Web サービスタスク

[アーティクル]
09/17/2013

Web サービスタスクは、Web サービスメソッドを実行します。 Web サービスタスクは、次の目的で使用できます。

Web サービスメソッドが返す値を変数に書き込みます。たとえば、Web サービスメソッドから 1 日の最高気温を取得し、その値を使用して、列の値を設定する式で使用する変数を更新できます。
Web サービスメソッドが返す値をファイルに書き込みます。たとえば、見込み客の一覧をファイルに書き込み、データをデータベースに書き込む前にそのデータをクリーンにするためのパッケージのデータソースとして、そのファイルを使用できます。

WSDL ファイル

Web サービスタスクは、HTTP 接続マネージャーを使用して Web サービスに接続します。 HTTP 接続マネージャーは、Web サービスタスクとは別に構成され、タスク内で参照されます。 HTTP 接続マネージャーは、サーバーの URL、Web サービスのサーバーにアクセスするための資格情報、タイムアウト長などの、サーバーのプロキシ設定を指定します。詳細については、「HTTP 接続マネージャー」を参照してください。

重要
HTTP 接続マネージャーでは、匿名認証と基本認証のみがサポートされています。 Windows 認証はサポートされていません。

HTTP 接続マネージャーは、Web サイトまたは Web サービス記述言語 (WSDL) ファイルを参照できます。 WSDL ファイルを参照する HTTP 接続マネージャーの URL には、?WSDL パラメーターが含まれます。たとえば、http://MyServer/MyWebService/MyPage.asmx?WSDL と指定します。

SSIS で用意されている [Web サービスタスクエディター] ダイアログボックスを使用して Web サービスタスクを構成するには、WSDL ファイルがローカルで使用できる必要があります。

HTTP 接続マネージャーが Web サイトを参照する場合、WSDL ファイルを手動でローカルコンピューターにコピーする必要があります。
HTTP 接続マネージャーが WSDL ファイルを参照する場合、Web サービスタスクを使用して、Web サイトからその WSDL ファイルをローカルファイルにダウンロードできます。

WSDL ファイルには、Web サービスが提供するメソッド、メソッドに必要な入力パラメーター、メソッドが返す応答、および Web サービスとの通信方法が一覧表示されます。

メソッドが入力パラメーターを使用する場合、Web サービスタスクにはパラメーター値が必要です。たとえば、身長に基づいて購入するスキーの長さをアドバイスする Web サービスメソッドでは、入力パラメーターに身長を送信する必要があります。パラメーター値は、タスク内で定義されている文字列、またはタスクのスコープか親コンテナーで定義されている変数によって指定できます。変数を使用すると、パッケージ構成またはスクリプトを使用してパラメーター値を動的に更新できるという利点があります。詳細については、「Integration Services (SSIS) の変数」および「パッケージ構成」を参照してください。

多くの Web サービスメソッドでは、入力パラメーターを使用しません。たとえば、今月が誕生月の大統領の名前を取得する Web サービスメソッドでは、入力パラメーターは必要ありません。これは、Web サービスで現在の月をローカルに判別できるためです。

Web サービスメソッドの結果は、変数またはファイルに書き込むことができます。結果を書き込むファイルを指定するか、変数の名前を指定するには、ファイル接続マネージャーを使用します。詳細については、「ファイル接続マネージャー」および「Integration Services (SSIS) の変数」を参照してください。