8.5.0

Mit Steuerungselementen vom Typ „Feldwertbereich“ kann eine bestimmte Wiederholung eines wiederholten Formularfelds oder Containers – oder ein bestimmter Wert eines Formularfeld mit mehreren Werten – gesetzt werden. Innerhalb des Bereichs wird dann nur auf diese Wiederholung zugegriffen.

Parameter

Feldwiederholungen

Hier wird festgelegt, von welchen wiederholten Feldern bzw. Fieldsets oder Containern eine bestimmte Wiederholung ausgewählt werden soll. Oft wird hier nur ein einzelnes Feld eingetragen, es sind aber auch mehrere Felder möglich. Die 1. Wiederholung hat den Index 0, die 2. Wiederholung den Index 1, usw.

Formularfeldwerte

Hier wird festgelegt, von welchen Feldern mit mehreren Werten ein bestimmter Wert ausgewählt werden soll. Oft wird hier nur ein einzelnes Feld eingetragen, es sind aber auch mehrere Felder möglich. Der 1. Wert hat den Index 0, der 2. Wert den Index 1, usw. Felder mit mehreren Werten sind zum Beispiel Auswahlfelder mit der Darstellung Checkboxen.

Innerhalb des Feldwertbereichs werden alle Referenzen auf Formularfeldwert entsprechend angepasst. Der Workflow innerhalbs eines solchen Bereichs verhält sich so, als ob die Formularfelder nicht wiederholt wären oder mehrere Werte hätten. Das umfasst u.A.: Formularplatzhalter, die Befüllung mittels Aktion Formularwerte ändern, das Mitsenden von Daten bei Aktion HTTP-Request, oder die exportierten Daten bei der Aktion Als XML exportieren.

Beispiel

Ein typisches Beispiel für den Feldwertbereich ist das Befüllen der Felder eines wiederholten Fieldsets mit Daten aus eine Datenbank- oder Prompt-Abfrage. Mittels einer Listenschleife kann über die Zeilen des Abfrageresultats gelaufen werden. Innerhalb jedes Schleifendurchgangs kann dann mit dem Feldwertbereich-Element die Wiederholung des Fieldsets am aktuellen Schleifenindex betreten werden (Platzhalter [%$<Schleifenname>.CURRENT.index%]). Schließlich können innerhalb der Feldwertbereichs mit der Aktion Formularwerte ändern die Felder innerhalb des Fieldsets befüllt werden.