Verificare le richieste pull

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

Quando si crea una richiesta pull e si specificano revisori obbligatori/facoltativi, Azure Repos invierà una 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 richieste pull che modificano rami critici come il ramo main, il tuo team potrebbe aver creato delle politiche di ramo che specificano 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.

Se stai esaminando una pull request, prova a fornire un feedback costruttivo che sia preciso e facile da comprendere. Per altre informazioni sul feedback di revisione, vedere Commenti e suggerimenti sulle richieste pull. Questo articolo descrive come esaminare le richieste pull in Azure DevOps.

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

In questo articolo viene spiegato come:

• Verificare le modifiche
• Usare i commenti
• Modificare file
• Tenere traccia dei file esaminati
• Votare le modifiche alle richieste pull
• Completare una richiesta pull

Prerequisiti

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

• Per esaminare le Pull Request, devi essere un membro del progetto Azure DevOps che contiene la PR, con accesso di base almeno .

  • Se non si ha un progetto, crearne uno o iscriverti gratuitamente.

  • Se non si è membri del progetto, farsi aggiungere.

  Nota

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

• Per altre informazioni sulle autorizzazioni e l'accesso, vedere Repository Git predefinito e autorizzazioni di ramo e Informazioni sui livelli di accesso.

È possibile gestire le richieste pull in Azure DevOps Services usando l'interfaccia a riga di comando di Azure DevOps. L'interfaccia della riga di comando di Azure DevOps è disponibile quando si installa l'interfaccia della riga di comando di Azure e l'estensione Azure DevOps. Per un elenco dei comandi dell'interfaccia della riga di comando per gestire le richieste pull, vedere i az repos pr comandi.

Verificare le modifiche

Le richieste pull consentono ai revisori designati di esaminare, discutere e votare le modifiche proposte prima che tali modifiche vengano applicate a un ramo di destinazione di un repository. Tenere presente che se lo sviluppo viene eseguito con gli stessi file in rami diversi, potrebbero verificarsi modifiche in conflitto. In tal caso è necessario analizzare e risolvere attentamente tali conflitti. A tale scopo, potrebbe essere necessario modificare manualmente il file per applicare correttamente le modifiche da origine, destinazione o entrambi i rami. L'acquisizione di tutte le modifiche dall'origine o dalla destinazione (che può essere eseguita con un singolo clic) potrebbe non essere ottimale e può comportare la perdita di alcune modifiche necessarie. Questa operazione può essere eseguita usando gli strumenti ADO o sarà più conveniente usare gli strumenti di sviluppo (ad esempio Visual Studio).

Per ulteriori informazioni, vedere Risoluzione dei conflitti di unione.

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. Scegliere Repo > 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 richiesta di pull mostra il titolo, la descrizione, i revisori, gli elementi di lavoro 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 viene valutato in base al numero di modifiche ed è contrassegnato con un segno "+" o un'etichetta "rinomina, modifica" accanto al nome. Quando un file ha modifiche superiori al 50%, viene considerato rinominato. Questa è la soglia predefinita per i repository Git che non possono essere modificati.

   

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 mostrerà 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 sono state apportate modifiche alla pull request dopo l'ultima revisione e si desidera visualizzare 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. Scegliere la scheda Aggiornamenti per visualizzare tutti i set di modifiche pubblicati per assicurarsi 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 sovrascriverà la cronologia del set di modifiche e verrà 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 Commit verrà sovrascritta se l'autore della richiesta pull esegue un push forzato di una cronologia di commit diversa, pertanto i commit visualizzati nella scheda Commit potrebbero differire dai commit visualizzati nella scheda Aggiornamenti.

   

Esaminare i file

Selezionare la scheda Files per visualizzare le modifiche effettive apportate al ramo di origine accanto al ramo di destinazione della richiesta pull.

Nota

le diverse modifiche tra la richiesta pull di Azure DevOps e il confronto dei rami di Azure DevOps dipendono dai diversi metodi di confronto.

Esistono due metodi di confronto per il comando git diff: a due punti (git diff A..B) e a tre punti (git diff A...B). Per impostazione predefinita, le richieste pull mostrano un diff a tre punti mentre il confronto tra rami mostra invece un diff a due punti.

Ad esempio:

      C---D---E branch
     /
A---B---F---G   master

Richieste pull: git diff branch...master produrrà solo commit C, D, E. Confronto tra rami: git diff branch..master produrrà i commit C, D, E, F, G.

Per altri dettagli, vedere three-dot-and-two-dot-git-diff-comparisons e git diff

Nota

Quando si visualizza la differenza per un singolo file selezionato, è previsto un limite di dimensioni del file di 5 MB. Per visualizzare e diff i file di dimensioni superiori a 5 MB, è possibile scaricare il file e visualizzarlo usando uno strumento diff locale. Quando si visualizza la differenza per una raccolta di file, il limite di dimensioni per ogni file è 0,5 MB, per motivi di prestazioni.

Esaminare gli aggiornamenti

Esaminare le versioni precedenti del codice dall'elenco a discesa Tutti gli aggiornamenti .

Ogni aggiornamento al ramo aggiunge una nuova versione all'elenco e nella scheda 'Aggiornamenti' della pull request. Quando si selezionano aggiornamenti diversi, la vista delle differenze viene aggiornata per mostrare le differenze tra i file in ogni versione del pull request.

È possibile recuperare gli aggiornamenti delle PR dopo esserti allontanato dalle PR, rivisitando i cambiamenti apportati dalla tua ultima revisione.

Esplorare un elenco delle modifiche apportate dall'autore nella scheda Aggiornamenti .

Visualizza e seleziona le modifiche apportate ai commit del ramo nella scheda dei Commit.

Usare i commenti

Gli autori e i revisori delle richieste pull possono comunicare tra loro aggiungendo e rispondendo ai commenti. Quando si esamina una pull request, usare i commenti per segnalare problemi con le 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

È possibile 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 sostituirà 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 verrà visualizzata un'icona a forma di lampadina se si aggiunge un commento al codice originale (a sinistra) 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

È possibile 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 a forma di pollice in alto 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 ai pull request tramite !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 cambierà 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 hanno inizialmente lo stato "Attivo", che gli autori delle richieste pull aggiornano durante il processo di revisione delle richieste pull per indicare come hanno affrontato il feedback 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, potrebbe essere stata accettata la modifica del codice suggerita da un revisore e si desidera apportare modifiche simili altrove.

1. Scegliere File del repository>, selezionare il ramo di origine della pull request, 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 delle pull request

Browser

I revisori delle pull request possono votare su una pull request selezionando un'opzione di voto nell'elenco a discesa. L'icona del revisore nella pagina della pull request mostrerà un'indicazione del loro voto.

Le opzioni di voto sono:

• Approva: approva le modifiche proposte nella pull request. Questa opzione è solo un voto e non approva il PR.

• Approva con suggerimenti: approva le modifiche proposte nel pull request con suggerimenti facoltativi per il miglioramento. Questa opzione è solo un voto e non approva il PR.

• Attendere l'autore: chiede all'autore di esaminare i commenti del revisore. L'autore della richiesta pull deve informare i revisori di rivalutare il codice dopo che l'autore della richiesta pull ha risolto i commenti. Se un revisore obbligatorio imposta questa opzione di voto, il voto bloccherà l'approvazione della pull request.

• Rifiuta: indica che le modifiche non sono accettabili. Quando si sceglie questa opzione, aggiungere un commento che spiega perché. Se un revisore obbligatorio imposta questa opzione di voto, il voto bloccherà l'approvazione della richiesta pull.

• Reimposta feedback: elimina il tuo voto. L'assenza di un voto non impedisce a una richiesta pull di essere completata.

Interfaccia della riga di comando di Azure DevOps

Per votare se approvare una richiesta pull, usa il comando az repos pr set-vote.

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

Parametri

Parametro	Richiesto	Descrizione
--id	Sì	ID della pull request
--vote	Sì	Nuovo valore di voto per la richiesta pull (valori accettati: approve, approve-with-suggestionsreject, reset, o wait-for-author)
--detect	No	Rilevare automaticamente l'organizzazione (valori accettati: false, true)
--organization	Sì, se un'organizzazione predefinita non è impostata e il file di configurazione Git non specifica l'organizzazione	URL dell'organizzazione di Azure DevOps o impostare un'organizzazione predefinita usando: az devops configure -d organization=<organization URL>
--subscription	No	Nome o ID di una sottoscrizione di Azure oppure impostare una sottoscrizione predefinita usando: az account set -s <name or ID>

Esempi

Il seguente comando voterà per approvare la pull request #21. Il comando restituisce una tabella.

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

Il comando seguente rimuove il voto. Il comando restituisce una tabella.

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 di integrazione

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

• Completa: completa la pull request ora se tutti i revisori necessari l'hanno approvata e vengono soddisfatti tutti i criteri per il ramo necessari.

• Completamento automatico: completa automaticamente la richiesta pull quando tutti i revisori necessari l'approvano e tutte le politiche del ramo richieste sono soddisfatte.

• Contrassegna come bozza: impostare la richiesta pull allo stato bozza per indicare che non è pronta per la revisione. Per una bozza di richiesta pull, puoi selezionare Pubblica per rimuovere lo stato di bozza e segnarlo come pronto per revisione.

• Abbandona: chiudi la richiesta pull. Per una richiesta pull abbandonata, è possibile selezionare Riattiva per ripristinarla.

Per ulteriori informazioni sul completamento di una richiesta pull, vedere Completare la richiesta pull.

Passaggi successivi

Completare la richiesta pull

Articoli correlati

• Notifiche di aggiornamento delle richieste pull
• Informazioni sulle richieste pull e sulle autorizzazioni