CSV Connector

The CSV connector converts comma-separated values (CSV) files into XML and generates CSV files from XML.

Key Capabilities

Bidirectional CSV/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 コネクタの使用がベストプラクティスです。

Message

Message 設定は、コネクタがメッセージを検索する方法と、処理後にメッセージを管理する方法を決定します。

Note： 以下の設定は非推奨となり、デフォルトで非表示になっています。以前に有効化またはデフォルト以外の値に設定されていたコネクタにのみ表示されます。処理済みファイルのコピーを保持するには、フロー内のコネクタを右クリックし、成功パスを表示を選択して、成功パスをFile コネクタに接続してください。

設定	説明
Sent フォルダに保存（非推奨）	コネクタが処理したファイルをSent フォルダにコピーします。デフォルトで無効です。Sent フォルダに保存されたファイルは保存データの暗号化の対象外です。
Sent フォルダのスキーム（非推奨）	選択した時間間隔でSent フォルダ内のファイルをグループ化します。Sent フォルダに保存が有効な場合のみ適用されます。

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	コネクタに到着したメッセージを自動的に処理するかどうか。

Performance

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

設定	説明
Max Workers	このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
Max Files	コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。

Alerts Tab

SLAs Tab

Converting CSV to XML

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

<Items>
  <Record>
    <field_0></field_0>
    <field_1></field_1>
    <field_2></field_2>
  </Record>
</Items>

元のファイルの各行（レコード）は、ルート要素 Items の子になります。すべてのレコード要素の名前は、コネクタ設定で設定された Record Name オプションによって決定されます。各レコード要素は、入力ファイルの各行の値に対応する子要素を持ちます。一部の CSV ファイルには、ファイル内の値にコンテキストを提供するヘッダー情報の行が含まれています。First line is header information 設定が有効になっている場合、このヘッダー行が解析され、解析されたヘッダーが値要素（レコード要素の子）の要素名として使用されます。それ以外の場合、値要素には field_0、field_1 のような汎用的な名前が付けられます。

Converting XML to CSV

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

<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 オプションが有効になっている場合、値にコンテキストを提供するために、各値要素の名前を含むヘッダー行が、生成される CSV ファイルに挿入されます。上記の例では、このヘッダー行は title、year、runtime で構成されます。

Print View

CSV Transformation: Using the XML Map Connector

CSV Operations

Arc に付属する操作に加えて、コネクタは ArcScript に機能を拡張する操作を提供できます。これらのコネクタ操作は、他の ArcScript 操作と同じように呼び出すことができますが、次の2点が異なります。

connector.rsc エンドポイントを介して呼び出す必要があります。
認証トークンを含める必要があります。

たとえば、これら両方のルールを使用してコネクタ操作を呼び出す場合は、次のようになります。

<arc:set attr="in.myInput" value="myvalue" />
<arc:call op="connector.rsc/opName" authtoken="admin:1j9P8v8b9K0x6g5R5t7k" in="in" out="out">
  <!-- handle output from the op here -->
</arc:call>

Operations specific to the functionality of the CSV connector are listed below.

csvListRecords

Loops over every record in a specified CSV file or string. See Functions for more details.

Required Parameters

file: The path to the CSV file.

Optional Parameters

data: If the CSV data exists as a string rather than stored in a CSV file, use this parameter instead of file.
columns: The comma-separated list of columns to include in the output (if unspecified, all columns are included).
requireheader: By default, the first row of data is interpreted as column headers; pass false to this parameter to use generic column names (for example, c1, c2, c3).

Output

Any script in a csvListRecords operation executes multiple times: once for each record/row in the input CSV file/data. Within the operation, individual CSV values are accessible using the csv formatter. This formatter takes a column name as a parameter, and outputs the value in that column for the current record. For example, imagine the CSV input data contains a set of items purchased in an order, and the name of the item is held in the ItemName column. The following script generates XML containing each ItemName value in an Item element:

<ItemList>
  <arc:call op="csvListRecords?file=myFile.csv">
    <Item>[csv('ItemName')]</Item>
  </arc:call>
</ItemList>

はじめに

フロー

EDI トレーディングパートナー管理コンソール

コネクタ

マッピング

API と自動化

ハウツーガイド

スクリプティング

ソフトウェアライセンスとサードパーティ著作権

Key Capabilities

Overview

Connector Configuration

Settings Tab

Configuration

Connector Settings

Other Settings

Sample Files Tab

Advanced Tab

Message

Logging

Miscellaneous

Automation Tab

Automation Settings

Performance

Alerts Tab

SLAs Tab

Converting CSV to XML

Converting XML to CSV

Print View

CSV Transformation: Using the XML Map Connector

CSV Operations

csvListRecords

Required Parameters

Optional Parameters

Output

Macros

Examples

​Key Capabilities

​Overview

​Connector Configuration

​Settings Tab

​Configuration

​Connector Settings

​Other Settings

​Sample Files Tab

​Advanced Tab

​Message

​Logging

​Miscellaneous

​Automation Tab

​Automation Settings

​Performance

​Alerts Tab

​SLAs Tab

​Converting CSV to XML

​Converting XML to CSV

​Print View

​CSV Transformation: Using the XML Map Connector

​CSV Operations

​csvListRecords

​Required Parameters

​Optional Parameters

​Output

​Macros

​Examples

Key Capabilities

Overview

Connector Configuration

Settings Tab

Configuration

Connector Settings

Other Settings

Sample Files Tab

Advanced Tab

Message

Logging

Miscellaneous

Automation Tab

Automation Settings

Performance

Alerts Tab

SLAs Tab

Converting CSV to XML

Converting XML to CSV

Print View

CSV Transformation: Using the XML Map Connector

CSV Operations

csvListRecords

Required Parameters

Optional Parameters

Output

Macros

Examples