Share via

マスター データ マネージャー Web サービス プロキシ クラスの作成

  • [アーティクル]

適用対象: SQL Server - Windows のみ Azure SQL Managed Instance

マスター データ マネージャー Web サービスを使用すると、マスター データ マネージャー Web サイトにアクセスできる任意のコンピューターからマスター データ サービスの機能をプログラムで使用できます。 Web サービスにアクセスするコードの記述を開始する前に、プロキシ クラスを生成する必要があります。 Web サービス操作の実行に使用する主要なプロキシ クラスは、ServiceClient クラスです。このクラスは、IService インターフェイスを実装します。

Web サービス メタデータ パブリッシュの有効化

プロキシ クラスを生成する前に、Web サービス メタデータ パブリッシュを有効にする必要があります。 これを行うには、次の手順を実行します。

  1. テキスト エディターでマスター データ サービス Web.config ファイルを開きます。 このファイルは、マスター データ サービスインストール パスの WebApplication フォルダーにあります。

  2. serviceBehaviors の mdsWsHttpBehavior<セクションを見つけます。> serviceMetadata> 要素の<場合は、httpGetEnabled を true に設定します。

    注意

    以前は Secure Sockets Layer (SSL) と呼ばれ、トランスポート層セキュリティ (TLS) 経由で Web サービスを有効にする場合は、web.config ファイルの mdsWsHttpBehavior セクションで httpsGetEnabled を true に設定します。 また、 mdsWsHTTPBinding も TLS 用に構成されるように変更し、TLS 以外のセクションをコメントアウトする必要があります。

  3. 変更をファイルに保存します。

  4. サービス URL (たとえば、https://yourserver/MDS/service/service.svc) を参照して、メタデータのパブリッシュをテストします。 メタデータ パブリッシュが有効化されると、
    "サービスを作成しました。" で始まるページが表示されます。

Visual Studio を使用してプロキシ クラスを作成する

Visual Studio 2010 がインストールされている場合、プロキシ クラスを生成する最もシンプルな方法は、プロジェクトにサービス参照を追加することです。 サービス参照のアドレスは、/service/service.svc が付加されたマスター データ マネージャー Web アプリケーションの URL です。 たとえば、https://yourserver/MDS/service/service.svc のように指定します。 詳細については、「方法: サービス参照を追加、更新、または削除する」を参照してください。

Svcutil.exe を使用してプロキシ クラスを作成する

コンピューターにSvcutil.exeするには、Microsoft Visual Studio またはMicrosoft Windows SDKがインストールされている必要があります。 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 は、マスター データ マネージャーをホストするコンピューターのコンピューター名とポート番号です。

  • virtual_path は、インターネット インフォメーション サービス (IIS) のマスター データ マネージャーの仮想パスです。

  • proxy_name には、生成されるプロキシ ファイルの名前を指定します。

参照

Web サービス操作の分類 (Master Data Services)