Collegare commit, richieste pull, rami e problemi di GitHub agli elementi di lavoro in Azure Boards

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

Questo articolo illustra come collegare elementi di lavoro a commit, richieste pull e rami di GitHub dopo aver collegato il progetto di Azure Boards a un repository GitHub. È possibile usare la sintassi #mention per i commit e i rami oppure aggiungere un commit, una richiesta pull o un collegamento di ramo gitHub direttamente dall'elemento di lavoro di Azure Boards.

Nota

Con l'app Azure Boards per GitHub, Azure Boards e Azure DevOps Services si integrano con repository GitHub.com e GitHub Enterprise Server. Azure DevOps Server 2019 e versioni successive supportano l'integrazione solo con i repository GitHub Enterprise Server. L'integrazione con altri repository Git non è supportata.

Prerequisiti

• Connessione al progetto: assicurarsi che il progetto di Azure Boards sia connesso al repository GitHub in cui esistono i commit, le richieste pull e il ramo a cui si vuole collegarsi. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub.

• Autorizzazioni: essere un collaboratore sia al progetto di Azure Boards che al repository GitHub.

Nota

I progetti che usano il modello di processo XML ospitato richiedono aggiornamenti ai tipi di elemento di lavoro per visualizzare la sezione Sviluppo e i tipi di collegamento GitHub. Per altre informazioni, vedere Aggiornare le definizioni XML per selezionare i tipi di elemento di lavoro.

Usare AB# per collegare da GitHub agli elementi di lavoro di Azure Boards

Da un commit GitHub, una richiesta pull o un problema, usare la sintassi seguente per creare un collegamento all'elemento di lavoro di Azure Boards. Immettere all'interno AB#ID del testo di un messaggio di commit. In alternativa, per una richiesta o un problema pull, immettere all'interno AB#ID del titolo o della descrizione. L'uso AB#ID di in un commento non crea un collegamento nell'elemento di lavoro.

AB#{ID}

Ad esempio, AB#125 collegamenti all'ID elemento di lavoro 125.

È anche possibile immettere un messaggio di commit o di richiesta pull per eseguire la transizione dell'elemento di lavoro. Il sistema riconosce fix, fixese fixede lo applica all'elemento #-mention che segue. Gli elementi di lavoro menzionati passano al primo Stato associato allo stato della categoria del flusso di lavoro risolto . Se non è associato alcuno stato a Resolved, l'elemento di lavoro passa allo stato dello stato della categoria del flusso di lavoro Completato. Per altre informazioni, vedere How workflow category states are used in Azure Boards backlogs and boards .For more information, see How workflow category states are used in Azure Boards backlogs and boards.

Esaminare la tabella di esempi seguente:

Eseguire il commit o il messaggio di richiesta pull	Azione
Fixed AB#123	Collega e passa l'elemento di lavoro alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato del flusso di lavoro completato .
Adds a new feature, fixes AB#123.	Collega e passa l'elemento di lavoro alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato del flusso di lavoro completato .
Fixes AB#123, AB#124, and AB#126	Collegamenti agli elementi di lavoro di Azure Boards 123, 124 e 126. Esegue la transizione solo del primo elemento, 123 alla categoria Stato del flusso di lavoro risolto o, se non è definito alcun elemento, la categoria Stato flusso di lavoro completato .
Fixes AB#123, Fixes AB#124, Fixes AB#125	Collegamenti agli elementi di lavoro di Azure Boards 123, 124 e 126. Esegue la transizione di tutti gli elementi alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato flusso di lavoro completato .
Fixing multiple bugs: issue #123 and user story AB#234	Collegamenti al problema 123 di GitHub e all'elemento di lavoro di Azure Boards 234. Non vengono effettuate transizioni.

Nota

Se è stato connesso lo stesso repository GitHub ai progetti definiti in due o più organizzazioni di Azure DevOps, è possibile che venga visualizzato un collegamento di riferimento AB# imprevisto. Per altre informazioni, vedere Risolvere i problemi di connessione. Per questo motivo, è consigliabile connettere un repository GitHub solo ai progetti definiti in una singola organizzazione di Azure DevOps.

Quando si aggiunge un collegamento a un elemento di lavoro usando AB#, tali collegamenti vengono visualizzati nella sezione Sviluppo della richiesta pull.

Creare un ramo GitHub dall'elemento di lavoro

Per creare un ramo GitHub direttamente da un elemento di lavoro, seguire questa procedura:

1. Dalla scheda individuare l'elemento di lavoro da cui si vuole creare un ramo GitHub.

2. Selezionare Azioni>elemento di lavoro Nuovo ramo GitHub.

   

3. Nella finestra di dialogo Crea un ramo GitHub immettere il nome del ramo e selezionare il repository GitHub e il ramo di base.

4. Seleziona Crea.

   

   Azure Boards crea il ramo nel repository GitHub specificato e lo collega all'elemento di lavoro. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub.

Aggiungere un collegamento all'elemento di lavoro al ramo GitHub, al commit o alla richiesta pull

1. Aprire l'elemento di lavoro e passare alla scheda Collegamenti .

   

2. Nella finestra di dialogo Aggiungi collegamento selezionare uno dei tipi di collegamento di GitHub, selezionare un repository GitHub, immettere l'URL del ramo GitHub, eseguire il commit o la richiesta pull e quindi selezionare Aggiungi collegamento.

   Nell'esempio seguente viene aggiunto un collegamento a una richiesta pull di GitHub.

   

   Azure Boards completa un controllo per assicurarsi di aver immesso un collegamento valido. Il repository GitHub collegato deve essere connesso al progetto di Azure Boards o la convalida non riesce.

Visualizzare o aprire collegamenti dalla sezione Sviluppo

La sezione Sviluppo all'interno del modulo dell'elemento di lavoro elenca i collegamenti creati ai commit e alle richieste pull di GitHub con l'icona di GitHub.

Scegliere il collegamento fornito per aprire la richiesta di commit o pull in GitHub.

Visualizzare gli oggetti GitHub in una scheda

Con le annotazioni di GitHub abilitate nella scheda, è possibile aprire rapidamente i commit di GitHub collegati, le richieste pull o i problemi per altri dettagli. Per altre informazioni, vedere Personalizzare le schede.

Passaggi successivi

Configurare le notifiche di stato

Articoli correlati

• Integrare Azure Boards con GitHub
• Informazioni sull'uso degli stati di categoria del flusso di lavoro nei backlog e nelle bacheche di Azure Boards
• Collegare elementi di lavoro a oggetti
• Risolvere i problemi di integrazione di GitHub e Azure Boards