Citizen Kane

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TSV Connector

> Convert Tab-Separated Values (TSV) files to XML and generate TSV files from XML, with configurable delimiters, encoding, and column mapping.

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

XML は、CData Arc がフロー内でデータを操作するために使用する主要な形式です。そのため、フロー内でさらに処理するためのステージングステップとして TSV ファイルを XML に変換したり、XML を操作した後に XML を TSV ファイルに変換したりすると便利です。これらの操作はどちらも TSV コネクタで実行できます。

TSV を XML に変換する詳細については、[TSV を XML に変換する](#converting-tsv-to-xml)セクションを参照してください。XML を TSV に変換する詳細については、[XML を TSV に変換する](#converting-xml-to-tsv)セクションを参照してください。

## Connector Configuration

This section contains all of the configurable connector properties.

### Settings Tab

#### Configuration

*Settings related to the connector Id and description.*

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Connector Id**</td>
<td>コネクタの静的で一意の識別子です。</td></tr>
<tr><td>**Connector Type**</td>
<td>コネクタ名とその機能の説明を表示します。</td></tr>
<tr><td>**Connector Description**</td>
<td>コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。</td></tr></tbody></table>

#### Connector Settings

*Settings related to the core operation of the connector.*

<table><thead><tr><th>Setting</th><th>Description</th></tr></thead>
<tbody><tr><td>**Column headers present**</td>
<td>TSV ファイルに、ファイル内の値に名前やコンテキストを提供するヘッダーの行が含まれているかどうか。</td></tr>
<tr><td>**Record Name**</td>
<td>XML に変換するときに TSV ファイル内の行を表す要素の名前。次のマクロを使用できます：%ConnectorID%、%FilenameNoExt%、%RegexFilename:%、%Header:%。詳しくは、[TSV を XML に変換する](#converting-tsv-to-xml)を参照してください。</td></tr></tbody></table>

#### Other Settings

*Settings not included in the previous categories.*

<table><thead><tr><th>Setting</th><th>Description</th></tr></thead>
<tbody><tr><td>**Local File Scheme**</td>
<td>コネクタがアウトプットするメッセージにファイル名を割り当てるスキーム。ファイル名にマクロを動的に使用して、識別子やタイムスタンプなどの情報を含めることができます。詳しくは、[マクロ](#macros)を参照してください。</td></tr>
<tr><td>**Line Separator**</td>
<td>行末を示すために使用する文字シーケンス。デフォルトではシステムによって決定されますが、この設定を使用してシステムの動作を上書きできます。キャリッジリターンを示すには `CR` または `\r` を使用し、ラインフィードを示すには `LF` または `\n` を使用します。</td></tr></tbody></table>

### Sample Files Tab

*サンプルファイルをアップロードすることで、接続された CSV Map または XML Map コネクタで簡単にマッピングできます。*

**Sample Files** タブを使用して、[CSV Map](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/map.md) または [XML Map](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/xml-map/xml-map.md) コネクタで使用するソースまたは宛先の XML テンプレートを生成します。**Add Sample File** をクリックします。

<ol><li>データの想定される形式と構造を反映したサンプルファイルがすでにある場合は、**File Upload** を選択してファイルを参照します。または、**Manually Create** を選択してアプリケーション内でファイルを直接作成します。**Manually Create** を選択した場合は、サンプルファイルに名前を付けます。**Next** をクリックします。</li>
<li>既存のファイルを参照した場合は、**View File** タブにそのコンテンツが表示されます。手動でファイルを作成した場合は、このタブにサンプルデータを入力します。**Next** をクリックします。</li>
<li>**Translate and Preview** タブには、サンプルデータを XML に変換したプレビューが表示されます。サンプルに満足したら、**Add** をクリックします。</li></ol>

### Advanced Tab

<table><thead><tr><th>Setting</th><th>Description</th></tr></thead>
<tbody><tr><td>**Processing Delay**</td>
<td>**Transactions** タブに置かれたファイルの処理を遅延させる時間（秒）。これは旧式の設定です。代替として、ローカルファイルシステムの管理にはこの設定ではなく [File コネクタの使用](https://docs.arc.cdata.com/26.4/cloud/ja/flows/designing-a-flow.md#interacting-with-the-local-file-system)がベストプラクティスです。</td></tr></tbody></table>

#### Logging

*ログの作成と保存を制御する設定です。*

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Log Level**</td>
<td>コネクタが生成するログの詳細度です。サポートを依頼する際は、これを**Debug** に設定してください。</td></tr>
<tr><td>**Log Subfolder Scheme**</td>
<td>選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。**Weekly** オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。</td></tr>
<tr><td>**Log Messages**</td>
<td>処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、**Transactions** タブからファイルのコピーをダウンロードできなくなる場合があります。</td></tr></tbody></table>

#### Miscellaneous

*Miscellaneous 設定は、特定のユースケース向けの設定です。*

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Other Settings**</td>
<td>非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：`setting1=value1;setting2=value2`）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。</td></tr></tbody></table>

### Automation Tab

#### Automation Settings

*コネクタによるファイルの自動処理に関連する設定。*

<table><thead><tr><th>Setting</th><th>Description</th></tr></thead>
<tbody><tr><td>**Send**</td>
<td>コネクタに到着したメッセージを自動的に処理するかどうか。</td></tr></tbody></table>

#### Performance

*コネクタへのリソースの割り当てに関する設定です。*

<table><thead><tr><th>設定</th>
<th>説明</th></tr></thead>
<tbody><tr><td>**Max Workers**</td>
<td>このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、[Advanced Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/advanced-settings.md) ページの[Performance Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/performance-settings.md) 部分にあるデフォルト設定が上書きされます。</td></tr>
<tr><td>**Max Files**</td>
<td>コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、[Advanced Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/advanced-settings.md) ページの[Performance Settings](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/performance-settings.md) 部分にあるデフォルト設定が上書きされます。</td></tr></tbody></table>

### Alerts Tab

*アラートの設定に関する設定です。*

サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、Arc は[Alerts](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/alerts.md) タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、**Override global setting** をオンに切り替えます。

デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、**Enable** チェックボックスのチェックを外します。

**Subject**（必須）を入力します。**Allow ArcScript in Subject** をチェックすると、**Subject** フィールドでArcScript を使用できます。これを選択すると、**ArcScript エディタ**ボタンが表示されます（![arcscript editor button](https://docs.arc.cdata.com/26.4/images/rest_arcscript_editor.png)）。

必要に応じて**Recipient** のメールアドレスをカンマ区切りのリストで入力します。

### SLAs Tab

*サービスレベルアグリーメント（SLA）の設定に関する設定です。*

SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。CData Arc は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA を*At Risk* としてマークします。これは、SLA が間もなく達成されない場合に*Violated* としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。

SLA が*At Risk* または*Violated* に移行したことも[アプリケーションログ](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/activity.md#アプリケーションログ)に書き込まれるため、Application Performance Monitoring（APM）やログ収集ツールでもアラートを設定できます。

SLA を定義するには、**Expected Volume** をオンに切り替え、**Settings** タブをクリックします。

![SLA Empty](https://docs.arc.cdata.com/26.4/images/sla_empty.png)
<ul><li>コネクタに送信と受信の個別のアクションがある場合は、ラジオボタンを使用してSLA がどちらの方向に適用されるかを指定します。</li>
<li>ウィンドウの**Expect at least** 部分で、次を設定します。
<ul><li>処理を見込む最小トランザクション数（ボリューム）を設定します。</li>
<li>**Every** フィールドを使用して期間を指定します。</li>
<li>SLA を有効にするタイミングを指定します。**Starting on** を選択した場合は、日付および時刻フィールドを入力します。</li>
<li>SLA を有効にしたい曜日のチェックボックスをオンにします。必要に応じて、ドロップダウンで**Everyday** を選択します。</li></ul></li>
<li>ウィンドウの**Set status to 'At Risk'** 部分で、SLA をAt Risk としてマークするタイミングを指定します。
<ul><li>デフォルトでは、SLA が違反状態になるまで通知は送信されません。これを変更するには、**Send an 'At Risk' notification** をオンにします。</li></ul></li></ul>

次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。

![SLA Configuration Example](https://docs.arc.cdata.com/26.4/images/sla_defined.png)

> [!NOTE]
>
> 必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar で**Settings** をクリックし、**Alerts > General Alerts** に移動します。タブレットと鉛筆のアイコンをクリックして編集し、**SLA Alerts** 設定のチェックを外します。

## Converting TSV to XML

TSV ファイルが XML に変換されると、生成される XML は次の構造になります。

```xml theme={null}
<Items>
  <Record>
    <field_0></field_0>
    <field_1></field_1>
    <field_2></field_2>
  </Record>
</Items>
```

元のファイルの各行（レコード）は、ルート要素 `Items` の子になります。すべてのレコード要素の名前は、[コネクタ設定](#connector-settings)で設定された **Record Name** オプションによって決定されます。各レコード要素は、入力ファイルの各行の値に対応する子要素を持ちます。

一部の TSV ファイルには、ファイル内の値にコンテキストを提供するヘッダー情報の行が含まれています。**First line is header information** 設定が有効になっている場合、このヘッダー行が解析され、解析されたヘッダーが値要素（レコード要素の子）の要素名として使用されます。それ以外の場合、値要素には `field_0`、`field_1` のような汎用的な名前が付けられます。

## Converting XML to TSV

XML を TSV ファイルに変換するには、入力 XML が「フラット」な構造になっている必要があります。これは、`Items` ルート要素を除いた XML 構造の深さが2であることを意味します。次に例を示します。

```xml theme={null}
<Items>
  <film>
    <title>Citizen Kane</title>
    <year>1941</year>
    <runtime>119</runtime>
  </film>
  <film>
    <title>Sharknado</title>
    <year>2013</year>
    <runtime>86</runtime>
  </film>
</Items>
```

XML は次のように解釈されます。

* ルート要素の子は、生成されるファイルのレコード（行）として扱われます
* 各レコード要素の子は、各行の値として扱われます

**First line is header information** オプションが有効になっている場合、値にコンテキストを提供するために、各値要素の名前を含むヘッダー行が、生成される TSV ファイルに挿入されます。上記の例では、このヘッダー行は `title`、`year`、`runtime` で構成されます。

## Print View

コネクタの **Transactions** タブで TSV ドキュメントを表示する場合、印刷プレビュー形式または生データとして表示できます。デフォルトでは、次の画像のように、ドキュメントはプレビュー形式で表示されます。

![](https://docs.arc.cdata.com/26.4/images/tsv_print_preview.png)

プレビュー形式では、データが読みやすいレイアウトで表示されます。書式設定されていないドキュメントを表示するには、右上隅の **Raw View** トグルを使用します。

## TSV Transformation: Using the XML Map Connector

多くのデータ変換フローでは、TSV コネクタを [XML Map コネクタ](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/xml-map/xml-map.md)と組み合わせて使用します。

多くの場合、データは TSV 形式で Arc フローに入り、別の形式（たとえば、データベースへの挿入、EDI ファイル、CRM や ERP データソースへの挿入）でフローから出る必要があります。あるいはその逆です。Arc は、これらのデータ変換要件に対して、単一の合理化されたアプローチを使用します。

<ul><li>入力形式を XML としてモデル化する</li>
<li>出力形式を XML としてモデル化する</li>
<li>XML Map コネクタを使用して、入力 XML と出力 XML の間でマッピングする</li></ul>

したがって、TSV コネクタはフロー内で XML Map コネクタに隣接して配置されるのが一般的です。

<ul><li>TSV ファイルがフローへの*入力*である場合、TSV コネクタは TSV ファイルを XML に変換し、その XML を変換するために XML Map コネクタに渡します</li>
<li>TSV ファイルがフローからの*出力*である場合、TSV コネクタは XML Map コネクタから XML を受け取り、それを TSV ファイルに変換します</li></ul>

XML Map コネクタには、マッピングの入力/ソースと出力/宛先の両方について、サンプル XML 構造が必要です。[Sample Files](#sample-files-tab) タブを使用してサンプルファイルをアップロードします。次に、フロー内で TSV コネクタを XML Map コネクタに接続します。この接続は、XML Map コネクタへのインバウンド、または XML Map コネクタからのアウトバウンドのいずれの方向にも設定できます。

XML Map コネクタは、テストファイルの構造を自動的に検出します。TSV コネクタを配置した場所に基づいて、ファイルは XML Map コネクタの **Source File** または **Destination File** ドロップダウンメニューに表示されます。

> [!NOTE]
>
> このテストファイルの構造は、今後のファイルを代表するものである必要があります。言い換えると、TSV コネクタ（およびその後の XML Map コネクタ）で処理されるすべての TSV ファイルは、テストファイルと同じ列を持つ必要があります。異なる TSV 構造を処理するために、複数の TSV コネクタと複数の XML Map コネクタを設定する必要がある場合があります。

## Macros

ファイル命名戦略でマクロを使用すると、データの整理効率と文脈の理解を高めることができます。
ファイル名にマクロを組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を
動的に含めることができ、各ファイルに有用な文脈を提供します。

CData Arc は次のマクロをサポートしています。これらはすべて次の構文を使用します。`%Macro%`

<table><thead><tr><th>マクロ</th><th>説明</th></tr></thead>
<tbody><tr><td>ConnectorID</td><td>コネクタのConnectorID に評価されます。</td></tr>
<tr><td>ConnectorName</td><td>コネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。</td></tr>
<tr><td>Ext</td><td>コネクタが現在処理しているファイルの拡張子に評価されます。</td></tr>
<tr><td>Filename</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。</td></tr>
<tr><td>FilenameNoExt</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。</td></tr>
<tr><td>MessageId</td><td>コネクタが出力しているメッセージのMessageId に評価されます。</td></tr>
<tr><td>RegexFilename:*pattern*</td><td>コネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。</td></tr>
<tr><td>Header:*headername*</td><td>コネクタが現在処理しているメッセージ上の対象ヘッダー（`headername`）の値に評価されます。</td></tr>
<tr><td>LongDate</td><td>システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。</td></tr>
<tr><td>ShortDate</td><td>システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。</td></tr>
<tr><td>DateFormat:*format*</td><td>システムの現在の日時を指定された形式（`format`）で評価します。利用可能な日時形式については、[日付形式のサンプル](https://docs.arc.cdata.com/26.4/cloud/ja/scripting/value-formatters/date-formatters.md#date-formats-with-literal-characters)を参照してください。</td></tr>
<tr><td>Vault:*vaultitem*</td><td>指定されたVault アイテムの値に評価されます。</td></tr></tbody></table>

### Examples

%Ext% や %ShortDate% などの一部のマクロは引数を必要としませんが、引数を必要とするものもあります。
引数を取るすべてのマクロは次の構文を使用します。`%Macro:argument%`

引数を取るマクロの例を次に示します。

<ul><li>%Header:headername%：`headername` はメッセージ上のヘッダーの名前です。</li>
<li>%Header:mycustomheader% は、入力メッセージに設定された`mycustomheader` ヘッダーの値に解決されます。</li>
<li>%Header:ponum% は、入力メッセージに設定された`ponum` ヘッダーの値に解決されます。</li>
<li>%RegexFilename:pattern%：`pattern` は正規表現パターンです。例えば、`%RegexFilename:^([\w][A-Za-z]+)%` は、ファイル名の最初の単語にマッチしてそれに解決され、大文字・小文字を区別しません（`test_file.xml` は`test` に解決されます）。</li>
<li>%Vault:vaultitem%：`vaultitem` は[Vault](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/global-settings-vault.md) 内のアイテムの名前です。例えば、`%Vault:companyname%` は、Vault に保存された`companyname` アイテムの値に解決されます。</li>
<li>%DateFormat:format%：`format` は許容される日付形式です（詳細は[日付形式のサンプル](https://docs.arc.cdata.com/26.4/cloud/ja/scripting/value-formatters/date-formatters.md#sample-date-formats)を参照してください）。例えば、`%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%` は、ファイルの日付とタイムスタンプに解決されます。</li></ul>

次の例に示すように、より高度なマクロを作成することもできます。

<ul><li>1 つのファイル名で複数のマクロを組み合わせる：`%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%`</li>
<li>マクロの外側にテキストを含める：`MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%`</li>
<li>マクロの内側にテキストを含める：`%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%`</li></ul>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
設定	説明
Connector Id	コネクタの静的で一意の識別子です。
Connector Type	コネクタ名とその機能の説明を表示します。
Connector Description	コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
Setting	Description
Column headers present	TSV ファイルに、ファイル内の値に名前やコンテキストを提供するヘッダーの行が含まれているかどうか。
Record Name	XML に変換するときに TSV ファイル内の行を表す要素の名前。次のマクロを使用できます：%ConnectorID%、%FilenameNoExt%、%RegexFilename:%、%Header:%。詳しくは、[TSV を XML に変換する](#converting-tsv-to-xml)を参照してください。
Setting	Description
Local File Scheme	コネクタがアウトプットするメッセージにファイル名を割り当てるスキーム。ファイル名にマクロを動的に使用して、識別子やタイムスタンプなどの情報を含めることができます。詳しくは、[マクロ](#macros)を参照してください。
Line Separator	行末を示すために使用する文字シーケンス。デフォルトではシステムによって決定されますが、この設定を使用してシステムの動作を上書きできます。キャリッジリターンを示すには `CR` または `\r` を使用し、ラインフィードを示すには `LF` または `\n` を使用します。
設定	説明
Log Level	コネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。
Log Subfolder Scheme	選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。
Log Messages	処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。
マクロ	説明
ConnectorID	コネクタのConnectorID に評価されます。
ConnectorName	コネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。
Ext	コネクタが現在処理しているファイルの拡張子に評価されます。
Filename	コネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。
FilenameNoExt	コネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。
MessageId	コネクタが出力しているメッセージのMessageId に評価されます。
RegexFilename:pattern	コネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。
Header:headername	コネクタが現在処理しているメッセージ上の対象ヘッダー（`headername`）の値に評価されます。
LongDate	システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。
ShortDate	システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。
DateFormat:format	システムの現在の日時を指定された形式（`format`）で評価します。利用可能な日時形式については、[日付形式のサンプル](https://docs.arc.cdata.com/26.4/cloud/ja/scripting/value-formatters/date-formatters.md#date-formats-with-literal-characters)を参照してください。
Vault:vaultitem	指定されたVault アイテムの値に評価されます。