Другое · 6 мин
Написание кода команды в 1С: с чего начать
Практическая инструкция по переходу от интерфейса 1С к написанию кода команды: где создавать команду, как разделять клиент и сервер, как проверить результат.
Команда в 1С — это действие, которое пользователь может запустить из интерфейса: нажатием кнопки, пунктом меню или элементом панели действий. Переход к написанию кода команды означает, что вы описываете, что именно произойдет после такого запуска: какие объекты изменятся, какие данные будут проверены и какой результат увидит пользователь.
Первое, что нужно определить, — где будет размещена команда и в каком модуле будет находиться её код. В управляемых формах команда часто создается в свойствах формы или элемента управления, а её обработчик пишется в модуле формы. Если команда должна быть доступна из нескольких мест, удобнее вынести общую логику в общий модуль, а из командной формы вызывать его процедуру.
Перед началом разработки уточните контекст выполнения: будет ли команда работать на клиенте, на сервере или и там и там, какие права нужны пользователю и какие данные она может изменить. Рекомендуется отрабатывать новые команды на копии информационной базы или в изолированной базе для тестирования, чтобы случайно не исправить рабочие данные.
Откуда берутся команды и где живет их код
Команды могут быть связаны с формой документа, справочника, отчета или с общими действиями в интерфейсе. В конфигураторе команда обычно появляется как свойство формы или элемента управления, после чего конфигуратор может сгенерировать заготовку обработчика. Если команда не привязана к конкретной форме, её код размещают в общем модуле и вызывают из командного интерфейса.
Важно различать команду как элемент интерфейса и процедуру-обработчик команды. Элемент отвечает за видимость, доступность, картинку и текст, а процедура содержит алгоритм. Без корректной привязки процедуры команда будет отображаться, но при нажатии не будет выполнять никаких действий.
Проверьте модуль формы и привязку команды к процедуре
Определите место размещения: форма, список или общая панель
Как создать команду в управляемой форме
В управляемой форме команда добавляется через команду формы или через элемент управления типа кнопка. После создания появляется возможность сгенерировать процедуру обработчика, в которую и пишется основной алгоритм. Имя процедуры обычно формируется автоматически, но его можно изменить, если это не нарушит привязку в свойствах команды.
При создании команды укажите, для какого контекста она предназначена: для выделенного объекта, для списка объектов или для формы без выделения. От этого зависит, какие данные будут доступны в коде и нужно ли проверять наличие выбранной строки перед выполнением.
- 1Определите место команды в интерфейсе
- 2Создайте команду и привяжите обработчик
- 3Напишите код с учетом клиентского и серверного выполнения
- 4Проверьте результат на копии базы
Написание кода команды: клиент и сервер
Код команды может выполняться на клиентском компьютере пользователя или на сервере 1С. Клиентская часть удобна для работы с интерфейсом, выделением и сообщениями пользователю, а серверная — для чтения и записи данных, проведения документов и доступа к общей базе. Часто используется комбинация: клиент собирает параметры, а сервер выполняет критические изменения.
Если команда изменяет данные, логику лучше разместить на сервере, а клиентский код использовать только для запуска серверной процедуры и отображения результата. Это снижает риск неполной записи данных при обрыве соединения и делает поведение предсказуемее для всех пользователей.
&НаСервере
Процедура КомандаПриВыполнении(Команда)
// серверная логика изменения данных
КонецПроцедурыПараметры команды и работа с выделением
Команда может получать параметры: ссылку на выбранный объект, набор выделенных строк в таблице или значения из реквизитов формы. Перед использованием параметров проверьте, что они переданы и не пусты. Если команда рассчитана на одну запись, а пользователь выделил несколько или ничего не выделил, код должен корректно обработать такую ситуацию.
Работа с выделением отличается в списке и в форме объекта. В списке нужно обращаться к текущей строке или к коллекции выделенных элементов, в форме объекта — к реквизитам открытого объекта. Неправильное предположение о контексте приводит к тому, что команда изменяет не ту запись или выдает ошибку при пустом выделении.
Проверка прав и безопасность выполнения
Даже если команда технически работает, она может быть недоступна некоторым пользователям из-за прав доступа. Перед внедрением уточните, какие роли и права необходимы, и нужно ли ограничить выполнение команды определенными пользователями. Проверка прав лучше выполнять на сервере, чтобы клиент не мог обойти ограничение через интерфейс.
Для команд, изменяющих данные, полезно использовать транзакции и предварительную валидацию: проверить заполнение обязательных реквизитов, корректность периодов и отсутствие блокировок. Если команда выполняется долго, предупредите пользователя и не блокируйте интерфейс без необходимости, иначе работа в программе может приостановиться.
Частые ошибки и как проверить результат
Типичная ошибка — писать серверную логику на клиенте и пытаться напрямую записать данные из клиентского кода. Это работает ненадежно и может привести к частичному сохранению или ошибкам доступа. Другая ошибка — отсутствие обработки исключений: команда молча завершается с ошибкой, и пользователь не понимает, выполнилось действие или нет.
После написания команды проведите проверку на нескольких сценариях: без выделения, с одним выделенным объектом, с несколькими объектами и от пользователя с ограниченными правами. Нормальный результат — команда выполняется только при корректных входных данных, записывает ожидаемые изменения и сообщает об успехе или отказе.
Что важно запомнить
Определите место команды, разделите клиентский и серверный код, проверяйте выделение и права, тестируйте на копии базы.
Нужно ли создавать отдельную команду для каждого действия?
Не обязательно. Одна команда может вызывать разные процедуры общего модуля в зависимости от параметров, но если действия сильно отличаются по логике и правам, проще создать отдельные команды с понятными именами.
Может ли команда работать только на клиенте?
Может, если она только управляет интерфейсом: открывает форму, выводит сообщение или меняет видимость элементов. Для записи и изменения данных лучше использовать серверную часть.
Что делать, если команда не видна в интерфейсе?
Проверьте свойства видимости и доступности команды, привязку к форме или профилю, а также права текущего пользователя. Команда может существовать в конфигурации, но быть скрыта из-за условий отображения.
Как понять, что команда отработала успешно?
Оцените изменение данных в базе, сообщение пользователю и отсутствие ошибок в журнале регистрации. Если данные не изменились и сообщения нет, проверьте привязку обработчика и условия выполнения команды.