Partager via

Générer un client WCF ou un contrat de service WCF pour les artefacts de solution Oracle E-Business Suite

  • Article

Vous pouvez utiliser le plug-in Visual Studio Add Adapter Service Reference pour générer une classe de client WCF ou un contrat de service WCF (interface) destiné aux opérations sélectionnées sur les artefacts Oracle E-Business Suite. Vous pouvez également utiliser l’outil ServiceModel Metadata Utility Tool (svcutil.exe) pour générer la classe de client WCF ou le contrat de service WCF ; Toutefois, le plug-in Add Adapter Service Reference expose les fonctionnalités de l’outil ServiceModel Metadata Utility Par le biais d’une interface Microsoft Windows standard. Il fournit également des fonctionnalités de navigation et de recherche qui ne sont pas disponibles avec l’outil svcutil.exe, et génère un fichier de configuration basé sur les propriétés de liaison que vous sélectionnez lorsque vous vous connectez à Oracle E-Business Suite.

Génération d’une classe cliente à l’aide du plug-in Add Adapter Service Reference

Effectuez les étapes suivantes pour générer une classe de client WCF à l’aide du plug-in Add Adapter Service Reference.

Pour générer une classe de client WCF

  1. Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.

  2. Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur s’ouvre, suivez les étapes décrites dans Récupération des métadonnées pour les opérations Oracle E-Business Suite dans Visual Studio pour vous connecter à Oracle E-Business Suite et rechercher des opérations. Pour créer une classe de client WCF pour les opérations que vous sélectionnez, assurez-vous que Client (opérations sortantes) est sélectionné dans la liste déroulante Sélectionner le type de contrat (il s’agit de la valeur par défaut).

  3. Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer la classe de client WCF.

    Le plug-in Add Adapter Service Reference ajoute deux fichiers à votre projet :

  • OracleEBSBindingClient.cs. Ce fichier contient la classe de client WCF et le code d’assistance générés pour les opérations que vous avez sélectionnées.

  • app.config. Ce fichier contient une configuration de liaison et des configurations de point de terminaison client. Ces configurations sont basées sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Service Reference.

    Important

    Lors de l’utilisation du plug-in Visual Studio Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type chaîne et dont la valeur par défaut est Null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.

Génération d’un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference

L’adaptateur expose des opérations entrantes pour permettre à Oracle E-Business Suite d’envoyer des messages à un client d’adaptateur. Pour ces opérations, vous devez générer un contrat de service WCF. Cette section fournit des informations sur la façon de générer un contrat de service pour les opérations entrantes exposées par l’adaptateur.

Effectuez les étapes suivantes pour générer un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference.

Pour générer un contrat de service WCF pour les opérations entrantes

  1. Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.

  2. Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur s’ouvre, suivez les étapes décrites dans Récupération des métadonnées pour les opérations Oracle E-Business Suite dans Visual Studio pour vous connecter à Oracle E-Business Suite. Il existe plusieurs propriétés de liaison et une propriété d’URI que vous pouvez définir lorsque vous vous connectez à Oracle E-Business Suite.

  3. Une fois connecté à Oracle E-Business Suite, sélectionnez Service (opérations entrantes) dans la liste déroulante Sélectionner le type de contrat .

  4. Dans la zone Sélectionner une catégorie , accédez à l’opération entrante pour laquelle vous souhaitez générer le contrat de service. Par exemple, pour Opération de notification , cliquez sur le nœud racine (/), sélectionnez Notification dans la zone Catégories et opérations disponibles , puis cliquez sur Ajouter. Pour obtenir des instructions sur la recherche d’opérations entrantes, consultez Parcourir, rechercher et récupérer des métadonnées pour les opérations Oracle E-Business Suite.

  5. Pour générer le contrat de service WCF pour l’opération, cliquez sur OK.

    Le plug-in Add Adapter Service Reference ajoute trois fichiers à votre projet :

  • OracleEBSBindingInterface.cs. Ce fichier contient le contrat de service WCF (interface) et le code d’assistance générés pour l’opération entrante.

  • OracleEBSBindingService.cs. Ce fichier contient une classe qui implémente l’interface définie dans OracleDBBindingInterface.cs. Vous pouvez implémenter la logique métier qui traite les enregistrements retournés par l’opération entrante.

  • app.config. Ce fichier contient une configuration de liaison, des comportements de point de terminaison et une configuration de point de terminaison de service qui sont basés sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Reference Service.

    Important

    Lors de l’utilisation du plug-in Visual Studio Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type chaîne et dont la valeur par défaut est Null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.

Utilisation de svcutil.exe pour générer une classe de client WCF ou un contrat de service WCF

Vous pouvez utiliser svcutil.exe pour générer une classe de client WCF ou une interface de service WCF pour votre application. Vous devez configurer svcutil.exe pour l’utiliser avec l’adaptateur Oracle E-Business.

Svcutil.exe génère la classe de client WCF ou le contrat de service WCF dans un fichier de sortie. Le nom de fichier par défaut est output.cs. Vous devez inclure manuellement ce fichier dans votre projet Visual Studio. Pour plus d’informations sur svcutil.exe, consultez https://go.microsoft.com/fwlink/?LinkId=139432.