HTTPクライアントのプロパティ
HTTPクライアント接続
プロパティ | 設定 |
---|---|
[Selection] (選択) | HTTPクライアントを選択または入力します。 |
プロパティ | 設定 |
---|---|
[Engine] (エンジン) | リストからエンジンを選択します。 |
プロパティ | 設定 |
---|---|
[Base URL] (ベースURL) |
アクセスしたいベースURLアドレスを入力します。 例: https://www.example.com/v1.0/ URLの2番目の部分は、HTTPクライアントのデータセット設定のPathパラメーターで設定する必要があります。 また、Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例: ベースURL = "https://{.input.job_url}"、およびパス = "{.input.job_url_path}" |
[Authentication] (認証) | サーバーのセキュリティ要件に応じて、次のいずれかの認証方法を選択します。
|
プロパティ | 設定 |
---|---|
[Connection timeout (ms)] (接続タイムアウト(ミリ秒)) |
アクセスしたいベースURLアドレスを入力します。 例: https://www.example.com/v1.0/ URLの2番目の部分は、HTTPクライアントのデータセット設定のPathパラメーターで設定する必要があります。 |
[Read timeout (ms)] (読み取りタイムアウト(ミリ秒)) | レスポンスペイロードを受信するまでの最大待機時間をミリ秒単位で設定します。読み取る対象のデータが提供される前にタイムアウトになると、例外が発生します。 |
[Bypass server certificate validation] (サーバー証明書の検証をバイパス) | 有効な場合、クライアントによるサーバー証明書の検証は行われません。これはあくまでテスト用なので、本番環境では無効にしておく必要があります。 |
[Use a proxy] (プロキシを使用) |
この切り替えを有効にすると、クライアントとサーバー間の接続はHTTPかSOCKSプロキシを介して確立されます。
|
プロパティ | 設定 |
---|---|
[Description] (説明) | 接続の表示名(必須)と説明(オプション)を入力します。 |
HTTPクライアントデータセット
プロパティ | 設定 |
---|---|
[Dataset Name] (データセット名) | データセットの表示名を入力します。この名前はすべてのTalend Cloudアプリでデータセットの一意識別子として使われます。 |
[Connection] (接続) | リストで接続を選択します。既存の接続に基づいてデータセットを作成する場合、このフィールドは読み取り専用となります。 |
[Type] (タイプ) | 作成するデータセットのタイプとして、次のいずれかを選択します。
|
プロパティ | 設定 |
---|---|
[HTTP method] (HTTPメソッド) | リストでHTTPメソッドを選択し、実行するアクションを指定します。 |
[Path] (パス) |
このデータセットが作成された接続の構成で前に設定されたURLの2番目の部分を入力します。両者を連結したものによって、このデータセットで対象としているリソースが決定されます。 ベースURL (接続)の値とパス (データセット)の値は連結し、必要であれば/という文字が追加されます。 また、Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例: ベースURL = "https://{.input.job_url}"、およびパス = "{.input.job_url_path}" |
[Path parameters] (パスパラメーター) |
このオプションを有効にすると、名前-値ペアの形式でベースURLまたはパスを完成させるために必要な追加パラメーターを指定できます。 ベースURLまたはパスにプレースホルダーが含まれている場合は、そのようなプレースホルダーを置き換えるパラメータを定義できます。
例: ベースURL = https://www.example.com パス = /{api_version} パラメーター名 = api_version パラメーター値 = v1.0 |
[Query parameters] (クエリーパラメーター) | このオプションを有効にすると、名前-値ペアの形式で?という文字の後にクエリーURLで設定されるパラメーターを指定できます。これらの値は自動的にエンコードされています。
例: クエリーパラメーター名 = entityId クエリーパラメーター値 = UUID-1234567 |
[Request headers] (リクエストヘッダー) | このオプションを有効にすると、一部のHTTPリクエストヘッダーを名前-値ペアとして定義できます。各ヘッダーは、メインのHTTPクエリー(Main)、認証クエリー(Authentication、OAuth 2.0認証でのみ利用可能)、両方のクエリー(Both)の一部となるように定義できます。
例: ヘッダー名 = Content-Type ヘッダー値 = text/html; charset=utf-8 クエリー = Main |
[Request body] (リクエストボディ) | リクエストにメッセージボディを含めたい場合は、このオプションを有効にします。
|
[Response body format] (レスポンスボディ形式) | レスポンスで期待されるペイロードのタイプに相当するボディ形式を選択します。正しい形式を選択することで、コネクターは返されたレコードを解析し、操作をそのレコードに適用できるようになります。
|
[Extract a sub-part of the response] (レスポンスのサブ部分を抽出) |
(回答ボディの形式がJSONまたはXMLの場合のみ利用可能) ボディレスポンスがJSONまたはXMLとして解析される場合は、レスポンスペイロードのサブ部分のみ返すことができます。値の抽出にはData Shaping Selector Language構文が使われます。配列が検出されると、項目は次々に返されます。 |
[Returned content] (返されたコンテンツ) | サーバーから受信する必要がある情報に応じて、次のいずれかのオプションを選択します。
|
[Output key/value pair] (出力キー/値のペア) | このオプションを有効にすると、HTTPレスポンスの生のボディの代わりにキーと値のペアが返されます。
例: 名前 = id 値 = {.response.user.id} |
プロパティ | 設定 |
---|---|
[Accept redirection] (リダイレクトを受け入れ) | このオプションを有効にすると、リソースでHTTPリダイレクトのルールが適用されます。
|
[Pagination] (ページネーション) | ページネーションを実装および設定する場合は、このオプションを有効にします。
|
HTTPクライアントソース/デスティネーション設定
- [Die on error (status code different from 2xx)] (エラー発生時(2xxとは異なるステータスコード)):
成功しなかったHTTPレスポンスのステータスコード(2xxとは異なる)を使い、実行時にエラーを発生させたい場合はこのオプションを有効にします。このオプションはデフォルトで無効になっています。
このページは役に立ちましたか?
このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。