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

  • 项目

适用于：SQL Server - 仅限 Windows Azure SQL 托管实例

使用 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. 在 serviceBehaviors 下找到 mdsWsHttpBehavior>部分。< <对于 serviceMetadata> 元素，请将 httpGetEnabled 设置为 true。

    注意

    如果要通过传输层安全性启用 Web 服务 (TLS) （以前称为安全套接字层 (SSL) ），请在 web.config 文件的 mdsWsHttpBehavior 节中将 httpsGetEnabled 设置为 true。 还需要更改 mdsWsHTTPBinding ，使其配置为 TLS，并注释掉非 TLS 部分。

  3. 保存对文件的更改。

  4. 通过浏览服务 URL 来测试元数据发布，例如：https://yourserver/MDS/service/service.svc。 如果启用元数据发布，则会显示一个以
    “你已创建服务”开头的页面。

通过使用 Visual Studio 创建代理类

如果已安装了 Visual Studio 2010，则生成代理类的最简方法是将“服务引用”添加到项目中。 服务引用的地址是主数据管理器 Web 应用程序的 URL，并追加了 /service/service.svc。 例如： https://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 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

其中：

  • servername：port 是承载 Master Data Manager 的计算机的计算机名和端口号。

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

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

另请参阅

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