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

Другое · 7 мин

Как выполнить команду документа в 1С

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

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

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

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

Где найти команду документа и как запустить

Команды документов размещаются на панели действий формы документа, в контекстном меню строки списка и, если разработчик добавил, в меню «Действия». В списке документов команда обычно применяется к выделенной строке, а в форме документа — к текущему открытому документу. Если кнопки нет, команда может быть скрыта из-за отсутствия прав, несоответствия состояния документа или настроек ролей.

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

Клиентская и серверная команда: в чем разница

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

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

Программное выполнение команды документа

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

Порядок действий
  1. 1
    Откройте список документов или форму нужного документа
  2. 2
    Выделите запись и нажмите кнопку команды или пункт контекстного меню
  3. 3
    Дождитесь сообщения системы и проверьте статус документа

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

Проверка результата и ограничения

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

Контрольные точки

Как проверить результат

Статус документа после команды
Норма

Соответствует ожидаемому действию

Тревожный признак

Без изменений или ошибка системы

Движения по регистрам
Норма

Появились при проведении или корректировке

Тревожный признак

Отсутствуют, хотя должны быть

Сообщение системы
Норма

Успешное выполнение

Тревожный признак

Предупреждение об отсутствии прав или условий

Ограничения связаны с правами доступа, состоянием документа, режимом работы и типом команды. Некоторые команды доступны только для документов в статусе «Не проведен», другие — только для проведенных. Также может действовать ограничение на одновременное редактирование документа другим пользователем, что блокирует выполнение команды до освобождения записи.

Частые ошибки и безопасность

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

Типичные ошибки
01
Запуск команды без прав на проведение или редактирование документа
02
Повторное нажатие кнопки при отсутствии реакции системы

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

Альтернативы, если команда недоступна

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

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

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

Итог

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

Запускайте команду документа в открытой форме с нужными правами, учитывайте клиентский или серверный тип и проверяйте результат по статусу и регистрам.

Можно ли выполнить команду документа без открытой формы?

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

Что делать, если кнопка команды отсутствует?

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

В чем разница между клиентской и серверной командой?

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

Безопасно ли массово выполнять команды проведения документов?

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