Introducción a LogSense for Jira

¡Bienvenido a la documentación oficial de LogSense for Jira! 🎉

LogSense for Jira es una aplicación Forge para Jira Cloud que aporta time tracking inteligente: clasificación billable / non-billable, tipos de trabajo, límite diario de horas, bloqueo en festivos, configuración global del sitio, ajustes por espacio en Space settings, restauración del acceso administrativo e integración con eazyBI, además de un gadget de informes de horas facturables.

El complemento actúa como proveedor de time tracking de Jira, sustituyendo la experiencia nativa de Log work por registro con metadata LogSense. La interfaz se adapta al idioma del usuario en Jira (inglés y español).

¿Cómo obtener este complemento?

LogSense for Jira aún no se encuentra disponible en el Atlassian Marketplace, pero puede realizar la instalación inmediata mediante el siguiente enlace: Instalar LogSense for Jira.

Prerrequisitos:

• Debe tener permisos de Administrador de Jira o Administrador del site para realizar la instalación.
• Una conexión activa a internet y acceso a su instancia de Jira Cloud.

Consulte la Guía de Instalación para los pasos detallados y la activación del proveedor de time tracking.

¿Para quién es este complemento?

Audiencia objetiva

LogSense for Jira está pensado para equipos de consultoría, agencias, mesas de servicio y operaciones que necesitan registrar tiempo con contexto de facturación, respetar límites diarios por persona, obtener visibilidad de horas facturables en dashboards y, cuando usan eazyBI, explotar billable/work type sin integraciones ad hoc.

Valor diferencial

Capacidad	Beneficio
Proveedor de time tracking	UI unificada de registro con metadata LogSense en modal Log work, pestaña Work log y administración del provider.
Configuración global	Defaults del site (límite diario, work types, festivos) heredables por cada espacio.
Límite diario	Validación contra el total real de worklogs del día del usuario (JQL + worklogs paginados), con comportamiento fail-safe si la API no responde.
Billable / non-billable	Clasificación explícita en cada registro para informes y facturación.
Tipos de trabajo	Catálogo global o por espacio para categorizar el esfuerzo.
Festivos	Bloqueo de registros en fechas marcadas en el calendario del espacio o heredadas del sitio.
Integración eazyBI	Stamp [LogSense:v1 ...] en comentarios de worklog para calculated fields.
Gadget de informes	Horas facturables visibles en dashboards de Jira.
Interfaz localizada	UI en inglés o español según el locale del usuario en Jira.

Funcionalidades incluidas en la versión 2.2.0

Proveedor de time tracking (Preview)

• Módulo Forge jira:timeTrackingProvider (logsense-time-provider).
• Al activar LogSense en Settings → Work items → Time tracking, desaparece la UI nativa de Log work.
• Puntos de entrada: acción Log work en el issue, pestaña Work log y administración del provider.

Registro de tiempo enriquecido

• Selector de fecha con calendario (locale del usuario).
• Atajos de tiempo (15m, 30m, 1h, 2h, 4h).
• Barras de progreso de estimación del issue y límite diario.
• Campos de metadata: billable, tipo de trabajo y notas.

Configuración global del sitio

Panel LogSense — Global Settings (jira:adminPage, logsense-global-admin):

• General, Work Types y Festivos a nivel site.
• Herencia global → espacio con override por espacio y acción Reset to Site Defaults.
• Pestaña eazyBI con snippets para reporting externo.

Ver Configuración global del sitio.

Ajustes por espacio en Space settings

Pantalla LogSense Settings dentro de Space settings (jira:projectSettingsPage):

• General: límite diario, facturable por defecto, estimaciones, bloqueo en festivos.
• Work Types: catálogo de tipos de trabajo (override del global si aplica).
• Festivos: calendario de festivos del espacio.

Integración eazyBI

• Stamp estructurado [LogSense:v1 billable=1 type=...] en el comentario del worklog de Jira.
• Metadata sigue en Forge KVS para la UI de LogSense.
• Guía de calculated fields en la pestaña eazyBI y en Integración con eazyBI.

Gadget de informes

• Dashboard gadget de horas facturables con consultas optimizadas a la API de Jira.

Cambio clave en la versión 2.2.0

La configuración por espacio deja la navegación principal del espacio y pasa a Space settings, alineándose con permisos de administración y reduciendo la exposición a usuarios no administradores.

Compatibilidad

• Jira Cloud: Cualquier site (Free, Standard, Premium, Enterprise).
• Plataforma: Atlassian Forge (UI Kit / Custom UI).
• Idiomas de la UI: inglés (en-US) y español (es-ES), con fallback a inglés.
• App ID: 2b9c7a64-8273-400f-9a03-ba079ffa2707

Bienvenido a LogSense: tiempo registrado con contexto, límites y visibilidad para equipos que facturan por horas.