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