Saltar al contenido principal
Version: 1.3.0

Historial de Cambios

Release 1.3.0​

Esta versión centra sus mejoras en la descubribilidad y uso correcto de JQL para el campo Semáforo KPI. El editor de umbrales ahora muestra consultas JQL listas para copiar, generadas en vivo a partir del nombre real del campo y los umbrales del contexto activo. Además, se amplía el README del repositorio con una sección dedicada al filtrado por zona del Semáforo.

✨ Nuevas Funcionalidades

  • Semáforo: ejemplos JQL por contexto en el editor de umbrales:
    • El formulario Edit Traffic Light KPI Thresholds incorpora un nuevo bloque de ayuda que muestra, por cada zona (roja, amarilla y verde), la consulta JQL correspondiente generada con el nombre real del campo y los umbrales introducidos en el formulario.
    • Las consultas se actualizan en vivo al modificar los valores de Red max / Yellow max o al marcar y desmarcar la opción Lower is better.
    • Botón Copiar junto a cada consulta: un clic copia la expresión JQL al portapapeles, lista para pegar en el buscador de issues o en un filtro guardado.
    • El bloque de ayuda incluye una nota explicando que JQL opera sobre el valor numérico almacenado, no sobre el color renderizado, y que los rangos son específicos del contexto de configuración activo.
    • Compatibilidad visual con el tema oscuro de Jira mediante tokens de color del sistema de diseño de Atlassian.
    • Todos los textos del nuevo bloque están internacionalizados (i18n) en español e inglés.

📝 Notas Técnicas

  • Sin cambios en módulos OSGi ni en tipos de campo: la actualización consiste en plantillas de interfaz, textos i18n y el README del repositorio.
  • La actualización del complemento se realiza a través de UPM de la forma habitual; no requiere migración de datos ni reconfiguración de los umbrales existentes.
  • Compatible con Jira Data Center 10.3.18 o superior.

Release 1.2.0​

Esta versión amplía la suite con dos nuevas extensiones de workflow —un validador de campos requeridos y una condición de roles de proyecto— y enriquece el campo personalizado Semáforo (Traffic Light KPI) con leyenda y tooltip de umbrales, un nuevo modo "menor es mejor" y una corrección de contraste para el tema oscuro de Jira.

✨ Nuevas Funcionalidades

  • Semáforo: leyenda y tooltip de umbrales en la vista del issue:

    • La vista detalle del issue muestra una leyenda descriptiva con los rangos de umbrales configurados, justo debajo del indicador.
    • Al pasar el cursor sobre el indicador aparece un tooltip con el rango exacto al que pertenece el valor actual del issue.
    • La leyenda y el tooltip respetan el idioma del usuario y el tema activo de Jira (claro / oscuro).
    • Mejora la comprensión del valor sin tener que acceder a la configuración del campo.

  • Semáforo: modo "menor es mejor" (invertir colores):

    • Nueva opción Lower is better en la configuración de umbrales del campo Semáforo, que invierte la asignación de colores sin alterar el orden de los umbrales.
    • Pensado para KPIs donde un valor bajo indica mejor desempeño: tiempo de resolución, número de incidencias, defectos abiertos, etc.
    • Configurable a nivel de contexto del campo, igual que los umbrales existentes (puede activarse en unos contextos y no en otros).
    • La leyenda y el tooltip reflejan automáticamente el modo activo.

  • Validador de Campos Requeridos en Transición:

    • Nuevo validador de workflow que bloquea la ejecución de una transición si determinados campos del issue están vacíos.
    • Configurable por transición: el administrador selecciona los campos exigidos desde un selector múltiple.
    • Permite definir un mensaje de error personalizado que se muestra al usuario cuando la transición es bloqueada.
    • En caso de bloqueo, el mensaje indica con claridad qué campos faltan por completar.
    • Compatible con campos personalizados y estándar de Jira.

  • Condición de Roles de Proyecto en Transición:

    • Nueva condición de workflow que restringe la ejecución de una transición a usuarios que pertenecen a uno o más roles de proyecto seleccionados.
    • Configurable por transición: el administrador elige los roles permitidos desde un selector múltiple.
    • La evaluación es siempre relativa al proyecto del issue, lo que permite reutilizar el mismo workflow en varios proyectos sin duplicarlo.
    • Los usuarios sin el rol requerido no ven la transición entre las acciones disponibles del issue.

🛠️ Correcciones

  • Contraste del número del Semáforo en modo oscuro: corregido el contraste del texto numérico del indicador Semáforo cuando Jira utiliza el tema oscuro. El valor numérico ahora es legible tanto en modo claro como en modo oscuro, manteniendo la accesibilidad en cualquier tema.

📝 Notas Técnicas

  • El modo "menor es mejor" se configura a nivel de contexto del campo, junto a los umbrales existentes. Si un mismo campo se reutiliza en varios proyectos con sentidos distintos, basta con activarlo en los contextos que lo requieran.
  • El nuevo validador y la nueva condición se incorporan al catálogo estándar de validadores/condiciones de workflow de Jira Data Center, y pueden combinarse con las reglas nativas (todas se evalúan en AND).
  • Todos los textos administrativos y de interfaz de las nuevas funcionalidades están internacionalizados (i18n) con soporte de español e inglés.
  • Compatible con Jira Data Center 10.3.18 o superior.

Release 1.1.0​

Esta versión amplía la suite con un nuevo campo personalizado de tipo Traffic Light KPI e incorpora los activos visuales oficiales del complemento: logo principal e imágenes de vista previa para los campos disponibles.

✨ Nuevas Funcionalidades

  • Campo Personalizado Traffic Light KPI:
    • Nuevo tipo de campo numérico que renderiza un indicador de color (🔴 rojo / 🟡 amarillo / 🟢 verde) en la vista detalle del issue y en los listados.
    • Umbrales configurables por contexto (Red max / Yellow max), permitiendo definir reglas distintas por proyecto o tipo de issue desde la página de configuración del campo.
    • Resolución del color por contexto activo: el indicador se calcula a partir de los umbrales del contexto al que pertenece el issue.
    • Renderizado accesible (etiquetas aria-label por estado) y vista compacta para columnas y tableros.
    • Buscador integrado (Number Range Searcher) para filtrado y búsqueda por valor numérico vía JQL (=, <, <=, >, >=).
    • Toda la interfaz de administración y los mensajes de validación están internacionalizados (i18n), con soporte de español e inglés incluido.
    • Compatible con Jira Data Center.

🎨 Diseño y Activos Visuales

  • Logo oficial del complemento Admin Essentials: se incorpora el logo principal del plugin (PNG 512×512 px), coherente visualmente con los íconos de los campos de la suite.
  • Imagen de vista previa del campo Correo electrónico: disponible en la pantalla de creación de campos personalizados de Jira, representa visualmente un campo de email (sobre y dirección de ejemplo).
  • Imagen de vista previa del campo Traffic Light KPI: disponible en la pantalla de creación de campos personalizados de Jira, representa el indicador de tres focos (verde / amarillo / rojo).

📝 Notas Técnicas

  • La configuración de umbrales del campo Traffic Light KPI está siempre ligada al FieldConfigContext activo, lo que permite umbrales independientes por proyecto o tipo de issue sin necesidad de duplicar el campo.
  • Mientras un contexto no tenga umbrales definidos, los valores del campo se renderizan en gris (sin estado) para evitar comunicar un color que pueda inducir a interpretaciones equivocadas.
  • El modelo de umbrales de esta versión asume "valores más altos son mejores". Si su KPI funciona al revés, modele los umbrales invirtiendo el significado del rango.

Release 1.0.0​

🚀 Primer Release Estable

Esta es la primera versión estable del complemento. A partir de este release, el plugin adopta oficialmente el nombre Admin Essentials, reflejando su naturaleza como suite multi-módulo de utilidades para administradores de Jira.

✨ Nuevas Funcionalidades

  • Campo Personalizado Email:
    • Nuevo tipo de campo personalizado Email disponible para proyectos de Jira Data Center.
    • Permite registrar una dirección de correo electrónico por issue, con renderizado como enlace mailto: en la vista del issue.
    • Validación de formato en el servidor siguiendo la especificación HTML5 (la misma que aplican los navegadores a <input type="email">), garantizando datos consistentes desde cualquier origen (pantallas de Jira, REST API, importadores e integraciones externas).
    • Aplica los límites RFC 5321: máximo 254 caracteres en total y 64 caracteres en la parte local.
    • Soporte de búsqueda integrado con el motor de Jira: el campo es buscable desde el buscador básico y desde JQL.

🛡️ Calidad y Cobertura

  • Suite de pruebas unitarias para el campo Email, incluyendo casos límite (longitudes máximas, caracteres especiales y entradas inválidas).
  • Quality gates de CI configurados para garantizar la cobertura mínima en cada merge.

📝 Notas Técnicas

  • El plugin ha sido renombrado oficialmente a Admin Essentials como nombre de cara al usuario, sentando las bases para futuros módulos.
  • Compatible con Jira Data Center 10.3.18 o superior.