Partager via

Configurer une liaison de port physique à l’aide d’un fichier de liaison de port sur SAP

Lorsque vous utilisez le complément BizTalk Project Consume Adapter Service pour générer des métadonnées pour un artefact SAP, en plus des fichiers de schéma, le même complément 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. La réutilisation des liaisons de l'adaptateur SAP inclut des étapes pour importer des fichiers de liaison. 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.

Important

Lors de l’utilisation du complément Consommer le service adaptateur, 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 de liaison. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier de liaison, si nécessaire.

La création d’un port à l’aide du fichier de liaison de port crée toujours un port d’envoi ou de réception bidirectionnel. Si vous souhaitez créer un port unidirectionnel, vous pouvez le créer manuellement à l’aide des étapes de configuration manuelle d’une liaison de port physique sur l’adaptateur SAP. Vous pouvez également suivre les solutions de contournement documentées dans cette rubrique pour modifier le fichier de liaison de port pour créer des ports unidirectionnel.

Important

L'Assistant Ajout de métadonnées d'adaptateur ne crée pas de fichier de liaison de port à partir duquel vous pouvez créer un port WCF-SAP. Toutefois, vous pouvez apporter des modifications au fichier de liaison de port généré par le complément Consommer le service d’adaptateur et l’utiliser pour créer un port WCF-SAP. Pour plus d’informations, consultez Configuration d’un port WCF-SAP à l’aide du fichier de liaison de port généré à l’aide du complément de service d’adaptateur consommation.

Voici quelques points clés que vous devez comprendre en ce qui concerne le fichier de liaison généré par le module complémentaire Service d’adaptateur Consommation :

  • Les fichiers sont créés avec une convention d’affectation de noms spécifique. Si vous avez généré des métadonnées pour les opérations sortantes, c’est-à-dire pour envoyer des messages au système SAP, le nom du fichier est WcfSendPort_SAPBinding_Custom.bindinginfo.xml.

    Si vous avez généré des métadonnées pour les opérations entrantes, c’est-à-dire recevoir des messages du système SAP, le nom du fichier est WcfReceivePort_SAPBinding_Custom.bindinginfo.xml.

  • Le fichier contient des informations sur la configuration de liaison, le type de liaison, l’URI du point de terminaison et l’action de port en fonction des opérations pour lesquelles les métadonnées ont été générées. Lorsque vous importez ce fichier de liaison 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 générez des métadonnées. Par exemple, si vous générez des métadonnées pour RFC_CUSTOMER_GET, l’action sur le port est définie sur <Operation Name="RFC_CUSTOMER_GET" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />. 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 identique. Vous devez vous assurer que le nom de l’opération dans le port logique (dans l’orchestration BizTalk) et le port d’envoi physique (dans la console Administration de BizTalk Server) sont identiques. Si ce n’est pas le cas, vous recevez une erreur lors de l’envoi de messages au système SAP via le port d’envoi.

  • Vous devez uniquement fournir les informations d’identification du port pour vous connecter au système SAP. Bien que le fichier de liaison conserve le nom d’utilisateur avec lequel se connecter, pour des raisons de sécurité, le fichier de liaison ne contient pas le mot de passe.

Considérations clés relatives à 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 indiquant que le nom de l’application BizTalk dans le fichier de liaison ne correspond pas au nom de l’application dans lequel vous importez le fichier de liaison. Vous pouvez ignorer ce message en toute sécurité et continuer.

  • Le fichier de liaison contient également des noms de ports et d’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 liaisons pour spécifier un nom unique pour les ports ou les 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 contient toujours des définitions pour les ports bidirectionnel (envoi ou réception). Lorsque vous importez ce fichier dans une application BizTalk, il crée un port d’envoi ou de réception bidirectionnel. Toutefois, vous pouvez avoir une orchestration qui a un port d’envoi ou de réception 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, car 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 liaisons pour apporter les modifications suivantes :

    Pour cela Procédez comme suit
    Pour modifier le fichier de liaisons de port pour 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" />
    Pour modifier le fichier de liaisons de port pour configurer un port de réception 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.
    <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1">
    2. Commentez les extraits suivants :
    <SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" />
    <SendPipelineData xsi:nil="true" />
    <SendPipelineData xsi:nil="true" />

Configuration d’un port WCF-SAP à l’aide du fichier de configuration de liaison de port généré via le complément du service d'adaptateur Consommation.

Le Service de complément Consomme Adaptateur crée également un fichier de liaison de port que vous pouvez importer dans la console BizTalk Server Administration. Vous pouvez utiliser le même fichier de liaison de port pour créer également le port bizTalk WCF-SAP dans la console Administration de BizTalk Server. Toutefois, avant de créer WCF-SAP 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-SAP dans la console Administration de BizTalk Server. Par exemple, si vous avez ajouté l’adaptateur WCF-SAP en tant que « SAPAdapter », remplacez « WCF-Custom » par « SAPAdapter ».

  3. Recherchez l’attribut « ConfigurationClsid » et remplacez la valeur existante de l’attribut par « A5F15999-8879-472d-8C62-3B5EA9406504 ».

  4. Enregistrez et fermez le fichier de liaison.

  5. Importez le fichier de liaison dans la console Administration de BizTalk Server. Réutiliser les liaisons d’adaptateur SAP répertorie les étapes.

Voir aussi

Blocs de construction pour créer des applications SAP