Partager via

Guide pratique pour exporter des liaisons pour une solution EDI-AS2

  • Article

Cette rubrique décrit l'exportation de la configuration depuis un ordinateur configuré comme une solution EDI et/ou AS2. Cela vous permet de définir la même configuration sur un autre ordinateur de manière automatisée. Vous pouvez exporter les liaisons à partir d'une application, d'un groupe ou d'un assembly.

Vous créez un fichier de liaison à partir de la console d’administration BizTalk Server. Le fichier de liaison .xml contient toutes les informations pertinentes pour votre configuration BizTalk Server. Cela inclut toutes les propriétés de configuration EDI et AS2, à l'exception de certaines informations de sécurité. Pour plus d’informations sur les nœuds d’un fichier de liaison (y compris les nœuds EDI et AS2), consultez Structure d’un fichier de liaison. Pour obtenir des informations générales sur les liaisons EDI/AS2, consultez « Nœuds EDI et AS2 dans le fichier de liaison BizTalk Server » ci-dessous.

Vous pouvez également exporter des liaisons dans le cadre de l'exportation d'une application à l'aide d'un fichier .msi. Pour plus d’informations, consultez Guide pratique pour exporter une application BizTalk. Vous pouvez enfin utiliser la commande BTSTask pour exporter et importer des liaisons. Pour plus d’informations sur BTSTask, consultez BTSTask Command-Line Reference.

Exportation des liaisons

Lorsque vous exportez la configuration, BizTalk Server exportez automatiquement les propriétés EDI et les informations d’autres parties liées. Si vous activez l’exportation d’informations de partie globale, BizTalk Server exportera également les propriétés pour les parties qui ne sont pas liées à une orchestration et les propriétés EDI globales. Vous pouvez exporter les informations de tiers global de trois manières :

  • En activant la propriété Exporter les informations du tiers global dans la boîte de dialogue Exporter les liaisons.

  • En activant la case à cocher Tiers globaux dans le volet Sélectionner les ressources de l'Assistant Exportation de fichier MSI.

  • En utilisant le commutateur GlobalParties dans l'outil de ligne de commande BTSTask, comme suit :

    BTSTask ExportBindings -Destination:value ((([-ApplicationName:value] | [-AssemblyName:value]) [-GlobalParties]) | [-GroupLevel])

    Pour des raisons de sécurité, lorsque vous exportez un fichier de liaison, BizTalk Server ne conserve pas les mots de passe des liaisons du fichier. BizTalk Server supprime les champs UNB6.1 et UNB6.2 des propriétés EDIFACT, et les champs ISA1, ISA2, ISA3 et ISA4 des propriétés X12.

    Outre l'utilisation de la commande export-bindings, export-application ou BTSTask, vous pouvez créer un fichier de liaison XML manuellement. En procédant ainsi, vous pouvez exporter les paramètres de tiers et EDI à partir d'une application sectorielle. Vous pouvez ensuite importer les liaisons à l'aide de la commande import-bindings ou de la commande BTSTask.

Prérequis

Vous devez être connecté avec un compte membre du groupe d'administrateurs BizTalk Server. Pour plus d’informations, consultez « Autorisations requises pour le déploiement et la gestion d’une application BizTalk » dans la documentation BizTalk Server.

Exportation de la configuration dans un fichier de liaison

  1. Sur l’ordinateur à partir duquel vous souhaitez exporter la configuration, ouvrez la console d’administration BizTalk Server.

  2. Cliquez avec le bouton droit sur l’application BizTalk à partir de laquelle vous souhaitez copier la configuration, pointez sur Exporter, puis cliquez sur Liaisons.

    Notes

    Vous pouvez également utiliser l'utilitaire BTSTask pour exporter ou importer la configuration.

  3. Sélectionnez l'option export, en choisissant d'exporter à partir de l'application ou du groupe actuel ou en exportant des liaisons pour un assembly.

  4. Si vous souhaitez exporter toutes les parties et leurs propriétés non sensibles, même si une orchestration n’y est pas liée, cliquez sur Exporter les informations de partie globale.

    Notes

    Si vous ne cliquez pas sur Exporter les informations de partie globale, BizTalk Server exportera les propriétés de toutes les parties liées à une orchestration, dans le fichier de liaison. Toutefois, elle n’exportera pas les parties qui ne sont pas liées à une orchestration, sauf si vous cliquez sur Exporter les informations de partie globale.

    Notes

    Le fichier de liaison généré lorsque la propriété Exporter les informations de partie globale est sélectionnée inclut la configuration de toutes les parties définies sur l’ordinateur. Il n'est pas possible d'exporter la configuration d'un sous-ensemble de l'ensemble complet de tiers défini sur un ordinateur.

  5. Cliquez sur OK pour exporter les liaisons.

    Notes

    BizTalk Server n’exportez pas de champs sensibles à l’EDI, tels que les mots de passe ou les informations de sécurité/d’authentification. Il exporte une chaîne vide pour tout champ EDI sensible. Après avoir importé les liaisons sur un autre ordinateur, vous devez définir manuellement les valeurs des champs EDI sensibles.

  6. Notez manuellement les champs EDI sensibles, tels que les mots de passe ou les informations de sécurité / d'authentification, pour un paramétrage ultérieur sur l'ordinateur sur lequel vous importez les liaisons.

Nœuds EDI et AS2 dans le fichier de liaison BizTalk Server

Si vous exportez votre configuration avec la propriété Exporter les informations de partie globale sélectionnée, BizTalk Server générera un fichier de liaison qui contient les nœuds suivants :

EdiData  
   PartyEDIProperties  
      PartnerAgreement  
         Contacts  
      PartnerEdifact  
         PartnerEdifactReceiverGroups  
         PartnerEdifactSenderGroups  
      PartnerAckValidation  
      PartnerX12  
      PartnerX12ReceiverGroups  
      PartnerX12SenderGroups  
      PartnerBatchUpdatable  
      PartnerAS2CommonUpdatable  
      PartnerAS2

Les propriétés globales EDI sont ajoutées au fichier de liaison dans les nœuds suivants.

EDIGlobalProperties  
   EDIGlobalProperties  
      GlobalCommon  
      GlobalEdiFact  
      GlobalX12

Les nœuds EDI et AS2 sont ajoutés à la fin du fichier de liaison BizTalk Server. Le nœud EdiData est ajouté au sous-nœud Tiers sous le nœud Regroupement de tiers, et le nœud EdiGlobalProperties est ajouté après, et au même niveau que, le nœud Regroupement de tiers. Pour plus d’informations sur les nœuds EDI et AS2 dans le fichier de liaison BizTalk, consultez Structure d’un fichier de liaison.

Le nœud EdiData est facultatif. Toutefois, si le nœud EdiData est présent, les sous-nœuds sous EdiData sont requis. De même, le nœud EdiGlobalProperties est facultatif. Cependant, si le nœud EdiGlobalProperties est présent, les sous-nœuds sous ce dernier sont requis.

Les nœuds de fichiers de liaison EDI et AS2 ne correspondent pas directement aux pages de propriétés dans le Gestionnaire des contrats partenaires dans la console d’administration BizTalk Server. Certains nœuds de fichier de liaison EDI et AS2 incluent des propriétés utilisées pour les rôles d'expéditeur et des propriétés utilisées pour les rôles de récepteur. Le rôle est indiqué par la propriété IsSender dans le nœud. Pour les nœuds qui ne sont pas utilisés pour les rôles d'expéditeur et de récepteur (PartnerAgreement, PartnerBatchUpdatable, PartnerAS2Updatable et GlobalCommon), IsSender est toujours False.

Les nœuds PartnerEdifact et PartnerX12 contiennent des propriétés pour les rôles d'expéditeur et de récepteur, qu'IsSender soit défini sur True ou False. Par exemple, PartnerEdifact inclut un champ Una1 (utilisé pour le tiers comme récepteur des échanges), même si IsSender est True. PartnerEdifact inclut également un champ Unb5CheckDup (utilisé pour le tiers comme expéditeur des échanges), même si IsSender est False. Cependant, lorsqu'IsSender est True, ces champs pour le tiers comme récepteur des échanges ne sont pas utilisés dans l'interface utilisateur ou par le moteur, mais ont des valeurs par défaut. De même, lorsqu'IsSender est False, ces champs pour le tiers comme expéditeur des échanges ne sont pas utilisés dans l'interface utilisateur ou par le moteur, mais ont des valeurs par défaut.

Si la valeur par défaut d'une propriété est null, le champ n'est pas inclus dans le fichier de liaison à moins que ce champ n'ait une valeur.

Les données du fichier de liaison sont enregistrées dans les tables de la base de données de gestion BizTalk (BizTalkMgmtDb).