Statusänderungen in der B2B mit ClearingCodes

Clearing Codes

Die erweiterten Clearing Codes geben der B2B die Möglichkeit bestimmte Eigenschaften beim Neustart abhängig vom Clearing Code zu setzen. So ist es z.B. möglich eine Nachricht direkt einem Channel zuzuordnen oder z.B. Aperak Checks zu überspringen.

Clearing Codes definieren

Clering Codes können über Schlüssel-Werte Paare definiert:

100=Restart 200=Versand fehlerhaft. Klärung bei Fachgruppe

Der Schlüssel ist dabei eine dreistellige Zahl. Der Wert ist die Beschreibung des Clearing Codes.

Nachrichtenkontext (MessageContext) Eigenschaften setzen

Durch das direkte Setzen von Attributen im MessageContext kann die Nachrichtenverarbeitung beim Neustart geändert werden. So kann z.B. die Formaterkennung, die Channeldistribution oder die Validierung übersprungen werden. Zudem ist es möglich den Basechannel zu setzen, sodass die Nachricht direkt diesem Channel zugeordnet ist.

Angenommen wir haben den ClearingCode xxx und die MessageContext Eigenschaften P1, P2 und P3, dann sind die Zuweisungen immer wie folgt aufgebaut:

&Properties.xxx=P1,P2,P3
&Property.xxx.P1=Value1
&Property.xxx.P2=Value2
&Property.xxx.P3=Value3

Wobei der Clearing Code in der Extension definiert sein muss (also als Key-Value-Paar).

Die Werte, welche zugewiesen werden, können wie folgt gesetzt werden:

  • &Property.xxx.P1=[String], mit [String] eine beliebige Zeichenfolge die nicht mit $ beginnt. So wird genau dieser Wert genommen.
  • &Property.xxx.P1=$DB, es wird der Wert genommen der zu der Property P1 persistiert wurde.
  • &Property.xxx.P1=$NULL, die Property wird zu NULL gesetzt
  • &Property.xxx.P1=$ClearingShort, der Kurztext der beim setzen des ClearingCodes gesetzt wurde
  • &Property.xxx.P1=$ClearingLong, der Langtext der beim setzen des ClearingCodes gesetzt wurde

Typische MessageContext Eigenschaften:

Key Beschreibung
FORCE_POSITIVE_CONTRL In der Validierung (ValidatorAction) wird kein Contrl-Fehler erzeugt, sondern auf CONTRL-Ebene positiv validiert. APERAK-Prüfung bei CONTRL-valider Nachricht
B3P_SKIP_VALIDATION Es wird keine Validierung durchgeführt. Weder CONTRL- noch APERAK-Prüfung
B3P_SKIP_APERAK_CHECK Normale CONTRL-Prüfung, keine APERAK-Prüfung
B3P_MAIL_SEC Ausgehende Nachrichten werden ohne Verschlüsselung und Signierung durch FSS verschickt
RESTART_SEND_CONTRL CONTRL wird nochmals verschickt auf Basis des Validierungsergebnisses
RESTART_SEND_APERAK APERAK wird nochmals verschickt auf Basis des Validierungsergebnisses
B3P_SKIP_CHANNEL_DISTRIBUTION Channel Distribution wird übersprungen
B3P_SKIP_FORMAT_RECOGNITION Format Recognition wird übersprungen
B3P_BASE_CHANNEL_ID Weißt die Nachricht diesem Channel zu
B3P_SKIPABLE Ist die Eigenschaft auf false gesetzt, werden Services erneut ausgeführt

Feste Meta Keys (veraltetes Verfahren - nicht empfohlen)

Bei den festen Meta Keys werden einer Menge von Clearing Codes eine Eigenschaft zugewiesen. Dies macht die Konfiguration unübersichtlich, deswegen sollen stattdessen direkt die MessageContext Eigenschaften, wie oben gezeigt, gesetzt werden.

In folgender Extension wird das Aussetzen des Aperak Checks Umgesetzt:

Beispielextension:

101=Restart ohne APERAK-Prüfung
&SkipAperakCheck=101

Momentan Sind folgende feste Meta Keys verfügbar:

Key Beschreibung Alternative MessageContext Eigenschaft
&ForcePositiveContrl In der Validierung (ValidatorAction) wird ein positives Contrl-Ergebnis erzeugt. Contrlprüfungen werden übersprungen (MPIDZ05Z06Check, DuplicateMessageCheck, WrongFormatFilterChannelDistribution, …) In der ContrlActionStandard wird eine positive Contrl erzeugt. FORCE_POSITIVE_CONTRL = true
&SkipContrlCheck dasselbe wie &ForcePositiveContrl FORCE_POSITIVE_CONTRL = true
&SkipAperakCheck Aperakprüfungen werden übersprungen. B3P_SKIP_APERAK_CHECK = true
&SkipCryptoCheck Ausgehende Nachrichten werden ohne Verschlüsselung und Signierung durch FSS verschickt aktuell keine
&PositiveCodes Nur für Easyplus  
&InWork Nur für Easyplus  

Beispiel Extension

000=In Arbeit [X]

501=Ticket [NLI]
503=Ticket [NLI] Fachlich erledigt

599=Manuell ablehnen
600=Manuell bestätigt

601=Restart ohne Validierung (keine CONTRL, keine APERAK)
602=Restart ohne CONTRL-Prüfung (pos. CONTRL, evtl APERAK)
603=Restart ohne CONTRL-Prüfung mit erneutem CONTRL/APERAK Versand (pos. CONTRL, evtl APERAK)
604=Restart ohne APERAK-Prüfung (CONTRL, keine APERAK)
605=Restart ohne CONTRL-Prüfung, ohne APERAK-Prüfung mit erneutem CONTRL Versand (pos. CONTRL, keine APERAK)

606=Restart ohne CRYPTO-Prüfung (Inbound)
607=Restart ohne CRYPTO-Prüfung (Outbound)
&SkipCryptoCheck=606;607

610=Restart mit Services
611=Neustart
612=Erledigt
613=Obsolet



&Properties.599=B3P_BASE_CHANNEL_ID,B3P_MAIL_BODY_CONTENT,B3P_SKIP_FORMAT_RECOGNITION,B3P_SKIP_CHANNEL_DISTRIBUTION,RESTART_SEND_CONTRL,RESTART_SEND_APERAK
&Property.599.B3P_BASE_CHANNEL_ID=INBOUND_MANUAL_REJECTED
&Property.599.B3P_MAIL_BODY_CONTENT=Nicht näher spezifiziertes Problem. Bitte wenden Sie sich bei Rückfragen an die unten stehenden Adresse.
&Property.599.B3P_SKIP_FORMAT_RECOGNITION=$NULL
&Property.599.B3P_SKIP_CHANNEL_DISTRIBUTION=$NULL
&Property.599.RESTART_SEND_CONTRL=true
&Property.599.RESTART_SEND_APERAK=true

&Properties.600=B3P_BASE_CHANNEL_ID,B3P_MAIL_BODY_CONTENT,B3P_SKIP_FORMAT_RECOGNITION
&Property.600.B3P_BASE_CHANNEL_ID=INBOUND_MANUAL_CONFIRM
&Property.600.B3P_MAIL_BODY_CONTENT=$ClearingLong
&Property.600.B3P_SKIP_FORMAT_RECOGNITION=$NULL

&Properties.601=SKIP_VALIDATION
&Property.601.SKIP_VALIDATION=true

&Properties.602=FORCE_POSITIVE_CONTRL,RESTART_SEND_CONTRL,RESTART_SEND_APERAK
&Property.602.FORCE_POSITIVE_CONTRL=true
&Property.602.RESTART_SEND_CONTRL=true
&Property.602.RESTART_SEND_APERAK=true

&Properties.603=FORCE_POSITIVE_CONTRL
&Property.603.FORCE_POSITIVE_CONTRL=true

&Properties.604=SKIP_APERAK_CHECK
&Property.604.SKIP_APERAK_CHECK=true

&Properties.605=FORCE_POSITIVE_CONTRL,SKIP_APERAK_CHECK,RESTART_SEND_CONTRL
&Property.605.FORCE_POSITIVE_CONTRL=true
&Property.605.SKIP_APERAK_CHECK=true
&Property.605.RESTART_SEND_CONTRL=true


&Properties.606=B3P_SKIP_CHANNEL_DISTRIBUTION,B3P_SKIP_FORMAT_RECOGNITION,B3P_BASE_CHANNEL_ID
&Property.606.B3P_SKIP_CHANNEL_DISTRIBUTION=$NULL
&Property.606.B3P_SKIP_FORMAT_RECOGNITION=$NULL
&Property.606.B3P_BASE_CHANNEL_ID=$DB

&Properties.607=B3P_SKIP_CHANNEL_DISTRIBUTION,B3P_SKIP_FORMAT_RECOGNITION,B3P_BASE_CHANNEL_ID
&Property.607.B3P_SKIP_CHANNEL_DISTRIBUTION=$NULL
&Property.607.B3P_SKIP_FORMAT_RECOGNITION=$NULL
&Property.607.B3P_BASE_CHANNEL_ID=OUTBOUND_NO_CRYPTO

&Properties.610=B3P_SKIPABLE
&Property.610.B3P_SKIPABLE=false
View Me   Edit Me