Битрикс 24 модификаторы в бизнес процессах

Модификация данных

Урок
49
из
244

  Список модификаторов

В таблице ниже собран список всех модификаторов с кратким примером записи. Модификатор добавляется через символ > внутри фигурных скобок. Примеры использования модификаторов есть в этом уроке и в последующих.

{=Variable:Variable1 > printable}

{=Document:CREATED_BY > friendly}

{=Variable:File > name}

{=Variable:Datetime > responsible}

{=Variable:Datetime > server}

{=Document:PROPERTY_MY_FILE > publink}

{=Document:PROPERTY_MY_FILE > shortlink}

{=Document:PROPERTY_MY_FILE > src}

{=Variable:Variable1 > bool}

{=Variable:Variable1 > date}

{=Variable:Variable1 > datetime}

{=Variable:Variable1 > double}

{=Variable:Variable1 > int}

{=Variable:Variable1 > file}

{=Variable:Variable1 > select}

{=Variable:Variable1 > string}

{=Variable:Variable1 > text}

{=Variable:Variable1 > user}

  Таблица преобразования типов данных

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

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

Примечание: при преобразовании типа Список в Строку или Текст берутся значения списка, при преобразовании Списка в Список — ключи списка. Для получения значения ключа списка используйте конвертирование, например: {=Variable:Select > select}.

Важно! Для версий модуля до 15.6.0 преобразование типов данных, в том числе и запрос печатной формы для значений, не имеющих таковой, возможно с помощью переменных и действия PHP-код.

  Примеры

printable

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

Возьмем переменную типа пользователь. Результат, если значение переменной равно Автор:

{=Variable:user}                          author
{=Variable:user > printable}              Автор

Для поля документа или параметра такой вариант отображения может быть сразу доступен для вставки в форме Вставка значения.

Если же печатная форма не предусмотрена, то запросить вывод печатной формы от любого значения получится и вручную (для переменной, дополнительного результата и т.п.). Кроме того, можно использовать модификаторы одновременно. Например, для переменной типа Datetime добавляем printable с преобразованием типа данных в Date:

{=Variable:Datetime > date, printable} // перевод даты в печатную форму

{=Variable:string>date} // преобразование строки в дату

friendly

Для данных типа Пользователь есть возможность преобразования в формат friendly. В таком случае выводится только имя и фамилия пользователя, без его ID и логина.

Пример: {=Document:CREATED_BY} > User_1

{=Document:CREATED_BY > printable} > Иван Иванов [1]

{=Document:CREATED_BY > friendly} > Иван Иванов

name

С версии 20.100.0 модуля Бизнес-процессы добавлена возможность получить имя файла через модификатор name для полей типа Файл. Пример для переменной типа Файл:

 {=Variable:File > name} // вывод названия файла

Другие примеры

• Примеры работы со ссылками;
• Примеры работы с датами.

Возможные форматы дат и времени

Параметры имён

Значения для падежей

Форматы адресов и разделители

Доступные параметры

Как вывести в шаблоне такой список читайте в статье Шаблоны документов

Похожие записи в блоге

Все статьи

19.05.2020
11:40
19.05.2020 11:40:25

Калькулятор в БП

=2+2 //выведет 4 2+2={{=2+2}} //выведет 2+2=4 
ID = {=Document:ID}  //выведет ID = 234 - выведет реальный ID документа 
ID+2 = {{=2+{=Document:ID}}} // выведет ID+2 = 236 

Модификаторы в БП

{=Document:CREATED_BY} > User_1
{=Document:CREATED_BY > printable} > Иван Иванов [1]
{=Document:CREATED_BY > friendly} > Иван Иванов

Начало настройки

Как включить
БП по диску. Диск->общий диск -> настройка (шестеренка) -> настроить бизнес процессы -> активировать
БП по документам. Диск->общий диск -> настройка (шестеренка) -> бизнес-процессы ->
«создать стандартные шаблоны БП» или выбрать существующий шаблон для просмотра или редактирования
БП Из живой ленты. Бизнес-процессы ->процессы в ленте
БП CRM. CRM ->настройки (верхнее меню) -> роботы и бизнес-процессы -> бизнес-процессы -> выбор сущности для организации БП
Роботы — это обертка БП (упрощенная)

Скопировать БП

• Создать новый шаблон БП
• В редактировании шаблона БП имеющегося меню Экспортировать
• В редактировании шаблона БП созданного меню Импортировать

Шаблон БП состоит из действий

• Документ в шаблоне — это текущий объект, по которому запущен БП
• Задания  https://helpdesk.bitrix24.ru/open/7451037/ действия, которые создают интерфейс для коммуникации с пользователями
• Обработка документа https://helpdesk.bitrix24.ru/open/7449433/
• Диск https://helpdesk.bitrix24.ru/open/7544195/  Для работы с диском, с файлами
• Уведомления https://helpdesk.bitrix24.ru/open/7471547/ возможности по коммуникации с пользователями (написать в чат, в живую ленту, поставить задачу)
• Конструкции https://helpdesk.bitrix24.ru/open/7453445/ как конструкции в языке программирования (условия, циклы)
• CRM https://helpdesk.bitrix24.ru/open/7567357/ для работы с CRM
• Прочее https://helpdesk.bitrix24.ru/open/7557393/
• Действия приложений — нестандартные, установленные (Можно добавить свое, но нужно обернуть в приложение)

Создание нового БП
1. создаем новый процесс (через добавить)
2. настраиваем поля, которые нужны (Название, сумма, статус, обоснование, счет)
3. создаем шаблон бизнес-процесса через (действия ->настроить бизнес-процесс)
4. создаем параметры (при запуске будут запрашиваться), константы (которые не изменятся за весь БП), переменные (которые будем менять-заполнять в БП)

В действии Задача в процессах нельзя просто указать поле Лида, Контакта, Сделки или Компании, оно не привяжется к задаче.

Дело в том, что эти поля содержат ID сущности, но не указывают что же это за сущность, поэтому ее нужно указать.

• Лид ‘L_’&{{ID}}
• Контакт  ‘C_’&{{ID}}
• Сделка ‘D_’&{{ID}}
• Компания ‘CO_’&{{ID}}

Пример добавления Компании и  Сделки к Задаче:

= ‘CO_’&{{Компания}}, ‘D_’&{=A89102_36331_72702_3654:DealId}

Для смарт-процессов такого префикса еще нет, но есть временное решение:

1. Берем ID смарт-процесса, на моем примере 185

1. Конвертируем с помощью любого сервиса данное число в шестнадцатеричную систему. В случае с ID=185 получаем значение B9.

1. К полученному значению дописываем “T” в начале. То есть получаем – TB9.

Данный код используем в привязке. Для моего примера получается:

=’TB9_’&{{ID}}

Также этот код можно получить с помощью Входящего вебхука и метода crm.enum.ownertype

Сохраните вебхук, нажмите Выполнить. В результатах найдите нужный смарт-процесс. Нам нужен [SYMBOL_CODE_SHORT]

Значение списка присвоить значению списка в другой сущности

Здесь тоже все не так тривиально. Нельзя просто приравнять списки, придется использовать переменную с ключами значений. 

Для получения значения ключа списка используется параметр select.

Например: {=Variable:Select > select}.

Подробнее в статье Сопоставление полей типа список.

Системные данные и функции

Если в действии процесса, где вы хотите внести какие-то данные, ввести равно, то для вас откроется мир системных данных и функций 🙂

Системные:

• {=Workflow:ID} Идентификатор процесса
• {=Template:TargetUser} Пользователь, запустивший процесс
• {=User:ID} Текущий пользователь
• {=System:Now} Текущая дата и время сервера
• {=System:NowLocal} Текущая дата и время локальное
• {=System:Date} Текущая дата
• {=System:Eol} Символ конца строки

Функции:

• abs вычисление модуля числа
• dateadd добавление указанного значения к дате
• datediff вычисление разницы между датами
• date форматирует вывод даты/времени
• workdateadd добавляет дни, часы, минуты к указанной дате
• addworkdays добавляет N рабочих дней к указанной дате
• isworkday проверяет является ли дата рабочим днем
• isworktime проверяет является ли дата/время рабочим временем
• touserdate приводит серверное время к времени пользователя
• getuserdateoffset возвращает смещение времени пользователя относительно сервера, в секундах
• if условный оператор
• intval возвращает целое число
• floatval возвращает число
• numberformat форматирует число с разделение групп
• min возвращает наименьшее число
• max возвращает наибольшее число
• rand возвращает случайное число
• round округляет число
• ceil округляет дробь в большую сторону
• floor округляет дробь в меньшую сторону
• substr возвращает подстроку
• strpos возвращает позицию первого вхождения подстроки
• strlen возвращает длину строки
• implode объединяет множественные значения в строку
• explode разбивает строку с помощью разделителя
• randstring возвращает случайную строку
• merge объединение множественных значений
• urlencode url-кодирование строки
• strtolower преобразует строку в нижний регистр
• strtoupper преобразует строку в верхний регистр
• ucwords преобразует в верхний регистр первый символ каждого слова в строке
• ucfirst преобразует первый символ строки в верхний регистр
• strtotime преобразует текстовое написание даты на английском языке во внутренний формат даты
• locdate меняет язык вывода даты/ времени на текущий язык портала
• shuffle перемешивает значения множественного поля
• firstvalue возвращает первое значение множественного поля
• swirl перемещает первое значение пользовательского поля в конец

Ссылки в уведомлениях и заданиях

Чтобы сделать кликабельную ссылку в задании она должна иметь следующий вид:[url=ссылка]название ссылки[/url]

Примеры ссылок:
Ссылка на просмотр существующего документа crm в слайдере:  /bitrix/components/bitrix/ crm.document.view/slider.php?documentId=[ID]&IFRAME=Y&IFRAME_TYPE= SIDE_SLIDER

Ссылка на папку: /bitrix/tools/disk/focus.php?folderId={=A52715_49501_92679_43337: ObjectId}& action=openFolderList&ncc=1

Ссылка на страницу с заданием текущего бизнес-процесса: /company/personal/bizproc/ {=Workflow:ID}/

Ссылка на пользователя: /company/personal/user/{{=substr({{Ответственный}}, 5)}}/

Ссылка на задачу: /company/personal/user/{{=substr({{Ответственный}}, 5)}}/tasks/task/view/{=A57030_97500_98792_73159:TaskId}

Ссылка на сделку: /crm/deal/details/{{ID}}/

Ссылку можно поставить на любую сущность. Например, вам нужно сделать ссылку на сделку, для этого зайдите в любую сделку и скопируйте адрес в адресной строке, а затем вместо ID сделки подставьте переменную.

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

Уведомление на задачу, завершения которой ждет бизнес-процесс

Если в действии Задача мы устанавливаем ожидание до завершения задачи, то нет смысла делать уведомление со ссылкой после задачи, т.к. она уже завершится, когда придет уведомление. Перед задачей тоже смысла нет, т.к. мы еще не знаем ID задачи и не можем указать ссылку на нее.

Зато мы можем сделать Задачу и Уведомление параллельно. Важно, чтобы сначала создавалась Задача, а потом уже Уведомление, поэтому Задачу размещаем слева.

В тексте уведомления в таком случае можно уже вставить ссылку непосредственно на Задачу: Вам поставлена [url=/company/personal/user/{=User: ID}/tasks/task/view/ {=A24388_98030_17242_51455: TaskId}/] новая задача[/url].

Где {=A24388_98030_17242_51455:TaskId} — ID задачи из вставки значения дополнительных результатов.

Задание и задача в одном флаконе

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

Поэтому иногда приходится совмещать эти действия.

Здесь есть два момента:

1. В Задаче укажите ссылку на задание и напишите примечание, что задача завершится автоматически после выполнения задания.
2. После задания необходимо установить либо rest-действие (в маркете есть) с завершением задачи, либо WebHook с завершением задачи.

Описание задачи:

Ознакомиться с документами по сделке [url=/crm/deal/details/{{ID}}/]{{Название}}[/url].

[b]Перейдите в [url=/company/personal/bizproc/ {=A94232_72478_73372_10926:TaskId}/]  задание[/url][/b]

[b][color=red]После выполнения задания задача завершится автоматически.[/color][/b]

В этом примере приведена ссылка на сделку и ссылка на задание. В примечании тег [b][/b] – жирный шрифт, [color=red][/color] – красный цвет шрифта.

Форматирование текста

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

Теги:

• <b>Жирный</b>
• <i>Курсив</i>
• <u>Подчеркивание</u> 
• [color=red]Цвет[/color] (цвет можно указывать как названием, так и кодом, например, #ff0000)

Блок и Мои действия

Если в вашем процессе часто повторяются какие-либо действия или конструкции, то поместите их в Блок действий, а блок в Мои действия дизайнера бизнес-процессов, это позволит быстро применять часто повторяющиеся схемы, которые Вы используете. 

Также это будет полезно, если вы захотите объединить два разных процесса.

Перемещение и копирование действий

Действия можно перемещать в пределах бизнес-процесса — зажмите действие левой клавишей мыши и переместите в нужное место. Если при этом зажать клавишу Ctrl на клавиатуре, то действие скопируется.

Сворачивание конструкций

Чтобы процесс было проще “читать”, порой удобно свернуть громоздкие конструкции. Тогда процесс будет выглядеть более лаконично. Если же нужно посмотреть более подробно, то конструкцию всегда можно развернуть и углубиться в действия. 

Импорт и экспорт бизнес-процесса

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

Итератор

Если Вам нужно произвести ряд действий над несколькими элементами одного типа, например над Контактами или Компаниями, то здесь пригодится Итератор. Пример использования итератора в процессе по отправке сообщения контакту определенного типа в WhatsApp.

Логирование

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

На скрине действие Запись в отчет названо Разветвление, там написано по какому пути пошел процесс.

Наименование процессов

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