# tContextLoad

フローからコンテキストをロードします。

このコンポーネントでは2種類のコントロールも実行します。受信フローに定義されているパラメーターがコンテキストに定義されていない場合に警告を出し、受信フローでコンテキスト値が初期化されていない場合にも警告を出します。ただし、これにより処理はブロックされません。

tContextLoadでは、アクティブコンテキストの値を動的に変更します。

情報メモ注: このコンポーネントがコンテキストパラメーターのダイナミックなロードに使用される時に、パラメーター値が特定のファイルまたはデータベースからロードされ、Talend Studio(Talend Cloudコンテキストパラメーターの場合はTalend Management Console)で静的に定義されたパラメーター値は無効になります。

## tContextLoadの標準プロパティ

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

標準のtContextLoadコンポーネントは、その他ファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドを定義するものです。<br><br>tContextLoadでは、スキーマは、パラメーター名と読み取るパラメーター値を含む2つのカラムで設定されている必要があります。 |
| 変数がロードされていても、コンテキストにない場合 | 変数ロードされていてもコンテキストに表示されない場合は、通知を表示する方法を選択します。[Error] (エラー)、[warning] (警告)または[info] (情報)の形式になります。 |
| 変数がコンテキストにあっても、ロードされていない場合 | 変数がコンテキストに表示されていてもロードされていない場合は、通知を表示する方法を選択する必要があります。[Error] (エラー)、[warning] (警告)または[info] (情報)の形式になります。 |
| [Print operations] (印刷操作) | このチェックボックスをオンにすると、[Run] (実行)ビューに設定されたコンテキストパラメーターが表示されます。 |
| [Disable errors] (エラーを無効にする) | このチェックボックスをオンにすると、エラーは表示されなくなります。 |
| [Disable warnings] (警告を無効にする) | このチェックボックスをオンにすると、警告は表示されなくなります。 |
| [Disable infos] (情報を無効にする) | このチェックボックスをオンにすると、情報は表示されなくなります。 |
| Die on error (エラー発生時に強制終了) | このチェックボックスはデフォルトで選択されています。エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [tStat Catcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 処理された行の数。これはAfter変数で、整数を返します。<br><br>KEY\_NOT\_INCONTEXT: 変数がロードされましたが、コンテキストに表示されません。これはAfter変数で、文字列を返します。<br><br>KEY\_NOT\_LOADED: 変数がロードされませんでしたが、コンテキストに表示されています。これはAfter変数で、文字列を返します。<br><br>ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、使用するコンテキスト値をロードするデータフローに依存しており、前の入力コンポーネントを必要としているため、開始コンポーネントにすることはできません。 |
| [Dynamic settings] (ダイナミック設定) | [+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、実行時に[Print operations] (印刷操作)オプションを動的に選択または選択解除にします。<br><br>動的パラメーターが定義されている場合、[Basic settings] (基本設定)ビューの対応する[Print operations] (印刷操作)オプションは使用できなくなります。<br><br>ダイナミックパラメーターの定義法を示すユースケースについては、[コンテキストベースのダイナミック接続によってデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/defining-context-groups/reading-data-from-databases-through-context-based-dynamic-connections)と、[ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters)をご覧ください。ダイナミック設定とコンテキスト変数の詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)と[コンテキストグループを作成し、その中でコンテキスト変数を定義](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/creating-context-group-and-define-context-variables-in-it)をご覧ください。 |
| [Limitation] (制限事項) | tContextLoadでは、デフォルトのコンテキストで定義されていない変数は作成されません。 |

**関連概念**

[ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取り](https://help.qlik.com/talend/ja-JP/components/8.0/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters)