Partager via

Utilisation de l'Assistant Consommation de service WCF BizTalk pour utiliser un service WCF

  • Article

L'infrastructure d'adaptateurs BizTalk offre un moyen d'ajouter des schémas d'adaptateur et des types BizTalk aux projets BizTalk. L'Assistant Consommation de service WCF BizTalk vous permet d'ajouter des adaptateurs d'envoi WCF à un projet BizTalk. Pour les adaptateurs d'envoi WCF, vous devez sélectionner un point de terminaison MEX (Metadata Exchange) existant pour les ports d'envoi. Vous devez ensuite entrer les informations utilisées pour générer les schémas et les types. Une fois que l'Assistant est fermé, les schémas et types nécessaires à l'utilisation de services WCF sont ajoutés au projet BizTalk.

Pour ajouter des schémas et des types pour les adaptateurs d'envoi WCF à votre projet

  1. Dans votre projet Microsoft Visual Studio BizTalk, dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, cliquez sur Ajouter, puis sur Ajouter des éléments générés.

  2. Dans la boîte de dialogue Ajouter des éléments générés - <Nom> du projet, dans la section Modèles , sélectionnez Utiliser le service WCF, puis cliquez sur Ajouter.

  3. Dans la page Bienvenue dans l’Assistant Consommation de services WCF BizTalk , cliquez sur Suivant.

  4. Dans la page Source des métadonnées , sélectionnez la source des métadonnées à importer, puis cliquez sur Suivant.

    Page source de métadonnées

    Pour télécharger des documents de métadonnées à partir du point de terminaison d’échange de métadonnées d’un service en cours d’exécution, sélectionnez l’option De point de terminaison d’échange de métadonnées (MEX). Cela nous permet de créer un port d'envoi qui agit comme un client du service WCF. Pour utiliser cette option, le point de terminaison du service doit publier des métadonnées de service pour extraction à l'aide d'une requête HTTP/GET ou HTTPS/GET. Le point de terminaison du service doit également donner accès aux métadonnées avec des informations d'identification anonymes ou des informations d'identification sous la forme d'un nom d'utilisateur et d'un mot de passe avec le schéma d'authentification de base.

    Notes

    Avec le schéma d'authentification de base, les informations d'identification sont envoyées en texte clair et peuvent être interceptées facilement. Le schéma n'offre aucune protection pour les informations transmises à partir du service. Vous devez utiliser SSL (Secure Sockets Layer) pour chiffrer vos données.

    Pour tous les autres documents de métadonnées à importer, sélectionnez l’option Fichiers de métadonnées (WSDL et XSD) pour importer des métadonnées à partir d’un système de fichiers.

    Notes

    Tous les services ne sont pas tenus de publier des métadonnées. Désactiver la publication de métadonnées permet de réduire la surface d'attaque de votre service et limiter le risque de divulgation d'informations involontaire.

  5. Si vous avez sélectionné l’option de point de terminaison d’échange de métadonnées (MEX) dans la page Source des métadonnées , la page Point de terminaison de métadonnées s’affiche. Dans la page Point de terminaison de métadonnées , spécifiez l’URL du service en cours d’exécution qui fournit des métadonnées à télécharger via WS-Metadata Exchange ou Http-Get. Pour obtenir le document de métadonnées à partir de l’URL, cliquez sur Obtenir. Si le service en cours d’exécution nécessite des informations d’identification utilisateur avec le schéma d’authentification de base, cliquez sur Modifier pour ouvrir la boîte de dialogue Assistant Consommation du service WCF BizTalk dans laquelle vous pouvez fournir le nom d’utilisateur et le mot de passe à utiliser lors de l’accès au service en cours d’exécution.

    Page point de terminaison de métadonnées

    Notes

    Pour télécharger les métadonnées des services WCF publiés via HTTP ou HTTPS, vous ne pouvez pas utiliser le point de terminaison MEX comme http://localhost:8087/CalculatorService/mex pour la zone de texte Adresse des métadonnées . Pour les services WCF, vous devez utiliser les métadonnées WSDL pour télécharger les métadonnées comme suit : http://localhost:8087/CalculatorService ou http://localhost:8087/CalculatorService?wsdl

  6. Si vous avez sélectionné l’option Fichiers de métadonnées (WSDL et XSD) dans la page Source des métadonnées , la page Point de terminaison de métadonnées s’affiche. Dans la page Point de terminaison de métadonnées , spécifiez les fichiers de métadonnées à importer. Cliquez sur Ajouter pour ajouter les fichiers de métadonnées à importer dans la vue Fichiers de métadonnées . La boîte de dialogue Ajouter des fichiers de métadonnées s’ouvre, dans laquelle vous pouvez rechercher des fichiers de métadonnées dans les emplacements de disque.

    Dans la boîte de dialogue Ajouter des fichiers de métadonnées , sélectionnez un ensemble complet de fichiers WSDL et XSD à utiliser pour les métadonnées. Vous pouvez générer ces fichiers de métadonnées en tapant la commande suivante à l'invite de commandes :

    svcutil.exe /t:metadata http://localhost/service.svc/mex

    Cliquez sur Supprimer pour supprimer les fichiers de métadonnées sélectionnés dans la vue Fichiers de métadonnées .

    Page Fichiers de métadonnées

    Notes

    SvcUtil.exe est inclus dans le Kit de développement logiciel Microsoft Windows de Windows Vista et dans les composants d'exécution .NET Framework.

    Notes

    Les métadonnées de service peuvent être falsifiées ou usurpées lorsqu'elles sont récupérées de façon non sécurisée. Des métadonnées falsifiées peuvent rediriger votre client vers un service malveillant, contenir des paramètres de sécurité compromis ou des structures XML malveillantes. Les documents de métadonnées peuvent être très volumineux et sont enregistrés fréquemment dans le système de fichiers. Vous devez vous assurer que les fichiers de métadonnées n'ont pas été falsifiés.

  7. Dans la page Importer le résumé des métadonnées du service WCF , passez en revue vos paramètres. Vous pouvez cliquer sur Précédent pour apporter des modifications. Cliquez ensuite sur Importer pour créer les artefacts et les types BizTalk à utiliser pour l’utilisation du service WCF.

  8. Dans la page Fin de l’Assistant Consommation du service WCF BizTalk , cliquez sur Terminer. Si vous souhaitez réexécuter cet Assistant, sélectionnez l’option Réexécuter cet Assistant , puis cliquez sur Terminer.

    L'Assistant Consommation de service WCF BizTalk crée, dans votre projet BizTalk, les schémas et types BizTalk nécessaires à l'utilisation des services WCF. Les types BizTalk, tels que des types de ports et de messages à parties multiples, sont créés dans une orchestration. Nous vous recommandons de ne pas modifier l'orchestration créée par l'Assistant. Au lieu de cela, vous pouvez ajouter de nouvelles orchestrations dans le projet BizTalk pour vos besoins. L’Assistant Consommation de services WCF BizTalk crée également deux fichiers de liaison, BizTalkServiceInstance.BindingInfo.xml et BizTalkServiceInstance_Custom.BindingInfo.xml. BizTalkServiceInstance.BindingInfo.xml est un fichier de liaison BizTalk qui peut être importé par l’assistant ou l’outil en ligne de commande de développement pour configurer les ports d’envoi avec les adaptateurs WCF de liaison standard, par exemple les adaptateurs WCF-NetMsmq et WCF-WSHttp. BizTalkServiceInstance.BindingInfo.xml est un fichier de liaison BizTalk qui peut être importé par l’assistant ou l’outil en ligne de commande de développement pour configurer les ports d’envoi avec l’adaptateur WCF-Custom.

    Lorsque vous importez le fichier de liaison généré, il remplit wcf . Propriété Action au format de mappage d’action. Pour voir comment cette propriété est configurée, consultez la zone de texte Action sous l’onglet Général de la boîte de dialogue Propriétés de transport du port d’envoi WCF dans la console Administration BizTalk.

    Vous pouvez spécifier wcf. Propriété d’action de deux manières différentes : le format d’action unique et le format de mappage d’action. Si vous définissez cette propriété au format d’action unique, par exemple, http://contoso.com/Svc/Op1 l’en-tête SOAPAction pour les messages sortants est toujours défini sur la valeur spécifiée dans cette propriété. Si vous définissez cette propriété dans le format de mappage d’action, l’en-tête SOAPAction sortant est déterminé par le BTS. Propriété de contexte d’opération . Par exemple, si cette propriété est définie sur le format XML suivant et le BTS. La propriété Operation est définie sur Op1, l’adaptateur d’envoi WCF utilise http://contoso.com/Svc/Op1 pour l’en-tête SOAPAction sortant.

    <BtsActionMapping>

    <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />

    <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />

    </BtsActionMapping>

    Si les messages sortants proviennent d’un port d’orchestration, les instances d’orchestration définissent dynamiquement le BTS. Propriété Operation avec le nom de l’opération du port. Si les messages sortants sont routés avec un routage basé sur le contenu, vous pouvez définir le BTS. Propriété Operation dans les composants de pipeline. Les ports générés par l’Assistant Consommation WCF BizTalk ont des opérations avec des noms qui correspondent aux attributs Name dans l’élément <BtsActionMapping> . Vous n’avez pas besoin de définir explicitement le BTS. Propriété d’opération dans les orchestrations lorsque vous envoyez des messages via des ports qui ont été générés par l’Assistant.

Voir aussi

Utilisation de l'Assistant Publication de services WCF BizTalk pour publier les orchestrations sous forme de services WCF
Comment utiliser l'Assistant Publication de services WCF BizTalk pour publier des schémas en tant que services WCF