Usare i modelli di elemento di lavoro

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Usare i modelli di elemento di lavoro per creare rapidamente elementi di lavoro con valori di campo predefiniti e applicare aggiornamenti coerenti tra più elementi. Questo articolo illustra come aggiungere e gestire modelli nel portale Web e, per gli ambienti legacy, in Visual Studio 2015 o versioni precedenti. Per esempi, vedere Modelli di elementi di lavoro di esempio.

Usa il portale web per l'esperienza attuale di Azure DevOps. Usare Visual Studio 2015 con Power Tools solo quando l'ambiente dipende ancora dalla gestione dei modelli basata su Team Explorer.

I modelli di elemento di lavoro sono diversi dai modelli di processo. Per altre informazioni, vedere Informazioni sui processi e sui modelli di processo e gli articoli sui modelli di processo predefiniti per Basic, Agile, Scrum e Capability Maturity Model Integration (CMMI).

Scegliere il flusso di lavoro

Usare questa tabella per scegliere il flusso di lavoro corretto.

Se vuoi... Utilizzare... Perché
Acquisire, gestire e applicare modelli nell'esperienza corrente Portale Web (primario) I modelli con ambito di team vengono gestiti in Azure DevOps.
Riutilizzare le impostazioni predefinite gestite centralmente per un team e un tipo di elemento di lavoro Modelli salvati I modelli sono individuabili e riutilizzabili dai membri del team.
Condividere un collegamento rapido che apre un nuovo elemento di lavoro con valori predefiniti URL dei modelli Ideale per la condivisione leggera in dashboard, wiki o messaggi.
Continuare un flusso di lavoro legacy basato su Team Explorer Visual Studio 2015 con Power Tools (legacy) Si applica solo quando l'ambiente dipende ancora da strumenti legacy.

Prerequisiti

Prerequisito Description
Flusso di lavoro del portale Web (primario) - Accesso a un'organizzazione e a un progetto Azure DevOps.
- Per gestire i modelli, essere membri del team proprietario dei modelli.
- Per usare i modelli, disporre dell'accesso collaboratore al progetto.
- Usare un browser supportato e aprire Azure DevOps nel portale Web.
flusso di lavoro Visual Studio 2015 (legacy) - Usare questo flusso di lavoro solo quando l'ambiente dipende ancora dalla gestione dei modelli di Team Explorer.
- Installare Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- I modelli acquisiti in questo flusso di lavoro sono con ambito utente e vengono visualizzati solo in Team Explorer.

Restrizioni per l'uso di modelli

I modelli definiti nel portale Web sono separati dai modelli definiti in Visual Studio.

Tipo di modello Scope Dove è possibile gestirlo e applicarlo
Modello portale Web A livello di team Solo portale Web
modello di Visual Studio A livello di utente solo Visual Studio

È possibile usare l'URL di uno dei due tipi di modello per aggiungere elementi di lavoro tramite il portale Web.

Attività del modello supportate

La disponibilità delle attività modello dipende dalla configurazione del client e della piattaforma. Usare il portale Web per il flusso di lavoro primario Azure DevOps. Usare Visual Studio 2015 con Power Tools solo per scenari preesistenti.

La tabella seguente riepiloga la disponibilità delle attività nel portale Web e nel flusso di lavoro legacy Visual Studio.

Attività predefinita Portale Web Visual Studio
Catturare un elemento di lavoro come modello ✔️ ✔️
Gestire i modelli di elementi di lavoro
(Definire, modificare, eliminare, copiare collegamento, creare copia e rinominare)
✔️ ✔️
Copiare il collegamento (URL) di un modello ✔️ ✔️
Aggiungere un elemento di lavoro usando un modello ✔️ ✔️
Definire un modello di elemento di lavoro ✔️ ✔️
Applicare un modello a uno o più elementi di lavoro ✔️ ✔️
Aggiungere o rimuovere tag dai modelli ✔️
Definire un modello con un collegamento ipertestuale ✔️

Acquisire un elemento di lavoro come modello

Usare la procedura corrispondente al client: portale Web (primario) o Visual Studio 2015 e versioni precedenti (legacy).

Ogni modello acquisito nel portale Web ottiene un GUID univoco. Usare la procedura seguente per acquisire un elemento di lavoro come modello e copiarne il collegamento.

  1. Nel portale Web aprire l'elemento di lavoro da usare come origine del modello.

  2. A destra selezionare Altre azioni>Modelli>Acquisisci:

    Screenshot che mostra come selezionare delle definizioni di campo dell'elemento di acquisizione come opzione modello dal menu Altre azioni.

  3. In Modello di acquisizione configurare i campi obbligatori e facoltativi:

    • Team (obbligatorio): selezionare il team da associare al modello.

    • Nome (obbligatorio): immettere un nome di modello.

    • Campi: usare Aggiungi per includere campi, Elimina per rimuovere i campi e impostare il valore del campo in base alle esigenze.

    • Note: aggiungere il contesto del modello. Quando si crea un elemento di lavoro dal modello, questo testo viene visualizzato come prima voce nel thread Discussione .

    Screenshot che mostra come configurare i campi nella finestra di dialogo Modello di acquisizione nel portale Web.

  4. Selezionare Salva e quindi copia collegamento per copiare l'URL del modello.

    Usare l'URL per creare elementi di lavoro dello stesso tipo con valori predefiniti. Per gli scenari di condivisione più comuni, vedi Creare un elemento di lavoro da un URL del modello e Aggiungere un collegamento a un modello a un dashboard del team.

  5. Verificare che il modello venga visualizzato nell'elenco dei modelli del team selezionato per il tipo di elemento di lavoro e il collegamento copiato apre un nuovo modulo dell'elemento di lavoro con valori predefiniti.

Gestire i modelli di elementi di lavoro

Per ogni tipo di elemento di lavoro, è possibile visualizzare e gestire i modelli definiti dal team. È possibile aggiungere, modificare, copiare, eliminare, rinominare e copiare un collegamento di modello.

Usare questi passaggi per aprire i modelli di elemento di lavoro nel portale Web:

  1. Nel portale web, apri Impostazioni progetto.

  2. In Boards selezionare Configurazione del team.

  3. Se hai bisogno di un team diverso, usa il selettore Team nella barra di navigazione.

  4. Nella pagina Boards selezionare Modelli:

    Screenshot che illustra come accedere all'elenco dei modelli salvati in Azure DevOps da Impostazioni progetto, Boards, Configurazione team, Templates.

  5. Selezionare un tipo di elemento di lavoro, ad esempio Bug, Feature o Test Case, per visualizzare o aggiungere modelli per tale tipo:

    Screenshot dei modelli definiti per il tipo di elemento di lavoro di tipo Bug.

Creare un modello di elemento di lavoro

Usare questi passaggi per creare un modello di elemento di lavoro nel portale Web:

  1. Nella pagina tipo di elemento di lavoro selezionare Nuovo modello:

    Screenshot che mostra come aggiungere un nuovo modello per il tipo di elemento di lavoro Bug.

    Annotazioni

    Se si prevede di usare markdown in un campo di testo di grandi dimensioni, aggiungere <br> tag per gestire le interruzioni di riga e assicurarsi che il rendering del markdown venga eseguito correttamente.

  2. Nella finestra di dialogo Nuovo modello immettere un nome (obbligatorio) e quindi aggiungere eventuali campi e valori facoltativi.

  3. Seleziona Salva. L'opzione Copia collegamento diventa disponibile.

  4. Selezionare Copia collegamento per copiare l'URL del modello.

  5. Verificare che il modello sia elencato per il tipo di elemento di lavoro selezionato e che il collegamento copiato apre un nuovo modulo dell'elemento di lavoro con valori di modello.

Dopo aver salvato un modello, è possibile aggiornarlo, rimuoverlo, copiarne il collegamento o crearne una copia.

Nella pagina tipo di elemento di lavoro selezionare Altre azioni per un modello e quindi scegliere una di queste opzioni:

Screenshot delle opzioni di menu

  1. Verificare che l'elenco di modelli rifletta l'azione (valori aggiornati, elemento rinominato, modello copiato o modello rimosso).

  2. Verificare che il collegamento Copia apre un nuovo modulo dell'elemento di lavoro con i valori del modello previsti.

Aggiungere un elemento di lavoro usando un modello

Usare il collegamento al modello in un browser per creare un elemento di lavoro con valori predefiniti.

  1. Ottieni il link del modello. Per altre informazioni, vedere Modificare, eliminare, copiare un collegamento, creare una copia.

  2. Incollare il collegamento al modello in un browser, completare i campi obbligatori e salvare le modifiche.

  3. Verifica che il nuovo elemento di lavoro si apra con i valori definiti dal modello già popolati prima del salvataggio.

Applicare un modello a elementi di lavoro nuovi o esistenti

Applicare un modello a un elemento di lavoro nuovo o esistente oppure usare un modello per gli aggiornamenti in blocco.

Nel portale Web è possibile applicare un modello in un elemento di lavoro aperto o tra gli elementi di lavoro selezionati.

Applicare un modello all'interno di un elemento di lavoro

Usare questi passaggi per applicare un modello a un elemento di lavoro nuovo o esistente:

  1. Aprire un elemento di lavoro nuovo o esistente da aggiornare con valori definiti dal modello.

  2. Selezionare Altri modelli di azioni> e quindi selezionare il nome di un modello predefinito:

    Screenshot che mostra come applicare un modello a un elemento di lavoro esistente all'interno del modulo.

    Annotazioni

    L'elenco Modelli mostra i modelli definiti per i team di cui si è membri. Se l'elenco è vuoto, potrebbe non essere presente alcun modello per il tipo di elemento di lavoro. Aggiornare il browser per individuare i modelli disponibili più recenti.

  3. Selezionare Salva per applicare il modello. Le modifiche al campo vengono registrate nel campo Cronologia elemento di lavoro.

  4. Verificare che i campi vengano aggiornati nel modulo e la cronologia dell'elemento di lavoro registra le modifiche salvate.

Applicare un modello a diversi elementi di lavoro

Usare questi passaggi per applicare un modello agli elementi di lavoro selezionati per un aggiornamento in blocco:

  1. Selezionare gli elementi di lavoro dal Backlog o da un elenco di risultati di Query. Tutti gli elementi selezionati devono essere dello stesso tipo di elemento di lavoro, ad esempio Bug o Feature.

  2. Selezionare Altri modelli di azioni> per uno degli elementi di lavoro selezionati e selezionare il modello da applicare.

    Screenshot che mostra come applicare un modello a più elementi di lavoro per un aggiornamento in blocco.

    Le modifiche al campo vengono applicate e salvate automaticamente. Le modifiche al campo vengono registrate nel campo Cronologia elemento di lavoro. Per altre informazioni sugli aggiornamenti in blocco, vedere Modificare in blocco gli elementi di lavoro.

  3. Verificare che ogni elemento di lavoro selezionato mostri i valori dei campi aggiornati e le voci cronologia corrispondenti.

Aggiungere o rimuovere tag dai modelli

In Visual Studio 2015 o versioni precedenti è possibile aggiungere tag a un modello. Quando si usa il modello, i tag si applicano automaticamente all'elemento di lavoro. Per aggiungere due o più tag, separarli con una virgola (,). Non è possibile aggiungere tag nel portale Web.

Screenshot della finestra di dialogo Modifica modello che mostra come aggiungere o rimuovere tag.

Se non si specificano tag da rimuovere, tutti i tag in un elemento di lavoro rimangono definiti. I tag rimangono definiti anche quando si applica un modello di elemento di lavoro a un elemento di lavoro esistente.

Verificare in Visual Studio che il modello mantenga i tag configurati e gli elementi di lavoro applicati includano tali tag dopo il salvataggio.

Creare un elemento di lavoro da un URL modello

Creare un URL che apre un nuovo elemento di lavoro con valori di campo predefiniti. Usa questo approccio quando vuoi un collegamento condivisibile a una configurazione comune degli elementi di lavoro.

Usa i modelli salvati per impostazioni predefinite riutilizzabili gestite dal team. Usare gli URL modello quando la condivisione diretta tramite link rappresenta la modalità principale.

  • Usare i modelli salvati quando il team necessita di impostazioni predefinite gestite centralmente.
  • Usare gli URL dei modelli quando è necessaria una condivisione leggera nei dashboard, nei wiki o nei messaggi.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Nell'esempio seguente viene creato un elemento di lavoro Attività con un titolo predefinito, assegnato a, descrizione, tag, attività e percorso di iterazione.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Annotazioni

Alcuni client del browser impongono un limite di 2.000 caratteri per i valori dei campi.

È possibile salvare l'URL come file di testo o aggiungerlo come collegamento ipertestuale in un dashboard o in una pagina Web.

Verificare che l'apertura dell'URL carichi il tipo di elemento di lavoro corretto e mostri i valori di campo predefiniti nel modulo del nuovo elemento di lavoro.

Aggiungi collegamenti ai modelli a un widget Markdown nella dashboard del team nel portale Web. Ogni collegamento apre un nuovo elemento di lavoro con valori di modello predefiniti.

L'esempio seguente mostra un widget Markdown con collegamenti a tre modelli:

Screenshot di un widget Markdown con collegamenti ai modelli.

Per i passaggi di installazione, vedere Aggiungere Markdown a un dashboard, widget Markdown.

Risolvere i problemi relativi ai modelli

  • Il menu Modelli non viene visualizzato: verificare di avere accesso al progetto e di usare il flusso di lavoro supportato dal client.
  • Elenco modelli vuoto nel portale Web: verificare che i modelli esistano per il tipo di elemento di lavoro selezionato e che si sia membri del team proprietario dei modelli. Aggiornare il browser per caricare i modelli più recenti.
  • Non è possibile gestire un modello di team: verificare di essere un membro del team proprietario del modello.
  • Non è possibile applicare un modello a più elementi di lavoro: verificare che tutti gli elementi di lavoro selezionati siano dello stesso tipo di elemento di lavoro.
  • Le opzioni del modello di Visual Studio non sono disponibili: verificare di utilizzare il flusso di lavoro legacy di Visual Studio 2015 e che Microsoft Visual Studio Team Foundation Server 2015 Power Tools sia installato.
  • L'URL del modello viene aperto senza valori previsti: verificare che ogni nome di riferimento di campo sia valido per il tipo di elemento di lavoro di destinazione e che i valori siano codificati con URL (ad esempio, spazi come + o %20).
  • L'URL del modello non viene caricato: verificare che l'URL usi il tipo di organizzazione, progetto e elemento di lavoro corretto e che sia stato eseguito l'accesso a un account con accesso al progetto.
  • Alcuni campi di un modello non vengono popolati: verificare che i campi siano ancora presenti nel tipo di elemento di lavoro e non siano limitati dalle regole di personalizzazione del processo.