RFC-Lookups grafisch definieren

Aufruf des RFC ermöglichen und RFC für Mapping-Editor importieren

Legen Sie den RFC-Empfängerkanal für den Aufruf des Anwendungssystems im Integration Directory an.

Weitere Informationen:

• Kommunikationskanäle definieren

• Konfiguration des RFC-Empfänger-Adapters

Dieser Empfängerkanal wird zunächst nur zum Testen des Lookups benötigt. Der Entwickler oder Berater kann später einen anderen Empfängerkanal anlegen, um den gleichen RFC in einem anderen System aufzurufen (siehe auch Schritt 8 unten).

Importieren Sie den RFC in das Enterprise Services Repository.

Weitere Informationen: Import von IDocs und RFCs

Parametrisiertes Message-Mapping-Programm definieren

Legen Sie im Enterprise Services Repository ein Message-Mapping mit Ausgangs- und Zielstruktur an beziehungsweise öffnen Sie ein bereits vorhandenes zur Bearbeitung.

Wechseln Sie im Mapping-Editor auf die Registerkarte Signatur . Legen Sie einen Import-Message-Mapping-Parameter der Kategorie Adapter an (beispielsweise MMP_RFC ) und weisen Sie ihm die Adaptermetadaten des RFC-Adapters zu. Die Adaptermetadaten des RFC-Adapters werden über die Software-Komponente SAP BASIS ausgeliefert.

Wechseln Sie im Mapping-Editor auf die Registerkarte Definition und zu Ihrem Zielfeld-Mapping, für das Sie den RFC-Lookup definieren wollen.

Ziehen Sie die Standardfunktion RFC Lookup der Funktionskategorie Konvertierungen in den Datenfluss-Editor und legen Sie den Aufruf in den Funktionseigenschaften grafisch fest:

• Wählen Sie über die Listbox den Import-Message-Mapping-Parameter für den RFC-Adapter aus ( MMP_RFC aus Schritt 4). Mit Hilfe dieses Parameters übergibt später das Message-Mapping die ID des Empfängerkanals an die Funktion, der für den Lookup verwendet werden soll (siehe Schritte 7 und 9).

• Wählen Sie über die Wertehilfe den importierten RFC aus Schritt 2 aus.

• Um den RFC-Aufruf zu definieren, modellieren Sie in den Funktionseigenschaften der Standardfunktion RFC Lookup die Eingangs- und Rückgabeparameter der Funktion und wie sie mit den Request- und Response-Parametern des RFCs verknüpft sind. Wenn Sie später Ausgangsfelder oder Funktionen mit den Eingangsparametern verbinden, definieren Sie implizit ein Mapping zwischen diesen Ausgangs-Feldern oder Funktionen und den Parametern des RFC-Requests (linke Seite). Dieses Mapping wird zur Laufzeit analog zu äquivalenten Zielfeld-Mappings prozessiert. Entsprechend bestimmen Sie in den Funktionseigenschaften, welche Parameter der RFC-Response über die Rückgabeparameter im Datenfluss-Editor Zielfeldern oder Funktionen zugewiesen werden können (rechte Seite):

Definieren Sie das jeweilige Mapping folgendermaßen:

• Um einen Parameter des RFC-Requests oder der RFC-Response als Eingangs- beziehungsweise Rückgabeparameter der Funktion RFC Lookup zu übernehmen, doppelklicken Sie auf den Parameter in der Struktur. Der Parameter wird dann jeweils in die Tabelle im unteren Bereich übernommen, in der Sie zusätzlich die Reihenfolge der Eingangs- beziehungsweise Rückgabeparameter festlegen können.

• Parameter des RFC, die keine Skalarwerte sind, werden im Dialogfenster fett angezeigt. Solche Parameter sind beispielsweise Tabellenparameter des RFC, die auf Elemente mit maxOccurs = unbounded abgebildet werden. Für das Mapping auf die Parameter des RFC-Requests beziehungsweise für das Mapping von den Parametern der RFC-Response gelten die gleichen Regeln wie für normale Zielfeld-Mappings.

• Statt einen Parameter des RFC-Requests als Eingangsparameter der Standardfunktion RFC Lookup anzubieten, können Sie für den Parameter auch eine Konstante in der Struktur eingeben.

• Am RFC definierte Ausnahmen können folgendermaßen beim RFC-Lookup behandelt werden:

• Wenn Sie das Ankreuzfeld Ausnahmen verwenden in den Funktionseigenschaften der Standardfunktion gesetzt haben, fügt der Mapping-Editor der Standardfunktion im Datenfluss-Editor einen zusätzlichen Parameter in Rot hinzu (der unterste Rückgabeparameter). Wenn Sie diesem Rückgabeparameter kein Zielfeld zuweisen, ignorieren Sie die Ausnahmen des RFCs (das Message-Mapping wird zur Laufzeit nicht abgebrochen). Ansonsten übergibt die Mapping-Laufzeit die Ausnahme als XML-Struktur und kann beispielsweise in einer benutzerdefinierten Funktion ausgewertet werden. Gibt es keine Ausnahme, übergibt die Mapping-Laufzeit einen leeren Kontext.

• Wenn Sie das Ankreuzfeld Ausnahmen verwenden nicht gesetzt haben, bricht die Mapping-Laufzeit das gesamte Message-Mapping bei einer auftretenden Ausnahme während des RFC-Lookups ab.

Um dem Message-Mapping-Parameter, dem Sie in Schritt 1 den Importfunktionsparameter zugewiesen haben ( MMP_RFC ), später einen Empfängerkanal zuweisen zu können, müssen Sie diesen Importparameter über ein Binding einem Operation-Mapping-Parameter zuweisen (siehe Schritte 4 bis 8 unter Importparameter definieren und verwenden ), beispielsweise IM_RFC .

Um das Mapping-Programm und den Mapping-Lookup ausführen oder testen zu können, sind die folgenden Schritte im Integration Directory notwendig:

Empfängerkanal für Mapping-Lookup konfigurieren

Falls Sie einen anderen RFC-Empfängerkanal als den aus Schritt 1 verwenden wollen, legen Sie einen neuen Empfängerkanal für den Aufruf des Anwendungssystems im Integration Directory an.

Weitere Informationen:

• Kommunikationskanäle definieren

• Konfiguration des RFC-Empfänger-Adapters

Um die ID des Empfängerkanals zur Laufzeit an Ihr Message-Mapping-Programm zu übergeben, legen Sie eine Interface-Ermittlung an, dem Sie das Operation-Mapping aus Schritt 7 zuweisen. In der Interface-Ermittlung können Sie anschließend den Empfängerkanal dem Operation-Mapping-Parameter zuweisen (im Beispiel IM_RFC ).

Weitere Informationen: Interface-Ermittlung definieren

Achtung: Der Mapping-Lookup kann nur ausgeführt werden, wenn diese Schritte durchgeführt worden sind und die Laufzeitkomponenten des Integration Servers installiert sind. Ansonsten bricht das gesamte Message-Mapping-Programm mit einer Fehlermeldung ab.