Preguntas Frecuentes (FAQ)
A continuación, se presentan algunas de las preguntas más comunes sobre la configuración y el uso de Admin Essentials for Jira.
P: ¿Cuál es la diferencia entre la versión Cloud y la versión Data Center del complemento?
R: Ambas versiones comparten el mismo conjunto de funcionalidades para los módulos cubiertos en esta versión (Email, Semáforo KPI, validador de Campos Requeridos). La versión Cloud está construida sobre Atlassian Forge y se distribuye mediante un enlace de instalación (no está en el Atlassian Marketplace), con actualizaciones automáticas, mientras que la versión Data Center se instala manualmente como plugin (.jar). La experiencia de usuario final es equivalente; las diferencias se concentran en los flujos de instalación, configuración y actualización.
P: ¿Por qué no encuentro el complemento en el Atlassian Marketplace?
R: Admin Essentials for Jira se distribuye de forma directa mediante un enlace de instalación de Forge proporcionado por MB Group. Consulte la Guía de Instalación para obtener el enlace y los pasos detallados. Si el enlace deja de funcionar, contacte a MB Group para solicitar uno actualizado.
P: ¿Por qué Jira no me deja guardar el issue y muestra un error en el campo Email?
R: El complemento valida el formato del correo mediante una Jira expression ejecutada en el servidor. El error aparece cuando: 1) el texto no respeta el formato de un correo electrónico estándar (por ejemplo, falta la @, contiene espacios o tiene varios @), 2) la dirección excede los 254 caracteres permitidos en total, o 3) la parte anterior a la @ excede los 64 caracteres. Corrija la dirección y vuelva a guardar.
P: ¿La validación también se aplica si creo o actualizo issues a través de la REST API?
R: Sí. La validación se ejecuta en el servidor como parte del ciclo de vida estándar de los campos personalizados de Forge, por lo que se aplica de forma uniforme tanto desde las pantallas de Jira como desde la REST API de Jira Cloud o integraciones externas. Esto evita que entren direcciones inválidas por caminos alternativos.
P: ¿Puedo buscar issues por el valor del campo Email desde JQL?
R: Sí, con los operadores de igualdad exacta: =, !=, in, not in, is EMPTY, is not EMPTY. Por ejemplo: "Nombre del campo" = "cliente@ejemplo.com". Los operadores de coincidencia parcial (~, !~) no son compatibles con campos personalizados Forge de tipo string; esta es una limitación de la plataforma de Atlassian, no del complemento.
P: Creé un campo Email pero los usuarios no lo ven en la pantalla del issue, ¿qué falta?
R: En Jira, los campos personalizados solo aparecen en las pantallas a las que han sido asociados explícitamente. Verifique que el campo esté incluido en el esquema de pantallas del proyecto correspondiente (por defecto, las pantallas de creación, edición y vista). En Jira Cloud, esto se gestiona desde Project settings → Issues → Screens o desde la administración global de pantallas.
P: Creé un campo Semáforo KPI, le asigné un valor a un issue y el indicador aparece en gris. ¿Qué falta?
R: El campo Semáforo KPI renderiza en gris mientras el contexto del campo no tenga los umbrales (Low threshold y High threshold) configurados. Vaya a Configuración → Issues → Custom fields, abra el menú de acciones del campo (⋯) → Contexts and default value, seleccione el contexto correspondiente y complete los umbrales en la sección Traffic Light thresholds. Una vez guardados, los issues de ese contexto comenzarán a mostrar el color resuelto.
P: ¿Puedo tener umbrales distintos por proyecto en el mismo campo Semáforo KPI?
R: Sí. Los umbrales del campo se guardan por contexto del campo personalizado. Cree un contexto por cada proyecto o tipo de issue al que quiera asignar reglas distintas y defina los umbrales de cada contexto de forma independiente desde Contexts and default value.
P: ¿Qué hace exactamente el modo "Lower value is better"?
R: Invierte la asignación de colores sin alterar el orden de los umbrales. En el modo por defecto, valores bajos = rojo y valores altos = verde. Con "Lower value is better" activado, valores bajos = verde y valores altos = rojo. Es útil para KPIs como tiempo de resolución, defectos abiertos o retrasos, donde un valor bajo indica mejor desempeño. La leyenda y el tooltip reflejan automáticamente el cambio.
P: El campo Semáforo KPI, ¿se puede usar en JQL?
R: Sí. El campo se registra en Forge con type: number, por lo que admite los operadores numéricos estándar (=, !=, <, <=, >, >=, is EMPTY, is not EMPTY, in, not in). Recuerde que las consultas operan sobre el valor numérico almacenado, no sobre el color resuelto.
P: ¿El complemento es compatible con Jira Service Management (JSM)?
R: Sí. Los tipos de campo del complemento se declaran con las experiencias portal-view y portal-request, lo que les permite renderizarse correctamente tanto en la vista del agente como en el portal del cliente de JSM. La edición y la validación funcionan igual que en proyectos Jira Software o Jira Work Management.
P: ¿El complemento es compatible con el modo oscuro de Jira Cloud?
R: Sí. Tanto el indicador del Semáforo KPI, su leyenda y tooltip, como el campo Email se construyen con tokens de diseño de UI Kit 2 (color.text, color.text.subtlest, etc.). Esto significa que los colores se ajustan automáticamente al tema activo (claro u oscuro) manteniendo el contraste accesible.
P: El validador "Fields Required" no aplica a un campo personalizado, aunque lo seleccioné. ¿Por qué?
R: Por defecto, el validador omite los campos personalizados que no están configurados para el proyecto o el tipo de issue del que se está ejecutando la transición. Es el comportamiento esperado cuando un mismo workflow se reutiliza en varios proyectos con esquemas distintos. Si necesita exigir el campo de todas formas, marque la casilla Ignore context al editar el validador.
P: ¿El complemento Cloud puede coexistir con la versión Data Center del mismo complemento?
R: Sí, son productos independientes que viven en plataformas distintas. Una organización puede tener la versión DC en su instancia Data Center y la versión Cloud en su site Atlassian Cloud, en paralelo, sin conflictos.
P: ¿Las actualizaciones del complemento son automáticas?
R: Sí. Las aplicaciones Forge se actualizan automáticamente desde la infraestructura de Atlassian, sin necesidad de intervención manual del administrador. Si una versión futura introduce nuevos permisos (scopes), Atlassian le notificará y solicitará su aprobación antes de aplicar la actualización.