CONTRL erzeugen
Übersicht
Die ContrlActionStandard erzeugt eine CONTRL-Nachricht in einem vordefinierten Channel, aus dem sie dann verschickt wird. Die ContrlActionStandard nutzt dabei die Ergebnisse der ValidatorAction, die zuvor im Channel ausgeführt worden sein muss.
Bei Nachrichten, auf die nicht mit einer CONTRL reagiert werden soll, passiert nichts. Das umfasst andere CONTRL Nachrichten und, ab der Formatumstellung Juni 2025, Nachrichten ohne Fehler auf CONTRL Ebene, die in der Sparte Strom empfangen werden. Auf zweitere muss stattdessen mit einer Anerkennungsmeldung (positive APERAK) reagiert werden.
Technische Beschreibung
Klassenpfad: org.b2bbp.runtime.actions.internal.ContrlActionStandard
Einrichtung
Konfigurationsmöglichkeiten
| ActionProperty / Eigenschaften | Wert | Beschreibung |
| SET_SUC_VS_ERROR_STATE | false | Bei einer negativen CONTRL bleibt der Verarbeitungstatus standardmäßig auf SUC. Wird diese Property gesetzt erhält man statt dem SUC ein ERR Status. |
| B3P_CONTRL_PRIO |
very low / 50 |
Diese Property bietet die Möglichkeit zur Priorisierung der CONTRL-Nachrichten bei der Verarbeitung. |
| B3P_SET_CONTRL_STATE | false | |
| B3P_TARGET_CHANNEL | OUT_B2B | Diese Property gibt den Channel an über den die CONTRL verschickt werden soll |
| USE_MESSAGE_CONTEXT_COPY | false(true) | Diese Property verwendet eine Kopie des MessageContext statt des Originals, defaultValue ist "false". |
| SKIP_APERAK_AND_CONTRL | true/false (default) | Überspringt die Action. (erfordert "MessageContext überschreiben") |
| B3P_REFERENCE_NUMBER_SYSTEM_IDENTIFIER | X | Der hier angegebene Wert wird als Präfix an die Referenznummer angehangen. Zu beachten ist hierbei, dass dieser Präfix möglichst klein (nicht mehr als 4 Zeichen) ausfallen sollte, da ansonsten die Gefahr besteht, dass mehrere CONTRLs die gleiche Referenznummern bekommen! Alternativ kann der Wert in der GlobalProperty referenceNumberSystemIdentifier konfiguriert werden. Dann wird er auch für die APERAK-Generierung verwendet. |
| CONTRL_UCI7_SENDER_OVERWRITE | ILN oder dynamischer Ausdruck der eine variable ILN zurück gibt | Die Eigenschaft kann dazu verwendet werden bei einem UCI7 Fehler, bei dem der Empfänger der Originalnachricht nicht von der B2B erkannt wurde, in der versendeten Contrl im UCI Segment durch die hier angegebene ILN ersetzt wird. |
| GlobalProperty: NEXT_EDI_VERSION_NUMBER_IS_CURRENT_VERSION_NUMBER | false(true) | Wenn auf einem Testsystem die GlobalProperty NEXT_EDI_VERSION_NUMBER_IS_CURRENT_VERSION_NUMBER gesetzt ist, verhält sich die Action entsprechend der Regeln der nächsten Formatumstellung. Damit kann z.B. getestet werden, dass keine positiven CONTRLs mehr ab der ersten Formatumstellung 2025 mehr für Nachrichten der Sparte Strom erzeugt werden. |