Wiederkehrende Variablen

Aus Planfix
Wechseln zu: Navigation, Suche

Repeating (multiplying) variables werden mit Feldern verwendet, die mehrere Werte enthalten können (z. B. Zuweisende/r, Dateien usw.). Sie ermöglichen, dass Daten aus diesen Feldern automatisch in Dokumentvorlagen, Text mit Variablen und berechnete Felder ausgegeben werden – entweder indem für jeden Wert eine eigene Zeile erzeugt wird oder indem alle Werte in einer einzigen, durch Kommas getrennten Zeile zusammengefasst werden. Felder, die in Aufgaben, Kontakten, Projekten und Mitarbeiter/innen Mengen von Werten enthalten können, sind:

Systemfelder

Feld Variable
Zuweisende/r {{Task.Assignee}}
Teilnehmer/in {{Task.Participant}}
Prüfer/in {Task.Task auditors}}
Daten-Tag {{Data tag.Actual working time}}
Dateien {{{Task.Attached files}}

{{Task.Task file}}
{{Task.All files of the task}}

Anpassbare Felder

Anpassbare Felder

  • Liste
  • Task set
  • Directory values set
  • Users list
  • Values set
  • Files

Alle Werte in einer Zeile ausgeben

Wenn Sie eine wiederholende Variable in einer Word-Vorlage oder in Text mit Variablen verwenden, werden alle Werte des Feldes in einer einzigen Zeile ausgegeben, getrennt durch Kommata. So sieht die Variable in der Vorlage aus:

X8QVqZ.png

Im erzeugten Dokument:

Iv6sWO.png

Werte in separaten Zeilen ausgeben

In Excel-Vorlagen oder in Word-Tabellen duplizieren wiederholende Variablen automatisch Zeilen und geben jeden im Feld enthaltenen Wert in einer eigenen Zeile aus.

So sieht die Variable in der Vorlage aus:

ComkgY.png

Im erzeugten Dokument:

fT6xSe.png

Zusätzliche Optionen

Für erweiterte Formatierung im Text mit Variablen können Sie die Konstrukte FOREACH oder TABLE verwenden.

Beispiel: Verwendung von FOREACH mit einer wiederholenden Variable in einem dynamischen Block:

Q3JNJU.png

Nach dem Speichern des Blocks werden die Daten als Spalte angezeigt:

b67SQL.png

Wichtig

  • Im FOREACH- und TABLE-Konstrukt muss das erste Argument der Feldname sein, über den Sie iterieren möchten:

SKkY8R.png

  • Innerhalb des Körpers jedes Konstrukts müssen Sie den Variablennamen hinzufügen und angeben, aus welchem Feld die Daten entnommen werden sollen:

VpAqFg.png

Variablen und JSON in POST-Requests

Für eine JSON-formatierte Anfrage wird eine wiederholende Variable als Array dargestellt:

H2VJgq.png

Die Anfrage erzeugt gültiges JSON: 

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


Wenn der Endpunkt statt eines Arrays einen einzelnen String erwartet, verwenden Sie die Variable „Phones as a string“: 

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


Ergebnis: 

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


Gehe zu