Freigeben über

Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für Oracle E-Business Suite-Lösungsartefakte

  • Artikel

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 Oracle E-Business Suite-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 der Oracle E-Business Suite 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

  1. Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.

  2. Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wurde, führen Sie die Schritte unter Abrufen von Metadaten für Oracle E-Business Suite-Vorgänge in Visual Studio aus, um eine Verbindung mit der Oracle E-Business Suite 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).

  3. 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:

  • OracleEBSBindingClient.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. Diese Konfigurationen 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 Visual Studio-Plug-Ins Adapterdienstverweis hinzufügen keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben, 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

Der Adapter macht eingehende Vorgänge verfügbar, damit Oracle E-Business Suite Nachrichten an einen Adapterclient senden kann. Für solche Vorgänge müssen Sie einen WCF-Dienstvertrag generieren. Dieser Abschnitt enthält Informationen zum Generieren eines Dienstvertrags für eingehende Vorgänge, die vom Adapter verfügbar gemacht werden.

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 für eingehende Vorgänge

  1. Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.

  2. Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wurde, führen Sie die Schritte unter Abrufen von Metadaten für Oracle E-Business Suite-Vorgänge in Visual Studio aus, um eine Verbindung mit der Oracle E-Business Suite herzustellen. Es gibt mehrere Bindungseigenschaften und eine URI-Eigenschaft, die Sie möglicherweise festlegen möchten, wenn Sie eine Verbindung mit der Oracle E-Business Suite herstellen.

  3. Nachdem Sie eine Verbindung mit der Oracle E-Business Suite hergestellt haben, wählen Sie in der Dropdownliste Vertragstyp auswählen die Option Dienst (Eingehende Vorgänge) aus.

  4. Navigieren Sie im Feld Kategorie auswählen zu dem eingehenden Vorgang, für den Sie den Dienstvertrag generieren möchten. Klicken Sie beispielsweise für Benachrichtigungsvorgang auf den Stammknoten (/), wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Option Benachrichtigung aus, und klicken Sie dann auf Hinzufügen. Anweisungen zum Suchen nach eingehenden Vorgängen finden Sie unter Durchsuchen, Suchen und Abrufen von Metadaten für Oracle E-Business Suite-Vorgänge.

  5. Klicken Sie auf OK, um den WCF-Dienstvertrag für den Vorgang zu generieren.

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

  • OracleEBSBindingInterface.cs. Diese Datei enthält den generierten WCF-Dienstvertrag (Schnittstelle) und Hilfscode für den eingehenden Vorgang.

  • OracleEBSBindingService.cs. Diese Datei enthält eine Klasse, die die in OracleDBBindingInterface.cs definierte Schnittstelle implementiert. Sie können die Geschäftslogik implementieren, die die vom eingehenden Vorgang zurückgegebenen Datensätze verarbeitet.

  • 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 Visual Studio-Plug-Ins Adapterdienstverweis hinzufügen keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben, 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.

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

Sie können svcutil.exe verwenden, um eine WCF-Clientklasse oder eine WCF-Dienstschnittstelle für Ihre Anwendung zu generieren. Sie müssen svcutil.exe für die Verwendung mit dem Oracle E-Business-Adapter konfigurieren.

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 zu svcutil.exe finden Sie unter https://go.microsoft.com/fwlink/?LinkId=139432.