Saltar al contenido principal
Version: 3.1.0

Historial de Cambios

Release 1.2.0 · Forge 3.1.0​

✨ Nuevas Funcionalidades

  • Campo Teléfono — Selector de país:

    • Nueva interfaz de captura estructurada: selector de país (buscable, ~250 entradas ISO 3166-1) + campo de número local, en disposición inline.
    • Configuración del país por defecto por contexto (contextConfig): los administradores pueden fijar el país predeterminado por proyecto o tipo de issue desde la configuración del campo.
    • Al crear un issue con el campo vacío se preselecciona el país configurado en el contexto; al editar un valor existente el complemento separa país y número local automáticamente.
    • Renderizado actualizado: 📱 PE +51 943 824 375 con enlace tel: clicable.
    • Validación ampliada a 25 caracteres máximos (anterior: 20).

  • Validador Field Dependency — Triggers numéricos y de texto:

    • Nuevos campos disparadores: Currency, Percentage y Traffic Light KPI (modo numérico); Email y Phone Number (modo texto).
    • Modo numérico: operadores =, !=, <, <=, >, >= con umbral numérico libre.
    • Modo texto: operadores equals, does not equal, contains, is empty, is not empty.
    • Las reglas configuradas en v3.0.0 siguen operativas sin migración manual.

Release 1.1.0 · Forge 3.0.0​

✨ Nuevas Funcionalidades — Campos Personalizados

  • Campo Teléfono (Phone Number Field):

    • Nuevo tipo de campo personalizado para almacenar un número de teléfono por work item.
    • Validación de formato uniforme en cliente y servidor: acepta E.164 (+51 999 888 777), formatos locales con separadores (999-888-777, (01) 234-5678) y longitud total entre 7 y 20 caracteres.
    • Renderizado como enlace tel: clicable, con el icono mobile, listo para abrir el marcador del dispositivo.
    • Soporta edición inline desde la vista del issue, pantallas de creación, edición, transición y portal de JSM.
    • Búsqueda JQL con operadores de igualdad exacta.

  • Campo Moneda (Currency Field):

    • Nuevo tipo de campo numérico que almacena un importe monetario y lo renderiza con símbolo configurable (ej. S/, $, €), posición (prefijo o sufijo) y decimales (0, 2 o 4).
    • Configuración por contexto del campo: distintos proyectos o tipos de issue pueden tener distintas monedas sin duplicar el campo.
    • JQL sigue operando sobre el valor numérico almacenado, no sobre la cadena formateada.
    • Cuando un contexto no tiene configuración guardada, el valor se muestra como número plano usando el locale del usuario.

  • Campo Porcentaje (Percentage Field):

    • Nuevo tipo de campo numérico restringido al rango 0–100, renderizado como una barra de progreso horizontal con tres bandas de color (rojo / amarillo / verde).
    • Umbrales configurables por contexto (At-risk from, On-track from), con valores por defecto (40 / 70) cuando un contexto aún no se configura.
    • Indicador accesible (role="progressbar" + aria-label).
    • JQL con operadores numéricos estándar.

✨ Nuevas Funcionalidades — Extensiones de Workflow

  • Validador "Field Dependency":
    • Nuevo validador de transición que bloquea el avance solo cuando se cumple una condición: un campo disparador tiene un valor concreto y, en ese caso, un campo requerido está vacío.
    • Múltiples reglas por validador, cada una con su propio par disparador → requerido y su propio mensaje de error personalizado.
    • Soporta como disparador los campos del sistema Priority y Issue Type, y los campos personalizados de tipo Single-select List y Radio Buttons. Los valores de la lista del disparador se cargan automáticamente desde Jira.
    • Complementa al validador Fields Required: ambos pueden coexistir en la misma transición.

🛠️ Mejoras

  • Botones Cancel/Save retirados de la vista de creación: se eliminó la duplicación de botones internos en los formularios de creación de los campos del complemento (Email, Teléfono, Semáforo KPI, Moneda y Porcentaje). Ahora estos campos se integran con los botones nativos Create / Cancel del diálogo de Jira, evitando confusión y manteniendo la consistencia con la UI nativa.

📝 Notas Técnicas

  • Plataforma: Atlassian Forge, runtime nodejs24.x.
  • Tecnología UI: UI Kit 2 (@forge/react) para los campos personalizados; Custom UI (Vite build) para la interfaz de configuración del Field Dependency Validator.
  • Distribución: Atlassian Marketplace con actualizaciones automáticas.
  • Compatibilidad: cualquier site de Jira Cloud (Free, Standard, Premium, Enterprise), incluidos proyectos de Jira Service Management.

Release 1.0.0 · Forge 2.0.0​

🚀 Primer Release Estable en Jira Cloud

Lanzamiento inicial de la suite Admin Essentials for Jira Cloud, 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: Atlassian 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.