Ereignisaktion - Kurzfassung
Zweck: Befüllt Barcode-Attribute von Positionen einer Bestellung mit Werten aus einem Nummernkreis. Optional wird dabei die Anzahl der Barcode-Attribute innerhalb einer Position mit der "Anzahl Packstücke" derselben Position synchronisiert, indem ggf. Barcode-Attribut hinzugefügt oder entfernt werden.
Tooltip
Verwendung: Die Ereignisaktion muss mit einer Bestellung als Bezugsobjekt ausgeführt werden. Die Parameter Positionen und Positionstypen definieren relevante Positionen im Bezugsobjekt. Für diese wird die Anzahl der enthaltenen Barcode-Attribute abhängig von der Option Mit Anzahl Packstücke synchronisieren reguliert. Soweit für den ausgewählten Nummernkreistyp ein Nummernkreis zugeordnet ist, werden Barcode-Attribute ohne Barcodewert aus diesem befüllt.
Parameter:
Die verpflichtende Auswahl für den Nummernkreistyp definiert, aus welchem der konfigurierten Nummernkreise Barcodes bezogen werden sollen, um Barcode-Attribute ohne Barcode-Wert zu befüllen.
Wird die Option Mit Anzahl Packstücke synchronisieren ausgewählt, werden ggf. Barcode-Attribut-Instanzen hinzugefügt oder entfernt, damit die Anzahl der Barcodes in einer Position der "Anzahl Packtücke" entspricht.
Zur Definition der relevanten Positionen innerhalb des Bezugsobjekts stehen zwei Parameter zur Verfügung, die alternativ genutzt werden können:
Über den Parameter Positionen kann eine explizite Liste von Positionen per Wertauflöser definiert werden.
Die Mehrfachauswahl für Positionstypen erlaubt die pauschale Auswahl von Positionen über den Positionstyp.
Wird keiner der Parameter genutzt, gelten alle Positionen mit dem Positionstyp "Standard" (
DEFAULT) als relevant.Output: In relevanten Positionen wird Barcode-Attributen ohne Barcode-Wert ein Barcode aus einem Nummernkreis zugewiesen. Optional werden "fehlende" Barcode-Attribute ergänzt oder "überzählige" entfernt.
Siehe auch: Generiere Barcodes, Generiere Barcodes (Sendung)

Die Ereignisaktion Generiere Barcodes (Bestellung) erzeugt über einen bestimmten Nummernkreistyp (s. Nummernkreise) Barcodes, um diese "leeren" Instanzen von Barcode-Attributen von relevanten Positionen eines Bezugsobjekts vom Typ Bestellungen als "Barcode" (barcode) zuzuweisen.
Relevante Positionen können alternativ mit einer der folgenden Methoden definiert werden:
Der Parameter Positionen erlaubt eine explizite Definition der relevanten Positionen über einen Wertauflöser, der eine Liste von Positionen liefert (z. B. Direkte Positionen und/oder Regel-Listen Resolver).
Der Parameter Positionstypen definiert per Mehrfachauswahl einen oder mehrere Positionstypen (s. Positionstyp). Sämtliche Positionen, die einem ausgewählten Positionstyp angehören, gelten pauschal als relevante Positionen.
Liegen für keinen dieser Parameter Angaben vor, gelten pauschal sämtliche Positionen mit dem Positionstyp "Standard" (
DEFAULT) als relevant.
Alle relevanten Positionen werden nach dem folgenden Schema verarbeitet:
Ist die Option Mit Anzahl Packstücke synchronisieren in der Ereignisaktion Generiere Barcodes (Bestellung) ausgewählt, wird die Anzahl der Barcode-Attribut-Instanzen innerhalb der Position auf die "Anzahl Packstücke" (
numberOfPackages) abgestimmt:Enthält die Position aktuell mehr Barcode-Attribut-Instanzen als das Feld "Anzahl Packstücke" angibt, dann werden "überzählige" Instanzen des Barcode-Attributs am Ende der Liste entfernt. Ob diesen bereits Barcodes zugewiesen sind, spielt dabei keine Rolle.
Enthält die Position aktuell weniger Barcode-Attribut-Instanzen als das Feld "Anzahl Packstücke" angibt, dann werden der Liste am Ende zusätzliche Instanzen des Barcode-Attribute hinzugefügt.
Allen in der Position enthaltenen Barcode-Attribute, deren Feld "Barcode" (
barcode) leer ist, wird abhängig vom angegebenen Nummernkreistyp ein automatisch erzeugter Wert zugewiesen.
HINWEIS Welcher der für den ausgewählten Nummernkreistyp konfigurierten Nummernkreise herangezogen wird, um Barcode-Werte zu erzeugen, entscheidet hängt von der Auswertung von deren Zuordnungskriterien nach dem best-matching-Prinzip ab.
WICHTIG Falls für den Aufrufkontext kein Nummernkreis für den Nummernkreistyp zugeordnet wird oder der zugeordnete Nummernkreis keine Werte mehr liefert, werden einige oder alle "Barcode"-Felder nicht befüllt. Sollten dadurch Barcode-Duplikate für dieselbe Position auftreten, tritt kann das Bezugsobjekt in diesem Zustand nicht gespeichert werden (s. "Hintergrund", oben).
HINWEIS Hintergrundinformationen zu Barcodes und ein anschauliches Laufzeitbeispiel finden Sie auf der Seite für den Entitätstyp Allgemeines Geschäftsobjekt:
Konfiguration
Die Ereignisaktion Generiere Barcodes (Bestellung) erwartet als Bezugsobjekt eine Bestellung (s. Bestellungen). Im Kontext eines anderen Objekttyps ist die Ereignisaktion wirkungslos, ohne dass zur Laufzeit ein Fehler auftritt.
Die Auswahl für den Parameter Nummernkreistyp (Pflichtfeld) regelt, welche Nummernkreise als Kandidaten zum Erzeugen von Barcode-Werten in Frage kommen. Die Auswahl erfolgt per Zuordnung nach dem best-matching-Prinzip (s. Zuordnungskriterien). Die Option Mit Anzahl Packstücke synchronisieren kann ausgewählt werden, um für alle relevanten Positionen sicherzustellen, dass die Anzahl der Barcode-Attribut-Instanzen exakt mit der "Anzahl Packstücke" ( Per Standard ist die Option Mit Anzahl Packstücke synchronisieren abgewählt. Dann wird das "Barcode"-Feld - sofern leer - nur für Barcode-Attribut-Instanzen gefüllt, die in den volatilen Daten des Bezugsobjekts bereits existieren. |
|
Der Parameter Positionen kann verwendet werden, um über einen Wertauflöser relevante Positionen explizit zu definieren, deren Barcode-Attribute durch die Ereignisaktion bearbeitet werden sollen.
|
|
Alternativ kann der Parameter Positionstypen verwendet werden, um relevante Positionen, deren Barcode-Attribute durch die Ereignisaktion bearbeitet werden sollen, pauschal über ihren Positionstyp zu definieren.
HINWEIS Nur wenn weder eine Konfiguration unter Positionen noch eine Auswahl unter Positionstypen vorliegt, gelten pauschal alle Positionen mit dem Positionstyp "Standard" ( |
|


