Summe Packmittel (Manifest)
Ereignisaktion - Kurzfassung
Zweck: Summiert in einem Manifest die Anzahl Packstücke für einen oder alle Verpackungstypen über alle enthaltenen Sendungen und schreibt die Summen in Verpackungssummenattribute im Manifestkopf.
Siehe auch: Summe Packmittel (Bestellung), Summe Packmittel (Sendung), Verpackungstyp
Die Ereignisaktion Summe Packmittel (Manifest) summiert die Mengenangaben für einen bestimmten Verpackungstyp (oder alle) in den in einem Bezugsobjekt vom Typ Manifest (s. Manifeste) als Manifestpositionen enthaltenen Sendungen.
Ausschlaggebend für die Anrechnung ist auf der Ebene der jeweiligen Position der Wert im Feld "Anzahl Packstücke" (numberOfPackages) und nicht etwa das Feld "Aggregierte Anzahl Packstücke" (aggregateNumberOfPackages).
ACHTUNG
Sofern für einen Positionstyp z. B. mit der Ereignisaktion Berechne aggregierte Anzahl Packstücke die "Aggregierte Anzahl Packstücke" berechnet werden soll, um in einer mehrstufigen Positionshierarchie die Anzahl der Packstücke in Unterposition kaskadierend zu skalieren, führt dies zu Unstimmigkeiten bei der Berechnung von Packmittel-Summen für jeden Verpackungstyp, der in diesen Unterpositionen vorkommt.
Die Gesamtanzahl je Verpackungstyp über alle Sendungen wird in das entsprechende Verpackungssummenattribut im Kopf des Manifests (s. Manifest-Masken) geschrieben.
Es gibt analoge Ereignisaktionen für Bestellungen (Summe Packmittel (Bestellung)) und Sendungen (Summe Packmittel (Sendung)). In Konfigurationen muss immer die "passende" Ereignisaktion für das betreffende Bezugsobjekt verwendet werden. Im Fall einer Verwechslung tritt zur Laufzeit keine Fehlermeldung auf. Die Berechnung liefert nur kein Ergebnis.
►HINWEIS◄ Die Berechnung geht immer von den genannten Detailangaben aus und berücksichtigt nicht etwa ggf. abweichende Zwischenergebnisse aus den Verpackungssummenattributen aus dem Kopf der Sendungen. Diese werden durch die Berechnung auch weder ergänzt noch aktualisiert. Um sicherzustellen, dass der Datenstand in den Sendungsköpfen konsistent zur Gesamtsumme im Manifest ist, kann bei Bedarf die Ereignisaktion Summe Packmittel (Sendung) in einer Schleife über alle Manifestpositionen aufgerufen werden. Eleganter ist eine Aktualisierung der Summenattribute jeder Sendung in einer eigenen Ereignisbehandlung, die beim "Ändern" Ereignis ausgelöst wird.
Konfiguration
Die Ereignisaktion Summe Packmittel (Manifest) erwartet als Bezugsobjekt ein Manifest (s. Manifeste). Im Kontext eines anderen Objekttyps ist die Ereignisaktion wirkungslos, ohne dass zur Laufzeit ein Fehler auftritt.
Der optionale Parameter Typ kann verwendet werden, um die Auswertung auf einen bestimmten Verpackungstyp zu begrenzen.
Ohne Angabe für den Typ wird jeder Verpackungstyp aufsummiert, der in den als Manifestpositionen enthaltenen Sendungen vorkommt.
►WICHTIG◄ Wenn kein Typ angegeben wird, aktualisiert die Aktion nur die Summenattribute der Verpackungstypen, die aktuell in Gebrauch sind. Sofern in früheren Berechnungen Summenwerte für Typen berechnet wurden, die aktuell in keiner der Sendungen mehr vorkommen, dann werden diese Werte unverändert beibehalten. Sie müssen bei Bedarf explizit zurückgesetzt bzw. gelöscht werden.
Beispiel
Immer wenn Manifeste gespeichert werden, sollen deren Verpackungssummenattribute abhängig von den als Manifestpositionen enthaltenen Sendungen aktualisiert werden.
Konfiguration:
Die Aktionen bei bestandener Regel werden wie rechts abgebildet konfiguriert:
|
|
Laufzeitbeispiel:
Das folgende Beispiel zeigt eine Erfassungsmaske für Manifeste, in der in der Kopfebene des Manifests die Verpackungssummenattribute je Verpackungstyp (hier konfiguriert: "Hobbock", "Sack" und "Fass") erscheinen.
Innerhalb der Manifestposition sind für je eine Sendung mehrere Positionen ggf. mit Unterpositionen zu sehen, für die jeweils eine Anzahl Packstücke in Verbindung mit einem Verpackungstyp angegeben werden kann.
►ANMERKUNG◄ Für die Unterpositionen gilt im Beispiel die Konvention, dass das Feld Anzahl Packstücke die absolute Anzahl von Packstücken des betreffenden Verpackungstyps angibt und nicht etwa die Anzahl von Packstücken innerhalb je Packstück in der übergeordneten Ebene. Konkret bedeutet das für die Position Nr. 2 in der zweiten Manifestposition, dass in 3 Fässern insgesamt 36 Säcke enthalten sind. Ob das 12 Säcke je Fass sind, ist damit nicht ausdrücklich definiert.
Die Verpackungssummenattribute werden beim Speichern des Manifests aktualisiert. Beim Speichern nach dem Entfernen der zweiten Manifestposition ergibt sich folgendes Bild:
►ANMERKUNGEN◄
Ohne das explizite Zurücksetzen (Löschen) aller Verpackungssummenattribute in der Ereignisbehandlung würde im Feld Fass immer noch der Wert 1 erscheinen.
Würde innerhalb der Ereignisaktion Summe Packmittel (Manifest) explizit der Typ "Fass" benannt, dann würde im Feld Fass der Wert 0 erscheinen, da dann das Attribut angelegt aber mit dem Wert 0 bewertet wird.