Visualizzare, filtrare e aprire richieste pull

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

Visual Studio 2019 | Visual Studio 2022

Crea richieste di pull per rivedere e integrare modifiche al codice in un repository Git su Azure Repos. I membri del team e gli stakeholder possono esaminare le modifiche e fornire commenti e suggerimenti prima di unire il codice nel ramo di destinazione. I revisori possono anche commentare le modifiche e votare per approvare o rifiutare il codice.

I team possono richiedere PR per le modifiche sui rami protetti e impostare politiche di ramo per richiedere che certi PR soddisfino criteri specifici.

Esistono diversi modi per elencare, filtrare, visualizzare e aprire richieste pull per un progetto.

Prerequisiti

• Repos devono essere abilitati nel progetto. Se l'hub di Repos e le pagine associate non vengono visualizzate, vedere Attivare o disattivare un servizio Azure DevOps per riabilitare Repos.

• Per visualizzare le richieste pull, è necessario essere membri del progetto Azure DevOps in cui è contenuta la richiesta pull, con accesso almeno Basic. Se non si è membri del progetto, viene aggiunto.

  Nota

  Per i progetti pubblici, gli utenti a cui è stato concesso l'accesso stakeholder hanno accesso completo ad Azure Repos.

• Per ulteriori informazioni sulle autorizzazioni e sui livelli di accesso, vedere Autorizzazioni predefinite del repository Git e del ramo e Informazioni sui livelli di accesso.

• In Azure DevOps Services, è possibile gestire le PR e altre risorse dall'interfaccia a riga di comando di Azure con l'estensione azure-devops. Per informazioni su come usare l'interfaccia della riga di comando di Azure DevOps Services, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps. I comandi dell'interfaccia della riga di comando di Azure Repos per le richieste pull usano az repos pr.

Elencare le richieste pull

È possibile elencare le richieste pull usando il sito Web del progetto Azure DevOps, Visual Studio o la riga di comando di Azure DevOps.

Browser

1. Per elencare i pull request in un repository specifico in un progetto, passare a quel progetto nel portale Web e selezionare Repository>Pull request.

   

2. Verificare di aver selezionato il repository corretto.

   

3. La visualizzazione predefinita mostra le richieste pull sotto la scheda Le mie. Selezionare Attive per visualizzare tutte le richieste pull attive per il repository corrente. Selezionare Completato o abbandonato per visualizzare elenchi di richieste pull chiuse.

   Seleziona un PR nell'elenco per andare alla pagina Panoramica di quel PR.

   

4. È possibile elencare tutte le pull request nei diversi progetti dell'organizzazione selezionando Pull requests nella vista Il mio lavoro.

   

Visual Studio

Per elencare le pull request da Visual Studio, nel menu Git selezionare <il servizio Git>>Visualizza Pull Request.

Visual Studio 2019 versione 16.8 e versioni successive offre un'esperienza di controllo della versione Git mantenendo al tempo stesso l'interfaccia utente di Team Explorer Git. Per usare Team Explorer, deselezionare Strumenti>Opzioni>Funzionalità di anteprima>Nuova esperienza utente Git dalla barra dei menu. È possibile eseguire l'esercizio delle funzionalità Git da entrambe le interfacce in modo intercambiabile.

Per accedere alle richieste di pull da Visual Studio Team Explorer:

1. Collegarsi al progetto da Visual Studio.

2. Selezionare Visualizza> Team Explorer per aprire Team Explorer. È anche possibile premere CTRL+\, CTRL+M.

3. Da Home, selezionare Pull Requests per visualizzare gli elenchi di richieste pull aperte da te o assegnate a te.

4. Per visualizzare l'elenco delle richieste pull nel portale Web di Azure DevOps, selezionare Azioni e quindi selezionare Apri nel browser.

   

Azure DevOps CLI

Per elencare le richieste pull attive nel tuo progetto insieme ai dettagli, utilizza 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]

Parametri

Parametro	Descrizione
--creator	Limitare i risultati ai pull request creati da questo utente.
--detect	Riconoscere automaticamente l'organizzazione. Valori accettati: false, true.
--include-links	Includere _links per ciascuna richiesta di pull.
--org --organization	URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=<ORG_URL>. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
--project -p	Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=<NAME_OR_ID>. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.
--query-examples	Stringa consigliata JMESPath. È possibile copiare una delle query e incollarla dopo il parametro --query tra virgolette doppie per visualizzare i risultati. È possibile aggiungere una o più parole chiave posizionali in modo che i suggerimenti siano basati su queste parole chiave.
--repository -r	Nome o ID del repository.
--reviewer	Limitare i risultati alle richieste pull in cui l'utente è un revisore.
--skip	Numero di richieste pull da ignorare.
--source-branch -s	Limitare i risultati alle pull request provenienti da questo ramo di origine.
--status	Limitare i risultati ai pull request con questo stato. Valori accettati: abandoned, active, all, completed.
--subscription	Nome o ID della sottoscrizione di Azure. È possibile configurare la sottoscrizione predefinita usando az account set -s <NAME_OR_ID>.
--target-branch -t	Limitare i risultati alle pull request destinate a questo ramo.
--top	Numero massimo di richieste pull da elencare.

Esempio

Il comando seguente elenca tutte le richieste pull nel repository, indipendentemente dallo stato, e mostra l'output in una tabella. Nell'esempio viene usata la configurazione predefinita 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

Definire una visualizzazione personalizzata per la richiesta di pull

Il filtro dell'elenco delle richieste pull consente di trovare e organizzare le richieste pull in modo da classificare in ordine di priorità i file più importanti nel flusso di lavoro.

Browser

Per filtrare l'elenco delle richieste pull, nella pagina richieste pull, selezionare l'icona filtro in alto a destra. Seleziona quindi ramo di destinazione o un'altra intestazione di colonna e seleziona il ramo o un altro valore su cui desideri filtrare.

Per personalizzare ulteriormente la visualizzazione dell'elenco delle richieste pull, selezionare Personalizza visualizzazione in alto a destra nella pagina Richieste pull.

Nella pagina Personalizza visualizzazione è possibile riorganizzare le sezioni di visualizzazione correnti, modificarle o rimuoverle. Per creare una nuova sezione, selezionare Aggiungi sezione.

Nella pagina Personalizza sezione, immettere e selezionare i valori per filtrare la sezione in base a parametri come lo stato di bozza o la data di aggiornamento. È possibile scegliere se mostrare le pull request che ho approvato o rifiutato in una scheda separatao escludere le pull request (duplicati) incluse nelle sezioni precedenti. Al termine della personalizzazione della visualizzazione, selezionare Salva.

Queste visualizzazioni personalizzate creano sezioni separate e a scomparsa nella pagina della pull request. Queste query personalizzate funzionano anche nei repository nella scheda Le mie richieste pull della home page dell'organizzazione.

Per modificare i parametri delle visualizzazioni personalizzate, selezionare il pulsante Personalizza accanto alla visualizzazione. In alternativa, selezionare Personalizza visualizzazionee nella schermata Personalizza visualizzazione selezionare la visualizzazione da modificare. Alcune visualizzazioni, ad esempio Assegnato a me, non possono essere personalizzate, ma possono essere riorganizzate o rimosse.

Nella scheda File , è possibile usare diversi filtri per selezionare file e commenti per revisioni più veloci. Selezionare Filtroe quindi selezionare tra le opzioni.

• Parola chiave: immettere una parola chiave.
• Revisionato/Non revisionato: Tutte (predefinito), In sospeso, Revisionato.
• File commentati: Tutti i file (impostazione predefinita), File con commenti.
• Commenti: Mostra (impostazione predefinita), Novità, Nascondi.
• Stato commento: attivo (impostazione predefinita), In sospeso, Risolto, Come progettato, Non correggerà, Chiuso.
• Commentato da: Tutti i commenti (impostazione predefinita) o una persona specifica.

È anche possibile digitare una stringa nel campo Cerca per visualizzare i risultati corrispondenti delle opzioni precedenti.

Visual Studio

Per filtrare le richieste pull da Visual Studio:

1. Nel menu Git selezionare <servizio Git>>Visualizzare le richieste pull.

2. Filtrare in base Author, Labelo altri attributi.

Dalla visualizzazione di Team Explorer Pull Requests:

• Selezionare Attivoo Assegnato a me o al mio team, per filtrare gli elenchi delle PR in base allo stato o all'assegnazione.
• Oppure, digitare nei campi qui per filtrare l'elenco per filtrare le liste delle pull request in base a data, autore, ramo o altri attributi.

Interfaccia della riga di comando di Azure DevOps

È possibile utilizzare diversi parametri di az repos pr list per filtrare l'elenco delle Richieste di Pull, ad esempio --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branche --top.

I valori --creator e --reviewer possono essere nomi visualizzati o indirizzi di posta elettronica. Il parametro --top definisce il numero massimo di richieste pull da elencare.

Ad esempio, per elencare i dettagli sull'ultima pull request creata, indipendentemente dallo stato, utilizzare:

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

Aprire una richiesta pull

Quando si apre una richiesta pull dal browser, da Visual Studio o dall'interfaccia della riga di comando di Azure, si apre nel browser la pagina Panoramica.

Browser

Per aprire una Pull request nel browser, selezionala dall'elenco nella pagina Pull requests. La richiesta pull viene visualizzata nella scheda Panoramica . La scheda Panoramica mostra il titolo della richiesta pull, la descrizione, i revisori, gli elementi di lavoro collegati, la cronologia e lo stato. È possibile vedere un riepilogo dei criteri dei rami che sono approvati o respinti e visualizzare i commenti fatti dai revisori.

Nella scheda file richiesta pull è possibile esaminare le modifiche effettive nei file delle richieste pull. Nelle schede Aggiornamenti e e Commits e, è possibile visualizzare le modifiche apportate dall'autore per aggiornare il ramo PR.

Visual Studio

Per aprire una richiesta pull da Visual Studio, nel menu git selezionare servizio GitVisualizza richieste pulle quindi selezionare una richiesta pull per aprirla.

In alternativa, in Team Explorer visualizzazione richieste pull fare clic con il pulsante destro del mouse sulla richiesta pull e selezionare Apri nel browser per aprire la richiesta pull nel portale Web.

Estrazione di un ramo

In Visual Studio 2019 è possibile estrarre un ramo di origine di una richiesta pull direttamente dalla visualizzazione richieste pull . Fare clic con il pulsante destro del mouse su una pull request e scegliere Checkout Source Branch.

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per ulteriori informazioni, consultare confronto affiancato di Git e Team Explorer.

Azure DevOps CLI

Per visualizzare i dettagli di una singola richiesta pull, utilizzare az repos pr show con il parametro --id richiesto. Per aprire il pull request nel tuo browser, usa --open.

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

Parametri

Parametro	Descrizione
--id	ID della richiesta di pull. Obbligatorio.
--detect	Rilevare l'organizzazione automaticamente. Valori accettati: false, true.
--open	Apri la pull request nel tuo browser web.
--org --organization	URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=<ORG_URL>. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
--query-examples	Stringa JMESPath consigliata. È possibile copiare una delle query e incollarla dopo il parametro --query tra virgolette doppie per visualizzare i risultati. È possibile aggiungere una o più parole chiave posizionali in modo che i suggerimenti siano basati su queste parole chiave.
--subscription	Nome o ID della sottoscrizione di Azure. È possibile configurare la sottoscrizione predefinita usando az account set -s <NAME_OR_ID>.

Esempio

L'esempio seguente mostra i dettagli per la richiesta pull #21, mostra l'output del comando come tabella e apre la richiesta pull nel browser:

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

Estrazione di un ramo

Utilizzare az repos pr checkout con il parametro --id necessario per eseguire il checkout di un branch PR localmente, a condizione che non vi siano modifiche locali.

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

Parametri

Parametro	Descrizione
--id	ID della pull request.
--remote-name	Nome del git remote in base al quale viene fatta la pull request. Valore predefinito: origin.
--subscription	Nome o ID della sottoscrizione di Azure. È possibile configurare la sottoscrizione predefinita usando az account set -s <NAME_OR_ID>.

Esempio

Ad esempio, per controllare il ramo per la richiesta pull #21 in locale, usare:

az repos pr checkout --id 21

Per esaminare le modifiche, lasciare commenti o suggerimenti o approvare o votare la pull request, consultare Esaminare le pull request.

Visualizzare e aggiornare le richieste pull da un dispositivo mobile

È possibile usare i dispositivi mobili per visualizzare tutte le schermate pr di Azure Repos ed eseguire azioni.

Passaggi successivi

Esaminare le pull request

Articoli correlati

• Creare una richiesta pull
• notifiche di aggiornamenti delle pull request
• Completare una pull request
• Modificare il ramo predefinito
• Modifiche copiate con cherry-pick
• Informazioni sui pull request e sulle autorizzazioni