Comment utiliser l’Assistant Publication des services web BizTalk pour publier une orchestration en tant que service web

L'Assistant Publication de services Web BizTalk permet de publier une orchestration en tant que service Web.

Pour publier une orchestration en tant que service Web

1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft BizTalk Server, puis cliquez sur Assistant Publication des services web BizTalk.

2. Dans la page Bienvenue dans l’Assistant Publication des services web BizTalk , cliquez sur Suivant.

3. Dans la page Créer un service web , sélectionnez Publier des orchestrations BizTalk en tant que services web, puis cliquez sur Suivant.

4. Dans la page Assembly BizTalk , dans la zone de texte Fichier d’assembly BizTalk (*.dll), tapez le nom du fichier d’assembly BizTalk ou cliquez sur Parcourir pour accéder à l’assembly contenant la ou les orchestrations à publier, puis cliquez sur Suivant.

   Notes

   Avant de sélectionner le fichier de l'assembly BizTalk, copiez tous les assemblys dépendants dans le dossier contenant l'assembly BizTalk ou installez ceux-ci dans le Global Assembly Cache (GAC).

   Notes

   Si vous avez installé le fichier d’assembly BizTalk dans le GAC, assurez-vous que l’assembly dans le GAC a été mis à jour avec l’assembly que vous allez sélectionner dans la boîte de dialogue Assembly BizTalk . 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.

   Notes

   Si vous ouvrez l'Assistant Publication de services Web BizTalk dans Visual Studio contenant une orchestration, le fichier de l'assembly BizTalk est renseigné avec l'assembly contenant l'orchestration.

   Notes

   Les chemins d’accès de plus de 260 caractères peuvent recevoir un message d’erreur indiquant que le chemin est trop long.

5. Dans la page Orchestrations et ports , développez les nœuds d’arborescence pour chaque assembly et orchestration en cliquant sur le signe plus. Sélectionnez les ports et orchestrations à publier en activant les cases à cocher correspondantes dans les nœuds de l'arborescence. Si vous souhaitez créer un service Web (.asmx) pour tous les ports de réception sélectionnés au lieu d’un service Web pour chaque port de réception, sélectionnez l’option Fusionner tous les ports sélectionnés en un seul service web , puis cliquez sur Suivant.

   Notes

   Lorsque vous fusionnez tous les ports sélectionnés en un seul service Web, ceux-ci disposent du même type de port, mais les noms des opérations demeurent uniques.

6. Dans la page Propriétés du service web, dans la zone 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 SharePoint Portal Server prise en charge de l'Sign-On authentification unique (SSO) 2007 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 Propriété WebServiceBindingAttribute.ConformsTo à 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 Propriété WebServiceBindingAttribute.ConformsTo à 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 est de ne pas forcer l'indicateur unidirectionnel.
   Forcer requête-réponse	No	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 est de ne pas forcer l'indicateur unidirectionnel.
   Forcer requête-réponse	Yes	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 est de ne pas forcer l'indicateur unidirectionnel.

7. Dans la page Propriétés du service web , cliquez sur Suivant.

   Notes

   La sélection d’une des options d’en-tête SOAP est appliquée globalement à tous les services Web et méthodes Web créés lors de l’exécution de cette instance de l’Assistant.

8. Si vous avez sélectionné l’option Ajouter des en-têtes SOAP supplémentaires , les pages Demander des en-têtes SOAP et Des en-têtes SOAP de réponse s’affichent. Vous pouvez ajouter et supprimer des en-têtes SOAP de requête 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 Fichier d’assembly BizTalk (*.dll), tapez ou recherchez l’assembly contenant le schéma d’en-tête SOAP. La vue 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

   Un en-tête SOAP est définit par un espace de noms cible et un nom d'élément racine.

   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.

9. Dans la page Projet de service web , dans la zone de texte Nom du projet, tapez le nom du projet. Vous pouvez accepter l’emplacement par défaut (http://localhost/<project_name>), taper un emplacement pour le projet dans la zone de texte Emplacement du 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 sur 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 emplacement de réception existe déjà, il n'est pas remplacé. Les emplacements de réception de l’adaptateur SOAP sont résolus à l’aide du format /<nom >du 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 personnalisé, ajoutez le numéro du port du site Web dans l'URL. Par exemple : http://localhost:8080/<project_name>.

     Notes

     Quand vous utilisez l'Assistant pour créer des emplacements de réception, il les crée avec les valeurs par défaut. La valeur par défaut du pipeline de réception est le pipeline Microsoft.BizTalk.DefaultPipelines.PassThruReceive . Si les messages reçus via le service Web publié nécessitent un traitement de pipeline spécial (par exemple, validation, corrélation/promotion de propriétés ou cartes entrantes/sortantes), vous devez définir le pipeline de réception sur Microsoft.BizTalk.DefaultPipelines.XMLReceive ou sur un pipeline personnalisé.

     Notes

     Lorsque vous consommez (appelez) des services Web à partir d'une orchestration, l'adaptateur SOAP prend uniquement en charge les pipelines d'envoi de type transfert. Vous pouvez utiliser un pipeline d'envoi personnalisé, mais celui-ci ne pourra contenir aucun composant qui modifie les parties du corps du message. Ces composants incluent l'Assembleur XML et les composants de codage.

     Notes

     Lorsque vous accédez à cette page et si vous choisissez de ne pas choisir l’option Publication de schémas en tant que services web , dans la page Services web , vous pouvez voir la description du service web afficher les noms de service et de méthode de l’assembly BizTalk précédemment sélectionné avant de vous retirer de l’option Publier des orchestrations BizTalk en tant que services web . Cela est dû au fait que la description du service Web stockée en mémoire n'est pas effacée lorsque la méthode de publication est modifiée.

10. Cliquez sur Suivant pour passer en revue vos paramètres pour le projet de service Web ASP.NET.

11. Cliquez sur Créer pour créer le service Web ASP.NET.

12. Cliquez sur Terminer pour terminer l’Assistant Publication des services web BizTalk.

Voir aussi

Publication d’une orchestration en tant que service webComment mapper des orchestrations aux services web