Configuration de la forme Appeler orchestration
La forme Orchestration des appels peut être utilisée pour appeler de manière synchrone une orchestration référencée dans un autre projet. Cela permet de réutiliser les modèles de workflow d'orchestration communs sur les divers projets BizTalk. Lorsque vous appelez une autre orchestration imbriquée de manière synchrone avec la forme d’orchestration des appels , l’orchestration englobante attend que l’orchestration imbriquée se termine avant de continuer.
Vous pouvez spécifier les paramètres qui seront transmis à l'orchestration imbriquée. Les paramètres incluent les messages, variables, références de port, liens de rôle ou ensembles de corrélations. Les références de port transmis, les liens de rôle et les jeux de corrélation fonctionnent tous comme des enveloppes auto-adressées : ils fournissent les informations d’orchestration imbriquées qu’ils peuvent utiliser pour renvoyer des informations à l’orchestration englobante.
Attention
Si vous transmettez des objets non sérialisables tels que XmlDocument ou XmlNode comme paramètres à une orchestration, elle échoue.
Pour obtenir un exemple d’utilisation de la forme d’orchestration des appels, consultez CallOrchestration (BizTalk Server Sample) .
Pour configurer une forme Appeler orchestration
À l’aide de la zone de liste déroulante Sélection de l’orchestration, sélectionnez une orchestration dans la liste.
À l’aide du contrôle de grille Paramètres d’orchestration , spécifiez les arguments à passer à l’orchestration, comme spécifié dans la zone de liste déroulante Sélection de l’orchestration, appelée. Pour indiquer ces arguments dans les cellules de la colonne Variable (une variable par cellule), entrez le nom d'une variable ou cliquez sur celle-ci dans la liste déroulante d'une cellule.
Pour configurer la forme Orchestration des appels en fonction du service et des arguments que vous avez spécifiés dans la boîte de dialogue, cliquez sur OK. Pour fermer la boîte de dialogue Configuration de l’orchestration des appels sans apporter de modifications à la forme Orchestration des appels, cliquez sur Annuler.
Attention
BizTalk Server ne prend pas en charge les orchestrations récursives. Si l'orchestration A appelle ou démarre l'orchestration B, cette dernière ne peut pas appeler ou démarrer directement l'orchestration A, de même que les orchestrations qui appellent directement ou indirectement l'orchestration A.
Orchestrations référencées
Pour que l'orchestration référencée puisse être appelée, assurez-vous que les propriétés suivantes ont été configurées pour l'orchestration appelée :
Définissez la propriété Modificateur de type sur Public pour l’orchestration appelée. Pour définir la propriété Modifier de type pour une orchestration sur Public, ouvrez l’orchestration dans Microsoft Visual Studio, cliquez sur la forme de début verte en haut de l’orchestration pour afficher la boîte de dialogue Propriétés de l’orchestration et définissez la propriété Modifier le type sur Public.
Définissez la propriété Activate de la forme de réception initiale dans l’orchestration sur False.
Zone de liste déroulante de sélection de l'orchestration
Cliquez sur la flèche pointant vers le bas dans la liste déroulante pour afficher les services disponibles et sélectionnez celui de votre choix. Cette liste contient tous les services qui peuvent être appelés à partir de l'orchestration en cours, y compris les assemblys référencés.
Contrôle de grille Paramètres de l'orchestration
Vous spécifiez les arguments à passer à une orchestration paramétrée à l’aide du contrôle grille Paramètres d’orchestration . La grille comporte quatre colonnes : Variables dans Étendue, Nom du paramètre, Type de paramètre et Direction du paramètre. Seule la première colonne est modifiable, les autres étant en lecture seule.
Lorsque vous sélectionnez une orchestration valide, ses paramètres remplissent le nom du paramètre, le type et les colonnes de direction du contrôle grille. Vous pouvez sélectionner les variables dans chaque ligne pour les transmettre en tant qu'arguments. Ces variables sont accessibles dans la liste déroulante de chaque cellule dans la colonne Variables de l'étendue. Cette liste affiche toutes les variables disponibles pour le type spécifié dans la cellule adjacente Type de paramètre. Si un seul objet de ce type est disponible, la cellule Variables de l'étendue est automatiquement complétée avec celui-ci. Vous pouvez également sélectionner une variable dans la liste déroulante d'une cellule Variables de l'étendue.
Notes
Étant donné qu’une forme d’orchestration d’appel appelle une orchestration, les « paramètres d’orchestration » que vous sélectionnez dans cette boîte de dialogue font en fait référence aux variables d’orchestration.
Si l'orchestration que vous appelez n'a pas de paramètres définis, le contrôle de grille de cette boîte de dialogue n'est pas disponible.