Повторяющиеся переменные

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

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

Системные поля

Поле	Переменная
Исполнители	{{Task.Assignee}}
Участники	{{Task.Participant}}
Аудиторы	{Task.Task auditors}
Аналитика	{{Data tag.Actual working time}}
Файлы	{{{Task.Attached files}} {{Task.Task file}} {{Task.All files of the task}}

Настраиваемые поля

Настраиваемые поля:

• Список
• Набор задач
• Набор значений справочника
• Список пользователей
• Набор значений
• Файлы

Вывод всех значений в одной строке

Если использовать повторяющуюся переменную в шаблоне Word или в тексте с переменными, все значения из поля будут перечислены в одной строке через запятую.

Так выглядит переменная в шаблоне:

В сформированном документе:

Вывод значений в отдельных строках

В шаблонах Excel или таблицах Word повторяющиеся переменные автоматически дублируют строки и выводят каждое значение из поля.

Так выглядит переменная в шаблоне:

В сформированном документе:

Дополнительные настройки

Для более сложного форматирования текста с переменными можно использовать конструкции FOREACH или TABLE.

Например, конструкцию FOREACH с повторяющейся переменной можно использовать в динамическом блоке:

После сохранения блока данные будут отображаться в виде столбца:

Важно

• В конструкциях FOREACH и TABLE первым аргументом должно быть имя поля, по которому нужно выполнить перебор:

• В теле каждой конструкции нужно добавить имя переменной и указать, из какого поля брать данные:

Переменные и JSON в POST-запросах

В запросе в формате JSON повторяющаяся переменная представлена в виде массива:

Запрос сформирует корректный JSON:

{
	phone: [
		"1 (234) 567-89-01",
		"2 (345) 678-91-23",
		"+5 (6789) 12-34-56"
	]
}

Если конечная точка ожидает одну строку, а не массив, используйте переменную «Phones as a string»:

{
    phone: "{{Task.Counterparty.Phones as string}}"
}

Результат:

{
	phone: "1 (234) 567-89-01,2 (345) 678-91-23,+5 (6789) 12-34-56"
}

Перейти

• Функции