Saltar al contenido principal
Version: 1.2.0

Historial de Cambios

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 Semáforo (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 Semáforo (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 Semáforo: 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 Semáforo 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.