Generación de informes externos
Exporta los datos de tus plantas desde Mirox a tu propio proceso de elaboración de informes, para crear informes con tu propia marca, alimentar herramientas de inteligencia de negocio o cumplir con un formato que los informes integrados no cubren.
Abrir en Mirox
Exportación de datos ▸ Plantillas para elegir o crear las columnas de tu informe, y después Exportación de datos ▸ Constructor de API para el enlace que lee tu herramienta.
¿Por qué crear informes fuera de Mirox?
Mirox tiene sus propios informes, con plantillas, capítulos, tu logotipo y cinco formatos de descarga. Exportar los datos tiene sentido cuando:
- Diseño: necesitas un diseño o una imagen de marca que va más allá de lo que ofrece el diseño del informe.
- Otros datos: combinas datos de Mirox con datos de otros sistemas en un mismo informe.
- Tus herramientas: tu organización trabaja con plantillas de Power BI, Tableau o Excel.
- Normativa: un informe tiene que seguir un formato o un cálculo prescritos.
- Flujo de trabajo: los informes tienen que pasar por un proceso documental o de aprobación existente.
Qué puedes exportar
| Datos | Cómo | Formato |
|---|---|---|
| Métricas como series temporales: producción, irradiación, disponibilidad, pérdidas, por planta, componente, sensor, aerogenerador o nivel de batería | Metric Export | CSV, JSON |
| Información de la planta: datos maestros, ubicación, potencia pico | Información de la planta | JSON |
| Eventos: con periodo y prioridad | Eventos | CSV |
| Un informe terminado con todas sus tablas | descarga Excel, CSV o JSON de un informe | Excel, CSV (ZIP), JSON |
El camino hasta un enlace de informe
- Elige las columnas. Abre Exportación de datos ▸ Plantillas. Usa una plantilla del sistema como Informe técnico, o crea una plantilla con las métricas que necesita tu informe. Una plantilla mantiene fijas las columnas y su orden, de modo que el programa que lee el archivo sigue siendo estable.
- Obtén el enlace. Abre Exportación de datos ▸ Constructor de API, elige la plantilla y las plantas, y fija el periodo y el paso. La página muestra el enlace y una vista previa.
- Elige ids como encabezados de columna si el archivo lo lee un programa. Los ids no cambian cuando una métrica cambia de nombre o cambia el idioma.
- Crea un token. Probar crea un token de API del grupo Metric Export y muestra comandos listos para usar.
- Lee el enlace desde tu herramienta, con la periodicidad que necesites. Un enlace con el periodo Mes anterior entrega cada vez el mes completo más reciente.
Varias plantas en una solicitud
Un enlace cubre varias plantas o portfolios enteros, combinados en una columna por métrica o con una columna por planta. Consulta Varias plantas.
Plantillas heredadas
Una plantilla creada antes de Metric Export lleva la etiqueta Legado en la pestaña Plantillas. Su enlace sigue funcionando y entrega las mismas columnas que antes. Convertir en plantilla nueva crea una plantilla nueva a partir de ella sin modificar la heredada, de modo que puedes cambiar tu informe cuando te convenga. Consulta Plantillas heredadas y conversión.
Ruta obsoleta
La ruta para una sola planta bajo /v1/export/report/{park_uid}/data/template/… está obsoleta. Usa GET /v1/export/series/template/{template_uid} para las plantillas de Metric Export, o GET /v1/export/metrics/template/{template_uid} para las plantillas heredadas.
Ejemplos
- Generador de informes externos: las solicitudes con curl, y un script completo en Python que crea un informe en PDF.
- Metric Export para Excel: enlaces listos para usar y la conexión de Power Query para libros que se actualizan solos.
Buenas prácticas
- Mantén los tokens fuera de los archivos. Carga el token desde una variable de entorno, y usa un token del grupo Metric Export, que puede leer exportaciones y nada más.
- Pide ids como encabezados de columna en todo lo que lea un programa.
- Usa los mismos periodos en todos los informes que se comparan entre sí.
- Trata las celdas vacías como «sin datos». La exportación deja una celda vacía cuando no hay valor; nunca escribe cero en su lugar.
- Lee las notas. Te dicen qué ha hecho Mirox por su cuenta, por ejemplo que se omitió una planta que no puedes leer. Consulta Notas.
- Contrasta con Mirox. Compara una vez las cifras de un informe nuevo con las páginas de Mirox.
Cosas que conviene saber
- Una exportación tiene un tamaño acotado. Una exportación grande se divide por tiempo, planta o métrica: consulta Cuando una exportación es demasiado grande.
- Los datos se remontan hasta donde la planta se ha medido, como muy pronto a 2020.
- Los archivos son UTF-8. Algunas herramientas necesitan que se indique la codificación al importar.
El separador de columnas y el separador decimal deben ser distintos
Tú eliges el separador de columnas y el separador decimal. No deben ser el mismo carácter. Los valores predeterminados (; y ,) se adaptan a herramientas con configuración regional alemana.
Si echas algo en falta en la exportación, escribe a support@mirox.io.
Funciones relacionadas
- Metric Export: la página Exportación de datos
- API de Metric Export: todos los parámetros, límites y errores
- API de exportación heredada: los enlaces anteriores, la información de la planta y los eventos
- Informes: los informes que genera el propio Mirox
- Uso de tokens de API: crea el token que usan tus herramientas