Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte

Artikel
07/21/2023

Sie können das Visual Studio-Plug-In Add Adapter Service Reference verwenden, um eine WCF-Clientklasse oder einen WCF-Dienstvertrag (Schnittstelle) für ausgewählte Vorgänge in SAP-Artefakten zu generieren. Sie können auch das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden, um die WCF-Clientklasse oder den WCF-Dienstvertrag zu generieren. Das Add Adapter Service Reference Plug-In macht jedoch die Funktionalität des ServiceModel Metadata Utility Tools über eine Standardmäßige Microsoft Windows-Schnittstelle verfügbar. Es bietet auch Such- und Suchfunktionen, die mit dem svcutil.exe-Tool nicht verfügbar sind, und generiert eine Konfigurationsdatei basierend auf den Bindungseigenschaften, die Sie beim Herstellen einer Verbindung mit dem SAP-System auswählen.

Generieren einer Clientklasse mithilfe des Add Adapter Service Reference Plug-In

Führen Sie die folgenden Schritte aus, um eine WCF-Clientklasse mithilfe des Add Adapter Service Reference Plug-Ins zu generieren.

So generieren Sie eine WCF-Clientklasse

Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.
Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wurde, führen Sie die Schritte unter Abrufen von Metadaten für SAP-Vorgänge in Visual Studio aus, um eine Verbindung mit dem SAP-System herzustellen und nach Vorgängen zu suchen. Um eine WCF-Clientklasse für die von Ihnen ausgewählten Vorgänge zu erstellen, stellen Sie sicher, dass Client (Ausgehende Vorgänge) in der Dropdownliste Vertragstyp auswählen ausgewählt ist (dies ist die Standardeinstellung).
Nachdem Sie alle Vorgänge ausgewählt haben, die Sie als Ziel verwenden möchten, klicken Sie auf OK , um die WCF-Clientklasse zu generieren.

Das Add Adapter Service Reference Plug-In fügt Ihrem Projekt zwei Dateien hinzu:

SAPBindingClient.cs. Diese Datei enthält die generierte WCF-Clientklasse und Hilfscode für die ausgewählten Vorgänge.
App.config. Diese Datei enthält eine Bindungskonfiguration und Clientendpunktkonfigurationen. Die Einstellungen basieren auf den Auswahlen, die Sie beim Konfigurieren der Bindung und Verbindung für das Add Adapter Service Reference Plug-In getroffen haben.

Wichtig

Wenn Sie beim Verwenden des Add Adapter Service Reference Plug-Ins keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben und deren Standardwert NULL ist, ist diese Bindungseigenschaft in der app.config-Datei nicht verfügbar. Sie müssen die Bindungseigenschaft und ihren Wert bei Bedarf manuell in der app.config-Datei hinzufügen.

Generieren eines WCF-Dienstvertrags mithilfe des Add Adapter Service Reference Plug-In

Wenn Sie den SAP-Adapter verwenden, um IDOCs, RFCs und tRFCs aus dem SAP-System zu empfangen, fungiert Ihr Code als Dienst für den Adapter. Das heißt, der Adapter empfängt das entsprechende Artefakt vom SAP-System und ruft dann einen (eingehenden) Vorgang für Ihren Code auf, um das Artefakt an Ihre Anwendung zu übermitteln.

Sie müssen daher einen WCF-Dienst implementieren, der diesen eingehenden Vorgang vom Adapter empfangen kann. Dazu verwenden Sie das Add Adapter Service Reference Plug-In, um eine .NET-Schnittstelle zu generieren, die den Dienstvertrag darstellt, der vom Adapter für den Vorgang angezeigt wird. Diese .NET-Schnittstelle wird auch als WCF-Dienstvertrag bezeichnet. Das Add Adapter Service Reference Plug-In generiert auch eine Klasse, die eine stubbed-Implementierung des WCF-Diensts enthält. Anschließend implementieren Sie diese Schnittstelle, um den WCF-Dienst zu erstellen, den Sie zum Empfangen des Vorgangs verwenden können.

Führen Sie die folgenden Schritte aus, um einen WCF-Dienstvertrag mithilfe des Add Adapter Service Reference Plug-Ins zu generieren.

So generieren Sie einen WCF-Dienstvertrag

Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.
Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wurde, führen Sie die Schritte unter Abrufen von Metadaten für SAP-Vorgänge in Visual Studio aus, um eine Verbindung mit dem SAP-System herzustellen und nach Vorgängen zu suchen. Um einen WCF-Dienstvertrag für die von Ihnen ausgewählten Vorgänge zu erstellen, stellen Sie sicher, dass Dienst (Eingehende Vorgänge) in der Dropdownliste Vertragstyp auswählen ausgewählt ist.
Nachdem Sie alle Vorgänge ausgewählt haben, die Sie als Ziel festlegen möchten, klicken Sie auf OK , um den WCF-Dienstvertrag zu generieren.

Das Add Adapter Service Reference Plug-In fügt Ihrem Projekt drei Dateien hinzu:

SAPBindingInterface.cs. Diese Datei enthält den generierten WCF-Dienstvertrag (Schnittstelle) und Hilfscode für die ausgewählten Vorgänge.
SAPBindingService.cs. Diese Datei enthält eine stubbed WCF-Dienstklasse, die die in SAPBindingInterface.cs definierte Schnittstelle implementiert. Sie können die Geschäftslogik, die rfc, tRFC oder IDOC verarbeitet, direkt in den Methoden dieser Klasse implementieren.
App.config. Diese Datei enthält eine Bindungskonfiguration, Endpunktverhalten und Dienstendpunktkonfiguration, die auf den Auswahlen basieren, die Sie beim Konfigurieren der Bindung und Verbindung für das Add Adapter Service Reference Plug-In getroffen haben.

Wichtig

Wenn Sie beim Verwenden des Add Adapter Service Reference Plug-Ins keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben und deren Standardwert NULL ist, ist diese Bindungseigenschaft in der app.config-Datei nicht verfügbar. Sie müssen die Bindungseigenschaft und ihren Wert bei Bedarf manuell in der app.config-Datei hinzufügen.

Hinweis

Sie müssen keine RFC-Serverparameter angeben, wenn Sie den Verbindungs-URI für das Add Adapter Service Reference Plug-In konfigurieren, um den WCF-Dienstvertrag zu generieren. Der SAP-Adapter ruft Metadaten über eine Clientverbindung aus dem SAP-System ab.

Generieren einer WCF-Clientklasse oder eines WCF-Dienstvertrags mithilfe von svcutil.exe

Sie können svcutil.exe verwenden, um eine WCF-Clientklasse oder einen WCF-Dienstvertrag für Ihre Anwendung zu generieren. Sie müssen svcutil.exe für die Verwendung mit dem SAP-Adapter konfigurieren. Weitere Informationen zum Konfigurieren und Verwenden von svcutil.exe mit dem SAP-Adapter finden Sie unter Verwenden des ServiceModel-Metadaten-Hilfsprogramms mit dem BizTalk-Adapter für mySAP Business Suite.

Svcutil.exe generiert die WCF-Clientklasse oder den WCF-Dienstvertrag in einer Ausgabedatei. Der Standarddateiname lautet output.cs. Sie müssen diese Datei manuell in Ihr Visual Studio-Projekt einschließen.

Weitere Informationen

Entwickeln von SAP-Anwendungen mithilfe des WCF-Kanalmodells

Teilen über