Étape 1 : Utiliser l’Assistant Développement de service d’adaptateur pour créer le projet web
Durée d’exécution : 10 minutes
Dans cette étape, vous créez un projet à l’aide de Visual Studio et de l’Assistant Développement du service d’adaptateur. L’Assistant Développement du service d’adaptateur collecte des informations sur l’adaptateur, les opérations et les configurations de point de terminaison, et génère un projet web qui peut ensuite être déployé sur IIS.
Prérequis
Vous devez générer et déployer l’exemple Echo décrit dans tutoriel 1 : Développer l’adaptateur Echo avant de commencer ce didacticiel.
Pour démarrer l’Assistant Développement du service d’adaptateur
Démarrez Visual Studio, puis dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Site web.
Dans la boîte de dialogue Nouveau site web , effectuez les actions suivantes :
Propriété Pour Langage Cliquez sur Visual C#. Modèles Cliquez sur Service d’adaptateur WCF. Lieu Sélectionnez Système de fichiers, puis tapez C :\Tutorials\EchoWeb comme chemin d’accès. Cliquez sur OK.
Dans la page d’accueil, cliquez sur Suivant.
Pour sélectionner l’adaptateur et l’URI
Dans la page Choisir les opérations pour générer un contrat de service , sélectionnez echoAdapterBindingV2 dans la liste déroulante Sélectionner une liaison , puis cliquez sur Configurer.
Sous l’onglet Sécurité de la boîte de dialogue Configurer l’adaptateur , définissez Type d’informations d’identification client sur Nom d’utilisateur, puis définissez les informations d’identification du nom d’utilisateur comme suit :
Propriété Valeur Nom d'utilisateur username Mot de passe mot de passe Notes
Le nom d’utilisateur et le mot de passe entrés ici sont uniquement utilisés pour se connecter à l’adaptateur lors de l’exécution des étapes de l’Assistant et ne sont pas conservés une fois l’Assistant terminé.
Cliquez sur l’onglet Propriétés de l’URI , puis définissez les propriétés comme suit :
Propriété Valeur Application LobApplication Activer l’authentification True Nom d’hôte lobhostname EchoInUpperCase Faux Notes
Les propriétés URI sélectionnées ici seront utilisées pour créer les éléments de <point de terminaison>client>< dans le fichier web.config.
Cliquez sur l’onglet Propriétés de liaison . Notez les valeurs par défaut, puis cliquez sur OK.
Notes
Les valeurs de liaison seront utilisées pour générer les < élémentsechoAdapterBindingV2>des liaisons>< dans le fichier web.config.
Pour sélectionner le contrat et les opérations
Dans la page Choisir les opérations pour générer un contrat de service , cliquez sur Se connecter.
Dans l’arborescence Sélectionner une catégorie , sélectionnez Catégorie principale. Cette opération remplit la liste Catégories et opérations disponibles .
Notes
Vous pouvez également entrer un terme de recherche dans le champ Rechercher dans la catégorie pour rechercher les opérations qui contiennent le terme de recherche.
Dans la liste Catégories et opérations disponibles , sélectionnez EchoGreetings , puis cliquez sur Ajouter. Cela déplace l’opération EchoGreetings vers la liste Catégories et opérations ajoutées . Les opérations sélectionnées ici seront exposées aux applications clientes via le code de proxy client généré par l’Assistant.
Cliquez sur Suivant.
Pour configurer le comportement du service et du point de terminaison
Dans la page Configurer les comportements de service et de point de terminaison , entrez les valeurs suivantes pour Configuration du comportement du service :
Propriété Valeur EnableMetadataExchange True IncludeExceptionDetailsinFault True Nom customServiceBehavior UseServiceCertificate False Ces valeurs sont utilisées pour remplir le <serviceBehaviors>.
Entrez les valeurs suivantes pour Endpoint Behavior Configuration :
Propriété Valeur Nom customEndpointBehavior AuthenticationType HTTPUsernamePassword UsernameHeader MyUserHeader PasswordHeader MyPassHeader Ces valeurs seront utilisées pour spécifier l’élément adapterSecurityBridgeType dans l’élément <endpointBehaviors dans web.confg.
Cliquez sur Suivant.
Pour configurer la liaison
Dans la page Configurer la liaison et l’adresse du point de terminaison de service , sélectionnez l’entrée BindingConfiguration dans Configurer l’adresse et la liaison pour le contrat, puis cliquez sur le bouton points de suspension (...).
Dans la boîte de dialogue Personnaliser la liaison , définissez Mode sur TransportWithMessageCredential, puis cliquez sur OK.
Cliquez sur Appliquer, puis sur Suivant.
Dans la page Résumé , passez en revue les contrats et les opérations sélectionnés pour ce projet, puis cliquez sur Terminer. La solution EchoWeb vous sera présentée, qui contient les fichiers projet créés par l’Assistant Développement du service d’adaptateur
Actions effectuées
Dans cette étape, vous avez utilisé l’Assistant Développement du service d’adaptateur pour générer un projet web qui, une fois publié sur IIS, hébergera l’adaptateur Echo développé dans le tutoriel 1 : Développer l’adaptateur Echo dans le processus IIS. Le projet web résultant permet aux services web et aux clients WCF d’accéder aux opérations sélectionnées.
Étapes suivantes
Pour générer et déployer le projet web, passez à l’étape 2 : Déployer le projet web