# tXSLT

データ構造を別の構造に変換するのに役立ちます。

このコンポーネントは、XMLソースファイルを定義済みの出力ファイルに変換するためのXSLスタイルシートを参照します。

## tXSLTの標準プロパティ

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

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

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

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [XML file/stream] (XMLファイル/ストリーム) | 検証するXMLファイルまたはデータフローへのファイルパス。なお、ストリームの場合は、コンポーネントが対応する変数を通じてデータを取得できるようデータをフローに追加する必要があります。<br><br>対応する代表変数により、コンポーネントでデータを取得できるようにするには、処理するデータフローを追加する必要があります。<br><br>この変数は、既にTalend Studioで事前に定義されているか、このコンポーネントと共に使用されているコンテキストやコンポーネントによって提供されている可能性があります。それ以外の場合は、手動で変数を定義し、ジョブのデザインに応じて(たとえばtJavaまたはtJavaFlexを使って)使用できます。<br><br>手入力の手間を省くため、変数が適切に定義されることを確認する必要があるものの、予測変換リスト(Ctrl + スペース)から目的の変数を選択して、現在のフィールドに入力できます。<br><br>ストリームの使用方法の詳細は、[ストリーミングモードでのリモートファイルからのデータの読み取り](https://help.qlik.com/talend/ja-JP/components/8.0/delimited/tfileinputdelimited-tfilefetch-tsleep-tlogrow-reading-data-from-remote-file-in-streaming-mode-standard-component-this)をご覧ください。<br><br>情報メモ注: このフィールドは、[Use column instead of file/stream for XML] (XMLにファイル/ストリームではなくカラムを使用)オプションを選択した場合のみ利用できます。 |
| [XSL file/stream] (XSLファイル/ストリーム) | 参照XSL変換ファイル、または変換データフローへのファイルパス。なお、ストリームの場合は、コンポーネントが対応する変数を通じてデータを取得できるようデータをフローに追加する必要があります。<br><br>対応する代表変数により、コンポーネントでデータを取得できるようにするには、処理するデータフローを追加する必要があります。<br><br>この変数は、既にTalend Studioで事前に定義されているか、このコンポーネントと共に使用されているコンテキストやコンポーネントによって提供されている可能性があります。それ以外の場合は、手動で変数を定義し、ジョブのデザインに応じて(たとえばtJavaまたはtJavaFlexを使って)使用できます。<br><br>手入力の手間を省くため、変数が適切に定義されることを確認する必要があるものの、予測変換リスト(Ctrl + スペース)から目的の変数を選択して、現在のフィールドに入力できます。<br><br>ストリームの使用方法の詳細は、[ストリーミングモードでのリモートファイルからのデータの読み取り](https://help.qlik.com/talend/ja-JP/components/8.0/delimited/tfileinputdelimited-tfilefetch-tsleep-tlogrow-reading-data-from-remote-file-in-streaming-mode-standard-component-this)をご覧ください。<br><br>情報メモ注: このフィールドは、[Use column instead of file/stream for XSL] (XSLにファイル/ストリームではなくカラムを使用)オプションを選択した場合のみ利用できます。 |
| 出力ファイル | 出力ファイルへのファイルパス。ファイルが存在しない場合は作成されます。出力ファイルは、xslに応じて、html、xml、txt、pdf、edifactなど、ストラクチャー化ファイルまたは非ストラクチャー化ファイルのいずれでもかまいません。<br><br>情報メモ注: このフィールドは、[Use column instead of File for Result] (結果にファイルではなくカラムを使用)オプションを選択した場合のみ利用できます。 |
| [Parameters] (パラメーター) | プラスボタンをクリックして、[Parameters] (パラメーター)リストに新しい行を追加し、XSLTファイルの変換パラメーターを定義します。各行をクリックして、*[name] (名前)*リストにキーを、*[Value] (値)*リストに関連する値を入力します。 |
| [Use column instead of file/stream for XML] (XMLにファイル/ストリームではなくカラムを使用) | 指定されたカラムのデータを入力として使用する場合は、このオプションを選択します。入力データを渡すカラムは、[Input column for XML] (XML用の入力カラム)ドロップダウンリストで指定する必要があります。 |
| [Use column instead of file/stream for XSL] (XSLにファイル/ストリームではなくカラムを使用) | 指定されたカラムのデータをXSLとして使用する場合は、このオプションを選択します。XSLデータを渡すカラムは、[Input column for XML] (XSL用の入力カラム)ドロップダウンリストで指定する必要があります。 |
| [Use column instead of File for Result] (結果にファイルではなくカラムを使用) | 変換済みデータを指定されたカラムに出力する場合は、このオプションを選択します。変換済みデータを渡すカラムは、[Input column for result] (結果用の入力カラム)ドロップダウンリストで指定する必要があります。 |
| [Schema] (スキーマ)および[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。<br><br><ul> <li> <span>[Built-in] (組み込み)</span>: このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</li> <li> <span>[Repository] (リポジトリー)</span>: スキーマは既に存在し、リポジトリーに保管されているため、さまざまなプロジェクトやジョブフローチャートで再利用できます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</li> </ul><br><br>このコンポーネントはダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。<br><br>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。<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>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| [Sync columns] (カラムを同期) | クリックすると、出力ファイルのスキーマと入力ファイルのスキーマが同期されます。同期機能は、Row接続がOutputコンポーネントにリンクされた場合にのみ表示されます。 |

## 詳細設定

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

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>OUTPUT\_FILEPATH: 出力ファイルのパス。これはFlow変数で、文字列を返します。<br><br>OUTPUT\_FILENAME: 出力ファイルの名前。これはFlow変数で、文字列を返します。<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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントはスタンドアロンコンポーネントとして使用できます。 |
| 制限事項 | ライセンスの互換性の問題のため、このコンポーネントの使用に必要な1つ以上のJARが提供されていません。この特定のコンポーネントに不足しているJARをインストールするには、Component (コンポーネント)タブビューの[Install] (インストール)ボタンをクリックします。Talend StudioのIntegrationパースペクティブにある[Modules] (モジュール)タブでも、不足しているすべてのJARを簡単に見つけて追加できます。詳細は、[外部モジュールをインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/installing-external-modules)をご覧ください。 |

**関連概念**

* [XSLスタイルシートを使ってストリームからHTMLに変換](https://help.qlik.com/talend/ja-JP/components/8.0/xml/transforming-stream-to-html-using-xsl-stylesheet-standard-component "tXSLTコンポーネントではストリームがサポートされています。ストリームの形式で渡されたXMLファイルやXSLファイルを受け取ることができます。また、ファイルへの出力だけでなく、[Row] (行) > [Main] 接続で後続のコンポーネントに出力を送ることもできます。このシナリオのtXSLTコンポーネントはtFileInputRawコンポーネントからストリーム形式でXMLファイルを受け取り、定義済みカラムを介してその出力をtLogRowコンポーネントに送信します。")
* [XSLスタイルシートを使ってXMLからHTMLに変換](https://help.qlik.com/talend/ja-JP/components/8.0/xml/txslt-tmsgbox-transforming-xml-to-html-using-xsl-stylesheet-standard-component "このシナリオでは、XSLスタイルシートを使ってXMLデータをHTMLドキュメントに変換する2つのコンポーネントのジョブについて説明します。また、作成されたHTMLドキュメントのヘッダーの背景色を変更できるよう、XSLスタイルシートの変換パラメーターも定義します。")