К статье
Практический материал

Другое · 6 мин

Написание кода команды в 1С: с чего начать

Практическая инструкция по переходу от интерфейса 1С к написанию кода команды: где создавать команду, как разделять клиент и сервер, как проверить результат.

Команда в 1С — это действие, которое пользователь может запустить из интерфейса: нажатием кнопки, пунктом меню или элементом панели действий. Переход к написанию кода команды означает, что вы описываете, что именно произойдет после такого запуска: какие объекты изменятся, какие данные будут проверены и какой результат увидит пользователь.

Первое, что нужно определить, — где будет размещена команда и в каком модуле будет находиться её код. В управляемых формах команда часто создается в свойствах формы или элемента управления, а её обработчик пишется в модуле формы. Если команда должна быть доступна из нескольких мест, удобнее вынести общую логику в общий модуль, а из командной формы вызывать его процедуру.

Перед началом разработки уточните контекст выполнения: будет ли команда работать на клиенте, на сервере или и там и там, какие права нужны пользователю и какие данные она может изменить. Рекомендуется отрабатывать новые команды на копии информационной базы или в изолированной базе для тестирования, чтобы случайно не исправить рабочие данные.

Откуда берутся команды и где живет их код

Команды могут быть связаны с формой документа, справочника, отчета или с общими действиями в интерфейсе. В конфигураторе команда обычно появляется как свойство формы или элемента управления, после чего конфигуратор может сгенерировать заготовку обработчика. Если команда не привязана к конкретной форме, её код размещают в общем модуле и вызывают из командного интерфейса.

Важно различать команду как элемент интерфейса и процедуру-обработчик команды. Элемент отвечает за видимость, доступность, картинку и текст, а процедура содержит алгоритм. Без корректной привязки процедуры команда будет отображаться, но при нажатии не будет выполнять никаких действий.

Команда есть в интерфейсеОбработчик не прописан

Проверьте модуль формы и привязку команды к процедуре

Команда отсутствуетНужно создать новый элемент

Определите место размещения: форма, список или общая панель

Как создать команду в управляемой форме

В управляемой форме команда добавляется через команду формы или через элемент управления типа кнопка. После создания появляется возможность сгенерировать процедуру обработчика, в которую и пишется основной алгоритм. Имя процедуры обычно формируется автоматически, но его можно изменить, если это не нарушит привязку в свойствах команды.

При создании команды укажите, для какого контекста она предназначена: для выделенного объекта, для списка объектов или для формы без выделения. От этого зависит, какие данные будут доступны в коде и нужно ли проверять наличие выбранной строки перед выполнением.

Порядок действий
  1. 1
    Определите место команды в интерфейсе
  2. 2
    Создайте команду и привяжите обработчик
  3. 3
    Напишите код с учетом клиентского и серверного выполнения
  4. 4
    Проверьте результат на копии базы

Написание кода команды: клиент и сервер

Код команды может выполняться на клиентском компьютере пользователя или на сервере 1С. Клиентская часть удобна для работы с интерфейсом, выделением и сообщениями пользователю, а серверная — для чтения и записи данных, проведения документов и доступа к общей базе. Часто используется комбинация: клиент собирает параметры, а сервер выполняет критические изменения.

Если команда изменяет данные, логику лучше разместить на сервере, а клиентский код использовать только для запуска серверной процедуры и отображения результата. Это снижает риск неполной записи данных при обрыве соединения и делает поведение предсказуемее для всех пользователей.

1c
&НаСервере
Процедура КомандаПриВыполнении(Команда)
    // серверная логика изменения данных
КонецПроцедуры

Параметры команды и работа с выделением

Команда может получать параметры: ссылку на выбранный объект, набор выделенных строк в таблице или значения из реквизитов формы. Перед использованием параметров проверьте, что они переданы и не пусты. Если команда рассчитана на одну запись, а пользователь выделил несколько или ничего не выделил, код должен корректно обработать такую ситуацию.

Работа с выделением отличается в списке и в форме объекта. В списке нужно обращаться к текущей строке или к коллекции выделенных элементов, в форме объекта — к реквизитам открытого объекта. Неправильное предположение о контексте приводит к тому, что команда изменяет не ту запись или выдает ошибку при пустом выделении.

Проверка прав и безопасность выполнения

Даже если команда технически работает, она может быть недоступна некоторым пользователям из-за прав доступа. Перед внедрением уточните, какие роли и права необходимы, и нужно ли ограничить выполнение команды определенными пользователями. Проверка прав лучше выполнять на сервере, чтобы клиент не мог обойти ограничение через интерфейс.

Для команд, изменяющих данные, полезно использовать транзакции и предварительную валидацию: проверить заполнение обязательных реквизитов, корректность периодов и отсутствие блокировок. Если команда выполняется долго, предупредите пользователя и не блокируйте интерфейс без необходимости, иначе работа в программе может приостановиться.

Частые ошибки и как проверить результат

Типичная ошибка — писать серверную логику на клиенте и пытаться напрямую записать данные из клиентского кода. Это работает ненадежно и может привести к частичному сохранению или ошибкам доступа. Другая ошибка — отсутствие обработки исключений: команда молча завершается с ошибкой, и пользователь не понимает, выполнилось действие или нет.

После написания команды проведите проверку на нескольких сценариях: без выделения, с одним выделенным объектом, с несколькими объектами и от пользователя с ограниченными правами. Нормальный результат — команда выполняется только при корректных входных данных, записывает ожидаемые изменения и сообщает об успехе или отказе.

Итог

Что важно запомнить

Определите место команды, разделите клиентский и серверный код, проверяйте выделение и права, тестируйте на копии базы.

Нужно ли создавать отдельную команду для каждого действия?

Не обязательно. Одна команда может вызывать разные процедуры общего модуля в зависимости от параметров, но если действия сильно отличаются по логике и правам, проще создать отдельные команды с понятными именами.

Может ли команда работать только на клиенте?

Может, если она только управляет интерфейсом: открывает форму, выводит сообщение или меняет видимость элементов. Для записи и изменения данных лучше использовать серверную часть.

Что делать, если команда не видна в интерфейсе?

Проверьте свойства видимости и доступности команды, привязку к форме или профилю, а также права текущего пользователя. Команда может существовать в конфигурации, но быть скрыта из-за условий отображения.

Как понять, что команда отработала успешно?

Оцените изменение данных в базе, сообщение пользователю и отсутствие ошибок в журнале регистрации. Если данные не изменились и сообщения нет, проверьте привязку обработчика и условия выполнения команды.