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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
 
(не показано 19 промежуточных версий этого же участника)
Строка 5: Строка 5:
|description=Повторяющиеся переменные
|description=Повторяющиеся переменные
}}
}}
Повторяющиеся (множащиеся) переменные — это переменные, которые используются для работы с полями, содержащими несколько значений (исполнители, файлы и т.д.). Они позволяют автоматически выводить данные из этих полей в шаблоны документов, текст с переменными, вычисляемые поля, создавая строки для каждого значения или объединяя их в одну строку через запятую.
'''Повторяющиеся (множащиеся) переменные''' — это переменные, которые используются для работы с полями, содержащими несколько значений (исполнители, файлы и т.д.). Они позволяют автоматически выводить данные из этих полей в шаблоны документов, текст с переменными, вычисляемые поля, создавая строки для каждого значения или объединяя их в одну строку через запятую.


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


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


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


{| class="wikitable"
{| class="wikitable"
|-
! Поле !! Переменная
|-
| Исполнители || <nowiki>{{Задача.Исполнитель}}</nowiki>
| Исполнители || <nowiki>{{Задача.Исполнитель}}</nowiki>
|-
|-
Строка 26: Строка 29:
|}
|}


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


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


https://p.pfx.so/pf/gR/lhkdlH.png
https://p.pfx.so/pf/gR/lhkdlH.png
Строка 82: Строка 84:
https://p.pfx.so/pf/22/jUon92.png
https://p.pfx.so/pf/22/jUon92.png


== Переменная и JSON в POST-запросах ==
Для запроса в формате JSON повторяющаяся переменная представляется как массив данных:
https://p.pfx.so/pf/ex/nmrNDL.png
Запрос сформирует валидный JSON:
<pre>
{
phone: [
"1 (234) 567-89-01",
"2 (345) 678-91-23",
"+5 (6789) 12-34-56"
]
}
</pre>
Если ожидаются данные в виде одной строки, тогда используйте переменную Телефоны строкой:
<pre>
{
    phone: "{{Задача.Контрагент.Телефоны строкой}}"
}
</pre>
Результат:
<pre>
{
phone: "1 (234) 567-89-01,2 (345) 678-91-23,+5 (6789) 12-34-56"
}
</pre>


== Перейти ==
== Перейти ==
*[[Функции]]
*[[Функции]]

Текущая версия от 14:28, 28 октября 2024

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

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

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

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

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

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

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

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

Если использовать повторяющуюся переменную в 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"
}

Перейти