Création de liens de rôle dans des orchestrations

Voici les tâches de base que vous devez effectuer pour utiliser des liens de rôle dans votre orchestration :

• Créez des tiers et des ports d'envoi et associez-les les uns aux autres.

• Utilisez la procédure suivante pour créer des types de lien de rôle et ajouter des types de port.

  Pour créer un type de lien de rôle

  1. Dans la fenêtre Vue d’orchestration, développez Types, cliquez avec le bouton droit sur Types de liens de rôle, puis cliquez sur Nouveau type de lien de rôle. 2. Cliquez sur le type de lien de rôle que vous venez de créer. Dans le Fenêtre Propriétés, dans le champ Identificateur, tapez Provider_Consumer_RoleLinkType. 3. Développez Provider_Consumer_RoleLinkType, puis cliquez sur Role_1. Dans le Fenêtre Propriétés, dans le champ Identificateur, tapez ConsumerRole. 4. Cliquez avec le bouton droit sur ConsumerRole, puis cliquez sur Ajouter un type de port. L'Assistant Type de port démarre. 5. Dans la page Bienvenue dans l’Assistant Type de port , cliquez sur Suivant. 6. Dans la page Sélectionner un type de port ou créer un type de port , sélectionnez Créer un type de port, puis pour Nom du type de port, tapez ConsumerPortType. 7. Pour Modèle de communication, sélectionnez Unidirectionnel et, pour Restrictions d’accès, sélectionnez Public - aucune limite. Cliquez sur Suivant. 8. Dans la page Fin de l’Assistant Port , cliquez sur Terminer. 9. Cliquez avec le bouton droit sur Provider_Consumer_RoleLinkType, puis cliquez sur Nouveau rôle. 10. Cliquez sur Role_1, puis dans le Fenêtre Propriétés, dans le champ Identificateur, tapez ProviderRole. 11. Cliquez avec le bouton droit sur ProviderRole, puis cliquez sur Ajouter un type de port. L'Assistant Type de port démarre. 12. Dans la page Bienvenue dans l’Assistant Type de port , cliquez sur Suivant. 13. Dans la page Sélectionner un type de port ou créer un type de port , sélectionnez Créer un type de port, puis pour Nom du type de port, tapez ProviderPortType. 14. Pour Modèle de communication, sélectionnez Unidirectionnel et, pour Restrictions d’accès, sélectionnez Public - aucune limite. Cliquez sur Suivant. 15. Dans la page Fin de l’Assistant Port , cliquez sur Terminer. Note: Les ports configurés placés à l’intérieur des liens de rôle ne conservent pas les informations de liaison associées.

  Dans la procédure précédente, vous créez un type de lien de rôle contenant deux rôles : un ProviderRole qui recevra et traitera les messages du consommateur et un ConsumerRole dont le port d'envoi sera utilisé par votre orchestration pour envoyer des messages au consommateur.

• Pour ajouter des liens de rôle à votre orchestration, suivez la procédure ci-dessous.

  Pour créer un lien de rôle à l'aide de l'Assistant Lien de rôle

  1. Dans la boîte à outils d’orchestration, faites glisser la forme Lien de rôle vers l’aire de conception. L'Assistant Lien de rôle démarre. 2. Dans la page Bienvenue dans l’Assistant Lien de rôle , cliquez sur Suivant. 3. Dans la page Nom du lien de rôle, dans le champ Nom , tapez Provider_Consumer. Cliquez sur Suivant. 4. Dans la page Type de lien de rôle, sélectionnez Utiliser un type de lien de rôle existant. Dans la liste déroulante Nom du type de lien de rôle, sélectionnez Provider_Consumer_RoleLinkType. Cliquez sur Suivant. 5. Dans la page Identification du rôle, sélectionnez ProviderRole dans la liste déroulante Quel rôle cette orchestration implémentera-t-elle pour recevoir et traiter les messages des partenaires ? L’Assistant sélectionne automatiquement Rôle consommateur pour Cette orchestration utilisera le rôle ci-dessous pour envoyer des messages aux partenaires sur les ports à l’intérieur du rôle. Cliquez sur Suivant. 6. Dans la page Utilisation du lien de rôle, sélectionnez Je vais envoyer le premier message au rôle de mon partenaire. Cliquez sur Terminer.

  Dans la procédure précédente, vous précisez la définition du ConsumerRole en tant que rôle initiateur. Cela signifie que votre orchestration enverra le premier message au consommateur via le port fourni par le ConsumerRole et que le ProviderRole recevra ensuite le message retourné par le consommateur pour traitement.

  Notes

  S’il n’existe qu’un seul rôle dans le type de lien de rôle, vous devez définir votre rôle dans le processus métier en sélectionnant Rôle fournisseur : je vais recevoir le premier message ou Rôle consommateur : j’enverrai le premier message au lieu d’effectuer l’étape 5 de la procédure précédente.

• Concevez votre processus d'entreprise. Vous pouvez tirer parti d'ensembles de corrélations pour vous assurer qu'un message entrant correspond à l'instance appropriée d'une orchestration.

• Associez les ports aux formes d’envoi et de réception . En outre, suivez les instructions suivantes :

  • Si le rôle initiateur est un consommateur pour l’envoi de messages, définissez explicitement la propriété DestinationParty (une fois et une seule fois) dans votre orchestration. Pour ce faire, définissez la valeur de DestinationParty dans la forme Expression , comme dans l’exemple suivant, où ConfirmOrder est le nom d’un lien de rôle, et PartnerName et OrganizationName sont des paramètres d’une partie :

    ConfirmOrder(Microsoft.XLANGs.BaseTypes.DestinationParty) = new Microsoft.XLANGs.BaseTypes.Party("PartnerName", "OrganizationName");
    

  • Si le rôle initiateur est un fournisseur de réception de messages, la propriété DestinationParty est initialisée automatiquement par le récepteur. DestinationParty est défini sur le fournisseur lui-même. La propriété SourceParty est en lecture seule et est fournie via un composant de pipeline approuvé pour résoudre le nom de la partie en fonction de l’identificateur de sécurité (SID) de l’expéditeur ou d’un certificat associé au tiers. L’hôte exécutant le composant de pipeline doit être marqué comme Authentification approuvée. Vous pouvez obtenir la valeur de SourceParty dans la forme Expression à l’aide de l’exemple de code suivant :

    PartyName = Buyer_Supplier(Microsoft.XLANGs.BaseTypes.SourceParty);
    

Exemples d'utilisation de liens de rôle

• PartyResolution (exemple BizTalk Server)

• Téléchargez l’exemple de SDK « Utilisation des liens de rôle » à partir des exemples de code BizTalk Server disponibles à l’adresse https://go.microsoft.com/fwlink/?LinkId=73703.

Voir aussi

Utilisation des liens de rôle dans les orchestrationsComment utiliser la forme de lien de rôleComment utiliser l’Assistant Lien de rôle