Modul in diesem Artikel: iFlow Docs
Message Mapping in SAP CPI dokumentieren: Mapping-Tabelle in Excel mit einem Klick
Wie Sie ein Message Mapping in SAP CPI als Mapping-Tabelle dokumentieren: die wichtigen Spalten, verständlich beschriebene Funktionen und Kontexte und der Export der Tabelle nach Excel.
Die Mapping-Spezifikation ist meist das erste Dokument einer Schnittstelle und das erste, das veraltet. Das Message Mapping in SAP Cloud Integration (SAP CPI) ändert sich während Bau und Tests, und die Tabelle, die es beschrieben hat, bleibt, wie sie war.
Dieser Artikel beschreibt die Spalten, die eine Mapping-Tabelle braucht, wie Sie Funktionen, Kontexte und Value Mappings so beschreiben, dass Leser ihnen folgen können, und wie Sie die Tabelle aus dem Mapping selbst exportieren.
Warum Mapping-Spezifikationen auseinanderlaufen
Eine Mapping-Spezifikation wird geschrieben, bevor das Mapping existiert, von jemandem, der die fachlichen Felder kennt. Dann stellt die Entwicklerin oder der Entwickler fest, dass ein Feld einen Kontextwechsel braucht, ein Datum ein anderes Format und ein Code ein Value Mapping. Jede dieser Entscheidungen steckt in der grafischen Ansicht des Mapping-Editors, und nur wenige finden den Weg zurück in die Tabelle.
Die Spalten, die eine Mapping-Tabelle braucht
| Spalte | Was hineingehört |
|---|---|
| Zielfeld | Der vollständige Pfad des Felds in der Zielnachricht |
| Vorkommen | Wie oft es vorkommen darf, zum Beispiel 0..1 oder 1..unbounded |
| Quellfelder | Die Quellpfade, aus denen der Wert stammt |
| Regel | Die Logik in einfachen Worten |
| Funktionen | Die verwendeten Standardfunktionen, etwa concat, if oder formatByExample |
| Konstanten | Feste Werte, die im Mapping stehen |
| UDFs | Benutzerdefinierte Funktionen und was sie tun |
| Value Mappings | Codes, die über ein Value Mapping übersetzt werden |
| Hinweise | Kontextwechsel und alles, was ein Tester wissen sollte |
Funktionen, Kontexte und Value Mappings beschreiben
- Schreiben Sie die Regel als Satz: „verkettet FirstName und LastName mit einem Leerzeichen“ lässt sich leichter prüfen als eine Liste von Funktionsnamen.
- Nennen Sie den Kontext, wenn er wechselt. Ein Feld, das einmal je Position gefüllt wird, verhält sich anders als eines, das einmal je Dokument gefüllt wird, und dort verstecken sich die meisten Mapping-Fehler.
- Nennen Sie bei Value Mappings die Agencies und Identifier, damit der Tester weiß, in welcher Tabelle er nachsehen muss.
- Sagen Sie bei einer benutzerdefinierten Funktion, was sie zurückgibt und wann, nicht, wie sie geschrieben ist.
Die Tabelle aus dem Mapping exportieren
- Öffnen Sie den iFlow im Designer, klicken Sie auf „Kitegra-Werkzeuge“ und wählen Sie „Diesen iFlow dokumentieren“.
- Öffnen Sie auf der Seite iFlow-Dokument die Mapping-Tabelle. Sie listet die Message Mappings des iFlows auf, eine Zeile je Zielfeld, mit den Spalten oben.
- Laden Sie sie als Excel-Arbeitsmappe herunter, mit einem Tabellenblatt je Mapping.
- Ohne Designer wählen Sie stattdessen „Mappings hochladen (.mmap oder ZIP)“. Eine hochgeladene Datei zählt nicht zu den iFlows Ihres Tarifs.
Die Tabelle wird aus der Mapping-Datei erstellt und zeigt daher, was das Mapping heute tut. Lesen Sie sie zusammen mit dem technischen Designdokument, das aus demselben iFlow erzeugt wurde.
Die Tabelle vor der Übergabe prüfen
- Vergleichen Sie einige Zeilen mit einer Testnachricht: Quellwert, Regel, Zielwert.
- Lassen Sie den iFlow mit TRACE laufen und lesen Sie den Body vor und nach dem Mapping-Schritt, wie in eine Nachricht Schritt für Schritt tracen beschrieben.
- Füllen Sie die Spalte Hinweise, wo ein Leser mehr als die Regel braucht: warum ein Feld konstant ist, welchem System eine Codeliste gehört.
Wie der Kitegra hilft
Die Mapping-Tabelle gehört zum Bereich iFlow Docs des Kitegra. Sie wird in Ihrem Browser erstellt; Mappings werden nie an Kitegra gesendet.
Helper, Message Monitor, iFlow Inspector und iFlow Docs zählen jeweils die iFlows, für die Sie sie nutzen: 5 je Modul ohne Kitegra-Konto, 50 im Tarif Free, 100 mit Starter und 300 mit Pro; Business hat kein Limit. Die Toolbox und die Extras für den Arbeitsbereich sind kostenlos. Tarife vergleichen.
Probieren Sie ihn im nächsten iFlow aus
Lesen Sie, was der Kitegra rund um den Designer der SAP Integration Suite ergänzt, oder sehen Sie ihn neben den anderen Chrome-Erweiterungen von Kitegra.
Häufige Fragen
Wie dokumentiere ich ein Message Mapping in SAP CPI?
Als Mapping-Tabelle mit einer Zeile je Zielfeld: Zielpfad, Vorkommen, Quellfelder, Regel in Worten, Funktionen, Konstanten, UDFs, Value Mappings und Hinweise.
Kann ich ein Message Mapping nach Excel exportieren?
Ja. Auf der Seite iFlow-Dokument lässt sich die Mapping-Tabelle als Excel-Arbeitsmappe herunterladen, mit einem Tabellenblatt je Mapping.
Kann ich ein Mapping ohne den Designer dokumentieren?
Ja. Laden Sie eine .mmap-Datei oder eine ZIP-Datei mit Mappings hoch; ein Upload zählt nicht zu den iFlows Ihres Tarifs.
Erklärt die Tabelle benutzerdefinierte Funktionen?
Sie listet die UDFs auf, die jedes Feld verwendet. Was eine UDF fachlich tut, ist eine Zeile in der Spalte Hinweise wert.
Werden meine Mappings an Kitegra gesendet?
Nein. Die Tabelle wird in Ihrem Browser erstellt, und Mappings werden nie gesendet.