Für den Button wird ein Verhalten mit dem Name "reset" eingerichtet und wie rechts abgebildet konfiguriert:

• Wie für den Button typisch wird der Auslöser Angeklickt ausgewählt.
  
  

• Die Verhaltensweise Statisch mit dem (Standard-)Wert "ON/Wahr" stellt sicher, dass bei jedem Klick auf den Button bedingungslos die Aktionen bei "wahr" ausgeführt werden.
  
  

• Als einzige Aktion soll eine Leere Elementdaten setzen-Aktion ausgeführt werden. Diese bezieht sich per Verknüpfung auf das Zielelement "Details", bei dem es sich hier um den Container handelt der "zurückgesetzt" werden soll.
  
  

• Abweichen vom Standard (ausgewählt) wird die Option Keine Standardwerte anwenden abgewählt, damit diese ggf. berücksichtigt werden.

Das Portal wurde gerade geöffnet:

Der Screenshot rechts zeigt das Portal mit den im Layout definierten Standardwerten:

• "XQ" im Textfeld "trackingId"
  
  

• Heute+1 im Datumsbereich Feld "requestedDate"

Für die anderen Felder ("confirmedDate", "cne") ist kein Standardwert vorgesehen.

{
"trackingId": "XQ",
"requestedDate": {
"clazz": "de.lobster.scm.utils.date.DateRange",
"timeZone": "Africa/Cairo",
"start": "1691013600000",
"end": "1691013600000"
}
}

Das Portal wurde bearbeitet:

• Eine "trackingId" wurde eingetragen,

• Das "requestedDate" wurde geändert.
  
  

• Ein "cne" (Empfänger) wurde ausgewählt.

Die Formulardaten (s. letzte Spalte) spiegeln die Änderungen an den Formularelemente innerhalb (blau) und außerhalb (schwarz) des Containers "Details".

{
"trackingId": "XQ10245122561286432",
"requestedDate": {
"clazz": "de.lobster.scm.utils.date.DateRange",
"timeZone": "Africa/Cairo",
"start": "1593993600000",
"end": "1593993600000"
},
"confirmedDate": null,
"cne": {
"clazz": "java.lang.Long",
"value": "4402"
}
}

Der Button "RESET" wurde geklickt:

• Die Formularelemente innerhalb des (unsichtbaren) Containers "Details" zeigen dieselben Werte wie nach dem Öffnen des Portals (s. erster Schritt).

• Das Feld "trackingId" zeigt immer noch die eingegebene Zeichenfolge.

Es sieht also so aus, als hätte der Button "RESET" über die Leere Elementdaten setzen-Aktion die gewünschte Wirkung erzielt und nur die "Details" zurückgesetzt.

Das ist allerdings ein Trugschluss, wie ein Blick auf die Formulardaten belegt!

Im Textfeld "trackingId" wurde eine geänderte Zeichenfolge eingegeben:

• Die Formulardaten für das Feld "trackingId" spiegeln die Änderung weiterhin, was den falschen Eindruck verstärken kann, dass der "RESET" erfolgreich funktioniert.
  
  

• Die Daten für Elemente im "Details"-Container weichen immer noch von den Formulardaten ab, die hier deshalb rot dargestellt werden.

{
"trackingId": "XQ123456789",
"requestedDate": {
"clazz": "de.lobster.scm.utils.date.DateRange",
"timeZone": "Africa/Cairo",
"start": "1593993600000",
"end": "1593993600000"
},
"cne": {
"clazz": "java.lang.Long",
"value": "4402"
}
}

Neben den oben gezeigten "Details" zum Versand sollen noch einige spezifische Merkmale für den Inhalt der Sendung als Kennzeichen (flags) aus-/abwählbar sein:

• "Gefahrgut" (danger)

• "Biologische Gefahren" (bioHazard)

• "Tiertransport" (livestock)

• "Mehrweg-Verpackung" (returnable)

• "Versicherung" (insurance)

Im Screenshot rechts werden wiederum die Namen der Datenfelder als Beschriftung angezeigt.

Im JSON-Abbild der Formulardaten (ganz rechts) sind die Daten der in einem Feld/Objekt flags zusammengefassten Kennzeichen blau hervorgehoben.

Das Kennzeichen "Versicherung" (insurance) soll per Standard ausgewählt sein. Alle anderen abgewählt.

{
"details": {
...

},
"flags": {
"insurance": true,
"danger": null,
"bioHazard": true,
"livestock": true, "returnable": false,

},
"trackingId": "XQ123456789"
}

Das Verhalten "resetFlags" rechts ist für den Button "RESET ▼" im "flags"-Tab konfiguriert:

• Wie für einen Button üblich wird auch hier der Auslöser Angeklickt zugewiesen.
  
  

• Das Verhalten Statisch (mit der Option "true") sorgt auch hier dafür dass die Aktionen bei "wahr" bedingungslos ausgeführt werden.
  
  

• Die Aktion Leere Elementdaten setzen bezieht sich auf das Tab-Element "flags" als Zielelement. Die Option Keine Standardwerte anwenden ist wie im ersten Beispiel abgewählt.

►HINWEIS◄ Der Screenshot zeigt die Standardwerte für die Checkbox-Elemente im "flags"-Tab:

• Die "insurance" -Checkbox ist "ON".

• Alle anderen sind per Standard "OFF".

Das Verhalten "resetFlags" rechts ist für den Button "RESET ►" links neben dem Tab Panel (Registerkarten)-Element bekonfiguriert:

• Wie für einen Button üblich wird auch hier der Auslöser Angeklickt zugewiesen.
  
  

• Das Verhalten Statisch (mit der Option "true") sorgt auch hier dafür dass die Aktionen bei "wahr" bedingungslos ausgeführt werden.
  
  

• Die Aktion Leere Elementdaten setzen wird hier zwei Mal mit unterschiedlichen Zielelement-Verknüpfungen beansprucht, um jeden Tab individuell "zurückzusetzen". In beiden Fällen wird die Option Keine Standardwerte anwenden abgewählt.

►ANMERKUNG◄ Vereinfachen ließe sich das Vorgehen nur, indem ein übergeordnetes Datenfeld adressiert wird. Dann würde dieses aber auch zwangsläufig in der Datenstruktur der Formulardaten auftauchen.

Anstelle des zweiten Aufrufs der Aktion Leere Elementdaten setzen könnte man auch über eine Verhalten ausführen-Aktion das Verhalten "resetFlags" aufrufen. Dann wäre sichergestellt, dass für das Zurücksetzen der Flags in beiden Fällen zuverlässig dieselbe Logik (etwa für die Option Keine Standardwerte anwenden) greift.

─ Klick ─►

{
"details": {
"requestedDate": {
"clazz": "de.lobster.scm.utils.date.DateRange",
"timeZone": "Africa/Cairo",
"start": "1691013600000",
"end": "1691013600000"

}
},
"flags": {
"insurance": true
},
"trackingId": "XQ123456789"
}

Auf Kopfebene des Portals soll ein zusätzliches Kennzeichen "test" angeboten werden, mit dem signalisiert werden kann, dass es sich bei den Eingaben um Testdaten handelt. Das Merkmal kann z. B. steuern ob bestimmte Schritte in einem ausgelösten Workflow stattfinden oder nicht.

Wie im Screenshot rechts zu sehen, orientiert sich nicht nur die Mimik (Icon und Checkbox mit Darstellungsart "Togglebox") an den Konfigurationen im "flags"-Tab. Auch der Hinweis auf den Datenfeld-Namen "flags.text" in der Beschriftung verdeutlicht, dass das Kennzeichen zusammen mit den anderen im Feld/Objekt "flags" lokalisiert sein soll, obwohl es im Formularkopf platziert ist.

{
"details": {
...
},
"flags": {
"test": true,
"insurance": true
},
"trackingId": "XQ"
}

►HINWEIS◄ Wie das JSON-Abbild der Formulardaten oben zeigt, erscheint das "test"-Kennzeichen (oben blau hervorgehoben) wie gewünscht zusammen mit den anderen Kennzeichen im "flags"-Feld, wenn es wie im Bild ausgewählt bzw. "eingeschaltet" wird.

← Ausgangssituation:

• Dem "test"-Kennzeichen ist der Standardwert "Ausgewählt" zugewiesen.
  
  

• Im "flags"-Tab ist nur das "insurance"-Kennzeichen ausgewählt. Dies entspricht unserem Standardzustand, der auch nach einem "RESET" erwartet wird.

Ein Klick auf den Button "RESET ▼" im "flags"-Tab ändert in dieser Situation nichts am Erscheinungsbild des Portals.

Um sicherzustellen, dass nach einem "RESET" im "flags"-Tab auch alle Formularelemente außerhalb des Tabs die dadurch geänderten Formulardaten berücksichtigen, sollte direkt nach der Aktion Leere Elementdaten setzen die Aktion Elementdaten neu laden ausgeführt werden:

• Als Zielelement verknüpfen wir hier explizit das gesamte Formular.

• Die Option Keine Standardwerte anwenden ist hier abgewählt, damit leeren Feldern ggf. definierte Standardwerte zugewiesen werden.

►WICHTIG◄ Die Zuweisung von Standardwerten betrifft alle Formularelemente, die sich auf Datenfelder beziehen, für die die Formulardaten keinen Wert ($null) beinhalten und nicht etwa nur die durch die vorherige Aktion "geleerten". Insofern gibt es sicher auch Szenarien, in denen es sinnvoll sein kann die Option Keine Standardwerte anwenden in beiden Aktionen unterschiedlich zu behandeln.