Verificare le richieste pull

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

Quando si crea una richiesta pull (PR) e si specificano revisori obbligatori e facoltativi, Azure Repos notifica ai revisori che la richiesta pull è pronta per la revisione. Tutti i revisori necessari devono approvare le modifiche nella pull request prima che possano essere integrate nel ramo di destinazione. Per le pull request che modificano rami critici come main, il team potrebbe avere criteri dei branch che indicano i revisori o richiedono un numero minimo di revisori. Se le politiche dei rami aggiungono revisori facoltativi alla pull request, è possibile mantenerli, richiederli o rimuoverli. Se le politiche del ramo aggiungono revisori obbligatori alla richiesta pull, non è possibile renderli opzionali o rimuoverli. Per informazioni sull'assegnazione di revisori tramite criteri di ramo, vedere Includere automaticamente i revisori del codice.

Quando esamini una PR, fornisci feedback costruttivi, precisi e facili da comprendere. Per altre informazioni, vedere Commenti e suggerimenti sulle richieste pull.

È possibile esaminare solo le pull request di Azure DevOps sul portale web usando il browser.

Prerequisiti

Verificare le modifiche

Le richieste pull consentono ai revisori designati di esaminare, discutere e votare le modifiche proposte prima che tali modifiche vengano unite in un ramo di destinazione. Se gli stessi file vengono modificati sia nei rami di origine che in quello di destinazione, è possibile che vengano visualizzati conflitti di unione. Analizzare attentamente i conflitti e modificare manualmente i file per applicare le modifiche corrette da ogni ramo. L'acquisizione di tutte le modifiche solo dall'origine o solo dalla destinazione con un solo clic può causare la perdita delle modifiche necessarie. È possibile risolvere i conflitti in Azure DevOps o in uno strumento di sviluppo come Visual Studio.

Per altre informazioni, vedere Risolvere i conflitti di merge.

Richiedere una revisione del codice Copilot

È possibile chiedere GitHub Copilot di esaminare una richiesta pull insieme ai revisori umani. Copilot pubblica commenti e suggerimenti direttamente sul codice modificato, in modo da poter risolvere i problemi comuni prima che un revisore umano si disconnette.

Per richiedere una verifica, aprire una richiesta pull e selezionare Request accanto a GitHub Copilot nella sezione Reviewers. Copilot lascia sempre un Commento, quindi il suo feedback non soddisfa i criteri dei revisori obbligatori e non blocca l'operazione di merge.

Questa funzionalità è in anteprima pubblica limitata e richiede l'iscrizione. Per informazioni su configurazione, fatturazione e limiti, consulta Inizia a usare la revisione del codice con Copilot per le pull request.

Esaminare le modifiche come revisore umano

I passaggi seguenti descrivono in che modo i revisori delle pull request in Azure Repos possono esplorare una pull request per comprendere le modifiche proposte:

1. Dal Web browser aprire il progetto team per l'organizzazione Azure DevOps. Scegli Repos>Pull requests per visualizzare l'elenco delle PR. Quando viene aperta una nuova richiesta pull, viene visualizzata per impostazione predefinita nella scheda Panoramica.

2. La scheda Panoramica di una PR mostra il titolo, la descrizione, i revisori, i work item collegati, la cronologia, lo stato e i commenti. Leggere la descrizione della pull request per visualizzare le modifiche proposte. Visualizzare i commenti per comprendere i problemi generati da altri revisori.

   Nota

   Ogni file è contrassegnato con un segno "+" o un'etichetta "rename, edit" accanto al nome per indicare il tipo di modifica. Quando un file ha più del 50% di modifiche, Git lo considera rinominato. Questa soglia è l'impostazione predefinita per i repository Git e non può essere modificata.

   

3. Selezionare la Scheda File per esaminare tutte le modifiche del contenuto nel branch di origine della pull request. La visualizzazione iniziale mostra una visualizzazione riepilogativa di tutte le modifiche apportate ai file. Scegliere il pulsante Visualizza accanto a un file per visualizzare solo le modifiche apportate al file. Se il file è stato modificato, il pulsante Visualizza apre una visualizzazione diff. Se il file è stato aggiunto o eliminato, il pulsante Visualizza apre un riquadro contenuto.

   

   Nota

   Per motivi di prestazioni, la visualizzazione riepilogo non mostra le modifiche per un file di dimensioni superiori a 0,5 MB.

4. In una visualizzazione diff per un file è possibile selezionare un layout side-by-side o Inline diff.

   

   Suggerimento

   Per qualsiasi singolo file di dimensioni superiori a 5 MB, la visualizzazione diff mostra il contenuto del file troncato. Per una visualizzazione diff del contenuto completo, scaricare ed esaminare tali file usando uno strumento diff locale.

   Usare l'albero dei file a sinistra per visualizzare un altro file o selezionare la radice dell'albero dei file per visualizzare una visualizzazione riepilogativa di tutte le modifiche apportate ai file.

5. Per esaminare le modifiche introdotte da specifici push nel ramo di origine, selezionare uno o più set di modifiche dall'elenco a discesa delle modifiche. Quando si seleziona uno o più insiemi di modifiche, la visualizzazione diff viene aggiornata per visualizzare solo le modifiche apportate dagli insiemi di modifiche selezionati. Questa funzionalità è utile quando vengono inviati aggiornamenti alla pull request dopo la tua ultima revisione e vuoi solo vedere le nuove modifiche. L'elenco a discesa delle modifiche nomina ciascun set di modifiche utilizzando il messaggio di commit dall'ultimo commit in ogni operazione di push.

   

   Suggerimento

   Tenere premuto il tasto Shift quando si selezionano più changeset dall'elenco a discesa delle modifiche.

6. Seleziona la scheda Aggiornamenti per visualizzare tutti i set di modifiche inviati e verificare di non aver perso alcuna modifica del ramo di origine. I set di modifiche sono numerati e il set di modifiche più recente viene visualizzato nella parte superiore dell'elenco. Ogni set di modifiche mostra i commit di cui è stato eseguito il push durante l'operazione di push. Un set di modifiche con push forzato non sovrascrive la cronologia dei set di modifiche e viene visualizzato nell'elenco dei set di modifiche come qualsiasi altro insieme di modifiche.

   

7. Scegliere la scheda Commit per visualizzare la cronologia dei commit del ramo di origine dopo la divergenza dal ramo di destinazione. La cronologia dei commit nella scheda Commits viene sovrascritta se l'autore della PR forza il push di una cronologia dei commit diversa, pertanto i commit visualizzati nella scheda Commits potrebbero differire dai commit visualizzati nella scheda Updates.

   

Usare i commenti

Gli autori e i revisori delle richieste pull possono comunicare tra loro aggiungendo e rispondendo ai commenti. Quando esamini una PR, usa i commenti per segnalare eventuali problemi nelle modifiche proposte, suggerire modifiche e rispondere ai commenti precedenti. Mira a fornire un feedback costruttivo che sia preciso e facile da comprendere. Indirizza i destinatari direttamente usando il @username. Fare riferimento agli elementi di lavoro usando #workitemID e alle pull request usando !pullrequestID. In alcuni casi, gli autori di PR creano commenti per se stessi a scopo di documentazione.

Fornire commenti e suggerimenti nei commenti

Se il feedback si applica a una riga o a un intervallo di righe specifico in un file, aggiungere un commento in quella posizione all'interno del file.

1. Nella scheda File di una pull request, passa il puntatore del mouse sulla riga su cui desideri aggiungere un commento e seleziona il pulsante commento per aprire una casella di commento in linea. È anche possibile selezionare più righe e quindi selezionare il pulsante commento visualizzato quando si passa il puntatore del mouse su tali righe.

   

2. Immettere il commento nella casella di commento e scegliere Commento.

   

Se il feedback si applica all'intero file, aggiungere un commento a livello di file selezionando Aggiungi commento dal menu opzioni file:

Per fornire commenti generali non correlati a un file specifico, aggiungere un commento nella scheda Panoramica :

I revisori delle pull request possono anche usare commenti per suggerire modifiche a specifiche righe di file, come descritto nella sezione successiva.

Suggerire modifiche nei commenti

Usare i commenti per suggerire testo sostitutivo per una o più righe in un file:

1. Nella scheda File di una pull request, passa il puntatore del mouse sulla riga su cui desideri aggiungere un commento e seleziona il pulsante commento per aprire una casella di commento in linea. È anche possibile selezionare più righe e quindi selezionare il pulsante commento visualizzato quando si passa il puntatore del mouse su tali righe. Se accettato, il contenuto suggerito sostituisce la riga o le righe a cui è stato aggiunto il commento.

   

2. Selezionare l'icona a forma di lampadina sotto la casella di commento per apportare le modifiche suggerite nella casella di commento all'interno di un blocco di codice delimitato e quindi scegliere Commento. Non viene visualizzata un'icona a forma di lampadina se si aggiunge un commento al codice originale (lato sinistro) di una visualizzazione diff side-by-side.

   

Gli autori delle pull request possono accettare i tuoi suggerimenti:

1. Scegliere Applica modifiche per mettere in scena la modifica in preparazione di un commit.

   

2. Scegliendo Commit tutte le modifiche per eseguire il commit di tutte le modifiche preparate. Gli autori di richieste pull possono rimuovere lo stage di un suggerimento scegliendo Annulla modifica.

   

Modificare o eliminare commenti

Modificare o eliminare il commento passando il puntatore del mouse sul commento e scegliendo l'icona di modifica o eliminazione :

Metti mi piace ai commenti

Gli autori e i revisori delle richieste pull possono mettere Mi piace ai loro commenti o a quelli di un altro utente passando il puntatore del mouse sul commento e scegliendo l'icona a forma di pollice in su:

I commenti con Mi piace mostrano un'icona piena con il pollice in su e il numero di Mi piace. Passare il puntatore del mouse sull'icona a forma di pollice verso l'alto per visualizzare l'elenco delle persone che hanno apprezzato il commento.

Rispondi ai commenti

Gli autori delle pull request devono rispondere ai commenti per far sapere ai revisori come stanno affrontando i feedback e i suggerimenti.

1. Per rispondere a un commento, digitare la risposta nel campo Scrivi una risposta . Indirizza i destinatari direttamente usando il @username. Fare riferimento agli elementi di lavoro usando #workitemID e alle pull request usando !pullrequestID.

   

2. Dopo aver immesso la risposta, selezionare Rispondi e risolvi se la risposta è finale. In caso contrario, selezionare Rispondi.

   

   Se si seleziona Rispondi e risolvi, lo stato del commento cambia in Risolto. Gli autori di richieste pull possono anche modificare direttamente lo stato di un commento, come descritto nella sezione successiva.

Modificare lo stato dei commenti

I nuovi commenti iniziano con lo stato Attivo . Gli autori delle PR aggiornano lo stato durante il processo di revisione per indicare come hanno recepito i commenti e i suggerimenti dei revisori. Gli autori delle richieste pull possono selezionare uno stato di commento dall'elenco a discesa stato:

• Attivo: stato predefinito per i nuovi commenti.
• In sospeso: il problema in questo commento è in fase di revisione e attende qualcos'altro.
• Risolto: il problema in questo commento viene risolto.
• Non verrà risolto: il problema in questo commento viene annotato ma non verrà risolto.
• Chiuso: la discussione in questo commento viene chiusa.

Gli autori e i revisori delle richieste pull possono tenere traccia dello stato delle richieste pull filtrando lo stato dei commenti, come descritto nella sezione successiva.

Filtrare i commenti

È possibile selezionare i commenti o gli aggiornamenti visualizzati nella scheda Panoramica selezionando un'opzione di filtro dall'elenco a discesa filtro commenti. Ad esempio, selezionare l'opzione del filtro Novità per visualizzare nuovi commenti e aggiornamenti dall'ultima volta che è stata aperta la pull request. Ogni opzione di filtro mostra il numero di elementi per la relativa categoria.

Modificare file

Per comodità, gli autori delle pull request possono modificare i file direttamente in Azure Repos. Ad esempio, è possibile accettare la modifica del codice suggerita da un revisore e apportare modifiche simili altrove.

1. Selezionare Repos > Files, selezionare il ramo di origine della richiesta pull, selezionare un file e quindi scegliere Modifica.

   

2. Apportare le modifiche nell'editor e quindi scegliere Commit per aprire la finestra di dialogo Commit .

   

3. Nella finestra di dialogo Commit, modifica il messaggio di commit, se necessario, quindi scegli Commit per eseguire il commit e fare il push delle modifiche sulla tua pull request.

   

Tenere traccia dei file esaminati

I revisori delle richieste pull possono tenere traccia dei file esaminati scegliendo Contrassegna come esaminato dal menu opzioni file oppure selezionando la casella di controllo accanto a un file o a una cartella:

Votare le modifiche alle richieste pull

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Completare una richiesta pull

Gli autori delle PR possono selezionare un'opzione di risoluzione della PR:

• Completa: completa la PR adesso se tutti i revisori obbligatori l'hanno approvata e tutti i criteri del ramo obbligatori sono soddisfatti.
• Imposta il completamento automatico: Completa automaticamente la PR quando tutti i revisori necessari la approvano e tutti i criteri del ramo richiesti sono soddisfatti.
• Contrassegna come bozza: imposta la PR come bozza per indicare che non è pronta per essere esaminata. Per una richiesta pull bozza, selezionare Pubblica per rimuovere lo stato della bozza e contrassegnarlo pronto per la revisione.
• Abbandona: Chiudi la PR. Per ripristinare una PR abbandonata, selezionare Riattiva.

Per altre informazioni, vedere Completare la richiesta pull.

Passo successivo

Articoli correlati

• Introduzione alla revisione del codice di Copilot per le pull request
• Notifiche di aggiornamento delle richieste pull
• Informazioni sulle richieste pull e sulle autorizzazioni