Étape 2 : configurer un port d’envoi WCF-WebHttp bidirectionnel
Au cours de cette étape, vous configurez un port d’envoi WCF-WebHttp bidirectionnel pour appeler l’URL de ressource REST afin de récupérer les retards dans les horaires des transporteurs aériens américains.
Pour configurer le port d’envoi WCF-WebHttp
À partir de BizTalk Server console d’administration, sous le nœud Application 1 BizTalk, cliquez avec le bouton droit sur Ports d’envoi, pointez sur Nouveau, puis cliquez sur Port d’envoi Solicit-Response statique.
Sous l’onglet Général, effectuez les actions suivantes :
Propriété Pour Nom Tapez SendPortRESTAzureMarketPlace. Type Sélectionnez WCF-WebHttp. Gestionnaire d’envoi Sélectionnez BizTalkServerApplication. Pipeline d’envoi Sélectionnez PassThruTransmit. Pipeline de réception Sélectionnez PassThruReceive. Cliquez sur Configurer.
Dans la boîte de dialogue Propriétés de transport WCF-WebHttp , procédez comme suit :
Sous l’onglet Général , pour Adresse (URI), entrez
https://api.datamarket.azure.com/oakleaf/US_Air_Carrier_Flight_Delays_Incr/
.Sous l’onglet Général, pour Mappage de méthode et d’URL HTTP, entrez les éléments suivants :
<BtsHttpUrlMapping> <Operation Method="GET" Url="/On_Time_Performance" /> </BtsHttpUrlMapping>
Ici, GET est le verbe HTTP et On_Time_Performance est ajouté à l’URI de base pour construire une URL de ressource unique pour récupérer les retards de vol.
Conseil
Dans le champ URL, tous les caractères XML spéciaux doivent être « placés dans une séquence d’échappement ». Cela garantit que les caractères XML spéciaux sont traités et conservés par le port. Par exemple, le
&
caractère spécial doit être placé dans une séquence d’échappement en tant que&
.de :
Url=”/Customer?{ID}& group=Location”
À :
Url=”/Customer?{ID}&group=Location”
Sous l’onglet Liaisons , pour le champ Taille maximale des messages reçus , sélectionnez une valeur suffisamment grande. car généralement, le message de réponse contenant les informations sur le vol est relativement volumineux et risque de dépasser la taille des messages spécifiée par défaut.
Dans l’onglet Sécurité, procédez comme suit :
Pour le mode sécurité, sélectionnez Transport.
Pour Type d’informations d’identification du client de transport, sélectionnez De base.
Dans la zone Informations d’identification du nom d’utilisateur , sélectionnez Modifier.
Dans la zone Informations d’identification du client , sélectionnez Ne pas utiliser Single-Sign Activé.
Entrez le nom d’utilisateur et le mot de passe que vous avez récupérés sous l’onglet Mon compte après vous être connecté à Microsoft Place de marché Azure.
Les informations d’identification sont répertoriées par rapport aux étiquettes ID client (nom d’utilisateur) et Clé de compte principal (mot de passe).
Sélectionnez OK.
Sous l’onglet Messages , pour Supprimer le corps pour les verbes, spécifiez le verbe pour lequel vous souhaitez supprimer la charge utile du message de la demande. Pour ce didacticiel, spécifiez ce sous la forme
GET
. Voici pourquoi : un appel de méthode GET sur le point de terminaison REST des retards de vol du transporteur aérien américain ne nécessite pas de charge utile de message ; l’URL de la ressource REST est suffisante pour récupérer les informations. Toutefois, pour déclencher le port d’envoi WCF-WebHttp qui effectue l’appel REST, vous supprimez un message factice qui a un corps de message. Le port d’envoi ne doit pas envoyer ce message factice au point de terminaison REST, car, comme expliqué plus haut, le point de terminaison n’attend pas de charge de message. Par conséquent, avant d’appeler le point de terminaison REST, l’adaptateur supprime la charge utile du message factice uniquement pour les verbes que vous spécifiez dans la zone de texte Supprimer le corps pour les verbes .Cliquez sur OK jusqu’à ce que vous reveniez dans la boîte de dialogue Propriétés du port d’envoi. Dans le volet gauche, cliquez sur Filtres, puis spécifiez le filtre pour utiliser tous les messages reçus via le port de réception que vous avez créé à l’étape 1 : Configurer un emplacement de réception FILE.
Paramètre Valeur Propriété Défini sur BTS. ReceivePortName Opérateur Paramètre à définir sur == Valeur Paramètre à définir sur ReceivePortRestAzureMarketPlace
Cliquez sur OK.
Voir aussi
Tutoriel 5 : Appel d’une interface REST à l’aide de BizTalk Server