Gadget de informes de horas facturables
LogSense for Jira incluye un dashboard gadget que muestra horas facturables agregadas a partir de la metadata de worklogs almacenada en Forge KVS.
Añadir el gadget a un dashboard
- Abra el dashboard de Jira donde desea el informe.
- Haga clic en Add gadget (Añadir gadget).
- Busque el gadget de LogSense (horas facturables / billable hours).
- Haga clic en Add y configure el gadget.
Configuración
Tras añadirlo, el gadget solicita parámetros de contexto (según la versión 1.0.0 del complemento):
| Parámetro | Descripción |
|---|---|
| Espacio | Espacio cuyos worklogs se incluirán en el informe. |
| Rango de fechas | Periodo de agregación (si está disponible en la UI del gadget). |
| Filtros adicionales | Criterios de billable, tipo de trabajo u otros según la configuración expuesta. |
Vista del gadget
El gadget consulta issues mediante POST /rest/api/3/search/jql con procesamiento paralelo y lee la metadata de cada worklog desde Forge KVS (worklog-meta:{issueId}:{worklogId}) para distinguir registros billable de non-billable.
Columnas y métricas habituales
Según la configuración del gadget en 1.0.0, puede mostrar:
- Total de horas facturables en el periodo seleccionado.
- Desglose por usuario, espacio o tipo de trabajo (si aplica).
- Comparativa con horas non-billable cuando el informe lo incluye.
Solo los worklogs registrados con LogSense (provider activo) incluyen la clasificación billable/non-billable en KVS. Worklogs nativos anteriores a la adopción pueden no tener metadata completa.
Rendimiento
Las consultas del gadget usan la API de búsqueda JQL paginada (nextPageToken) y procesamiento paralelo de worklogs para reducir el tiempo de carga en dashboards con alto volumen de datos.
Buenas prácticas
- Coloque el gadget en dashboards de gestión de espacio o facturación, no en vistas operativas de sprint.
- Alinee el rango de fechas con el ciclo de facturación del cliente.
- Asegúrese de que los equipos registran tiempo con clasificación billable correcta desde el día uno.