メイン コンテンツをスキップする 補完的コンテンツへスキップ

tRESTClientの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtRESTClientを設定するために使われます。

標準tRESTClientコンポーネントは、ESBファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

基本設定

URL

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

[Relative Path] (相対パス)

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

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

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

[Use Service Locator] (Service Locatorを使用)が有効の場合: URLの部分はService Locatorによって与えられます。この場合、URLの部分を知っている必要があり、残りの部分を[Relative Path] (相対パス)に指定する必要があります。これは、リクエストするサービスに応じて異なります。たとえばtRESTRequestでは、[REST Endpoint] (RESTエンドポイント)http://localhost:8888/servicesに指定し、[Use Service Locator] (Service Locatorを使用)を有効にします。次に、このサービスを使用する場合は、tRESTClient側で、[Relative Path] (相対パス)/customers/listを指定します。
情報メモ警告: 相対パスを使う場合は、コンパイル時の問題を避けるために、host:portだけを指定するのではなく、URLフィールドにサブディレクトリーを少なくとも1つ指定してください。たとえば、http://localhost:8888の代わりにhttp://localhost:8888/servicesを使ってください。

HTTP方式

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

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

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

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

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

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

[Content Type] (コンテンツタイプ)

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

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

[Accept Type] (許可タイプ)

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

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

クエリーパラメーター

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

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

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

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

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

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

情報メモ警告:

スキーマタイプを変更すると、スキーマストラクチャーが失われ、コンポーネントが失敗する可能性があります。

入力スキーマ

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

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

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

[Response Schema] (レスポンススキーマ)

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

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

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

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

[Error Schema] (エラースキーマ)

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

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

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

[Use Service Locator] (サービスロケーターを使用) Service Locatorを有効にするには、このチェックボックスをオンにします。Service Locatorは、要求およびサービスレベル合意(SLA)を満たすよう、サービスの可用性を維持します。サービスネームスペースとサービス名をそれぞれのフィールドに指定します。
[Use Service Activity Monitor] (サービスアクティビィティモニターの使用) サービスアクティビティモニタリングを有効にするには、このチェックボックスをオンにします。このオプションにより、イベントがキャプチャーされ、それに関する情報が格納されて、サービスアクティビィティの詳細な分析とビジネストランザクションにおけるメッセージの追跡とトレースが行えます。これはサービス応答時間の分析、トラフィックパターンの特定、根本原因分析の実行などに使用できます。
[Use Authentication] (認証を使用)

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実行時のみ))を選択すると表示されます。

ユーザーのロールおよび権限の詳細は、『 Talend Administration Centerユーザーガイド』および『 Talend ESBインフラストラクチャーサービス設定ガイド』をご覧ください。

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

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

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

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

[Check server identity] (サーバーIDをチェック)

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

[Die on error] (エラー発生時に強制終了) このチェックボックスをオンにすると、エラーが発生したジョブは強制終了されます。エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。

詳細設定

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

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

[Follow redirects] (リダイレクトをフォロー) このチェックボックスをオンにすると、自動リダイレクトに従うようになります。
[Allow non-same host redirects] (異なるホストへのリダイレクトを許可) このオプションは、[Follow redirectes] (リダイレクトをフォロー)が有効である場合に表示されます。このチェックボックスをオンにすると、異なるホストでのリダイレクトが許可されます。
[Maintain session] (セッションを維持)
このオプションは、[Follow redirectes] (リダイレクトをフォロー)が有効である場合に表示されます。このチェックボックスを選択すると、複数のリダイレクトを行う場合にセッションクッキーを共有できるようになります。セッションクッキーは、メッセージ交換の終了後に他のCookieと同じように収集され、後続の処理で利用できるようになります。
情報メモ注: このオプションは、Talendが提供するR2023-01以降のStudioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

[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"
    }
[Drop JSON Request Root] (JSONリクエストルートを削除)

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

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

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

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

[HTTP Headers] (HTTPヘッダー)

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

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

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

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

[Service Locator Customer Properties] (Service Locatorの顧客プロパティ) このオプションは、[Basic settings] (基本設定)タブで[Use Service Locator] (Service Locatorを使用)が有効な場合に表示されます。[+]をクリックして、テーブルに必要なだけのプロパティを追加します。[Property Name] (プロパティ名)フィールドおよび[Property Value] (プロパティ値)フィールドにプロパティの名前と値をそれぞれ入力して、サービスを特定します。
[Service Activity Customer Properties] (サービスアクティビティの顧客プロパティ) このオプションは、[Basic settings] (基本設定)タブで[Use Service Activity Monitor] (サービスアクティビティモニタリングの使用)が有効である場合に表示されます。[+]をクリックして、テーブルに必要なだけのプロパティを追加します。[Property Name] (プロパティ名)フィールドおよび[Property Value] (プロパティ値)フィールドにプロパティの名前と値をそれぞれ入力して、サービスを特定します。

[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もミリ秒で指定してください。

[Receive timeout] (受信タイムアウト)

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

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

[Use HTTP proxy] (HTTPプロキシの使用) プロキシサーバーを使用する場合は、このチェックボックスをオンにします。選択すると、接続の詳細(ホスト、ポート、ユーザー名、パスワード)を入力する必要があります。
[tStatCatcher Statistics] (tStatCatcher統計) このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

グローバル変数

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

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

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

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

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

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

変数の詳細は、Talend Studioユーザーガイドをご覧ください。

使用方法

使用ルール

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

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

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

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

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。[Dynamic settings] (ダイナミック設定)とコンテキスト変数については、Talend Studioユーザーガイドをご覧ください。

[Connections] (接続)

出力リンク:

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

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

入力リンク:

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

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

接続の詳細は、Talend Studioユーザーガイドをご覧ください。

制限事項

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

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。