Message-Interface 

Verwendung

Mit einem Message-Interface beschreiben Sie unabhängig von einer Plattform beziehungsweise Programmiersprache eine Schnittstelle, mit der Sie über die Exchange Infrastructure Messages zwischen Anwendungskomponenten austauschen wollen. Abhängig von den Kommunikationsparametern eines Message-Interface, kann es entweder die Rolle übernehmen, einen Request zu senden (Outbound) oder einen Request entgegenzunehmen (Inbound). Über die Zuordnung von einem Outbound-Interface mit einem Inbound-Interface können verschiedene Kommunikationspartner miteinander Messages austauschen (siehe auch: Kommunikationspartner (Fallbeispiele)). Im Bezug auf Message-Interfaces sind folgende Verbindungen möglich:

·      Message-Interfaces untereinander

·      Message-Interfaces mit importierten Interfaces oder

·      Ein Message-Interface mit einem Interface, das bei einem Adapter konfiguriert wurde.

Message-Interfaces ermöglichen über die Proxy-Generierung die Anbindung von ABAP- und Java-Anwendungen.

Voraussetzungen

Sie verweisen von Message-Interfaces auf Message-Typen, Fault-Message-Typen, Messages aus externen Definitionen, RFC- oder IDoc-Messages. Sie können Message-Interfaces zwar abspeichern, ohne auf diese Objekte zu verweisen, dessen Definition wäre aber dann noch unvollständig.

Siehe außerdem den Abschnitt Voraussetzungen in Einführung in die Interface-Entwicklung.

Funktionsumfang

Kommunikationsparameter

Beim anlegen von Message-Interfaces legen Sie mit den Attributen Modus und Kategorie die Kommunikationsparameter fest. Sie können somit folgende Typen von Message-Interfaces anlegen:

Kategorie	Modus		Verwendung
	synchron	asynchron
inbound	synchrones Inbound-Message-Interface	asynchrones Inbound-Message-Interface	Proxy-Kommunikation
outbound	synchrones Outbound-Message-Interface	asynchrones Outbound-Message-Interface
abstrakt	synchrones abstraktes Message-Interface	asynchrones abstraktes Message-Interface	Festlegen der Prozesssignatur

Je nach den gewählten Attributen für das Message-Interface, müssen Sie unter Message-Typen auf ein oder zwei Message-Typen verweisen. Der Input-Message-Typ definiert die erwartete Message, der Output-Message-Typ die gesendete.

Wenn Sie anwendungsspezifische Fehler behandeln beziehungsweise im Monitoring persistieren wollen, weisen Sie dem Message-Interface außerdem entsprechende Fault-Message-Typen zu.

Fault-Messages sind dazu vorgesehen, Fehler auf Empfängerseite dem Sender beziehungsweise dem Monitoring zu übermitteln. Für asynchrone abstrakte Message-Interfaces und asynchrone Outbound-Message-Interfaces können Sie daher keine Fault-Messages definieren.

Erweiterte Funktionen

Wenn Sie ein Message-Interface angelegt haben, können Sie:

·      Für Felder der Request-Message Kontextobjekte zuweisen, um sie später an Stelle von XPath-Ausdrücken in einem Integrationsprozess oder beim logischen Routing zu verwenden.

·      Mit Hilfe der ABAP Proxy-Generierung beziehungsweise der Java Proxy-Generierung ein Proxy für die Laufzeit generieren.

·      Die Interface-Beschreibung als WSDL-Dokument exportieren (siehe: XSD- und WSDL-Dokumente exportieren)

Aktivitäten

...

     1.     Legen Sie ein Message-Interface in der Design-Pflege des Integration Builder an (siehe: Anlegen eines Objektes).

     2.     Geben Sie eine Beschreibung zu Ihrem Message-Interface ein.

     3.     Legen Sie im Rahmen Attribute die Kommunikationsparameter fest.

     4.     Verweisen Sie im Rahmen Message-Typen auf den notwendigen Input- und/oder Output-Message-Typ. Mögliche Objekttypen sind unter Interface- und Message-Typen aufgeführt.

     5.     Wenn es sich nicht um ein asynchrones Outbound- oder abstraktes Message-Interface handelt, können Sie in der unteren Tabelle des Rahmens Message-Typen optional auf Fault-Message-Typen verweisen. Verwenden Sie dazu folgende Funktionen:

Verweise auf Fault-Messages bearbeiten

Funktion	Verwendung
	Einfügen einer zusätzlichen Zeile in der Tabelle. Tragen Sie in die eingefügte Zeile den gewünschten Fault-Message-Typ über die Eingabehilfe (siehe unten) oder manuell ein.
	Über diese Funktion am Zeilenende einer Tabellenzeile können Sie die Eingabehilfe zum Auswählen eines Fault-Message-Typs aufrufen.
	Verändern der Reihenfolge der Fault-Message-Typen.
	Löschen eines Verweis auf einen Fault-Message-Typ.

 

     6.     Weisen Sie optional Feldern mit Hilfe der Eingabehilfe Kontextobjekte zu. Dies ist für Attribute und für Elemente möglich, die einen skalaren Typ haben.

     7.     Speichern Sie Ihre Änderungen.