Повторяющиеся переменные: различия между версиями
Artem (обсуждение | вклад) (Новая страница: «{{#seo: |title=Повторяющиеся переменные |titlemode=append |keywords=функции, планфикс, переменные, повторяющиеся переменные |description=Повторяющиеся переменные }} Повторяющиеся (множащиеся) переменные — это переменные, которые используются для работы с полями, содержащими...») |
Artem (обсуждение | вклад) |
||
| (не показано 27 промежуточных версий этого же участника) | |||
| Строка 5: | Строка 5: | ||
|description=Повторяющиеся переменные | |description=Повторяющиеся переменные | ||
}} | }} | ||
Повторяющиеся (множащиеся) переменные — это переменные, которые используются для работы с полями, содержащими несколько значений (исполнители, файлы и т.д.). Они позволяют автоматически выводить данные из этих полей в шаблоны документов, текст с переменными, вычисляемые поля, создавая строки для каждого значения или объединяя их в одну строку через запятую. | '''Повторяющиеся (множащиеся) переменные''' — это переменные, которые используются для работы с полями, содержащими несколько значений (исполнители, файлы и т.д.). Они позволяют автоматически выводить данные из этих полей в шаблоны документов, текст с переменными, вычисляемые поля, создавая строки для каждого значения или объединяя их в одну строку через запятую. | ||
К полям содержащим наборы значений в задачах, контактах, проектах, сотрудниках относятся: | К полям содержащим наборы значений в задачах, контактах, проектах, сотрудниках относятся: | ||
== Системные поля == | |||
=== Пользовательские поля | {| class="wikitable" | ||
|- | |||
! Поле !! Переменная | |||
|- | |||
| Исполнители || <nowiki>{{Задача.Исполнитель}}</nowiki> | |||
|- | |||
| Участники || <nowiki>{{Задача.Участник}}</nowiki> | |||
|- | |||
| Аудиторы || <nowiki>{{Задача.Аудитор задачи}}</nowiki> | |||
|- | |||
| Аналитика || <nowiki>{{Аналитика.Фактическое время работы}}</nowiki> | |||
|- | |||
| Файлы || <nowiki>{{Задача.Прикрепленные файлы}}</nowiki><br> | |||
<nowiki>{{Задача.Файл задачи}}</nowiki><br> | |||
<nowiki>{{Задача.Все файлы задачи}}</nowiki> | |||
|} | |||
== Пользовательские поля == | |||
*Список | *Список | ||
*Набор задач | *Набор задач | ||
| Строка 64: | Строка 65: | ||
Для более сложного отображения данных в тексте с переменными можно использовать конструкции ДЛЯКАЖДОГО или ТАБЛИЦА. | Для более сложного отображения данных в тексте с переменными можно использовать конструкции ДЛЯКАЖДОГО или ТАБЛИЦА. | ||
ДЛЯКАЖДОГО с повторяющейся переменной в динамическом блоке: | Например, ДЛЯКАЖДОГО с повторяющейся переменной в динамическом блоке: | ||
https://p.pfx.so/pf/gR/lhkdlH.png | https://p.pfx.so/pf/gR/lhkdlH.png | ||
| Строка 83: | Строка 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 или тексте с переменными, то все значения поля будут перечислены в одну строку через запятую. Вот так переменная выглядит в шаблоне:
А вот так в сформированном документе:
Значения переменной с новой строки
Повторяющиеся переменные в Excel или таблице в Word автоматически размножают строки и выводят все значения, входящие в поле.
Вот так выглядят переменные в шаблоне документа:
Вот так переменные развернулись в автоматически сформированном документе:
Дополнительно
Для более сложного отображения данных в тексте с переменными можно использовать конструкции ДЛЯКАЖДОГО или ТАБЛИЦА.
Например, ДЛЯКАЖДОГО с повторяющейся переменной в динамическом блоке:
После сохранения блока данные отобразятся в виде столбца:
Важно
- В конструкциях ДЛЯКАЖДОГО и ТАБЛИЦА первым аргументом необходимо указывать название поля, по которому нужно произвести итерацию:
- Внутри текста каждой из конструкций необходимо добавить имя переменной с указанием поля, из которого нужно вывести данные:
Переменная и JSON в POST-запросах
Для запроса в формате JSON повторяющаяся переменная представляется как массив данных:
Запрос сформирует валидный 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"
}