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
Questo articolo illustra come collegare gli elementi di lavoro ai commit e alle richieste pull di GitHub dopo aver connesso il progetto di Azure Boards con un repository GitHub. È possibile usare la sintassi #mention o aggiungere un collegamento di commit o richiesta pull di 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 progetto:
- Verificare che il progetto di Azure Boards sia 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.
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.
Nota
Il collegamento a problemi di GitHub richiede Azure DevOps Server 2019 Update 1 o versione successiva.
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.
Creare un ramo GitHub dall'elemento di lavoro
Per creare un ramo GitHub direttamente da un elemento di lavoro, seguire questa procedura:
Dalla scheda individuare l'elemento di lavoro da cui si vuole creare un ramo GitHub.
Selezionare
Azioni>elemento di lavoro Nuovo ramo GitHub.
Nella finestra di dialogo Crea un ramo GitHub immettere il nome del ramo e selezionare il repository GitHub e il ramo di base.
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
Nota
Il collegamento a un problema di GitHub richiede Azure DevOps Server 2019 Update 1 o versione successiva.
Aprire l'elemento di lavoro e passare alla scheda Collegamenti .
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.
Nota
Si verifica un ritardo durante il completamento dei collegamenti AB# se si usa Azure DevOps Server e GitHub Enterprise Server. È disponibile una progettazione "push-and-pull" per eseguire il pull dagli eventi GitHub ogni ora sulle modifiche incrementali in commit, richiesta pull e problema.
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.
