Powtarzające się zmienne

Z Planfix
Skocz do: nawigacja, szukaj

Powtarzające się (mnożące) zmienne używane są z polami, które mogą zawierać wiele wartości (np. osoby odpowiedzialne, pliki itp.). Pozwalają one automatycznie wypisywać dane z tych pól w szablonach dokumentów, tekście ze zmiennymi oraz w polach obliczanych — albo generując osobny wiersz dla każdej wartości, albo łącząc wszystkie wartości w jedną linię rozdzieloną 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

Pola niestandardowe

  • Lista
  • Zestaw pól zadania
  • 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ą wypisane w jednej linii, rozdzielone przecinkami. Oto jak wygląda zmienna w szablonie:

X8QVqZ.png

W wygenerowanym dokumencie:

Iv6sWO.png

Wyświetlanie wartości w oddzielnych wierszach

W szablonach Excel lub w tabelach Word powtarzające się zmienne automatycznie duplikują wiersze i wypisują każdą wartość zawartą w polu.

Oto jak wygląda zmienna w szablonie:

ComkgY.png

W wygenerowanym dokumencie:

fT6xSe.png

Dodatkowe opcje

Dla bardziej zaawansowanego formatowania w tekście ze zmiennymi możesz użyć konstrukcji FOREACH lub TABLE.

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

Q3JNJU.png

Po zapisaniu bloku dane zostaną wyświetlone jako kolumna:

b67SQL.png

Ważne

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

SKkY8R.png

  • Wewnątrz ciała każdej konstrukcji musisz dodać nazwę zmiennej i określić, z którego pola mają być pobierane dane:

VpAqFg.png

Zmienne i JSON w żądaniach POST

Dla żądania sformatowanego jako JSON powtarzająca się zmienna jest reprezentowana jako tablica:

H2VJgq.png

Żądanie wygeneruje poprawny JSON: 

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

Jeśli endpoint oczekuje pojedynczego łańcucha 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