创建主数据管理器 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. 在 mdsWsHttpBehaviorserviceBehaviors> 下<找到节。 <对于 serviceMetadata> 元素，将 设置为 httpGetEnabledtrue。

    注意

    如果您想要通过安全套接字层 (SSL) 启用 Web 服务，请在 web.config 文件的 httpsGetEnabled 部分中将 true 设置为 mdsWsHttpBehavior。 您还需要更改 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

其中：

  • servername：port 是承载主数据管理器的计算机的计算机名称和端口号。

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

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

另请参阅

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