Gefahrgutpunkte ermitteln

Wertauflöser - Kurzfassung

Zweck: Wertet die im Bezugsobjekt enthaltenen Gefahrgutattribute aus, um in Verbindung mit den ADR-Details des jeweiligen Gefahrstoffs eine Gesamtpunktzahl zu ermitteln.


images/download/attachments/78258647/image2020-1-21_10-16-44-version-1-modificationdate-1629800712794-api-v2.png

Der Wertauflöser Gefahrgutpunkte ermitteln wertet die im Bezugsobjekt enthaltenen Gefahrgutattribute aus, um in Verbindung mit den ADR-Details des jeweiligen Gefahrstoffs eine Gesamtpunktzahl zu ermitteln.

Die Berechnung kann für einzelne Manifeste, Sendungen, Bestellungen, oder ein Allgemeines Geschäftsobjekt ausgeführt werden.

Außerdem können einzelne Positionen der genannten Geschäftsobjekt-Typen übergeben werden. Dabei werden nur Gefahrgutattribute berücksichtigt, die (über einen Produkt-Knoten) direkter Bestandteil der Positionsdaten sind. Unterpositionen müssen bei Bedarf individuell ausgewertet werden, da diese nicht wirklich Bestandteil der Datenstruktur der übergeordneten Position sind.

Für jedes einzelne Gefahrgutattribut wird dabei folgender Rechengang vollzogen:

  1. Ausgehend vom Feld Außenmenge (outerQuantity) wird die anzurechnende Menge ermittelt. Die Außenmenge wird dabei durch eine Kombination von Außenmenge Wert (value) und Außenmenge Einheit (unit) beschrieben, wobei die Einheit aus den Dynamischen Aufzählungen für Gewicht- & Masseneinheiten oder Volumeneinheit wählbar ist. Abhängig vom Typ der Einheit erfolgt eine Umrechnung in die anwendbare Basismengeneinheit für Gefahrgutpunkte, nämlich Liter (l) für Volumenangaben oder Kilogramm (kg) für Massen. Valide Umrechnungsvorschriften müssen in den betreffenden Dynamischen Aufzählungen hinterlegt sein.

  2. Die anzurechnende Menge wird für jedes einzelne Gefahrgutattribut auf einen ganzzahligen Wert für die Basismengeneinheit für Gefahrgutpunkte (l oder kg) abgerundet.

    images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg ACHTUNGimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg Durch dieses "Abschneiden von Nachkommastellen" steuert das einzelne Attribut u. U. weniger Gefahrgutpunkte zum Gesamtergebnis bei als bei Anwendung anderer Rechen- oder Rundungsvorschriften. Ob diese Standard-Berechnungslogik dem Verwendungszweck in einem konkreten Anwendungskontext exakt entspricht, ist im Einzelfall kritisch zu prüfen. Bestehen Zweifel oder sind abweichende Anforderungen spezifiziert, sollte der Rechengang mit anderen Mitteln explizit vollzogen werden (z. B. per Für jeden Eintrag wiederholen (Schleife) in einer Ereignisbehandlung).

  3. Der ganzzahlige Wert der anzurechnenden Menge eines Gefahrgutattributs wird mit dem Multiplikator (multiplier) multipliziert, der in den ADR-Details für den betreffenden Gefahrstoff (Stammdaten) hinterlegt sein muss. Diese Multiplikation ergibt die Gefahrgutpunkte des einzelnen Gefahrgutattributs.

  4. Als Gesamtergebnis wird die Summe der Gefahrgutpunkte aller ausgewerteten Gefahrgutattribute zurückgegeben. Der Rückgabewert ist immer vom Ganzzahl-Datentyp Long, sodass der Standardwert 0 auch dann zurückgegeben wird, wenn keinerlei Gefahrgutattribute gefunden werden.

Konfiguration

Der Wertaufllöser Gefahrgutpunkte ermitteln erwartet ein Bezugsobjekt das Gefahrgutattribute enthält bzw. enthalten kann.

Er verwendet keine Parameter.

Beispiel

Ein Zuordnungskriterium soll prüfen, ob die Summe der Gefahrgutpunkte aus den durch ein Manifest zusammengefassten Sendungen einen bestimmten Grenzwert (hier: 1000 Punkte) überschreitet oder nicht.

Konfiguration:

Das Zuordnungskriterium wird wie rechts abgebildet konfiguriert:

  • Innerhalb einer UND-Verknüpfung stellt zunächst eine Typprüfung sicher, dass als Bezugsobjekt eine Entität des Typs "Manifest" (s. Manifeste) vorliegt.

  • Sofern ein "Manifest" als Bezugsobjekt vorliegt, wird die unterhalb angeordnete Objekt-Feld-Regel ausgewertet. Diese ermittelt über den Gefahrgutpunkte ermitteln-Wertauflöser die Summe der Gefahrgutpunkte für das Manifest. Das Ergebnis wird mit dem statisch definierten Grenzwert von 1000 Punkten verglichen. Die Regel nur als "bestanden", wenn dieser überschritten wird (s. Vergleiche mit (Formulardesigner)).

    ►WICHTIG◄ Die Warnung zur Rundung (s. Punkt 2 im oben beschriebenen "Rechengang") muss unbedingt beachtet werden, wenn von diesem Zuordnungskriterium operative Entscheidungen abhängen.

images/download/attachments/78258647/image2020-1-21_10-22-58-version-1-modificationdate-1629800712789-api-v2.png