AS4 Customizing in der B2B synchron

AS4 Customizing in der B2B

Allgemeine Konfiguration

Global Properties

AS4_FEATURE

Um AS4-Nachrichten im Nachrichtenmonitor angezeigt zu bekommen, muss die Global Property AS4_FEATURE auf true gesetzt werden.

Customizing Export

Dieser Customizing Export beinhaltet die B2B-Konfiguration für AS4, die hier beschrieben ist und kann als Import genutzt werden. Dabei sollte aber darauf geachtet werden, dass die Action IDs und Channelnamen noch nicht vergeben sind oder diese zusammengeführt werden dürfen.

Ausgehende AS4-Kommunikation

Um Nachrichten mit Hilfe der AS4-Services an den Marktpartner zu verschicken, muss in der B2B ein neuer Channel angelegt werden. In diesem befindet sich unter anderem eine Action, die den entsprechenden Service anspricht, der die Nachricht an den AS4-Outbound-Market-Message-Service übergibt. Damit die zurück gemeldete AS4-ID in der Datenbank gespeichert werden kann, muss dem Channel eine neue SetPropertyAction hinzugefügt werden. Diese Action ist zwingend erforderlich, damit die AS4-Nachrichten im Nachrichtenmonitor angezeigt werden können. Ist der Marktpartner nicht in der AS4-Adress-Datenbank hinterlegt oder das AS4-System inaktiv, wird versucht, die Nachricht per AS2 oder Mail zu verschicken.

Das Routing, also der Weg, wie die Nachrichten in den neuen Channel gelangen, ist abhängig vom bereits bestehenden Routing und muss entsprechend konfiguriert werden. Zum Beispiel direkt am Service, mit dem die Nachricht in die B2B gelangt oder über das Routing der Channel Distribution.

Channel

Ausgehender AS4 Channel

Actions innerhalb des Channels.

Ausgehender AS4 Channel for Contrl und Aperak

Für den Contrl- und Aperak-Versand können entweder neue Channel angelegt oder die bestehenden angepasst werden. So könnten zum Beispiel die Channel wie folgt aussehen:

Actions

AS4 Nachricht senden

Es muss eine PropertyAction gesetzt werden, um den RestClientService aufzurufen, der Edifact-Nachrichten an den AS4-Outbound-Market-Message-Service übergibt.

Action Properties

AS4-ID speichern

Es muss eine PropertyAction gesetzt werden, um AS4-IDs in der Datenbank speichern zu können, die dann wiederum benötigt werden, um AS4-Nachrichten im Nachrichtenmonitor anzuzeigen.

Action Properties

Wichtig ist, dass die Eigenschaft AS4_ID genau so geschrieben wird und der dynamische Ausdruck den ENTITY_KEY_RESPONSE des Services enthält.

Nachricht versenden (Mail oder AS2 statt AS4)

Kann die Nachricht nicht per AS4 verschickt werden, weil entweder das AS4-System inaktiv ist oder die AS4-Partneradresse nicht in der AS4-Adress-Datenbank gepflegt ist (zu erkennen an der leeren AS4_ID), so wird die Nachricht per AS2 oder Mail verschickt. Hierfür kann die bereits existierende Action zum Mail/AS2 Versand kopiert werden. Es müssen in der Regel lediglich B3P_MAIL_TO und B3P_USED_SERVICE_ID angepasst werden.

Action Properties

Services

Übergabe an den AS4-Outbound-Market-Message-Service

Um eine Edifact-Nachricht (current payload) an die AS4-Services zu übergeben, kann der RestClientService genutzt werden.

Service Properties

Wichtig ist, dass der ENTITY_KEY_RESPONSE mit dem Wert aus dem dynamischen Ausdruck aus der Action-Eigenschaft AS4_ID übereinstimmt.

Mithilfe der URL wird der AS4-Outbound-Market-Message-Service angesprochen. Wird kein Docker verwendet, muss die URL zu dem Service entsprechend angepasst werden. Für Gas und Strom gibt es unterschiedliche Parameter, die über die URL mitgegeben werden. Daher muss unterschieden werden, welche Nachrichten Gas und welche Strom sind. Dies wird momentan anhand der ILN gemacht. Alle ILNs, die mit 98 beginnen, werden GAS zugeordnet, alle anderen Strom.

Wie die unterschiedlichen Informationen für Gas und Strom genau aussehen, ist in der Extension AS4_SENDER_EXTENSION hinterlegt. Diese wird über einen dynamischen Ausdruck in der URL geladen.

Extensions

AS4_SENDER_EXTENSION

Die Extension vervollständigt die URL aus dem RestClientService.

Für Strom und Gas werden unterschiedliche Informationen mitgegeben:

Inhalt der Extension:

electricity=from=${template(&(this.FORMAT.senderCode))}&to=${template(&(this.FORMAT.partnerCode))}&section=electricity&fromCode=${edipath(UNB[1]+2+1)}&toCode=${edipath(UNB[1]+3+1)}&bdewDocumentType=${template(&(this.FORMAT.type))}&bdewDocumentDate=${edipath(UNB[1]+4+0)}${edipath(UNB[1]+4+1)}&bdewDocumentNo=${template(&(this.FORMAT.referenceId))}

gas=from=${template(&(this.FORMAT.senderCode))}&to=${template(&(this.FORMAT.partnerCode))}&section=gas&bgmCode=${edipath(BGM[1]+1+0)}

Eingehende AS4-Kommunikation

Für die eingehende AS4-Kommunikation gibt es keinen Eingangsservice im ursprünglichen Sinne. Der B2B-Message-Service, ein eigener Microservice, schreibt einen Queue-Eintrag und die Informationen, die die B2B (der Monolith) benötigt, um diesen zu verarbeiten, in die B2B-Datenbank. Anschließend verarbeitet der normale Queue-Service den Eintrag/die Nachricht. Als Default-Eingangschannel ist der Channel INBOUND_MESSAGES hinterlegt. Ist ein anderer Eingangschannel gewünscht, so ist dieser nicht wie üblich in der B2B zu konfigurieren, sondern kann in der application.properties des Microservices AS4-Inbound-Market-Message-Service angegeben werden. Dadurch, dass der Queue-Service die Nachricht verarbeitet, findet die restliche Bearbeitung in der B2B wie üblich statt. So kann beispielsweise über die Channel Distribution das Routing geregelt werden.

Damit der Queue-Service die Nachricht aus der Queue verarbeiten kann muss lediglich eine Art “dummy”-Service angelegt werden.

Services

B2B Message Service

Wichtig ist, dass der Service genau die angegebene ID hat. Eigenschaften besitzt der Service nicht.