B2B Service, der die MetaDaten-JSONs von Edifact Nachrichten via REST an ein konfiguriertes Backend sendet.

Übersicht

Der ProcessTriggerService ist ein passiver Service in der B2B, der einen POST Endpunkt via REST eines Backend-Systems zum Empfang der MetaDaten-JSONs anspricht. Das Backend muss dazu über einen entsprechenden POST Endpunkt verfügen, der JSONs der entsprechenden Struktur erwartet.

Verwendung

Der ProcessTriggerService wird (getriggert über eine konfigurierte SetPropertyAction) am Ende der Nachrichtenverarbeitung in jedem (relvanten) Inbound-Channel ausgeführt. Dadurch wird eine Push-Kommunikation zwischen in der B2B eingehenden Nachrichten und dem Backend System hergestellt. Der Datenaustausch zwischen den Systemen wird dabei möglichst klein gehalten, da nur die MetaDaten jeder Nachricht übertragen werden und nicht gleich die gesamte Nachricht.

Für den Datenaustausch vollständiger Nachrichten (im JSON-Format) bietet die B2B einen GET Endpunkt via REST an, welcher gezielt einzelne Nachrichten über ihre MessageId, welche im MetaDaten JSON enthalten ist, angesprochen werden kann.

Einrichtung

In der Administration muss dazu der Service mit dem Klassenpfad com.nextlevel.services.outbound.http.ProcessTriggerService als passiver Service angelegt werden:

ProcessTriggerServiceConf

Konfiguration

Pflichtwert:

Eigenschaft Beispielswert Beschreibung Kontext überschreiben
URL http://serverXY:8080/api/v1/meta Volle URL des POST Endpunktes des Backend-Systems für die MetaDaten-JSONs Nein

Optionale Werte:

Eigenschaft Beispielswert Beschreibung Kontext überschreiben
MONITOR_OUTPUT true/false (Default: false) Loggt das übermittelte MetaDaten-JSON als technisches Attribut OUTPUT Nein
TIMEOUT 45000 (Default: 60000) Erlaubte Höchstdauer den HTTP-Request in Millisekunden Nein

JSON Struktur der MetaDaten

Die MetaDaten werden mittels HATEOAS versendet und haben die folgende Struktur:

{
    "data": {
        "messageId": "String",
        "documentRef": "String",
        "sender": "String",
        "senderRegistrarCode": "String",
        "recipient": "String",
        "format": "String",
        "version": "String",
        "creationTime": "String",
        "applicationRef": "String",
        "messageReceived": "String",
        "messageMetaDataList": [{
                "msgRef": "String",
                "docRef": "String",
                "docCode": "String",
                "incidentMetaDataList": [{
                        "incidentRef": "String",
                        "incidentTypeIdentification": "String",
                        "locationCodes": ["String"]
                    }
                ]
            }
        ]
    },
    "links": [{
            "rel": "message",
            "href": "uri/messageId",
            "hreflang": "String",
            "media": "String",
            "title": "String",
            "type": "String",
            "deprecation": "String"
        }, {
            "rel": "String",
            "href": "uri/metadata?id=messageId",
            "hreflang": "String",
            "media": "String",
            "title": "String",
            "type": "String",
            "deprecation": "String"
        }
    ]
}

View Me   Edit Me