Importar desde un panel de Jira
Exportelier puede leer un panel de Jira y construir un informe a partir de lo que encuentre. Eliges un panel, Exportelier te dice gadget por gadget qué ha entendido, tú completas lo que Jira no ha entregado y obtienes un informe editable corriente.
Conviene saber dos cosas antes de empezar, porque condicionan todo lo demás de esta página.
Exportelier importa la configuración del panel — qué filtro, qué campo, qué tipo de gráfico — y la reconstruye con sus propios componentes. El resultado no es una captura de pantalla, ni una copia fiel al píxel, ni una página de Jira incrustada. Los anchos de columna, los marcos de los gadgets y el espaciado exacto no se reproducen, porque la API pública de Jira no los expone.
Atlassian no garantiza que los ajustes de un gadget integrado sean legibles a través de una API pública. Cuando un ajuste no es legible, Exportelier te pide que lo elijas. Nunca adivina qué filtro o qué campo querías.
Qué se puede importar
| Gadget de Jira | Se convierte en | Notas |
|---|---|---|
| Filter Results | Tabla de incidencias | Conserva las columnas elegidas y su orden |
| Pie Chart | Gráfico de categorías (circular) | Usa el tipo de estadística del gadget |
| Work Item Statistics | Gráfico de categorías (barras) | Usa el tipo de estadística del gadget |
| Two Dimensional Filter Statistics | Matriz | Usa los campos de ambos ejes |
| Created vs. Resolved Chart | Gráfico de series temporales | Conserva el periodo y el histórico del gadget — consulta los límites más abajo |
| Sprint Burndown | — | Necesita datos históricos de sprint que Exportelier aún no incluye |
| Cualquier otro | — | Se nombra y se excluye, nunca se descarta en silencio |
Cada gadget del panel recibe exactamente un estado:
- Listo — reconocido, y todo lo necesario era legible.
- Necesita reparación — reconocido, pero tienes que aportar un ajuste que falta.
- Disponible más adelante — reconocido, pero el componente correspondiente de Exportelier todavía no existe. Sprint Burndown está aquí.
- No compatible — un gadget de terceros o desconocido. Se nombra, no se oculta.
- Error — Jira no ha dejado que Exportelier lo lea, o lo leído era contradictorio. Este estado bloquea la importación hasta que lo arregles en Jira.
El reconocimiento se basa en la identidad técnica del gadget, nunca en su título. Renombrar un gadget en Jira, o tener Jira en otro idioma, no cambia lo que Exportelier hace con él — y llamar «Pie Chart» a un gadget propio no lo convierte en uno.
Qué muestra un gráfico de creadas frente a resueltas
Un gráfico de creadas frente a resueltas importado cuenta las fechas de creación y de resolución de las incidencias que su filtro guardado devuelve hoy. No reconstruye qué incidencias devolvía el filtro en el pasado.
Esto importa cuando el contenido del filtro ha cambiado. Si una incidencia salió del proyecto que cubre el filtro, desaparece de todos los periodos del gráfico, incluidos los anteriores al cambio. El propio gadget de Jira se comporta igual y por el mismo motivo, pero conviene saberlo antes de comparar dos exportaciones separadas por meses.
Hay otras tres diferencias posibles, y cada una se nombra en el aviso de integridad del informe cuando corresponde:
- Periodo del informe. Diario, semanal y mensual se reproducen con exactitud. Por horas pasa a diario, y trimestral y anual pasan a mensual: los totales no cambian, solo la anchura de cada periodo.
- La línea de tendencia de sin resolver. Jira puede superponer una tercera línea con las incidencias abiertas a lo largo del tiempo. El gráfico de Exportelier muestra solo las series de creadas y resueltas.
- Histórico. Un periodo superior a 366 días se recorta a 366 días.
Todo lo demás —el filtro, el modo acumulado, las propias cifras— se conserva sin cambios, y puedes editar cada uno de estos ajustes en el diseñador después.
La importación
- Abre Informes y elige Importar desde un panel de Jira.
- Elige un panel. Aquí solo aparecen los paneles que Jira ya te muestra: ser administrador del sitio en Exportelier no amplía la lista.
- Lee el análisis. Cada gadget aparece con su estado.
- Repara lo que haya que reparar. Eliges el filtro guardado y los campos con los selectores habituales; no hay un campo de JQL en bruto, por diseño.
- Revisa la integridad. Todo lo que quedará fuera aparece por su nombre, y debes confirmar las exclusiones explícitamente antes de poder crear el informe.
- Crea el informe. Se abre en el editor normal, totalmente editable.
Cualquier cosa marcada como Necesita reparación o Error impide la creación. Exportelier prefiere negarse antes que producir un informe que omita en silencio medio panel.
El aviso de integridad
Todo informe importado empieza con un aviso de integridad: un componente real del documento, no una indicación en la interfaz. Nombra el panel de origen, cuándo se importó, cuántos gadgets del panel se incluyen y todos los que no, por título.
Es una nota informativa cuando se importó todo y una advertencia cuando quedó algo fuera. Aparece igual en PDF, Word y Markdown.
Mientras el informe siga vinculado a su importación, Exportelier gestiona el aviso: puedes reorganizar libremente el resto del diseño, pero no borrarlo ni reescribirlo. Si aun así se elimina o se altera, el informe no se exportará: un documento que dice representar un panel mientras omite parte de él en silencio es peor que ningún documento.
Si quieres un informe sin el aviso, duplícalo. Un duplicado es un informe corriente, sin importación detrás y sin aviso gestionado.
Mantenerse al día con el panel
La importación es una instantánea de la configuración del panel. Los datos siguen en vivo: un informe lee sus filtros guardados en el momento de exportar, así que las cifras están actualizadas incluso meses después.
Lo que no se actualiza solo es el diseño y la configuración. Si alguien añade un gadget en Jira, o apunta uno a otro filtro, tu informe sigue funcionando exactamente igual hasta que tú digas lo contrario.
Abre el informe y usa Buscar cambios. Exportelier vuelve a leer el panel y clasifica cada gadget como añadido, eliminado, movido, con la configuración modificada o sin cambios. Volver a importar lo aplica:
- los gadgets sin cambios y los movidos conservan lo que tienen;
- lo que hayas añadido al informe a mano se deja intacto;
- los gadgets modificados y añadidos reciben contenido nuevo;
- un gadget cuya nueva configuración no puede resolverse automáticamente detiene la reimportación y pasa a reparación, en lugar de sobrescribir tu trabajo con una suposición;
- un gadget excluido como «disponible más adelante» que una versión más reciente de Exportelier ya puede importar aparece como cambiado, y la reimportación lo añade al final del informe. Los informes existentes nunca ganan un componente solo porque se publique una versión: tienes que pedirlo.
Antes de cada reimportación se guarda automáticamente una versión de la plantilla, así que Restaurar versión la deshace.
No hay programador ni sincronización en segundo plano. La reimportación ocurre cuando tú la pides.
Permisos
Importar, volver a importar y eliminar una importación son acciones de administrador del sitio.
Cada lectura de panel, gadget y filtro durante una importación se ejecuta como la persona que la realiza: un administrador no puede importar un panel que Jira no le muestra. Las exportaciones posteriores vuelven a leer los filtros del informe como quien exporta, así que la importación no amplía el acceso de nadie a los datos de Jira. Consulta Permisos y roles.
Límites
| Límite | Valor |
|---|---|
| Gadgets analizados por importación | 12 |
| Gadgets ofrecidos para selección por encima de ese tope | 60 |
Un panel con más de doce gadgets no se trunca. Se te pide que elijas qué gadgets importar, y los que dejes fuera se nombran en el aviso de integridad como cualquier otra exclusión.
Un informe importado es un informe corriente y hereda todos los límites de informe: fuentes de datos, componentes, incidencias por fuente. Consulta la referencia de límites.
Sobre la API de Jira que se utiliza
Exportelier lee paneles únicamente a través de la API REST de paneles de Jira Cloud documentada por Atlassian. No analiza páginas web de Jira, no lee iframes de gadgets, no hace capturas de pantalla ni usa endpoints no documentados.
Una de esas operaciones — Get gadgets, que lista los gadgets de un panel — está marcada como Experimental por Atlassian. Eso significa que Atlassian puede cambiarla sin las garantías de estabilidad del resto de la API. Si cambia de un modo que Exportelier no reconoce, la importación de paneles se desactiva sola y lo dice, en lugar de importar algo que ha leído mal. Tus informes, plantillas y exportaciones existentes no se ven afectados.