Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Al vincular un elemento de trabajo a una solicitud de incorporación de cambios (PR), puede completar de forma automática esos elementos de trabajo cuando complete la PR. Como alternativa, puede especificar el estado del flujo de trabajo para realizar la transición del elemento de trabajo al combinar el PR.
Esta automatización simplifica el flujo de trabajo de desarrollo asegurándose de que los elementos de trabajo reflejen el estado actual del código sin intervención manual.
Para obtener más información, consulte Creación, visualización y administración de solicitudes de incorporación de cambios.
Requisitos previos
| Categoría | Requisitos |
|---|---|
| Permisos | - Para ver, seguir y editar elementos de trabajo: permisos de Ver los elementos de trabajo de este nodo y Editar elementos de trabajo de este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores dispone de estos permisos. Para obtener más información, consulte Establecimiento de permisos para el seguimiento del trabajo. - Para agregar etiquetas a los elementos de trabajo: permiso de Crear nueva definición de etiqueta en el nivel de proyecto establecido en Permitir. De forma predeterminada, el grupo Colaboradores tiene este permiso. |
| Niveles de acceso |
-
Miembro del proyecto. - Para agregar nuevas etiquetas a los elementos de trabajo o para ver o seguir solicitudes de incorporación de cambios: al menos acceso Básico. - Para ver o seguir elementos de trabajo: al menos acceso de Parte interesada. Para obtener más información, consulte Acerca de los niveles de acceso. - Todos los miembros del proyecto, incluidos los del grupo lectores de , pueden enviar correos electrónicos que contengan elementos de trabajo. |
Autocompletar elementos de trabajo
Para habilitar la finalización automática de elementos de trabajo vinculados al combinar una solicitud de incorporación de cambios, active la casilla Completar elementos de trabajo vinculados después de la combinación, como se muestra en la siguiente imagen. El sistema guarda su selección como valor predeterminado para futuros PR.
Cuando no se produce la finalización automática
El sistema no actualiza automáticamente el estado del elemento de trabajo a categorías Done, Closed o Completed para el tipo de elemento de trabajo (WIT) en las siguientes circunstancias:
- Elemento de trabajo que ya está en estado Resuelto: el elemento de trabajo, cuyo WIT usa el modelo de proceso de herencia, ya está en estado Resuelto. En este caso, el sistema no actualiza el estado. Por ejemplo, si un error derivado del proceso Agile está en estado Resuelto, el sistema no lo pasa a Cerrado.
- Elemento de trabajo ya completado: el elemento de trabajo ya está en la categoría Estado completado. No es necesario realizar ninguna transición posterior.
- Reglas de flujo de trabajo impiden la transición: el WIT incluye reglas de campo de flujo de trabajo que impiden que el elemento de trabajo avance al siguiente estado. Por ejemplo, una regla podría requerir que defina otro campo al cerrar el elemento de trabajo.
- Configuración del flujo de trabajo local: para las implementaciones locales y el modelo de proceso hospedado de Azure Boards, debe modificar el flujo de trabajo para especificar las acciones (elemento ACTION ) que se realizarán al realizar la transición del flujo de trabajo. Para obtener más información, consulte Cambio del flujo de trabajo de un WIT, Especificar acciones.
Para obtener más información sobre la personalización de flujos de trabajo, consulte Personalización de la experiencia de seguimiento del trabajo.
Especificar el estado de flujo de trabajo de los elementos de trabajo vinculados
Para realizar la transición de un elemento de trabajo a un estado de flujo de trabajo específico, escriba la información en la descripción de la solicitud de incorporación de cambios. Anteponga a #ID un estado de flujo de trabajo válido para el elemento de trabajo mencionado. Este enfoque proporciona un control preciso sobre cómo cambian los elementos de trabajo al combinar el código.
En el ejemplo siguiente se muestran casos de usuario que realizan la transición, uno al estado Resuelto y el otro al estado Revisar . El sistema también marca dos tareas como Listo.
Sintaxis para transiciones de estado
Use los siguientes patrones de sintaxis en la descripción de la solicitud de incorporación de cambios para especificar transiciones de estado:
-
Resolves #123- Cambia el elemento de trabajo 123 al estado Resuelto -
Fixes #456- Cambia el elemento de trabajo 456 al estado completado adecuado. -
Closes #789- Transiciona el elemento de trabajo 789 al estado Cerrado -
Review #101- Transición del elemento de trabajo 101 al estado de revisión
El sistema reconoce palabras clave comunes y aplica la transición de estado adecuada en función de la configuración de flujo de trabajo del tipo de elemento de trabajo.
Deshabilitación de la finalización automática de elementos de trabajo asociados
Para deshabilitar la finalización automática de elementos de trabajo asociados cuando los usuarios completan una solicitud de incorporación de cambios, siga estos pasos:
- Vaya a Configuración del> proyectoRepositorios> seleccione el repositorio.
- En la pestaña Configuración, desactive el interruptor para resolver elementos de trabajo mencionados en confirmación.
Al deshabilitar esta configuración, el sistema no permite que las menciones en los comentarios de confirmación cierren los elementos de trabajo (por ejemplo, "Correcciones #123"). Esta configuración afecta tanto a la finalización de solicitudes de incorporación de cambios como a las menciones directas de confirmación.
procedimientos recomendados
Tenga en cuenta estos procedimientos recomendados al usar la finalización automática de elementos de trabajo:
- Revisar los estados del elemento de trabajo: antes de habilitar la finalización automática, asegúrese de que los estados del elemento de trabajo se alinean con las expectativas de flujo de trabajo del equipo.
- Usar transiciones de estado específicas: cuando necesite un control preciso, use la sintaxis de transición de estado en las descripciones de la solicitud de incorporación de cambios en lugar de confiar en el comportamiento de finalización predeterminado.
- Reglas de flujo de trabajo de prueba: compruebe que las reglas de flujo de trabajo personalizadas no impiden las transiciones automáticas de estado.
- Comunicarse con su equipo: asegúrese de que todos los miembros del equipo entiendan cómo afecta la finalización automática al seguimiento de elementos de trabajo.
Solución de problemas
Si los elementos de trabajo no se completan automáticamente según lo previsto, siga estos pasos:
- Comprobar permisos: compruebe que tiene los permisos necesarios para editar elementos de trabajo.
- Revisar reglas de flujo de trabajo: asegúrese de que no hay reglas de campo de flujo de trabajo que impidan la transición de estado.
- Validar vínculos de elementos de trabajo: Confirme que los elementos de trabajo están vinculados correctamente a la pull request.
- Comprobar el estado actual: compruebe que el elemento de trabajo aún no está en estado completado.
- Revisar la configuración del repositorio: asegúrese de que la finalización automática está habilitada en la configuración del repositorio.
Contenido relacionado
- Creación, visualización y administración de solicitudes de incorporación de cambios
- Personalización del flujo de trabajo (proceso de herencia)
- Personalización de la experiencia de seguimiento del trabajo
- Cómo se usan los estados de flujo de trabajo y las categorías de estado en trabajos pendientes y paneles
- Vinculación de elementos de trabajo a otros objetos