Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Abschnitt enthält Anweisungen zum Durchsuchen, Suchen und Abrufen von Metadaten aus SAP für BAPI-Vorgänge mithilfe des Add Adapter Service Reference Plug-Ins, Add Adapter Metadata Wizard oder Using Adapter Service Add-In. Die meisten Anweisungen sind für alle drei Benutzeroberfläche identisch. Sofern zutreffend, werden separate Verfahren für die jeweilige Benutzeroberfläche bereitgestellt.
Bevor Sie die in den folgenden Abschnitten beschriebenen Schritte ausführen, müssen Sie folgendes haben:
Ein Visual Studio-Projekt wurde erstellt.
Verbunden mit dem SAP-System mithilfe des Add-Ins "Adapterdienst nutzen", "Assistent zum Hinzufügen von Adaptermetadaten" oder "Adapterdienstverweis-Plug-In hinzufügen". Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio.
Durchsuchen von BAPIs 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 BAPIs des SAP-Adapters als Geschäftsobjekte und ALS RFCs angezeigt. Das Durchsuchen von BAPIs als RFCs ähnelt dem Durchsuchen eines RFC in einem SAP-System. In einem solchen Fall sind die BAPIs als RFCs im RFC verfügbar. Weitere Informationen zum Durchsuchen von RFCs finden Sie unter Durchsuchen, Suchen und Abrufen von Metadaten für RFC-Vorgänge in SAP.
Dieser Abschnitt enthält Informationen zum Durchsuchen von BAPIs als Geschäftsobjekte. Weitere Informationen zum Durchsuchen von SAP-Metadaten finden Sie unter How Does the Adapter Surface SAP Metadata?
Führen Sie die folgenden Schritte aus, um BAPIs in einem SAP-System zu durchsuchen, indem Sie das Add-In "Adapterdienst nutzen", den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden.
So durchsuchen Sie BAPIs in einem SAP-System
Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In Zum Verwenden des Adapterdiensts, 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 mit dem Adapter ausführen.
Klicken Sie im Feld Kategorie auswählen auf den Knoten BAPI, um die BAPI-Funktionsbereiche im Feld Verfügbare Kategorien und Vorgänge anzuzeigen. Alternativ können Sie auch die BAPI-Funktionsbereiche anzeigen, indem Sie den BAPI-Knoten erweitern.
Tipp
Sie können direkt zum "unmittelbaren" Kategorieknoten oder zum Unterkategorieknoten in der Struktur wechseln, indem Sie den Namen des Artefakts eingeben, während der Fokus auf der Strukturansicht im Feld Kategorie auswählen liegt. Wenn Sie beispielsweise zum Funktionsbereich Controlling BAPI wechseln möchten, behalten Sie den Fokus auf dem BAPI-Knoten , und geben Sie dann ein
Controlling.Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", das die BAPI-Funktionsbereiche auflistet.
Klicken Sie auf den BAPI-Funktionsbereich, um die weiteren Kategorisierungen des BAPI-Funktionsbereichs anzuzeigen.
Klicken Sie auf den BAPI-Funktionsbereich, um die für diesen Funktionsbereich unterstützten relevanten Vorgänge anzuzeigen. Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen" mit den Für einen bestimmten Funktionsbereich unterstützten Vorgängen.
Suchen nach BAPIs in einem SAP-System
Beim Durchsuchen von Metadaten nach BAPIs in einem SAP-System mithilfe des Add-Ins "Adapterdienst-Add-In", "Add Adapter Metadata Wizard" oder "Add Adapter Service Reference Plug-In the SAP adapter" (Adapterdienstverweis-Plug-In hinzufügen) in einem SAP-System:
Unterstützt Feldhalterzeichen im Suchausdruck.
Aktiviert die Suche sofort unter dem Knoten, auf dem der Suchvorgang ausgeführt wird.
In der folgenden Tabelle sind die Sonderzeichen aufgeführt, die für die Suche und deren Interpretation durch den SAP-Adapter verwendet werden können.
| Sonderzeichen | Interpretation |
|---|---|
| + (Plus) | Entspricht genau einem Zeichen. A+ entspricht z. B. AB, AC, AD |
| * (Sternchen) | Entspricht null oder mehr Zeichen. Beispielsweise stimmt A* mit A, AB, ABC überein. |
Weitere Informationen zu den Sonderzeichen, die vom Adapter unterstützt werden, finden Sie unter How Does the Adapter Surface SAP Metadata?
Führen Sie die folgenden Schritte aus, um BAPIs in einem SAP-System zu durchsuchen, indem Sie das Add-In Zum Verwenden des Adapterdiensts, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden.
So suchen Sie BAPIs in einem SAP-System
Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In Zum Verwenden des Adapterdiensts, 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 mit dem Adapter nach eingehenden oder ausgehenden Vorgängen suchen.
Klicken Sie im Feld Kategorie auswählen auf den BAPI-Funktionsbereich mit dem zu durchsuchenden BAPI.
Hinweis
Sie können nur auf Stammebene nach BAPIs suchen.
Geben Sie im Textfeld In kategorie suchen einen Suchausdruck ein, um nach einem bestimmten BAPI zu suchen. Wenn Sie beispielsweise nach BAPIs suchen möchten, die "Konto" im Namen enthalten, geben Sie *Konto* in das Textfeld ein.
Klicken Sie auf die Schaltfläche mit dem Rechtspfeilsymbol, um die Suche zu starten. Nach Abschluss der Suche werden im Feld Verfügbare Kategorien und Vorgänge die BAPIs aufgelistet, die die Suchkriterien erfüllen.
Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", das das BAPI-Suchergebnis auflistet.
Generieren eines Schemas für BizTalk-Projekte
Sie können das Add-In Zum Verbrauchen des Adapterdiensts oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden, um ein Schema für ausgewählte SAP-Artefakte zu generieren. Nachdem Sie nach den Artefakten gesucht haben, die Sie aufrufen möchten, 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 BAPI-Unterfunktion auswählen (um ein Schema für alle BAPIs in dieser Gruppe zu generieren) oder bestimmte BAPIs auswählen, um das Schema nur für diese BAPIs zu generieren. Weitere Informationen zu den Knoten finden Sie unter Metadatenknoten-IDs4.
So rufen Sie Metadaten für BAPIs ab
Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In "Adapterdienst nutzen" oder den Assistenten zum Hinzufügen von Adaptermetadaten 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 mit dem Adapter ausführen.
Klicken Sie im Feld Kategorie auswählen auf die BAPI-Funktionsgruppe, die das BAPI enthält, für das Sie Metadaten generieren möchten.
Wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Funktionsbereiche oder Vorgänge aus, für die Sie Metadaten generieren möchten, und klicken Sie auf Hinzufügen. Die ausgewählten Funktionsbereiche oder Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt.
Die folgende Abbildung zeigt das Add-In "Adapter-Dienst nutzen", das die ausgewählten BAPIs auflistet.
Wenn Sie ein Schema für mehrere Vorgänge generieren möchten, gibt es möglicherweise einige doppelte Elementdefinitionen unter diesen Schemas, die bei der Kompilierung des BizTalk-Projekts einen Fehler verursachen 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 empfehlen wir Folgendes:
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 "Adapter-Dienst nutzen" 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, aktivieren Sie das Kontrollkästchen Eindeutige Schematypen generieren , damit die generierten XSD-Dateien eindeutige Namespaces für den komplexen Datentyp "CT1" enthalten.
Klicken Sie auf OK. Die Schemadatei wird mit einer XSD-Erweiterung am gleichen Speicherort wie das BizTalk-Projekt gespeichert.
Hinweis
Wenn Sie das Add-In "Consume Adapter Service" verwenden, werden die Dateien standardmäßig mit der Benennungskonvention "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 Namenskonventionsdateipräfix <><n.xsd>.
Hinweis
Das Add-In Adapterdienst 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 BAPI-Vorgänge mithilfe des Add Adapter Service Reference Plug-In
Sie können das Add Adapter Service Reference Plug-In verwenden, um WCF-Clientcode für BAPI-Vorgänge zu generieren (eingehende Vorgänge werden für BAPIs nicht unterstützt).
So generieren Sie einen WCF-Client für BAPIs
Wählen Sie im Add Adapter Service Reference Plug-In in der Dropdownliste Vertragstyp auswählen die Option Client (Ausgehende Vorgänge) aus.
Erweitern Sie im Feld Kategorie auswählen den Knoten BAPI, und suchen Sie dann nach den BAPI-Kategorien oder -Vorgängen, für die Sie einen WCF-Client generieren möchten.
Wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Vorgänge oder Kategorien (BAPI-Funktionsgruppen) aus, für die Sie einen WCF-Client 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 Vorgänge ausgewählt, die unter diesem Knoten und seinen Unterknoten verfügbar sind.
Wichtig
Das Add Adapter Service Reference Plug-In generiert eine eindeutige WCF-Clientklasse für jedes Geschäftsobjekt. Abhängig von den von Ihnen ausgewählten Kategorien und Vorgängen können mehrere WCF-Clientklassen generiert werden. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte.
Für die meisten Szenarien sind die Standardserialisierungsoptionen ausreichend. Bei Bedarf können Sie jedoch mehrere Aspekte des generierten Codes und des verwendeten Serialisierungstyps 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 Serialisierungsprogramm das Serialisierungsprogramm aus, das 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 und den Hilfscode in Ihrem Projektverzeichnis für die ausgewählten Vorgänge und Kategorien. Standardmäßig wird auch eine Konfigurationsdatei gespeichert. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte.