# 出力形式

COM Agent は、完了した各測定値をファイルに書き出すことができます。**出力フォルダー** を選択し、1 つ以上の **出力形式** にチェックを入れます。形式は自由に組み合わせられます。

![](../_images/com-agent-output-formats-ja.png)

## 出力フォルダー

*出力フォルダー* の横にある **参照…** をクリックし、ファイルの書き出し先を選択します。測定のたびに、一意のタイムスタンプ付きの名前で新しいファイルが作成されるため、既存のファイルが上書きされることはありません。

```
2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv
```

この名前には、UTC タイムスタンプ、連番カウンター、一意の識別子が含まれます。

## 形式

| 形式 | 生成される内容 |
| --- | --- |
| **テキストファイル (.txt)** | 計測器から受信したままの生データで、処理は行われません。すべての計測器で動作します。 |
| **CSV ファイル (.csv)** | 名前付きの列とメートル単位を備えた、構造化されたスプレッドシートファイルです。認識されたデータ形式 (現在は FT3 の *「全サンプル印刷」* 膜厚形式) が必要です。 |
| **キーボードエミュレーション** | ファイルに書き出す代わりに、値を別のアプリケーションに入力します — [キーボードエミュレーション](rhopoint-com-agent-keyboard-emulation.md) を参照。 |

> [!info] 複数の形式を同時に有効にできます。たとえば、**テキスト** と **CSV** にチェックを入れて生データのアーカイブと構造化ファイルの両方を保持したり、**CSV** と **キーボード** にチェックを入れてデータをファイルに保存 *しつつ* QA システムに値を入力したりできます。

## CSV エクスポートオプション

![](../_images/com-agent-csv-options-ja.png)

**CSV** を有効にすると、ファイルの書き出し方法を制御する 4 つの設定を備えた **CSV オプション** パネルが表示されます。COM Agent はお使いの言語と地域から適切な既定値を選ぶため、ほとんどの場合はそのままにしておけます。

| オプション | 選択肢 | 効果 |
| --- | --- | --- |
| **区切り文字** | カンマ "," · セミコロン ";" · タブ "→" | 列と列の間に置かれる文字。 |
| **時刻形式** | ISO 8601, UTC · ISO 8601, ローカル | *Timestamp* 列の形式: UTC (例: `2025-10-11T11:03:56Z`) またはオフセット付きのローカル時刻 (例: `2025-10-11T13:03:56+02:00`)。 |
| **小数点記号** | ピリオド "." · カンマ "," | 数値に使用される小数点の記号。日付や識別子は変更されません。 |
| **ファイルエンコード** | UTF-8 · UTF-8, BOM 付き | ファイルの先頭にバイトオーダーマークを書き込むかどうか。BOM は一部のスプレッドシートプログラム (例: Excel) が UTF-8 を検出し、µm の見出しを正しく表示するのに役立ちます。 |

> [!tip] **区切り文字** と **小数点記号** は、既定でお使いの地域の慣習に従います。リストの値をセミコロンで区切る地域 (ヨーロッパの大部分) は **セミコロン + カンマ小数点** で始まり、それ以外 (例: 英語) は **カンマ + ピリオド小数点** で始まります。これにより、ローカルのスプレッドシートプログラムでダブルクリックするだけでファイルがきれいに開きます。設定を変更すると、その選択が記憶されます。

## CSV の構造

FT3 膜厚形式の場合、COM Agent は個々のサンプルごとに 1 行を生成し、併せて集計統計と計測器のメタデータを出力します。単位はマイクロメートル (µm) で示されます。

| Column | 例 | 意味 |
| --- | --- | --- |
| Index | 1 | セット内のサンプル番号 |
| Measurement (µm) | 1090.9 | 個々のサンプルの測定値 |
| Min (µm) | 1088.4 | セットの最小値 |
| Max (µm) | 1090.9 | セットの最大値 |
| Mean (µm) | 1089.4 | セットの平均値 |
| StdDev (µm) | 0.990 | セットの標準偏差 |
| Template | 10 | 計測器のデータ形式 |
| Device_ID | FTG38041012H | 計測器のシリアル番号 / ID |
| Test_Date | 2025-10-07 | 試験日 (ISO 8601) |
| Calibration_Date | 2025-10-11 | 前回の校正日 |
| Test_Time | 11:03:56 | 試験時刻 |
| Sample_Count | 5 | セット内のサンプル数 |
| Timestamp | 2025-10-11T11:03:56Z | COM Agent がセットを受信した時刻。選択した *時刻形式* で表示 |

> [!info] 計測器自身の *Test_Date* / *Test_Time* は装置の時計に由来し、タイムゾーンを持ちません。**Timestamp** 列はお使いの PC がセットを受信した時点であり、*時刻形式* オプション (UTC またはローカル) を反映します。

> [!info] COM Agent が構造化形式として認識できないデータを受信した場合、その測定値については CSV ファイルがスキップされ、アクティビティログにメモが表示されます。生の **TXT** 出力 (有効な場合) は、形式に関わらず常に書き出されます。

[次へ: 別のアプリケーションに値を入力する](rhopoint-com-agent-keyboard-emulation.md)