Partager via


Guide pratique pour utiliser l’Assistant de Publication des Services WCF de BizTalk pour publier des schémas sous forme de services WCF

Vous utilisez l’Assistant Publication du service WCF BizTalk pour publier des schémas en tant que services WCF.

Remarque

Vous devez générer vos projets BizTalk avant d’exécuter l’Assistant Publication du service WCF BizTalk. Les projets BizTalk doivent inclure des schémas à publier en tant que services WCF.

Pour publier des schémas en tant que services WCF

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, pointez sur Microsoft BizTalk Server 20xx, puis cliquez sur l’Assistant Publication du service WCF BizTalk.

    Remarque

    Pour créer et publier des orchestrations et des schémas BizTalk en tant que services WCF avec les adaptateurs WCF, vous utilisez l’Assistant Publication du service WCF BizTalk. Pour publier des orchestrations et des schémas en tant que services Web avec l’adaptateur SOAP, vous utilisez l’Assistant Publication des services web BizTalk.

  2. Dans la page Bienvenue dans l’Assistant Publication du service WCF BizTalk , cliquez sur Suivant.

  3. Dans la page Type de service WCF , sélectionnez l’option de point de terminaison de service pour publier les services WCF sur les orchestrations BizTalk sélectionnées dans un assembly BizTalk.

    Page Type de service WCF

  4. Dans la page Type de service WCF , activez ou désactivez la case à cocher Activer le point de terminaison de métadonnées pour indiquer si l’emplacement de réception WCF isolé hébergé par Internet Information Services (IIS) publiera les métadonnées du service pour la récupération à l’aide d’une requête HTTP/GET.

    Lorsque cette case à cocher est cochée, l’Assistant génère un fichier Web.config dans lequel l’attribut httpGetEnabled de l’élément <serviceMetadata> a la valeur true. Vous pouvez utiliser un outil d’importation de métadonnées (tel que SvcUtil.exe) pour générer le code client requis pour appeler ce service dans l’environnement de développement. L’adresse à laquelle les métadonnées sont publiées est l’adresse du point de terminaison ainsi qu’une chaîne de requête ?wsdl .

    Remarque

    Pour empêcher la divulgation involontaire des métadonnées de service potentiellement sensibles, nous vous recommandons de désactiver ce comportement dans l’environnement de production. Pour ce faire, définissez httpgetenabled sur false ou supprimez le répertoire virtuel MEX.

  5. Dans la page Type de service WCF , dans la liste déroulante Nom de l’adaptateur (type de transport), sélectionnez l’adaptateur WCF isolé avec lequel les services WCF sont publiés. Vous pouvez sélectionner l’un des adaptateurs suivants :

    • WCF-BasicHttp. L’adaptateur WCF-BasicHttp peut communiquer avec WS-I services Web conformes à basic Profile 1.1, tels que les services ASMX.

    • WCF-WSHttp. L’adaptateur WCF-WSHttp peut communiquer avec un service via les normes WS-* via HTTP et HTTPS.

    • WCF-CustomIsolated. L’adaptateur WCF-CustomIsolated permet d’utiliser des fonctionnalités d’extensibilité Windows Communication Foundation (WCF) sur le transport HTTP.

  6. Dans la page Type de service WCF, activez la case à cocher Créer des emplacements de réception BizTalk dans l’application suivante pour créer les ports et emplacements de réception correspondant à chaque fichier .svc généré pour l’adaptateur WCF que vous avez sélectionné dans la liste déroulante Nom de l’adaptateur. Si un emplacement de réception existe déjà, il n’est pas remplacé. Après avoir sélectionné cette option, choisissez l’application dans laquelle les ports et emplacements de réception seront générés dans la liste déroulante nom de l’application BizTalk , puis cliquez sur Suivant.

  7. Dans la page Créer un service WCF , sélectionnez Publier des schémas en tant que service WCF, puis cliquez sur Suivant.

    Créer une page de service WCF

  8. Dans la page du service WCF , définissez le ou les services WCF à publier. Utilisez l’arborescence dans la boîte de dialogue Description du service Web pour ajouter, supprimer, renommer et modifier les nœuds de description du service Web pour que les services WCF publient. La boîte de dialogue Informations fournit des informations sur le nœud sélectionné et affiche les erreurs dans le nœud actuel ou les sous-nœuds :

    • Le nœud racine de l’arborescence (description du service web) décrit les services WCF à publier. Le nom du répertoire virtuel utilise le nœud racine comme nom par défaut. Vous pouvez modifier le nom de la description du service web pour que les services WCF publient en sélectionnant Renommer la description du service web.

      Page du service WCF

    • Le nœud de méthode Web, Operation1, du nœud de service par défaut, Service1, affiché par défaut dans la boîte de dialogue description du service web peut être utilisé pour un emplacement de réception de demande-réponse. Si vous envisagez de publier un emplacement de réception WCF unidirectionnel pour cette description de service, cliquez avec le bouton droit sur le nœud de méthode web par défaut, cliquez sur Supprimer la méthode web, puis créez une méthode web unidirectionnelle comme suit : Cliquez avec le bouton droit sur le nœud de service par défaut, pointez sur Ajouter une méthode web, puis cliquez sur One-Way.

    • Pour ajouter un nouveau service WCF, cliquez avec le bouton droit sur le nom de la description du service web, puis cliquez sur Ajouter un service web. Cela crée un service WCF sans aucune opération WCF. Pour modifier le nom du service WCF, cliquez avec le bouton droit sur le nœud du service WCF, cliquez sur Renommer le service web, puis appuyez sur Entrée pour accepter le nouveau nom.

    • Pour ajouter une nouvelle opération WCF, cliquez avec le bouton droit sur le nœud de service WCF, pointez sur Ajouter une méthode web, puis cliquez sur Unidirectionnel (pour une opération WCF de demande) ou demande-réponse (pour une opération WCF de requête-réponse).

    • Pour définir les types de schéma de requête 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 BizTalkou cliquez sur Parcourir pour rechercher l’assembly. L’affichage 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 de schéma de requête ou de réponse.

      Remarque

      Si vous avez installé le fichier d’assembly BizTalk dans le Global Assembly Cache (GAC), vérifiez que l’assembly du GAC a été mis à jour avec l’assembly que vous sélectionnez dans la boîte de dialogue Type de message de demande . Si le GAC a le même nom complet, l’Assistant Publication du service WCF BizTalk utilise le fichier d’assembly dans le GAC au lieu de celui que vous avez sélectionné.

      Page Type de message de demande

    • Vous pouvez renommer les nœuds demande et réponse sans affecter le code généré. Après avoir défini vos schémas, vous pouvez renommer les éléments de partie, ce qui modifie le nom du paramètre d’opération WCF. Vous pouvez voir les modifications en consultant les métadonnées de services pour les services WCF à publier.

      Remarque

      Vous ne pouvez pas utiliser d’espaces lors du changement de nom des nœuds de description du service Web.

  9. Cliquez sur Suivant pour continuer l’Assistant.

  10. Dans la page Propriétés du service WCF, dans la zone de texte Espace de noms cible du service WCF, tapez un espace de noms cible pour les services WCF, puis cliquez sur Suivant.

    Page Propriétés du service WCF

  11. Dans la page Emplacement du service WCF , dans la zone de texte Emplacement , tapez le nom du répertoire Web dans lequel les services WCF sont générés. Vous pouvez accepter l’emplacement par défaut (http://localhost/<Web service description name>), taper un emplacement pour les services WCF dans la zone de texte Emplacement , ou cliquer sur Parcourir et sélectionner un répertoire web. Sélectionnez l’une des options suivantes :

    • Remplacez le projet existant. Cette option est disponible uniquement si le répertoire Web existe déjà. Vous serez en mesure de publier sur le même emplacement uniquement si vous sélectionnez cette option. Sinon, vous devez saisir un autre emplacement de projet.

    • Autoriser l’accès anonyme au service WCF. Cette option ajoute l’accès anonyme au répertoire virtuel créé. Par défaut, le répertoire virtuel 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).

      Lorsque vous avez terminé cette page, cliquez sur Suivant.

      Page d’emplacement du service WCF

    Remarque

    L’emplacement du projet peut exister sur un autre serveur. Pour publier les services WCF sur un autre serveur, tapez le nom du projet en tant que http://<servername>/<WCF service location>.

    Remarque

    L’emplacement du projet peut exister sur un site web non défini par défaut. Lors de la publication sur un site web non défini par défaut, incluez le numéro de port du site Web dans l’URL. Par exemple : http://<servername>:8080/<WCF service location>.

    Remarque

    Lorsque vous utilisez l’Assistant pour créer des emplacements de réception, l’Assistant crée les emplacements de réception à l’aide des 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 les services WCF publiés nécessitent un traitement de pipeline spécial (par exemple, validation, promotion de corrélation/propriété ou mappages entrants/sortants), vous devez définir le pipeline de réception sur Microsoft.BizTalk.DefaultPipelines.XMLReceive ou sur un pipeline personnalisé à l’aide de la console Administration BizTalk.

  12. Dans la page Résumé du service WCF , passez en revue vos paramètres pour les services WCF.

  13. Cliquez sur Créer pour créer les services WCF.

  14. Cliquez sur Terminer pour terminer l'Assistant de publication du service WCF BizTalk.

  15. Après avoir publié des services WCF avec l’Assistant Publication du service WCF BizTalk, vous devez les configurer correctement. Pour plus d’informations sur la configuration de l’adaptateur de réception WCF isolé, consultez Comment configurer les services WCF publiés avec l’Assistant Publication du service WCF BizTalk.

Voir aussi

Comment configurer les services WCF publiés avec l'Assistant de publication de service WCF BizTalk
Procédure pas à pas : publication de services WCF avec l’adaptateur WCF-BasicHttp
Guide pratique pour utiliser l’Assistant Publication du service WCF BizTalk pour publier des orchestrations en tant que services WCF