tODataInputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtODataInputを設定するために使われます。
標準のtODataInputコンポーネントは、インターネットファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で使用できます。
- このコンポーネントは、Talendが提供する8.0.1-R2024-01以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
- このコンポーネントはODataバージョン4.xのみをサポートしています。
基本設定
| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。
|
| [Root URL] (ルートURL) | アクセスしたいODataサービスのルートを示すURLアドレスを入力します。たとえばhttps://services.odata.org/V4/xxxとなります。詳細は、Service Root URLをご覧ください。 |
| [Authentication type] (認証タイプ) | サーバーのセキュリティ要件に応じて、次のいずれかの認証方法を選択します。
情報メモヒント: パスワード、トークン、クライアントシークレットキーを入力するためには、該当するフィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにパスワード、トークン、シークレットのいずれかを入力してOKをクリックします。[pure password] (純粋なパスワード)モードであればJSON文字列を、JavaモードであればJava式を入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。
|
| [Entity set] (エンティティセット) | サービスから取得したい特定のエンティティセットを入力または選択します。詳細は、Addressing Entitiesをご覧ください。 情報メモヒント: 使用可能なエンティティセットをすべて表示させる場合は、対応するフィールドの横にある[...]ボタンをクリックして[Retrieve values] (値を取得)ダイアログボックスを開き、[Run in background] (バックグラウンドで実行)をクリックします。新しいダイアログボックスが開き、選択できる取得済みエンティティセットがすべて表示されます。[Use custom value] (カスタム値を使用)チェックボックスを選択すれば、カスタム値を指定することもできます。
このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Specify entity key] (エンティティキーを指定) | このチェックボックスを選択すると、特定のエンティティセットを一意識別するために使用するキーを入力できます。詳細は、Addressing Entitiesをご覧ください。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $filter] ($filterを使用) | このチェックボックスを選択すると、リクエストURLで指定されたリソースのコレクションをフィルタリングするクエリーを入力できます。詳細は、System Query Option $filterをご覧ください。 同じリクエストに[Use $filter] ($filterを使用)オプションと[Use $search] ($searchを使用)オプションの両方を適用すると、結果には両方の条件に一致するエンティティだけが含まれます。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $search] ($searchを使用) | このチェックボックスを選択すると、リクエストURLに適用され、コレクションで一致するエンティティをすべて返すクエリーを入力できます。詳細は、System Query Option $searchをご覧ください。 同じリクエストに[Use $filter] ($filterを使用)オプションと[Use $search] ($searchを使用)オプションの両方が適用されると、結果には両方の条件に一致するエンティティだけが含まれます。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $select] ($selectを使用) | このチェックボックスを選択すると、リクエストURLに適用され、各エンティティや複合タイプの特定のプロパティセットを返すクエリーを入力できます。詳細は、System Query Option $selectをご覧ください。 同じリクエストに[Use $select] ($selectを使用)オプションと[Use $expand] ($expandを使用)オプションの両方が適用されると、結果には$selectの条件に一致するエンティティのみが含まれます。そのため、期待されるプロパティがすべて返されるようにするためには、$selectクエリーに$expand条件を含める必要があります。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $expand] ($expandを使用) | このチェックボックスを選択すると、リクエストURLに適用され、行に含まれる関連の拡張リソースを検索されたリソースと共に返すクエリーを入力できます。詳細は、System Query Option $expandをご覧ください。 同じリクエストに[Use $select] ($selectを使用)オプションと[Use $expand] ($expandを使用)オプションの両方が適用されると、結果には$selectの条件に一致するエンティティのみが含まれます。そのため、期待されるプロパティがすべて返されるようにするためには、$selectクエリーに$expand条件を含める必要があります。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Return type] (戻り値のタイプ) | サーバーから返されるデータを解析する方法に応じてオプションを選択します。
|
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。
スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。
|
| [Guess Schema] (推測スキーマ) | このボタンをクリックすると、設定に応じたスキーマを取得できます。このボタンは、[Returned content] (返されたコンテンツ)ドロップダウンリストで[Status, headers and body] (ステータス、ヘッダー、ボディ)が選択されている場合か、[Output key/value pairs] (出力キー-値ペア)が選択され、その[Output key/value pairs] (出力キー-値ペア)オプションでキー-値ペアがテーブルに設定されている場合に動作します。 ODataからデータを取得する時は、スキーマ、[Guess schema] (スキーマを推測)ボタン、[Entity set] (エンティティセット)オプション、[Specify entity key] (エンティティキーを指定)オプション、$filter/search/select/expandオプション、[Return type] (戻り値のタイプ)オプションを使い、取得するデータの形式とコンテンツを指定できます。 |
詳細設定
| [tStatCatcher Statistics] (tStatCatcher統計) | ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータを収集するには、このチェックボックスを選択します。 |
| [Connection timeout (ms)] (接続タイムアウト(ミリ秒)) | コネクターがサーバーへの接続を確立するまでのタイムアウト期間(ミリ秒)を設定するために使われます。接続の確立に失敗した場合はエラーが発生します。 |
| [Receive timeout (ms)] (受信タイムアウト(ミリ秒)) | レスポンスデータ受信のタイムアウト期間(ミリ秒)を設定するために使われます。読み取りタイムアウト期間が経過してもデータが受信されない場合は、エラーが発生します。 |
| [Use a proxy] (プロキシを使用) | このオプションを選択すると、HTTPやSOCKSプロキシを使用できます。
|
| [Accept header] (承認ヘッダー)と[Headers] (ヘッダー) | これらのオプションを使用すると、ヘッダーで受け入れられる書式のセットを名前-値ペアとして定義できます。詳細は、Header Acceptをご覧ください。 [Basic settings] (基本設定)タブでRecordを戻り値のタイプとして選択した場合は、String以外のプリミティブタイプが正しく解析されるよう、[Accept header] (承認ヘッダー)フィールドのodata.metadata=minimalをodata.metadata=fullに置き換える必要があるかもしれません。 |
| [Use custom URL parameters] (カスタムURLパラメーターを使用) | このチェックボックスを選択すると、?という文字の後にクエリーURLで設定されるパラメーターをname-valueペアの形式で指定できます。 |
| [Use $skip] ($skipを使用) | このチェックボックスを選択すると、クエリーされたコレクションでスキップされ、結果に含まれない項目の数を指定できます。詳細は、System Query Option $top and $skipをご覧ください。 同じリクエストに[Use $skip] ($skipを使用)オプションと[Use $top] ($topを使用)オプションの両方を適用すると、結果には両方の条件に一致するエンティティだけが含まれます。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $top] ($topを使用) | このチェックボックスを選択すると、クエリーされたコレクションでスキップされ、結果に含まれる最初の項目の数を指定できます。詳細は、System Query Option $top and $skipをご覧ください。 同じリクエストに[Use $skip] ($skipを使用)オプションと[Use $top] ($topを使用)オプションの両方を適用すると、結果には両方の条件に一致するエンティティだけが含まれます。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Use $orderBy] ($orderByを使用) | このチェックボックスを選択すると、リクエストURLに適用され、関連するリソースを特定の順序で返すクエリーを入力できます。詳細は、System Query Option $orderbyをご覧ください。 このオプションは、このコンポーネントの出力フローのスキーマに影響します。このオプションを使ってテーブルでキー-値ペアを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
グローバル変数
| グローバル変数 |
ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。 NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。 |
使用方法
| 使用ルール | このコンポーネントは、データフローの中間ステップとして、またはジョブフローチャートの終了オブジェクトとして使用できます。 |