Geração externa de relatórios

Exporte os dados das suas centrais do Mirox para o seu próprio processo de relatórios, para criar relatórios com a sua própria imagem, alimentar ferramentas de business intelligence ou cumprir um formato que os relatórios integrados não cobrem.

Abrir no Mirox

Exportação de dados ▸ Modelos para escolher ou criar as colunas do seu relatório, e depois Exportação de dados ▸ Construtor de API para a ligação que a sua ferramenta lê.

Porquê criar relatórios fora do Mirox?

O Mirox tem relatórios próprios, com modelos, capítulos, o seu logótipo e cinco formatos de transferência. Exportar os dados faz sentido quando:

  1. Apresentação — precisa de uma apresentação ou de uma imagem de marca para além do que o design do relatório oferece.
  2. Outros dados — combina dados do Mirox com dados de outros sistemas num só relatório.
  3. As suas ferramentas — a sua organização trabalha com modelos de Power BI, Tableau ou Excel.
  4. Regulamentação — um relatório tem de seguir um formato ou um cálculo prescrito.
  5. Fluxo de trabalho — os relatórios têm de passar por um processo documental ou de aprovação existente.

O que pode exportar

DadosComoFormato
Métricas como séries temporais — produção, irradiação, disponibilidade, perdas, por central, componente, sensor, turbina ou nível de bateriaExportação de métricasCSV, JSON
Informações da central — dados base, localização, potência de picoInformações da centralJSON
Eventos — com período e prioridadeEventosCSV
Um relatório concluído com todas as suas tabelastransferência Excel, CSV ou JSON de um relatórioExcel, CSV (ZIP), JSON

O caminho até uma ligação de relatório

  1. Escolha as colunas. Abra Exportação de dados ▸ Modelos. Use um modelo do sistema, como o Relatório técnico, ou crie um modelo com as métricas de que o seu relatório precisa. Um modelo mantém fixas as colunas e a sua ordem, pelo que o programa que lê o ficheiro se mantém estável.
  2. Obtenha a ligação. Abra Exportação de dados ▸ Construtor de API, escolha o modelo e as centrais, e defina o período e o passo. A página mostra a ligação e uma pré-visualização.
  3. Escolha IDs como cabeçalhos das colunas se for um programa a ler o ficheiro. Os IDs não mudam quando uma métrica muda de nome ou o idioma muda.
  4. Crie um token. Experimentar cria um token de API do grupo Metric Export e mostra comandos prontos a usar.
  5. Leia a ligação a partir da sua ferramenta, com a periodicidade de que precisa. Uma ligação com o período Mês anterior fornece sempre o mês completo mais recente.

Várias centrais num só pedido

Uma ligação abrange várias centrais ou carteiras inteiras, combinadas numa coluna por métrica ou com uma coluna por central. Consulte Várias centrais.

Modelos legados

Um modelo criado antes da exportação de métricas tem a marca Legado no separador Modelos. A sua ligação continua a funcionar e fornece as mesmas colunas de antes. Converter em novo modelo cria um novo modelo a partir dele sem alterar o legado, pelo que pode mudar o seu relatório quando lhe convier. Consulte Modelos legados e conversão.

Rota obsoleta

A rota para uma só central em /v1/export/report/{park_uid}/data/template/… está obsoleta. Use GET /v1/export/series/template/{template_uid} para os modelos da exportação de métricas, ou GET /v1/export/metrics/template/{template_uid} para os modelos legados.

Exemplos

Boas práticas

  1. Mantenha os tokens fora dos ficheiros. Carregue o token a partir de uma variável de ambiente, e use um token do grupo Metric Export, que pode ler exportações e nada mais.
  2. Peça IDs como cabeçalhos das colunas em tudo o que um programa lê.
  3. Use os mesmos períodos em todos os relatórios que são comparados entre si.
  4. Trate as células vazias como «sem dados». A exportação deixa uma célula vazia quando não há valor; nunca escreve zero no seu lugar.
  5. Leia as notas. Dizem-lhe o que o Mirox fez por iniciativa própria, por exemplo que uma central que não pode ler ficou de fora. Consulte Notas.
  6. Compare com o Mirox. Compare uma vez os valores de um novo relatório com as páginas no Mirox.

O que convém saber

  • Uma exportação tem tamanho limitado. Uma exportação grande é dividida por tempo, central ou métrica — consulte Quando uma exportação é demasiado grande.
  • Os dados recuam até onde a central foi medida, no mínimo até 2020.
  • Os ficheiros estão em UTF-8. Algumas ferramentas precisam de que a codificação seja indicada na importação.

O separador de colunas e o separador decimal têm de ser diferentes

Escolhe o separador de colunas e o separador decimal. Não podem ser o mesmo carácter. As predefinições (; e ,) são adequadas a ferramentas com definições regionais alemãs.

Se faltar alguma coisa na exportação, escreva para support@mirox.io.