Views: 5097 (Data available since 06.02.2017)

When working with workflows, in addition to static text, the activity, template and status parameters can use special macros to specify auto-generated values like document fields, system variables, date and time etc.

To add a macro, click the ellipsis button (...) beside the target field. This will open the Insert Value form:

  • Template Parameters: contains the template parameters you can define by clicking Template Parameters button in Visual Modeler. Notice that a value may be defined by user at run time, when starting the business process.
  • Variables: inserts user defined variables that may change during the execution of the business process. For example, this may be an auxiliary number field that a user will be prompted to enter.
  • Constants - insert of pre-set constants that do not change during the execution of the business process. Their values are specified in the template parameters and the user without appropriate access permissions cannot modify them.
  • Document Fields: inserts the value of a field of the document on which the business process is running. For example: Created on or Created by.
  • Additional Results: inserts the activity processing result if it exists. The list includes only the activities of the current business process template that return one or more values.
  • Users: inserts the users (or user groups) privy to the business process. You can select one or more users separating multiple items with semicolon.
  • User categories - allow более подробно указать пользователей, которые будут причастны к выполнению бизнес-процесса. В том числе можно выбрать Отдел или Группу соцсети.
Примечание: можно вставлять как отдельные группы пользователей, так и целые отделы и группы социальной сети. Для этого в настройках прав доступа к элементам и разделам процесса нужно указать группы, которые вы хотите чтобы отображались в форме. Любая помещенная в эту вкладку группа вне зависимости от указанного уровня доступа будет отображаться в списке. Данная возможность пока недоступна в бизнес процессах в универсальных списках.

Следующие значения недоступны напрямую из формы, но могут быть использованы при проектировании шаблона бизнес-процесса:

  • {=Workflow:ID} - идентификатор бизнес-процесса;
  • {=User:ID} - идентификатор текущего пользователя в формате user_[номер_пользователя_в_системе];
  • {=Template:TargetUser} - параметр, в котором содержится идентификатор пользователя, запустившего бизнес-процесс в формате user_[номер_пользователя_в_системе];
  • {=System:Now} - текущая дата со временем на сервере;
  • {=System:NowLocal} - текущая дата со временем у клиента (учитывается часовой пояс);
  • {=System:Date} - текущая дата без времени;
  • {=Document:DETAIL_PAGE_URL} - позволяет получить ссылку на страницу детального просмотра документа, при условии, что в настройках инфоблока корректно заполнен URL страницы детального просмотра.
  • Примечание: Некоторые Примеры работы с выражениями рассмотрены в соответствующем уроке главы.

Использование некоторых значений полей контактов/компаний (для облачной версии)

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

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

Для переменной типа пользователь это выглядит следующим образом:

{=Variable:user}
{=Variable:user_printable}

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

author
Автор

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

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

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

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

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

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

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

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

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

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

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


Решение некоторых проблем (для коробочной версии)



Courses developed by «Bitrix», Inc.