Der dritte Teil dieses Blogbeitrags umfasst eine Schritt-für-Schritt Anleitung dafür, wie man einen IDoc, das von einem SAP On-Premise System gesendet wurde, im SAP BTP Integration Flow empfangen und verarbeiten kann.

Schritt 1: Erstellen des Integration Flow

Wir beginnen mit der Erstellung eines einfachen Integration Flows.

Dazu navigieren wir wieder zu Design>Integration and APIs>Create.

Als nächstes die Pflichtfelder ausfüllen und auf Save.

Reiter Artifacts>Add>Integration Flow

Pflichtfelder eintragen und Add and Open in Editor.

Im Integration Flow Editor auf Edit.

Connector von Sender=>Start und Adapter Type IDoc auswählen.

Pflichtfelder im Reiter Connection eingeben.

Save and Deploy

Unter dem Reiter Deployment Status => Navigate to Manage Integration Content.

Runtime Status sollte auf “Started” sein.

Hier findet man nur alle wichtigen Informationen zum erstellten Integration Flow, wie Endpoint URL, Status Details, etc.

Die Endpoint URL benötigen wir im nächsten Schritt

Schritt 2: On-Premise System vorbereiten, das IDoc an die BTP zu senden

Erstelle zunächst eine RFC-Verbindung zu dem BTP-Mandanten, in dem sich der Integration Flow befindet oder befinden wird.

• Transaktion SM59 und „HTTP-Verbindung zu ext. Server“ erstellen
• Zielsystem Host und Pfadpräfix von der Integration Flow URL und Port eintragen

Reiter Anmeldung & Sicherheit: BTP-User+Passwort, System-ID und Mandant eintragen. SSL Option aktivieren.

Schritt 3: SSL-Zertfikat importieren

Falls das SSL-Zertifikat von der SAP-BTP bereits im On-Premise System importiert worden ist, kann dieser Step übersprungen werden.

Siehe auch: 2853519 - How to download the SSL certificate of SAP BTP

Zuerst das benötigte SSL-Zertifikat von der SAP-BTP Website exportieren.

Es wird empfohlen, das Root-CA-Zertifikat anstelle des Serverzertifikats zu importieren, um eine Vertrauensbeziehung herzustellen. In diesem Fall vertraut der Client-Server allen SSL-Zertifikaten, die von der Root-CA ausgestellt wurden. Root-CA-Zertifikate haben eine längere Gültigkeit. 

Zertfikat Exportieren und lokal speichern.

Transaktion STRUST und SSL-Zertifikat importieren

Schritt 4: Transaktion WE21, XML-HTTP Port anlegen 

Schritt 5: Transaktion WE20 Partnerprofil anlegen

Ausgangsoptionen einstellen

Schritt 6: Testing

Transaktion WE19 IDoc generieren, was zur BTP gesendet werden soll.

Benötigte Empfänger und Absender Informationen eintragen

Standard Ausgang klicken und Bestätigen.

Hinweis: Es wird die Rolle „ESBMessaging.send“ bzw. „MessagingSend“ benötigt, ansonsten bekommt man beim Senden des IDoc einen „403 Forbidden Error“. 
Siehe Note: https://me.sap.com/notes/2642897/E

Schritt 7: Status checken in der WE05

Schritt 8: In der Integration Suite prüfen

Artifact Details > Monitor Message Processing

Wenn „Trace log“ aktiv ist, kann man mit einem Klick auf „Log Level: Trace“ den Content vom IDoc einsehen

IDoc Content:

Schritt 9: Access IDoc Felder im Integration Flow

Um die IDoc Felder abzufragen und zu verarbeiten, kann man einen „Content Modifier“ in den Integration Flow hinzufügen und Exchange Properties definieren.

Gewünschte Exchange Properties hinzufügen.

Message Body für die Ausgabe festlegen. Dann Save und Deploy.

Wenn alles geklappt hat, sieht man nun unter Message Processing Run>End>Message Content>Payload den Inhalt der Body Message mit den jeweiligen Daten vom gesendeten IDoc.