通过

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

  • 项目

主数据管理器 Web 服务可让您通过任何能访问 主数据管理器 网站的计算机以编程方式使用 Master Data Services 的功能。 在开始编写访问 Web 服务的代码之前，必须先生成代理类。 您用于执行 Web 服务操作的主代理类是 Microsoft.MasterDataServices.ServiceClient 类，它可实现 Microsoft.MasterDataServices.IService 接口。

启用 Web 服务元数据发布

在可以生成代理类之前，必须启用 Web 服务元数据发布。 请按照下列步骤完成此操作：

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

  2. 找到 <serviceBehaviors> 下的 mdsWsHttpBehavior 部分。 对于 <serviceMetadata> 元素，将 httpGetEnabled 设置为 true。

    注意注意

    如果您想要通过安全套接字层 (SSL) 启用 Web 服务，请在 web.config 文件的 mdsWsHttpBehavior 部分中将 httpsGetEnabled 设置为 true。 您还需要更改 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 Metadata Utility Tool (Svcutil.exe)（ServiceModel 元数据实用工具 (Svcutil.exe)）和 Generating a WCF Client from Service Metadata（从服务元数据生成 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 是承载主数据管理器的计算机的名称和端口号。

  • virtual_path 是主数据管理器在 Internet Information Services (IIS) 中的虚拟路径。

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

请参阅

概念

分类的 Web 服务操作 (Master Data Services)