Introducción a Admin Essentials

¡Bienvenido a la documentación oficial del complemento Admin Essentials for Jira! 🎉

Admin Essentials — campos personalizados avanzados y extensiones de workflow para Jira Cloud sobre Forge.

El complemento está construido sobre Atlassian Forge y se distribuye mediante un enlace de instalación proporcionado por MB Group, por lo que se beneficia del modelo de seguridad, despliegue y actualización de la plataforma oficial de Atlassian.

¿Cómo obtener este complemento?

Admin Essentials for Jira no está disponible en el Atlassian Marketplace. Use el enlace de instalación de nuestra Guía de Instalación para habilitarlo en su site.

¿Para quién es este complemento?

Audiencia objetivo

Admin Essentials está diseñado para Administradores de Jira Cloud, Líderes de Proyecto y equipos operativos (soporte, mesas de servicio, comerciales, operaciones) que necesiten ampliar Jira con utilidades transversales que cubran necesidades cotidianas sin sumar complementos adicionales a la instancia.

Funcionalidades incluidas en la versión 3.1.0

La versión actual para Cloud incorpora siete módulos que mantienen paridad funcional con la versión Data Center del complemento en los ámbitos cubiertos:

Campo personalizado Email

• Tipo de campo personalizado que almacena una dirección de correo electrónico por work item.
• Validación de formato en el cliente (al editar) y en el servidor (mediante una Jira expression).
• Renderizado automático como enlace mailto: clicable en la vista del issue.
• Edición inline desde la vista del issue, pantallas de creación, edición, transición y el portal de JSM.
• Búsqueda JQL con operadores de igualdad exacta (=, !=, in, is EMPTY, etc.).

Campo personalizado Semáforo KPI (Traffic Light)

• Tipo de campo numérico que se renderiza como un indicador visual de tres colores (🔴 rojo / 🟡 amarillo / 🟢 verde).
• Umbrales configurables por contexto del campo: distintos umbrales para distintos proyectos o tipos de issue.
• Modo "Lower is better" (menor es mejor) para invertir la semántica de colores en KPIs donde un valor bajo es deseable.
• Leyenda descriptiva y tooltip que explican la regla activa.
• Soporte nativo de modo oscuro mediante tokens de diseño de UI Kit 2.

Campo personalizado Teléfono (Phone Number)

• Almacena un número de teléfono por work item con selector de país (buscable, ~250 países ISO) y campo de número local en disposición inline.
• País por defecto configurable por contexto (contextConfig): los administradores fijan el país predeterminado por proyecto o tipo de issue.
• Validación uniforme en cliente y servidor (E.164, formatos locales con separadores); longitud total entre 7 y 25 caracteres (incluido el código de marcación).
• Renderizado como 📱 PE +51 943 824 375 con enlace tel: clicable.
• Edición inline y búsqueda JQL con operadores de igualdad exacta.

Campo personalizado Moneda (Currency)

• Campo numérico que almacena un importe y lo renderiza con símbolo, posición y decimales configurables por contexto.
• Búsqueda JQL sobre el valor numérico almacenado, no sobre la cadena formateada.

Campo personalizado Porcentaje (Percentage)

• Campo numérico restringido al rango 0–100, renderizado como barra de progreso con tres bandas de color.
• Umbrales configurables por contexto (At-risk from, On-track from).

Validador de Workflow "Campos Requeridos"

• Validador de transición que bloquea el avance si determinados campos están vacíos.
• Configuración mediante lista dual (campos disponibles / campos seleccionados).
• Mensaje de error personalizado y opción de ignorar el contexto para forzar la validación incluso en contextos no configurados.

Validador de Workflow "Field Dependency"

• Validador condicional que bloquea la transición cuando un campo disparador cumple una condición y un campo requerido está vacío.
• Múltiples reglas por validador, cada una con su propio mensaje de error personalizado.
• Disparadores de lista (Priority, Issue Type, Single-select List, Radio Buttons), numéricos (Currency, Percentage, Traffic Light KPI) y texto (Email, Phone Number).
• Operadores numéricos (=, !=, <, <=, >, >=) y de texto (equals, does not equal, contains, is empty, is not empty).

Diferencias frente a la versión Data Center

Aspecto	Data Center	Cloud (Forge)
Plataforma	Plugin tradicional (P2)	Atlassian Forge
Distribución	Archivo .jar / .obr	Enlace de instalación Forge
Tecnología UI	Velocity / AUI	UI Kit 2 (@forge/react) + Custom UI
Compatibilidad	Jira Data Center 10.3.18+	Jira Cloud (cualquier site)
Actualizaciones	Manuales por el administrador	Automáticas desde Atlassian
Modo oscuro	Estilo CSS clásico	Nativo con tokens de diseño

¿Ya usa la versión Data Center?

Si ya conoce Admin Essentials para Jira Data Center, encontrará una experiencia funcionalmente equivalente en la versión Cloud para los módulos incluidos en esta versión 1.2.0. Las diferencias se concentran en los flujos de instalación, configuración de pantallas y acceso a la configuración de campos, que en Cloud siguen los patrones nativos de Forge y de la administración de Jira Cloud.

Compatibilidad

• Jira Cloud: Cualquier site de Jira Cloud (Free, Standard, Premium, Enterprise).
• Jira Service Management (JSM): Los campos personalizados son compatibles con la vista del agente y el portal del cliente.
• Plataforma: Atlassian Forge, runtime nodejs24.x.

Bienvenido a Admin Essentials: lo esencial para que su Jira Cloud hable el mismo idioma que sus procesos.