# Formatos de saída

O COM Agent pode escrever cada medição concluída num ficheiro. Escolha uma **Pasta de saída** e assinale um ou mais **Formatos de saída**. Os formatos podem ser combinados livremente.

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

## Pasta de saída

Clique em **Procurar…** junto a *Pasta de saída* e escolha onde os ficheiros devem ser escritos. Cada medição cria um novo ficheiro com um nome único e com data/hora, pelo que nada é alguma vez substituído:

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

O nome contém a data/hora UTC, um contador sequencial e um identificador único.

## Formatos

| Formato | O que produz |
| --- | --- |
| **Ficheiro de texto (.txt)** | Os dados em bruto exatamente como recebidos do instrumento, sem qualquer processamento. Funciona para todos os instrumentos. |
| **Ficheiro CSV (.csv)** | Um ficheiro de folha de cálculo estruturado com colunas nomeadas e unidades métricas. Requer um formato de dados reconhecido (atualmente o formato de espessura *"print all samples"* do FT3). |
| **Emulação de teclado** | Escreve os valores noutra aplicação em vez de criar um ficheiro — consulte [Emulação de teclado](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Pode ativar vários formatos ao mesmo tempo. Por exemplo, assinale **Texto** e **CSV** para manter um arquivo em bruto juntamente com um ficheiro estruturado, ou assinale **CSV** e **Teclado** para arquivar os dados *e* escrever um valor no seu sistema de qualidade.

## Opções de exportação CSV

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

Quando o **CSV** está ativado, surge um painel **Opções de CSV** com quatro definições que controlam a forma como o ficheiro é escrito. O COM Agent escolhe valores predefinidos sensatos com base no seu idioma e região, pelo que, na maioria dos casos, pode deixá-los como estão.

| Opção | Escolhas | Efeito |
| --- | --- | --- |
| **Delimitador** | Vírgula "," · Ponto e vírgula ";" · Tabulação "→" | O carácter colocado entre as colunas. |
| **Formato de hora** | ISO 8601, UTC · ISO 8601, local | Formato da coluna *Timestamp*: UTC (p. ex. `2025-10-11T11:03:56Z`) ou hora local com desvio (p. ex. `2025-10-11T13:03:56+02:00`). |
| **Separador decimal** | Ponto "." · Vírgula "," | O sinal decimal utilizado nos valores numéricos. As datas e os identificadores nunca são alterados. |
| **Codificação do ficheiro** | UTF-8 · UTF-8 com BOM | Se é escrita uma marca de ordem de bytes no início do ficheiro. Uma BOM ajuda alguns programas de folha de cálculo (por exemplo o Excel) a detetar o UTF-8 e a mostrar corretamente os cabeçalhos em µm. |

> [!tip] O **Delimitador** e o **Separador decimal** assumem por predefinição a convenção da sua região: as regiões que separam os valores de uma lista com um ponto e vírgula (a maior parte da Europa) começam com **ponto e vírgula + vírgula decimal**, as restantes (por exemplo o inglês) com **vírgula + ponto decimal**. Isto permite que o ficheiro abra corretamente com um duplo clique no seu programa de folha de cálculo local. Depois de alterar uma definição, a sua escolha é memorizada.

## Estrutura do CSV

Para o formato de espessura do FT3, o COM Agent produz uma linha por cada amostra individual, juntamente com as estatísticas de resumo e os metadados do instrumento. As unidades são indicadas em micrómetros (µm).

| Coluna | Exemplo | Significado |
| --- | --- | --- |
| Index | 1 | Número da amostra dentro do conjunto |
| Measurement (µm) | 1090.9 | A leitura da amostra individual |
| Min (µm) | 1088.4 | Mínimo do conjunto |
| Max (µm) | 1090.9 | Máximo do conjunto |
| Mean (µm) | 1089.4 | Média do conjunto |
| StdDev (µm) | 0.990 | Desvio padrão do conjunto |
| Template | 10 | O formato de dados do instrumento |
| Device_ID | FTG38041012H | Número de série / ID do instrumento |
| Test_Date | 2025-10-07 | Data do ensaio (ISO 8601) |
| Calibration_Date | 2025-10-11 | Data da última calibração |
| Test_Time | 11:03:56 | Hora do ensaio |
| Sample_Count | 5 | Número de amostras no conjunto |
| Timestamp | 2025-10-11T11:03:56Z | Quando o COM Agent recebeu o conjunto, no *Formato de hora* escolhido |

> [!info] Os valores próprios do instrumento *Test_Date* / *Test_Time* provêm do relógio do dispositivo e não têm fuso horário. A coluna **Timestamp** é o momento em que o seu PC recebeu o conjunto, pelo que reflete a opção *Formato de hora* (UTC ou local).

> [!info] Se o COM Agent receber dados que não reconheça como um formato estruturado, o ficheiro CSV é ignorado para essa medição e surge uma nota no registo de atividade. A saída **TXT** em bruto (se ativada) é sempre escrita, independentemente do formato.

[Seguinte: escrever valores noutra aplicação](rhopoint-com-agent-keyboard-emulation.md)