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

Другое · 7 мин

Как завершить бизнес-процесс в 1С программно

Программное завершение бизнес-процесса в 1C: условия, способы через объект и статус, проверка результата, риски и типичные ошибки для самостоятельной работы.

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

Нельзя завершать процесс «вслепую»: перед изменением статуса нужно убедиться, что экземпляр существует, не заблокирован другим сеансом и находится в состоянии, допускающем завершение. Также важно проверить заполнение обязательных реквизитов, права текущего пользователя и отсутствие незавершённых зависимых документов, иначе сохранение может быть отменено или привести к неконсистентности данных.

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

Как определить, что процесс можно завершить программно

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

Полезно проверить, есть ли у процесса признак «завершён» или «отменён» в справочнике статусов, и какими правами обладает пользователь от имени которого выполняется код. Если процесс находится в состоянии выполнения и не заблокирован, программное завершение обычно безопаснее, чем прямое удаление объекта.

Экземпляр процессаСуществует и доступен для чтения

Получить ссылку по номеру, документу или инициатору

Текущий статусНе является финальным и не блокирует завершение

Сравнить со списком допустимых для закрытия статусов

Права и блокировкиПозволяют изменять объект

Проверить права пользователя и отсутствие блокировки другими сеансами

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

Основные способы завершения бизнес-процесса

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

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

Порядок действий
  1. 1
    Получить ссылку на экземпляр бизнес-процесса
  2. 2
    Проверить статус, права и отсутствие блокировок
  3. 3
    Установить конечный статус или вызвать процедуру завершения
  4. 4
    Сохранить объект и зафиксировать результат в журнале

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

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

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

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

Отдельно стоит учитывать права доступа: код, запущенный от имени пользователя без прав на изменение бизнес-процессов, вернёт ошибку или молча не сохранит данные. Использование прав администратора для массового завершения допустимо только в тестовой копии и с пониманием последствий для аудита.

Типичные ошибки и ограничения

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

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

Типичные ошибки
01
Завершение уже закрытого процесса без проверки статуса
02
Игнорирование обязательных реквизитов при сохранении
03
Прямое изменение таблиц базы данных минуя объекты 1С
04
Массовое завершение без резервной копии и тестовой копии

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

Альтернативы и границы самостоятельной работы

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

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

Итог

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

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

Можно ли завершить любой бизнес-процесс программно?

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

Что проверить перед запусккода завершения?

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

Нужно ли использовать транзакцию?

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

Что делать, если процесс не сохраняется после установки статуса?

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

Безопасно ли завершать процессы от имени администратора?

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