Bouclage

Article
07/21/2023

Vous utilisez l’utilitaire Bouclage pour générer automatiquement un contrat de bouclage qui est une copie miroir d’un contrat d’origine à partenaire. Vous pouvez ainsi effectuer des échanges de messages d'une organisation d'origine à un partenaire et d'un partenaire à une organisation d'origine sur un seul ordinateur. Vous pouvez utiliser cet utilitaire pour un scénario avec des messages 0A1 ou un scénario sans messages 0A1. Vous pouvez créer un contrat de bouclage pour un contrat action-message (non-0A1) ou un accord 0A1.

Vous pouvez également utiliser l’utilitaire pour inscrire ou annuler l’inscription d’un organization d’origine pour un rôle d’expéditeur. Lorsque vous utilisez l’utilitaire pour activer un organization de base, il crée deux ports d’envoi, <Home>. Async et <Home>. Synchroniser, que le organization utilise pour communiquer avec son partenaire.

Emplacement dans le kit de développement logiciel (SDK)

<Disque>\ Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\

Bouclage en cours d’exécution

Pour exécuter le bouclage

Ouvrez une invite de commandes.
Déplacer vers <drive>\ Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\.
À l’invite de commandes, tapez Bouclage, tapez les commutateurs requis et appropriés, puis appuyez sur Entrée.

Syntaxe du bouclage

Voici la syntaxe que vous utilisez pour démarrer cet utilitaire de ligne de commande :

Loopback [/enable|/disable <home_organization>] [/mirror|/unmirror <agreement_name>] [/NoF <0A1_agreement>]

Description de la syntaxe

Le tableau suivant décrit chaque partie de la syntaxe utilisée par l’utilitaire Loopback.

Syntaxe	Description
enable	Inscrit le organization désigné dans <home_organization> pour un rôle d’expéditeur. Il crée deux ports d’envoi, <Home>. Async et <Home>. Synchroniser, que le partenaire utilise pour communiquer avec le organization d’origine.
disable	Supprime la liste des organization de base pour un rôle d’expéditeur.
home_organization	Partenaire à inscrire ou à désinscrire pour un rôle d’expéditeur.
mirror	Crée un contrat de bouclage basé sur l’accord désigné dans <agreement_name>.
unmirror	Supprime l’accord de bouclage en fonction du contrat désigné dans <agreement_name>.
agreement_name	L’accord pour miroir ou unmirror dans le scénario de bouclage.
Nof	Définit la propriété de contrat 0A1 du contrat de message d’action mis en miroir par l’utilitaire Bouclage sur <0A1_agreement>. Un commutateur /NoF peut uniquement être ajouté à une commande Loopback qui contient également un commutateur /miroir.
0A1_agreement	Un accord 0A1 qui sera utilisé par l’accord miroir de agreement_name. Ce contrat est généré par la mise en miroir d’un accord répondeur 0A1.

Remarques

L’utilitaire bouclage bascule les rôles lors de la création du contrat de bouclage. Si un organization était le organization d’origine dans le contrat d’origine, l’utilitaire en fait le partenaire organization dans le contrat de bouclage. De même, si un organization était le partenaire organization dans le contrat d’origine, l’utilitaire en fait le organization d’origine dans le contrat de bouclage. L’utilitaire change également le paramètre de la propriété de rôle Accueil. Si la propriété de rôle Accueil était l’initiateur dans le contrat d’origine, l’utilitaire en fait le répondeur, et vice versa. Toutes les autres propriétés restent les mêmes.

L’utilitaire bouclage nomme le contrat de bouclage avec le même nom que le contrat d’origine, précédé de « bouclage : ». Pour éviter toute confusion, ne nommez pas un contrat commençant par « bouclage ».

Si vous exécutez l’utilitaire sur un contrat pour lequel vous avez déjà généré un contrat de bouclage, l’utilitaire annule le contrat de bouclage existant et crée un contrat de bouclage.

Vous avez besoin de l’utilitaire Bouclage, car vous ne pouvez pas créer un contrat en miroir dans la console de gestion BTARN. Vous ne pouvez pas créer un contrat dans la console de gestion BTARN pour lequel les propriétés de organization de base, de organization partenaire et de rôle d’accueil sont inversées, et tous les autres champs sont identiques aux champs d’un contrat existant. De même, BTARN ne prend pas en charge la modification du contrat de bouclage directement dans la console. Vous recevrez une erreur si vous essayez d’ouvrir un contrat de bouclage dans la console. Si vous devez apporter des modifications au contrat de bouclage, modifiez le contrat d’origine, puis exécutez à nouveau l’utilitaire bouclage sur celui-ci pour régénérer le contrat de bouclage.

Important

Le scénario de bouclage ne prend pas en charge les accords signés. Dans ce scénario, un message signé échoue à la validation, car BizTalk Server vous permet de configurer une seule partie avec un certificat de signature. Un organization de base et un organization partenaire ne peuvent pas utiliser le même certificat de signature. Il s’agit d’une limitation dans BizTalk Server liée à l’identification unique d’une partie à l’aide d’un certificat de signature. Par conséquent, deux parties BizTalk ne peuvent pas partager le même certificat.

Pour plus d’informations sur l’implémentation du bouclage, consultez Didacticiel sur le bouclage.

Utilisation du bouclage avec des contrats 0A1

Vous pouvez configurer un scénario de bouclage pour générer des messages 0A1 (notification d’échec). Pour ce faire, vous devez créer les contrats suivants pour l’organization de base : un contrat de message d’action de demande, un accord 0A1 initiateur et un contrat de répondeur 0A1. Vous devez ensuite exécuter l’utilitaire bouclage sur chacun de ces contrats afin de créer les contrats suivants pour le organization partenaire : un contrat de message d’action de réponse, un accord initiateur 0A1 et un accord répondeur 0A1. Cela est obligatoire, car vous ne pouvez pas utiliser la console de gestion BTARN pour créer ces contrats.

L’ensemble complet des contrats doit inclure des contrats pour les messages suivants. À titre d’illustration, le message d’action est un 3A4 :

Un accord Home_to_Partner_3A4 (message d’action). Un accord pour lancer le pip du message d’action à partir du organization HOME vers le organization PARTENAIRE.
Home_to_Partner_Initiator_0A1 accord. Un accord pour lancer un PIP 0A1 à partir du home organization au organization PARTENAIRE.
Home_to_Partner_Responder_0A1 accord. Un accord pour recevoir un PIP 0A1 de la part du partenaire organization à l’organization HOME.
Contrat Loopback :Home_to_Partner_3A4 (message de réponse). Un accord pour recevoir un PIP 3A4 du home organization au organization PARTENAIRE.
Loopback :Home_to_Partner_Responder_0A1 contrat. Un accord pour lancer un PIP 0A1 du organization PARTENAIRE vers le organization HOME.
Bouclage : Home_to_Partner_Initiator_0A1. Un accord pour recevoir un PIP 0A1 du home organization au organization PARTENAIRE.

Création des contrats de bouclage pour les messages 0A1

Pour créer l’ensemble complet des contrats, vous devez utiliser l’utilitaire Bouclage pour créer les contrats action-message et 0A1 sur le partenaire. Les tableaux suivants montrent les opérations de bouclage requises pour générer les contrats de bouclage partenaire. À titre d’illustration, cette rubrique utilise un message 3A4 dans les tables.

Étape	Contrats HOME
1, 4	Home_to_Partner_3A4 Home Org : HOME Organisation partenaire : PARTNER Rôle d’organisation d’accueil : Initiateur Accord 0A1 : Home_to_Partner_Initiator_0A1 Description : Accord pour lancer PIP 3A4 de HOME à PARTNER
2	Home_to_Partner_Initiator_0A1 Accueil : Accueil Partenaire : Partenaire Rôle : Initiateur Description : Accord pour lancer PIP 0A1 de HOME à PARTNER
3	Home_to_Partner_Responder_0A1 Accueil : Accueil Partenaire : Partenaire Rôle : Répondeur Description : Accord pour recevoir PIP 0A1 de PARTNER to HOME

Étape	Contrats PARTENAIRES (mis en miroir à l’aide de Loopback.exe)
7	Bouclage :Home_to_Partner_3A4 Accueil : Partenaire Partenaire : Accueil Rôle : Répondeur Contrat 0A1 : Bouclage :Home_to_Partner_Responder_0A1 Description : Accord pour recevoir PIP 3A4 de HOME à PARTNER Commande de bouclage pour la créer : Bouclage /miroir Home_to_Partner_3A4 /NoF Loopback :Home_to_Partner_Responder_0A1
5	Bouclage :Home_to_Partner_Responder_0A1 Accueil : Partenaire Partenaire : Accueil Rôle : Initiateur Description : Accord pour lancer PIP 0A1 du partenaire vers l’accueil Commande de bouclage pour la créer : Bouclage /miroir Home_to_Partner_Responder_0A1
6	Bouclage :Home_to_Partner_Initiator_0A1 Accueil : Partenaire Partenaire : Accueil Rôle : Répondeur Description : Accord pour recevoir PIP 0A1 de HOME à PARTNER Commande de bouclage pour la créer : Bouclage /miroir Home_to_Partner_Initiator_0A1

Exécutez les commandes bouclage dans ces tables dans le cadre de la procédure suivante.

Pour créer les contrats pour un scénario de bouclage à l’aide de messages 0A1

Dans la console de gestion BTARN, créez un contrat pour que le message d’action de demande soit envoyé par le organization de base.

Créez un contrat pour que le message 0A1 de l’initiateur soit envoyé par le organization de base, puis procédez comme suit :

Propriété	Pour
Mon organization	Définissez sur le organization de base.
Organization partenaires	Définissez sur le partenaire.
Rôle d’accueil	Définissez sur Notificateur d’échec PIP (initiateur).

À l’aide de la console de gestion BTARN, créez un contrat pour que le message du répondeur 0A1 soit envoyé au organization d’accueil, puis procédez comme suit :

Propriété	Pour
Mon organization	Définissez sur le organization de base.
Organization partenaires	Définissez sur le partenaire.
Rôle d’accueil	Définissez sur Administrateur du rapport d’échec (répondeur).

À l’aide de la console de gestion BTARN, définissez la propriété de contrat 0A1 pour le contrat de message d’action de requête de l’organization de base sur le nom du contrat 0A1 initiateur pour le organization de base.
À l’aide de l’utilitaire Bouclage, créez un contrat pour que le message initiateur 0A1 soit envoyé par le organization partenaire. Pour ce faire, vous devez mettre en miroir l’accord 0A1 du répondeur pour le organization d’accueil. Cela crée un contrat 0A1 avec le nom bouclage :<0A1 nom> de l’accord. La My organization propriété est définie sur le partenaire, la Partner organization propriété est définie sur le organization de base et la Home role propriété est PIP Failure Notifier (Initiator).
À l’aide de l’utilitaire Bouclage, créez un contrat pour le message 0A1 du répondeur pour le organization partenaire. Pour ce faire, vous devez mettre en miroir le contrat d’initiateur 0A1 pour le organization de base. Cela crée un contrat 0A1 avec le nom bouclage :<0A1 nom> de l’accord. La My organization propriété est définie sur le partenaire, la Partner organization propriété est définie sur le organization de base et la Home role propriété est Administrateur du rapport d’échec (répondeur) .
À l’aide de l’utilitaire bouclage, créez un contrat pour le message d’action de réponse pour le organization partenaire. Dans la même commande, vous devez définir la propriété du contrat 0A1 sur le contrat 0A1 du répondant pour le partenaire. Pour ce faire, vous devez mettre en miroir le contrat de message d’action de demande pour le organization d’accueil et utiliser le commutateur /NoF avec le nom du contrat 0A1 du répondeur du partenaire. Cela crée un contrat d’action-message de réponse portant le nom Loopback :<agreement name>. La My organization propriété est définie sur le partenaire, et la propriété de contrat 0A1 est définie sur l’accord 0A1 du répondeur du partenaire.

Voir aussi

Utilitaires
Didacticiel sur le bouclage

Partage via