Повторяющиеся переменные: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 92: Строка 92:


Запрос сформирует валидный JSON:
Запрос сформирует валидный JSON:
<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;">
<pre>
{
{
"phone": [
"phone": [
Строка 100: Строка 100:
]
]
}
}
</div>
</pre>


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

Версия от 05:51, 15 октября 2024

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

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

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

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

{{Задача.Файл задачи}}
{{Задача.Все файлы задачи}}

Пользовательские поля

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

Значения переменной в одну строку

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

VuQGHl.png


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

pGqnKd.png


Значения переменной с новой строки

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

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

H0hpPb.png


Вот так переменные развернулись в автоматически сформированном документе:

8tmFkW.png


Дополнительно

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

Например, ДЛЯКАЖДОГО с повторяющейся переменной в динамическом блоке:

lhkdlH.png


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

YHzmmT.png

Важно

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

8Lhqbo.png


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

jUon92.png


Работа переменной при отправке JSON в POST-запросах

Для запроса в формате JSON переменная представляется как массив данных.

kLd1DZ.png


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

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

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

Результат:

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

Перейти