Externe Definitionen 

Verwendung

Für die Beschreibung der Message-Struktur zur Laufzeit gibt es eine Reihe von Standard-Schemata. Viele verwenden WSDL (Web Service Description Language), XSD (XML Schema Definition Language) oder DTDs (Document Type Definitions), um ein Message-Schema festzulegen. In Fällen, in denen eine Beschreibung der Struktur einer Message bereits in einem dieser Formate vorliegt, können Sie sie über den Import als externe Definition im Integration Repository wiederverwenden, statt sie erneut manuell über den Datentyp-Editor eingeben zu müssen.

Siehe auch: Messages.

Integration

Mit einer externen Definition können Sie eine lokale WSDL-, XSD- oder DTD-Datei in das Integration Repository importieren und spezifizieren, welche Teile des Schemas als Beschreibung für eine Message extrahiert werden sollen. Die so extrahierten Message-Schemas können Sie für folgende Zwecke verwenden:

·      Um sie als Output- oder Input-Message in Message-Interfaces zu verwenden.

·      Um sie als Ausgangs- oder Zielstruktur für Message-Mappings zu verwenden.

Im Integration Builder erkennen Sie zugeordnete Message-Schemas an der Bezeichnung  externe Message. Bezogen auf den Aufbau von Message-Interfaces haben Message-Schemas die gleiche Bedeutung wie Message-Typen.

Aus technischen Gründen unterstützen die Proxy-Generierung und die jeweiligen Editoren im Integration Builder nicht den gesamten Sprachumfang von XML Schema beziehungsweise WSDL. Eine Übersicht, welche Sprachelemente unterstützt werden ist in einem Excel-Spreadsheet dokumentiert, der auf dem SAP Service Marketplace unter der Internetadresse service.sap.com/xi ® Media Library ® Documentation: SAP XI 3.0 (SP11) – Supported XML Schema and WSDL (EN).

Voraussetzungen

Das zu importierende Dokument muss dem WSDL-, XSD- beziehungsweise DTD-Standard genügen.

Funktionsumfang

Extraktion von Message-Schemata

Der Integration Builder setzt importierte externe Definitionen in eine für die weitere Verwendung handhabbare WSDL-Definition um, wenn die Datei nicht sowieso schon in WSDL vorliegt. Dabei identifiziert der Integration Builder die Definitionen, die die Message-Struktur beschreiben. Abhängig vom importierten Format können Sie für diesen Vorgang den Modus vor dem Import festlegen:

Modi für den Import von externen Definitionen

Externes Format	Auswahl der Listbox Messages	Bedeutung
WSDL	keine extrahieren	Import ohne Konvertierung, um auf die externe Definition zentral zugreifen zu können.
	aus allen enthaltenen Message-Definitionen	Extraktion aller Message-Definitionen im WSDL. Enthält die Message-Definition mehr als einen Part, werden alle Parts über einen übergeordneten Part zusammengefasst.
XSD	keine extrahieren	Siehe oben.
	aus allen enthaltenen globalen Elementen	Interpretation aller Element-Definitionen als Message-Schema.
	aus allen unreferenzierten globalen Elementen	Es werden nur solche Element-Definitionen als Message-Schema interpretiert, die von keinem anderen Element referenziert werden.
DTD	keine extrahieren	Siehe oben.
	aus dem DOCTYPE	Interpretation des DOCTYPE-Tags als Message-Schema.
	aus dem ersten ELEMENT	Interpretation des ersten ELEMENT-Tags als Message-Schema.

Verweise

WSDL-, XSD- und DTD-Dokumente können aufeinander verweisen. Der Integration Builder erkennt solche Verweise automatisch, wenn Sie für jedes importierte Dokument seine Quelle angeben. Dies kann zum Beispiel eine URL sein, auf die von anderen Dokumenten verwiesen wird. Die Registerkarte Externe Verweise listet im Dokument erkannte Verweise auf und markiert, welche referenzierten Dokumente in das Integration Repository importiert worden sind. Es sind nur Verweise auf externe Definitionen des gleichen Namensraums möglich.

Aktivitäten

...

     1.     Legen Sie eine externe Definition an (siehe: Neues Objekt anlegen).

     2.     Wählen Sie über das Listenfeld Kategorie aus, ob Sie ein WSDL-, XSD- oder DTD-Dokument importieren möchten. Je nach dieser Einstellung verändern sich die Auswahlmöglichkeiten des Listenfeldes Modus.

     3.     Wählen Sie über das Listenfeld Modus, welche Teile des Dokuments als Message-Schema interpretiert werden sollen (siehe oben).

     4.     Wählen Sie mit Hilfe des Datei-Dialogs eine Datei aus, die in das Integration Repository hochgeladen werden soll. Der Integration Builder kann sich aus technischen Gründen nur den Dateinamen, aber nicht den Verzeichnispfad der Datei merken.

     5.     Nach der Auswahl der Datei können Sie über die Registerkarten folgende Informationen abrufen:

¡      Importiertes Dokument: Ihre Datei im Text-Format

¡      Nachrichten: Die Message-Schemas, die über den von Ihnen gewählten Modus extrahiert worden sind.

¡      WSDL: Das Ergebnis der Konvertierung nach WSDL

¡      Externe Verweise: Übersicht über verwendete Verweise im importierten Dokument. Hier wird sichtbar, falls andere importierte Dokumente erkannt worden sind.

     6.     Falls Ihr importiertes Dokument von anderen externen Definitionen referenzierbar sein soll, geben Sie im Eingabefeld Quelle die zum Dokument gehörende eindeutige ID an (in der Regel können Sie diese aus dem Dokument kopieren). Dies kann zum Beispiel eine URL sein. Auf diese Weise kann der Integration Builder aufeinander verweisende Dokumente einander zuordnen.

Beispiel

Sie wollen ein XSD-Dokument myMessage in das Integration Repository importieren, dass über die <include>-Anweisung auf drei andere XSD-Dokumente myStr1, myStr2 und myStr3 verweist. Eine Möglichkeit ist, zuerst myMessage zu importieren. Dann zeigt die Registerkarte externe Verweise an, dass auf drei Dokumente verwiesen wird und dass diese noch nicht im Integration Repository gefunden wurden. Danach legen Sie weitere externe Definitionen für myStr1, myStr2 und myStr3 im gleichen Namensraum an und geben jeweils die Quelle für diese Dokumente an. Wenn die Quelle nicht im Dokument selbst enthalten ist, finden Sie sie im verweisenden Dokument. Wenn Sie die Anzeige der externen Definition für myMessage auffrischen, zeigt die Registerkarte Externe Verweise, dass die Dokumente im Integration Repository gefunden worden sind. Sie können dann von dort über Doppelklick zu den anderen referenzierten externen Definitionen im Repository navigieren.