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