Powtarzające się zmienne

Powtarzające się (mnożące) zmienne są używane z polami, które mogą zawierać wiele wartości (takimi jak osoby odpowiedzialne, pliki itp.). Umożliwiają automatyczne umieszczanie danych z tych pól w szablonach dokumentów, tekstach ze zmiennymi i polach obliczeniowych — przez generowanie osobnego wiersza dla każdej wartości albo połączenie wszystkich wartości w jednym wierszu, oddzielonych przecinkami. Pola, które mogą zawierać zestawy wartości w zadaniach, kontaktach, projektach i pracownikach, obejmują:

Pola systemowe

Pole	Zmienna
Osoby odpowiedzialne	{{Task.Assignee}}
Uczestnicy	{{Task.Participant}}
Audytorzy	{Task.Task auditors}
Znacznik danych	{{Data tag.Actual working time}}
Pliki	{{{Task.Attached files}} {{Task.Task file}} {{Task.All files of the task}}

Pola niestandardowe

Lista
Zestaw zadań
Zestaw wartości katalogu
Lista użytkowników
Zestaw wartości
Pliki

Wyświetlanie wszystkich wartości w jednym wierszu

Jeśli użyjesz powtarzającej się zmiennej w szablonie Word lub w tekście ze zmiennymi, wszystkie wartości z pola zostaną wyświetlone w jednym wierszu, oddzielone przecinkami. Tak wygląda zmienna w szablonie:

W wygenerowanym dokumencie:

Wyświetlanie wartości w osobnych wierszach

W szablonach Excel lub tabelach Word powtarzające się zmienne automatycznie powielają wiersze i wyświetlają każdą wartość z pola.

Tak wygląda zmienna w szablonie:

W wygenerowanym dokumencie:

Dodatkowe opcje

Aby uzyskać bardziej zaawansowane formatowanie tekstu ze zmiennymi, możesz użyć konstrukcji FOREACH lub TABLE.

Na przykład użycie FOREACH z powtarzającą się zmienną w bloku dynamicznym:

Po zapisaniu bloku dane zostaną wyświetlone w kolumnie:

Ważne

W konstrukcjach FOREACH i TABLE pierwszym argumentem musi być nazwa pola, po którym chcesz iterować:

W treści każdej konstrukcji należy dodać nazwę zmiennej i wskazać, z którego pola mają być pobierane dane:

Zmienne i JSON w żądaniach POST

W żądaniu w formacie JSON powtarzająca się zmienna jest reprezentowana jako tablica:

Żądanie wygeneruje prawidłowy JSON:

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

Jeśli punkt końcowy oczekuje pojedynczego ciągu znaków zamiast tablicy, użyj zmiennej „Phones as a string”:

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

Wynik:

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

Przejdź do

Standardowe funkcje