Modul in diesem Artikel: iFlow Docs
Nach dem Deploy in SAP CPI: Deploy-Überwachung, Paketdokumente, Systemlandschaft und Value Mapping in Excel
Sehen Sie, wann ein iFlow Started ist oder warum er fehlschlug, wählen Sie die Cloud- oder Edge-Laufzeit, nutzen Sie neue Designprüfungen, dokumentieren Sie ein ganzes Paket mit seiner Systemlandschaft, exportieren Sie Value Mappings nach Excel und schalten Sie jedes Werkzeug aus.
Wer in SAP Cloud Integration (SAP CPI) auf Deploy drückt, beginnt zu warten: zum Monitor wechseln, den iFlow suchen, aktualisieren, bis Started oder Error dasteht, und dann herausfinden, was der Fehler bedeutet. Und wenn eine Schnittstelle fertig ist, fragt trotzdem jemand nach dem Dokument, dem Bild der Systemlandschaft und dem Value Mapping als Tabelle.
Kitegra übernimmt diesen Teil der Arbeit jetzt direkt im Designer von SAP Integration Suite: eine Deploy-Überwachung mit Testaufruf, eine Runtime-Auswahl für Tenants mit Edge Integration Cell, neue Designprüfungen, ein Paketdokument mit Landschaftsdiagramm und Dokumentationsstand, eine Value-Mapping-Tabelle in Excel und Erklärungen von Groovy-Skripten in einfachen Worten. Jedes Werkzeug lässt sich einzeln ausschalten. Dieser Artikel geht sie der Reihe nach durch.
Deploy-Überwachung: Started oder Error, ohne den iFlow zu verlassen
Drücken Sie wie gewohnt Deploy im Designer und bestätigen Sie den Dialog von SAP. Ein Hinweis Bereitstellung erscheint mit "Wird bereitgestellt…" und der vergangenen Zeit, und Sie arbeiten weiter. Kitegra fragt SAP nach drei Sekunden nach dem Status, danach immer seltener, höchstens alle 20 Sekunden. Sobald SAP antwortet, wird aus dem Hinweis:
- Started, mit der deployten Version. Hat der iFlow einen HTTP-Endpunkt, öffnet Testaufruf senden den HTTP Runner mit fertigem Request, und Neueste Nachricht zeigen öffnet das Fenster Nachrichten frisch geladen.
- Fehler, mit dem Fehlertext von SAP und, wenn es ein bekannter Fall ist, was er meist bedeutet: Ein anderer deployter iFlow nutzt die Senderadresse bereits, ein Skript lässt sich nicht kompilieren, ein externalisierter Parameter hat keinen Wert, oder SAP konnte den iFlow nicht erstellen. Bereitgestellte Inhalte in SAP öffnen führt Sie zu den Details.
- Noch nicht fertig nach zehn Minuten, mit einem Verweis auf die bereitgestellten Inhalte in SAP.
Brechen Sie den Deploy-Dialog von SAP ab, wird nichts überwacht. Die Überwachung liest nur den Deploy-Status; das Deployen erledigt SAP, ausgelöst durch Ihren eigenen Klick. Wie Sie eine Nachricht danach durch den iFlow verfolgen, beschreibt eine Nachricht Schritt für Schritt verfolgen, den Aufruf selbst einen HTTPS-iFlow mit einem Service Key testen.
Runtime-Auswahl: Cloud oder Edge
Ein Tenant mit Edge Integration Cell führt iFlows auf mehr als einer Laufzeit aus. Nur auf einem solchen Tenant zeigt das Kitegra-Feld Laufzeit: Cloud (oder den Namen der Edge-Laufzeit). Wählen Sie dort die Laufzeit, und der Message Monitor liest die Nachrichten dieses iFlows auf dieser Laufzeit und setzt dort seine Protokollstufe. Die Auswahl zeigt außerdem, ob und in welcher Version der iFlow auf jeder Laufzeit deployt ist. Tenants mit nur einer Laufzeit sehen sie nie.
Neue Designprüfungen im iFlow Inspector
Die Checkliste für iFlow-Reviews hat fünf neue Prüfungen bekommen, mit der neuen Kategorie Dokumentation:
| Prüfung | Warum sie wichtig ist |
|---|---|
| Empfänger ohne Adresse (Fehler) | Der iFlow lässt sich deployen, aber jeder Aufruf dieses Empfängers schlägt zur Laufzeit fehl. |
| HTTPS-Sender mit Standardadresse (Warnung) | Eine leere Adresse, / oder ein Platzhalter wie /test sagt Aufrufern nichts, und zwei iFlows können darüber kollidieren. |
| HTTPS-Sender erwartet ein CSRF-Token (Info) | Jeder Aufrufer muss zuerst ein X-CSRF-Token holen, sonst bekommt sein POST einen 403. |
| Empfängeradresse fest im iFlow (Info) | Der Weg zwischen DEV, QA und PROD bedeutet, den iFlow zu bearbeiten; Externalize Parameters behebt das in einem Schritt. |
| Teilnehmer trägt noch den Standardnamen (Info, Dokumentation) | "Sender" und "Receiver" erscheinen auch im Monitoring, sodass niemand erkennt, welches System gemeint ist. |
Wie die anderen Prüfungen zählen sie zur Punktzahl und lassen sich einzeln abschalten. Das Ansehen ist kostenlos; der Export des Berichts gehört zu Pro. Externalize Parameters und die anderen neuen Werkzeuge des Helper beschreibt Externalize Parameters, Schrittkopie und Hub-Import.
Ein Dokument für das ganze Paket
Neben Diesen iFlow dokumentieren hat das Kitegra-Menü jetzt Paketdokument. Es liest jeden iFlow aus dem Paket des geöffneten iFlows nacheinander ("iFlow 2 von 5 wird gelesen…"), und Sie können anhalten und öffnen, was bis dahin gelesen wurde. iFlows, die nicht gelesen werden konnten, werden aufgelistet. Das Dokument öffnet sich in einem neuen Tab, als Word, PDF oder HTML oder in Ihre eigene Word-Vorlage gefüllt, wie das technische Designdokument eines einzelnen iFlows. Es enthält Version, Anbieter, Tags und Anzahl der iFlows des Pakets, dann jeden iFlow und zwei neue Teile:
- Systemlandschaft: ein Diagramm mit den Sendern links, den iFlows des Pakets in der Mitte und den Empfängern rechts. Teilnehmer mit demselben Namen werden zu einem Kasten, und jede Linie trägt ihre Adaptertypen.
- Dokumentationsstand: was Lesende brauchen, Punkt für Punkt geprüft: Beschreibung und Tags des Pakets, eine Beschreibung je iFlow, Teilnehmer mit eigenem Namen statt Sender und Receiver sowie externalisierte Empfängeradressen. Er zeigt, wie viele Prüfungen bestanden sind und was fehlt, damit Sie die Lücken vor der Übergabe schließen können.
Value Mapping in Excel
Laden Sie auf der Seite iFlow Docs unter Value Mappings ein Value-Mapping-ZIP (in SAP aus seinem Paket herunterladen) oder dessen value_mapping.xml hoch. Kitegra listet die Werte und schreibt eine Excel-Arbeitsmappe mit einem Blatt je Paar aus Agentur und Kennung: Quellagentur, Quellkennung und Quellwert, dann Zielagentur, Zielkennung und Zielwert. Die Datei wird in Ihrem Browser gelesen; nichts wird aus SAP gelesen und nichts wird irgendwohin gesendet. Das Message-Mapping-Blatt funktioniert für Mappings genauso.
Skripte in einfachen Worten erklärt
Skripte erklären im Kitegra-Menü listet jeden Groovy-Skriptschritt des iFlows. Zu jedem zeigt es den zusammenfassenden Kommentar des Autors, die definierten Funktionen, was es liest (Body, Header, Exchange Properties, Anhänge), was es setzt und ändert, seine Hauptlogik (XML oder JSON parsen oder aufbauen, Schleifen, Entscheidungen, HTTP-Aufrufe, Datumswerte), die verwendeten SAP-APIs wie Security Material, Value Mapping oder Partner Directory sowie Hinweise und Risiken. Ein Klick auf den Namen eines Schritts wählt ihn im Diagramm aus. Die Erklärung entsteht aus dem Text des Skripts in Ihrem Browser; das Skript wird nie irgendwohin gesendet.
Jedes Werkzeug ausschalten, das Sie nicht nutzen
Die Optionsseite hat jetzt einen Abschnitt Tools mit einem Schalter für jedes Werkzeug, eingeordnet unter seinem Modul: von XPath-Prüfung, Anordnen, Security Material, Externalisieren, Schrittkopie und Hub-Import im Helper über Nachrichten, Runtime-Auswahl, Log-Anzeige und Deploy-Überwachung, iFlow-Infos, Inspector und Suche, Dokumente und Skripte erklärt bis zu Notizen, Snippets, Vergleich, Konvertierung, Generierung und dem HTTP Runner in der Toolbox. Ein ausgeschaltetes Werkzeug verschwindet sofort aus dem Designer und dem Popup; Ihre Daten bleiben, und Alle einschalten holt alles zurück. Um ein ganzes Modul auszuschalten, nutzen Sie Module auf derselben Seite; siehe die Optionsseite.
Die Deploy-Überwachung, die Runtime-Auswahl, Skripte erklärt und das Ansehen der Designprüfungen sind kostenlos. Paketdokument, Systemlandschaft und Value-Mapping-Blatt gehören zu iFlow Docs, mit einigen Nutzungen in Free und Starter. 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 sehen Sie sich die neuen Werkzeuge zum Bauen von iFlows an.
Häufige Fragen
Deployt Kitegra meinen iFlow?
Nein. Sie drücken Deploy in SAP; die Deploy-Überwachung liest nur den Deploy-Status und meldet Ihnen, wann der iFlow Started ist oder fehlgeschlagen ist.
Wie dokumentiere ich ein ganzes SAP-CPI-Paket?
Öffnen Sie einen beliebigen iFlow des Pakets und wählen Sie Paketdokument im Kitegra-Menü. Es liest jeden iFlow und öffnet ein Dokument mit Landschaftsdiagramm und Dokumentationsstand, als Word, PDF oder HTML.
Kann ich ein Value Mapping nach Excel exportieren?
Ja. Laden Sie das Value-Mapping-ZIP in SAP aus seinem Paket herunter und laden Sie es auf der Seite iFlow Docs hoch. Sie erhalten ein Blatt je Paar aus Agentur und Kennung; die Datei verlässt Ihren Browser nie.
Warum sehe ich die Runtime-Auswahl nicht?
Sie erscheint nur auf Tenants mit mehr als einer Laufzeit, etwa Cloud plus Edge Integration Cell.
Werden meine Daten gelöscht, wenn ich ein Werkzeug ausschalte?
Nein. Das Werkzeug verschwindet aus dem Designer und dem Popup, und seine Daten bleiben. Schalten Sie es im Abschnitt Tools der Optionsseite wieder ein.