tWriteXMLFieldの標準プロパティ

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

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

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

基本設定

Output Column	XMLストラクチャーを書き込む出力コンポーネントのデスティネーションフィールドを選択します。
Configure XML Tree (XMLツリーの設定)	フィールドに書き込むXMLストラクチャーの作成をサポートするインターフェイスを開きます。インターフェイスの詳細は、XMLツリーを定義をご覧ください。
[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ユーザーガイドをご覧ください。
[Sync columns] (カラムを同期)	クリックすると、出力ファイルのスキーマと入力ファイルのスキーマが同期されます。同期機能は、[Row] (行)接続が入力コンポーネントにリンクされている場合にのみ表示されます。
[Group by] (グループ基準)	集計セット、データの再グルーピングに使用するカラムを定義します。

詳細設定

XML宣言を削除	XMLヘッダーを含めたくない場合は、このチェックボックスをオンにしてください。
Create empty element if needed (必要に応じて空のエレメントを作成)	このチェックボックスはデフォルトで選択されています。XMLツリーエディタの[Related Column] (関連カラム)にNULL値がある場合、または列がXMLノードに関連付けられていない場合、このオプションは予想される場所に開閉タグを作成します。
[Ignore service attributes for empty elements] (空のエレメントのサービス属性を無視する)	このオプションを選択すると、入力ノードがnullであるにもかかわらずサービス属性(`@type`、`@class`、`@array`など)を持つ場合に、コンポーネントがXMLノードを生成することを防止できます。このオプションは、[Create empty element if needed] (必要に応じて空のエレメントを作成)オプションが選択されていない場合に利用可能です。注: このオプションは、TalendのR2020-04以降のStudioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
必要に応じて空のエレメントを展開する(dom4jの場合)	このオプションを選択すると、nullエレメントをタグペアの形式で表示できます。例: <element> </element> そうでない場合は、そのようなエレメントはソロタグとして表示されます。例: <element/>。XMLタグの詳細は、http://www.tizag.com/xmlTutorial/xmltag.phpをご覧ください。注: このオプションを使う場合、生成モードDom4Jを選択する必要があります。[Create empty element if needed] (必要に応じて空のエレメント作成)が選択されている場合に使用可能です。
Create associated XSD file (関連するXSDファイルの作成)	XMLエレメントの1つがNamespaceエレメントとして定義されている場合、このオプションにより対応するXSDファイルが作成されます。注: このオプションを使う場合、生成モードDom4Jを選択する必要があります。
[Advanced separator (for number)] (高度な区切り文字:数値)	数字にデフォルトで使用される区切りを変更する場合は、このチェックボックスをオンにします。数千の区切り文字: 括弧の間に千単位で使用する区切りを入力します。小数点の区切り文字: 小数点の間に使用する区切り文字を括弧で囲んで入力します。
Generation mode (生成モード)	利用可能なメモリに応じて、適切な生成モードを選択します。利用可能モードは以下のとおりです: Slow and memory-consuming (Dom4j) (低速およびメモリ消費多) 注: このオプションでは、dom4jを使用して、複雑なXMLファイルを処理できます。 [Fast with low memory consumption] (高速およびメモリ消費少)
[Encoding] (エンコーディング)	一覧からエンコードの種類を選択するか、[Custom] (カスタム)を選択して手動で定義します。データベースを扱う場合は、このフィールドは必須です。
[tStatCatcher Statistics] (tStatCatcher統計)	このチェックボックスをオンにすると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

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

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

NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

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

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

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

使用方法

使用ルール	このコンポーネントは、データフローの中間ステップとして使用できます。