Créer des classes proxy de service Web Master Data Manager

  • Article

Le service Web Master Data Manager vous permet de programmer les fonctionnalités de Master Data Services à partir de n'importe quel ordinateur pouvant accéder à votre site Web Master Data Manager. Avant de commencer à écrire du code pour accéder au service Web, vous devez générer des classes proxy. La classe proxy principale que vous utilisez pour effectuer des opérations de service Web est la classe Microsoft.MasterDataServices.ServiceClient, qui implémente l'interface Microsoft.MasterDataServices.IService.

Activer la publication de métadonnées de service Web

Avant de pouvoir générer des classes proxy, vous devez activer la publication de métadonnées de service Web. Pour cela, procédez comme suit :

  1. Ouvrez le fichier Web.config Master Data Services dans un éditeur de texte. Ce fichier se trouve dans le dossier WebApplication du chemin d'installation de Master Data Services.

  2. Recherchez la section mdsWsHttpBehavior sous <serviceBehaviors>. Pour l'élément <serviceMetadata>, définissez httpGetEnabled sur true.

    [!REMARQUE]

    Si vous souhaitez activer des services Web via SSL (Secure Sockets Layer), définissez httpsGetEnabled sur true dans la section mdsWsHttpBehavior du fichier web.config. Vous devez également modifier mdsWsHTTPBinding afin qu'il soit configuré pour SSL et mettre en commentaire la section non-SSL.

  3. Enregistrez les modifications apportées au fichier.

  4. Testez les métadonnées de la publication en naviguant jusqu'à l'URL du service, par exemple : http://yourserver/MDS/service/service.svc. Si la publication de métadonnées est activée, une page s'affiche, commençant par : « Vous avez créé un service. »

Création de classes proxy à l'aide de Visual Studio

Si vous avez installé Visual Studio 2010, la méthode la plus simple de générer des classes proxy est d'ajouter une Référence de service à votre projet. L'adresse de la référence de service est l'URL de l'application Web de Master Data Manager, suivie de /service/service.svc. Par exemple : http://votre serveur/MDS/service/service.svc. Pour plus d'informations, consultez Procédure : ajouter, mettre à jour ou supprimer une référence de service.

Création de classes proxy à l'aide de Svcutil.exe

Vous devez avoir installé Microsoft Visual Studio ou le Kit de développement logiciel (SDK) de Microsoft Windows pour avoir Svcutil.exe sur votre ordinateur. Si vous utilisez Visual Studio, vous devez utiliser l'invite de commandes Visual Studio pour exécuter la commande. Pour plus d'informations, consultez Outil Service Model Metadata Tool (Svcutil.exe) et Génération d'un client WCF à partir de métadonnées de service.

Pour créer un jeu de classes proxy C# à l'aide de Svcutil.exe, utilisez une commande telle que :

svcutil.exe http://<server_name:port>/<virtual_path>/Service/Service.svc 
/out:<proxy_name>.cs /messageContract /tcv:Version35 
/noconfig /ct:System.Collections.ObjectModel.Collection`1 
/namespace:*,Microsoft.MasterDataServices

Où :

  • servername:port sont le nom d'ordinateur et le numéro de port de l'ordinateur qui héberge les Master Data Manager.

  • virtual_path est le chemin d'accès virtuel des Master Data Manager dans les services Internet (IIS).

  • proxy_name désigne le nom du fichier proxy généré.

Voir aussi

Concepts

Opérations de service Web par catégorie (Master Data Services)