分享方式：

建立主資料管理員 Web 服務 Proxy 類別

  • 文章

適用於：SQL Server - 僅限 Windows Azure SQL 受控執行個體

Master Data Manager Web 服務可讓您從可存取 Master Data Manager 網站的任何電腦，以程序設計方式使用 Master Data Services 的功能。 您必須先產生 Proxy 類別，才能開始撰寫程式代碼來存取 Web 服務。 您用來執行 Web 服務作業的主要 Proxy 類別是 ServiceClient 實作 介面的 IService 類別。

啟用 Web 服務元數據發佈

您必須先啟用 Web 服務元數據發佈，才能產生 Proxy 類別。 請遵循下列步驟進行：

  1. 在文本編輯器中開啟 Master Data Services Web.config 檔案。 此檔案位於 Master Data Services 安裝路徑的 WebApplication 資料夾中。

  2. 在 serviceBehaviors> 下<尋找 mdsWsHttpBehavior 區段。 針對 serviceMetadata> 元素，將 HTTPGetEnabled 設定為 true。<

    注意

    如果您想要在 Web.config 檔案的 mdsWsHttpBehavior 區段中啟用 Web 服務，先前稱為安全套接字層 （SSL），請將 HTTPsGetEnabled 設定為 true。 您也需要變更 mdsWsHTTPBinding ，使其設定為 TLS，並將非 TLS 區段批注化。

  3. 將變更儲存到 檔案。

  4. 流覽至服務 URL 以測試元數據發佈，例如： https://yourserver/MDS/service/service.svc。 如果已啟用元數據發佈，則會顯示以 開頭的頁面
    「您已建立服務」。

使用 Visual Studio 建立 Proxy 類別

如果您已安裝 Visual Studio 2010，產生 Proxy 類別最簡單的方式就是將服務參考新增至專案。 服務參考的位址是 Master Data Manager Web 應用程式的 URL，附加於 /service/service.svc。 例如： https://yourserver/MDS/service/service.svc 。 如需詳細資訊，請參閱 如何：新增、更新或移除服務參考。

使用 Svcutil.exe 建立 Proxy 類別

您必須安裝 Microsoft Visual Studio 或 Microsoft Windows SDK，才能在電腦上Svcutil.exe。 如果您使用 Visual Studio，您必須使用 Visual Studio 命令提示字元來執行命令。 如需詳細資訊，請參閱 ServiceModel 元數據公用程式工具（Svcutil.exe） 和 從服務元數據產生 WCF 用戶端。

若要使用 Svcutil.exe 建立一組 C# Proxy 類別，請使用下列命令：

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是 網際網路資訊服務 中 Master Data Manager 的虛擬路徑（IIS）。

  • proxy_name是所產生 Proxy 檔案的名稱。

另請參閱

分類的 Web 服務作業 （Master Data Services）