Opakující se proměnné

Opakující se (násobící) proměnné se používají u polí, která mohou obsahovat více hodnot (např. Vykonavatelé, soubory apod.). Umožňují automaticky vkládat údaje z těchto polí do šablon dokumentů, textu s proměnnými a vypočítaných polí – buď tak, že vygenerují samostatný řádek pro každou hodnotu, nebo tak, že všechny hodnoty spojí do jediného řádku odděleného čárkami. Pole, která mohou obsahovat sady hodnot v úkolech, kontaktech, projektech a zaměstnancích, zahrnují:

Systémová pole

Pole	Proměnná
Vykonavatelé	{{Task.Assignee}}
Účastníci	{{Task.Participant}}
Auditoři	{Task.Task auditors}}
Datový tag	{{Data tag.Actual working time}}
Soubory	{{{Task.Attached files}} {{Task.Task file}} {{Task.All files of the task}}

Vlastní pole

Seznam
Sada pro úkoly
Hodnoty adresáře - sada
Seznam uživatelů
Hodnoty - sada
Soubory

Výstup všech hodnot v jednom řádku

Pokud použijete opakující se proměnnou v Word šabloně nebo v textu s proměnnými, budou všechny hodnoty z pole vypsány do jednoho řádku, oddělené čárkami. Takto vypadá proměnná ve šabloně:

Vygenerovaný dokument:

Výstup hodnot na samostatných řádcích

V Excel šablonách nebo v tabulkách ve Wordu opakující se proměnné automaticky duplikují řádky a vypisují každou hodnotu obsaženou v poli.

Takto vypadá proměnná ve šabloně:

Vygenerovaný dokument:

Další možnosti

Pro pokročilejší formátování v textu s proměnnými můžete použít konstrukce FOREACH nebo TABLE.

Například použití FOREACH s opakující se proměnnou v dynamickém bloku:

Po uložení bloku budou data zobrazena jako sloupec:

Důležité

V konstrukcích FOREACH a TABLE musí být prvním argumentem název pole, přes které chcete iterovat:

Uvnitř těla každé konstrukce musíte přidat název proměnné a určit, z kterého pole se mají data brát:

Proměnné a JSON v POST požadavcích

Pro požadavek formátovaný jako JSON je opakující se proměnná reprezentovaná jako pole (array):

Požadavek vygeneruje validní JSON:

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

Pokud endpoint očekává místo pole jediný řetězec, použijte proměnnou „Phones as a string“:

{
    phone: "{{Task.Counterparty.Phones as string}}"
}

Výsledek:

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

Přejít na

Standardní funkce