Generación de informes externos
Exporte los datos de su planta desde Mirox a su propia canalización de informes, para poder crear informes con marca propia, alimentar herramientas de inteligencia de negocio o cumplir un formato normativo que los informes integrados no cubren. Esta guía explica qué capacidades de exportación utilizar cuando necesita generar informes fuera de la plataforma.
Abrir en Mirox: Exportación de datos ▸ Generador — abra la página de exportación de datos y seleccione la pestaña Generador para ensamblar una exportación de forma interactiva, o cambie a la pestaña Plantillas para reutilizar un diseño de columnas guardado.
¿Por qué utilizar la generación de informes externos?
La plataforma ofrece informes integrados, pero exportar datos a su propia canalización tiene sentido cuando:
- Personalización avanzada — necesita un formato o una marca específicos que van más allá de las opciones de informes integradas.
- Integración de datos — desea combinar los datos de Mirox con información de otros sistemas en un único informe.
- Herramientas de inteligencia de negocio — su organización ya utiliza herramientas como Power BI, Tableau o plantillas personalizadas de Excel.
- Requisitos normativos — debe generar informes que sigan un formato o un cálculo normativo específico.
- Integración en el flujo de trabajo — los informes deben encajar en un flujo de trabajo existente de gestión documental o de aprobación.
Capacidades de exportación
La plataforma expone sus datos a través de una API REST para que pueda extraer exactamente lo que su herramienta de informes necesita:
- Información de la planta — metadatos, especificaciones técnicas y detalles de configuración.
- Eventos operativos — filtrados por periodo de tiempo y prioridad.
- Métricas de rendimiento — agregadas según la resolución que elija (diaria, semanal, mensual, trimestral o anual).
- Formatos estándar — CSV y JSON, listos para las herramientas de inteligencia de negocio habituales.
- Filtrado de tiempo flexible — por año, trimestre, mes, semana o un único día.
- Plantillas personalizadas — defina qué métricas incluye cada exportación, de modo que las columnas coincidan con el diseño de su informe.
La exportación de métricas canónica
Para las cifras de producción y rendimiento, utilice la exportación de métricas basada en plantillas:
GET /v1/export/metrics/template/{template_uid}
Esta es la ruta recomendada para la generación de informes externos. Devuelve un CSV cuyas columnas están definidas por una plantilla de exportación — una lista ordenada de métricas que usted (o las plantillas de sistema integradas en la plataforma) ha elegido. El orden de las columnas, las unidades y los encabezados traducidos siguen la plantilla exactamente, de modo que su analizador posterior se mantiene estable.
Cree una plantilla sin escribir código
No tiene que elaborar la solicitud a mano. Abra la página de exportación de datos en Mirox, utilice la pestaña Generador para elegir sus métricas y la resolución, y luego guárdela en la pestaña Plantillas para obtener una plantilla reutilizable para la llamada a la API anterior.
Exportación de varias plantas en una sola solicitud
Una única llamada puede abarcar varias plantas o carteras completas pasando los parámetros de consulta park y portfolio separados por comas. Esto permite informes a nivel de cartera sin necesidad de una llamada independiente por planta, con los datos agregados según la resolución que elija. Consulte la Guía de la API de exportación de métricas para la referencia completa de parámetros.
Utilice la ruta actual
Una ruta antigua para una sola planta en /v1/export/report/{park_uid}/data/template/... está obsoleta. Las nuevas integraciones deben utilizar /v1/export/metrics/template/{template_uid}, que admite varias plantas, resoluciones adicionales y salida adaptada al formato regional. Consulte la documentación en vivo de la API en service.mirox.io/docs para conocer el contrato actual.
Para las exportaciones de metadatos de la planta y de eventos, las rutas de información y eventos de /v1/export/report/... siguen disponibles y se muestran en los ejemplos de la API a continuación.
Ejemplos de la API
Para ver ejemplos ejecutables de las API de exportación — endpoints, llamadas curl, formatos de solicitud y respuesta, y un generador de informes en Python completo — consulte Ejemplos de la API de generación de informes externos.
Buenas prácticas
Para una generación eficaz de informes externos:
- Utilice los tokens de API de forma segura — nunca incruste tokens directamente en los scripts; cárguelos desde variables de entorno. Consulte Uso de tokens de API.
- Automatice los informes recurrentes — programe los scripts para que se ejecuten a intervalos regulares y obtener informes coherentes.
- Pruebe a fondo — confirme que los datos exportados aparecen correctamente en sus informes antes de confiar en ellos.
- Documente su lógica de procesamiento — mantenga un registro claro de cualquier transformación de datos que aplique.
- Valide los cálculos — contraste las métricas derivadas con los paneles de Mirox.
- Aplique periodos coherentes — utilice los mismos rangos de fechas en todos los informes para que los resultados sigan siendo comparables.
Consideraciones
Al trabajar con datos exportados:
- Se aplican límites de frecuencia de la API igual que en otros endpoints de Mirox.
- La disponibilidad de datos históricos depende del tiempo que la planta lleve recopilando datos.
- Las exportaciones CSV usan codificación UTF-8, que algunas herramientas requieren establecer explícitamente al importar.
El separador de campos CSV y el separador decimal deben ser distintos
La exportación de métricas le permite elegir el separador de campos CSV y el separador decimal. No deben ser el mismo carácter, o la salida no podrá analizarse. Los valores predeterminados (separador de campos ;, decimal ,) son seguros para las herramientas con formato regional alemán.
Si encuentra problemas con las exportaciones de datos o desea sugerir formatos o métricas adicionales, póngase en contacto con nuestro equipo en support@mirox.io.
Funciones relacionadas
- API de exportación de métricas — referencia completa de la exportación de métricas basada en plantillas y sus opciones
- MiroxQL — el formato para el acceso a métricas sin procesar y personalizadas; defina fórmulas para incluirlas como columnas de exportación
- Informes — los informes PDF y CSV integrados de la plataforma
- Uso de tokens de API — cree y delimite el alcance de los tokens que utilizan sus scripts de exportación
- Ejemplos de la API de generación de informes externos — ejemplos ejecutables en curl y Python