Visualización, filtro y apertura de solicitudes de incorporación de cambios

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Las solicitudes de incorporación de cambios (RR) se crean para revisar y combinar los cambios de código en un repositorio de Git en Azure Repos. Los miembros del equipo y las partes interesadas pueden revisar los cambios y enviar comentarios antes de combinar el código en la rama de destino. Los revisores también pueden comentar los cambios y votar para aprobar o rechazar el código.

Los equipos pueden necesitar solicitudes de incorporación de cambios para cambios en las ramas protegidas y establecer directivas de rama para exigir que determinadas solicitudes de incorporación de cambios cumplan criterios específicos.

Hay varias maneras de enumerar, filtrar, ver y abrir solicitudes de incorporación de cambios para un proyecto.

Requisitos previos

• Repos debe estar habilitado en el proyecto. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.

• Para ver las PR, debe ser miembro del proyecto de Azure DevOps en el que se encuentre la PR, con acceso Básico o superior. Si no es miembro del proyecto, agréguese.

  Nota:

  En el caso de los proyectos públicos, los usuarios con acceso de parte interesada tienen acceso total a Azure Repos.

• Para más información sobre los permisos y el acceso, vea Permisos predeterminados de repositorios y ramas de Git y Acerca de los niveles de acceso.

• En Azure DevOps Services, puede administrar solicitudes de incorporación de cambios y otros recursos desde la interfaz de la línea de comandos (CLI) de Azure con la extensión azure-devops. Para aprender a trabajar con la CLI de Azure DevOps Services, vea Introducción a la CLI de Azure DevOps. Los comandos de la CLI de Azure Repos para las solicitudes de incorporación de cambios usan az repos pr.

Enumerar solicitudes de incorporación de cambios

Puede enumerar las solicitudes de incorporación de cambios mediante el sitio web del proyecto de Azure DevOps, Visual Studio o la línea de comandos de Azure DevOps.

Browser

1. Para enumerar solicitudes de incorporación de cambios en un repositorio específico de un proyecto, vaya a ese proyecto en el portal web y seleccione Repos>Solicitudes de incorporación de cambios.

   

2. Compruebe que ha seleccionado el repositorio correcto.

   

3. En la vista predeterminada se muestran las solicitudes de incorporación de cambios en la pestaña Mías. Seleccione Activas para mostrar todas las solicitudes de incorporación de cambios activas para el repositorio actual. Seleccione Completadas o Abandonadas para abrir listas de solicitudes de incorporación de cambios cerradas.

   Seleccione cualquier solicitud de incorporación de cambios en la lista para ir a su página Información general.

   

4. Puede enumerar todas las solicitudes de incorporación de cambios en diferentes proyectos de la organización si elige Solicitudes de incorporación de cambios en la vista Mi trabajo.

   

Visual Studio

Para enumerar las solicitudes de incorporación de cambios de Visual Studio, en el menú Git, seleccione <el servicio Git>>Ver solicitudes de incorporación de cambios.

Visual Studio 2019, versión 16.8 y versiones posteriores, proporciona una experiencia de control de versiones de Git al tiempo que mantiene la interfaz de usuario de Git de Team Explorer. Para usar Team Explorer, desactive Herramientas>Opciones>Características en versión preliminar>Nueva experiencia de usuario de Git en la barra de menús. Puede usar ejecutar características de Git indistintamente desde cualquier interfaz.

Para acceder a las solicitudes de incorporación de cambios desde Team Explorer de Visual Studio:

1. Conéctese al proyecto desde Visual Studio.

2. Seleccione Ver>Team Explorer para abrir Team Explorer. También puede presionar Ctrl+\, Ctrl+M.

3. En Inicio, seleccione Solicitudes de incorporación de cambios para ver listas de solicitudes de incorporación de cambios que haya abierto lo hayan asignado.

4. Para ver la lista de solicitudes de incorporación de cambios en el portal web de Azure DevOps, seleccione Acciones y después Abrir en el explorador.

   

CLI de Azure DevOps

Para enumerar las solicitudes de incorporación de cambios activas en el proyecto con sus detalles, use az repos pr list.

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org]
                 [--project]
                 [--query-examples]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--subscription]
                 [--target-branch]
                 [--top]

Parámetros

Parámetro	Description
--creator	Limitar los resultados a las solicitudes de incorporación de cambios creadas por este usuario.
--detect	Detectar automáticamente la organización. Valores aceptados: false, true.
--include-links	Incluir _links para cada solicitud de incorporación de cambios.
--org --organization	URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=<ORG_URL>. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.
--project -p	Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=<NAME_OR_ID>. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git.
--query-examples	Cadena de JMESPath recomendada. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que las sugerencias se basen en estas palabras clave.
--repository -r	Nombre o id. del repositorio.
--reviewer	Limitar los resultados a las solicitudes de incorporación de cambios en las que este usuario es un revisor.
--skip	Número de solicitudes de incorporación de cambios que se van a omitir.
--source-branch -s	Limitar los resultados a las solicitudes de incorporación de cambios que se originan en esta rama de origen.
--status	Limitar los resultados a las solicitudes de incorporación de cambios con este estado. Valores aceptados: abandoned, active, all, completed.
--subscription	Nombre o id. de la suscripción de Azure. Puede configurar la suscripción predeterminada mediante az account set -s <NAME_OR_ID>.
--target-branch -t	Limitar los resultados a las solicitudes de incorporación de cambios destinadas a esta rama.
--top	Número máximo de solicitudes de incorporación de cambios que se van a enumerar.

Ejemplo

El comando siguiente enumera todas las solicitudes de incorporación de cambios en el repositorio, independientemente del estado, y muestra la salida en una tabla. En el ejemplo se usa la configuración predeterminada az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos pr list --status all --output table

ID    Created     Creator              Title                                           Status     IsDraft    Repository
----  ----------  -------------------  ----------------------------------------------  ---------  ---------  ------------
11    2021-10-04  jamalh@fabrikam.com  Revert 'Updated parameterized-functions.md'     Completed  False      Fabrikam
10    2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Completed  False      Fabrikam
9     2021-10-04  ke@fabrikam.com      New pull request                                Completed  False      Fabrikam
8     2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Abandoned  False      Fabrikam
7     2021-09-30  jamalh@fabrikam.com  Added note-new-git-tool.md to /                 Completed  False      Fabrikam
6     2021-09-29  jamalh@fabrikam.com  Revert 'Added parameterized-functions.md to /'  Abandoned  False      Fabrikam
5     2021-09-29  jamalh@fabrikam.com  Updated README.md                               Completed  False      Fabrikam
4     2021-09-29  jamalh@fabrikam.com  Added parameterized-functions.md to /           Completed  False      Fabrikam
3     2021-09-28  jamalh@fabrikam.com  WIP New file                                    Abandoned  False      Fabrikam
2     2021-09-28  jamalh@fabrikam.com  Update README.md                                Abandoned  False      Fabrikam
1     2021-09-28  jamalh@fabrikam.com  Edit README.md                                  Completed  False      Fabrikam

Definición de una vista de solicitud de incorporación de cambios personalizada

El filtrado de la lista de solicitudes de incorporación de cambios le ayuda a buscar y organizar las solicitudes de incorporación de cambios para priorizar los archivos más importantes del flujo de trabajo.

Browser

Para filtrar la lista de solicitudes de incorporación de cambios, en la página Solicitudes de incorporación de cambios, seleccione el icono Filtrar en la esquina superior derecha. Después, seleccione Rama de destino u otro encabezado de columna, y seleccione la rama u otro valor por el que quiera filtrar.

Para personalizar aún más la vista de la lista de solicitudes de incorporación de cambios, seleccione Personalizar vista en la esquina superior derecha de la página Solicitudes de incorporación de cambios.

En la página Personalizar vista, puede reorganizar las secciones de vista actuales, editarlas o quitarlas. Para crear una sección, seleccione Agregar sección.

En la página Personalizar sección, escriba y seleccione valores para filtrar la sección por parámetros como el estado de borrador o la fecha actualizada. Puede elegir si quiere Mostrar solicitudes de incorporación de cambios que he aprobado o rechazado en una pestaña independiente, o bien Excluir solicitudes de incorporación de cambios (duplicadas) incluidas en las secciones anteriores. Cuando termine de personalizar la vista, seleccione Guardar.

Estas vistas personalizadas crean secciones independientes contraíbles en la página de la solicitud de incorporación de cambios. Estas consultas personalizadas también funcionan entre repositorios en la pestaña Mis solicitudes de incorporación de cambios de la página principal de la organización.

Para cambiar los parámetros de las vistas personalizadas, seleccione el botón Personalizar situado junto a la vista. O bien, seleccione Personalizar vista y, en la pantalla Personalizar vista, seleccione la vista que quiera cambiar. Algunas vistas, como Asignadas a mí, no se pueden personalizar, pero se pueden reorganizar o quitar.

En una pestaña Archivos de una solicitud de incorporación de cambios, puede usar varios filtros a fin de seleccionar archivos y comentarios para revisiones más rápidas. Seleccione Filtrar y después una de las opciones.

• Palabra clave: escriba una palabra clave.
• Revisado o no revisado: Todo (valor predeterminado), Pendiente, Revisado.
• Archivos comentados: Todos los archivos (valor predeterminado), Archivos con comentarios.
• Comentarios: Mostrar (valor predeterminado), Novedades, Ocultar.
• Estado del comentario: Activo (valor predeterminado), Pendiente, Resuelto, Por diseño, No se corregirá, Cerrado.
• Comentado por: Todos los comentarios (valor predeterminado) o una persona específica.

También puede escribir una cadena en el campo Buscar para mostrar los resultados coincidentes de las opciones anteriores.

Visual Studio

Para filtrar las solicitudes de incorporación de cambios desde Visual Studio:

1. En el menú Git, seleccione <el servicio Git>>Ver solicitudes de incorporación de cambios.

2. Filtre por Autor, Etiqueta u otros atributos.

Desde la vista Solicitudes de incorporación de cambios de Team Explorer:

• Seleccione Activas, o bien Asignadas a mí o a mi equipo, para filtrar las listas de solicitudes de incorporación de cambios por estado o asignación de PR.
• O bien, escriba en los campos Escriba aquí para filtrar la lista para filtrar las listas de solicitudes de incorporación de cambios por fecha, autor, rama u otros atributos.

CLI de Azure DevOps

Puede usar varios parámetros az repos pr list para filtrar la lista de solicitudes de incorporación de cambios, como --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch y --top.

Los valores --creator y --reviewer pueden ser nombres para mostrar o direcciones de correo electrónico. El parámetro --top define el número máximo de solicitudes de incorporación de cambios que se van a enumerar.

Por ejemplo, para enumerar los detalles sobre la última solicitud de incorporación de cambios que ha creado, independientemente de su estado, use lo siguiente:

az repos pr list --creator "My Name" --status all --top 1

Apertura de una solicitud de incorporación de cambios

Al abrir una solicitud de incorporación de cambios desde el explorador, desde Visual Studio o desde la CLI de Azure, se abre la página Información general de la solicitud de incorporación de cambios en el explorador.

Browser

Para abrir una solicitud de incorporación de cambios en el explorador, selecciónela en la lista de la página Solicitudes de incorporación de cambios. La solicitud de incorporación de cambios se abre en su pestaña Información general. En la pestaña Información general se muestra el título de la solicitud de incorporación de cambios, la descripción, los revisores, los elementos de trabajo vinculados, el historial y el estado. Puede ver un resumen de las directivas de rama correctas o con errores, y ver los comentarios que han realizado los revisores.

En la pestaña Archivos de la solicitud de incorporación de cambios, puede revisar los cambios reales en los archivos de solicitud de incorporación de cambios. En las pestañas Actualizaciones y Confirmaciones, puede ver los cambios realizados por el autor para actualizar la rama de la solicitud de incorporación de cambios.

Visual Studio

Para abrir una solicitud de incorporación de cambios desde Visual Studio, en el menú Git, seleccione <el servicio de Git>>Ver solicitudes de incorporación de cambios y, después, seleccione una solicitud de incorporación de cambios para abrirla.

O bien, en la vista Solicitudes de incorporación de cambios de Team Explorer, haga clic con el botón derecho en la solicitud de incorporación de cambios y seleccione Abrir en el explorador para abrirla en el portal web.

Extracción de una rama del repositorio

En Visual Studio 2019, puede extraer del repositorio la rama de origen de una solicitud de incorporación de cambios directamente desde la vista Solicitudes de incorporación de cambios. Haga clic con el botón derecho en una solicitud de incorporación de cambios y elija Extraer rama de origen del repositorio.

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

CLI de Azure DevOps

Para mostrar los detalles de una sola solicitud de incorporación de cambios, use az repos pr show con el parámetro --id obligatorio. Para abrir la solicitud de incorporación de cambios en el explorador, use --open.

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]
                 [--query-examples]
                 [--subscription]

Parámetros

Parámetro	Descripción
--id	Id. de la PR. Requerido.
--detect	Detecta automáticamente la organización. Valores aceptados: false, true.
--open	Abra la solicitud de incorporación de cambios en el explorador web.
--org --organization	URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=<ORG_URL>. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.
--query-examples	Cadena de JMESPath recomendada. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que las sugerencias se basen en estas palabras clave.
--subscription	Nombre o id. de la suscripción de Azure. Puede configurar la suscripción predeterminada mediante az account set -s <NAME_OR_ID>.

Ejemplo

En el ejemplo siguiente se muestran los detalles de la PR 21, la salida del comando como una tabla y se abre la solicitud de incorporación de cambios en el explorador:

az repos pr show --id 21 --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
21    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

Extracción de una rama del repositorio

Use az repos pr checkout con el parámetro --id obligatorio para extraer del repositorio una rama de PR localmente, siempre y cuando no haya cambios locales.

az repos pr checkout --id
                     [--remote-name]
                     [--subscription]

Parámetros

Parámetro	Descripción
--id	Id. de la solicitud de incorporación de cambios.
--remote-name	Nombre del repositorio remoto Git sobre el que se genera la solicitud de incorporación de cambios. Valor predeterminado: origin.
--subscription	Nombre o id. de la suscripción de Azure. Puede configurar la suscripción predeterminada mediante az account set -s <NAME_OR_ID>.

Ejemplo

Por ejemplo, para extraer del repositorio la rama de la PR 21 localmente, use lo siguiente:

az repos pr checkout --id 21

Para revisar los cambios, hacer comentarios o sugerencias, o bien aprobar o votar la solicitud de incorporación de cambios, vea Revisión de las solicitudes de incorporación de cambios.

Visualización y actualización de solicitudes de incorporación de cambios desde un dispositivo móvil

Puede usar dispositivos móviles para ver todas las pantallas de PR de Azure Repos y realizar acciones.

Pasos siguientes

Revisar PR

Artículos relacionados

• Creación de una solicitud de incorporación de cambios
• Notificaciones de actualización de solicitud de extracción
• Completar una solicitud de incorporación de cambios
• Cambiar la rama predeterminada
• Copia de cambios con selección exclusiva
• Acerca de las solicitudes de incorporación de cambios y los permisos