tRESTClientの標準プロパティ

URL

呼び出すRESTサーバーのURLアドレスを入力します。[Use Service Locator] (Service Locatorを使用)チェックボックスがオンの場合、このフィールドは表示されず、RESTサーバーのURLはService Locatorサーバーから自動的に取得されます。

呼び出すRESTサーバーの相対パスを入力します。

たとえば、http://localhost:8888/services/Customers/listにアクセスする場合:

[Use Service Locator (Service Locatorを使用)が無効になっている場合: アドレスの最初の部分からどれでもURLフィールドに入力し、2番目の部分を[Relative Path] (相対パス)フィールドに入力できます。たとえば、URLにhttp://localhost:8888、[Relative Path] (相対パス)に/services/Customers/listと入力できます。RESTサーバーの完全パスをURLに入力し、[Relative Path] (相対パス)を空白にしておくことも可能です。

HTTP方式

このリストから、目的のアクションを説明するHTTP方式を選択します。HTTP方式の具体的な意味は、Webサービスプロバイダーの定義によって異なります。一般的に受け入れられているHTTP方式の定義は、以下のとおりです。

- GET: 特定のパラメーターをベースにサーバーエンドからデータを取得します。

- POST: 特定のパラメーターをベースにサーバーエンドにデータをアップロードします。

- PUT: 特定のパラメーターをベースにデータをアップデートします。データが存在しない場合は作成します。

- PATCH: 特定のパラメーターをベースにデータを部分的に変更します。

- DELETE: 特定のパラメーターをベースにデータを削除します。

サーバーエンドにアップロードするコンテンツのメディアタイプに応じて、[XML]、[JSON]、[FORM]のいずれかを選択します。

このリストは、POST、PUT、またはPATCH HTTP方式を選択した場合のみ表示されます。

クライアントエンドで、サーバーエンドからの受信を許可するレスポンスのメディアタイプを選択します。

オプションには、[XML]、[JSON]、[ANY] (すべて)があります。[ANY] (すべて)を選択すると、すべてのタイプのレスポンスメールを受け入れ、文字列に変換します。

URIクエリーパラメーターを名前/値のペアの形式で指定します。

このオプションは、GETメソッドで使用する場合がほとんどです。

[Schema] (スキーマ)と[Edit Schema] (スキーマを編集)

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。

このコンポーネントは、3つの組み込み、読み取り専用のスキーマを使用します。

スキーマストラクチャーを表示するには、[Edit Schema] (スキーマを編集)をクリックします。

入力データのスキーマ。このスキーマには2つのカラムが含まれています。

- [body] (ボディ): ストラクチャー化された入力データのコンテンツを保存します。

- [string] (文字列): 入力コンテンツが文字列であるか、文字列として処理される場合に、それを保存します。

サーバーレスポンスのスキーマ。このスキーマは、[Row] (行) > [Response] (レスポンス)リンク経由で次のコンポーネントに渡されます。また、次の3つのカラムが含まれています。

- statusCode: サーバーエンドからのHTTPステータスコードを保存します。

- [body] (ボディ): サーバーエンドからのストラクチャー化されたレスポンスのコンテンツを保存します。

- [string] (文字列): 文字列であるか、文字列として処理される場合に、サーバーエンドからのレスポンスコンテンツを保存します。

エラー情報のスキーマ。このスキーマは、[Row] (行) > [Error] (エラー)リンク経由で次のコンポーネントに渡されます。また、次の2つのカラムが含まれています。

- errorCode: 呼び出し処理中にエラーが発生すると、サーバーエンドからのHTTPステータスコードを保存します。エラーコードの具体的な意味は、Webサービスプロバイダーの定義によって異なります。参照情報は、en.wikipedia.org/wiki/List_of_HTTP_status_codesをご覧ください。

- errorMessage: エラーコードに対応するエラーメッセージを保存します。

RESTサーバーエンドで認証が必要な場合は、このチェックボックスをオンにします。認証タイプを以下から選択します。

• [Basic HTTP] (Basic認証): [Username] (ユーザー名)と[Password] (パスワード)に認証情報を入力します。
• [HTTP Digest] (Digest認証): [Username] (ユーザー名)と[Password] (パスワード)に認証情報を入力します。
• [SAML Token (ESB runtime only)] (SAMLトークン(ESB実行時のみ)): [Username] (ユーザー名)と[Password] (パスワード)に認証情報を入力します。
• OAuth2 Bearer: [Bearer Token] (Bearerトークン)フィールドにbase64でエンコードされた認証情報文字列を入力します。
• [Open ID Connect] (ID接続を開く): [Username] (ユーザー名)と[Password] (パスワード)に認証情報を入力します。詳細は、Talend Identity and Access ManagementおよびESBリソースと認証の管理をご覧ください。

パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。

[Use Authorization] (認証サービスを使用)

このチェックボックスをオンにして、許可されたコールを有効にします。クライアントのロールを[Role] (ロール)フィールドに指定します。このオプションは、[Use Authentication] (認証を使用)リストで[SAML Token (ESB runtime only)] (SAMLトークン(ESB実行時のみ))を選択すると表示されます。

ユーザーのロールと権限の管理については、Managing ESB Resources and authorizationsとTalend Identity and Access Managementをご覧ください。

[Use Business Correlation] (ビジネスコリレーションを使用)

このチェックボックスをオンにしてこのコンポーネントにコリレーションIDを作成します。

コリレーションIDは[Correlation Value] (コリレーション値)フィールドで指定できます。この場合、コリレーションIDはIDが呼び出すサービスに渡されます。その結果、連鎖型のサービスコールがこのコリレーションIDの下にまとめられます。このフィールドを空白にすると、実行時にこの値が自動的に生成されます。

このオプションを有効にすると、tRESTClientはレスポンスヘッダーからコリレーションIDも抽出してコンポーネント変数に保存し、フローで引き続き利用できるようにします。

このチェックボックスをオンにすると、URLのホスト名とサーバーの共通名(CN)の一致を確認できるようになります。不一致の場合は、java.io.IOException.HTTPS hostname wrongというエラーが返されます。

このオプションはデフォルトで無効になっています。有効になると、1つのジョブで同じサーバーが複数回コールされた場合にSSL設定が一度作成され、他のコールのために再利用されます。

このオプションは、URLフィールドや[Relative Path] (相対パス)フィールドに設定されたクエリーパラメーターをサポートしません。このオプションを正しく動作させるためには、すべてのクエリーパラメーターを[Query parameters] (クエリーパラメーター)テーブルに追加する必要があります。

[Log messages] (ログメッセージ)

サービスプロバイダーとコンシューマーの間のメッセージ交換を記録するには、このチェックボックスをオンにします。

[Enable WebClient Operation Reporting] (WebClientオペレーションレポートの有効化)

このチェックボックスをオンにすると、CXFエンドポイントプロパティがクライアントサイドで設定されます。一部の出力CXFメトリクスインターセプターはこれを使用し、URLを使用してサービスリクエストを追跡します。

設定されるプロパティはorg.apache.cxf.resource.operation.nameで、HTTP方式名と共にサービスURLが含まれています(たとえば、GET:http: //example.com:8080/service/)。

このチェックボックスをオンにしていない場合、プロパティは設定されず、一部のメトリクスがカウントされないため、パフォーマンスが向上する場合があります。

[Convert Response To DOM Document] (DOMドキュメントにレスポンスを変換する)

サーバーからのレスポンスをドキュメントタイプに変換する場合は、このチェックボックスをオンにします。

レスポンスが文字列として処理されるようにするには、このチェックボックスをオフにします。

[Convert Types To Strings] (タイプを文字列に変換)

このオプションは、[Content Type] (コンテンツタイプ)がJSONであるか、[Accept Type] (許可タイプ)がJSONまたは[any] (すべて)の場合に表示されます。JSONのすべての値を引用符の間の文字列に変換するには、このチェックボックスをオンにします。たとえば、このオプションを有効にすると、JSONデータは:

 "root": {
      "test": 111
    }

以下に変更されます。

"root": {
      "test": "111"
    }

このオプションは、[HTTP Method] (HTTP方式)がPOST、PUT、またはPATCHで、[Content Type] (コンテンツタイプ)がJSONの場合に表示されます。ルートJSONエレメントをドロップするには、このチェックボックスをオンにします。

[Wrap JSON Response] (JSONレスポンスをラップ)

このオプションは、[Basic settings] (基本設定)ビューの[Accept Type] (許可タイプ)リストでJSONが選択されている場合に表示され、デフォルトで有効になっています。

このチェックボックスをオンにすると、レスポンスはrootエレメントでラップされます。レスポンスからrootエレメントを削除するには、このチェックボックスをオフにします。

HTTPヘッダーに名前/値のペアを入力して、リクエストされたHTTPオペレーションのパラメーターを定義します。

HTTPヘッダーの具体的な定義は、REST Webサービスプロバイダーにお問い合わせください。参照情報は、en.wikipedia.org/wiki/List_of_HTTP_headersをご覧ください。

[Disable chunked encoding] (チャンクエンコードの無効化)

このオプションは、[HTTP Method] (HTTP方式)がPOST、PUT、またはPATCHの場合に表示されます。payloadのチャンクエンコードを無効にする場合は、このチェックボックスをオンにします。

[Connection timeout] (接続タイムアウト)

クライアントが接続を試みてタイムアウトになるまでの時間を秒数で設定します。0に設定すると、接続の試行にタイムアウトがなくなります(デフォルト: 30)。

このオプションは、 Talend Runtimeでは動作しません。ESBを Talend Runtimeにデプロイする場合、このパラメーターは無効になります。設定ファイル<TalendRuntimePath>/container/etc/org.apache.cxf.http.conduits-common.cfgには、たとえば、HTTPとHTTPSの両方のリクエストを処理し、このHTTPコンジットファイル内にclient.ConnectionTimeoutパラメーターをミリ秒単位で指定するurl = http://.*のように、サービスを網羅するURLが必要です。[Receive timeout] (受信タイムアウト)オプションを使用する必要がある場合は、client.ReceiveTimeoutもミリ秒で指定してください。

クライアントがレスポンスを待機してタイムアウトになるまでの時間を秒数で設定します。0に設定すると、クライアントは無期限に待機することになります。(デフォルトは60)

このオプションは[Connection timeout] (接続タイムアウト)オプションに似ています。コンポーネントが Talend Runtimeでデプロイされた後にこのコンポーネントを使用する方法は、[Connection timeout] (接続タイムアウト)オプションをご覧ください。

グローバル変数

NB_LINE: 処理された行の数。これはAfter変数で、整数を返します。

HEADERS: HTTPレスポンスヘッダー。これはFlow変数で、HTTPレスポンスヘッダー値のリストを返します。

CORRELATION_ID: チェーンされたサービス呼び出しがグルーピングされるコリレーションID。これはFlow変数で、文字列を返します。

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。

変数の詳細は、コンテキストと変数を使用をご覧ください。

使用ルール

このコンポーネントは、RESTfulサービスプロバイダーと通信するためにRESTful Webサービスクライアントとして使用され、サービスリクエストをジョブに入力し、ジョブの結果をサービス応答として返すことができます。実行するアクションに応じて、通常はジョブまたはサブジョブ内の開始または中間コンポーネントとして機能します。

[Dynamic settings] (ダイナミック設定)

[ + ]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、[Log messages] (ログメッセージ)、[Use Authentication] (認証を使用)、[Use HTTP proxy] (HTTPプロキシを使用)のいずれかのオプションがランタイムでダイナミックにオン、またはオフになるようにします。テーブルに3行追加すれば、オプションをすべて設定できます。

ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューまたは[Advanced settings] (詳細設定)ビューで対応するオプションがハイライトされ、利用できなくなります。

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマとコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。

出力リンク:

[Row] (行): レスポンス、エラー。

[Trigger] (トリガー): サブジョブがOkの場合、サブジョブがエラーの場合、コンポーネントがOkの場合、ifを実行、コンポーネントがエラーの場合

入力リンク:

[Row] (行): メイン、リジェクト。

[Trigger] (トリガー): 条件付き実行、サブジョブがOKの場合、サブジョブがエラーの場合、コンポーネントがOKの場合、コンポーネントがエラーの場合。

接続の詳細は、ジョブにおける接続の使い方をご覧ください。

制限事項

コンテキスト変数をダイナミックエンドポイントやService Locatorのネームスペースに利用できるのは、Talend Studio内のみです。 Talend Runtimeではサポートされていません。