Aufrufen von Anforderungsgruppen in Oracle E-Business Suite mithilfe des WCF-Dienstmodells

Artikel
2023-10-14

Mit dem Microsoft BizTalk-Adapter für Oracle E-Business Suite können Sie Anforderungssätze in Oracle E-Business Suite ausführen. Anforderungsgruppen sind in eine oder mehrere Phasen unterteilt, und jede Phase enthält einen Satz von Berichten und gleichzeitigen Programmen. Weitere Informationen dazu, wie der Adapter Anforderungssätze unterstützt, finden Sie unter Vorgänge für Anforderungssätze.

Die WCF-Clientklasse

Der Name des WCF-Clients, der für den Aufruf der Anforderungssätze vom Oracle E-Business-Adapter generiert wurde, wird in der folgenden Tabelle aufgeführt.

Artefakt	WCF-Clientname
Anforderungssatz	RequestSets_[APP_NAME]Client

[APP_NAME] = Tatsächlicher Name der Oracle E-Business Suite-Anwendung; Beispiel: SQLAP.

Methodensignatur für Aufrufanforderungsgruppen

Die folgende Tabelle zeigt die Methodensignatur für Anforderungssätze.

Vorgang	Methodensignatur
Anforderungssatz	Öffentlicher <Rückgabetyp-Anforderungssatzname><> (Param 1, Param 2, ...)

Als Beispiel zeigt der folgende Code die Methodensignaturen für eine WCF-Clientklasse, die für den reqset_singlestage Anforderungssatz generiert wurde.

Hinweis

Dies ist ein benutzerdefinierter Anforderungssatz, der möglicherweise nicht in Ihrem Oracle E-Business Solution-instance verfügbar ist.

public partial class RequestSets_SQLAPClient : System.ServiceModel.ClientBase<RequestSets_SQLAP>, RequestSets_SQLAP{      
  
    public string REQSTG(  
      schemas.microsoft.com.OracleEBS._2008._05.Options.SetRelClassOptions SetRelClassOptions,  
      schemas.microsoft.com.OracleEBS._2008._05.Options.SetPrintOptions SetPrintOptions,   
      schemas.microsoft.com.OracleEBS._2008._05.Options.SetRepeatOptions SetRepeatOptions,   
      schemas.microsoft.com.OracleEBS._2008._05.Options.SetNlsOptions SetNlsOptions,  
      string StartTime,  
      schemas.microsoft.com.OracleEBS._2008._05.RequestSetStage.SQLAP.REQSTG.set1 set1_set1);  
}

In diesem Codeausschnitt ist RequestSets_SQLAPClient der Name der WCF-Klasse in der OracleEBSBindingClient.cs, die vom Add Adapter Service Reference Plug-In generiert wird. REQSTG ist der Name der Methode zum Aufrufen des Anforderungssatzes.

Erstellen eines WCF-Clients zum Aufrufen von Anforderungsgruppen

Der generische Aktionssatz, der zum Ausführen eines Vorgangs in Oracle E-Business Suite mithilfe eines WCF-Clients erforderlich ist, umfasst eine Reihe von Aufgaben, die unter Übersicht über das WCF-Dienstmodell mit dem Oracle E-Business Suite-Adapter beschrieben werden. In diesem Abschnitt wird beschrieben, wie Sie einen WCF-Client erstellen, um den reqset_singlestage Anforderungssatz aufzurufen.

So erstellen Sie einen WCF-Client

Erstellen Sie ein Visual C#-Projekt in Visual Studio. Erstellen Sie für dieses Thema eine Konsolenanwendung.
Generieren Sie die WCF-Clientklasse für den reqset_singlestage Anforderungssatz. Weitere Informationen zum Generieren einer WCF-Clientklasse finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für Oracle E-Business Suite-Lösungsartefakte.

Wichtig

Stellen Sie vor dem Generieren der WCF-Clientklasse sicher, dass Sie die EnableBizTalkCompatibilityMode-Bindungseigenschaft auf false festlegen.
Fügen Sie im Projektmappen-Explorer verweis auf und Microsoft.ServiceModel.ChannelshinzuMicrosoft.Adapters.OracleEBS.
Öffnen Sie die Datei Program.cs, und fügen Sie die folgenden Namespaces hinzu:
- Microsoft.Adapters.OracleEBS
- System.ServiceModel
Öffnen Sie die Datei Program.cs, und erstellen Sie einen Client, wie im folgenden Codeausschnitt beschrieben.
```
OracleEBSBinding binding = new OracleEBSBinding();  
EndpointAddress address = new EndpointAddress("oracleebs://ebs_instance_name");  
RequestSets_SQLAPClient client = new RequestSets_SQLAPClient(binding, address);  
```
In diesem Codeausschnitt ist der WCF-Client, RequestSets_SQLAPClient der in OracleEBSBindingClient.cs definiert ist. Diese Datei wird vom Add Adapter Service Reference Plug-In generiert.

Hinweis

In diesem Codeausschnitt geben Sie explizit die Bindungs- und Endpunktadresse im Anwendungscode an. Sie können diese Werte auch aus der Anwendungskonfigurationsdatei verwenden, app.config, die ebenfalls vom Add Adapter Service Reference Plug-In generiert wird. Weitere Informationen zu den verschiedenen Möglichkeiten zum Angeben der Clientbindung finden Sie unter Konfigurieren einer Clientbindung für die Oracle E-Business Suite.

Legen Sie die Anmeldeinformationen für den Client fest.

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

Da Sie Anforderungsgruppen in einer Oracle E-Business Suite-Anwendung aufrufen, müssen Sie den Anwendungskontext festlegen. In diesem Beispiel geben Sie zum Festlegen des Anwendungskontexts die Bindungseigenschaften OracleUserName, OraclePassword und OracleEBSResponsibilityName an. Weitere Informationen zum Anwendungskontext finden Sie unter Festlegen des Anwendungskontexts.
```
binding.OracleUserName = "myOracleEBSUserName";  
binding.OraclePassword = "myOracleEBSPassword";  
binding.OracleEBSResponsibilityName = "myOracleEBSResponsibility";  
```

Öffnen Sie den Client wie im folgenden Codeausschnitt beschrieben:

try  
{  
   Console.WriteLine("Opening Client...");  
   client.Open();  
}  
catch (Exception ex)  
{  
   Console.WriteLine("Exception: " + ex.Message);  
   throw;  
}

Rufen Sie den reqset_singlestage Anforderungssatz auf.

string RequestID;  

schemas.microsoft.com.OracleEBS._2008._05.RequestSetStage.SQLAP.REQSTG.set1 param =  
    new schemas.microsoft.com.OracleEBS._2008._05.RequestSetStage.SQLAP.REQSTG.set1();  

param.INSPARAMPROG = new schemas.microsoft.com.OracleEBS._2008._05.RequestSetConcurrentProgram.SQLAP.REQSTG.set1.SQLAP1.INSPARAMPROG();  
param.INSPARAMPROG.p_id = "123";  
param.INSPARAMPROG.p_name = "MyName";  

try  
{  
    Console.WriteLine("Invoking the reqset_singlestage request set");  
    RequestID = client.REQSTG(null, null, null, null, null, param);  
    Console.WriteLine("The request ID generated for the request set is : " + RequestID);  
    Console.WriteLine("*****************************************************************");  
    Console.WriteLine("\nHit <RETURN> to end");  
    Console.ReadLine();  
}  
catch (Exception ex)  
{  
    Console.WriteLine("Exception : " + ex);  
    throw;  
}

Schließen Sie den Client wie im folgenden Codeausschnitt beschrieben:
```
client.Close();  
```
Erstellen Sie das Projekt, und führen Sie es dann aus. Die Anwendung ruft den reqset_singlestage Anforderungssatz auf und gibt eine Anforderungs-ID zurück, die in die Konsole geschrieben wird.

Weitere Informationen

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

Freigeben über