Element hinzufügen (Optionales/Wiederholendes Element)
Aktionen - Kurzfassung
Die Aktion Element hinzufügen dient zum Hinzufügen eines einzelnen neuen Elements zu einem Optionale Elemente Container oder einem Wiederholendes Element Container.
Die Aktion Element hinzufügen dient zum Hinzufügen eines einzelnen neuen Elements zu einem der folgenden Containertypen:
Optionale Elemente Container
Wiederholendes Element Container
Die Aktion erscheint nur zur Auswahl unter Typ der Aktion, wenn vorher ein geeignetes Zielelement verknüpft wurde. Details werden in eigenen Abschnitten je Containertyp (unten) beschrieben.
Das Ausführen der Aktion entspricht einem Klick auf das 
Symbol im jeweiligen Kontext und kann diese Funktion ersetzen, z. B. wenn das Symbol im Formular ausgeblendet ist und das Hinzufügen von Elementen nur über Verhalten möglich sein soll.
Beide Containertypen unterstützen die verwandte Aktion zum Entfernen von Elementen: Element entfernen (Optionales/Wiederholendes Element)
|
Kontext: Optionale Elemente |
Kontext: Wiederholendes Element |
|
|
|
Während für Optionale Elemente-Container keine spezifischen Parameter anwendbar sind, können die folgenden Optionen im Kontext eines Wiederholendes Element-Containers relevant sein:
Ist die Option Daten des Verhaltensübernehmen gesetzt, dann werden an die Aktion übergebene Eingabedaten ($input) auf das durch die Aktion hinzugefügte Element angewendet, das ohne die Option mit 'leeren Elementdaten' initialisiert wird.
Die Option Neues Element auswählen erscheint nur, wenn das Wiederholendes Element die Darstellungsart "Grid" verwendet. Ist die Option gesetzt, erhält das von der Aktion hinzugefügte Element den Fokus im Grid, so dass seine Detailsdaten angezeigt werden und direkt bearbeitet werden können, sofern das überhaupt vorgesehen ist.
Optionale Elemente Container
In Verbindung mit einem Optionale Elemente Container muss als Zielelement für die Aktion eines der optionalen Elemente im Container ausgewählt werden.
Beim Ausführen der Aktion wird die als Zielelement verknüpfte Option als letztes Element im Container hinzugefügt, falls sie noch nicht ausgewählt war.
Konfigurationsbeispiel:
Der Standort eines geparkten Luftfahrzeugs soll wahlweise durch Angaben für Abstellplatz und/oder Bereich qualifiziert werden können.
Die Maske sieht für jede Angabe ein Textfeld in einem Optionale Elemente Container vor.
Die Textfelder sollen als optionale Elemente bei Bedarf über je einen Ribbon Button (Portal) aktiviert werden können.
Die Standardsymbole
und 
sollen im Formular nicht erscheinen.
Je Button wird ein Verhalten (z. B.Statisch / true) hinterlegt, das bei Angeklickt die Aktion 'Element hinzufügen' auslöst:
Ergebnis:
|
Ansicht beim Öffnen des Formulars |
nach Klick auf Button "Bereich" |
nach Klick auf Button "Abstellplatz" |
|
|
|
|
Wiederholendes Element Container
In Verbindung mit einem Wiederholendes Element Container fügt die Aktion neue Elemente hinzu, also Instanzen des Containerinhalts, der als wiederholtes Element bezeichnet werden soll.
Wo (und ggf. auch ob) im Container neue Instanzen eingefügt werden, hängt von folgenden Faktoren ab:
Ist die Aktion in einem Verhalten eines Elements innerhalb des wiederholten Elements konfiguriert, so dass zur Laufzeit ein Bezug zu einer bestimmten Instanz besteht, oder außerhalb?
Ist als Zielelement für die Aktion der Container als Ganzes oder das wiederholte Element verknüpft?
Ist für die Aktion die Option Auch für Duplikate gesetzt oder nicht?
Enthält der Container bereits Instanzen des wiederholten Elements oder ist er leer?
Ist für den Container der Parameter Max. Einträge mit einem Wert > 0 gesetzt und würde durch das Hinzufügen von Einträgen diese Grenze überschritten?
Die folgende Tabelle definiert, welche Zielsetzung bzgl. der Einfügeposition durch welche Konfiguration für die Aktion erreicht werden kann:
|
Zielsetzung |
Konfiguration |
||
|
Einfügeposition |
Wo erfolgt der Aktionsaufruf? |
Verknüpftes Zielelement |
Option "Auch für Duplikate" |
|
als erstes Element im Container |
außerhalb des wiederholten Elements |
wiederholtes Element |
nicht gesetzt |
|
als letztes Element im Container |
unerheblich |
Container |
unerheblich |
|
nach einem bestimmten Element |
innerhalb des wiederholten Elements |
wiederholtes Element |
nicht gesetzt |
|
nach jedem Element im Container |
unerheblich |
unerheblich |
gesetzt |
Konfigurationsbeispiel:
Ein Wiederholendes Element "Luftfahrzeugliste" soll die Anlage mehrerer "Luftfahrzeuge" als Elemente mit den Merkmalen Registrierung und Luftfahrzeugtyp zulassen.
Per Button Hinzufügen die bestehende Aufzählung um neue Elemente erweitert werden können.
Um das Ausfüllen komfortabler zu gestalten, soll schon beim Verlassen des Felds für den Luftfahrzeugtyp automatisch ein neues Element am Ende der Liste hinzugefügt werden.
Für den Button Hinzufügen wird ein Verhalten mit der folgenden Aktion hinzugefügt:
Dieses Verhalten könnte außerdem über Verhalten ausführen (Aktion) beim Feld verlassen (Auslöser) für den Luftfahrzeugtyp adressiert werden. Dann erscheinen neue Elemente immer am Ende der bestehenden Liste.
Stattdessen soll die Aktion zum Hinzufügen des Elements hier beim Feld verlassen (Auslöser) für den Luftfahrzeugtyp eingehängt werden, damit neue Elemente auch innerhalb einer bestehenden Liste eingefügt werden können:
►HINWEIS◄ Als Zielelement ist hier der Spaltenlayout-Container Luftfahrzeug angegeben, der im Screenshot oben hervorgehoben ist. Da die Aktion von der enthaltenen Combobox Luftfahrzeugtyp ausgeht, wird das neue Element als direkter Nachfolger des aktuellen Luftfahrzeugs eingefügt.
Ergebnis:
|
Ausgangssituation |
Nach Klick auf Button "Hinzufügen" |
|
|
Neues Element (Luftfahrzeug) erscheint:
Ausfüllen der Pflichtfelder für das neue Element:
Nach Verlassen des Felds Luftfahrzeugtyp erscheint das nächste neue Element unterhalb:
|
Option "Daten des Verhaltens übernehmen"
Die Option Daten des Verhaltens übernehmen steht nur für den "Wiederholendes Element" Container zur Verfügung. Ist diese Option gesetzt, werden die vom Verhalten gelieferten Daten für das neue Element übernommen.
Beispiel:
Werte für die Felder firstName und Nachname solle in einem bestimmten Container erfasst und dann insgesamt einem Wiederholendes Element-Container hinzugefügt werden, wenn ein Button (s. Mauszeiger) angeklickt wird.
Konfiguration:
Der Einfachheit halber entsprechen die Elementbeschriftungen ihren Datenfeldern.
Beim Klicken auf den
-Knopf wird das im Bild gezeigte Verhalten ausgeführt, das zunächst die Daten des Herkunftscontainers "source" (Element # 6) validiert. Die Aktion Element hinzufügen (Optionales/Wiederholendes Element) übernimmt diese Daten dann für das Element, das dem Zielelement "persons" (Wiederholendes Element # 3) hinzugefügt wird.