Utilisation des tableaux de service Web
BizTalk Server permet d’utiliser des tableaux exposés dans les services Web à partir d’une orchestration BizTalk.
Pour configurer une orchestration pour utiliser un tableau exposé dans un service Web :
Déterminez l'URL du service Web qui expose des tableaux. Il s'agit généralement d'une page Web asmx qui répertorie les opérations prises en charge par le service Web. Par exemple : http://localhost/ArrayWS/ArraySvc.asmx.
Ajoutez une référence Web à cette URL dans le projet Visual Studio qui contient votre orchestration :
Dans le Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence de service.
Dans la boîte de dialogue Ajouter une référence de service , cliquez sur Avancé.
Dans la boîte de dialogue Paramètres de référence du service , cliquez sur Ajouter une référence web dans la section Compatibilité .
Dans la boîte de dialogue Ajouter une référence web , entrez l’URL du service Web dans la zone de texte URL , puis cliquez sur Accéder.
Entrez un nom pour la référence web dans la zone de texte Nom de référence web , puis cliquez sur le bouton Ajouter une référence .
La référence web s’affiche sous Références web dans le Explorateur de solutions.
Conseil
Une fois que vous avez ajouté une référence web au projet, la commande Ajouter une référence web est directement disponible lorsque vous cliquez avec le bouton droit sur le nom du projet ou référencesweb.
Ajoutez un port web à votre orchestration :
Faites glisser une forme de port de la boîte à outils vers l’une des surfaces de port dans le Designer d’orchestration pour lancer l’Assistant Configuration du port. Cliquez sur le bouton Suivant de l’Assistant Configuration du port pour afficher la boîte de dialogue Propriétés du port .
Entrez une valeur dans la zone de texte Nom pour identifier le port, puis cliquez sur le bouton Suivant pour afficher la boîte de dialogue Sélectionner un type de port .
Sélectionnez l’option Utiliser un type de port existant, sélectionnez le type de port web qui correspond à la référence web que vous avez ajoutée, puis cliquez sur le bouton Suivant pour afficher la boîte de dialogue Liaison de port .
Dans la boîte de dialogue Liaison de port, sélectionnez l’option de liaison de port appropriée, puis cliquez sur le bouton Suivant , puis sur le bouton Terminer . Vous devez maintenant avoir un port Web affiché dans le Designer Orchestration qui inclut les opérations prises en charge par le service Web.
Ajoutez des formes d’envoi et de réception à votre orchestration selon les besoins :
Faites glisser une forme d’envoi de la boîte à outils vers une ligne de connexion dans la surface d’orchestration Designer pour configurer l’orchestration afin d’envoyer un message de demande au port web. Si vous connectez la forme Envoyer à l’un des connecteurs de message de demande de port web, BizTalk crée automatiquement un message du type approprié à utiliser lors de l’envoi d’un message de demande à ce port.
Faites glisser une forme de réception de la boîte à outils vers une ligne de connexion dans la surface d’orchestration Designer pour configurer l’orchestration afin de recevoir un message de réponse à partir du port web. Si vous connectez la forme De réception à l’un des connecteurs de message de réponse de port web, BizTalk crée automatiquement un message du type approprié à utiliser lors de la réception d’un message de réponse à partir de ce port.
Notes
L'adaptateur SOAP permet d'envoyer des messages à un service Web ou d'en recevoir d'un service Web. Pour plus d’informations sur la configuration de l’adaptateur SOAP, consultez Configuration de l’adaptateur SOAP.
Le moteur d’orchestration BizTalk Server prend en charge la consommation de tableaux unidimensionnels et déchiquetés qui sont exposés par les services Web. Si vous ajoutez une référence Web à un service Web qui expose des tableaux, le Concepteur d'orchestration génère un type de message Web qui décrit le tableau. Vous pouvez alors envoyer et recevoir des messages de ce type comme n'importe quel autre message. BizTalk Server ne limite pas l'envoi de messages Web contenant des tableaux aux seuls ports Web.
Pour obtenir un exemple de consommation de tableaux de services Web, consultez l’exemple sdk « Consommer des services web » et « Consommer des services web avec des paramètres de tableau » sur https://go.microsoft.com/fwlink/?LinkId=73703.