共用方式為

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

  • 發行項

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

啟用 Web 服務中繼資料發佈

在您可以產生 Proxy 類別之前，必須啟用 Web 服務中繼資料發佈。 請遵循下列步驟進行：

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

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

    注意

    如果您想要透過安全通訊端層 (SSL) 啟用 Web 服務，請在 web.config 檔案的 httpsGetEnabled 區段中，改為將 true 設定為 mdsWsHttpBehavior。 您也需要變更 mdsWsHTTPBinding 使其設定成 SSL，與此同時也請註解非 SSL 的區段。

  3. 儲存檔案的變更。

  4. 藉由流覽至服務 URL 來測試中繼資料發佈，例如： http://yourserver/MDS/service/service.svc. 如果已啟用中繼資料發佈，則會顯示開頭為
    「您已建立服務」的頁面。

使用 Visual Studio 建立 Proxy 類別

如果您已安裝 Visual Studio 2010，產生 Proxy 類別最簡單的方式，就是將 [服務參考] 新增至您的專案。 服務參考的位址是 Master Data Manager Web 應用程式的 URL，附加了 /service/service.svc。 例如：http://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 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) 中 Master Data Manager 的虛擬路徑。

  • proxy_name 為產生之 Proxy 檔案的名稱。

另請參閱

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