Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
È possibile creare richieste pull per esaminare e unire le modifiche al codice in un repository Git in 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.
Esistono diversi modi per elencare, filtrare, visualizzare e aprire richieste pull per un progetto.
Prerequisiti
I repository devono essere abilitati nel progetto. Se l'hub 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 si trova la richiesta pull, con accesso Basic o versione successiva. Se non si è membri del progetto, viene aggiunto.
Nota
Per i progetti pubblici, gli utenti a cui è concesso l'accesso degli stakeholder hanno accesso completo ad Azure Repos.
I repository devono essere abilitati nel progetto. Se l'hub 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 con accesso basic o versione successiva. Se non si è membri del progetto, viene aggiunto.
In Azure DevOps Services è possibile gestire le richieste pull e altre risorse dall'interfaccia della 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.
Per elencare le richieste pull in un repository specifico in un progetto, passare a tale progetto nel portale Web e selezionare Repos>Pull requests (Richieste pull repository).
Verificare di aver selezionato il repository corretto.
La visualizzazione predefinita mostra le richieste pull nella scheda Mine. Selezionare Attivo per visualizzare tutte le richieste pull attive per il repository corrente. Selezionare Completato o Abbandonato per visualizzare elenchi di richieste pull chiuse.
Selezionare una richiesta pull nell'elenco per passare alla pagina Panoramica della richiesta pull.
È possibile elencare tutte le richieste pull tra progetti diversi nell'organizzazione scegliendo Richieste pull nella visualizzazione Lavoro personale.
Per elencare le richieste pull da Visual Studio, nel menu Git selezionare <Il servizio>>Git Visualizza richieste pull.
Visual Studio 2019 versione 16.8 e versioni successive offre un'esperienza di controllo della versione Git mantenendo al tempo stesso l'interfaccia utente git di Team Explorer . Per usare Team Explorer, deselezionare Strumenti>Opzioni>anteprima Funzionalità>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 pull da Visual Studio Team Explorer:
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 JMESPath consigliata. È possibile copiare una delle query e incollarla dopo il --query parametro 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 richieste pull provenienti da questo ramo di origine.
--status
Limitare i risultati alle richieste pull 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 richieste pull 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 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"predefinita .
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
I comandi dell'interfaccia della riga di comando di Azure DevOps non sono supportati per Azure DevOps Server.
Definire una visualizzazione richiesta pull personalizzata
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.
Per filtrare l'elenco delle richieste pull, nella pagina Richieste pull selezionare l'icona Filtro in alto a destra. Selezionare quindi Ramo di destinazione o un'altra intestazione di colonna e selezionare il ramo o un altro valore da 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 ridisporre le sezioni della visualizzazione corrente, 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 bozza o la data aggiornata. È possibile scegliere se visualizzare le richieste pull approvate o rifiutate in una scheda separata oppure Escludere le richieste pull (duplicati) incluse nelle sezioni precedenti. Al termine della personalizzazione della visualizzazione, selezionare Salva.
Queste visualizzazioni personalizzate creano sezioni separate e collapible nella pagina della richiesta pull. Queste query personalizzate funzionano anche tra repository nella scheda Richieste pull personali della home page dell'organizzazione.
Per modificare i parametri delle visualizzazioni personalizzate, selezionare il pulsante Personalizza accanto alla visualizzazione. In alternativa, selezionare Personalizza visualizzazione e nella schermata Personalizza visualizzazione selezionare la visualizzazione da modificare. Alcune visualizzazioni, ad esempio Assegnate a me, non possono essere personalizzate, ma possono essere riorganizzato o rimosso.
In una scheda File pull è possibile usare diversi filtri per selezionare file e commenti per revisioni più veloci. Selezionare Filtro e quindi selezionare tra le opzioni.
Parola chiave: immettere una parola chiave.
Reviewed/Unreviewed: All (default), Pending, Reviewed.
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 corregge, Chiuso.
Commento 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.
Per filtrare le richieste pull da Visual Studio:
Nel menu Git selezionare< il servizio Git View Pull Requests (Visualizza richieste pull) del servizio>>Git.
Filtra per autore, etichetta o altri attributi.
Dalla visualizzazione Richieste pull di Team Explorer:
Selezionare Attivo o Assegnato all'utente o al team per filtrare gli elenchi delle richieste pull in base allo stato o all'assegnazione della richiesta pull.
In alternativa, digitare qui Tipo per filtrare i campi elenco per filtrare gli elenchi delle richieste pull in base a data, autore, ramo o altri attributi.
È possibile usare diversi parametri az repos pr list per filtrare l'elenco di richieste pull, ad esempio --creator, --project--source-branch--reviewer--status--repository, --target-branche .--top
I --creator valori e --reviewer possono essere nomi visualizzati o indirizzi di posta elettronica. Il --top parametro definisce il numero massimo di richieste pull da elencare.
Ad esempio, per elencare i dettagli sull'ultima richiesta pull creata, indipendentemente dallo stato, usare:
az repos pr list --creator "My Name" --status all --top 1
I comandi dell'interfaccia della riga di comando di Azure DevOps non sono supportati per Azure DevOps Server.
Open a pull request
Quando si apre una richiesta pull dal browser, da Visual Studio o dall'interfaccia della riga di comando di Azure, viene aperta la pagina Panoramica richiesta pull nel browser.
Per aprire una richiesta pull nel browser, selezionare la richiesta pull dall'elenco nella pagina Richieste pull. La richiesta pull si apre alla relativa 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 visualizzare un riepilogo dei criteri dei rami che passano o hanno esito negativo e visualizzano i revisori dei commenti.
Nella scheda File richiesta pull è possibile esaminare le modifiche effettive nei file pr. Nelle schede Aggiornamenti e commit è possibile visualizzare le modifiche apportate dall'autore per aggiornare il ramo pr.
Per aprire una richiesta pull da Visual Studio, nel menu Git selezionare <il servizio>>Git Visualizza richieste pull e quindi selezionare una richiesta pull per aprirla.
In alternativa, nella visualizzazione Richieste pull di Team Explorer fare clic con il pulsante destro del mouse sulla richiesta pull e scegliere 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 richiesta pull e scegliere Checkout Source Branch (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 altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.
Per visualizzare i dettagli per una singola richiesta pull, usare az repos pr show con il parametro obbligatorio --id . Per aprire la richiesta pull nel browser, usare --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
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 --query parametro 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
Usare az repos pr checkout con il parametro obbligatorio --id per estrarre un ramo di richiesta pull in locale, purché non siano presenti modifiche locali.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parametri
Parametro
Descrizione
--id
ID della richiesta pull.
--remote-name
Nome di git remote in base al quale viene generata la richiesta pull. 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
I comandi dell'interfaccia della riga di comando di Azure DevOps non sono supportati per Azure DevOps Server.
Per esaminare le modifiche, apportare commenti o suggerimenti o approvare o votare la richiesta pull, vedere Esaminare le richieste pull.
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.
