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

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

Dopo aver connesso il progetto di Azure Boards con un repository GitHub, è possibile collegare gli elementi di lavoro ai commit e alle richieste pull di GitHub. È possibile aggiungere collegamenti usando la sintassi #mention familiare agli utenti di GitHub oppure è possibile aggiungere un tipo di collegamento di richiesta pull gitHub o commit gitHub dall'elemento di lavoro di Azure Boards.

Nota

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

Prerequisiti

• Il progetto di Azure Boards deve essere connesso al repository GitHub in cui esistono i commit e le richieste pull da collegare a/da. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub.
• È necessario essere un collaboratore al progetto Azure Boards e 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 (non un commento).

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, fixes, fixed e 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, passa allo stato della categoria del flusso di lavoro Completato. Per informazioni sul mapping degli stati e degli stati delle categorie del flusso di lavoro, vedere Come vengono usati gli stati delle categorie del flusso di lavoro nei backlog e nelle bacheche di Azure Boards.

Vedere la tabella seguente di esempi.

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 si è connesso lo stesso repository GitHub ai progetti definiti in due o più organizzazioni di Azure DevOps, è possibile che venga visualizzato un collegamento 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.

Aggiungere un collegamento da un elemento di lavoro a un commit, una richiesta pull o un problema di GitHub

1. Per collegarsi a una richiesta di commit o pull, aprire l'elemento di lavoro e scegliere Aggiungi collegamento nella sezione Sviluppo.

   

   Per collegarsi a un problema, scegliere la scheda Collegamenti e quindi scegliere Aggiungi elemento esistente collegamento>.

   

2. Nella finestra di dialogo Aggiungi collegamento selezionare uno dei tipi di collegamento di GitHub, immettere l'URL per il commit, la richiesta pull o il problema e quindi scegliere OK.
   In questo caso 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.

   In questo caso viene aggiunto un collegamento a un problema di GitHub.

   

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 nella scheda Kanban

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

Passaggi successivi

Configurare le notifiche di stato

Articoli correlati

• Aggiungere o rimuovere repository
• Modificare l'accesso al repository GitHub
• Integrazione di Azure Boards-GitHub
• Modalità di utilizzo 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