# tMDMRestInputの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtMDMRestInputを設定するために使われます。

標準のtMDMRestInputコンポーネントは、Talend MDMファミリーに属しています。

このコンポーネントは、Talend MDM PlatformおよびTalend Data Fabricで利用できます。

## 基本設定

| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは組み込まれるか、リポジトリーにリモートで保存されます。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| --- | --- |
|  | [Built-In] (組み込み): スキーマは、このコンポーネント専用に作成され、保管されます。詳細は、 *Talend Studio* *ユーザーガイド*をご覧ください。 |
|  | [Repository] (リポジトリー): スキーマは既に存在し、リポジトリーに保管されています。さまざまなプロジェクトやジョブで再利用できます。詳細は、 *Talend Studio* *ユーザーガイド*をご覧ください。 |
| [Use an existing connection] (既存の接続を使用) | 定義済みのtMDMConnectionコンポーネントを使用する場合は、このチェックボックスを選択します。 |
| URL | REST APIを介してMDMサーバーにアクセスするためのURLを入力します。 |
| Username (ユーザー名)とPassword (パスワード) | MDMサーバーのユーザー認証データを入力します。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。 |
| データコンテナー | 読み取るデータを保持しているデータコンテナーの名前を入力します。 |
| Type (タイプ) | [Master] (マスター)または[Staging] (ステージング)を選択して、読み取りアクションを実行するデータベースのタイプを指定します。 |
| [Retrieve raw data] (生データの取得) | 必要に応じて、このチェックボックスをオンにして、クエリーされたすべてのデータを単一のフィールドに取得します。<br><br><ul> <li> <p> <span>[XML field] (XMLフィールド)</span>: 取得したデータを書き込む単一のフィールドの名前を選択します。</p> </li> <li> <p> <span>[Accept Type] (タイプを受け入れる)</span>: 取得するコンテンツのタイプ(<span>XML</span>または<span>JSON</span>)を選択します。</p> </li> </ul> |
| [Query Text] (クエリーテキスト) | 目的のデータレコードを取得するためにREST APIコールに含めるクエリーテキストを入力します。これは必須です。<br><br>デフォルトのサンプルクエリーを除き、クエリーテキストは次のようになります。<br><br><ul> <li> <p>globalMap変数、例: <span>((String)globalMap.get("row1.query"))</span> </p> </li> <li> <p>事前エスケープされたコンテキスト変数、例: <span>context.lpcMDMRestQuery</span> </p> </li> <li> <p>globalMap変数またはコンテキスト変数を含むクエリー、例: <span>"{'select':{'from':['"+context.myEntity +"'],'fields':[{'field':'"+ (String)globalMap.get("field") +"'}] }}"</span> </p> </li> </ul><br><br>クエリーテキストの各JSONフィールドを一重引用符または二重引用符で囲んで指定します。<br><br>クエリーテキストのフィールドの値に含まれる単一引用符は、バックスラッシュで二重にエスケープする必要があります。<br><br>たとえば、[Product] (製品) エンティティの [Name] (名前) フィールドに [This is Product's name] (これは製品の名前)という値がある場合、この特定の値をフィルタリングするには、次のいずれかの方法でクエリーテキストを記述します。<br><br><ul> <li> <span>"{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"</span> </li> <li> <span>"{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"</span> </li> </ul><br><br>クエリーテキストを入力したら、必ずクエリーテキストに基づいてスキーマを正しく設定してください。詳細は、[tMDMRestInputを使う時に、クエリーテキストに基づいてスキーマを正しく設定する方法](https://help.qlik.com/talend/ja-JP/components/7.3/mdm-data-processing/how-to-set-schema-correctly-based-on-query-text-whja-JPing-tmdmrestinput)をご覧ください。<br><br>情報メモ警告: 照会した生データをXMLまたはJSON形式で自分で解析する場合にのみ、[Retrieve Raw Data] (生データの取得)チェックボックスをオンにする必要があります。<br><br>情報メモ注: このコンポーネントを使って、繰り返し外部キーエレメントを含むエンティティからデータを取得する場合は、選択クエリーでメインエンティティとリンクされたエンティティの間に結合句を追加する必要があります。<br><br>たとえば、Storeという名前の別のエンティティを指す外部キーのコレクションを含むProductという名前のエンティティを考慮し、StoreFKという名前の繰り返し外部キーエレメントのデータを取得する場合は、次のように記述します。<br><br>```<br>{<br>'select':{<br>'from':['Product'],<br>'fields':[<br>{'field':'Product/Id'},<br>{'field':'Product/StoreFK'}<br>]<br>}<br>}<br>```<br><br>正しくは次のように記述します。<br><br>```<br>{<br>'select':{<br>'from':['Product'],<br>'fields':[<br>{'field':'Product/Id'},<br>{'field':'Product/StoreFK'}<br>] ,<br>'joins': [<br>{<br>'from': 'Product/StoreFK',<br>'on': 'Store/Id'<br>}<br>]<br>}<br>}<br>```<br><br>結合句を使う選択クエリーについては、 Talend Help Center ([https://help.talend.com](https://help.talend.com/) (英語のみ))で、*MDMクエリー言語とRESTデータアクセス*という記事の*他のタイプへの結合*をご覧ください。 |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスをオンにすると、エラーの発生した行がスキップされ、エラーが発生していない行の処理が完了されます。必要に応じて[Row] (行) &gt; [Rejects] (リジェクト)リンクを使ってエラーの発生している行を取得できます。 |

## 詳細設定

| [Batch Size] (バッチサイズ) | 各処理バッチの行数。<br><br>現在のクエリーのレコード数がバッチサイズより大きい場合は、レコードにページ番号を付け、バッチごとに取得する必要があります。 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルで処理メタデータが収集されます。 |

## グローバル変数

| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>NB\_LINE: 処理された行の数。これはAfter変数で、整数を返します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入れるには、Ctrl + スペースを押して変数リストにアクセスし、リストから使用する変数を選択します。<br><br>変数の詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。 |
| --- | --- |

## 使用方法

| **使用ルール** | tMDMRestInputは、tMDMConnection、tMDMCommit、MDMRollbackと一緒に使えます。<br><br>tMDMRestInputには出力リンクが必要です。 |
| --- | --- |