Formato de ficheiro das publicações

Apresentação

O formato de ficheiro dos ficheiros publicados depende do método de publicação escolhido:

Serviços em nuvem da Schneider: formato de ficheiro json
SFTP e HTTPS: selecione o formato de ficheiro json ou csv nas páginas Web do Panel Server

Formato de ficheiro da publicação CSV

Um ficheiro .csv contém:

Dados relativos a um único dispositivo a jusante
Todas as medições configuradas com o mesmo período de amostragem para esse dispositivo
Dados de um máximo de 24 horas de amostragem

O nome dos ficheiros CSV que são exportados segue a convenção de nomenclatura ReducedID_DeviceName_DateTime_IndexNumber.csv em que:

ReducedID
é o identificador interno do dispositivo, que garante que os ficheiros produzidos são únicos para dispositivos que partilham o mesmo nome (por exemplo, 10_mb, 21_zd).
DeviceName é o nome atribuído ao dispositivo a jusante.
DateTime é o carimbo de data/hora que corresponde ao momento em que o ficheiro foi publicado, expresso ao milissegundo no formato AAAAMMDDhmmssSSS.
IndexNumber no formato _<nn> indica o número do ficheiro no número total de ficheiros para uma única publicação (o mesmo ID, o mesmo nome do dispositivo e o mesmo carimbo de data/hora). Se existirem 20 ficheiros na publicação, estão numerados de _1 a _20.
São permitidos apenas os seguintes carateres no nome de ficheiro .csv: UTF-8 e ASCII básico (32 a 7F, excluindo \ / : * ? " < > |). Os carateres não suportados são substituídos por ~.

Exemplo: Tendo em conta o seguinte nome de ficheiro:
11_mb_F160 3P 3P+N_202412161020_19.csv em que:

ReducedID é 11_mb.
DeviceName é F160 3P 3P+N, o nome do dispositivo.
NOTA: Este nome é o valor predefinido (modelo do produto) se o utilizador não o tiver atualizado.
DataHora é 202412161020, o que significa que o ficheiro foi publicado a 16 de dezembro de 2024 às 10h20.
Número de índice é _19, o que significa que o ficheiro é o 19.º ficheiro na publicação.

O conteúdo do ficheiro .csv só fornece suporte à codificação de carateres padrão UTF-8 para o nome do dispositivo, nome do evento, nome da medição e nome do ficheiro.

As aspas em todos os campos de dados do ficheiro .csv ajudam a garantir a compatibilidade com carateres especiais.

Para obter detalhes e exemplos do ficheiro .csv, consulte Anexo D Formatos de ficheiros de publicação SFTP e HTTPS.

Formato de ficheiro da publicação JSON

Um ficheiro .json contém medições de vários dispositivos a jusante configurados com o mesmo período de amostragem.

Cada ficheiro contém os dados de 24 horas de amostragem, até um limite de 256 KB de dados.

O nome do ficheiro JSON exportado segue a convenção de nomenclatura DateTime_IndexNumber.json em que:

DateTime é o carimbo de data/hora que corresponde ao momento em que o ficheiro foi publicado, expresso ao milissegundo no formato AAAAMMDDhmmssSSS.
IndexNumber no formato _<nn> indica o número do ficheiro no número total de ficheiros para uma única publicação (o mesmo ID, o mesmo nome do dispositivo e o mesmo carimbo de data/hora). Se existirem 20 ficheiros na publicação, estão numerados de _1 a _20.

Para obter um exemplo de um ficheiro .json, consulte Anexo D Formatos de ficheiros de publicação SFTP e HTTPS.