Integración con eazyBI
A partir de la versión 1.1.0, LogSense escribe la metadata billable y tipo de trabajo en el comentario del worklog de Jira mediante un stamp estructurado. eazyBI puede leer ese stamp con calculated fields sin acceder a Forge KVS.
Por qué hace falta
eazyBI consulta los datos nativos del worklog en Jira: horas, autor, fecha y comentario. La metadata LogSense (billable, workTypeId, notas) se almacenaba solo en Forge KVS (worklog-meta:{issueId}:{worklogId}), invisible para eazyBI.
LogSense aplica doble escritura: persiste en KVS para la UI del complemento y añade un stamp machine-readable al comentario ADF del worklog en Jira.
Formato del stamp
Al crear un worklog desde LogSense, el comentario incluye una primera línea con el stamp y, opcionalmente, las notas del usuario en líneas siguientes:
[LogSense:v1 billable=1 type=development]
Notas del usuario aquí...
| Campo | Valores | Descripción |
|---|---|---|
billable | 1 o 0 | 1 = billable, 0 = non-billable |
type | id del work type | Identificador configurado en LogSense (p. ej. development, meetings) |
Si un usuario edita o elimina el stamp en la UI nativa de Jira, eazyBI puede dejar de interpretar billable/work type correctamente. LogSense intenta leer el stamp como fallback cuando KVS no tiene metadata (worklogs legacy).
Pestaña eazyBI en Global Settings
En Configuración global de LogSense → pestaña eazyBI encontrará instrucciones y snippets listos para copiar en su instancia de eazyBI.
Calculated fields sugeridos en eazyBI
Cree JavaScript calculated fields en el cubo de eazyBI que analicen el comentario del worklog. Ejemplo orientativo para detectar si el registro es billable:
// LogSense Billable (boolean) — ejemplo orientativo
var comment = issue.fields.comment;
if (!comment) return null;
var match = comment.match(/\[LogSense:v1 billable=(\d)/);
if (!match) return null;
return match[1] === '1';
Ejemplo para extraer el tipo de trabajo:
// LogSense Work Type (string) — ejemplo orientativo
var comment = issue.fields.comment;
if (!comment) return null;
var match = comment.match(/\[LogSense:v1[^\]]*type=([^\s\]]+)/);
return match ? match[1] : null;
Con esos campos puede derivar métricas como:
- LogSense Billable Hours —
Hours spentcuando billable = true - LogSense Non-Billable Hours —
Hours spentcuando billable = false - Agrupaciones por work type en informes de dedicación
Los nombres de propiedades y la API de calculated fields pueden variar según la versión y el esquema de su cubo. Use la pestaña eazyBI de Global Settings y la documentación de eazyBI como referencia principal; los snippets anteriores ilustran el parseo del stamp [LogSense:v1 ...].
Worklogs sin stamp
| Origen del worklog | Stamp en comentario | Sugerencia en eazyBI |
|---|---|---|
| Creado con LogSense (v1.1.0+) | Sí | Parsear billable y work type del stamp |
| Creado con Jira nativo o apps de terceros | No | Tratar como unknown o aplicar regla de negocio por defecto |
| Legacy (solo metadata en KVS) | Puede no tenerlo | Ejecutar backfill documentado en el README del complemento |
Backfill de worklogs existentes
Los worklogs registrados antes de v1.1.0 pueden tener metadata solo en KVS. El complemento incluye un procedimiento de backfill (script o resolver administrativo) que lee KVS y actualiza los comentarios con el stamp, de forma idempotente (no duplica stamps ya presentes).
Consulte el README del repositorio logsense-for-jira (tag 1.1.0) para los pasos de ejecución en su site.
Relación con el gadget de LogSense
El gadget de informes de LogSense sigue leyendo metadata desde KVS. El stamp en comentarios es el puente para herramientas externas como eazyBI; no sustituye el gadget ni requiere desactivarlo.
Próximos pasos
- Configuración global del sitio — pestaña eazyBI y defaults del site
- Billable, non-billable y tipos de trabajo — perspectiva del usuario final