Vue d’ensemble du modèle de service WCF avec l’adaptateur Oracle E-Business Suite
L’adaptateur Microsoft BizTalk pour Oracle E-Business Suite expose un système Oracle E-Business Suite en tant que service WCF. Pour effectuer des opérations sur des artefacts Oracle E-Business Suite, par exemple pour appeler une procédure stockée, vous appelez une opération sur l’adaptateur, qui, à son tour, effectue l’opération sur Oracle E-Business Suite. Votre code agit en tant que client pour le service WCF présenté par l’adaptateur.
Dans le modèle de service Windows Communication Foundation (WCF), le contrat de service qui existe entre un client et un service est représenté sous la forme d’une interface .NET, et les opérations sont représentées en tant que méthodes sur cette interface. L’adaptateur Oracle E-Business et WCF fournissent des outils qui vous permettent de générer cette interface pour des opérations ciblées à partir des métadonnées exposées par l’adaptateur. Ces outils créent également une classe de client WCF qui peut être utilisée pour appeler les opérations exposées dans l’interface de service. Une application cliente peut appeler les méthodes de la classe de client WCF pour appeler des opérations sur l’adaptateur.
La section suivante explique comment utiliser le modèle de service WCF pour appeler des opérations avec un client WCF.
Appel d’opérations sur Oracle E-Business Suite avec un client WCF
Pour utiliser le modèle de service WCF afin d’appeler des opérations sur l’adaptateur Oracle E-Business, vous devez d’abord générer une classe de client WCF pour les opérations cibles. Vous pouvez ensuite créer un instance de cette classe, un client WCF, et appeler ses méthodes pour effectuer ces opérations sur Oracle E-Business Suite.
Pour appeler des opérations sur l’adaptateur Oracle E-Business
Générez une classe de client WCF et du code d’assistance. Utilisez le plug-in Visual Studio Add Adapter Service Reference ou l’outil Utilitaire de métadonnées ServiceModel (svcutil.exe) pour générer une classe de client WCF ciblée sur les artefacts Oracle E-Business Suite avec lesquels vous souhaitez travailler. Pour plus d’informations sur la génération d’un client WCF, consultez Générer un client WCF ou un contrat de service WCF pour les artefacts de solution Oracle E-Business.
Créez un client WCF instance et configurez le client WCF. La configuration du client WCF implique de spécifier la liaison et l’adresse de point de terminaison (URI de connexion) que le client utilisera. Vous pouvez le faire impérativement dans le code ou de manière déclarative dans la configuration. Le code suivant crée un client WCF qui cible le programme simultané de l’interface client dans l’application Clients dans Oracle E-Business Suite. Il définit également les informations d’identification pour Oracle E-Business Suite. Le client WCF est initialisé à partir de la configuration.
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";
Notes
Vous pouvez spécifier la liaison client et l’adresse de point de terminaison dans le code ou les déclarer dans le fichier de configuration app.config. L’extrait de code précédent utilise ce dernier. Pour plus d’informations sur l’utilisation de l’une ou l’autre des approches, consultez Configurer une liaison cliente pour Oracle E-Business Suite.
Ouvrez le client WCF.
client.Open();
Appelez des méthodes sur le client WCF créé à l’étape 2 pour effectuer des opérations sur Oracle E-Business Suite. Le code suivant appelle le programme simultané de l’interface client dans l’application Clients dans Oracle E-Business Suite.
string Result = client.RACUST(null, null, null, description, null, recipro_cust, org_id);
RACUST est le nom réel du programme simultané de l’interface client. L’interface client est le nom convivial du programme simultané.
Fermez le client WCF.
client.Close();
Voir aussi
Développer des applications Oracle E-Business Suite à l’aide du modèle de canal WCF