Ereignisaktion - Kurzfassung
Zweck: Aggregiert für einen oder mehrere Positionstypen in einer Bestellung die Einzelwerte für einen ausgewählten Nummerntyp in einer Quellebene der Positionshierarchie, um Teilsummen für die Positionen einer übergeordneten Zielebene zu berechnen. Dabei werden die Teilsummen dem (aggregierten) numerischen Attribut desselben Nummerntyps in der Zielebene als Wert (
value) zugewiesen.Tooltip
Verwendung: Die Ereignisaktion muss mit einer Bestellung als Bezugsobjekt ausgeführt werden. Die Berechnung berücksichtigt die ausgewählten Positionstypen und summiert innerhalb der zugehörigen Positionshierarchie die Werte der aggregierten numerischen Attribute für genau einen Nummerntyp (Typ) in der angegebenen Quellebene, um den Positionen einer übergeordneten Zielebene Teilsummen zuzuordnen. Dabei kann eine Rundung der Einzelwerte auf einen begrenzte Anzahl Dezimalstellen festgelegt werden.
Parameter:
Die Einfachauswahl für den Parameter Typ (Nummerntyp) definiert welche numerischen Attribute aggregiert werden sollen.
Die Zielebene legt absolut (≥0) oder relativ zur tiefsten Ebene (<0) fest, in welcher Ebene der Positionshierarchie Teilsummen geschrieben werden sollen.
Die Quellebene legt absolut (>0) oder relativ zur tiefsten Ebene (≤0) fest, aus welcher Ebene der Positionshierarchie Einzelwerte summiert werden sollen.
Die Anzahl Dezimalstellen definiert ob (0=keine Rundung) bzw. auf wie viele (>0) Nachkommastellen die Einzelwerte vor der Aggregation gerundet werden sollen.
Die Berechnung wird auf die Positionshierarchien der per Mehrfachauswahl definierten Positionstypen angewendet.
Output: Aktualisierungen für die Werte der numerischen Attribute für den per Typ ausgewählten Nummerntyp in Positionen der Zielebene für alle ausgewählten Positionstypen.
HINWEIS Die Kopfebene des Bezugsobjekts kann als Zielebene mit dem Wert 0 adressiert werden. Allerdings funktioniert die Aggregation auf Kopfebene nur mit einer Einfachauswahl für den Parameter Positionstypen korrekt.
WARNUNG Wenn die Quellebene unterhalb einer Position der Zielebene keine Einzelwerte enthält, wird dem aggregierten numerischen Attribut dieser Position der Wert 0 zugewiesen.
Siehe auch: Summiere numerisches Attribut, Summe numerisches Attribut (Sendung)
Die Ereignisaktion Summe numerisches Attribut (Bestellung) bildet innerhalb der Positionshierarchie eines Bezugsobjekts vom Typ Bestellungen Teilsummen für die Werte von numerischen Attributen für genau einen per Typ ausgewählten Nummerntyp.
Dabei wird für jede Position einer wählbaren Zielebene (Zielposition) eine Teilsumme ermittelt, die alle Einzelwerte aus einer wählbaren untergeordneten Quellebene zusammenfasst. Die Summe der Einzelwerte aus den direkten oder indirekten Unterpositionen wird dem aggregierten numerischen Attribut für denselben Nummerntyp auf der Zielebene als Wert zugewiesen. Ein an der Zielposition bestehender Wert wird dabei überschrieben. Die Teilsumme wird abhängig von der Einstellung für den Parameter Anzahl Dezimalstellen gerundet oder nicht.
ACHTUNG Beinhaltet die Teilhierarchie unterhalb einer bestimmten Zielposition für den aufzusummierenden Nummerntyp keine Werte in der Quellebene , dann wird für die Zielposition der Wert 0 zugewiesen.
Quellebene und Zielebene können wahlweise absolut oder relativ zur tiefsten Hierarchieebene identifiziert werden (s. "Konfiguration"). Unter Umständen kann auch die Kopfebene des Bezugsobjekts als Zielebene dienen.
HINWEIS Unabhängig davon ob absolute oder relative Bezüge verwendet werden, muss die Zielebene effektiv immer oberhalb der Quellebene liegen, sonst findet keine Aggregation statt.
Der Parameter Positionstypen definiert per Mehrfachauswahl eine Positivliste für die für die Aggregation relevanten Positionstypen. Ohne Angaben für den Positionstyp gelten nur Positionen des Typs "Standard" (DEFAULT) als relevant.
Die Ereignisaktion Summiere numerisches Attribut bearbeitet nur die volatilen Daten des Bezugsobjekts und speichert dieses nicht.
Für die Entitätstypen Allgemeines Geschäftsobjekt und Sendungen werden spezifische Varianten dieser Ereignisaktion angeboten, die nach denselben Prinzipien funktionieren.
HINWEIS Ein anschauliches Laufzeitbeispiel finden Sie auf der Seite für den Entitätstyp Allgemeines Geschäftsobjekt:
Konfiguration
Die Ereignisaktion Summiere numerisches Attribut erwartet als Bezugsobjekt eine Bestellung (s. Bestellungen). Im Kontext von Entitäten anderer Typen ist die Ereignisaktion wirkungslos, ohne dass zur Laufzeit ein Fehler auftritt.
Der Typ bestimmt als Pflichtfeld statisch per Einfachauswahl den Nummerntyp der Attribute, deren Werte aufsummiert werden sollen. Der Parameter Zielebene definiert über einen positiven oder negativen ganzzahligen Index die Hierarchieebene, für die Teilsummen berechnet werden sollen:
Der Parameter Quellebene definiert definiert über einen positiven oder negativen ganzzahligen Index die Hierarchieebene, in der nach Einzelwerten für den Nummerntyp gesucht werden soll:
Die Anzahl Dezimalstellen definiert ob und ggf. wie beim Aufsummieren gerundet wird:
Relevante Positionstypen für die Berechnung können per Mehrfachauswahl qualifiziert werden. |
|
HINWEIS In Lobster Data Platform / Orchestration begründet jeder Positionstyp eine eigenständige Positionshierarchie, so dass die Teilsummen immer nur Einzelwerte für denselben Positionstyp zusammenfassen. Sind mehrere Positionstypen als relevant ausgewählt, dann wird das gesamte Berechnungsverfahren der Ereignisbehandlung sequenziell für jeden relevanten Positionstyp wiederholt. Daher sind folgende Aspekte zu berücksichtigen:
| |
