Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Quando si collega un elemento di lavoro a una richiesta pull, è possibile completare automaticamente tali elementi di lavoro al termine della richiesta pull. In alternativa, è possibile specificare lo stato del flusso di lavoro per eseguire la transizione dell'elemento di lavoro al momento del merging della pull request.
Questa automazione semplifica il flusso di lavoro di sviluppo assicurando che gli elementi di lavoro riflettano lo stato corrente delle modifiche del codice senza intervento manuale.
Suggerimento
È possibile usare l'intelligenza artificiale per facilitare questa attività più avanti in questo articolo, oppure vedere Abilitare l'assistenza AI con Azure DevOps MCP Server per iniziare.
Per altre informazioni, vedere Creare, visualizzare e gestire le pull request.
Prerequisiti
| Categoria | Requisiti |
|---|---|
| Permissions | - Per visualizzare, seguire e modificare gli elementi di lavoro: Visualizzare gli elementi di lavoro in questo nodo e Modificare gli elementi di lavoro in questo nodo autorizzazioni impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di queste autorizzazioni. Per ulteriori informazioni, vedere Impostare le autorizzazioni per il monitoraggio del lavoro. - Per aggiungere tag agli elementi di lavoro: Creare una nuova definizione di tag a livello di progetto con autorizzazione impostata su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questa autorizzazione. |
| Livelli di accesso |
-
Membro del progetto. - Per aggiungere nuovi tag agli elementi di lavoro o per visualizzare o seguire le pull request: accesso almeno - Per visualizzare o seguire gli elementi di lavoro: accesso almeno di livello Stakeholder. Per altre informazioni, vedere Informazioni sui livelli di accesso. - Tutti i membri del progetto, inclusi quelli nel gruppo Reader, possono inviare messaggi di posta elettronica contenenti elementi di lavoro. |
Completamento automatico degli elementi di lavoro
Per abilitare il completamento automatico degli elementi di lavoro collegati quando si unisce una richiesta pull, selezionare la casella di controllo Completa elementi di lavoro collegati dopo l'unione, come illustrato nell'immagine seguente. Il sistema salva la selezione come predefinita per le richieste pull future.
Quando il completamento automatico non si verifica
Il sistema non aggiorna automaticamente lo stato dell'elemento di lavoro alle categorie Done, Closed o Completed per il tipo di elemento di lavoro (WIT) nelle circostanze seguenti:
- Elemento di lavoro già in stato risolto: l'elemento di lavoro, il cui WIT usa il modello di processo di ereditarietà, è già nello stato Risolto. In questo caso, il sistema non aggiorna lo stato. Ad esempio, se un bug derivato dal processo Agile si trova in uno stato risolto , il sistema non esegue la transizione a Closed.
- Elemento di lavoro già completato: l'elemento di lavoro è già incluso nella categoria Stato completato . Non è necessaria alcuna ulteriore transizione.
- Le regole del flusso di lavoro impediscono la transizione: il WIT include regole di campo del flusso di lavoro che impediscono all'elemento di lavoro di passare allo stato successivo. Ad esempio, una regola potrebbe richiedere di definire un altro campo quando si chiude l'elemento di lavoro.
- Configurazione del flusso di lavoro locale: per le distribuzioni locali e Azure Boards modello di processo ospitato, è necessario modificare il flusso di lavoro per specificare le azioni (ACTION) da eseguire durante la transizione del flusso di lavoro. Per altre informazioni, vedere Modificare il flusso di lavoro per un WIT, Specificare azioni.
Per altre informazioni sulla personalizzazione dei flussi di lavoro, vedere Personalizzare l'esperienza di rilevamento del lavoro.
Specificare lo stato del flusso di lavoro degli elementi di lavoro collegati
È possibile eseguire la transizione di un elemento di lavoro a uno stato specifico del flusso di lavoro immettendo le informazioni nella descrizione della richiesta pull. Anteporre al #ID uno stato del flusso di lavoro valido per l'elemento di lavoro indicato. Questo approccio consente di controllare in modo preciso la transizione degli elementi di lavoro quando si uniscono modifiche al codice.
L'esempio seguente mostra le storie degli utenti che passano, una allo stato Risolto e l'altra allo stato Revisione. Il sistema contrassegna anche due attività come Fine.
Sintassi per le transizioni di stato
Usare i modelli di sintassi seguenti nella descrizione della richiesta pull per specificare le transizioni di stato:
-
Resolves #123- Esegue la transizione dell'elemento di lavoro 123 allo stato risolto -
Fixes #456- Esegue la transizione dell'elemento di lavoro 456 allo stato di completamento appropriato -
Closes #789- Esegue la transizione dell'elemento di lavoro 789 allo stato Chiuso -
Review #101- Esegue la transizione dell'elemento di lavoro 101 allo stato di revisione
Il sistema riconosce le parole chiave comuni e applica la transizione di stato appropriata in base alla configurazione del flusso di lavoro del tipo di elemento di lavoro.
Disabilitare il completamento automatico degli elementi di lavoro associati
Per disabilitare il completamento automatico degli elementi di lavoro associati quando gli utenti completano una richiesta pull, seguire questa procedura:
- Passare a Impostazioni progetto>Repository> selezionare il repository.
- Nella scheda Impostazionidisattivare l'interruttore per Commit menzione risoluzione degli elementi di lavoro.
Quando si disabilita questa impostazione, il sistema non consente menzioni nei commenti di commit per chiudere gli elementi di lavoro(ad esempio, "Correzioni #123"). Questa impostazione influisce sia sul completamento della pull request che sulle menzioni di commit diretto.
Procedure consigliate
Quando si usa il completamento automatico degli elementi di lavoro, prendere in considerazione queste procedure consigliate:
- Esaminare gli stati degli elementi di lavoro: prima di abilitare il completamento automatico, assicurarsi che gli stati dell'elemento di lavoro siano allineati alle aspettative del flusso di lavoro del team.
- Usare transizioni di stato specifiche: quando è necessario un controllo preciso, usare la sintassi della transizione di stato nelle descrizioni delle richieste pull anziché basarsi sul comportamento di completamento predefinito.
- Regole del flusso di lavoro di test: verificare che tutte le regole del flusso di lavoro personalizzate non impediscano transizioni di stato automatiche.
- Comunicare con il team: assicurarsi che tutti i membri del team comprendano il modo in cui il completamento automatico influisce sul rilevamento degli elementi di lavoro.
Risoluzione dei problemi
Se gli elementi di lavoro non vengono completati automaticamente come previsto:
- Controllare le autorizzazioni: verificare di avere le autorizzazioni necessarie per modificare gli elementi di lavoro.
- Esaminare le regole del flusso di lavoro: assicurarsi che nessuna regola del campo del flusso di lavoro impedisca la transizione dello stato.
- Convalidare i collegamenti degli elementi di lavoro: verificare che gli elementi di lavoro siano collegati correttamente alla richiesta pull.
- Controllare lo stato corrente: verificare che l'elemento di lavoro non sia già in uno stato completato.
- Esaminare le impostazioni del repository: verificare che il completamento automatico sia abilitato nelle impostazioni del repository.
Usare l'intelligenza artificiale per gestire i work item collegati alle pull request
Se si configura Azure DevOps MCP Server, è possibile eseguire query e gestire elementi di lavoro collegati alle richieste pull usando il linguaggio naturale.
| Task | Richiesta di esempio |
|---|---|
| Trovare elementi collegati | Show all work items linked to open pull requests in project <Contoso> |
| Controllare lo stato di completamento | List work items linked to merged PRs that are still in the Active state in <Contoso> |
| Collegare un elemento di lavoro a una pull request | Link work item #3456 to pull request #789 in project <Contoso> |
| Verificare gli elementi collegati alla pull request | Show all pull requests merged this sprint with their linked work items for <Contoso> |
| Trovare gli elementi senza collegamenti ai PR | List all completed user stories in Sprint 12 that have no linked pull request in project <Contoso> |
| Rilevare i collegamenti non aggiornati per le richieste pull obsoleti | Find work items linked to pull requests that were abandoned or closed without merging in <Contoso> |
| Verificare che il completamento automatico funzioni | Which work items linked to PRs merged today are still not in the Done or Closed state in project <Contoso>? |
| Tenere traccia dell'attività pull per assegnatario | For each team member on <Contoso Team>, list their work items that have linked PRs currently in review |
| Trova elementi con più pull request | Show work items in project <Contoso> that are linked to more than one pull request |
| Report di copertura PR dello sprint | What percentage of completed work items in Sprint 12 have at least one linked pull request in <Contoso>? |
Annotazioni
Se si usa Visual Studio Code, la modalità agent è particolarmente utile per la gestione delle relazioni tra elementi di lavoro e richieste pull.
Contenuti correlati
- Creare, visualizzare e gestire le richieste pull
- Personalizzare il flusso di lavoro (processo di ereditarietà)
- Personalizza la tua esperienza di monitoraggio del lavoro
- Come sono utilizzati gli stati del flusso di lavoro e le categorie di stato nei backlog e nelle bacheche
- Collegare elementi di lavoro ad altri oggetti