Configurer une liaison de port physique à l’aide d’un fichier de liaison de port à Oracle E-Business Suite

Lorsque vous utilisez le complément de projet BizTalk du service Consume Adapter pour générer des métadonnées pour les artefacts Oracle E-Business Suite, autres que les fichiers de schéma, le complément Consume Adapter Service génère également un fichier de liaison de port. Vous pouvez importer ce fichier de liaison dans votre application BizTalk pour créer un port d’envoi ou de réception physique. Pour obtenir des instructions sur l’importation de fichiers de liaison, consultez Réutiliser les liaisons d’adaptateurs avec Oracle E-Business Suite. Si vous importez ce fichier de liaison, vous n’avez pas besoin de créer manuellement un port d’envoi ou de réception physique.

La création d’un port à l’aide du fichier de liaison de port crée toujours un port d’envoi bidirectionnel ou un port de réception unidirectionnel. Si vous souhaitez créer un port d’envoi unidirectionnel, vous pouvez le créer manuellement en suivant la procédure mentionnée dans Configuration manuelle d’une liaison de port physique à l’adaptateur Oracle E-Business. Vous pouvez également suivre les solutions de contournement documentées dans cette rubrique pour modifier le fichier de liaison de port afin de créer des ports d’envoi unidirectionnel.

Voici quelques points clés que vous devez comprendre en ce qui concerne le fichier de liaison généré par le complément Consume Adapter Service :

• Les fichiers sont créés avec une convention de nommage spécifique. Si vous avez généré des métadonnées pour les opérations sortantes, c’est-à-dire pour envoyer des messages à Oracle E-Business Suite, le nom du fichier est WcfSendPort_OracleEBSBinding_Custom.bindinginfo.xml.

  Si vous avez généré des métadonnées pour les opérations entrantes, c’est-à-dire pour recevoir des messages d’Oracle E-Business Suite, le nom du fichier est WcfReceivePort_OracleEBSBinding_Custom.bindinginfo.xml.

• Le fichier contient des informations sur la configuration de la liaison, le type de liaison, l’URI du point de terminaison et l’action de port en fonction des opérations pour lesquelles des métadonnées ont été générées. Lorsque vous importez ce fichier de liaison dans votre application BizTalk pour créer un port, toutes les informations pertinentes requises pour configurer un port physique sont automatiquement définies sur le port.

  Important

  Par défaut, l’action sur le port d’envoi est mappée au nom de l’opération pour laquelle vous avez généré des métadonnées. Par exemple, si vous générez des métadonnées pour l’opération Insérer sur la table d’interface (par exemple, FA_BOOKS), l’action sur le port est définie <Operation Name="Insert" Action="InterfaceTables/Insert/OFA/FA/FA_BOOKS" />sur . Toutefois, le nom de l’opération sur le port d’envoi logique que vous créez dans l’orchestration BizTalk peut ne pas être le même. Vous devez vous assurer que le nom de l’opération dans le port d’envoi logique (dans l’orchestration BizTalk) et le port d’envoi physique (dans BizTalk Server console Administration) sont identiques. Si ce n’est pas le cas, vous recevrez une erreur lors de l’envoi de messages à Oracle E-Business Suite via le port d’envoi.

• Il vous suffit de fournir les informations d’identification pour que le port se connecte à Oracle E-Business Suite. Bien que le fichier de liaison conserve le nom d’utilisateur auquel se connecter, pour des raisons de sécurité, le fichier de liaison ne contient pas le mot de passe.

Considérations clés pour l’utilisation du fichier de liaison de port

• Lorsque vous importez le fichier de liaison, vous pouvez recevoir un message de boîte de dialogue vous informant que le nom de l’application BizTalk dans le fichier de liaison ne correspond pas au nom de l’application dans laquelle vous importez le fichier de liaison. Vous pouvez ignorer ce message en toute sécurité et continuer.

• Le fichier de liaison contient également les noms des ports et des emplacements de réception. Si l’application BizTalk dans laquelle vous importez le fichier de liaison crée un port ou un emplacement de réception portant le même nom qu’un port déjà existant dans la même application BizTalk, vous obtiendrez une erreur. Vous devez modifier manuellement le fichier de liaison pour spécifier un nom unique pour les ports ou emplacements de réception.

• Le fichier de liaison contient également des informations sur l’URI de connexion. Si le fichier de liaison crée un emplacement de réception qui a le même URI de réception qu’un emplacement de réception déjà existant dans la même application BizTalk, vous obtiendrez une erreur. Vous devez modifier manuellement le fichier de liaison pour spécifier un URI unique.

• Par défaut, le fichier de liaison de port pour les opérations sortantes contient toujours des définitions pour un port d’envoi bidirectionnel. Lorsque vous importez ce fichier dans une application BizTalk, il crée un port d’envoi bidirectionnel. Toutefois, vous pouvez avoir une orchestration qui a un port d’envoi unidirectionnel. Par conséquent, lorsque vous configurez une telle orchestration et utilisez le port créé en important le fichier de liaison, le port n’est pas disponible dans la liste. Cela se produit parce que le port logique que vous avez créé dans le cadre de l’orchestration est un port unidirectionnel, tandis que le port physique créé dans l’orchestration est un port bidirectionnel. Dans ce cas, vous pouvez modifier le fichier de liaison pour apporter les modifications suivantes :

  Pour

  Action

  Pour modifier le fichier de liaison de port afin de configurer un port d’envoi unidirectionnel

  1. Dans l’extrait suivant, remplacez la valeur de la propriété IsTwoWay par false. À l’origine, cette valeur est définie sur true. <SendPort Name="port_name" IsStatic="true" IsTwoWay="false " BindingOption="0"> 2. Commentez les extraits suivants : <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken= token" Type="1" TrackingOption="None" Description=""/> <ReceivePipelineData xsi:nil="true" />

  Important

  Pour les opérations entrantes, le fichier de liaison de port crée toujours un port de réception unidirectionnel. En effet, l’adaptateur Oracle E-Business prend uniquement en charge le port de réception unidirectionnel pour les opérations entrantes.

Configuration d’un port WCF-OracleEBS à l’aide du fichier de liaison de port généré à l’aide du complément Consume Adapter Service

Le complément Consume Adapter Service crée un fichier de liaison de port que vous pouvez importer dans BizTalk Server console d’administration. Vous pouvez utiliser le même fichier de liaison de port pour créer également le port bizTalk WCF-OracleEBS dans BizTalk Server console Administration. Toutefois, avant de créer WCF-OracleEBS port, vous devez effectuer les tâches suivantes pour modifier le fichier de liaison de port.

1. Ouvrez le fichier de liaison de port dans un éditeur de texte.

2. Recherchez et remplacez « WCF-Custom » par le nom avec lequel vous avez ajouté l’adaptateur WCF-OracleEBS dans BizTalk Server console Administration. Par exemple, si vous avez ajouté l’adaptateur WCF-OracleEBS en tant que « OracleEBSAdapter », remplacez « WCF-Custom » par « OracleEBSAdapter ».

3. Recherchez l’attribut « ConfigurationClsid » et remplacez la valeur existante de l’attribut par « F452BB15-7A0D-495d-9395-C630D3FD29CD ».

4. Enregistrez et fermez le fichier de liaison.

5. Importez le fichier de liaison dans BizTalk Server console Administration. Pour obtenir des instructions sur l’importation du fichier de liaison, consultez Réutiliser les liaisons d’adaptateur avec Oracle E-Business Suite.

Voir aussi

Blocs de construction pour créer des applications Oracle E-Business Suite