Fuentes de datos de filtros guardados
Los datos de un informe proceden de filtros guardados de Jira. Añades cada filtro una vez, le das un nombre y vinculas componentes a ese nombre.
Los filtros guardados son la única fuente de datos en esta versión. No hay JQL de texto libre, ni fuentes REST, SQL o CSV, ni conectores de terceros.
Añadir una fuente
En el editor de informes, Añadir fuente de datos lista los filtros guardados que Jira te muestra. Elige uno y dale un nombre local — «Backlog de soporte», «Escalados de ingeniería» — que es el que verás en el selector de fuente del editor.
También puedes escribir directamente un ID numérico de filtro guardado. Si no se puede contactar con Jira, el selector lo indica en lugar de bloquear el editor.
Un informe admite hasta 8 fuentes de datos. Los nombres deben ser únicos.
Exportelier guarda un ID de filtro, no una consulta
Esto es lo más importante que hay que entender sobre los informes.
Al añadir un filtro guardado, Exportelier guarda su ID numérico y tu nombre para mostrar. Nada más. No guarda:
- el JQL del filtro — nunca se lee, copia, registra ni concatena;
- los resultados del filtro — no se conserva ninguna instantánea de incidencias.
En el momento de exportar, Exportelier construye un único predicado estrictamente
numérico, filter = 12345, y le pide a Jira la respuesta de ahora.
De ahí se siguen tres consecuencias, todas deliberadas:
- El informe sigue al filtro. Edita el filtro guardado en Jira y la siguiente exportación lo reflejará. No hay nada que resincronizar en Exportelier.
- Las reglas de compartición de Jira se aplican automáticamente. Exportelier nunca se convierte en un canal lateral que las esquive.
- No hay copia obsoleta que pueda filtrarse. Un informe guarda una referencia, no datos.
Como la referencia es en vivo, editar un filtro guardado muy compartido cambia todos los informes vinculados a él, incluidos los de otros administradores.
Cada exportación se ejecuta como tú
Exportelier lee Jira como la persona que inició la exportación, nunca como la aplicación ni como quien construyó el informe.
Así, dos personas pueden exportar el mismo informe el mismo día y recibir legítimamente documentos distintos. Cada una ve exactamente las incidencias que permiten sus propios permisos de Jira: ni más, ni menos. Es el comportamiento correcto, no un error: la alternativa sería una aplicación que enseña a la gente datos que Jira le deniega.
El administrador que construye el informe ve los filtros que él puede ver. Eso nunca amplía lo que recibe otra persona.
Dos fuentes, un filtro, una búsqueda
Si dos fuentes de datos apuntan al mismo filtro guardado, se consulta a Jira una sola vez y el resultado se entrega a ambas. Los campos que los componentes realmente necesitan se recogen en todo el informe y se piden juntos, en lugar de pedir «todo» o de consultar por componente.
Puedes por tanto añadir el mismo filtro dos veces con nombres distintos —para componentes distintos— sin pagarlo dos veces.
Comprobación previa: qué encontrará la exportación
Antes de iniciar una exportación, Exportelier revisa cada fuente e informa de uno de estos estados:
| Estado | Qué significa | ¿Bloquea la exportación? |
|---|---|---|
| Lista | El filtro se leyó y encontró incidencias. | No |
| Vacía | El filtro no encuentra ninguna incidencia ahora mismo. | No — un informe vacío es una respuesta veraz. |
| No disponible | El filtro no está disponible para ti. | Sí |
| Limitada por tasa | Jira está limitando las peticiones; inténtalo en breve. | Temporalmente |
| Error | No se pudo comprobar el filtro. | Temporalmente |
La comprobación previa también muestra un recuento aproximado por fuente y avisa cuando una fuente vaya a cortarse en el tope por fuente.
Por qué «no disponible» no dice «eliminado»
Jira responde 404 tanto para un filtro que ya no existe como para uno que
existe pero no está compartido contigo. Los dos casos no se pueden distinguir
desde la API, así que Exportelier no lo adivina. Afirmar una eliminación que no
puede demostrar mandaría a la gente a buscar el problema equivocado; el mensaje
nombra ambas posibilidades y sugiere pedir a un administrador que comparta el
filtro.
Una fuente no disponible detiene la exportación
Un informe al que le falta una fuente no se exporta. El trabajo falla y nombra la fuente. Es una decisión deliberada: un informe al que le falta en silencio una de sus fuentes de datos es materialmente falso e indistinguible de uno completo.
Límites aplicables a las fuentes
- 8 fuentes de datos por informe y como máximo 8 búsquedas de filtro distintas.
- 500 incidencias por fuente y 2000 incidencias únicas en todo el informe.
- 2 búsquedas de Jira simultáneas — los informes son trabajos en segundo plano, no lecturas interactivas, y comparten el presupuesto de tasa de Jira del sitio.
Cuando un límite trunca datos, el documento final lo indica, por fuente. Consulta la referencia de límites.