Параметры бизнес-процессов в Битрикс24 — это данные, которые процесс получает в момент запуска: сумма скидки, даты отпуска, обоснование, файл счёта. Человек заполняет их в форме перед стартом, а дальше процесс использует эти значения в условиях, заданиях и уведомлениях.
На параметрах держится почти любой процесс, где сотрудник что-то просит: согласование скидки, оплата счёта, командировка, заявка на закупку. Если параметры продуманы, процесс запускается за полминуты и не требует уточнений в чате. Если нет — согласующий получает задание «утвердить», не понимая, что именно утверждает.
Ниже разберу, что такое параметры бизнес-процесса в Битрикс24 и чем они отличаются от переменных и констант, где их задать, какие бывают типы, как значения попадают в процесс при ручном и автоматическом запуске, как их использовать в действиях и на каких ошибках шаблоны ломаются чаще всего.
Параметр — это вопрос, который процесс задаёт человеку на входе. Плохой вопрос — плохой процесс.
Что такое параметры бизнес-процесса в Битрикс24
У шаблона бизнес-процесса есть три вида собственных данных. Путать их — самая частая причина кривых шаблонов, поэтому сначала коротко о разнице ↓
| Вид данных | Кто задаёт значение | Когда меняется |
|---|---|---|
| Параметр | Тот, кто запускает процесс, — в форме запуска | Задаётся один раз при старте |
| Переменная | Сам процесс по ходу выполнения | Может меняться на любом шаге |
| Константа | Администратор, настраивающий шаблон | Одинакова для всех запусков |
Параметры отвечают на вопрос «с чем мы запускаем процесс». Например, в согласовании скидки это размер скидки и обоснование. Переменная — это то, что процесс вычисляет или запоминает сам: например, кто согласовал и когда. Константа — то, что одинаково для всех: например, финансовый директор, который утверждает скидки больше порога. Подробно о втором и третьем виде — в материале о переменных бизнес-процессов Битрикс24.
Важно и другое. Параметр описывает данные конкретного запуска, а не документа. Если значение должно жить в карточке сделки после окончания процесса и попадать в отчёты — это не параметр, а поле сделки, и процесс должен его заполнить действием изменения документа.
Где задаются параметры бизнес-процессов
Параметры задаются в редакторе шаблона. Сам редактор открывается из настроек той сущности, с которой работает процесс: сделки, лида, смарт-процесса, универсального списка, процесса в ленте новостей. Как в него попасть и из чего собирается схема, разобрано в статье о конструкторе бизнес-процессов Битрикс24.
Внутри редактора есть настройки шаблона с отдельными вкладками для параметров, переменных и констант. Добавляя параметр, вы указываете несколько свойств ↓
Названия пунктов меню и точный набор настроек отличаются в облаке и коробке и меняются с обновлениями, поэтому актуальный путь сверяйте со справкой Битрикс24. Сама логика — вкладка параметров в настройках шаблона — остаётся прежней много лет.
Идентификатор стоит продумать сразу. Название можно поменять в любой момент, а идентификатор уже вставлен в условия и тексты уведомлений — если его переименовать, придётся пройти по всей схеме.
Типы параметров и какой выбирать
Тип определяет, как поле выглядит в форме и что с ним можно делать дальше. Набор доступных типов зависит от того, где живёт процесс, но основные есть везде ↓
| Тип | Когда брать |
|---|---|
| Строка и текст | Короткое название или развёрнутое обоснование |
| Число | Суммы, проценты, количество — всё, что сравнивается в условиях |
| Дата и дата со временем | Сроки, даты отпуска и командировки, дедлайны оплаты |
| Да / Нет | Простой выбор, влияющий на ветку процесса |
| Список | Заранее известные варианты: тип закупки, отдел, причина |
| Привязка к сотруднику | Кого назначить исполнителем или согласующим |
| Файл | Счёт, договор, скан документа для согласования |
Главное правило выбора: всё, по чему процесс будет ветвиться, должно быть числом, датой, списком или «да / нет», а не свободной строкой. Условие «если сумма больше 100 000» работает с числом. Если сумму ввели строкой «сто тысяч» или «100 000 руб.», условие промахнётся, и процесс уйдёт не в ту ветку без всякой ошибки.
То же со списками. Если причина закупки — свободный текст, через месяц в нём будут десятки вариантов написания одного и того же, и отчёт по заявкам не сгруппировать. Список из пяти вариантов плюс «другое» с текстовым пояснением решает эту проблему.
Как параметры получают значения при запуске
Откуда возьмутся значения, зависит от способа запуска. Способы подробно разобраны в статье как запустить бизнес-процесс в Битрикс24, здесь — только то, что касается параметров ↓
Ручной запуск. Сотрудник открывает карточку или список, выбирает шаблон, и перед стартом Битрикс24 показывает форму со всеми параметрами. Обязательные без значения не дадут запустить процесс. Это самый понятный сценарий, и на него рассчитано большинство процессов согласования.
Автоматический запуск. Если процесс стартует сам — при создании или изменении документа, — формы никто не увидит. Значения параметров берутся по умолчанию. Поэтому для процессов с автозапуском параметры почти не нужны: всё, что процессу требуется, лучше брать из полей самого документа.
Запуск из робота или через REST. Бизнес-процесс можно запустить роботом на стадии сделки или внешним вызовом через REST API Битрикс24. В обоих случаях значения параметров передаются при запуске: робот подставляет их из полей карточки, внешняя система — из своих данных. Так, например, интернет-магазин может запускать процесс проверки заказа с номером и суммой в параметрах.
Как использовать параметры в действиях процесса
Параметр сам по себе ничего не делает — он нужен, чтобы подставить значение в действие. Почти в любом поле действия есть кнопка вставки значения, где среди доступных данных есть раздел параметров шаблона. Выбранный параметр вставляется как ссылка, и при выполнении процесс заменяет её на то, что ввёл сотрудник.
Где параметры используются чаще всего ↓
Хорошее задание согласования читается без открытия карточки: «Утвердите скидку 12% по сделке такой-то, обоснование: клиент берёт годовой пакет». Всё это — параметры, подставленные в текст. Как устроены сами задания и почему они зависают, подробно разобрано в материале о задании бизнес-процесса.
Одна оговорка. Параметр задают при запуске, и по замыслу он описывает вход процесса. Если значение должно меняться по ходу — например, согласующий уменьшил скидку, — заведите переменную, скопируйте в неё параметр в начале процесса и меняйте уже переменную. Так в журнале процесса останется и то, что просили, и то, что утвердили.
Параметр или поле документа: как решить
Самый частый вопрос при проектировании шаблона — заводить ли данные параметром или полем сделки, смарт-процесса, элемента списка. Ошибка здесь не видна сразу, а через три месяца оказывается, что нужные цифры нельзя достать в отчёт. Решаю по четырём вопросам ↓
- Нужно ли значение после окончания процесса? Если да — это поле документа. Параметр остаётся только в истории конкретного запуска.
- Нужно ли по нему строить отчёт или фильтр? Отчёты CRM и списки работают с полями, а не с параметрами процессов.
- Может ли процесс запускаться сам? При автозапуске формы нет — данные должны уже лежать в полях.
- Относится ли значение только к этому запуску? Обоснование конкретной просьбы или комментарий к согласованию — хорошие кандидаты в параметры.
Часто правильный ответ — оба варианта сразу. Параметр собирает данные в удобной форме запуска, а процесс в первом же действии записывает их в поля документа. Так сотрудник видит короткую форму, а руководитель — заполненную карточку и честный отчёт. Как устроить поля, чтобы они не превращались в свалку, — в статье о настройке полей Битрикс24.
Параметры в процессах ленты новостей
В процессах, которые запускаются из ленты новостей, — заявления на отпуск, командировки, счета на оплату — параметры особенно заметны: форма заявки, которую видит сотрудник, и есть набор параметров шаблона. Поэтому от их продуманности зависит, будут ли сотрудники пользоваться процессом или продолжат писать бухгалтеру в чат.
Несколько правил для таких форм ↓
- Не больше шести-семи полей. Всё, что можно вычислить или взять из профиля сотрудника, не спрашивайте.
- Порядок полей — как в голове у человека. Сначала что и сколько, потом когда, потом обоснование и файл.
- Подсказка в описании параметра. «Сумма с НДС, в рублях» избавляет от половины уточнений.
- Обязательны только те поля, без которых решение не принять. Лишняя обязательность — повод не подавать заявку вовсе.
Примеры параметров для типовых процессов
Чтобы было от чего оттолкнуться, вот наборы параметров для процессов, которые заводят чаще всего ↓
| Процесс | Параметры при запуске |
|---|---|
| Согласование скидки | Размер скидки (число), обоснование (текст), срок действия (дата) |
| Оплата счёта | Сумма (число), контрагент (строка), файл счёта, срок оплаты (дата), статья расходов (список) |
| Командировка | Даты (дата), город (строка), цель (текст), нужен ли аванс (да / нет) |
| Заявка на закупку | Что купить (текст), сумма (число), срочность (список), ответственный за приёмку (сотрудник) |
Во всех примерах суммы и даты — отдельные типизированные поля: по ним строятся ветки и сроки. Процессы согласования в целом, включая последовательное и параллельное утверждение, разобраны в большом материале о бизнес-процессах в Битрикс24.
Частые ошибки с параметрами
Отдельно о правах. Параметр типа «сотрудник» назначает исполнителя, но не выдаёт ему доступ к документу. Если назначенный не видит сделку или элемент списка, задание он получит, а открыть карточку не сможет. Как это настраивается, — в статье о правах на бизнес-процессы в Битрикс24.
Как проверить шаблон с параметрами перед запуском
Перед тем как открыть процесс всей компании, я прогоняю шаблон по короткому списку ↓
- Запуск под обычным сотрудником. Не под администратором: видна ли форма, понятны ли поля, хватает ли прав.
- Граничные значения. Сумма ровно на пороге, чуть ниже и чуть выше — процесс уходит в правильные ветки.
- Пустые необязательные поля. Тексты уведомлений не превращаются в «Сумма: , срок: ».
- Автозапуск, если он включён. С какими значениями стартует процесс без формы.
- Журнал выполнения. Какие значения реально пришли в каждое действие.
На это уходит полчаса, а экономит недели разбирательств, почему скидку утвердил не тот человек.
После запуска на всю компанию полезно через пару недель вернуться к шаблону. Посмотрите, какие поля формы сотрудники заполняют формально — одним словом, прочерком, одинаковым текстом. Такие параметры либо лишние, либо сформулированы непонятно. Уберите их или перепишите подсказку: форма запуска должна становиться короче с каждой версией, а не длиннее.
Разбор ваших процессов за 30 минут
Покажите портал по видеосвязи: посмотрим шаблоны, формы запуска и зависшие задания, скажем, что поправить в первую очередь и что проще перевести на роботов.
Записаться на разбор →Итог: параметры бизнес-процессов в Битрикс24 — это вход процесса, форма, которую человек заполняет при запуске. Типизируйте всё, по чему процесс ветвится, держите форму короткой и не путайте параметры с полями документа и переменными. Если процессы нужно выстроить целиком — от описания до обучения сотрудников, — это работа в рамках автоматизации бизнес-процессов; стоимость внедрения портала можно прикинуть в калькуляторе Битрикс24.
