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

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

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

Параметр — это вопрос, который процесс задаёт человеку на входе. Плохой вопрос — плохой процесс.

Что такое параметры бизнес-процесса в Битрикс24

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

Вид данныхКто задаёт значениеКогда меняется
ПараметрТот, кто запускает процесс, — в форме запускаЗадаётся один раз при старте
ПеременнаяСам процесс по ходу выполненияМожет меняться на любом шаге
КонстантаАдминистратор, настраивающий шаблонОдинакова для всех запусков

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

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

Где задаются параметры бизнес-процессов

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

Внутри редактора есть настройки шаблона с отдельными вкладками для параметров, переменных и констант. Добавляя параметр, вы указываете несколько свойств ↓

НазваниеТо, что человек увидит в форме запуска.
ИдентификаторЛатинское имя, по которому к параметру обращаются действия.
ОписаниеПодсказка: что именно ввести и в каком виде.
ТипСтрока, число, дата, список, сотрудник и другие.
ОбязательностьБез значения процесс не запустится вручную.
Значение по умолчаниюПодставляется, если никто не заполнил форму.

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

Идентификатор стоит продумать сразу. Название можно поменять в любой момент, а идентификатор уже вставлен в условия и тексты уведомлений — если его переименовать, придётся пройти по всей схеме.

Типы параметров и какой выбирать

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

ТипКогда брать
Строка и текстКороткое название или развёрнутое обоснование
ЧислоСуммы, проценты, количество — всё, что сравнивается в условиях
Дата и дата со временемСроки, даты отпуска и командировки, дедлайны оплаты
Да / НетПростой выбор, влияющий на ветку процесса
СписокЗаранее известные варианты: тип закупки, отдел, причина
Привязка к сотрудникуКого назначить исполнителем или согласующим
ФайлСчёт, договор, скан документа для согласования

Главное правило выбора: всё, по чему процесс будет ветвиться, должно быть числом, датой, списком или «да / нет», а не свободной строкой. Условие «если сумма больше 100 000» работает с числом. Если сумму ввели строкой «сто тысяч» или «100 000 руб.», условие промахнётся, и процесс уйдёт не в ту ветку без всякой ошибки.

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

Как параметры получают значения при запуске

Откуда возьмутся значения, зависит от способа запуска. Способы подробно разобраны в статье как запустить бизнес-процесс в Битрикс24, здесь — только то, что касается параметров ↓

Три пути, которыми значения попадают в процесс:
Ручной запуск: форма
Автозапуск: по умолчанию
Робот или REST: передача

Ручной запуск. Сотрудник открывает карточку или список, выбирает шаблон, и перед стартом Битрикс24 показывает форму со всеми параметрами. Обязательные без значения не дадут запустить процесс. Это самый понятный сценарий, и на него рассчитано большинство процессов согласования.

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

Запуск из робота или через REST. Бизнес-процесс можно запустить роботом на стадии сделки или внешним вызовом через REST API Битрикс24. В обоих случаях значения параметров передаются при запуске: робот подставляет их из полей карточки, внешняя система — из своих данных. Так, например, интернет-магазин может запускать процесс проверки заказа с номером и суммой в параметрах.

Процессы есть, но сотрудники их обходят?
Посмотреть, как мы автоматизируем →

Как использовать параметры в действиях процесса

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

Где параметры используются чаще всего ↓

УсловияСумма больше порога — в ветку финдиректора.
ЗаданияВ тексте утверждения — что, сколько и зачем.
УведомленияСообщение в чат с датами и суммой.
ИсполнителиСотрудник из параметра получает задачу.
Изменение документаЗначение записывается в поле карточки.
Сроки и паузыОжидание до даты, указанной при запуске.

Хорошее задание согласования читается без открытия карточки: «Утвердите скидку 12% по сделке такой-то, обоснование: клиент берёт годовой пакет». Всё это — параметры, подставленные в текст. Как устроены сами задания и почему они зависают, подробно разобрано в материале о задании бизнес-процесса.

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

Параметр или поле документа: как решить

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

  1. Нужно ли значение после окончания процесса? Если да — это поле документа. Параметр остаётся только в истории конкретного запуска.
  2. Нужно ли по нему строить отчёт или фильтр? Отчёты CRM и списки работают с полями, а не с параметрами процессов.
  3. Может ли процесс запускаться сам? При автозапуске формы нет — данные должны уже лежать в полях.
  4. Относится ли значение только к этому запуску? Обоснование конкретной просьбы или комментарий к согласованию — хорошие кандидаты в параметры.

Часто правильный ответ — оба варианта сразу. Параметр собирает данные в удобной форме запуска, а процесс в первом же действии записывает их в поля документа. Так сотрудник видит короткую форму, а руководитель — заполненную карточку и честный отчёт. Как устроить поля, чтобы они не превращались в свалку, — в статье о настройке полей Битрикс24.

Параметры в процессах ленты новостей

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

Несколько правил для таких форм ↓

  1. Не больше шести-семи полей. Всё, что можно вычислить или взять из профиля сотрудника, не спрашивайте.
  2. Порядок полей — как в голове у человека. Сначала что и сколько, потом когда, потом обоснование и файл.
  3. Подсказка в описании параметра. «Сумма с НДС, в рублях» избавляет от половины уточнений.
  4. Обязательны только те поля, без которых решение не принять. Лишняя обязательность — повод не подавать заявку вовсе.

Примеры параметров для типовых процессов

Чтобы было от чего оттолкнуться, вот наборы параметров для процессов, которые заводят чаще всего ↓

ПроцессПараметры при запуске
Согласование скидкиРазмер скидки (число), обоснование (текст), срок действия (дата)
Оплата счётаСумма (число), контрагент (строка), файл счёта, срок оплаты (дата), статья расходов (список)
КомандировкаДаты (дата), город (строка), цель (текст), нужен ли аванс (да / нет)
Заявка на закупкуЧто купить (текст), сумма (число), срочность (список), ответственный за приёмку (сотрудник)

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

Частые ошибки с параметрами

Сумма строкойУсловие «больше порога» не срабатывает, процесс идёт не туда.
Обязательный параметр при автозапускеФормы нет, значения по умолчанию пустые — процесс работает с пустотой.
Параметр вместо поляЗначение нужно в отчётах, а живёт только внутри процесса.
Переименован идентификаторСсылки в условиях и текстах перестали подставлять значения.
Двадцать полей в формеСотрудники не подают заявки через процесс, пишут в чат.
Нет подсказокКаждый вводит по-своему, согласующий переспрашивает.

Отдельно о правах. Параметр типа «сотрудник» назначает исполнителя, но не выдаёт ему доступ к документу. Если назначенный не видит сделку или элемент списка, задание он получит, а открыть карточку не сможет. Как это настраивается, — в статье о правах на бизнес-процессы в Битрикс24.

Как проверить шаблон с параметрами перед запуском

Перед тем как открыть процесс всей компании, я прогоняю шаблон по короткому списку ↓

  1. Запуск под обычным сотрудником. Не под администратором: видна ли форма, понятны ли поля, хватает ли прав.
  2. Граничные значения. Сумма ровно на пороге, чуть ниже и чуть выше — процесс уходит в правильные ветки.
  3. Пустые необязательные поля. Тексты уведомлений не превращаются в «Сумма: , срок: ».
  4. Автозапуск, если он включён. С какими значениями стартует процесс без формы.
  5. Журнал выполнения. Какие значения реально пришли в каждое действие.

На это уходит полчаса, а экономит недели разбирательств, почему скидку утвердил не тот человек.

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

Первый шаг

Разбор ваших процессов за 30 минут

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

Записаться на разбор →

Итог: параметры бизнес-процессов в Битрикс24 — это вход процесса, форма, которую человек заполняет при запуске. Типизируйте всё, по чему процесс ветвится, держите форму короткой и не путайте параметры с полями документа и переменными. Если процессы нужно выстроить целиком — от описания до обучения сотрудников, — это работа в рамках автоматизации бизнес-процессов; стоимость внедрения портала можно прикинуть в калькуляторе Битрикс24.