Отладка и журнал бизнес-процесса

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

Журнал выполнения: главный инструмент

Журнал — это пошаговая история конкретного экземпляра процесса. Он открывается по элементу (сделке, записи списка, документу) и показывает, какие действия отработали, в каком порядке и с каким результатом. Именно здесь видно, на каком шаге процесс остановился.

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

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

Действие «Лог в журнал»

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

В его текст подставляют интересующие значения через «Вставить значение»:

Шаг 3. Счётчик = {=Variable:Schetchik}, Сумма = {=Document:SUM}, Ветка: крупная

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

Тестовые запуски и изоляция

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

1. создайте тестовый элемент (тестовую сделку, запись, файл) с типичными данными;
2. подставьте свои контакты вместо клиентских, чтобы уведомления шли вам;
3. прогоните процесс и пройдите все ветки, меняя входные данные;
4. после каждого прогона читайте журнал и сверяйте с ожиданием.

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

Процесс вообще не запускается

Частая ситуация: процесс есть, а на элементе не стартует. Причина обычно не в логике, а в настройках запуска.

Если автозапуск настроен, но процесс молчит, запустите его вручную на том же элементе: если вручную идёт, а автоматически нет — дело в условии или событии запуска.

Зависшие и застрявшие экземпляры

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

• ждёт ответа отсутствующего сотрудника — переназначить или завершить;
• встал на внешнем вызове — проверить доступность сервиса;
• попал в логическую яму (ни одна ветка условия не истинна) — исправить шаблон и перезапустить;
• потерял актуальность — принудительно завершить.

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

Профилактика: как облегчить будущую отладку

Хорошо спроектированный процесс отлаживается в разы легче. Несколько привычек, которые окупаются:

• Осмысленные названия действий и веток вместо «Условие 1», «Условие 2» — журнал сразу читаем.
• Контрольные точки логирования на входах в крупные ветки.
• Ранняя валидация данных — ошибка ловится в понятном месте, а не в глубине схемы.
• Версионирование: сохраняйте рабочую копию шаблона перед крупными правками.

Итог

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

Мы в B2Bsite не только строим процессы, но и разбираем чужие — зависшие, непрозрачные, унаследованные от прежних подрядчиков. Если автоматизация на портале работает нестабильно, поможем найти причину по журналам и привести процессы в порядок.