APERAK Z28 Check

Übersicht

Es gibt verschiedene Wege um eine Referenzprüfung (ab 01.10.2017 APERAK Z33, vorher Z28) bzgl. der Referenz auf eine Ursprungs- oder Initialnachricht durchzuführen.

Folgende Variante ist veraltet und wird demnächst entfernt: An der AperakAction kann der Z28-Check eingeschaltet werden. Zusätzlich können die unten aufgeführten Eigenschaften hinzugefügt werden.

Bei der Prüfung werden die Vorgangs-Referenzierung der Nachrichten untereinander geprüft, z. B. dass für eine UTILMD Antwortnachricht eine entsprechende UTILMD Anfragenachricht existiert. Falls die Initialnachricht nicht gefunden wird, wird eine APERAK Z28 erstellt!

Für die Suche nach den Vorgangsnummern wird der Volltextindex benutzt. Es kann also vorkommen, dass die Initialnachricht noch nicht im Volltextindex auffindbar ist, wenn die Antwortnachricht validiert wird. Die erweiterte Prüfung kann die Nachricht in einen Pause-Channel verschieben. Sie kann dann nach einigen Stunden automatisch neu gestartet werden. Erst wenn bei der zweiten Suche die Initialnachricht nicht gefunden wird, wird eine APERAK erstellt.

Eingeschaltet und konfiguriert wird an den ReferenceKnownValidatorActions bzw. (veraltet) den AperakActions (z.B. AperakAction21a). Die Regeln, wie die Referenzen gefunden werden, sind in der Extension B3P_Z28_RULES_EXTENDED bzw. B3P_Z28_RULES konfiguriert.

Die Konfiguration behält weiterhin Z28 in den Namensgebungen. Ab dem 01.10.2017 wird allerdings eine APERAK Z33 erzeugt.

Einrichtung

Platzierung der Action

Folgende Actions machen eine Referenzprüfung:

org.b2bbp.validation.aperak21a.ReferenceKnownValidatorAction (einfache Prüfung) org.b2bbp.validation.aperak21a.contributions.ReferenceKnownValidatorActionExtended (erweiterte Prüfung) org.b2bbp.runtime.invoic.remadv.check.StopRemadvOnMissingInvoic (nur der zur Vollständigkeit aufgelistet, nicht Teil dieser Dokumentation)

Bei der alten Z28-Prüfung war die Reihenfolge:

  • ValidatorAction
  • ControlActionStandard
  • AperakAction mit Konfiguration für Z28-Prüfung

Empfohlen ist nun folgende Reihenfolge:

  • ValidatorAction
  • ControlActionStandard
  • ReferenceKnownValidatorAction mit Konfiguration für Z28/Z33-Prüfung
  • AperakAction ohne Konfiguration für Z28-Prüfung

Einrichtung an der Action

Folgende Eigenschaften können an der org.b2bbp.validation.aperak21a.contributions.ReferenceKnownValidatorActionExtended konfiguriert werden. Message Context soll dabei nicht überschrieben werden. Werte die fett markiert sind, sind standardmäßig in den Einstellungen!

ActionProperty / Eigenschaften Mögliche Werte Erklärung
B3P_CHECK_Z28 EXTENDED_CHECK Diese Eigenschaft ist nach der Umstellung des Workflows nicht mehr nötig.
B3P_CHECK_Z28_USE_PAUSE_CHANNEL false / true Soll bei Fehlern während der ersten Prüfung die Nachricht in den Pause Channel verschoben werden. Empfohlener Wert: true
B3P_CHECK_Z28_PAUSE_CHANNEL INBOUND_PAUSE_CHANNEL Name des Pause-Channels
B3P_CHECK_Z28_PAUSE_CHANNEL_ICON Bestätigungsstatus, der bei Pausierung gesetzt werden soll. Empfohlener Wert: nichts.
B3P_CHECK_Z28_CHECK_INDEX false / true Falls eingeschaltet: Es wird geprüft, ob der Volltext-Index aktuell ist.
B3P_CHECK_Z28_STOP_WORKFLOW​_IF_INDEX_IS_NOT_UP_TO_DATE false / true Falls eingeschaltet: Die weitere Verarbeitung wird abgebrochen, falls der Volltext-Index nicht aktuell ist. Die Nachricht erhält den VS-Status "Fehlerhaft". Mit "false" läuft die Verarbeitung ohne Fehler weiter, obwohl kein Z28-Check gemacht werden konnte. Es wird keine Z28-Aperak erzeugt.
B3P_CHECK_Z28_DECLINE_CONTRL false / true Falls mit true eingeschalte: Initialnachrichten, die per negativir Contrl abgelehnt wurden, werden als fehlend betrachtet.
B3P_CHECK_Z28_DECLINE_APERAK false / true Fall mit true eingeschaltet: Vorgänge der Initialnachricht, die per Aperak abgelehnt wurden, werden als fehlend betrachtet.
B3P_CHECK_Z28_DECLINE_EXCEPTIONS I26;Z28;M26 etc. (I26 = UCI 26, M26 = UCM 26) Contrl- und Aperak-Fehlercodes, die ignoriert werden, falls die _DECLINE_CONTRL oder _DECLINE_APERAK Einstellung eingeschaltet ist. Empfohlener Wert: nichts
B3P_STORE_MONITOR

TECHNICAL

PROFESSIONAL

ALL

OFF

DEBUG

Wo soll das Protokoll gespeichert werden: als technisches / fachliches Attribut, beides oder keins.

Mit DEBUG wird ein erweitertes Protokoll als technisches und fachliches Attribut abgelegt.

B3P_CHECK_Z28_USE_ARCHIVE_SEARCH false / true

Soll bei der Suche nach referenzierten Nachrichten auch im Archiv gesucht werden?

Einschränkung: die Eigenschaften B3P_CHECK_Z28_DECLINE_APERAK und B3P_CHECK_Z28_DECLINE_EXCEPTIONS können bei der Arhchivsuche nicht berücksichtigt werden.

Die Z28-Validierung wird nur ausgeführt, falls die Message Context Variable ERRORS_TO_VALIDATE den Wert “APERAK” enthält. Die Variable wird normalerweise an der ValidatorAction gesetzt.

Konfiguration der Regeln

Die Regeln werden in der Extension B3P_Z28_RULES_EXTENDED bzw. B3P_Z28_RULES konfiguriert. Die Konfiguration dieser Regeln ist für beide ReferenceKnownValidator-Actions möglich. Möglicher Inhalt:

#Format der Antwortnachricht ; Referenz in der Antwortnachricht. (Edipath) ; Format der Initialnachricht ; Ref.-segment der Initialnachricht. (Segment-Präfix) ; Bezeichnung der Regel ; Fehler ignorieren

UTILMD;RFF\[1+0="TN"\]+1+1;UTILMD;IDE+24+;UTILMD Antwortnachricht auf UTILMD Anfrage;false
UTILMD;RFF\[1+0="ACW"\]+1+1;UTILMD;IDE+24+;UTILMD Storno auf UTILMD Nachricht;false
MSCONS;RFF\[1+0="AGI"\]+1+1;ORDERS;BGM+7+;MSCONS Antwortnachricht auf ORDERS Anfrage;false
MSCONS;RFF\[1+0="AGI"\]+1+1;UTILMD;IDE+24+;MSCONS Antwortnachricht auf UTILMD Gerätewechsel;false
ORDRSP;RFF\[1+0="ON"\]+1+1;ORDERS;BGM+7+;ORDRSP Antwortnachricht auf ORDERS Anfrage;false
INVOIC;RFF\[1+0="ACE"\]+1+1;MSCONS;BGM+Z23+;INVOIC MMMA auf Bilanzierungs-MSCONS;false
INVOIC;RFF\[1+0="ACE"\]+1+1;MSCONS;BGM+Z24+;INVOIC MMMA auf Allokations-MSCONS;false
MSCONS;RFF\[1+0="ACW"\]+1+1;MSCONS;BGM+7+;MSCONS Storno auf MSCONS Zählerstand;false
INVOIC;RFF\[1+0="OI"\]+1+1;INVOIC;BGM+380+;INVOIC Storno auf INVOIC Rechnung;false

bzw. in B3P_Z28_RULES exemplarisch

UTILMD;RFF\[1+0="TN"\]+1+1;IDE+24+

Pause Channel

Der Pausechannel muss keine besonderen Actions beinhalten.

Zum Neustarten der Nachrichten in diesem Channel soll der RestartMessageJob konfiguriert werden.

Trouble Shooting

Für die Extendes-Prüfung können einzelne Regeln in der Extension B3P_Z28_RULES_EXTENDED abgeschaltet werden. Dafür soll der letzte Wert auf true geändert werden.

Um die ganze Prüfung zu deaktivieren, kann die Action im Channel deaktiviert werden. Die alte Prüflogik kann an der Aperak Action abgeschaltet werden. Dafür muss die Eigenschaft B3P_CHECK_Z28 auf false gesetzt (oder entfernt) werden.

ValidatorAction

View Me   Edit Me