Повторювані змінні

Матеріал з Planfix
Перейти до: навігація, пошук

Повторювані (множинні) змінні — це змінні, які використовуються для роботи з полями, що містять декілька значень (виконавці, файли тощо). Вони дозволяють автоматично виводити дані з цих полів у шаблони документів, текст зі змінними, обчислювані поля, створюючи рядки для кожного значення або об'єднуючи їх в один рядок через кому.

До полів, що містять набори значень у завданнях, контактах, проєктах, співробітниках, належать:

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

Поле Змінна
Виконавці {{Задача.Виконавець}}
Учасники {{Задача.Учасник}}
Аудитори {{Задача.Аудитор завдання}}
Аналітика {{Аналітика.Фактичний час роботи}}
Файли {{Задача.Прикріплені файли}}

{{Задача.Файл завдання}}
{{Задача.Всі файли завдання}}

Користувацькі поля

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

Значення змінної в один рядок

Якщо використовувати повторювану змінну в Word або тексті зі змінними, то всі значення поля будуть перелічені в один рядок через кому. Ось так змінна виглядає в шаблоні:

VuQGHl.png

А ось так у сформованому документі:

pGqnKd.png

Значення змінної з нового рядка

Повторювані змінні в Excel або таблиці в Word автоматично розмножують рядки і виводять всі значення, що входять у поле.

Ось так виглядають змінні в шаблоні документа:

H0hpPb.png

Ось так змінні розгорнулися в автоматично сформованому документі:

8tmFkW.png

Додатково

Для більш складного відображення даних у тексті зі змінними можна використовувати конструкції ДЛЯКАЖНОГО або ТАБЛИЦЯ.

Наприклад, ДЛЯКАЖНОГО з повторюваною змінною в динамічному блоці:

lhkdlH.png

Після збереження блоку дані відобразяться у вигляді стовпця:

YHzmmT.png

Важливо

  • У конструкціях ДЛЯКАЖНОГО і ТАБЛИЦЯ першим аргументом необхідно вказувати назву поля, по якому потрібно здійснити ітерацію:

8Lhqbo.png

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

jUon92.png

Змінна і JSON у POST-запитах

Для запиту у форматі JSON повторювана змінна представляється як масив даних:

nmrNDL.png

Запит сформує валідний JSON: 

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

Якщо очікуються дані у вигляді одного рядка, тоді використовуйте змінну Телефони рядком: 

{
    phone: "{{Задача.Контрагент.Телефони рядком}}"
}

Результат: 

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

Перейти