Anexo D: Formatos de ficheiros de publicação SFTP e HTTPS

Publicação CSV

A tabela a seguir fornece os detalhes de cada linha do ficheiro .csv, com dados de exemplo:

Linha	Dados no ficheiro .csv	Descrição
1	`Gateway Name,Gateway SN,Gateway IP Address,Gateway MAC Address,Device Name,Device Local ID,Device Type ID,Device Type Name,Logging Interval,Historical Intervals`	Esta linha contém os cabeçalhos das colunas para as informações fornecidas na linha 2: `Gateway Name`: nome atribuído ao Panel Server durante a colocação em funcionamento `Gateway SN`: número de série do Panel Server `Gateway IP`: Endereço IP do Panel Server `Gateway MAC Address`: Endereço MAC do Panel Server `Device Name`: nome atribuído ao dispositivo durante a colocação em funcionamento `Device Local ID`: referência do dispositivo registado, exclusiva no Panel Server `Device Type ID`: modelo do dispositivo `Device Type Name`: modelo do dispositivo `Logging Interval`: período de amostragem expresso em minutos `Historical Intervals`: número total de linhas de dados registados neste ficheiro
2	`Device TypeEcoStruxure Panel Server,542206310926,10.195.253.81,00:00:54:E5:8A:36,F160 3P 3P+N,modbus:1_mb_81,F160 3P 3P+N,F160 3P 3P+N,5,7`	Esta linha contém informações sobre o Panel Server que criou o ficheiro e o dispositivo a jusante a partir do qual foram recolhidas as medições.
3	–	–
4	`,,,Topic ID1,Topic ID2`	Esta linha contém os cabeçalhos de coluna para os ID de tópico. Um ID de tópico é uma referência à quantidade que vai ser registada. O nome atribuído a uma quantidade pode variar consoante os dispositivos e idiomas. Os ID de tópico são utilizados para identificar a quantidade, independentemente do dispositivo ou idioma. Os ID de tópico são exclusivos no Panel Server. NOTA: As 3 primeiras vírgulas são utilizadas para fins de esquema numa aplicação de folha de cálculo.
5	`,,,"modbus:1_mb_VAB","modbus:1_mb_VAN"`	Esta linha contém os ID de tópico das medições registadas.
6	–	–
7	`Error,UTC Offset (minutes),Local Time Stamp,RmsVoltagePhsAB (V),RmsVoltagePhsAN (V)`	Esta linha contém os cabeçalhos das colunas dos dados registados nas linhas 8 e seguintes: `Error`: `0` para o sucesso, `19` quando pelo menos uma medida era inválida ou não estava disponível para amostragem (`NaN`). `UTC Offset (minutes)`: desvio do carimbo de data/hora local do fuso horário UTC. `Local Time Stamp`: data e hora das amostras A partir do quarto ponto em seguida, cada medida é descrita pelo respetivo nome e unidade (caso sejam conhecidos).
8 e mais	`0,0,2022-11-04 08:10:00,127.80000305,235.3999939` `0,0,2022-11-04 08:15:00,128.1000061,235.69999695` `0,0,2022-11-04 08:20:00,127.69999695,234.8999939`	Estas linhas contêm os dados registados.

Publicação JSON

A tabela seguinte fornece uma explicação do conteúdo do ficheiro .json, cujo exemplo de conteúdo é retirado do ficheiro de exemplo para ilustrar.

@MOP and SMEs: Review the table. I think it would be easier to give an example file that contains measurements (rather than a Digital input) to make the table easier to understand.

Dados no ficheiro json	Descrição	Exemplo
valueItemId	Nome do dispositivo e medição/evento. O nome do dispositivo utilizado no ficheiro .json é um nome interno. Para obter a correspondência entre este nome e o nome do dispositivo listado no Panel Server, siga o procedimento para exportar todos os registos. O ficheiro diagnostic_topology.txt nos registos exportados lista os nomes dos dispositivos e os nomes internos.	Io_block:7_iod_827_DO1indica o dispositivo de E/S número 7 e o registo das ações na Entrada digital 1
timestamp	Referência temporal do início do período de amostragem	2023-03-28T08:13:00Z
v	Medição/evento	Open
t	Deslocamento de tempo em ms a adicionar à referência de tempo	120000 ms = 120 s = 2 min, por isso a amostra recolhida a 08,13 + 2 min = 08,15
s	Medição inválida	false

As seguintes linhas fornecem um exemplo de um ficheiro .json com dados que consistem numa lista de duas séries de tempo com uma coleção de vários registos: