Kitegra 2.0: Autovervollständigung, Message Trace, iFlow Inspector und Doku für SAP CPI

Wer im Designer der SAP Integration Suite einen iFlow baut, verlässt ihn ständig: für den Monitor, um zu sehen, was eine Nachricht getan hat, für eine Tabelle mit der Mapping-Spezifikation, für ein anderes Tool, um den Endpunkt aufzurufen, oder um eine Kollegin zu fragen, welche Namensregel gilt. Kitegra ist eine Erweiterung für Chrome und Edge, die diese Arbeit direkt neben das Diagramm holt, das Sie gerade bearbeiten.

Mit Version 2.0 wächst sie von einem Modul auf fünf Bereiche. Dieser Artikel erklärt, was jeder Bereich leistet, was die Erweiterung in Ihrem Tenant ändert und wann, was sie speichert und synchronisiert und wie viele iFlows jeder Tarif abdeckt. Sie gehört zu den Chrome-Erweiterungen von Kitegra.

Fünf Bereiche rund um den iFlow-Designer

Öffnen Sie einen iFlow, und in der Werkzeugleiste des Diagramms erscheint ein Kitegra-Feld, im Anzeige- wie im Bearbeitungsmodus. Nachrichten, Logs und iFlow-Infos haben darin eine eigene Schaltfläche; alle anderen Werkzeuge liegen im Menü hinter der letzten Schaltfläche, und Alt+Shift+P öffnet dieses Menü per Tastatur. Jedes Werkzeug öffnet ein Panel, das Sie auf der Seite verschieben können. Die Werkzeuge gehören zu fünf Bereichen:

• Helper (Integration Flow Helper): iFlows schneller schreiben, mit Vorschlägen und Prüfungen direkt in den Feldern des Designers.
• Message Monitor: Nachrichten, Trace und Protokolle des geöffneten iFlows direkt im Designer.
• iFlow Inspector: Details des bereitgestellten iFlows, Namens- und Designprüfungen sowie Suche.
• iFlow Docs: Dokumente, die aus einem iFlow oder einem Message Mapping erzeugt werden.
• Toolbox (in der Oberfläche „Werkzeugkasten“): kostenlose Werkzeuge, um Payloads zu vergleichen, umzuwandeln und zu erzeugen, dazu Snippets, Notizen und HTTP-Anfragen.

Jeder Bereich lässt sich auf der Optionsseite unter Module abschalten. Dazu kommen einige Extras, die den Alltag im Tenant erleichtern: eine Umgebungsleiste, Tab-Branding, Monitoring-Links und Tastenkürzel.

Helper: iFlows schneller schreiben

Tippen Sie ${ oder $ in ein Feld des Designers, und es öffnet sich eine Liste der Namen, die an dieser Stelle des iFlows passen. Der Rest des Helpers baut auf demselben Modell Ihres iFlows auf:

• Vorschläge: die Header und Exchange Properties, die Ihr iFlow setzt, die Standard-Header von SAP und Camel, {{…}}-Parameter, Variablen, Data Stores sowie Namen von Security Material und Keystore in Feldern für Anmeldedaten.
• Ausdrucksprüfung: nicht geschlossene Ausdrücke, überzählige Leerzeichen, Header, die vor dem aktuellen Schritt nirgends gesetzt werden, und OData-Namen, die im EDMX fehlen.
• Quellen: XPath-Pfade aus einer Beispiel-Payload, URLs und Bodies aus einer OpenAPI-, Swagger- oder Postman-Datei sowie Header, die über ProcessDirect und JMS weitergegeben werden.
• Diagramm anordnen: räumt das Diagramm im Bearbeitungsmodus mit einem Klick auf; Save behält das Ergebnis, und die Rückgängig-Schaltfläche daneben stellt den alten Stand wieder her.

Die sechs früheren Artikel gehen tiefer auf diese Funktionen ein, angefangen mit Camel Simple Expressions in SAP CPI.

Message Monitor: sehen, was passiert ist

• Nachrichten: die letzten Nachrichten des geöffneten iFlows in einem Panel neben dem Diagramm, mit Status, Zeit und Dauer, und der Fehler von SAP erklärt unter „Was das meist bedeutet:“.
• Trace: Ein Schalter setzt die Protokollstufe des iFlows auf TRACE und hält sie aktiv, solange Sie arbeiten.
• Im Diagramm: Die Schritte, die eine getracte Nachricht durchlaufen hat, werden im Diagramm eingefärbt, und ein Klick auf einen Schritt zeigt Body, Header und Exchange Properties davor.
• Nachrichtenprotokolle: ein Protokoll-Viewer mit Suche nach Message ID oder Correlation ID, einer Zeitachse zusammengehöriger Nachrichten und den Laufzeiten der Schritte im Diagramm.

Eine Nachricht Schritt für Schritt tracen zeigt den gesamten Ablauf.

iFlow Inspector und iFlow Docs: prüfen und dokumentieren

• Benennung: die Regeln, auf die sich Ihr Team einigt, geprüft an jedem Schritt, mit einem vorgeschlagenen Namen und der Schaltfläche Umbenennen.
• Designprüfungen: Fehlerbehandlung, Geheimnisse im Klartext, unsichere Protokolle, Skript-Risiken und mehr, mit einer Punktzahl von 0 bis 100, einer Baseline und einem Bericht als HTML, PDF oder Excel. Die Checkliste für das iFlow-Review führt sie auf.
• iFlow-Info: Bereitstellung, Endpunkte, Data-Store-Einträge, Variablen und die Bearbeitungssperre, mit Undeploy, Unlock und Löschen, wenn Sie sie brauchen.
• Suche im iFlow oder in seinem ganzen Package.
• Ein aus dem iFlow erzeugtes Designdokument als Word, PDF oder HTML, mit seinem Diagramm und einer Beschreibung jedes Prozesses, oder in Ihre eigene Word-Vorlage eingefüllt. Siehe ein technisches Designdokument erzeugen.
• Eine Mapping-Tabelle in Excel für Message Mappings sowie erklärte Skripte.

Toolbox und Arbeitsbereich

• Payload-Vergleich, ein Formatkonverter, ein Testpayload-Generator mit Fehlerfällen, Groovy-Snippets und ein Spickzettel sowie Notizen je iFlow, je Tenant oder für überall.
• Ein HTTP Runner für die Endpunkte Ihrer iFlows, mit OAuth aus einem Service Key von Process Integration Runtime.
• Eine Umgebungsleiste (PROD, TEST, DEV) und Tab-Branding je Tenant, Monitoring-Links, Tastenkürzel und die Größe des Eigenschaftsbereichs.

Die Oberfläche gibt es in 15 Sprachen, im hellen und im dunklen Modus.

Der Einstieg, Schritt für Schritt

1. Fügen Sie Kitegra zu Chrome oder Microsoft Edge hinzu.
2. Öffnen Sie einen iFlow im Designer der SAP Integration Suite auf Ihrem Tenant (eine Adresse unter *.hana.ondemand.com).
3. Klicken Sie in ein Feld, etwa einen Content-Modifier-Wert, und tippen Sie ${ oder $; wählen Sie einen Namen aus der Liste.
4. Klicken Sie im Kitegra-Feld der Werkzeugleiste des Diagramms auf Nachrichten, Logs oder iFlow-Infos, oder öffnen Sie sein Menü für den Inspektor und die anderen Werkzeuge.
5. Öffnen Sie das Popup der Erweiterung für Ihre Tenants, Packages und iFlows sowie für die Ansicht Werkzeuge mit den Seiten der Toolbox.

Ohne Konto können Sie jedes Modul für 5 iFlows nutzen. Für mehr wählen Sie in der Erweiterung Mit Kitegra anmelden.

Probieren Sie ihn im nächsten iFlow aus

Sehen Sie sich den Kitegra neben den anderen Chrome-Erweiterungen von Kitegra an und vergleichen Sie, was jeder Tarif enthält.

Was sie in Ihrem Tenant ändert, und wann

Die Erweiterung liest den geöffneten iFlow, seine Nachrichten und Protokolle mit Ihrer eigenen SAP-Sitzung. Den Inhalt eines iFlows speichert, deployt oder bearbeitet sie nie: Umbenennen und Snippets tippen nur in die Felder des Designers, und gespeichert wird von Ihnen. Ihren Tenant ändert sie nur, wenn Sie auf eine von vier benannten Aktionen klicken:

Ein Schalter auf der Optionsseite, „Aktionen erlauben, die den Tenant ändern“, schaltet alle vier ab: Ihre Schaltflächen verschwinden, und die Erweiterung verweigert sie. Der HTTP Runner sendet nur die Anfragen, die Sie selbst schreiben und abschicken.

Was sie speichert, und was synchronisiert wird

• Nachrichteninhalte (Bodies, Header, Properties, Anhänge und Protokolle) werden auf der Seite angezeigt, aber nie gespeichert oder irgendwohin gesendet.
• Ohne Kitegra-Konto verlässt nichts Ihren Browser.
• Wenn Sie angemeldet sind, speichert Kitegra für jeden iFlow, den Sie öffnen, seinen Namen und seine ID, sein Package, den Designer-Link, die genutzten Module, die Datumsangaben und einen Einweg-Hash Ihres SAP-Kontos, um die iFlows Ihres Tarifs zu zählen.
• Wenn Sie angemeldet sind, folgt Ihnen, was Sie geschrieben haben, auf jeden Computer: Einstellungen und Tastenkürzel, Notizen, Namensregeln, Einstellungen und Baselines der Designprüfungen, Tenant-Branding, Snippets und die Sammlungen des HTTP Runners, aus denen jeder Auth-Wert und jede geheime Variable entfernt ist. Ist der Schalter „Kitegra-Dashboard“ auf der Optionsseite an (standardmäßig an), werden auch die Namen und IDs Ihrer Pakete und iFlows gesendet, und in einem Team-Tarif kann der Inhaber des Teams sie und Ihre Notizen sehen.
• Nie gesendet werden: Nachrichteninhalte, Skripte, Mappings, Beispiel-Payloads, API-Spezifikationen, Zugangsdaten und Geheimnisse. Unter Optionen › Synchronisierung entfernt „Synchronisierte Daten löschen“ die synchronisierten Daten bei Kitegra.

Wie viele iFlows jeder Tarif abdeckt

Das Limit zählt unterschiedliche iFlows, je Modul und dauerhaft: Einen bereits genutzten iFlow erneut zu öffnen, zählt nicht noch einmal, und ein iFlow, den ein Modul genutzt hat, zählt für ein anderes erst, wenn Sie auch dieses Modul darauf anwenden.

Helper, Message Monitor, iFlow Inspector und iFlow Docs zählen iFlows; die Toolbox und die Extras für den Arbeitsbereich zählen keine. Ein iFlow über dem Limit Ihres Tarifs zeigt im Designer und im Popup ein Schloss. Während des Starts von Kitegra sind alle Werkzeuge für alle Angemeldeten offen, auch im Tarif Free. Wenn Sie sich mit Kitegra anmelden, gehen die ohne Konto genutzten iFlows in Ihr Konto über. Tarife vergleichen.

Häufige Fragen