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.
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 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 @ o contiene espacios), 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 Jira, por lo que se aplica de forma uniforme tanto desde las pantallas de Jira como desde la REST API, importadores e 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í. El campo se registra con un buscador (searcher) integrado al motor de Jira. Puede usar consultas como "Nombre del campo" = "cliente@ejemplo.com" reemplazando Nombre del campo por el nombre exacto que se asignó al crear el campo personalizado.
P: Creé el campo, 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 Email esté incluido en el esquema de pantallas del proyecto correspondiente (por ejemplo, en la pantalla por defecto, la de creación y la de edición de issues).
P: ¿Puedo guardar más de una dirección de correo en el mismo campo?
R: No. El campo Email almacena una única dirección por issue. Si necesita capturar varias direcciones (por ejemplo, una lista de notificación), la recomendación es crear varios campos Email separados o usar un campo de texto libre acompañado de una convención interna.
P: ¿Qué pasa si el campo no está marcado como obligatorio y un usuario lo deja en blanco?
R: El valor vacío es válido cuando el campo no es obligatorio en la configuración del proyecto. No se mostrará error y el issue se podrá guardar normalmente.
P: ¿Por qué el plugin se llama ahora "Admin Essentials"?
R: A partir de la versión 1.0.0, el complemento adopta oficialmente el nombre Admin Essentials para reflejar su naturaleza como suite multi-módulo de utilidades para administradores de Jira. La primera versión incluye el campo Email; futuras versiones añadirán nuevos módulos bajo el mismo paquete.
P: Creé un campo Semáforo, le asigné un valor a un issue y el indicador aparece en gris. ¿Qué falta?
R: El campo Semáforo renderiza en gris mientras el contexto del campo no tenga umbrales (Red max y Yellow max) configurados. Vaya a Administración de Jira > Incidencias > Campos personalizados, abra la configuración del campo, localice la fila Thresholds del contexto correspondiente y haga clic en Edit para definir los umbrales. 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?
R: Sí. Los umbrales del campo Semáforo se guardan por contexto (FieldConfigContext). 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 la página de configuración del campo.
P: ¿El campo Semáforo se puede usar en JQL?
R: Sí. El campo se registra con el Number Range Searcher estándar de Jira, por lo que admite los operadores numéricos habituales (=, <, <=, >, >=). Por ejemplo: "Nivel de cumplimiento" < 30. Recuerde que las consultas operan sobre el valor numérico almacenado, no sobre el color resuelto.