创建主数据管理器 Web 服务代理类

使用 Master Data Manager Web 服务,可以从可访问 Master Data Manager 网站的任何计算机以编程方式使用 Master Data Services 的功能。 在开始编写代码以访问 Web 服务之前,必须生成代理类。 用于执行 Web 服务作的主代理类是 ServiceClient 实现接口的 IService 类。

启用 Web 服务元数据发布

在生成代理类之前,必须启用 Web 服务元数据发布。 按照以下步骤执行此作:

  1. 在文本编辑器中打开 Master Data Services Web.config 文件。 此文件位于 Master Data Services 安装路径的 WebApplication 文件夹中。

  2. mdsWsHttpBehavior查找 serviceBehaviors> 下<的部分。 <对于 serviceMetadata> 元素,设置为 httpGetEnabledtrue.

    注释

    如果要在安全套接字层(SSL)上启用 Web 服务,请设置为 httpsGetEnabledtruemdsWsHttpBehavior web.config 文件的部分中。 还需要更改 mdsWsHTTPBinding ,以便为 SSL 配置它,并注释掉非 SSL 部分。

  3. 保存对文件的更改。

  4. 通过浏览到服务 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  

地点:

  • servernameport 是承载 Master Data Manager 的计算机的计算机名称和端口号。

  • virtual_path 是 Internet Information Services(IIS)中 Master Data Manager 的虚拟路径。

  • proxy_name 是生成的代理文件的名称。

另请参阅

分类 Web 服务作 (Master Data Services)