Summe Ladehilfsmittel (Sendung)

Ereignisaktion - Kurzfassung

Zweck: Summiert in einer Sendung die Mengenangaben für einen oder alle Ladehilfsmittel-Typen und schreibt die Summe(n) in Ladehilfsmittel-Attribute im Sendungskopf. Dabei werden alle expliziten Mengen für Ladehilfsmittel auf Positionsebene der Sendung mit der Anzahl der Ladehilfsmitteldefinitionen für denselben Ladehilfsmittel-Typ im Sendungskopf zusammengezählt.

Siehe auch: Summe Ladehilfsmittel (Manifest), Ladehilfsmittel

images/download/attachments/177912678/image-2024-9-19_12-9-51-version-1-modificationdate-1726740590982-api-v2.png

Die Ereignisaktion Summe Ladehilfsmittel (Sendung) summiert die Menge für einen oder alle Ladehilfsmittel-Typen innerhalb in den Positionen eines Bezugsobjekts vom Typ Sendung (s. Sendungen).

Dabei werden alle expliziten Angaben für Ladehilfsmittel-Mengen in allen Positionsebenen der Sendung mit der Anzahl der Ladehilfsmitteldefinitionen für denselben Ladehilfsmitteltyp zusammengezählt.

Die Gesamtsumme je Ladehilfsmittel-Typ wird in das entsprechende Ladehilfsmittel-Summenattribut im Sendungskopf geschrieben.

Es gibt eine entsprechende Ereignisaktion für Manifeste (Summe Ladehilfsmittel (Manifest)), die sich allerdings ausschließlich auf die Ladehilfsmittel-Mengen der enthaltenen Sendungen bezieht.
►HINWEIS◄ Für Manifeste ist - im Unterschied zu Sendungen - keine Möglichkeit zur Pflege von eigenen Ladehilfsmitteldefinitionen vorgesehen.

Konfiguration

images/download/attachments/177912678/image-2024-9-19_12-10-35-version-1-modificationdate-1726740634598-api-v2.png

Die Ereignisaktion Summe Ladehilfsmittel (Sendung) erwartet als Bezugsobjekt eine Sendung (s. Sendungen). 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 ein bestimmtes Ladehilfsmittel zu begrenzen.

  • Ohne Angabe für den Typ werden alle Ladehilfsmittel-Typen aufsummiert, die in den Positionen der Sendung vorkommen.

►WICHTIG◄ Wenn kein Typ angegeben wird, aktualisiert die Ereignisaktion nur die Summenattribute der Ladehilfsmittel-Typen, die aktuell in Gebrauch sind. Sofern in früheren Berechnungen Summenwerte für Typen berechnet wurden, die aktuell in keiner der Sendungspositionen mehr vorkommen, werden diese Werte unverändert beibehalten. Sie müssen bei Bedarf explizit zurückgesetzt bzw. gelöscht werden.

Beispiel

In einer Erfassungsmaske für Sendungen sollen die Summenattribute je Ladehilfsmittel per Klick auf einen Button (über ein Eigenes Aktionsevent) aktualisiert werden können. Spätestens beim Speichern der Sendung soll dieselbe Berechnung automatisch ausgelöst werden.

Konfiguration:

  • Als Auslösende Ereignisse werden "Erstellen" und "Ändern" (s. Allgemein (Ereignisse)) ausgewählt, damit die Aktualisierung der Summenattribute bei jedem "Speichern" erfolgt. Außerdem soll die Berechnung auf Anfrage über ein Eigenes Aktionsevent ("Jetzt berechnen") ausgelöst werden können.

  • Die Prüfende Regel stellt per Typprüfung sicher, dass die Aktionen bei bestandener Regel nur im Kontext einer Sendung ausgeführt werden.

Die Aktionen bei bestandener Regel werden wie rechts abgebildet konfiguriert:

  • Vor der Berechnung der Ladehilfsmittel-Summenattribute für werden durch eine Ereignisaktion vom Typ Liste modifizieren / Leeren alle bestehenden Attribute dieses Typs gelöscht, damit nach der Neuberechnung keine veralteten Angaben für ggf. nicht mehr relevante Ladehilfsmittel im Kopf der Sendung enthalten sind (s., "Wichtig" oben). Die Liste wird dabei durch einen Alle Attribute eines Typs-Wertauflöser ermittelt.

  • Anschließend wird die Ereignisaktion Summe Ladehilfsmittel (Sendung) ohne Einschränkungen für den Typ ausgeführt, so dass eine Summe für jeden Ladehilfsmittel-Typ berechnet wird, der innerhalb der Positionen der Sendung in Gebrauch ist.

images/download/attachments/177912678/image-2024-9-23_8-42-54-version-1-modificationdate-1727073773691-api-v2.png

Laufzeitbeispiel:

Das folgende Beispiel zeigt eine Erfassungsmaske für Sendungen, die in der Kopfebene der Sendung die Ladehilfsmittel-Summen je Verpackungstyp (hier konfiguriert: "EURO-Palette" und "Box") enthält.

Unterhalb können Ladehilfsmitteldefinitionen für den Sendungskopf hinzugefügt werden, die jeweils genau ein Ladehilfsmittel über Typ und Barcode identifizieren.

Im Abschnitt Positionen sind mehrere Positionen mit Unterpositionen zu sehen, für die jeweils die Menge für den je Positionsebene vordefinierten Ladehilfsmittel-Typ angegeben werden kann.

images/download/attachments/177912678/image2021-7-29_9-26-52-version-1-modificationdate-1726740580837-api-v2.png

Im Bild wurden die Ladehilfsmittel-Summen bereits per Klick auf den Button "Aufsummieren" berechnet.

Nach dem Entfernen der Unterpositionen (1.1 und 2.1) für die Warenproben wird die Sendung gespeichert. Die dabei ausgelöste Neuberechnung ergibt folgendes Bild:

images/download/attachments/177912678/image2021-7-29_9-37-57-version-1-modificationdate-1726740580832-api-v2.png

►ANMERKUNGEN◄

  • Für den Ladehilfsmittel-Typ "Box" erscheint kein Wert mehr, weil dieser Ladehilfsmittel-Typ in keiner der Positionen mehr vorkommt und weil die Ereignisbehandlung (s. oben) vor der Berechnung alle Ladehilfsmittel-Summenattribute löscht.

  • Ohne das explizite Zurücksetzen (Löschen) aller Ladehilfsmittel-Summenattribute in der Ereignisbehandlung würde im Feld Box immer noch der Wert 2 erscheinen.