Saltar al contenido principal
Version: 2.0.0

Historial de Cambios

Release 1.0.0 · Forge 2.0.0​

🚀 Primer Release Estable en Jira Cloud

Lanzamiento inicial de la suite Admin Essentials for Jira, desarrollada sobre Atlassian Forge. Esta primera versión incorpora las capacidades centrales de validación de flujos de trabajo y los tipos de campo personalizado más solicitados, con paridad funcional frente a la versión Data Center del complemento.

✨ Nuevas Funcionalidades — Campos Personalizados

  • Campo Email (jira:customFieldType):

    • Nuevo tipo de campo personalizado Email Custom Field disponible para proyectos de Jira Cloud y proyectos JSM (vista del agente y portal del cliente).
    • Validación de formato en cliente (al editar) y servidor (mediante una Jira expression definida en el manifiesto Forge).
    • Cumple los límites RFC 5321: máximo 254 caracteres en total y 64 caracteres en la parte local.
    • Renderizado automático como enlace mailto: clicable (RFC 6068) en la vista del issue.
    • Soporte de edición inline desde la vista del issue.
    • Búsqueda JQL con operadores de igualdad exacta (=, !=, in, is EMPTY, etc.).

  • Campo Semáforo KPI / Traffic Light (jira:customFieldType):

    • Nuevo tipo de campo numérico que se renderiza como un indicador de tres colores (🔴 rojo / 🟡 amarillo / 🟢 verde) basado en umbrales por contexto.
    • Umbrales configurables por contexto (Low threshold, High threshold) mediante el módulo contextConfig de Forge, permitiendo distintos umbrales por proyecto o tipo de issue.
    • Modo "Lower value is better" para invertir la semántica de colores en KPIs donde un valor bajo es deseable (tiempo de resolución, incidencias abiertas, etc.).
    • Leyenda descriptiva debajo del indicador y tooltip al pasar el cursor que comunican la regla activa.
    • Soporte nativo de modo oscuro mediante tokens de diseño de UI Kit 2 (color.text, color.text.subtlest).
    • Búsqueda JQL con operadores numéricos estándar (=, <, <=, >, >=, is EMPTY, etc.).
    • Paridad funcional equivalente a la versión 1.2.0 de Data Center del campo Semáforo.

✨ Nuevas Funcionalidades — Extensiones de Workflow

  • Validador "Fields Required" (jira:workflowValidator):
    • Nuevo validador de transición que bloquea el avance si determinados campos del issue están vacíos.
    • Interfaz de configuración mediante Custom UI con lista dual (campos disponibles / campos seleccionados) y caja de búsqueda.
    • Soporte de mensaje de error personalizado y opción Ignore context para forzar la validación incluso en contextos no aplicables al issue.
    • La validación se materializa como una Jira expression generada en el momento de guardar, lo que garantiza ejecución nativa por parte de Jira y compatibilidad con campos de pantalla de transición (incluido el campo Comment).

📝 Notas Técnicas

  • Plataforma: Atlassian Forge, runtime nodejs24.x (arm64), 256 MB.
  • Tecnología UI: UI Kit 2 (@forge/react) para los campos personalizados; Custom UI (Vite build) para la interfaz de configuración del validador (necesaria para soportar la generación de la Jira expression al guardar).
  • Distribución: Enlace de instalación Forge (fuera del Marketplace) con actualizaciones automáticas.
  • Internacionalización: Textos de UI servidos desde translations/en-US.json mediante useTranslation() de @forge/react. Idioma base: inglés.
  • Compatibilidad: cualquier site de Jira Cloud (Free, Standard, Premium, Enterprise), incluidos proyectos de Jira Service Management.