Freigeben über

Übersicht über das WCF-Dienstmodell mit dem Oracle E-Business Suite-Adapter

  • Artikel

Der Microsoft BizTalk-Adapter für Oracle E-Business Suite macht ein Oracle E-Business Suite-System als WCF-Dienst verfügbar. Um Vorgänge für Oracle E-Business Suite-Artefakte auszuführen, z. B. zum Aufrufen einer gespeicherten Prozedur, rufen Sie einen Vorgang auf dem Adapter auf, der wiederum den Vorgang für die Oracle E-Business Suite ausführt. Ihr Code fungiert als Client für den WCF-Dienst, der vom Adapter bereitgestellt wird.

Im Windows Communication Foundation-Dienstmodell (WCF) wird der Dienstvertrag, der zwischen einem Client und einem Dienst besteht, als .NET-Schnittstelle dargestellt, und Vorgänge werden auf dieser Schnittstelle als Methoden dargestellt. Der Oracle E-Business-Adapter und WCF stellen Tools bereit, mit denen Sie diese Schnittstelle für Zielvorgänge aus den Metadaten generieren können, die der Adapter verfügbar macht. Diese Tools erstellen auch eine WCF-Clientklasse, die zum Aufrufen der Vorgänge verwendet werden kann, die in der Dienstschnittstelle verfügbar gemacht werden. Eine Clientanwendung kann die Methoden der WCF-Clientklasse aufrufen, um Vorgänge auf dem Adapter aufzurufen.

Im folgenden Abschnitt wird erläutert, wie Sie das WCF-Dienstmodell verwenden, um Vorgänge mit einem WCF-Client aufzurufen.

Aufrufen von Vorgängen in der Oracle E-Business Suite mit einem WCF-Client

Um das WCF-Dienstmodell zum Aufrufen von Vorgängen für den Oracle E-Business-Adapter zu verwenden, müssen Sie zunächst eine WCF-Clientklasse für die Zielvorgänge generieren. Anschließend können Sie eine instance dieser Klasse erstellen, einen WCF-Client, und dessen Methoden aufrufen, um diese Vorgänge in der Oracle E-Business Suite auszuführen.

So rufen Sie Vorgänge für den Oracle E-Business-Adapter auf

  1. Generieren Sie eine WCF-Clientklasse und Hilfscode. Verwenden Sie das Visual Studio-Plug-In Add Adapter Service Reference oder das ServiceModel Metadata Utility Tool (svcutil.exe), um eine WCF-Clientklasse für Oracle E-Business Suite-Artefakte zu generieren, mit denen Sie arbeiten möchten. Weitere Informationen zum Generieren eines WCF-Clients finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für Oracle E-Business-Lösungsartefakte.

  2. Erstellen Sie einen WCF-Client instance, und konfigurieren Sie den WCF-Client. Das Konfigurieren des WCF-Clients umfasst die Angabe der Bindungs- und Endpunktadresse (Verbindungs-URI), die der Client verwendet. Sie können dies entweder zwingend im Code oder deklarativ in der Konfiguration tun. Mit dem folgenden Code wird ein WCF-Client erstellt, der auf das gleichzeitige Kundenschnittstellenprogramm in der Debitorenanwendung in der Oracle E-Business Suite ausgerichtet ist. Außerdem werden die Anmeldeinformationen für die Oracle E-Business Suite festgelegt. Der WCF-Client wird über die Konfiguration initialisiert.

    ConcurrentPrograms_ARClient client = new ConcurrentPrograms_ARClient("OracleEBSBinding_ConcurrentPrograms_AR"); //picking the binding and address from app.config  

client.ClientCredentials.UserName.UserName = "myuser";  
client.ClientCredentials.UserName.Password = "mypassword";

    Hinweis

    Sie können entweder die Clientbindung und die Endpunktadresse im Code angeben oder in der app.config-Konfigurationsdatei deklarieren. Der vorangehende Codeausschnitt verwendet letzteres. Weitere Informationen zur Verwendung beider Ansätze finden Sie unter Konfigurieren einer Clientbindung für die Oracle E-Business Suite.

  3. Öffnen Sie den WCF-Client.

    client.Open();

  4. Rufen Sie Methoden auf dem WCF-Client auf, der in Schritt 2 erstellt wurde, um Vorgänge für die Oracle E-Business Suite auszuführen. Der folgende Code ruft das Gleichzeitigprogramm Customer Interface in der Debitorenanwendung in der Oracle E-Business Suite auf.

    string Result = client.RACUST(null, null, null, description, null, recipro_cust, org_id);

    RACUST ist der tatsächliche Name des gleichzeitigen Kundenschnittstellenprogramms. Customer Interface ist der Anzeigename des gleichzeitigen Programms.

  5. Schließen Sie den WCF-Client.

    client.Close();

Weitere Informationen

Entwickeln von Oracle E-Business Suite-Anwendungen mithilfe des WCF-Kanalmodells