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.
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?
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 2.0.0
Esta primera versión para Cloud incorpora tres módulos que mantienen paridad funcional con la versión Data Center del complemento:
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.
Validador de Workflow "Campos Requeridos"
- Nuevo validador de transición de workflow 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.
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 |
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.0.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.