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

  • Article

S’applique à :SQL Server - Windows uniquement Azure SQL Managed Instance

Le service web Master Data Manager vous permet d’utiliser par programmation 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 ServiceClient, qui implémente l'interface 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, effectuez les étapes suivantes :

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

  2. Recherchez la section mdsWsHttpBehavior sous <serviceBehaviors>. Pour l’élément <serviceMetadata> , définissez httpGetEnabled surtrue.

    Notes

    Si vous souhaitez activer les services Web via TLS (Transport Layer Security), anciennement 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 également configuré pour TLS, et commentez la section non TLS.

  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 : https://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 Master Data Manager, ajoutée à /service/service.svc. Par exemple : https://yourserver/MDS/service/service.svc. Pour plus d’informations, consultez Guide pratique pour ajouter, mettre à jour ou supprimer une référence de service.

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

Vous devez disposer de Microsoft Visual Studio ou du Microsoft Windows SDK installé 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 https://<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 est le nom et le numéro de port de l’ordinateur qui héberge Master Data Manager.

  • virtual_path est le chemin d’accès virtuel de Master Data Manager dans Internet Information Services (IIS).

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

Voir aussi

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