# Output Formats

COM Agent può scrivere ogni misurazione completata in un file. Scegli una **Cartella di uscita** e seleziona uno o più **Formati di uscita**. I formati possono essere combinati liberamente.

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

## Cartella di uscita

Fai clic su **Sfoglia…** accanto a *Cartella di uscita* e scegli dove scrivere i file. Ogni misurazione crea un nuovo file con un nome univoco e con marca temporale, in modo che nulla venga mai sovrascritto:

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

Il nome contiene la marca temporale UTC, un contatore progressivo e un identificatore univoco.

## Formati

| Formato | Cosa produce |
| --- | --- |
| **File di testo (.txt)** | I dati grezzi esattamente come ricevuti dallo strumento, senza alcuna elaborazione. Funziona per ogni strumento. |
| **File CSV (.csv)** | Un file strutturato per fogli di calcolo con colonne denominate e unità metriche. Richiede un formato di dati riconosciuto (attualmente il formato di spessore FT3 *"print all samples"*). |
| **Emulazione tastiera** | Digita i valori in un'altra applicazione invece di scrivere un file — vedi [Emulazione tastiera](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Puoi abilitare più formati contemporaneamente. Ad esempio, seleziona **Testo** e **CSV** per conservare un archivio grezzo insieme a un file strutturato, oppure seleziona **CSV** e **Tastiera** per archiviare i dati *e* digitare un valore nel tuo sistema di controllo qualità.

## Opzioni di esportazione CSV

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

Quando **CSV** è abilitato, compare un pannello **Opzioni CSV** con quattro impostazioni che controllano come viene scritto il file. COM Agent sceglie valori predefiniti sensati in base alla tua lingua e regione, quindi nella maggior parte dei casi puoi lasciarli invariati.

| Opzione | Scelte | Effetto |
| --- | --- | --- |
| **Delimitatore** | Virgola "," · Punto e virgola ";" · Tabulazione "→" | Il carattere posto tra le colonne. |
| **Formato ora** | ISO 8601, UTC · ISO 8601, locale | Formato della colonna *Timestamp*: UTC (ad es. `2025-10-11T11:03:56Z`) oppure ora locale con offset (ad es. `2025-10-11T13:03:56+02:00`). |
| **Separatore decimale** | Punto "." · Virgola "," | Il segno decimale usato per i valori numerici. Le date e gli identificatori non vengono mai modificati. |
| **Codifica del file** | UTF-8 · UTF-8 con BOM | Se all'inizio del file viene scritto un byte-order mark. Un BOM aiuta alcuni programmi di fogli di calcolo (ad esempio Excel) a rilevare l'UTF-8 e a mostrare correttamente le intestazioni in µm. |

> [!tip] **Delimitatore** e **Separatore decimale** adottano per impostazione predefinita la convenzione della tua regione: le regioni che separano i valori di un elenco con un punto e virgola (la maggior parte dell'Europa) partono con **punto e virgola + virgola decimale**, le altre (ad esempio l'inglese) con **virgola + punto decimale**. In questo modo il file si apre correttamente con un doppio clic nel tuo programma di fogli di calcolo locale. Una volta che modifichi un'impostazione, la tua scelta viene memorizzata.

## Struttura CSV

Per il formato di spessore FT3, COM Agent produce una riga per ogni singolo campione, insieme alle statistiche riepilogative e ai metadati dello strumento. Le unità sono espresse in micrometri (µm).

| Column | Esempio | Significato |
| --- | --- | --- |
| Index | 1 | Numero del campione all'interno del set |
| Measurement (µm) | 1090.9 | La lettura del singolo campione |
| Min (µm) | 1088.4 | Minimo del set |
| Max (µm) | 1090.9 | Massimo del set |
| Mean (µm) | 1089.4 | Media del set |
| StdDev (µm) | 0.990 | Deviazione standard del set |
| Template | 10 | Il formato dei dati dello strumento |
| Device_ID | FTG38041012H | Numero di serie / ID dello strumento |
| Test_Date | 2025-10-07 | Data del test (ISO 8601) |
| Calibration_Date | 2025-10-11 | Data dell'ultima calibrazione |
| Test_Time | 11:03:56 | Ora del test |
| Sample_Count | 5 | Numero di campioni nel set |
| Timestamp | 2025-10-11T11:03:56Z | Quando COM Agent ha ricevuto il set, nel *Formato ora* scelto |

> [!info] I valori propri dello strumento *Test_Date* / *Test_Time* provengono dall'orologio del dispositivo e non hanno fuso orario. La colonna **Timestamp** è il momento in cui il tuo PC ha ricevuto il set, quindi riflette l'opzione *Formato ora* (UTC o locale).

> [!info] Se COM Agent riceve dati che non riconosce come formato strutturato, il file CSV viene saltato per quella misurazione e nel registro attività compare una nota. L'uscita **TXT** grezza (se abilitata) viene sempre scritta indipendentemente dal formato.

[Avanti: digita i valori in un'altra applicazione](rhopoint-com-agent-keyboard-emulation.md)