The TSV connector converts Tab-Separated Values (TSV) files into XML and generates TSV files from XML.
Key Capabilities
- Bidirectional TSV/XML conversion with configurable delimiters and encoding
- Header detection and custom column mapping capabilities
- Support for various character encodings and special character handling
Overview
Connector Configuration
This section contains all of the configurable connector properties.
Settings Tab
Configuration
Settings related to the connector Id and description.
| 設定 | 説明 |
|---|
| Connector Id | コネクタの静的で一意の識別子です。 |
| Connector Type | コネクタ名とその機能の説明を表示します。 |
| Connector Description | コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。 |
Connector Settings
Settings related to the core operation of the connector.
Other Settings
Settings not included in the previous categories.
| Setting | Description |
|---|
| Local File Scheme | コネクタがアウトプットするメッセージにファイル名を割り当てるスキーム。ファイル名にマクロを動的に使用して、識別子やタイムスタンプなどの情報を含めることができます。詳しくは、マクロを参照してください。 |
| Line Separator | 行末を示すために使用する文字シーケンス。デフォルトではシステムによって決定されますが、この設定を使用してシステムの動作を上書きできます。キャリッジリターンを示すには CR または \r を使用し、ラインフィードを示すには LF または \n を使用します。 |
Sample Files Tab
サンプルファイルをアップロードすることで、接続された CSV Map または XML Map コネクタで簡単にマッピングできます。
Sample Files タブを使用して、CSV Map または XML Map コネクタで使用するソースまたは宛先の XML テンプレートを生成します。Add Sample File をクリックします。
- データの想定される形式と構造を反映したサンプルファイルがすでにある場合は、File Upload を選択してファイルを参照します。または、Manually Create を選択してアプリケーション内でファイルを直接作成します。Manually Create を選択した場合は、サンプルファイルに名前を付けます。Next をクリックします。
- 既存のファイルを参照した場合は、View File タブにそのコンテンツが表示されます。手動でファイルを作成した場合は、このタブにサンプルデータを入力します。Next をクリックします。
- Translate and Preview タブには、サンプルデータを XML に変換したプレビューが表示されます。サンプルに満足したら、Add をクリックします。
Advanced Tab
| Setting | Description |
|---|
| Processing Delay | Transactions タブに置かれたファイルの処理を遅延させる時間（秒）。これは旧式の設定です。代替として、ローカルファイルシステムの管理にはこの設定ではなく File コネクタの使用がベストプラクティスです。 |
Logging
ログの作成と保存を制御する設定です。
| 設定 | 説明 |
|---|
| Log Level | コネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。 |
| Log Subfolder Scheme | 選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。 |
| Log Messages | 処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。 |
Miscellaneous
Miscellaneous 設定は、特定のユースケース向けの設定です。
| 設定 | 説明 |
|---|
| Other Settings | 非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：setting1=value1;setting2=value2）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。 |
Automation Tab
Automation Settings
コネクタによるファイルの自動処理に関連する設定。
| Setting | Description |
|---|
| Send | コネクタに到着したメッセージを自動的に処理するかどうか。 |
コネクタへのリソースの割り当てに関する設定です。
Alerts Tab
SLAs Tab
Converting TSV to XML
TSV ファイルが XML に変換されると、生成される XML は次の構造になります。
元のファイルの各行（レコード）は、ルート要素 Items の子になります。すべてのレコード要素の名前は、コネクタ設定で設定された Record Name オプションによって決定されます。各レコード要素は、入力ファイルの各行の値に対応する子要素を持ちます。
一部の TSV ファイルには、ファイル内の値にコンテキストを提供するヘッダー情報の行が含まれています。First line is header information 設定が有効になっている場合、このヘッダー行が解析され、解析されたヘッダーが値要素（レコード要素の子）の要素名として使用されます。それ以外の場合、値要素には field_0、field_1 のような汎用的な名前が付けられます。
Converting XML to TSV
XML を TSV ファイルに変換するには、入力 XML が「フラット」な構造になっている必要があります。これは、Items ルート要素を除いた XML 構造の深さが2であることを意味します。次に例を示します。
XML は次のように解釈されます。
- ルート要素の子は、生成されるファイルのレコード（行）として扱われます
- 各レコード要素の子は、各行の値として扱われます
First line is header information オプションが有効になっている場合、値にコンテキストを提供するために、各値要素の名前を含むヘッダー行が、生成される TSV ファイルに挿入されます。上記の例では、このヘッダー行は title、year、runtime で構成されます。
Print View
Macros
Examples
