Configuration dynamique de l'URI d'un service Web utilisé
Lorsque vous créez un port Web pour le service Web utilisé, vous pouvez sélectionner une liaison de port dynamique. Lorsque vous sélectionnez une liaison de port dynamique, vous devez définir l'URI du service Web utilisé au moment de l'exécution. L'URI sélectionnée doit appeler un service Web doté du même proxy Web que le service Web utilisé pour créer le type de port Web.
Notes
Cette rubrique décrit la configuration par programme des propriétés d'un port d'envoi SOAP dynamique dans une orchestration. Cependant, vous pouvez également définir ces propriétés dans une orchestration ou un composant de pipeline personnalisé, que le port d'envoi soit statique ou dynamique. Pour plus d’informations sur les composants de pipeline personnalisés, consultez Développement de composants de pipeline personnalisés.
Le comportement des liaisons de port dynamiques pour les ports Web est différent de celui des liaisons de ports non-Web. Lors de la sélection des liaisons dynamiques pour un port non-Web, vous ne pouvez pas utiliser l'adaptateur SOAP.
Lors de l'utilisation des ports Web dynamiques pour utiliser un service Web, les propriétés du port d'envoi sont définies sur les valeurs par défaut. Certaines de ces valeurs sont définies en interne et d’autres valeurs sont définies par défaut sur les valeurs définies dans les pages de propriétés du gestionnaire d’adaptateur SOAP . Vous pouvez remplacer ces valeurs dans une orchestration lorsque vous utilisez les ports d'envoi dynamiques. Pour plus d’informations, consultez Considérations relatives à l’utilisation des services web.
Modifier dynamiquement l’URI d’un service Web consommé
Ajoutez un port web comme indiqué dans Comment ajouter un port web. Toutefois, au lieu de sélectionner la liaison de port Spécifier maintenant , sélectionnez Liaison de port dynamique, comme illustré dans la figure suivante.
Dans l’orchestration qui appelle le service Web consommé, ajoutez une forme Expression à un moment donné avant la forme d’envoi que vous avez connectée au port Web.
Dans la forme Expression , ajoutez une expression similaire à :
myWebPort(Microsoft.XLANGs.BaseTypes.Address) = "http://orders/myCompany.asmx";
Notes
Vous pouvez récupérer l'URI utilisée dans l'Éditeur d'expression BizTalk à partir de divers emplacements, notamment le message entrant, une base de données SQL ou une application sectorielle.
Modifier dynamiquement les propriétés du port d’envoi
Dans la forme Construire un message que vous utilisez pour construire le message Web, ajoutez une forme d’affectation de message si elle n’en est pas déjà présente.
Dans la forme Affectation de message, ajoutez une expression similaire à :
myWebMessage(SOAP.UseSSO) = true;Toutes les propriétés du port d'envoi SOAP utilisent l'espace de noms SOAP.
Le tableau suivant contient une liste des propriétés du port d'envoi SOAP que vous pouvez configurer lors de l'utilisation des ports Web dynamiques.
| Nom de la propriété | Type | Description |
|---|---|---|
| AuthenticationScheme | String | Méthode d'authentification à utiliser pour l'appel du service Web Valeur par défaut : Anonyme Autres valeurs autorisées : De base, Digest, NTLM |
| Nom d’utilisateur | String | Nom d'utilisateur à spécifier pour accéder au service Web cible. Valeur par défaut : vide |
| Mot de passe | String | Mot de passe de l'utilisateur utilisé pour l'authentification sur le serveur. Valeur par défaut : vide |
| ClientCertificate | String | Empreinte du certificat SSL (Secure Sockets Layer) client Valeur par défaut : vide |
| UseSSO | Boolean | Indique si ce port Web utilisera l'authentification unique (SSO). Valeur par défaut : False |
| AffiliateApplicationName | String | Nom de l'application SSO que ce port Web va utiliser pour échanger le ticket et récupérer les informations d'identification du client. Valeur par défaut : vide |
| UseHandlerSetting | Boolean | Indique si ce port Web va utiliser les paramètres du proxy HTTP du Gestionnaire d'envoi SOAP. Note: Si la propriété de contexte UseProxy est définie, la propriété de contexte UseHandlerSetting est ignorée. Valeur par défaut : False |
| UseProxy | Boolean | Indique si ce port Web va utiliser un serveur proxy pour accéder au service Web cible. Note: Si la propriété de contexte UseProxy est définie, la propriété de contexte UseHandlerSetting est ignorée. Valeur par défaut : False |
| ProxyAddress | String | Adresse du proxy HTTP à utiliser pour l'appel de service Web. Valeur par défaut : récupérée à partir des propriétés du gestionnaire d’envoi SOAP. |
| ProxyPort | Integer | Port du proxy HTTP à utiliser pour l'appel de service Web. Valeur par défaut : récupérée à partir des propriétés du gestionnaire d’envoi SOAP. |
| ProxyUsername | String | Nom d'utilisateur à utiliser pour le proxy HTTP. Valeur par défaut : récupérée à partir des propriétés du gestionnaire d’envoi SOAP. |
| ProxyPassword | String | Mot de passe à utiliser pour le proxy HTTP. Valeur par défaut : récupérée à partir des propriétés du gestionnaire d’envoi SOAP. |
| ClientConnectionTimeout | Int32 | Valeur d'expiration de la connexion du client HTTP. Valeur par défaut : identique à la valeur par défaut ASP.NET délai d’expiration de la connexion HTTP. |
| TypeName | String | Indiquez le nom de la classe contenant la méthode Web à appeler. Valeur par défaut : vide |
| MethodName | String | Indiquez la méthode de la classe contenant la méthode Web qui sera appelée. Note: Pour configurer la propriété MethodName pour le port d’envoi SOAP statique par programme, vous devez définir nom de la méthode sur [Spécifier plus tard] sous l’onglet Service web de la boîte de dialogue Propriétés de transport SOAP dans BizTalk Server console Administration. Pour plus d’informations sur la boîte de dialogue Propriétés du transport SOAP , consultez la boîte de dialogue Propriétés du transport SOAP, onglet Service web dans les conseils d’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. Valeur par défaut : vide |
| Assemblyname | String | Identifie le type .NET et l'assembly qui doivent être chargés et exécutés. Valeur par défaut : vide |
| UnknownHeaders | String | Indique la liste sérialisée des en-têtes SOAP inconnus. Valeur par défaut : vide |
| UserDefined | String | Spécifie les classes définies par l'utilisateur Valeur par défaut : vide |
| UseSoap12 | Boolean | Indiquez qu'il faut générer un code proxy qui prendra en charge le protocole SOAP 1.2. Si cette propriété est définie sur False, le code proxy compatible SOAP 1.1 sera généré. Valeur par défaut : False |
Notes
À l’exception du paramètre ClientConnectionTimeout , ces valeurs ne peuvent être définies dynamiquement que lors de l’utilisation de liaisons de port dynamiques . Ils sont en lecture seule lors de l’utilisation de la liaison de port Spécifier maintenant . Vous pouvez définir le paramètre ClientConnectionTimeout avec des liaisons de port spécifier maintenant et de port dynamique .
Voir aussi
En-têtes SOAP avec les services web utilisés
Création de ports web