Die Ausgabeumwandlung erstellt die REST-Webdienst-Antwortnachricht aus Gruppen von relationalen Daten im Operation-Mapping. Das Developer Tool erstellt eine Ausgabeumwandlung, wenn Sie einen REST-Webdienst definieren.
Wenn Sie einen REST-Webdienst erstellen, erstellt das Developer Tool die Ausgabeumwandlung anhand der Ressourcendefinition, die Sie definiert haben. Das Developer Tool erstellt Eingabeports für die Umwandlung auf Basis der Struktur der Antwortnachricht. Die Ausgabeumwandlung enthält ein Mapping, das Eingabeports Knoten in der Antwortnachricht zuordnet.
Sie können die Elemente in der Ausgabenachrichthierarchie durch Ändern des Schemas ändern. Sie können die Eingabeports in der Umwandlung den Schema-Änderungen entsprechend ändern.
Auf der Registerkarte
Ports
der Ausgabeumwandlung können Sie die REST-Antwortnachrichthierarchie anzeigen. Sie können wahlweise die Umwandlungsports oder ein Mapping zwischen den Eingabeports der Umwandlung und der Antwortnachrichthierarchie anzeigen.
Wenn Sie die Ports anzeigen, können Sie Gruppen und Ports manuell hinzufügen oder Ports aus anderen Umwandlungen in die Ausgabeumwandlung kopieren. Dazu können Sie Tastenkombinationen oder die Schaltflächen zum Kopieren und Einfügen im Developer Tool verwenden.
Wenn Sie das Ausgabe-Mapping anzeigen, können Sie Eingabegruppen und Eingabeports definieren und die Eingabeports den Elementen der Antwortnachricht zuordnen. Links auf der Registerkarte sehen Sie den Bereich
Ports
, rechts den Bereich
Ausgabe
. Im Bereich
Ausgabe
wird die Antwortnachrichthierarchie angezeigt. Definieren Sie Eingabegruppen und -Ports im Bereich
Ports
. Beim Zuordnen der Eingabeports aus dem Bereich
Ports
zu den Knoten im Bereich
Ausgabe
wird der Speicherort der Eingabeports in der Spalte
Speicherort
des Bereichs
Ausgabe
angezeigt.
Wenn Sie das Ausgabe-Mapping anzeigen, können Sie festlegen, dass die Verbindungslinien zwischen den Eingabeports und den Knoten in der Operation-Eingabe angezeigt werden.
Die folgende Abbildung zeigt ein einfaches Ausgabe-Mapping in einer Ausgabeumwandlung:
In der vorherigen Abbildung empfängt die Umwandlung eine Gruppe von Ports für einen Kunden. Sie gibt einfach vorkommende Elemente zurück.
Wenn Sie angeben, dass die erste Ebene der Hierarchie zugeordnet werden soll, weist das Developer Tool die Knoten der ersten Ebene der Operation-Ausgabe den Eingabeports zu. Die Option
Erste Hierarchiestufe zuordnen
ist standardmäßig aktiviert. Das Developer Tool erstellt auch die Eingabeports, die zum Zuordnen der Daten erforderlich sind. Wenn die erste Ebene der Hierarchie einen mehrfach vorkommenden übergeordneten Knoten mit einfach oder mehrfach vorkommenden untergeordneten Knoten enthält, erstellt das Developer Tool keine Ports und ordnet die erste Ebene der Hierarchie auch nicht zu.