Parameter externalisieren, Schritteinstellungen kopieren und APIs aus SAP Business Accelerator Hub importieren in SAP CPI

Die langsamste Arbeit an einem iFlow in SAP Cloud Integration (SAP CPI) ist oft nicht die Logik. Es ist das Eintippen derselben Empfängeradresse in drei Tenants, das Abschreiben von zehn Content-Modifier-Zeilen von einem iFlow in den nächsten, der Neubau einer OData-Abfrage, die Sie letzten Monat schon geschrieben haben, oder der Download einer API-Spezifikation, nur um die Felder einer Entitätsmenge zu kennen.

Der Helper von Kitegra hat jetzt für jede dieser Aufgaben ein Werkzeug, direkt im Designer von SAP Integration Suite: Externalize Parameters, Kopieren und Einfügen von Schritteinstellungen mit OData-Abfragevorlagen, einen Import aus SAP Business Accelerator Hub, eine XPath-Prüfung am Beispiel-Payload und Anordnen für Ausdrücke im Message Mapping. Dieser Artikel erklärt, was jedes davon tut, wann es Ihren iFlow ändert und was es speichert.

Parameter in einem Schritt externalisieren

Steht eine Adresse fest in einem Empfängerkanal, müssen Sie den iFlow selbst bearbeiten, sobald er von DEV nach QA und PROD wandert. Die Antwort von SAP ist ein externalisierter Parameter: {{Receiver_OData_Address}} im Feld, dessen Wert je Tenant unter Configure gesetzt wird. Externalize Parameters übernimmt das Tippen für Sie.

Öffnen Sie einen iFlow, drücken Sie Edit in SAP und wählen Sie Externalize Parameters im Kitegra-Menü. Das Fenster listet die festen Werte, die sich zwischen Tenants meist unterscheiden:

• Adressen: URLs, Hosts, Endpunkte, Pfade, Verzeichnisse und WSDLs. Sie sind bereits angehakt, außer Proxy-Adressen sowie ProcessDirect- und JMS-Adressen.
• Andere Werte: Namen von Queues und Data Stores, OData-Pfade und -Abfragen, Timeouts, Namen und Aliasse von Zugangsdaten sowie Ports.
• Konstanten in den Tabellen von Content Modifier und Write Variables.

Jeder Wert bekommt einen Namensvorschlag wie Receiver_OData_Address, gebildet aus Teilnehmer und Feld, den Sie ändern können. Werte, die bereits {{…}} oder ${…} sind, werden als solche angezeigt. Klicken Sie auf Externalisieren, und die angehakten Felder werden im geöffneten iFlow zu Parametern. Gespeichert wird erst, wenn Sie den iFlow in SAP speichern.

Nach einem Durchlauf stellt Rückgängig die vorherigen Werte wieder her, und Aktuelle Werte kopieren kopiert jeden Parameter mit dem Wert, den er ersetzt hat: Nach dem Deploy fragt SAP unter Configure nach jedem Wert, und Sie fügen ihn dort ein. Die letzten zehn Durchläufe je iFlow bleiben für Rückgängig erhalten. Die Designprüfungen des iFlow Inspector verweisen auf dieses Werkzeug, wenn die Adresse eines Empfängers fest im iFlow steht.

Die Einstellungen eines Schritts in einen anderen Schritt oder iFlow kopieren

Wählen Sie Schritteinstellungen kopieren & einfügen im Kitegra-Menü, wählen Sie einen Schritt im Diagramm (oder im Fenster) und klicken Sie auf Einstellungen kopieren. Die Kopie enthält die Header, Exchange Properties und Adapterfelder des Schritts. Das Fenster behält Ihre letzten zehn Kopien, die neueste zuerst, für jeden Tenant und iFlow in diesem Browser.

Zum Einfügen drücken Sie Edit in SAP, wählen den Zielschritt und klicken auf Einfügen in. Bevor geschrieben wird, listet das Fenster die Felder, die sich ändern. Für jede Tabelle wählen Sie Behalten, Zeilen anhängen (fügt nur die kopierten Zeilen hinzu, die noch fehlen) oder Zeilen ersetzen. Eine Kopie passt nur in einen Schritt derselben Art und kann in einen anderen iFlow, außer einem EDMX-Pfad und Skriptfeldern, die Dateien des iFlows benennen, aus dem sie stammen. Rückgängig stellt wieder her, was das letzte Einfügen geändert hat.

OData-Abfragevorlagen

Dasselbe Fenster verwaltet OData-Abfragevorlagen. Wählen Sie einen OData-Receiver-Kanal, dessen Abfrage Sie aufgebaut haben, klicken Sie auf Abfrage als Vorlage speichern und geben Sie ihr einen Namen. Eine Vorlage behält die Operation, den Ressourcenpfad und die Abfrageoptionen wie $select, $filter und $expand. Später wählen Sie im Bearbeitungsmodus einen anderen OData-Receiver und klicken auf Übernehmen. Speichern unter einem vorhandenen Namen ersetzt diese Vorlage. Zu den Optionen selbst siehe Abfrageoptionen des OData-Receivers.

Kopien und Vorlagen bleiben im Erweiterungsspeicher dieses Browsers. Sie werden nicht mit Ihrem Kitegra-Konto synchronisiert und nirgendwohin gesendet.

Eine API aus SAP Business Accelerator Hub importieren

Der Helper schlägt OData-Entitätsmengen und -Felder aus einer EDMX vor und HTTP-Pfade aus einer OpenAPI-Datei. Mit dem Hub-Import müssen Sie diese Datei nicht mehr zuerst herunterladen. Öffnen Sie im Popup der Erweiterung die Seite eines iFlows mit Beispiel-Payload und API-Spezifikation und suchen Sie Aus SAP Business Accelerator Hub importieren.

1. Klicken Sie beim ersten Mal auf Zugriff erlauben: Der Browser fragt einmal nach Zugriff auf api.sap.com. Kitegra hat ihn erst, wenn Sie zustimmen.
2. Suchen Sie eine API, zum Beispiel API_PRODUCT_SRV. Die Suche braucht keine Anmeldung.
3. Klicken Sie auf Importieren. Der Download der Spezifikation braucht Ihre Anmeldung bei api.sap.com in diesem Browser; sind Sie nicht angemeldet, sagt das Fenster es Ihnen und öffnet den Hub.

Die Entitätsmengen und Felder einer OData-API werden dann in den OData-Receivern dieses iFlows vorgeschlagen, die keine eigene EDMX haben. Die Pfade einer REST-API werden in HTTP-Feldern vorgeschlagen, als hätten Sie die Datei geladen, wie es der Artikel zu OpenAPI und Postman beschreibt. Die Spezifikation wird je iFlow gespeichert, nur in diesem Browser, bis zu 8 MB, und Entfernen löscht sie.

XPath gegen Ihren Beispiel-Payload geprüft

Ist für den iFlow ein Beispiel-Payload gespeichert, schlägt der Helper daraus bereits XPath-Pfade vor. Jetzt prüft er auch den XPath, den Sie eingegeben haben. Passt kein Knoten des Beispiels, erscheint unter dem Feld die Warnung "Kein Knoten im Beispiel-Payload passt zu diesem XPath." Passt einer, zeigt eine Infozeile den gefundenen Wert.

Die Prüfung gilt für XPath-Zeilen in Headern und Properties des Content Modifier und in Write Variables, für Bedingungen des XML Router und für XPath-Splitter. Sie läuft nur dort, wo das gespeicherte Beispiel wirklich bei diesem Schritt ankommt: ein XML-Beispiel, vor dem nur Schritte stehen, die den Body unverändert lassen, oder ein JSON-Beispiel nach einem JSON to XML Converter. In Local Integration Processes, Exception Subprocesses und bei XPaths, die mit ${…} oder {{…}} gebaut sind, bleibt sie still, damit eine Warnung eine echte Abweichung bedeutet.

Einen Message-Mapping-Ausdruck anordnen

Ein Message-Mapping-Ausdruck mit einem Dutzend Funktionen wird schnell zu einem Knäuel sich kreuzender Linien. Auf der Zeichenfläche des Ausdrucks steht jetzt neben den Schaltflächen von SAP eine Schaltfläche Anordnen. Sie legt die Knoten von den Quellfeldern bis zum Ziel aus. Im Bearbeitungsmodus behält Save die Anordnung, und die Rückgängig-Schaltfläche daneben stellt den vorherigen Zustand wieder her; im Anzeigemodus hilft sie nur beim Lesen, und die Anordnung ist weg, sobald SAP den Ausdruck neu zeichnet. Nichts wird gespeichert oder an SAP gesendet. Auch das iFlow-Diagramm hat im Bearbeitungsmodus eine eigene Schaltfläche zum Anordnen, mit Rückgängig.

Was sich in Ihrem iFlow ändert

Externalize Parameters, Einfügen und das Übernehmen einer Vorlage schreiben in den im Designer geöffneten iFlow, nur im Bearbeitungsmodus, und der Designer zeigt den iFlow als geändert an. Sie speichern und deployen nie: Sie speichern in SAP, oder verwerfen die Änderung mit Discard. Jedes dieser Werkzeuge lässt sich auf der Optionsseite unter Tools einzeln ausschalten; es verschwindet dann sofort aus dem Designer. Externalisieren, Kopieren und Einfügen von Schritten und der Hub-Import gehören zu den bezahlten Tarifen, mit einigen Nutzungen in Free; die XPath-Prüfung und das Anordnen sind kostenlos. Während des Starts von Kitegra sind alle Werkzeuge für alle Angemeldeten offen. Tarife vergleichen.

Probieren Sie es im nächsten iFlow aus

Lesen Sie, was Kitegra rund um den Designer von SAP Integration Suite ergänzt, oder was es tut, nachdem Sie Deploy gedrückt haben.

Häufige Fragen