Validador de Campos Requeridos

El validador Fields Required (Admin Essentials) bloquea una transición de workflow cuando uno o más campos del issue están vacíos en el momento de ejecutarla. Es útil cuando un estado del workflow exige información mínima para avanzar (por ejemplo, "Resuelto" sin la causa raíz informada o "En Revisión" sin un responsable asignado).

A diferencia de marcar un campo como obligatorio a nivel global, este validador permite definir qué campos se exigen en cada transición individual, sin afectar otras pantallas ni otros estados del workflow.

¿Cuándo usar este validador?

• Asegurar que un issue tenga un comentario antes de cerrarse.
• Exigir que se complete la causa raíz, el impacto o el plan de acción antes de pasar a "En Análisis".
• Garantizar que un issue tenga estimación o fecha de vencimiento antes de moverse al estado "En Curso".
• Forzar que el campo Assignee esté informado antes de tomar una transición de aceptación.

Recuerde

El validador no añade los campos a la pantalla de transición ni modifica el resto del workflow: solamente comprueba que estén informados al ejecutar la transición. Si quiere que el usuario los rellene durante la transición, asegúrese de que los campos estén incluidos en la pantalla de transición correspondiente.

Añadir el validador a una transición

1. En Jira, abra la configuración del workflow que desea modificar.

   • Para workflows asociados a un proyecto: Project settings → Workflows → Edit.
   • Para workflows globales: Jira settings → Issues → Workflows → Edit.

2. Seleccione la transición a la que quiere añadir la regla.

3. Abra la pestaña Validators (Validadores).

4. Haga clic en Add validator.

5. En la lista de validadores disponibles, seleccione Fields Required (Admin Essentials) y haga clic en Add.

   

6. Configure los campos exigidos (ver siguiente apartado) y guarde.

7. Publique el workflow para que los cambios entren en vigor.

Configurar los campos requeridos

Al añadir o editar el validador se abrirá su panel de configuración (una Custom UI servida por Forge), donde encontrará tres bloques:

1. Lista dual de campos

A la izquierda, Available fields (Campos disponibles) lista todos los campos personalizados y estándar de Jira que pueden marcarse como requeridos. A la derecha, Required fields (Campos requeridos) muestra los que ya forman parte de la regla.

• Haga clic en un campo de la lista izquierda y use el botón → para añadirlo a la lista de requeridos.
• Haga clic en un campo de la derecha y use el botón ← para retirarlo.
• Use la caja de búsqueda superior para filtrar por nombre.

2. Mensaje de error personalizado (opcional)

Introduzca el texto que se mostrará al usuario cuando la transición sea bloqueada por falta de campos. Si lo deja en blanco, se usará el mensaje por defecto del complemento, que incluye automáticamente la lista de campos faltantes.

3. Ignorar contexto

La casilla Ignore context controla el comportamiento del validador frente a campos personalizados que no están configurados para el proyecto o el tipo de issue actual:

• Desactivada (por defecto): los campos no aplicables al contexto del issue se omiten silenciosamente. Útil cuando un mismo workflow se usa en varios proyectos con esquemas de campos distintos.
• Activada: los campos se exigen siempre, incluso si no están configurados para el contexto. Útil para detectar contextos mal configurados (el usuario verá un error al transicionar).

Al guardar, los campos seleccionados aparecerán resumidos en la lista de validadores de la transición. Puede editar el validador en cualquier momento para añadir o quitar campos.

Comportamiento en tiempo de transición

Cuando un usuario intenta ejecutar la transición:

• Si todos los campos requeridos están informados, la transición se ejecuta con normalidad.
• Si uno o más campos están vacíos, la transición se aborta y Jira muestra un mensaje de error indicando con claridad qué campos faltan por completar. El issue permanece en el estado anterior y no se registra ningún cambio.

Los campos se consideran "informados" cuando contienen un valor distinto de vacío según las reglas estándar de Jira (texto no vacío, número informado, fecha seleccionada, al menos un usuario en un campo de selección de usuarios, etc.).

Combine con pantallas de transición

Para obtener la mejor experiencia, recomendamos asociar a la transición una pantalla que contenga los campos exigidos. Así el usuario verá los campos a rellenar antes de confirmar la transición, en lugar de descubrir el error al final.

Ejemplo: cierre de issue con resolución y comentario

Supongamos la transición "Resolver" del workflow de un proyecto de soporte. El equipo necesita que ningún issue se cierre sin resolución y comentario de cierre.

1. Edite la transición "Resolver" del workflow.
2. Añada el validador Fields Required (Admin Essentials).
3. En la lista dual, pase a la derecha:
   • Resolution (Resolución)
   • Comment (Comentario)
4. (Opcional) Introduzca el mensaje personalizado: "Para cerrar el ticket, debe registrar la resolución y un comentario explicativo del cierre."
5. Guarde y publique el workflow.

A partir de ese momento, cualquier intento de ejecutar "Resolver" sin esos campos informados será bloqueado con el mensaje configurado.

Diferencias clave frente a la versión Data Center

Aspecto	Data Center	Cloud (Forge)
UI de configuración	Plantilla Velocity nativa de Jira	Custom UI servida por Forge
Ejecución de la validación	Plugin Java en el servidor	Jira expression generada al guardar
Campos de pantalla de transición	Soporte directo	Soporte equivalente (ver nota técnica)
Workflows globales	Sí	Sí

Nota técnica sobre la generación de la Jira expression

En Cloud el validador no evalúa los campos en tiempo de transición ejecutando código Java. En su lugar, la Custom UI genera una Jira expression al guardar la configuración, que codifica la regla "todos los campos seleccionados deben tener valor". Jira ejecuta esa expresión nativamente durante la transición. Esto garantiza la misma confiabilidad que la validación nativa de Jira, sin penalización de rendimiento.