Crear solicitudes de incorporación de cambios

Después de insertar o actualizar una rama de características, Azure Repos muestra un mensaje para crear una solicitud de inserción de solicitudes.

• En la página Solicitudes de extracción:

  

• En la página Archivos:

  

Seleccione Crear una solicitud de extracción para ir a una página en la que puede escribir los detalles de la solicitud de cambio y crear la solicitud de solicitud de cambio.

Después de insertar o actualizar una rama de características, Azure Repos le pide que cree una solicitud de inserción de solicitudes en la vista Código de la web. Este mensaje se muestra en Solicitudes de extracción y archivos.

Seleccione Crear una solicitud de extracción para ir a una página en la que puede escribir los detalles de la solicitud de cambio y crear la solicitud de solicitud de cambio.

Para crear una nueva pr en el proyecto, use az repos pr create. Para abrir la pr en el explorador después de la creación, use el --open parámetro .

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parámetros

Ejemplo

El comando siguiente crea una solicitud de solicitud de acceso desde la rama a la rama predeterminada del repositorio de Fabrikam, abre la solicitud de solicitud en el explorador y muestra la salida del comando newmain 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 create --repository Fabrikam --source-branch new --open --output table

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

Puede agregar muchos otros detalles de la pr en o después de la creación de la pr. Para agregar detalles, revisores, elementos de trabajo y opciones de finalización a la pr, vea Agregar detalles o editar PR.

Puede agregar detalles durante la creación de la pr con az repos pr createo actualizar los detalles en las PR existentes con az repos pr update.

Al crear una pr con , agregue un y un detallado de los cambios para que otros usuarios puedan ver qué problemas az repos pr create--title--description resuelven los cambios. El --description parámetro acepta la entrada Markdown y cada valor del argumento es una nueva línea de la descripción de la pr.

Por ejemplo:

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Mantenga estos campos actualizados para que los revisores puedan comprender los cambios en la pr. Para actualizar los detalles de una pr, use az repos pr update con el parámetro de PR --id necesario.

Por ejemplo, para actualizar el título y la descripción de la PR n.º 21, use:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Puede agregar revisores en la sección Revisores de una pr. nueva o existente. También puede hacer que los revisores opcionales existentes sean necesarios o cambiar los revisores necesarios a opcionales o quitarlos, a menos que la directiva los requiera.

Las directivas de rama pueden requerir un número mínimo de revisores,o incluir automáticamente ciertos revisores opcionales o necesarios en las PR. No se pueden quitar los revisores requeridos por la directiva de rama. Puede cambiar los revisores opcionales de la directiva de rama para que sean necesarios o eliminarlos.

Para ver la directiva de rama que agregó automáticamente un revisor, en la sección Revisores de la página Información general de la PR, haga clic con el botón derecho en Más opciones junto al revisor.

Si el usuario o grupo que quiere revisar la pr. no es miembro del proyecto, debe agregarlo al proyecto para poder agregarlos como revisores.

Para agregar revisores a una nueva pr:

1. En la página Nueva solicitud de extracción, en Revisores,seleccione Buscar usuarios y grupos para agregar como revisores.
2. A medida que escribe un nombre o una dirección de correo electrónico, una lista desplegable muestra una lista de usuarios y grupos que coinciden. Seleccione los nombres de la lista para agregarlos como revisores opcionales.
3. Para agregar los revisores necesarios, seleccione Agregar revisores necesarios y,a continuación, seleccione Buscar para agregar los revisores necesarios para buscar y seleccionar los nombres.

Para agregar revisores a una PR existente:

1. En la sección Revisores de la página Información general, seleccione Agregary, a continuación, seleccione Revisor requerido u Revisor opcional.

   

2. A medida que escribe un nombre o una dirección de correo electrónico, aparece una lista de usuarios o grupos que coinciden. Seleccione los nombres que se agregarán como revisores.

   

Para cambiar un revisor entre obligatorio y opcional, o quitar un revisor, seleccione Más opciones a la derecha del nombre del revisor. Para ver la pertenencia de un grupo o equipo designado como revisor, seleccione el icono del grupo.

Para agregar revisores a la pr.

1. Seleccione la pestaña Información general en la pr.

   

2. Seleccione el botón Agregar en el área Revisores.

3. Escriba el nombre del usuario o grupo que se agregará a la lista de revisores de la pr. Si el usuario no es miembro del proyecto, deberá agregarlo.

4. A medida que escribe un nombre o una dirección de correo electrónico, aparece una lista de usuarios o grupos que coinciden. Seleccione el usuario o grupo de la lista para agregarlo como revisor.

   

Puede agregar revisores opcionales a una pr durante la creación con
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Por ejemplo:

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

Para agregar los revisores necesarios o cambiar los revisores entre opcionales y obligatorios, abra y actualice la pr. en el explorador.

Para administrar revisores de una pr existente, use az repos pr reviewer.

• Para agregar revisores a una pr. existente, use
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Para enumerar los revisores de una pr, use az repos pr reviewer list --id <PR Id> .
• Para quitar revisores de una pr, use az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>" .

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

Parámetros

Para vincular elementos de trabajo a una nueva PR:

1. En la página Nueva solicitud de extracción, en Elementos de trabajo para vincular,seleccione Buscar elementos de trabajo por identificador o título.
2. Comience a escribir un identificador o un título de elemento de trabajo y seleccione el elemento de trabajo que desea vincular en la lista desplegable que aparece.

Para vincular elementos de trabajo a una pr. existente:

1. En la pestaña Información general de la PR, en el área Elementos de trabajo, seleccione .

   

2. Escriba el identificador del elemento de trabajo o busque el título del elemento de trabajo. Seleccione el elemento de trabajo en la lista que aparece.

Para quitar un vínculo de elemento de trabajo, seleccione el icono x situado junto al elemento de trabajo. Al quitar un vínculo solo se quita el vínculo entre el elemento de trabajo y la pr. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Para vincular elementos de trabajo a la PR:

1. Seleccione la pestaña Información general en la pr.

   

2. Seleccione el botón Agregar en el área Elementos de trabajo.

3. Escriba el identificador del elemento de trabajo o busque elementos de trabajo con títulos que coincidan con el texto. Seleccione el elemento de trabajo en la lista que aparece.

Para quitar vínculos de elementos de trabajo, seleccione el botón Quitar que aparece al mantener el puntero sobre el elemento de trabajo. Al quitar un vínculo solo se quita el vínculo entre un elemento de trabajo y una pr. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Para vincular elementos de trabajo a la PR:

1. Seleccione Información general en la pr.

   

2. Seleccione el botón Agregar en el área Elementos de trabajo.

3. Escriba el identificador del elemento de trabajo o busque elementos de trabajo con títulos que coincidan con el texto. Seleccione el elemento de trabajo en la lista que aparece.

Para quitar vínculos de elementos de trabajo, seleccione el botón Quitar que aparece al mantener el puntero sobre el elemento de trabajo. Al quitar un vínculo solo se quita el vínculo entre el elemento de trabajo y la pr. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Puede vincular Azure Boards de trabajo a pr en la creación de pr con , donde Id es el identificador az repos pr create --work-items <Id1> <Id2>< del elemento de > trabajo.

Por ejemplo, el comando siguiente vincula los elementos de trabajo n.º 63 y 64 a una nueva SOLICITUD en la new rama:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Para administrar elementos de trabajo para una pr existente, use az repos pr work-item.

• Para vincular elementos de trabajo a una pr. existente, use az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2> .
• Para enumerar los elementos de trabajo vinculados a una pr, use az repos pr work-item list --id <PR Id> .
• Para desvincular un elemento de trabajo de una pr, use az repos pr work-item remove --id <PR Id> --work-items <Id1> . Al desvincular solo se quita el vínculo entre el elemento de trabajo y la pr. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

Parámetros