Publier des schémas en tant que service web dans BizTalk
Vous utilisez l'Assistant Publication de services Web BizTalk pour publier des schémas en tant que services Web.
Publier des schémas en tant que service web
Dans Programmes, sélectionnez BizTalk Server, puis Sélectionnez Assistant Publication des services web BizTalk.
Important
Vous devez créer des projets BizTalk avant d'exécuter l'Assistant Publication de services Web BizTalk.
Sur la page d’accueil, cliquez sur Suivant.
Dans la page Créer un service web , sélectionnez Publier des schémas en tant que services web , puis cliquez sur Suivant.
Dans la page Service web , définissez le ou les services Web à publier. Vous utilisez l’arborescence de la boîte de dialogue Description du service Web pour ajouter, supprimer, renommer et modifier les nœuds de description du service Web. La boîte de dialogue Informations fournit des informations sur le nœud sélectionné et affiche les erreurs éventuelles dans le nœud actuel ou les sous-nœuds :
Le nœud racine de l'arborescence (Description du service Web) décrit le nom de projet de service Web. Le nom du répertoire virtuel utilise le nœud racine comme nom par défaut. Vous pouvez modifier la description du service Web en sélectionnant Renommer la description du service web.
Pour ajouter un nouveau service Web, cliquez avec le bouton droit sur le nœud Description du service Web , puis cliquez sur Ajouter un service web. Cela crée un service Web sans méthode Web. Pour modifier le nom du service Web, cliquez avec le bouton droit sur le nœud du service Web, sélectionnez Renommer le service web, puis appuyez sur Entrée pour accepter le nouveau nom.
Pour ajouter une nouvelle méthode Web, cliquez avec le bouton droit sur le nœud du service Web, pointez sur Ajouter une méthode web, puis cliquez sur Unidirectionnel (pour une méthode Web de demande) ou Requête-réponse (pour une méthode Web requête-réponse) dans le menu contextuel.
Pour définir les types de schéma de demande et de réponse, cliquez avec le bouton droit sur le nœud Requête ou Réponse , puis cliquez sur Sélectionner le type de schéma. Dans la boîte de dialogue Type de message de demande, tapez le nom de l’assembly contenant le schéma de document dans la zone de texte Fichier d’assembly BizTalk ou cliquez sur Parcourir pour rechercher l’assembly. L’affichage de liste Types de schémas disponibles affiche chaque élément racine du schéma. Sélectionnez un nœud racine à ajouter en tant que type du schéma de requête ou de réponse.
Notes
Si vous avez installé le fichier d’assembly BizTalk dans le Global Assembly Cache (GAC), assurez-vous que l’assembly dans le GAC a été mis à jour avec l’assembly que vous sélectionnerez dans la boîte de dialogue Type de message de demande. Toutefois, si le GAC possède le même nom complet, l'Assistant Publication de services Web BizTalk utilise le fichier de l'assembly du GAC plutôt que celui sélectionné par vos soins.
Vous pouvez renommer les nœuds requête et réponse sans affecter le code généré. Après avoir défini vos schémas, vous pouvez renommer les éléments part, ce qui modifie le nom du paramètre de la méthode Web. Vous pouvez voir les modifications en affichant le code du service Web généré.
Notes
Vous ne pouvez pas utiliser d'espaces lors du changement de nom d'un nœud de description de service Web.
Cliquez sur Suivant pour continuer l’Assistant.
Dans la page Propriétés du service web , dans la boîte de dialogue Espace de noms cible du service web , tapez un espace de noms cible pour le service Web, puis sélectionnez les zones appropriées pour spécifier la façon dont l’Assistant doit gérer les en-têtes SOAP et la prise en charge des Sign-On uniques pour le service Web. Si vous souhaitez personnaliser davantage l’implémentation du service Web, cliquez sur le bouton Avancé . Il affiche plus d'options disponibles :
Option Valeur Description Style de paramètre SOAP Default Cette option spécifie la façon dont les paramètres sont formatés dans un message SOAP. Pour plus d’informations, consultez SoapParameterStyle, énumération à l’adresse https://go.microsoft.com/fwlink/?LinkId=62259. Style de paramètre SOAP Bare Cette option spécifie la façon dont les paramètres sont formatés dans un message SOAP. Pour plus d’informations, consultez SoapParameterStyle, énumération à l’adresse https://go.microsoft.com/fwlink/?LinkId=62259. Style de paramètre SOAP Wrapped Cette option spécifie la façon dont les paramètres sont formatés dans un message SOAP. Pour plus d’informations, consultez SoapParameterStyle, énumération à l’adresse https://go.microsoft.com/fwlink/?LinkId=62259. Demandes de conformité None Cette option indique la spécification d'interopérabilité des services Web (WSI) à laquelle les demandes de liaison doivent se conformer. Pour plus d’informations, consultez WebServiceBindingAttribute.ConformsTo, propriété à l’adresse https://go.microsoft.com/fwlink/?LinkId=193064. Demandes de conformité WS-I Basic Profile 1.1 Cette option indique la spécification d'interopérabilité des services Web (WSI) à laquelle les demandes de liaison doivent se conformer. Pour plus d’informations, consultez WebServiceBindingAttribute.ConformsTo, propriété à l’adresse https://go.microsoft.com/fwlink/?LinkId=193064. Forcer requête-réponse [Par défaut] Cette option indique si des opérations BizTalk unidirectionnelles doivent être exposées en tant que méthodes Web de requête-réponse. La valeur par défaut n’est pas forcer l’indicateur unidirectionnel. Notes
Les options de sélection d'un en-tête SOAP sont appliquées globalement à tous les services Web et méthodes Web créés lors de l'exécution de cette instance de l'Assistant.
Dans la page Propriétés du service web , cliquez sur Suivant.
Si vous avez sélectionné Ajouter des en-têtes SOAP supplémentaires, les pages Demander des en-têtes SOAP et En-têtes SOAP de réponse s’affichent. Vous pouvez ajouter et supprimer des en-têtes SOAP de demande et de réponse à l’aide des boutons Ajouter et Supprimer dans les boîtes de dialogue suivantes :
Pour ajouter un en-tête SOAP, cliquez sur Ajouter. Dans la zone de texte Nom de l’assembly BizTalk (*.dll), tapez le nom de l’assembly ou recherchez l’assembly contenant le schéma d’en-tête SOAP dans la zone de texte Fichier d’assembly BizTalk . L’affichage de liste Types de schémas disponibles affiche chaque élément racine du schéma. Sélectionnez un nœud racine à ajouter comme en-tête SOAP de requête ou de réponse. Pour sélectionner plusieurs éléments, maintenez la touche Ctrl enfoncée et cliquez sur OK.
Pour supprimer un en-tête SOAP de la liste, sélectionnez-le dans la liste des en-têtes SOAP ajoutés, puis cliquez sur Supprimer.
Cliquez sur Suivant sur chaque page d’en-tête SOAP pour continuer l’Assistant.
Notes
L'espace de noms cible et le nom de l'élément racine définissent l'en-tête SOAP.
Notes
Si la même combinaison espace de noms cible / nom de l'élément racine est ajoutée en tant qu'en-tête SOAP de requête et de réponse, il ne sera pas traité en tant qu'en-tête d'entrée/sortie. Vous devez copier manuellement l'en-tête entrant dans l'en-tête sortant à l'intérieur d'une orchestration.
Notes
La même combinaison espace de noms cible / nom de l'élément racine ne peut être ajoutée qu'une seule fois en tant qu'en-tête SOAP de requête et qu'une seule fois en tant qu'en-tête SOAP de réponse.
Dans la page Projet de service web , dans la zone de texte Emplacement du projet, tapez l’emplacement du projet. Vous pouvez accepter l’emplacement par défaut (
http://localhost/your_project_name), taper un emplacement pour le projet ou cliquer sur Parcourir et sélectionner un répertoire Web. Sélectionnez l’une des options suivantes :Remplacer le projet existant : cette option n'est disponible que si l'emplacement du projet existe déjà. Vous ne pourrez publier dans le même emplacement que si vous sélectionnez cette option. Sinon, vous devez indiquer un emplacement de projet différent.
Autoriser l'accès anonyme au service Web : Cette option permet d'ajouter un accès anonyme au répertoire virtuel créé. Par défaut, celui-ci hérite des privilèges d'accès de son répertoire virtuel parent ou du site Web (s'il s'agit d'un répertoire virtuel de niveau supérieur).
Créer des emplacements de réception BizTalk : cette option crée automatiquement les ports et emplacements de réception de l'adaptateur SOAP qui correspondent à chaque fichier .asmx généré. Si un autre emplacement de réception existe déjà, l'emplacement de réception n'est pas remplacé. Les emplacements de réception de l’adaptateur SOAP sont résolus au format « /<nom >de répertoire virtuel/<orchestration namespace_typename_portname.asmx >». Après avoir sélectionné cette option, choisissez l'application où les ports et emplacements de réception sont générés.
Notes
L'emplacement du projet peut se trouver sur un serveur différent. Pour publier un service Web sur un autre serveur, tapez le nom du projet sous la forme
http://<servername>/<project_name>.Notes
L'emplacement du projet peut se trouver sur un site Web personnalisé. Lors de la publication sur un site Web autre que celui par défaut, incluez le numéro de port du site Web dans l’URL :
http://localhost:8080/<project_name>.Notes
Lors de l'utilisation de l'Assistant pour créer des emplacements de réception, celui-ci crée des emplacements de réception à l'aide de nombreuses valeurs par défaut. Les valeurs par défaut pour les pipelines de réception et d’envoi sont Microsoft.BizTalk.DefaultPipelines.PassThruReceive et Microsoft.BizTalk.DefaultPipelines.PassThruTransmit. Si les messages reçus via le service Web publié nécessitent un traitement de pipeline spécial (par exemple, validation, corrélation ou mappages entrants/sortants), vous devez définir les pipelines d’envoi et de réception sur Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines.XMLSend ou sur un pipeline personnalisé.
Cliquez sur Suivant pour passer en revue vos paramètres pour le projet de service Web ASP.NET.
Cliquez sur Créer pour créer le service Web ASP.NET.
Cliquez sur Terminer pour terminer l’Assistant Publication des services web BizTalk.