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