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.