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

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


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


=== Системные поля ===
== Системные поля ==
{| class="wikitable" style="margin:auto"
 
 
{| class="wikitable"
|-
|-
! Название поля !! Пример переменной
! Поле !! Переменная
|-
|-
| Исполнители || {{Задача.Исполнитель}}
| Исполнители || <nowiki>{{Задача.Исполнитель}}</nowiki>
|-
|-
| Участники || {{Задача.Участник}}
| Участники || <nowiki>{{Задача.Участник}}</nowiki>
|-
|-
| Аудиторы || {{Задача.Аудитор задачи}}
| Аудиторы || <nowiki>{{Задача.Аудитор задачи}}</nowiki>
|-
|-
| Аналитика || {{Аналитика.Фактическое время работы}}
| Аналитика || <nowiki>{{Аналитика.Фактическое время работы}}</nowiki>
|-
|-
| Файлы || {{Задача.Прикрепленные файлы}}
| Файлы || <nowiki>{{Задача.Прикрепленные файлы}}</nowiki><br>
{{Задача.Файл задачи}}
<nowiki>{{Задача.Файл задачи}}</nowiki><br>
{{Задача.Все файлы задачи}}
<nowiki>{{Задача.Все файлы задачи}}</nowiki>
|}
|}


=== Пользовательские поля ===
== Пользовательские поля ==
*Список
*Список
*Набор задач
*Набор задач
Строка 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"
}

Перейти