Importare ed esportare la configurazione del processo [witadmin]

È possibile personalizzare la configurazione del processo per modificare la visualizzazione delle pagine degli strumenti di pianificazione Agile visualizzate tramite il portale Web di Team Foundation Server (TFS). Alcuni strumenti aggiuntivi richiedono i mapping di stati di flusso di lavoro a mapping di metastati.

Per una panoramica su come personalizzare le pagine degli strumenti di pianificazione Agile, vedere Configurare e personalizzare gli strumenti di pianificazione Agile per il progetto team.

Nota

Se viene visualizzato il messaggio di errore TF400917, è presente una configurazione non valida.Reimportare il file di configurazione del processo nel progetto team mediante witadmin importprocessconfig.Verranno visualizzati i messaggi necessari per risolvere l'errore.

Per gestire la configurazione del processo per un progetto team, usare lo strumento da riga di comando witadmin per esportare e importare il file di definizione XML della configurazione del processo. Per informazioni sulla configurazione del processo, vedere Riferimento all'elemento XML di configurazione del processo.

• exportprocessconfig: esporta la configurazione del processo in un file XML o nella finestra del prompt dei comandi.

• importprocessconfig: importa il file XML di definizione della configurazione del processo.

Lo strumento da riga di comando witadmin funziona solo se viene eseguito in un'istanza locale di TFS. Per eseguire lo strumento, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e digitare:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.

Requisiti

• Per esportare le definizioni della configurazione del processo, è necessario essere un utente valido del progetto team o della raccolta team.

• Per importare le definizioni della configurazione del processo, è necessario essere membro del gruppo di sicurezza Team Foundation Administrators o Project Administrators.

Per altre informazioni, vedere Riferimento alle autorizzazioni per Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Parametri

Parametro	Descrizione
/collection:CollectionURLx	Necessario. Specifica l'URL della raccolta. L'URI deve essere specificato nel formato seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta Se non si specifica una directory virtuale, è necessario specificare l'URI nel formato seguente: http://NomeServer:Porta/NomeRaccolta.
/p:ProjectName	Necessario. Specifica il progetto team per cui si vuole esportare o importare la configurazione del processo. Questo progetto team deve essere definito nell'insieme di progetti team specificata dal parametro /collection. Non è necessario specificare un progetto team quando si specifica l'opzione /v.
/f:FileName	Percorso e nome del file di definizione XML per la configurazione di processo da esportare o importare. Nota Se il computer client esegue Windows Vista, è possibile che non si disponga delle autorizzazioni per determinate cartelle.Se si tenta di esportare un elenco globale in un percorso per cui non si dispone delle autorizzazioni, la tecnologia di virtualizzazione del Registro di sistema reindirizza automaticamente il file esportato e lo salva nell'archivio virtuale.Per altre informazioni, vedere la pagina del sito Web Microsoft relativa alla virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.Per evitare questo reindirizzamento, è possibile esportare il file in un percorso per cui si dispone delle autorizzazioni necessarie.
/e:Encoding	Parametro facoltativo. Nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà usata per esportare o importare i dati XML. Ad esempio, /e utf-7 specifica la codifica Unicode (UTF-7). Se questo parametro viene omesso, witadmin tenta di rilevare la codifica. Se il rilevamento ha esito negativo, usa la codifica UTF-8.
/v	Parametro facoltativo. Convalida l'XML che definisce la configurazione di processo ma non importa il file di definizione.
/? o help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

L'installazione della versione più recente di TFS aggiorna i progetti team esistenti. Se si sta aggiornando un progetto team con una versione aggiornata, vedere Configurare funzionalità dopo un aggiornamento di TFS.

Se si verificano problemi durante l'accesso ai piani di test o ai gruppi di test esistenti dopo un aggiornamento, vedere Update a team project manually to support test management.

Esempi

In ciascun esempio vengono applicati i valori seguenti:

• URL della raccolta: http://AdventureWorksServer:8080/tfs/DefaultCollection

• Progetto team: Contoso

• Numero di porta per il sito Web del server: 8080

Per aggiungere un campo al pannello di aggiunta rapida

È possibile aggiungere campi per qualsiasi pannello di aggiunta rapida. Ad esempio, nell'esempio seguente Valore di business viene aggiunto al pannello di backlog di prodotto.

Nel pannello vengono visualizzati solo i campi inclusi nella sezione FIELDS della definizione di WIT per il WIT selezionato. Ad esempio, se si seleziona il WIT del bug, viene visualizzato solo il titolo perché il valore di business non è definito per i bug. Per aggiungere un altro WIT al pannello, aggiungerlo alla Categoria requisiti come descritto qui.

1. Se non si dispone di autorizzazioni di amministrazione per il progetto team, è necessario ottenerle.

2. Aprire una finestra del prompt dei comandi nel computer in cui è installato Visual Studio o Team Explorer e immettere:

   cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
   

   In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%. È possibile scaricare Team Explorer gratuitamente.

3. Esportare il file di configurazione del processo.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

   Un esempio di CollectionURL è https://Server:8080/tfs/NomeRaccoltaProgettiTeam.

4. Aggiungere il nome di riferimento del campo alla sezione AddPanel.

   Ad esempio, la sintassi seguente aggiunge l'elemento Priorità al pannello.

   <AddPanel>
      <Fields>
         <Field refname="System.Title" />
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />
      </Fields>
   </AddPanel>
   

   Suggerimenti:

   • È possibile cercare il nome di riferimento per un campo tramite l'indice.

   • Aggiungere tutti i campi obbligatori per i tipi di elemento di lavoro definiti per la categoria di requisiti. In questo modo, si evita di dover aprire il form elemento di lavoro per compilare i campi quando si aggiungono elementi backlog dal pannello.

5. Importare i file di configurazione del processo.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. Aggiornare la pagina di backlog per visualizzare il pannello aggiornato.

Aggiornare i mapping a metastati per supportare Gestione test

Se si personalizza la sezione WORKFLOW del piano di test o del gruppo di test, sarà necessario mappare gli stati ai metastati,

Nell'esempio seguente il flusso di lavoro dei piani di test è stato aggiornato per usare gli stati Progettazione, Test e Disconnesso. Per supportare la compatibilità con le versioni precedenti, TestPlanWorkItems è aggiunto alla sezione ProjectProcessConfiguration della definizione della configurazione del processo.

WORKFLOW

Mapping a metastati

<WORKFLOW>       <STATES>         <STATE value="Design" />         <STATE value="Testing" />         <STATE value="Signed Off" />       </STATES>       <TRANSITIONS>         <TRANSITION from="" to="Design">           <REASONS>             <DEFAULTREASON value="New test plan" />           </REASONS>         </TRANSITION>      <TRANSITION from="Design" to="Testing">           <REASONS>             <DEFAULTREASON value="Authoring complete" />           </REASONS>         </TRANSITION>             <TRANSITION from="Testing" to="Signed Off">           <REASONS>             <DEFAULTREASON value="Signed Off testing" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Design">           <REASONS>             <DEFAULTREASON value="Reactivating to authoring phase" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Testing">           <REASONS>             <DEFAULTREASON value="Reactivating to run tests" />           </REASONS>         </TRANSITION>         <TRANSITION from="Testing" to="Design">           <REASONS>             <DEFAULTREASON value="Back to authoring" />           </REASONS>         </TRANSITION>       </TRANSITIONS>     </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">     <States>       <State type="InProgress" value="Design" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Signed Off" />     </States>   </TestPlanWorkItems> <TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">     <States>       <State type="Proposed" value="In Planning" />       <State type="InProgress" value="In Progress" />       <State type="Complete" value="Completed" />     </States>   </TestSuiteWorkItems>

Se si modifica il flusso di lavoro del gruppo di test, sarà necessario eseguire un aggiornamento analogo per mappare i nuovi stati. Eseguire questa operazione tramite l'aggiunta in una sezione TestSuiteWorkItems. Vedere Riferimento all'elemento XML di configurazione del processo.

Domande e risposte

D: Quali personalizzazioni si possono applicare se si continua a usare Configurazione guidata delle funzionalità per aggiornare il progetto team dopo un aggiornamento a TFS?

R: È possibile personalizzare il pannello di aggiunta rapida. Con la procedura guidata Configurazione funzionalità è possibile aggiornare i progetti team e accedere alle ultime funzionalità.

Altre modifiche possono richiedere l'esecuzione di alcune operazioni manuali durante l'aggiornamento del progetto team. Per informazioni sulle personalizzazioni che è possibile applicare e quelle da evitare, vedere la sezione Prima di personalizzare, comprendere le implicazioni di aggiornamento e di manutenzione in Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team.

D: Quando è necessario mappare gli stati dei flussi di lavoro ai metastati?

R: Quando si aggiungono o rimuovono stati dei flussi di lavoro per i tipi di elemento di lavoro seguenti, è consigliabile valutare l'aggiornamento della configurazione del processo per aggiungere o rimuovere i mapping a metastati corrispondenti.

• Tipi di elemento di lavoro appartenenti alla Categoria requisiti o alla Categoria attività: i mapping dei metastati supportano la visualizzazione degli strumenti di pianificazione Agile.

• Tipi di elemento di lavoro appartenenti alla Categoria di bug: mapping di metastati per supportare lo strumento Lavoro personale (progetti team basati su Agile e CMMI).

• Piano di test e gruppo di test: gli aggiornamenti al flusso di lavoro di questi tipi di elemento di lavoro devono essere mappati solo quando si supportano membri del team che si connettono a TFS da una versione di Gestione test basata su Visual Studio 2013.2 o versioni precedenti.

  Aggiornare i mapping ai metastati se si riceve un errore Errore imprevisto rilevato dall'applicazione quando ci si connette al progetto team.

  

Come si risolvono gli errori di configurazione del processo?

R: Quando si apporta una delle modifiche seguenti a un progetto team, sarà necessario aggiornare le definizioni per il tipo di elemento di lavoro, per le categorie o per la configurazione del processo. Per evitare errori, apportare sempre le modifiche nell'ordine seguente: (1) tipi di elemento di lavoro, (2) categorie e (3) configurazione del processo.

Personalizzazione	Aggiornare o verificare la definizione dei tipi di elemento di lavoro	Aggiornare o verificare la definizione della configurazione del processo
Aggiungere un tipo di elemento di lavoro alla Categoria requisiti Un tipo di elemento di lavoro può appartenere alla Categoria requisiti o alla Categoria attività, ma non a entrambe.	Per includere i campi seguenti: Priorità backlog (Scrum) oppure Ordine di priorità (Agile o CMMI) (deve corrispondere al valore di campo assegnato a type=Order nel file di configurazione del processo) Lavoro richiesto (Scrum), Punti della storia (Agile) o Dimensione (CMMI) (deve corrispondere al valore di campo assegnato a type=Effort nel file di configurazione del processo) Percorso di area o valore di campo assegnato a type=Team nel file di configurazione del processo Tutti i campi inclusi nella sezione AddPanel del file di configurazione del processo (i campi devono essere definiti nella sezione FIELDS ma non devono essere necessariamente inclusi nella sezione FORM).	Per includere i mapping a metastati necessari: Mappare l'inizio di ogni stato di flusso di lavoro a type="Proposed" Mappare ogni stato di flusso di lavoro intermedio da visualizzare nell'area Kanban a type="InProgress" Mappare la fine di ogni stato di flusso di lavoro a type="Complete" È possibile mappare solo uno stato a type="Complete" Per includere una voce per definire i codici colore associati al tipo di elemento di lavoro. Ad esempio: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />
Modificare il flusso di lavoro di un tipo di elemento di lavoro nella Categoria requisiti	N/D	Per includere i mapping a metastati necessari illustrati in precedenza per l'aggiunta di un tipo di elemento di lavoro alla Categoria requisiti.
Aggiungere un tipo di elemento di lavoro alla Categoria attività	Per includere i campi seguenti: Priorità backlog (Scrum) oppure Ordine di priorità (Agile o CMMI) Attività (Scrum o Agile) o Disciplina (CMMI) (deve corrispondere al valore di campo assegnato a type=Activity nel file di configurazione del processo) Lavoro rimanente (deve corrispondere al valore di campo assegnato a type=RemainingWork nel file di configurazione del processo) Percorso di area o valore di campo assegnato a type=Team nel file di configurazione del processo (Facoltativo) Lavoro originale e Lavoro completato (solo Agile e CMMI)	Per includere i mapping a metastati necessari: Mappare l'inizio di ogni stato di flusso di lavoro a type="Proposed" Mappare ogni stato di flusso di lavoro intermedio da visualizzare nella lavagna delle attività a type="InProgress" Mappare la fine di ogni stato di flusso di lavoro a type="Complete" È possibile mappare solo uno stato a type="Complete" Per includere una voce per definire i codici colore associati al tipo di elemento di lavoro. Ad esempio: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
Modificare il flusso di lavoro di un tipo di elemento di lavoro nella Categoria attività	N/D	Per includere i mapping a metastati necessari illustrati in precedenza per l'aggiunta di un tipo di elemento di lavoro alla Categoria attività.
Aggiungere un tipo di elemento di lavoro alla Categoria di bug (solo Agile e CMMI) Modificare il flusso di lavoro di un tipo di elemento di lavoro nella Categoria di bug (solo Agile e CMMI)	N/D	Per includere i mapping a metastati necessari: Mappare l'inizio di ogni stato di flusso di lavoro a type="Proposed" Mappare ogni stato di flusso di lavoro intermedio da visualizzare per Lavoro personale a type="InProgress" Mappare la fine di ogni stato di flusso di lavoro a type="Complete" È possibile mappare solo uno stato a type="Complete" Per altre informazioni, vedere Supportare lo stato di aggiornamento dei bug tramite la funzionalità Lavoro personale.
Rimuovere un tipo di elemento di lavoro dalla Categoria requisiti o dalla Categoria attività	N/D	Per rimuovere eventuali mapping a metastati associati solo a tale tipo di elemento di lavoro
Rimuovere un tipo di elemento di lavoro da un progetto team	Per rimuovere il tipo di elemento di lavoro dal file di categorie.	Per rimuovere eventuali mapping a metastati associati solo al tipo di elemento di lavoro rimosso e l'elemento WorkItemColor che definisce il codice colore per il tipo di elemento di lavoro rimosso.

D: Come si personalizzano altre funzioni visualizzate negli strumenti di pianificazione Agile in TWA?

R: Alcune personalizzazioni possono essere eseguite tramite l'interfaccia utente. mentre per altre sono richiesti la configurazione del processo di modifica o altri oggetti del progetto team. Per informazioni generali, vedere Configurare e personalizzare gli strumenti di pianificazione Agile per il progetto team.

D: Si desidera usare due o più backlog di portfolio?

R: L'utilizzo predefinito supporta un livello di backlog di portfolio. È possibile aggiungere fino a cinque livelli come descritto in Aggiungere un backlog a Gestione portfolio Agile.

D: Si desidera aggiungere o modificare i WIT visualizzati nella lavagna delle attività o nel backlog di prodotto?

R: Se si è aggiunto un WIT personalizzato e si desidera aggiungerlo al backlog o alla lavagna delle attività, l'operazione è possibile. Non è possibile visualizzarli in entrambe le posizioni. Per informazioni, leggere Aggiungere tipi di elemento di lavoro a backlog e bacheche/lavagne.