使用 Master Data Manager Web 服务,可以从可访问 Master Data Manager 网站的任何计算机以编程方式使用 Master Data Services 的功能。 在开始编写代码以访问 Web 服务之前,必须生成代理类。 用于执行 Web 服务作的主代理类是 ServiceClient 实现接口的 IService 类。
启用 Web 服务元数据发布
在生成代理类之前,必须启用 Web 服务元数据发布。 按照以下步骤执行此作:
在文本编辑器中打开 Master Data Services Web.config 文件。 此文件位于 Master Data Services 安装路径的 WebApplication 文件夹中。
mdsWsHttpBehavior查找 serviceBehaviors> 下<的部分。 <对于 serviceMetadata> 元素,设置为httpGetEnabledtrue.注释
如果要在安全套接字层(SSL)上启用 Web 服务,请设置为
httpsGetEnabledtruemdsWsHttpBehaviorweb.config 文件的部分中。 还需要更改mdsWsHTTPBinding,以便为 SSL 配置它,并注释掉非 SSL 部分。保存对文件的更改。
通过浏览到服务 URL 来测试元数据发布,例如: http://yourserver/MDS/service/service.svc. 如果启用了元数据发布,将显示以
开头的页面
“你已经创建了一个服务。”
使用 Visual Studio 创建代理类
如果已安装 Visual Studio 2010,生成代理类的最简单方法是向项目添加 服务引用 。 服务引用的地址是主数据管理器 Web 应用程序的 URL,追加了 /service/service.svc。 例如:http://yourserver/MDS/service/service.svc. 有关详细信息,请参阅 如何:添加、更新或删除服务引用。
使用 Svcutil.exe 创建代理类
必须安装 Microsoft Visual Studio 或 Microsoft Windows SDK 才能在计算机上 Svcutil.exe。 如果使用 Visual Studio,则必须使用 Visual Studio 命令提示符运行该命令。 有关详细信息,请参阅 ServiceModel 元数据实用工具工具(Svcutil.exe) 并从 服务元数据生成 WCF 客户端。
若要使用 Svcutil.exe创建一组 C# 代理类,请使用如下命令:
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
地点:
servername:port 是承载 Master Data Manager 的计算机的计算机名称和端口号。
virtual_path 是 Internet Information Services(IIS)中 Master Data Manager 的虚拟路径。
proxy_name 是生成的代理文件的名称。