tSAPODataInput
tSAPODataInputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtSAPODataInputを設定するために使われます。
標準のtSAPODataInputコンポーネントは、ビジネスファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。
このコンポーネントは、Talendが提供する8.0.1-R2025-06以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は、管理者にお問い合わせください。
基本設定
| プロパティ | 説明 |
|---|---|
| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。
|
| [OData version] (ODataバージョン) | 使用するODataプロトコルのバージョンを選択します。 |
| [Root URL] (ルートURL) | アクセスしたいSAP ODataサービスのベース URLを示すURLアドレス、つまりSAPサーバーのホストとポートを入力します。 |
| [Username] (ユーザー名)と[Password] (パスワード) | サーバーへのアクセスに基本認証として使う認証情報を入力します。 情報メモヒント: パスワード、トークン、クライアントシークレットキーを入力するためには、該当するフィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにパスワード、トークン、シークレットのいずれかを入力してOKをクリックします。[pure password] (純粋なパスワード)モードであればJSON文字列を、JavaモードであればJava式を入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。
|
| [Path] (パス) |
カタログサービスパスを入力します。 例: [Root URL] (ルートURL) = http://<server>:<port>および[Path] (パス) = /sap/opu/odata4/IWFND/config/default/iwfnd/CATALOGSERVICE |
| [Guess catalog service path] (カタログサービスパスを推測) | このボタンをクリックすると、SAP ODataカタログサービスのデフォルトパスを取得できます。詳細は、Catalog serviceをご覧ください。 |
| [OData V4 parameters] (OData V4パラメーター) (オプション) | サービスへのリクエストを微調整するために必要な、次の追加パラメーターを指定します:
詳細は、The Groups and related APIをご覧ください。 |
| [OData V2 parameters] (OData V2パラメーター) (オプション) | サービスへのリクエストを微調整するために必要な、次の追加パラメーターを指定します:
|
| [Service URL] (サービスURL) | リストからサービスURLを選択します。値は、OData v4の場合は選択されたAPIグループに基づき、OData v2の場合はフィルターパラメーターを使って生成されます。 |
| [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プロキシを使用できます。
|
| [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変数で、整数を返します。 |
使用方法
| 使用方法のガイダンス | 説明 |
|---|---|
| 使用ルール |
このコンポーネントは通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。 |
| 制限事項 |
OData v4: このコンポーネントの現在の実装では、サービスが$count機能をサポートしている必要があります。 OData v2の場合:
|