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.
Sugerencia
Puede usar AI para ayudar con esta tarea más adelante en este artículo o consulte Habilitación de la asistencia de IA con el servidor MCP de Azure DevOps para empezar.
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.
Uso de IA para administrar elementos de trabajo vinculados a pull requests
Si configura el servidor MCP de Azure DevOps, puede consultar y administrar elementos de trabajo vinculados a solicitudes de incorporación de cambios mediante lenguaje natural.
| Tarea | Ejemplo de sugerencia |
|---|---|
| Buscar elementos vinculados | copilot-prompt Show all work items linked to open pull requests in project <Contoso> |
| Comprobación del estado de finalización | copilot-prompt List work items linked to merged PRs that are still in the Active state in <Contoso> |
| Vincular un elemento de trabajo a un PR | copilot-prompt Link work item #3456 to pull request #789 in project <Contoso> |
| Auditar elementos vinculados a PR | copilot-prompt Show all pull requests merged this sprint with their linked work items for <Contoso> |
| Buscar elementos con enlaces de PR faltantes | copilot-prompt List all completed user stories in Sprint 12 that have no linked pull request in project <Contoso> |
| Detección de vínculos de PR obsoletos | copilot-prompt Find work items linked to pull requests that were abandoned or closed without merging in <Contoso> |
| Verificar que el autocompletado funcionó | copilot-prompt Which work items linked to PRs merged today are still not in the Done or Closed state in project <Contoso>? |
| Seguimiento de la actividad de pr por parte del asignado | copilot-prompt For each team member on <Contoso Team>, list their work items that have linked PRs currently in review |
| Buscar ítems con varias solicitudes de incorporación de cambios | copilot-prompt Show work items in project <Contoso> that are linked to more than one pull request |
| Informe de cobertura de PR del sprint | copilot-prompt What percentage of completed work items in Sprint 12 have at least one linked pull request in <Contoso>? |
Nota:
Si está utilizando Visual Studio Code, el modo agente es especialmente útil para administrar las relaciones de elementos de trabajo y pull requests.
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