tHTTPClientの標準プロパティ

[Property type] (プロパティタイプ)

[Guess Schema] (推測スキーマ)

このボタンをクリックすると、設定に応じたスキーマを取得できます。このボタンは、[Returned content] (返されたコンテンツ)ドロップダウンリストで[Status, headers and body] (ステータス、ヘッダー、ボディ)が選択されている場合か、[Output key/value pairs] (出力キー/値のペア)が選択され、その[Output key/value pairs] (出力キー/値のペア)オプションでキー/値のペアがテーブルに設定されている場合に動作します。

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

[Schema] (スキーマ)および[Edit schema] (スキーマを編集)

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。

• [Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

• [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保存されており、さまざまなプロジェクトやジョブデザインで再利用できます。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

このコンポーネントは、コンポーネントの関連設定に応じてスキーマを自動的に生成します。ただし、[Returned content] (返されたコンテンツ)ドロップダウンリストで[Body] (ボディ)を、[Response body format] (レスポンスボディ形式)ドロップダウンリストでJSONを選択した場合は、スキーマを手動で定義する必要があります。この場合、最初のレベルの属性ごとにカラムを追加し、ネスト済みJSONオブジェクトを持つ属性ではカラムタイプをStringに設定する必要があります。

{
    "id": 1,
    "name": "Talend",
    "address": {
       "city": "San Mateo",
       "state": "California",
       "zipcode": "94402"
    }
}

スキーマには、id (Int型)、name (String型)、address (String型)というカラムを追加する必要があります。追加後、このコンポーネントはinput.address.zipcodeのようにData Shaping Selector Language (DSSL)を使ってaddressカラムからzipcodeを抽出できます。

デフォルトで、スキーマのカラムは[Response body format] (レスポンスボディ形式)オプションと[Returned content] (返されたコンテンツ)オプションの設定に応じて次のようになります。

• [Returned content] (返されたコンテンツ)ドロップダウンリストで[Status, headers, and body] (ステータス、ヘッダー、ボディ)エントリーが選択された場合、スキーマにはbody (String型)、headers (String型)、status (Int型)という3つのカラムが含まれます。
• [Returned content] (返されたコンテンツ)ドロップダウンリストで[Body] (ボディ)エントリーが選択され、[Response body format] (レスポンスボディ形式)ドロップダウンリストでTEXTが選択された場合、スキーマにはbody (String型)というカラムが1つ含まれます。

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

• [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

• [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

• [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

  変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

[Sync columns] (カラムを同期)

このボタンをクリックすると、先行コンポーネントからスキーマを取得できます。

[Base URL] (ベースURL)

アクセスしたいHTTPサーバーのベースURLアドレス(https://www.example.com/v1.0/など)を入力します。HTTPサーバーによって提供されるWebサービスにアクセスするためには、ベースURLのアドレスとパスの両方を入力する必要があります。パスは[Path] (パス)フィールドに入力します。

また、Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例:

ベースURL = "https://{.input.job_url}"、およびパス = "{.input.job_url_path}"

[Authentication type] (認証タイプ)

サーバーのセキュリティ要件に応じて、次のいずれかの認証方法を選択します。

• [No authentication] (認証なし): サーバーへのアクセスで認証が必要とされない場合
• [Basic] (基本): ユーザー名とパスワードが求められます。詳細は、RFC 2617をご覧ください。
• [Digest] (ダイジェスト): ユーザー名とパスワードが求められます。詳細は、RFC 2617をご覧ください。
• [Bearer token] (ベアラートークン): 生のアクセストークンが求められます。これは、Authorization: Bearer <your token>としてHTTPリクエストヘッダーに入力されます。
• NTLM: ユーザー名(ドメイン名を含む場合あり)とパスワードが求められます。詳細は、NT LAN Manager (NTLM) Authentication Protocolをご覧ください。
• [API key] (APIキー): 渡す場所、名前、プレフィックスを選択できるなど、柔軟な方法でAPIキートークンをサーバーに渡します。
  • [Destination] (デスティネーション): トークンを設定する場所として、指定された名前を持つHTTPヘッダー、または指定された名前を持つHTTPクエリパラメーター(トークンがログに残る可能性があるため推奨しません)を指定します。
  • [Name] (名前): ヘッダーまたはクエリーパラメーターの名前を入力します。
  • [Prefix] (プレフィックス) (オプション): トークンの前に追加するプレフィックスを入力します([Destination]　(デスティネーション)が[Request header] (リクエストヘッダー)である場合のみ)。
  • [Token] (トークン): 認証トークンを入力します。
• OAuth 2.0 は、OAuthサーバーに対するアクセストークンの取得とアップデートを自動的に管理した後、ベアラートークンとしてターゲットエンドポイントに渡します。
  • [Flow] (フロー): 実行したいOAuthフローです。現在のところ、サポートされているのは[Client Credentials] (クライアント認証情報)フローのみです。
  • [Authentication mode] (認証モード): サポートされているどの認証方式についても、フローとスコープのパラメーターがボディで設定されます。使用する形式はapplication/x-www-form-urlencodedで、キーはgrant_type=xxx&scope=xxxxとなります。
  • [Token endpoint] (トークンエンドポイント): oauth2/mydomain.com/tokenという形式で認証トークンを入力します。
  • [Client ID] (クライアントID)と[Client secret] (クライアントシークレット): クライアントIDとクライアントシークレットを入力します。
  • [Additional parameters] (追加パラメーター): 追加したい属性(たとえばscope)を入力します。

[HTTP method] (HTTPメソッド)

実行するアクションを指定するには、HTTPメソッドとしてGET、POST、HEAD、OPTIONS、PUT、PATCH、DELETE、TRACEのいずれかを選択します。

HTTPメソッドを選択するためには、このフィールドの横にある[...]ボタンをクリックし、表示されるダイアログボックスで目的のHTTPメソッドを選択します。

[Path] (パス)

URLの2番目の部分を入力し、[Base URL] (ベースURL)フィールドのベースURLを完成させます。ベースURLとパスは、必要であれば/という文字で結合されます。たとえばhttps://jira.talendforge.org/rest/api/2/というURLのサーバーからデータを検索するためには、このフィールドにsearchと入力します。

関連情報は[Base URL] (ベースURL)フィールドの説明をご参照ください。

また、Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例:

ベースURL = "https://{.input.job_url}"、およびパス = "{.input.job_url_path}"

[Path parameters] (パスパラメーター)

このチェックボックスを選択すると、ベースURLやパスを完成させるために必要な追加パラメーターを名前と値のペアの形式で指定できます。

ベースURLやパスにプレースホルダーが含まれている場合は、このテーブルにパラメーターを追加し、次の方法でそのパラメーターに名前と値を設定すれば、そのプレースホルダーを置き換えることができます。

• [Name] (名前): 置換するプレースホルダーの名前を入力します。

• [Value] (値): プレースホルダーの代わりに置換したい値を入力します。静的値(contactEntityなど)、受信レコードからの抽出値({.input.entity.id}など)、両方の混合値(version{.input.api.version}など)のいずれか

たとえばベースURLがhttps://www.example.comでパスが/{api_version}であれば、このテーブルにパラメーターを追加し、[Name] (名前)をapi_versionに、[Value] (値)をv1.0にすることでパスを設定できます。

クエリーパラメーター

例: クエリーパラメーター名 = entityId、およびクエリーパラメーター値 = UUID-1234567

[Request headers] (リクエストヘッダー)

例: ヘッダー名 = Content-Type、およびヘッダー値 = text/html;charset=utf-8

[Request body] (リクエストボディ)

リクエストにメッセージボディを含めたい場合は、このオプションを選択します。

• [Text] (テキスト): ドロップダウンリストの下にあるテキストフレームに、メッセージのボディをプレーンテキストで入力します。Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例:

  id={.input.user.id}
  name={.input.user.name}

• JSON: ドロップダウンリストの下にあるテキストフレームに、メッセージのボディをJSON形式で入力します。Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例:

  {
   "id": "{.input.user.id}",
   "name": "{.input.user.name}",
   "age": "{.input.user.age}",
   }

• XML: ドロップダウンリストの下にあるテキストフレームに、メッセージのボディをXML形式で入力します。Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。例:

  <user>
   <id>{.input.user.id}</id>
   <name>{.input.user.name}</name>
   <age>{.input.user.age}</age>
  </user>

• [Form data] (フォームデータ)とx_www_urlencoded: 属性名と値のペアを持つマルチパートフォーム、または属性名と値のペアを持つURLエンコードフォームを使ってボディを作成します。ドロップダウンリストの下にあるテーブルの行に、属性の名前と値を入力します。Data Shaping Selector Language構文を使ってプレースホルダーを定義すると、受信レコードから抽出された値で一部が動的に入力されます。

[Body type] (ボディタイプ)ドロップダウンリストは、[Request body] (リクエストぼでし)オプションを選択した場合に利用できます。

[Response body format] (レスポンスボディ形式)

ドロップダウンリストでレスポンスボディ形式を選択します。正しい形式を選択すれば、コネクターは返されたレコードを解析し、そのレコードに操作を適用できるようになります。現時点では、テキスト形式とJSON形式がサポートされています。

• [Text] (テキスト): プレーンテキストのメッセージを返す場合はこの形式を選択します。この場合、レスポンスペイロードは解析されず、そこからサブ部分を抽出できなくなります。
• JSON: 受信したレスポンスがJSON形式の場合はこの形式を選択します。その場合、ペイロードは正しく解析されたJSONレコードに変換されます。

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

[Returned content] (返されたコンテンツ)

サーバーから返されるデータに応じて、次のいずれかのオプションを選択します。

• [Body] (ボディ): [Response body format] (レスポンスボディ形式)ドロップダウンリストで[Text] (テキスト)が選択された場合、bodyという文字列属性を1つだけ持つレコードが生成され、その中にペイロードがすべてコピーされます。[Response body format] (レスポンスボディ形式)ドロップダウンリストでJSONが選択された場合は、解析済みドキュメントの階層ストラクチャーを表すレコードが生成されます。

• [Status, headers and body] (ステータス、ヘッダー、ボディ): レコードの生成は、HTTPステータスコードが含まれているstatus属性(INT型)、すべてのレスポンスヘッダーがネスト済みレコードであるheaders属性、ペイロード全体がテキストとして含まれている単純文字列([Reponse body format] (レスポンスボディ形式)ドロップダウンリストからTextが選択された場合)、または解析済みドキュメントを表す階層型オブジェクト([Reponse body format] (レスポンスボディ形式)ドロップダウンリストでJSONが選択された場合)であるbody属性で行われます。

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)

ノードのパスを入力して、レスポンスのサブエレメントを選択します。エレメントが配列である場合は、その配列の各エレメントがループされます。ノード名を入力するための構文の詳細は、Data Shaping Selector Language構文をご覧ください。

このフィールドはオプションであり、JSONレスポンス全体を取得するためには空のままにしておく必要があります。

{
   "description": "List of some famous geologists",
   "content_length": 5,
   "author": "A. Smith",
   "content":[
      {
         "name":"Maurice Krafft",
         "age":35,
         "female":false,
         "address":{
            "city":"Mulhouse",
            "zipcode":68100
         }
      },
      {
         "name":"Katia Krafft",
         "age":49,
         "female":true,
         "address":{
            "city":"Soultz-Haut-Rhin",
            "zipcode":6860
         }
      },
      {
         "name":"Pline l'Ancien",
         "age":55,
         "female":false,
         "address":{
            "city":"Côme",
            "zipcode":22100
         }
      },
      {
         "name":"James Hutton",
         "age":70,
         "female":false,
         "address":{
            "city":"Édimbourg",
            "zipcode":0
         }
      },
      {
         "name":"Aline Peltier",
         "age":40,
         "female":false,
         "address":{
            "city":"Saint-Pierre",
            "zipcode":97410
         }
      }
   ]
}

{"name":"Katia Krafft","age":49.0,"female":true, ...
{"name":"Pline l'Ancien","age":55.0,"female":false, ...
{"name":"James Hutton","age":70.0,"female":false, ...

|=-----------------=|
|field              |
|=-----------------=|
|Soultz-Haut-Rhin   |
|Côme               |
|Édimbourg          |
'-------------------'

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

このフィールドは、[Response body format] (レスポンスボディ形式)ドロップダウンリストでJSONを選択した場合に利用できます。

[Output key/value pairs] (出力キー/値のペア)

このオプションを選択すると、HTTPレスポンスの生のボディの代わりにキーと値のペアが返されます。ノードの値を入力するためには、テーブルの下にあるプラスボタンをクリックして行を追加し、[Name] (名前)フィールドにノードの名前を、[Value] (値)フィールドに値をそれぞれ入力します。

値はコンポーネントの入力値かHTTPレスポンスから選択できます。値がコンポーネント入力からの場合は[Value] (値)に"{.input.<dssl_path>}"と、HTTPレスポンスの場合は"{.response.<dssl_path>}"と入力します。

HTTPサーバーからデータを取得する場合は、スキーマ、[Guess schema] (推測スキーマ)ボタン、[Response body format] (レスポンスボディ形式)オプション、[Returned content] (返されたコンテンツ)オプション、[Extract a sub-part of the JSON] (JSONのサブ部分を抽出)オプション、[Output key/value pairs] (出力キー/値のペア)オプションを使い、取得するデータの形式とコンテンツを指定できます。詳細は、tHTTPClient: 設定と出力をご覧ください。

このオプションは、[Output key/value pairs] (出力キー/値のペア)が選択されている場合に利用できます。

このオプションを選択すると、指定されたディレクトリーにレスポンスの添付ファイルがファイルとして保存されます。このオプションは、レスポンスボディが添付ファイル付きのMIMEマルチパートである場合に機能します。[Directory to save] (保存先ディレクトリー)フィールドに、ディレクトリーへのパスを入力する必要があります。指定されたディレクトリーが存在しない場合は、コンポーネントによって作成されます。指定されたディレクトリーに対して書き込み権限があることを確認してください。

添付ファイル付きのMIMEマルチパートレスポンスでは、ボディにある添付ファイルでない最初の部分が出力レコードボディとして扱われます。添付ファイル部分はContent-Disposition=attachment;...というヘッダーでマークされ、添付ファイル名はその`name=...`値から取得されます。ヘッダーメタデータにnameフィールドが提供されていない場合、そのファイルにはサービス名(つまりPath値)を使って命名されます。Content-Disposition=attachmentヘッダーを持つパートがない場合、マルチパートの最初のパートは出力レコードのボディとして扱われ、その他のパートは添付ファイルとして扱われます。

[tStatCatcher Statistics] (tStatCatcher統計)

ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータを収集するには、このチェックボックスを選択します。

[Connection timeout (ms)] (接続タイムアウト(ミリ秒))

コネクターがサーバーへの接続を確立するまでのタイムアウト期間(ミリ秒)を設定するために使われます。接続の確立に失敗した場合はエラーが発生します。

[Receive timeout (ms)] (受信タイムアウト(ミリ秒))

レスポンスデータ受信のタイムアウト期間(ミリ秒)を設定するために使われます。読み取りタイムアウト期間が経過してもデータが受信されない場合は、エラーが発生します。

[Bypass server certificate validation] (サーバー証明書の検証をバイパス)

このオプションを選択すると、クライアントにサーバー証明書を検証させないようにできます。

このオプションは本番環境ではお勧めしません。

プロキシを使用

このオプションを選択すると、HTTPやSOCKSプロキシを使用できます。

• [Proxy type] (プロキシタイプ): 使用したいプロキシのタイプとして、HTTPまたはSOCKSを選択します。HTTPプロキシでは基本認証がサポートされています。
• [Proxy host] (プロキシホスト)と[Proxy port] (プロキシポート): プロキシのアドレスとポートを入力します。
• [Proxy login] (プロキシログイン)と[Proxy password] (プロキシパスワード): プロキシへの認証に必要な認証情報を入力します。これら2つのフィールドは、[Proxy type] (プロキシタイプ)ドロップダウンリストでHTTPが選択されている場合に利用できます。

[Accept redirections] (リダイレクトを受け入れ)

このオプションを選択すると、リソースでHTTPリダイレクトのルールを適用できます。

• [Maximum number of redirects] (最大リダイレクト数): コネクターが従う最大リダイレクト数を設定するために使われます。設定した数を超えるリダイレクトがある場合は、最後のリダイレクトがクエリーの結果として返されます。
• [Redirect only on same host] (同じホストでのみリダイレクト): 同じホストを使用している場合のみリダイレクトを実行したい場合は、このオプションを有効にします。

なお、ページネーションはJSONペイロードとのみ互換性があります。目的のエレメントはJSONペイロード内の配列であることが必要です。

ページネーションを正しく動作させるためには、次のオプションを設定する必要があります。

• [Preset] (事前設定): ページネーション方式をサポートする特定のサービスについて、該当するサービスを選択して事前設定を行います。サービスを選択するためには、このフィールドの横にある[...]ボタンをクリックしてサービスを選択します。選択できるサービスは次のとおりです。
  • BOX: 詳細は、Offset-based Paginationをご覧ください。
  • JIRA: 詳細は、JIRA Server platform REST API referenceをご覧ください。
  • OData: 詳細は、OData Version 4.01. Part 1: Protocolをご覧ください。
• [Load selected preset] (選択された事前設定をロード): このボタンをクリックすると、[Preset] (事前設定)フィールドで選択された事前設定がロードされます。
• [Pagination strategy] (ページネーション方式): 使用するページネーション方式を選択します。現在のところ、使用できるのは[Offset/limit] (オフセット/制限)ストラテジーのみです。[Offset/limit] (オフセット/制限)ストラテジーは、特定サイズのページの特定の位置から始まるエレメントを取得します。offsetパラメーターは最初のエレメントからのオフセットによって開始エレメントを指定します。limitパラメーターは、エレメントの数によってページの最大サイズを指定します。[Pagination strategy] (ページネーション方式)を適用した場合、最後の呼び出しで0個のエレメントが返されるとクエリーが停止します。
• [Location] (ロケーション): オフセットパラメーターと制限パラメーターの設定方法を指定します。[Query parameters] (クエリーパラメーター)と[In headers] (ヘッダー内)のいずれかとなります。
• [Name of the offset] (オフセットの名前): オフセットとして使われるパラメーターの名前を設定するために使われます。
• [Value of the offset] (オフセットの値): オフセットを設定するために使われます。最初のエレメントから開始する場合は、0に設定します。'{.input.last_page_info.offset}'というDSSL式を使えば、受信レコードからクエリーのオフセットを取得できます。
• [Name of the limit] (制限の名前): ページ内で許可されているエレメントの最大数を定義するパラメーターの名前を設定するために使われます。
• [Value of the limit] (制限の値): 制限値、つまりページ内で返されるエレメントの最大数を設定するために使われます。ページが返される時のエレメントが0個の場合、ページネーションは停止します。
• [Path to elements] (エレメントへのパス): 目的のエレメントが含まれているJSON配列へのパスを設定するために使われます。これはJSON配列であることが必要です。offset/limit方式が適用された場合、[Extract a sub-part of the response] (レスポンスのサブ部分を抽出)オプションの設定にかかわらず、このパラメーターで指定されたエレメントがルートになります。たとえば[Preset] (事前設定)フィールドでJIRAが選択された状態で[Path to elements] (エレメントへのパス)を.issueに設定した場合、問題に存在するエレメントの属性をkeyと仮定すると、[Extract a sub-part of the response] (レスポンスのサブ部分を抽出)が.keyに設定されていても問題が取得されます。

• [Content type] (コンテンツタイプ): HTTPによって定義されているファイルのコンテンツタイプを設定するために使われます。関連情報は、https://www.w3.org/Protocols/rfc1341/4_Content-Type.htmlをご覧ください。
• [Encoding] (エンコーディング): ファイルのエンコーディングを設定するために使われます。
• [Path to file] (ファイルへのパス): アップロードするファイルへのパスを、ファイル名を含めて入力します。
• [Attachment name] (添付ファイル名): 添付ファイルのHTTP形式によるIDを設定するために使われます。

[Add attachments] (添付ファイルを追加)オプションは、[Request body] (リクエストボディ)オプションを選択し、[Basic settings] (基本設定)ビューにある[Body type] (ボディタイプ)ドロップダウンリストで[Form data] (フォームデータ)を選択した場合に利用できます。

[Force JSON numbers to "Double" type in response body] (レスポンスボディでJSON数値を倍数型に強制)

すべてのJSON数値を強制的にDouble型に変換したい場合は、このオプションを選択します。JSONでは、Integer型の数字とDouble型の数字を区別することは必ずしも可能ではありません。

たとえばDouble型しか含まないはずの地理的位置マトリクスで、項目の1つがInteger型の[47, -1.567075]として推測されてしまうことがあります。これは、コネクターがまずInteger配列を生成しようとし、次にその中にDouble型を追加しようとするため、エラーが発生しやすくなることが原因です。すべての数値を強制的にDouble型にすれば、そのようなエラーを防ぐことができます。

このオプションは、[Basic settings] (基本設定)ビューの[Response body format] (レスポンスボディ形式)ドロップダウンリストでJSONが選択された場合に利用できます。

グローバル変数

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

NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

使用ルール

このコンポーネントは、データフローの中間ステップとして、またはジョブフローチャートの終了オブジェクトとして使用できます。