Durchsuchen, Suchen und Abrufen von Metadaten für RFC-Vorgänge in SAP
Dieser Abschnitt enthält Anweisungen zum Durchsuchen, Suchen und Abrufen von Metadaten aus SAP für RFC-Vorgänge mithilfe des Adapterdienstverweis-Plug-Ins, Assistenten zum Hinzufügen von Adaptermetadaten oder Nutzen des Adapterdienst-Add-Ins. Die meisten Anweisungen sind für alle drei Benutzeroberflächen identisch. Sofern zutreffend, werden für die jeweilige Benutzeroberfläche separate Verfahren bereitgestellt.
Bevor Sie die in den folgenden Abschnitten beschriebenen Schritte ausführen, benötigen Sie Folgendes:
Erstellt ein Visual Studio-Projekt.
Verbindung mit dem SAP-System mithilfe des Adapterdienst-Add-Ins nutzen, Assistenten zum Hinzufügen von Adaptermetadaten oder Add Adapter Service Reference Plug-In Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio.
Durchsuchen von RFCs in einem SAP-System
Beim Durchsuchen von Metadaten mithilfe des Add-Ins "Adapterdienst nutzen", "Assistent zum Hinzufügen von Adaptermetadaten" oder "Adapterdienstverweis-Plug-In hinzufügen" werden die SAP-Adapteroberflächen angezeigt:
RFCs als Vorgänge, die im SAP-System aufgerufen werden können.
RfcGetAttributes-Vorgang, mit dem Adapterclients Informationen zu den RFC-Verbindungsparametern abrufen können.
Weitere Informationen zum Durchsuchen von SAP-Metadaten finden Sie unter Verfügbarmachen von Adaptereinstellungen als Bindungseigenschaft mithilfe des WCF LOB Adapter SDK.
Führen Sie die folgenden Schritte aus, um RFCs in einem SAP-System zu durchsuchen, indem Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden.
So durchsuchen Sie RFCs in einem SAP-System
Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .
Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende oder ausgehende Vorgänge mithilfe des Adapters ausführen.
Klicken Sie im Feld Kategorie auswählen auf den Knoten RFC, um die RFC-Funktionsgruppen im Feld Verfügbare Kategorien und Vorgänge anzuzeigen. Alternativ können Sie auch die RFC-Funktionsgruppen anzeigen, indem Sie den RFC-Knoten erweitern.
Tipp
Sie können direkt zum "unmittelbaren" Kategorieknoten oder Unterkategorieknoten in der Struktur wechseln, indem Sie den Namen des Artefakts eingeben, während sich der Fokus auf der Strukturansicht im Feld Kategorie auswählen befindet. Wenn Sie beispielsweise zur Funktionsgruppe Basis RFC wechseln möchten, behalten Sie den Fokus auf dem RFC-Knoten , und geben Sie dann ein
Basis.Die folgende Abbildung zeigt das Add-In Adapter-Dienst nutzen, das die RFC-Funktionsgruppen auflistet.
Klicken Sie auf die RFC-Funktionsgruppen, um die relevanten RFCs anzuzeigen. Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen" mit den RFCs unter einer bestimmten RFC-Funktionsgruppe.
Durchsuchen von RFCs in einem SAP-System
Beim Durchsuchen von Metadaten nach RFCs in einem SAP-System mithilfe des Adapterdienst-Add-Ins, Assistenten zum Hinzufügen von Adaptermetadaten oder Add Adapter Service Reference Plug-in the SAP adapter:
Unterstützt Wildcardzeichen im Suchausdruck.
Aktiviert die Suche direkt unter dem Knoten, auf dem der Suchvorgang ausgeführt wird.
In der folgenden Tabelle sind die Sonderzeichen aufgeführt, die für die Suche verwendet werden können, und deren Interpretation durch den SAP-Adapter.
| Sonderzeichen | Interpretation |
|---|---|
| + (Plus) | Entspricht genau einem Zeichen. A+ entspricht z. B. AB, AC, AD |
| * (Sternchen) | Entspricht null oder mehr Zeichen. A* entspricht z. B. A, AB, ABC. |
Weitere Informationen zu den Sonderzeichen, die vom Adapter unterstützt werden, finden Sie unter Verfügbarmachen von Adaptereinstellungen als Bindungseigenschaft mithilfe des WCF LOB Adapter SDK.
Führen Sie die folgenden Schritte aus, um RFCs in einem SAP-System mit dem Adapterdienst-Add-In nutzen, dem Assistenten zum Hinzufügen von Adaptermetadaten oder dem Add Adapter Service Reference Plug-In zu durchsuchen.
So durchsuchen Sie RFCs in einem SAP-System
Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .
Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie mithilfe des Adapters nach eingehenden oder ausgehenden Vorgängen suchen.
Klicken Sie im Feld Kategorie auswählen auf die Funktionsgruppe RFC, die den RFC enthält, den Sie durchsuchen möchten. Wenn Sie nicht sicher sind, in welcher Funktionsgruppe gesucht werden soll, klicken Sie auf den RFC-Stammknoten.
Geben Sie im Textfeld In Kategorie suchen einen Suchausdruck ein, um nach einem bestimmten RFC zu suchen. Wenn Sie beispielsweise nach RFCs suchen möchten, deren Namen "RFC_CUST" enthält, geben Sie *RFC_CUST* in das Textfeld ein.
Klicken Sie auf die Schaltfläche mit dem Pfeilsymbol nach rechts, um die Suche zu starten. Nach Abschluss der Suche werden im Feld Verfügbare Kategorien und Vorgänge die RFCs aufgelistet, die die Suchkriterien erfüllen.
Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", das das RFC-Suchergebnis auflistet.
Generieren eines Schemas für BizTalk-Projekte
Sie können das Adapterdienst-Add-In nutzen oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden, um ein Schema für ausgewählte SAP-Artefakte zu generieren. Nachdem Sie die Artefakte, die Sie aufrufen möchten, durchsucht und gesucht haben, können Sie ein Schema für diese Artefakte generieren und dem Schema entsprechende Nachrichten an das SAP-System senden.
Hinweis
Sie können Kategorieknoten auswählen, um alle Vorgänge in der Unterstruktur dieser Kategorie zurückzugeben. Sie können z. B. eine gesamte RFC-Funktionsgruppe auswählen (um ein Schema für alle RFCs in dieser Gruppe zu generieren) oder bestimmte RFCs auswählen, um ein Schema nur für diese RFCs zu generieren. Weitere Informationen zu den Knoten finden Sie unter Metadatenknoten-IDs.
So rufen Sie Metadaten für RFCs ab
Stellen Sie mithilfe des Adapterdienst-Add-Ins oder des Assistenten zum Hinzufügen von Adaptermetadaten eine Verbindung mit einem SAP-Server her. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .
Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende oder ausgehende Vorgänge mithilfe des Adapters ausführen.
Klicken Sie im Feld Kategorie auswählen auf die Rfc-Funktionsgruppe, die den RFC enthält, für den Sie Metadaten generieren möchten.
Sie können auch nach bestimmten RFCs suchen. Wenn Sie beispielsweise nach RFCs suchen möchten, die "RFC_CUST" in ihrem Namen enthalten, klicken Sie auf den RFC-Knoten, und geben Sie im Textfeld In Kategorie suchen *RFC_CUST* ein. Klicken Sie auf die Schaltfläche mit dem Pfeilsymbol nach rechts, um die Suche zu starten. Im Feld Verfügbare Kategorien und Vorgänge werden alle RFCs aufgelistet, deren Name "RFC_CUST" enthält.
Wählen Sie im Feld Verfügbare Kategorien und Vorgänge die RFCs aus, für die Sie Metadaten generieren möchten, und klicken Sie auf Hinzufügen. Die ausgewählten RFCs werden im Feld Kategorien und Vorgänge hinzugefügt aufgeführt.
Die folgende Abbildung zeigt das Add-In Adapterdienst nutzen, das die ausgewählten RFCs auflistet.
Wenn Sie ein Schema für mehrere Vorgänge generieren möchten, gibt es möglicherweise einige doppelte Elementdefinitionen unter diesen Schemas, die zu Fehlern bei der Kompilierung des BizTalk-Projekts führen können. Betrachten Sie beispielsweise ein Szenario, in dem Sie ein Schema für einen Vorgang "Op1" generieren. Das Schema für "Op1" enthält einen Parameter des komplexen Datentyps "CT1". Nachdem Sie das Schema für "Op1" generiert haben, schließen Sie das Add-In "Adapterdienst nutzen" und öffnen es erneut, um das Schema für einen anderen Vorgang "Op2" zu generieren. Angenommen, "Op2" enthält auch einen Parameter des komplexen Datentyps "CT1". Nachdem Sie das Add-In "Adapterdienst nutzen" beendet und das Projekt kompiliert haben, erhalten Sie Kompilierungsfehler, da der komplexe Datentyp "CT1" zweimal in verschiedenen XSD-Dateien definiert ist. In solchen Situationen wird Folgendes empfohlen:
Generieren Sie ein Schema für alle Vorgänge in einer einzelnen Ausführung des Add-Ins "Adapterdienst nutzen". Dadurch wird sichergestellt, dass das Add-In Zum Verbrauchen des Adapterdiensts nur eine Definition für den komplexen Datentyp "CT1" generiert.
Wenn Sie ein Schema für mehrere Vorgänge für verschiedene Ausführungen des Add-Ins "Adapterdienst nutzen" generieren möchten, müssen Sie das Kontrollkästchen Eindeutige Schematypen generieren aktivieren, damit die generierten XSD-Dateien eindeutige Namespaces für den komplexen Datentyp "CT1" enthalten.
Klicken Sie auf OK. Die Schemadatei wird mit der XSD-Erweiterung am gleichen Speicherort wie das BizTalk-Projekt gespeichert.
Hinweis
Wenn Sie das Add-In zum Verbrauch des Adapterdiensts verwenden, werden die Dateien standardmäßig mit der Namenskonvention "SAPBinding<n.xsd>" erstellt, wobei "n" je nach Anzahl der erstellten Schemadateien 1, 2 usw. sein kann. Alternativ können Sie einen benutzerdefinierten Namen für die Schemadateien angeben, indem Sie einen Namen in das Textfeld Dateipräfix eingeben. Das Add-In Adapterdienst nutzen erstellt jetzt Schemadateien mit dem Dateinamenpräfix><n.xsd> der Namenskonvention<.
Hinweis
Das Add-In Adapter-Dienst nutzen erstellt auch eine Bindungsdatei (eine XML-Datei), die die Bindungseigenschaften enthält, die Sie beim Generieren des Schemas für einen Vorgang und die SOAP-Aktion zum Aufrufen des Vorgangs angegeben haben. Sie können diese Bindungsdatei in die BizTalk Server-Verwaltungskonsole importieren, um einen WCF-Custom Port mit dem Verbindungs-URI, den Bindungseigenschaften und dem SOAP-Aktionssatz zu erstellen. Weitere Informationen finden Sie unter Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für SAP.
Klicken Sie im Menü Datei auf Alle speichern.
Generieren eines WCF-Clients für RFC-Vorgänge mithilfe des Add Adapter Service Reference Plug-In
Sie können das Add Adapter Service Reference Plug-In verwenden, um entweder WCF-Clientcode zum Senden von RFCs an das SAP-System oder einen WCF-Dienstvertrag und Code zum Empfangen von RFCs (RFC-Server) vom SAP-System zu generieren.
So generieren Sie einen WCF-Client oder einen WCF-Dienstvertrag für RFCs
Wählen Sie im Add Adapter Service Reference Plug-in aus der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende Vorgänge (RFC-Server) oder ausgehende Vorgänge ausführen.
Erweitern Sie im Feld Kategorie auswählen den Knoten RFC , und klicken Sie dann auf die RFC-Funktionsgruppe, die den RFC enthält, für den Sie einen WCF-Client oder WCF-Dienstvertrag generieren möchten.
Sie können auch nach RFCs suchen. Um beispielsweise nach RFCs zu suchen, die "RFC_CUST" in ihrem Namen enthalten, klicken Sie auf den RFC-Knoten , und geben Sie im Textfeld In Kategorie suchen *RFC_CUST* ein. Klicken Sie auf die Schaltfläche mit dem Rechtspfeilsymbol, um die Suche zu starten. Im Feld Verfügbare Kategorien und Vorgänge werden alle RFCs aufgelistet, die "RFC_CUST" im Namen haben.
Wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Vorgänge oder Kategorien (RFC-Funktionsgruppen) aus, für die Sie einen WCF-Client (oder WCF-Dienstvertrag) generieren möchten, und klicken Sie dann auf Hinzufügen. Die ausgewählten Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt. Sie können einen beliebigen Knoten auswählen, der im Feld Verfügbare Kategorien und Vorgänge aufgeführt ist. Wenn Sie einen Kategorieknoten auswählen, werden alle unter diesem Knoten und seinen Unterknoten verfügbaren Vorgänge hinzugefügt.
Für die meisten Szenarien sind die Standardserialisierungsoptionen ausreichend. Bei Bedarf können Sie jedoch mehrere Aspekte über den generierten Code und den Typ des verwendeten Serialisierungsprogramms steuern. So legen Sie diese Optionen fest:
Klicken Sie auf Erweiterte Optionen , um das Feld Erweiterte Optionen zu öffnen.
Wählen Sie im Feld Erweiterte Optionen unter Optionen für generierten Proxy auswählen die gewünschten Optionen aus. Sie können beispielsweise auswählen, ob asynchrone Methoden für den WCF-Client generiert werden, oder die Generierung einer Konfigurationsdatei deaktivieren.
Wählen Sie unter Serialisierer den Serialisierer aus, der verwendet werden soll.
Die folgende Abbildung zeigt das Feld Erweiterte Optionen mit der Standardauswahl (Auto ist für das Serialisierungsprogramm ausgewählt, und es sind keine anderen Optionen ausgewählt).
Die Optionen, die Sie im Feld Erweiterte Optionen konfigurieren können, entsprechen einigen der verfügbaren Optionen, wenn Sie das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden. Weitere Informationen zu diesen Optionen finden Sie unter ServiceModel Metadata Utility Tool (Svcutil.exe).
Klicken Sie auf OK. Das Add Adapter Service Reference Plug-In speichert die WCF-Clientklasse (oder WCF-Dienstschnittstelle) und Hilfscode für die Vorgänge und Kategorien, die Sie in Ihrem Projektverzeichnis ausgewählt haben. Standardmäßig wird auch eine Konfigurationsdatei gespeichert. Für eingehende und ausgehende Vorgänge werden geringfügig unterschiedliche Dateien generiert. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte.