tMDMRestInputの標準プロパティ

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

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

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

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

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

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

[Built-In] (組み込み): スキーマは、このコンポーネント専用に作成され、保管されます。詳細は、 Talend Studio ユーザーガイドをご覧ください。

[Repository] (リポジトリー): スキーマは既に存在し、リポジトリーに保管されています。さまざまなプロジェクトやジョブで再利用できます。詳細は、 Talend Studio ユーザーガイドをご覧ください。

[Use an existing connection] (既存の接続を使用)

定義済みのtMDMConnectionコンポーネントを使用する場合は、このチェックボックスを選択します。

URL

REST APIを介してMDMサーバーにアクセスするためのURLを入力します。

Username (ユーザー名)とPassword (パスワード)

MDMサーバーのユーザー認証データを入力します。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。

データコンテナー

読み取るデータを保持しているデータコンテナーの名前を入力します。

Type (タイプ)

[Master] (マスター)または[Staging] (ステージング)を選択して、読み取りアクションを実行するデータベースのタイプを指定します。

[Retrieve raw data] (生データの取得)

必要に応じて、このチェックボックスをオンにして、クエリーされたすべてのデータを単一のフィールドに取得します。

• [XML field] (XMLフィールド): 取得したデータを書き込む単一のフィールドの名前を選択します。

• [Accept Type] (タイプを受け入れる): 取得するコンテンツのタイプ(XMLまたはJSON)を選択します。

[Query Text] (クエリーテキスト)

目的のデータレコードを取得するためにREST APIコールに含めるクエリーテキストを入力します。これは必須です。

デフォルトのサンプルクエリーを除き、クエリーテキストは次のようになります。

• globalMap変数、例: ((String)globalMap.get("row1.query"))

• 事前エスケープされたコンテキスト変数、例: context.lpcMDMRestQuery

• globalMap変数またはコンテキスト変数を含むクエリー、例: "{'select':{'from':['"+context.myEntity +"'],'fields':[{'field':'"+ (String)globalMap.get("field") +"'}] }}"

クエリーテキストの各JSONフィールドを一重引用符または二重引用符で囲んで指定します。

クエリーテキストのフィールドの値に含まれる単一引用符は、バックスラッシュで二重にエスケープする必要があります。

たとえば、[Product] (製品) エンティティの [Name] (名前) フィールドに [This is Product's name] (これは製品の名前)という値がある場合、この特定の値をフィルタリングするには、次のいずれかの方法でクエリーテキストを記述します。

• "{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"
• "{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"

クエリーテキストを入力したら、必ずクエリーテキストに基づいてスキーマを正しく設定してください。詳細は、tMDMRestInputを使う時に、クエリーテキストに基づいてスキーマを正しく設定する方法をご覧ください。

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] 
    }
}

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] ,
         'joins': [
             {
             'from': 'Product/StoreFK',
             'on': 'Store/Id'
             }
          ] 
    }
}

[Die on error] (エラー発生時に強制終了)

このチェックボックスをオンにすると、エラーの発生した行がスキップされ、エラーが発生していない行の処理が完了されます。必要に応じて[Row] (行) > [Rejects] (リジェクト)リンクを使ってエラーの発生している行を取得できます。

[Batch Size] (バッチサイズ)

各処理バッチの行数。

現在のクエリーのレコード数がバッチサイズより大きい場合は、レコードにページ番号を付け、バッチごとに取得する必要があります。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

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

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

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

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

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

使用ルール

tMDMRestInputは、tMDMConnection、tMDMCommit、MDMRollbackと一緒に使えます。

tMDMRestInputには出力リンクが必要です。