共用方式為

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

  • 發行項

主資料管理員 Web 服務可讓您以程式設計的方式，從可以存取 主資料管理員 網站的任何電腦使用 Master Data Services 的功能。 在您可以開始撰寫程式碼以存取 Web 服務之前，必須先產生 Proxy 類別。 您用來執行 Web 服務作業的主要 Proxy 類別為 Microsoft.MasterDataServices.ServiceClient 類別，此類別會實作 Microsoft.MasterDataServices.IService 介面。

啟用 Web 服務中繼資料發佈

在您可以產生 Proxy 類別之前，必須啟用 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 建立 Proxy 類別

如果您已安裝 Visual Studio 2010，產生 Proxy 類別最簡單的方式，就是將 [服務參考] 加入至您的專案中。 服務參考的位址就是 主資料管理員 Web 應用程式的 URL，並附加 /service/service.svc。 例如：http://yourserver/MDS/service/service.svc。 如需詳細資訊，請參閱＜HOW TO：加入、更新或移除服務參考＞。

使用 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 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 為產生之 Proxy 檔案的名稱。

請參閱

概念

分類的 Web 服務作業 (Master Data Services)