Direkte Positionen
Wertauflöser - Kurzfassung
Zweck: Liefert eine Liste von Positionen für einen bestimmten Positionstyp, die der Entität im Eingabewert direkt untergeordnet sind.
|
Auf Kopfebene: |
Innerhalb der Positionshierarchie: |
|
|
|
Der Direkte Positionen-Wertauflöser liefert eine Liste von Positionen für einen bestimmten Positionstyp, die der Entität im Eingabewert direkt untergeordnet sind.
Der Wertauflöser ermöglicht nicht nur den Zugriff auf bestehende Positionen innerhalb der Hierarchie, sondern ist auch nützlich, um der bestehenden Positionshierarchie in Verbindung mit dem Listenwert-Wertauflöser gezielt neue Positionen hinzuzufügen.
Er ist ausschließlich für den Kontext von Entitäten bestimmt, deren Typdefinition eine Positionshierarchie unterstützt. Innerhalb der Geschäftstransaktionsobjekte betrifft das Bestellungen, Sendungen und den Typ Allgemeines Geschäftsobjekt aber nicht Manifeste, da diese nicht über eine Positionshierarchie verfügen, sondern nur eine einzige Ebene von "Manifestpositionen" (mit den dem Manifest zugeordneten Sendungen) beinhalten.
Das Erscheinungsbild des Wertauflösers unterscheidet sich abhängig von der Ebene der Positionshierarchie, auf der er eingesetzt wird:
Auf Kopfebene (s. Bild oben links) - wenn der Eingabewert die übergeordnete Entität der Positionshierarchie angibt - muss über den Parameter Vom Typ der Positionstyp ausgewählt werden, für den die Positionen der obersten Hierarchieebene zurückgegeben werden sollen.
Innerhalb der Positionshierarchie - wenn der Eingabewert eine bestimmte hierarchische Position innerhalb der Hierarchie angibt - ist der Positionstyp durch die übergeordnete Position bereits vorbestimmt, so dass der Parameter entfällt.
Konfiguration
Beim Einsatz auf Kopfebene muss der Positionstyp ausgewählt werden. Für Lesezugriffe auf bestehende Positionen wirkt die Auswahl als Filter. Noch wichtiger ist die Auswahl, wenn über den Listenwert-Wertauflöser neue Positionen hinzugefügt werden sollen. Denn dann deklariert die Auswahl im Wertauflöser, welcher Positionstyp hinzugefügt werden soll.
|
Das Auswahlfeld für den Parameter Vom Typ (in Verbindung mit dem Namen des Wertauflösers zu lesen als "Direkte Positionen ... Vom Typ:") bezieht sich auf die Dynamische Aufzählung Positionstyp und unterstützt wie recht gezeigt eine Suchfunktion. Im Kontext der Konfiguration anwendbare Dynamische Aufzählungsfilter für den Positionstyp können die Auswahloptionen einschränken. Auf das Laufzeitverhalten haben solche Einschränkungen keinen Einfluss. |
|
Beispiele
Auf Kopfebene eine Position eines bestimmten Positionstyps hinzufügen
Bei der Neuanlage einer Bestellung soll automatisch eine Service-Position mit Standarddaten angelegt werden.
Konfiguration:
|
Die rechts abgebildete Ereignisbehandlung reagiert auf das Auslösende Ereignis "Neu" (s. Allgemein (Ereignisse)), wird also aktiv, wenn in einer Erfassungsmaske der Button "Neu" betätigt wird. Der ideale Zeitpunkt, um die Daten der neuen Entität automatisch zu initialisieren. Die Prüfende Regel stellt durch eine Typprüfung sicher, dass es sich bei der neuen Entität um eine Bestellung handelt. Nur dann sollen die folgenden Aktionen ausgeführt werden. Als Aktion bei bestandener Regel wird eine Ausführen mit-Ereignisaktion ausgeführt. Über deren Parameter Objekt Resolver wird die neue Service-Position als Bezugsobjekt für den unterhalb folgenden Aktionsblock definiert:
Im Aktionsblock kann die neue Position nach Bedarf mit Standardwerten besetzt werden. Im Beispiel wird durch eine Setze Wert-Ereignisaktion nur dem Textattribut "Warenbeschreibung" ein Standardwert zugewiesen. |
|
Auf "Unterpositionen" mit bestimmten Eigenschaften prüfen
Ein Client Workflow soll im Kontext einer Erfassungsmaske für Sendungen feststellen, ob zu einer in der Maske angezeigten Position Unterpositionen existieren, für die das Kennzeichenattribut "Gefahrgut" gesetzt ist. Abhängig vom Ergebnis der Suche soll im Kontext der Position ein Warnsymbol aktiv (rot) oder inaktiv (hellgrau) erscheinen.
Laufzeitbeispiel:
Das Warnsymbol für "Gefahrgut" erscheint nur in der Positionszeile, wenn für mindestens eine (direkte) Unterposition der Position das Kennzeichenattribut "Gefahrgut" gesetzt ist.
Die Unterpositionen selbst werden in der Erfassungsmaske nicht angezeigt.
Konfiguration:
|
Der rechts abgebildete Client-Workflow wird in der Erfassungsmaske für Sendungen beim Laden der Daten je Positionszeile mit den ausgeführt. Über eine Verknüpfung mit dem Element Container für die Positionsdaten als Eingabewert die "Sendungsposition" bereitgestellt.
|
|
