Condición de Roles de Proyecto en Transición

La condición Project Roles on Transition (Roles de Proyecto en Transición) restringe la ejecución de una transición del workflow a usuarios que pertenecen a uno o más roles de proyecto específicos. Los usuarios que no pertenecen a ninguno de los roles permitidos no verán la transición disponible en el issue.

Es una forma directa de modelar separación de responsabilidades en el flujo: por ejemplo, restringir que sólo Project Leads puedan cerrar un issue, que sólo QA pueda mover un issue a "Listo para Producción", o que sólo Soporte N2 pueda escalar un ticket.

¿Cuándo usar esta condición?

• Restringir el cierre de issues al rol de líder de proyecto.
• Permitir el paso a "En Producción" únicamente a usuarios del rol Release Manager.
• Reservar la transición "Aprobar" a un rol de Aprobadores definido en el proyecto.
• Limitar la transición "Devolver al Solicitante" al rol Soporte N1 o Mesa de Servicio.

Ventajas frente a condiciones por usuario

Trabajar con roles de proyecto (en lugar de usuarios o grupos globales) permite reutilizar el mismo workflow en varios proyectos: cada proyecto define quién ocupa cada rol y la condición se adapta automáticamente, sin necesidad de duplicar workflows.

Añadir la condición a una transición

1. Navegue a Administración de Jira > Incidencias.
2. En la barra lateral izquierda, dentro de la sección Flujos de Trabajo, haga clic en Flujos de trabajo.
3. Localice el workflow y haga clic en Editar.
4. Seleccione la transición que desea restringir y abra la pestaña Condiciones.
5. Haga clic en Agregar condición.
6. En la lista de condiciones disponibles, seleccione Project Roles on Transition y haga clic en Agregar.
7. Configure los roles permitidos (ver siguiente apartado) y guarde.
8. Publique el workflow para que los cambios entren en vigor.

Configurar los roles permitidos

Al añadir o editar la condición, se mostrará un formulario con:

• Roles permitidos — Selector múltiple con todos los roles de proyecto disponibles en la instancia (por ejemplo, Administrators, Developers, Users, así como los roles personalizados que su organización haya definido).

Marque uno o más roles. La condición se cumple cuando el usuario que intenta ejecutar la transición pertenece a al menos uno de los roles seleccionados en el proyecto del issue.

Al guardar, los roles seleccionados aparecerán resumidos en la lista de condiciones de la transición. Puede editar la condición en cualquier momento.

Comportamiento en la vista del issue

Cuando un usuario abre un issue:

• Si pertenece a al menos uno de los roles configurados en el proyecto del issue, la transición aparece disponible y puede ejecutarla normalmente.
• Si no pertenece a ninguno de los roles configurados, la transición no aparece entre las acciones disponibles del issue. Esto evita que el usuario intente ejecutarla y reciba un error a posteriori.

La evaluación es siempre relativa al proyecto del issue: el mismo usuario puede ver la transición en un proyecto donde tiene el rol y no verla en otro donde no lo tiene, aunque ambos proyectos compartan el mismo workflow.

Combinación con otras condiciones

Puede combinar esta condición con otras condiciones nativas de Jira o con otras condiciones del propio complemento. Por defecto, todas las condiciones se evalúan en AND: el usuario debe cumplirlas todas para que la transición esté disponible.

Ejemplo: aprobación restringida a líderes de proyecto

Supongamos la transición "Aprobar" del workflow de gestión de cambios. Sólo los líderes del proyecto deben poder aprobar:

1. Edite la transición "Aprobar" del workflow.
2. Añada la condición Project Roles on Transition.
3. Seleccione el rol Project Leads (o el nombre que tenga en su instancia).
4. Guarde y publique el workflow.

A partir de entonces, sólo los usuarios que figuren en el rol Project Leads del proyecto verán y podrán ejecutar la transición "Aprobar". El resto de usuarios verán el issue, pero la acción de aprobación no aparecerá entre las disponibles.

Recomendaciones

• Defina los roles de proyecto con nombres claros y consistentes en toda la instancia (Approvers, QA, Release Manager) para facilitar el reuso de workflows entre proyectos.
• Documente en su catálogo de procesos qué rol gobierna cada transición sensible (cierre, aprobación, paso a producción, etc.).
• Combine esta condición con el validador de campos requeridos para reforzar la calidad del dato en las mismas transiciones críticas.

Internacionalización (i18n)

Todos los textos administrativos de la condición (nombre, descripción en el catálogo de Jira y etiquetas del formulario de configuración) están internacionalizados y respetan el idioma del usuario de Jira, con soporte de español e inglés incluido.