次の方法で共有


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

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

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

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

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

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

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

    Note

    トランスポート層セキュリティ (TLS) 経由で Web サービスを有効にする場合は、web.config ファイルの mdsWsHttpBehavior セクションで httpsGetEnabledtrue に設定します。 また、 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 を使用してプロキシ クラスを作成する

コンピューターに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 サービス操作の分類 (マスター データ サービス)