Visualización, filtrado y apertura de solicitudes de extracción
Artículo
11 minutos para leer
Gracias.
Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015
Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015
Puede crear solicitudes de extracción (PR) para revisary 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.
Teams requerir las opciones de cambio para los cambios en las ramas protegidas y establecer directivas de rama para que requieran determinados requisitos para cumplir criterios específicos.
Hay varias maneras de enumerar, filtrar, ver y abrir las PR de un proyecto.
Requisitos previos
Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio Azure DevOps para volver a Repos.
Para ver las PR, debe ser miembro del proyecto Azure DevOps en el que se encuentra la pr, con acceso Básico o superior. Si no es miembro del proyecto, obtenga agregado.
Nota
En el caso de los proyectos públicos, los usuarios a los que se concede acceso de las partes interesadas tienen acceso total a Azure Repos.
Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio Azure DevOps para volver a Repos.
Para ver las PR, debe ser miembro del proyecto Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
Para ver o revisar las PR, debe ser miembro del proyecto Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
Para más información sobre los permisos y el acceso, consulte Permisos predeterminados de repositorio y rama de Git y Acerca de los niveles de acceso.
En Azure DevOps Server 2020 y Azure DevOps Services, puede administrar LAS y otros recursos desde la interfaz de la línea de comandos (CLI) de Azure con la extensión . Para obtener información sobre cómo trabajar con la CLI Azure DevOps Services, consulte Introducción a Azure DevOps CLI. Azure Repos comandos de la CLI para pr usan az repos pr.
Enumeración de solicitudes de extracción
Puede enumerar las opciones de solicitud mediante el sitio web Azure DevOps proyecto, Visual Studio o la línea Azure DevOps comandos.
Para enumerar solicitudes de solicitud en un repositorio específico de un proyecto, vaya a ese proyecto en el portal web y seleccioneRepos solicitudes de extracción.
Compruebe que ha seleccionado el repositorio correcto.
La vista predeterminada muestra las OPCIONES en la pestaña Minería. Seleccione Activo para mostrar todas las OPCIONES activas del repositorio actual. Seleccione Completado o Abandonado para mostrar listas de opciones de solicitud cerradas.
Seleccione cualquier PR de la lista para ir a la página Información general de esa pr.
Puede enumerar todos los solicitudes de solicitud en diferentes proyectos de su organización eligiendo Solicitudes de extracción en la vista Mi trabajo.
Administre solicitudes de solicitud que posee o a las que está asignado con la pestaña Solicitudes de extracción de la página Códigos de la web.
Seleccione Activo para mostrar todas las OPCIONES activas del repositorio actual.
Seleccione Completado o Abandonado para mostrar un historial de las opciones de solicitud cerradas.
Puede ver todas las solicitudes de solicitud de acceso de su organización, en todos los proyectos, eligiendo Mis solicitudes de extracción en la página Proyectos.
En Visual Studio 2015, 2017 y 2019, puede acceder a las PR desde Visual Studio Team Explorer.
Seleccione VerTeam Explorer para abrir Team Explorer. También puede presionar Ctrl\ , \++.
En Inicio,seleccione Solicitudes de extracción para ver las listas de solicitudes de solicitud abiertas por usted o asignadas a usted.
Para ver la lista de pr en el portal web Azure DevOps, seleccione Acciones y, a continuación, seleccione Abrir en el explorador.
Para enumerar las PR 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
Descripción
--creator
Limite los resultados a las solicitudes de extracción creadas por este usuario.
--detect
Detectar automáticamente la organización. Valores aceptados: false , true .
--include-links
Incluya _links para cada solicitud de extracción.
--org--organization
Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=<ORG_URL> . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git. Ejemplo: .
--project-p
Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=<NAME_OR_ID> . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git.
--query-examples
Cadena 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 identificador del repositorio.
--reviewer
Limite los resultados a las solicitudes de extracción en las que este usuario sea revisor.
--skip
Número de solicitudes de extracción que se omitirán.
--source-branch-s
Limite los resultados a las solicitudes de extracción que se originan en esta rama de origen.
--status
Limite los resultados a las solicitudes de extracción con este estado. Valores aceptados: abandoned , active , , allcompleted .
--subscription
Nombre o identificador de la suscripción de Azure. Puede configurar la suscripción predeterminada mediante az account set -s <NAME_OR_ID> .
--target-branch-t
Limite los resultados a las solicitudes de extracción destinadas a esta rama.
--top
Número máximo de solicitudes de extracción para enumerar.
Ejemplo
El siguiente comando enumera todas las opciones de solicitud del 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
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
Definición de una vista de solicitud de extracción personalizada
El filtrado de la lista de solicitudes de registro le ayuda a buscar y organizar solicitudes de registro para priorizar los archivos más importantes del flujo de trabajo.
Para filtrar la lista de solicitudes de solicitud de cambio, en la página Solicitudes de extracción, seleccione el icono Filtro en la esquina superior derecha. A continuación, seleccione Rama de destino u otro encabezado de columna y seleccione la rama u otro valor por el que desea filtrar.
Para personalizar aún más la vista de la lista de solicitudes de solicitud de cambio, seleccione Personalizar vista en la esquina superior derecha de la página Solicitudes de extracción.
En la página Personalizar vista, puede reorganizar las secciones de vista actuales, editarlas o quitarlas. Para crear una nueva 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 de actualización. Puede elegir entre Mostrar solicitudes de extracción que he aprobado o rechazado en una pestaña independiente o Excluir solicitudes de extracción (duplicados)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 solicitud de extracción. Estas consultas personalizadas también funcionan entre repositorios en la pestaña Mis solicitudes de extracción 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 vistay, en la pantalla Personalizar vista, seleccione la vista que desea cambiar. Algunas vistas, como Asignado a mí,no se pueden personalizar, pero se pueden reorganizar o quitar.
En una pestaña Archivos de PR, puede usar varios filtros para seleccionar archivos y comentarios para revisiones más rápidas. Seleccione Filtrary, a continuación, seleccione entre las opciones.
Palabra clave: escriba una palabra clave.
Revisado/sin revisar: Todos (valor predeterminado), Pendientey Revisado.
Archivos comentados: Todos los archivos (valor predeterminado), Archivos con comentarios.
Estado del comentario: Activo (valor predeterminado), Pendiente,Resuelto,Tal ycomo está diseñado, No 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 correspondientes de las opciones anteriores.
En la Team Explorer solicitudes de extracción:
Seleccione Activoo Asignado a mí o a mi equipopara filtrar las listas de PR por estado o asignación de la PR.
O bien, escriba aquí el tipo para filtrar los campos de lista para filtrar las listas de PR por fecha, autor, rama u otros atributos.
Puede usar varios parámetros az repos pr list para filtrar la lista de PR, como , , , , , , y --project--repository--reviewer--source-branch--status--target-branch--top .
Los --creator valores y pueden ser nombres para mostrar o direcciones de correo --reviewer electrónico. El --top parámetro define el número máximo de PR que se enumera.
Por ejemplo, para enumerar detalles sobre la última PR que creó, independientemente de su estado, use:
az repos pr list --creator "My Name" --status all --top 1
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
Apertura de una solicitud de incorporación de cambios
Al abrir una PR desde el explorador, desde Visual Studio o desde CLI de Azure, se abre la página Información general de la pr. en el explorador.
Para abrir una solicitud de cambio en el explorador, seleccione la solicitud de solicitud en la lista de la página Solicitudes de extracción. La pr. se abre en su pestaña Información general. La pestaña Información general muestra el título, la descripción, los revisores, los elementos trabajados vinculados, el historial y el estado. Puede ver un resumen de las directivas de rama que pasan o no, y ver los comentarios que los revisores han realizado.
En la pestaña Archivos de PR, puede revisar los cambios reales en los archivos de pr. En las pestañas Actualizaciones y Confirmaciones, puede ver los cambios realizados por el autor para actualizar la rama de pr.
En la Team Explorer solicitudes de extracción, haga clic con el botón derecho en la solicitud de solicitud y seleccione Abrir en el explorador para abrir la solicitud de solicitud en el portal web.
Consulta de una rama
A partir Visual Studio 2017 Update 6, puede consultar la rama de origen de una solicitud de cambio directamente desde la vista Solicitudes de extracción. Haga clic con el botón derecho en una pr. y elija Checkout Source Branch (Extraer rama de origen).
Nota
Si utiliza Visual Studio 2019, versión 16.8 o una posterior, pruebe la experiencia del control de versiones de Git. Obtenga más información sobre las diferencias de Git con respecto de Team Explorer en esta página de comparación en paralelo.
Para mostrar los detalles de una única pr, use az repos pr show con el parámetro obligatorio. Para abrir la PR 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
Identificador de la solicitud de extracción. Requerido.
--detect
Detecte automáticamente la organización. Valores aceptados: false , true .
--open
Abra la solicitud de extracción en el explorador web.
--org--organization
Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=<ORG_URL> . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git. Ejemplo: .
--query-examples
Cadena JMESPath recomendada. Puede copiar una de las consultas y pegarla después del parámetro entre --query 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 identificador 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 SOLICITUD n.º 21, se muestra la salida del comando como una tabla y se abre la solicitud de solicitud 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
Consulta de una rama
Use az repos pr checkout con el parámetro necesario para extraer 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
Identificador de la solicitud de extracción.
--remote-name
Nombre de git remoto en el que se genera la PR. Valor predeterminado: origin.
--subscription
Nombre o identificador de la suscripción de Azure. Puede configurar la suscripción predeterminada mediante az account set -s <NAME_OR_ID> .
Ejemplo
Por ejemplo, para consultar la rama de la PR #21 localmente, use:
az repos pr checkout --id 21
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
Para revisar los cambios, realizar comentarios o sugerencias, o aprobar o votar en la solicitud de cambio, consulte Revisión de solicitudes de extracción.
Visualización y actualización de solicitudes de extracción desde un dispositivo móvil
Puede usar dispositivos móviles para ver todas las Azure Repos de PR y realizar acciones.
