AS4 Outbound Market Message Service Dokumentation

Dieser Service nimmt über REST eine Edifact-Nachricht an und gibt bei fehlerfreier Verarbeitung die AS4ID zurück. Die AS4-Nachricht wird erstellt und an den Message-Broker weitergeleitet.

Einfache Konfiguration der as4-outbound-market-message-service.properties

Der AS4 Outbound Market Message Service benötigt die Adresse des Marktpartners, der Empfänger der Edifact Nachricht ist. Diese erhält er vom AS4 Address Service. Um diesen Service ansprechen zu können, ist die Adresse addressServerUrl notwendig.

addressServerUrl=http://localhost:8085/aep-as4-address-service/as4-address

Existiert zum Beispiel aus Testgründen kein AS4 Address Service oder sind noch keine Adressen vorhanden, dann lässt sich die Abfrage mit useFeign=false deaktivieren und mit as4.address.send ein Dummy Wert setzen.

useFeign=false
as4.address.send=http://localhost:8083/aep-as4-inbound-endpoint/as4

Außerdem benötigt der AS4 Outbound Market Service die Angaben zum Message-Broker.

rabbitmq.host=localhost
rabbitmq.port=5672
rabbitmq.username=guest
rabbitmq.password=guest

Die Edifact Nachricht wir an den Crypto Operations weitergeleitet. Der vollständige Name ohne Routing lautet as4.encrypt.sign.default.

cryptoEncryptAndSignExchangeName=as4.encrypt.sign

Routing Konfiguration der as4-outbound-market-message-service.properties

Für die Aktivierung des Routings müssen der headerName und die headerValues gesetzt werden. Den headerName kann man sich als Filterkategorie vorstellen, während die headerValues den zu filternden Werten entsprechen. Nachrichten mit Werten, die nicht explizit als headerValues aufgelistet sind, laufen weiterhin über die default Route.

Als headerName werden folgende Parameter angeboten:

  • tenant: ILN Nummer des Senders
  • partner: ILN Nummer des Empfängers.
  • sector: GAS, ELECTRICITY

Es können mehrere Werte kommasepariert angegeben werden.

cryptoEncryptAndSignExchangeName=as4.encrypt.sign
cryptoEncryptAndSignHeaderName=tenant
cryptoEncryptAndSignHeaderValues=

Der Pathswitch ist die Möglichkeit eine neue Internet Adresse des Tenants dem Marktpartner bekannt zu geben. Dieser Prozess wird vom AS4 Address Service aus gestartet.

pathswitchConsumerExchangeName=as4.outbound.request.pathswitch
pathswitchConsumerGroup=default
consumer.max.attempts=1

Wird der Producer für das Routing konfiguriert muss natürlich auch die Gegenstelle dafür eingerichtet werden. Dem Consumer wird über die Gruppe der Wert (Value) aus der HeaderValues Liste zugewiesen nach welchem gefiltert werden soll. Bitte den Default Wert nur ändern, wenn Routing verwendet werden soll.

Mit der Variable consumer.max.attempts wird verhindert, dass die Nachricht nochmal versendet wird, wenn die Verarbeitung fehlschlägt.

REST API Dokumenation

Die Beschreibung der REST API lässt sich, im Fall einer Docker Installation, unter

http://host.docker.internal:8081/aep-as4-outbound-market-message-service/swagger-ui/index.html#

oder unter

http://localhost:8080/aep-as4-outbound-market-message-service/swagger-ui/index.html#/

finden.

View Me   Edit Me