PartyResolution (exemple BizTalk Server)

L'exemple PartyResolution illustre l'utilisation des orchestrations BizTalk avec la résolution de tiers pour acheminer les messages vers l'un des deux destinataires possibles.

Fonctions de l'exemple

Cet exemple exécute plusieurs orchestrations qui illustrent les rôles suivants :

• orchestration de l'acheteur, qui permet de lancer le traitement des messages relatifs aux bons de commande ;

• orchestration du fournisseur, qui illustre la résolution de tiers entrants et sortants ;

• orchestrations ShipmentAgency1 et ShipmentAgency2, qui répondent à l'orchestration du fournisseur sur la base de l'adresse de livraison figurant sur le bon de commande.

Comment cet exemple est conçu et pourquoi

La résolution de tiers fait référence au processus qui consiste à déterminer l'expéditeur (tiers) d'un message. Par exemple, vous pouvez autoriser uniquement les tiers connus à envoyer un message. La résolution de tiers sortants est le processus qui consiste à déterminer les tiers destinataires d'un message.

Outre la résolution de tiers, cet exemple présente l'implémentation et l'utilisation des rôles. Par exemple, pour traiter la livraison d'un produit, vous créez un port d'envoi auquel vous envoyez un document demandant à un expéditeur de livrer le produit. Si vous avez le choix entre plusieurs expéditeurs, vous pouvez créer un rôle Expéditeur dans votre orchestration, plutôt que de créer plusieurs ports d'envoi dont la seule différence réside dans l'URL de l'expéditeur. Vous pouvez ensuite envoyer des messages relatifs à la livraison du produit au rôle Expéditeur. Vous créez des tiers, puis associez un port d'envoi à chaque tiers et certificat de tiers. Pour terminer, vous inscrivez chaque tiers au rôle Expéditeur pour l'activer. Dans l'orchestration, vous pouvez ensuite spécifier dynamiquement l'expéditeur auquel vous envoyez le message.

Cet exemple illustre également l'utilisation de la corrélation afin de faire correspondre le message entrant à l'instance d'orchestration adéquate.

• Les flux de processus d'entreprise pour l'acheteur, le fournisseur et les expéditeurs sont les suivants :

• Flux de processus d'entreprise de l'acheteur :

  1. Recevez le message de bon de commande envoyé par le service interne au format .xml.

  2. Envoyez le message de bon de commande au fournisseur.

• Flux de processus d'entreprise du fournisseur :

  1. Résolvez le tiers (résolution de tiers entrant) pour mettre à jour le tiers source sur la base d'un certificat de signature.

  2. Recevez un message d'activation (bon de commande) de l'acheteur.

  3. Envoyez un accusé de réception de bon de commande à l'acheteur.

  4. Vérifiez le pays ou la région de la livraison.

  5. Résolvez le tiers sortant pour rechercher l'agence d'expédition à utiliser. Aux États-Unis, l'agence d'expédition est ShipmentAgency2. Au Canada, l'agence d'expédition est ShipmentAgency1.

  6. Envoyez un message de demande d'ordre de livraison à l'agence d'expédition appropriée.

  7. Recevez l'accusé de réception d'ordre de livraison provenant de l'agence d'expédition appropriée.

  8. Envoyez un message d'avis d'expédition à l'agence d'expédition appropriée.

  9. Recevez un accusé de réception d'avis d'expédition provenant de l'agence d'expédition appropriée.

  10. Envoyez un message d'accusé de réception du bon de commande à l'acheteur.

• Flux de processus d'entreprise de l'agence d'expédition (identique pour les deux agences d'expédition) :

  1. Recevez un message de demande d'ordre de livraison provenant du fournisseur.

  2. Générez et envoyez un message d'accusé de réception du message de demande d'ordre de livraison.

  3. Recevez un message d'avis d'expédition du fournisseur.

  4. Générez et envoyez un message d'accusé de réception du message d'avis d'expédition.

  Les énoncés suivants décrivent la conception de cet exemple :

• L'orchestration BuyerProcess.odx reçoit un message et utilise le pipeline personnalisé MimePartyResSendPipeline pour l'encoder et l'envoyer au fournisseur. Cette opération est effectuée à l'aide du Concepteur de pipeline pour générer et déployer un pipeline d'envoi personnalisé. Avant d’envoyer le message au fournisseur, le message est signé numériquement avec la clé privée de l’acheteur, qui est spécifiée dans les propriétés du groupe BizTalk dans la console Administration BizTalk Server.

• L'orchestration SupplierProcess.odx utilise le pipeline personnalisé MimePartyResReceivePipeline, qui inclut le Composant Décodeur MIME/SMIME, pour décoder le message et procéder à une résolution de tiers entrant à l'aide de la clé publique de l'acheteur pour résoudre et valider l'identité de celui-ci. Cette opération est effectuée en générant et en déployant un pipeline de réception personnalisé.

• L'orchestration du fournisseur lance ensuite POCorrelationSets, qui se base sur la propriété promue PONo. Celle-ci permettra de faire correspondre les messages entrants et sortants avec cette instance d'orchestration ultérieurement, car plusieurs actions d'envoi et de réception transitent par l'orchestration entière.

• L'orchestration du fournisseur implémente les liens de rôle pour traiter la résolution des tiers entrants et sortants. Elle utilise deux types de liens de rôle :

  • Type de lien de rôle Buyer_Supplier

  • Type de lien de rôle Supplier_Shipment

• Dans la forme de lien de rôle Buyer_Supplier, le fournisseur est dans le rôle Fournisseur et l’acheteur est dans le rôle Consommateur, car le fournisseur reçoit le premier message de l’acheteur. Lorsque l'orchestration du fournisseur envoie l'accusé de réception au rôle de l'acheteur, un port d'envoi est associé à l'acheteur et le message est envoyé à celui-ci via le port d'envoi spécifié. Pour rechercher le port d’envoi, cliquez avec le bouton droit sur BuyerAgency dans la console d’administration BizTalk Server, puis cliquez sur Propriétés. Le port d’envoi s’affiche sous Ports d’envoi.

• L'orchestration utilise ensuite l'expression suivante pour renvoyer les informations du partenaire, puis génère un fichier XML dans un dossier via un appel à un assembly externe nommé CheckPartyName.

  Buyer_Supplier(Microsoft.XLANGs.BaseTypes.SourceParty)  
  

• Dans la forme de lien de rôle Supplier_Shipment, le rôle Expédition contient un port d’envoi avec deux opérations qui sont utilisées pour envoyer le message du fournisseur à l’agence d’expédition appropriée en fonction de la partie de destination. Le rôle Fournisseur inclut un port de réception contenant deux opérations permettant de recevoir la réponse de l'agence d'expédition. La corrélation, basée sur la propriété PONo, est utilisée lors de l'envoi et de la réception de ces messages.

  Notes

  Lorsque vous lierez l'orchestration du fournisseur, vous remarquerez que seul un port d'envoi et deux ports de réception doivent être liés. Ceci s'explique par le fait que les ports d'envoi vers les tiers de destination sont déjà liés aux tiers. De plus, l’un des ports de réception de l’orchestration contient deux opérations de réception. Par conséquent, même si vous voyez trois formes de réception , seules deux d’entre elles doivent être liées.

• L'orchestration du fournisseur utilise la première ligne du code suivant pour obtenir l'agence d'expédition en appelant un assembly externe nommé QueryShipmentCatalogComponent. Elle utilise ensuite la deuxième ligne pour définir le tiers de destination pour le rôle Livraison.

  strShipmentName= objQueryShipmentCatalog.GetShipmentDetails(POMessage.MessagePart_1.POHeader.Address.Country);  
  Supplier_Shipment(Microsoft.XLANGs.BaseTypes.DestinationParty) = new Microsoft.XLANGs.BaseTypes.Party(strShipmentName,"OrganizationName");  
  

• Shipper1Process.odx et Shipper2Process.odx sont générés pour recevoir le bordereau de livraison et l'avis d'expédition de SupplierProcess.odx, ainsi que pour renvoyer la réponse à SupplierProcess.odx. Dans les deux orchestrations d'expéditeur, la corrélation est utilisée et son type est basé sur la propriété promue PONo.

Accès à l'exemple

<Chemin d’accès> d’exemples\Orchestrations\PartyResolution\

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Génération et initialisation de cet exemple

Le composant de pipeline MIME n'est pas pris en charge dans une instance d'hôte 64 bits. L'hôte associé au gestionnaire d'envoi et de réception pour l'adaptateur de FILE doit être configuré en tant qu'hôte 32 bits uniquement. Pour plus d’informations à ce sujet, consultez Comment modifier les propriétés de l’hôte. Si vous disposez déjà d’un hôte 32 bits uniquement configuré sur le système et que vous souhaitez l’utiliser, consultez Configuration de l’adaptateur de fichier pour obtenir des instructions sur la configuration du ou des hôtes associés au gestionnaire d’envoi et de réception de l’adaptateur de fichier.

Le certificat mentionné dans cette section doit être ajouté au magasin personnel du compte de connexion configuré pour l'instance d'hôte BizTalk de type In-Process par défaut qui signera les messages.

Par défaut, le fichier setup.bat mentionné ci-dessous installe l’exemple Résolution de partie dans l’application BizTalk Server par défaut. Vous pouvez modifier le fichier setup.bat pour déployer l’exemple dans une nouvelle application BizTalk Server en ouvrant le fichier setup.bat et en remplaçant la section précédée de l’instruction @ECHO Deploy Assemblies... par ce qui suit :

@ECHO Deploy Assemblies...  

btstask AddApp -ApplicationName:PartyResolutionSample -Description:"Party Resolution Orchestration sample from the SDK"  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Schemas\bin\Release\Schemas.dll -Options:GacOnAdd  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Pipeline\projectschema\bin\Release\ProjectSchema.dll -Options:GacOnAdd   
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Buyer\bin\Release\Buyer.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%BuyerBindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:ShipmentAgency1\bin\Release\ShipmentAgency1.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%ShipmentAgency1BindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:ShipmentAgency2\bin\Release\ShipmentAgency2.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%ShipmentAgency2BindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Supplier\bin\Release\Supplier.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%SupplierBindingFileName%  

Pour créer et initialiser l'exemple PartyResolution

1. Dans une fenêtre de commande, accédez au dossier suivant :

   <Chemin d’accès> des exemples\Orchestrations\PartyResolution

2. Exécutez le fichier Setup.bat, qui effectue les actions suivantes :

   • Compile les projets Visual Studio pour cet exemple et déploie les assemblys résultants.

   • Crée et lie les ports d’envoi et de réception BizTalk Server.

     Au cours de l'installation, vous pouvez recevoir les avertissements suivants ou des avertissements similaires. Vous pouvez les ignorer en toute sécurité.

     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\PartyResolution.sln" (Buildtarget) (1) ->  
     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj" (default target) (5) ->  
     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj" (default target) (5:2) ->  
     (CompileODX target) ->  
       C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\SupplierProcess.odx(831,13): warning X4014: convoy processing will not occur -- check your protocol if you were expecting it [C:\ProgramFiles\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj]  
       C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\SupplierProcess.odx(841,13): warning X4014: convoy processing will not occur -- check your protocol if you were expecting it [C:\ProgramFiles\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj]  
     
     

3. Démarrez l’invite de commandes Visual Studio.

4. Tapez les commandes suivantes pour installer les assemblys dans le Global Assembly Cache :

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\Schemas\bin\Release\schemas.dll

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\Pipeline\projectschema\bin\Release\ProjectSchema.dll

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\Buyer\bin\Release\Buyer.dll

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\ShipmentAgency1\bin\Release\ShipmentAgency1.dll

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\ShipmentAgency2\bin\Release\ShipmentAgency2.dll

   • gacutil -i \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\Orchestrations\PartyResolution\Supplier\bin\Release\Supplier.dll

5. Obtenez un certificat de messagerie sécurisé auprès d'une autorité de certification (autorité tierce ou autorité de votre organisation). Une fois le certificat obtenu, exportez les clés publique et privée.

6. Pour importer la clé privée dans le magasin personnel du compte de connexion de l'instance d'hôte et la clé publique dans le magasin Autres personnes de l'ordinateur local, procédez comme suit :

   1. Dans BizTalk Server console d’administration, développez le groupe BizTalk, puis paramètres de la plateforme.

   2. Cliquez sur Instances d’hôte et recherchez le compte d’ouverture de session indiqué pour le instance hôte In-Process par défaut. Dans une installation par défaut, l'hôte de type In-Process par défaut doit être nommé BizTalkServerApplication.

   3. Cliquez sur Démarrer, puis sur Exécuter. Dans la zone Exécuter , tapez mmc.exe, puis cliquez sur OK. Entrez le mot de passe correct du compte de connexion de l'instance d'hôte pour ouvrir la console MMC (Microsoft Management Console) sous ce compte.

   4. Dans le menu Fichier , cliquez sur Ajouter/Supprimer un composant logiciel enfichable.

   5. Dans la boîte de dialogue Ajouter ou supprimer des composants logiciels enfichables , sélectionnez Certificats, puis cliquez sur Ajouter.

   6. Dans la boîte de dialogue Composant logiciel enfichable Certificats , sélectionnez Mon compte d’utilisateur, puis cliquez sur Terminer.

   7. Dans la boîte de dialogue Ajouter ou supprimer des composants logiciels enfichables , sélectionnez Certificats, puis cliquez sur Ajouter.

   8. Dans la boîte de dialogue Composant logiciel enfichable Certificats, sélectionnez Compte d'ordinateur, puis cliquez sur Suivant.

   9. Dans la boîte de dialogue Sélectionner un ordinateur , sélectionnez Ordinateur local, puis cliquez sur Terminer.

   10. Dans la boîte de dialogue Ajouter ou supprimer des composants logiciels enfichables , cliquez sur OK.

   11. Développez le nœud Certificats - Utilisateur actuel , puis Développez Personnel. Cliquez avec le bouton droit sur Certificats, cliquez sur Toutes les tâches, puis cliquez sur Importer.

   12. Importez la clé privée et indiquez un mot de passe dans l'Assistant.

   13. Développez le nœud Certificats (ordinateur local), puis développez Autres Personnes. Cliquez avec le bouton droit sur Certificats, cliquez sur Toutes les tâches, puis cliquez sur Importer.

   14. Importez la clé publique.

7. Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur le nœud Groupe BizTalk, puis cliquez sur Propriétés. Dans la boîte de dialogue Groupe BizTalk - Propriétés du groupe , sélectionnez Certificat.

8. Dans la boîte de dialogue Certificat , cliquez sur Parcourir et sélectionnez la clé privée que vous venez d’importer. Le certificat spécifié ici permet de signer le message sortant. Cliquez sur OK.

9. Pour mettre à jour le tiers BuyerAgency dans cet exemple, procédez comme suit :

   1. Dans la console Administration BizTalk Server, sélectionnez Parties.

   2. Cliquez avec le bouton droit sur BuyerAgency , puis cliquez sur Propriétés. Dans la boîte de dialogue BuyerAgency - Party Properties ,sélectionnez Général.

   3. Dans la section Alias de la boîte de dialogue, ajoutez un nouvel alias avec le nom et le qualificateur définis sur WindowsUser. Définissez la valeur sur un nom d’utilisateur <au format domaine\nom> d’utilisateur (par exemple, SOMEDOMAIN\someuser).

   4. Sélectionnez Certificat , puis cliquez sur Parcourir et sélectionnez la clé publique que vous venez d’importer. Le certificat spécifié ici permet de valider l'identité de l'expéditeur du message entrant. Cliquez sur OK.

10. Dans la console d’administration BizTalk Server, développez Paramètres de la plateforme, puis sélectionnez Hôtes.

11. Cliquez avec le bouton droit sur BizTalkServerApplication , puis cliquez sur Propriétés. Dans la boîte de dialogue BizTalkServerApplication - Propriétés de l’hôte , sélectionnez Certificats.

12. Cliquez sur Parcourir et sélectionnez la clé privée que vous venez d’importer. Le certificat spécifié ici permet de déchiffrer les messages entrants. Cliquez sur OK.

13. Dans la console d’administration BizTalk Server, développez Paramètres de la plateforme, puis sélectionnez Instances d’hôte.

14. Cliquez avec le bouton droit sur BizTalkServerApplication , puis cliquez sur Redémarrer.

Exécution de cet exemple

Pour exécuter l'exemple PartyResolution

1. Exécutez FilePolling.exe à partir du dossier suivant :

   <Chemin d’accès> d’exemples\Orchestrations\PartyResolution\FilePolling\bin\Debug

2. Cliquez sur Démarrer l’interrogation.

3. Collez une copie du fichier d'instance de bon de commande fourni, PurchaseOrder.xml, dans le dossier suivant :

   <Chemin d’accès> d’exemples\Orchestrations\PartyResolution\FileDrop\PurchaseOrder

4. Observez la séquence de messages fournis sous forme de MessageBoxes qui vous informent de la progression de l'exemple :

   1. Lorsque le fournisseur reçoit le bon de commande de l'acheteur.

   2. Lorsqu'une demande d'ordre de livraison est reçue de l'agence d'expédition 1 ou 2.

   3. Lorsqu'un avis d'expédition est reçu par l'agence d'expédition 1 ou 2.

   4. Lorsque le fournisseur envoie l'accusé de réception du bon de commande à l'acheteur.

5. Cliquez sur Quitter pour fermer le programme d’interrogation de fichiers.

Désinstallation de l'exemple

Pour désinstaller l'exemple PartyResolution

1. À une invite de commandes Visual Studio, remplacez répertoire (cd) par <Samples Path>\Orchestrations\ PartyResolution\.

2. Exécutez Cleanup.bat.

Voir aussi

Composant de pipeline Résolution du tiers
Configuration du composant de pipeline Encodeur MIME/SMIME
Guide pratique pour configurer le composant de pipeline de décodeur MIME-SMIME
Orchestrations (dossier d’exemples BizTalk Server)