Aggiungere un campo e modificare il layout di un tipo di elemento di lavoro esistente

Articolo
03/12/2013

Per tenere traccia dei dati aggiuntivi per un elemento di lavoro, è possibile aggiungere un campo a un tipo di elemento di lavoro, visualizzare nel form dell'elemento di lavoro e renderlo segnalabile.È inoltre possibile modificare il layout di un form di elemento di lavoro al meglio per le esigenze del team.In questo argomento, Julia e Peter, membri del team Fabrikam Fiber, personalizzano due diversi tipi di elementi di lavoro per supportare gli obiettivi di rilevamento.

Per tenere traccia delle richieste per le nuove funzionalità prodotte, Julia aggiunge un campo personalizzato con un menu a discesa di opzioni e modifica il layout del form elemento di lavoro per l'elemento di backlog del prodotto.Julia esegue cinque attività per aggiungere un campo personalizzato con un elenco di opzioni a discesa e modificare il layout del form elemento di lavoro per l'elemento di backlog del prodotto.
Per tracciare in maniera migliore il lavoro e migliorare la sua abilità e quella del gruppo nello stimare il lavoro, Peter aggiunge un campo al tipo di elemento di lavoro attività.

Come illustrato, Julia e Peter eseguono indipendentemente le loro attività, ma in una sequenza prescritta.

Cambia il layout di un form dell'elemento di lavoro.

Sequenza per aggiungere un campo a un tipo di elemento di lavoro

Aggiungere un campo a un form di elemento di lavoro

Aggiungere un campo a un tipo di elemento di lavoro

Per esaminare i campi elemento di lavoro e campi assegnati come segnalabile nei modelli di processo predefiniti per Team Foundation Server, vedere Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio e Riferimento ai campi segnalabili per ALM di Visual Studio.

Requisiti

Per eseguire questa procedura, è necessario essere membro del gruppo Administrators di Team Foundation o del gruppo Project Administrators per il progetto.Per ulteriori informazioni, vedere la classe Autorizzazioni per Team Foundation Server.

[!NOTA]

Se si esegue Windows Vista potrebbero non essere disponibili le autorizzazioni impostate per certe cartelle.Se si tenta di esportare il tipo di elemento di lavoro in un percorso per il quale non si dispone di autorizzazioni impostate, la tecnologia di virtualizzazione del Registro di sistema consente il reindirizzamento automatico del file esportato e il relativo salvataggio nell'archivio virtuale.Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone di autorizzazioni impostate.Per ulteriori informazioni sulla virtualizzazione del registro di sistema, vedere le pagine seguenti nel sito Web Microsoft: Virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.

1.Esportare una definizione dei tipi di elementi di lavoro

Quando si scaricano la definizione del tipo dal progetto team, si garantisce l'utilizzo della versione più recente.

[!NOTA]

Se le modifiche da apportare sono di entità minore e si ha familiarità con l'utilizzo del formato XML, è possibile modificare i file utilizzando il Blocco note o un altro editor di testo.È inoltre possibile utilizzare l'Editor di processo, un potente strumento installato come componente aggiuntivo in Visual Studio.Utilizzando questo strumento, non è necessario importare o esportare definizioni di tipo.In alternativa, è possibile aprirli utilizzando l'editor di processo e modificarli tramite l'interfaccia dell'editor.

È possibile scaricare questo potente strumento dalla pagina Team Foundation Server Power Tools del sito Web Microsoft (la pagina potrebbe essere in inglese).

Per ulteriori informazioni su come scaricare i file di schema per i modelli di processo, vedere Indice delle definizioni degli elementi XML per plug-in di modelli di processo.

Per esportare un file di definizione dei tipi di elementi di lavoro da un progetto esistente

Per eseguire lo strumento della riga di comando witadmin, aprire una finestra Prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
In una versione a 64 bit di Windows sostituire %programfiles% con %programfiles(x86)%.
Immettere il comando seguente, sostituendo i dati agli argomenti riportati di seguito, dove CollectionURL specifica l'URL di una raccolta di progetti team, ProjectName specifica il nome del progetto team definito nella raccolta, WorkItemTypeName specifica il nome dell'elemento di lavoro da esportare e FileName specifica il nome e il percorso del file esportato da esportare.Scegliere quindi il tasto Invio.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Esempio: Esportare la definizione dell'elemento di backlog del prodotto

Ad esempio, Julia utilizza il comando seguente per esportare la definizione del tipo per il progetto team di FabrikamFiber per l'elemento di backlog del prodotto a FF_ProductBItem.xml.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml
```
Esempio: Esportare la definizione dell'attività

E Peter utilizza il comando seguente per esportare la definizione dell'attività e salvarla nel file contrassegnato come FF_Task.xml.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml
```
Al termine, viene visualizzato il seguente messaggio:

Operazione completata.

2.Aggiungere un campo a un tipo di definizione

Per aggiungere un campo a una definizione di tipo, è necessario aggiungere un elemento FIELD nella sezione FIELDS e un elemento Control nella sezione FORM.Inoltre, si consiglia di aderire alle convenzioni di denominazione definite per i campi.

Per aggiungere un campo a un tipo di elemento di lavoro

Individuare la sezione del file XML che definisce i campi per il tipo e che inizia con FIELDS.
Aggiungere l'elemento FIELD che specifica il nome del campo personalizzato da aggiungere.È necessario specificare i seguenti attributi richiesti: namedescrittivo, refname (nome di riferimento) e type.Per ulteriori informazioni, vedere Elemento FIELD (Definizione).

[!NOTA]

Il nome di riferimento, o refname, è il nome a livello di codice del campo.Tutte le altre regole devono fare riferimento a questo refname.Per ulteriori informazioni, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Esempio: Aggiungere un campo personalizzato con un elenco del menu

Ad esempio, Julia digita il testo seguente per aggiungere il campo personalizzato, richiedente, con un nome di riferimento di FabrikamFiber.MyTeam.Requestor, alla definizione del tipo per l'elemento di backlog del prodotto.Specifica inoltre l'elenco di selezione di valori consentiti per il campo e il valore predefinito del cliente per l'elenco.
```
<FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>
```
Per ulteriori informazioni sugli elenchi di selezione, vedere Definire elenchi di opzioni.

Esempio: Aggiungere un campo predefinito

Per la definizione di tipo per l'attività, Peter aggiungere il campo predefinito, Lavoro completato, con un nome di riferimento di Microsoft.VSTS.Scheduling.CompletedWork.
```
<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />
```
Per un elenco di tutti i campi predefiniti, vedere Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.

Aggiungere l'elemento CONTROL nella sezione FORM in modo che il campo personalizzato venga visualizzato nel form elemento di lavoro nel gruppo di elementi in cui si desidera visualizzarlo.È necessario specificare l'attributo di controllo type.Per ulteriori informazioni, vedere Riferimento all'elemento XML Control.

Esempio: Aggiungere il campo personalizzato al form per l'elemento di backlog del prodotto

Esempio: Aggiungere l'elemento di controllo per un campo

Ad esempio, Julia aggiunge l'elemento Control per il campo della richiesta in modo che venga visualizzato nel campo motivo nel form elemento di lavoro, come mostrato nell'esempio di codice.

<Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>

Suggerimento
La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole e tutti gli altri elementi come tutto scritto in maiuscolo.Se si rilevano errori durante la convalida dei file di definizione del tipo, controllare la struttura del caso degli elementi.Inoltre, la struttura del caso dei tag di apertura e di chiusura deve corrispondere alle regole per la sintassi XML.

La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole e tutti gli altri elementi come tutto scritto in maiuscolo.Se si rilevano errori durante la convalida dei file di definizione del tipo, controllare la struttura del caso degli elementi.Inoltre, la struttura del caso dei tag di apertura e di chiusura deve corrispondere alle regole per la sintassi XML.

Nella figura seguente viene illustrato il form elemento di lavoro per l'elemento di backlog del prodotto che adesso contiene il nuovo campo.

Campo personalizzato aggiunto al form e alla definizione del tipo

Esempio: Aggiungere il campo predefinito al form per l'attività

Per l'elemento di lavoro attività, Peter aggiungere il campo Control cosi che venga visualizzato nel campo lavoro rimanente come illustrato nell'esempio di codice seguente:

<Column PercentWidth="50">
   <Group Label="Details">
      <Column PercentWidth="100">
         <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
         <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
      </Column>
   </Group>
</Column>

Nella figura seguente viene illustrato il form elemento di lavoro per l'attività che ora contiene il campo Lavoro completato.

Aggiungere il lavoro completato al form e al tipo di attività

Salvare le modifiche apportate al file XML.

Per ulteriori informazioni sull'aggiungere campi di elementi di lavoro a definizioni di tipo

3.Modificare il layout del form per i gruppi della scheda da due colonne a una singola colonna

Julia desidera modificare il layout del form per l'elemento di backlog del prodotto in modo che il campo di descrizione si estenda alla larghezza del form.Come illustrato nella figura seguente, il layout di impostazione predefinita visualizza due set di gruppi di schede.Per modificare il layout in un singolo set di gruppi di schede, Jill necessita di modificare l'elemento della prima colonna su una larghezza del 100% e elimina le Column e gli elementi TabGroup estranei dalla sezione FORM.

Layout gruppo di schede a due colonne

Per modificare il layout del form dai gruppi della scheda a due colonne ai gruppi di schede a una singola colonna

Individuare la sezione TabGroup del file XML.Si noti che sono presenti elementi Tab per elementi come Descrizione, Attività, Criteri di accettazione, e Cronologia nei quali ogni elemento Tab contiene un elemento Control che rende i rispettivi controlli.
```
<Group>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>
```
Consolidare tutti gli elementi <Tab> . . . </Tab> in un TabGroup.Eliminare Group, Columne gli elementi TabGroup estranei.Nell'esempio riportato di seguito viene illustrata la nuova struttura sintattica XML.
```
<Group>
   <Column PercentWidth="100">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>
```
[!NOTA]

Per ottenere risultati ottimali, ciascun controllo o gruppo deve essere visualizzato in una colonna anche se questa si estende per l'intera larghezza del form.Ciascuna colonna, a sua volta, deve essere visualizzata in un gruppo anche se questo non dispone di un'etichetta o di un limite visibile.Per ulteriori informazioni, vedere Progettare e personalizzare un form elemento di lavoro.

Nella figura seguente vengono illustrati i gruppi di schede a singola colonna.
Salvare le modifiche apportate al file XML.

4.Importare una definizione dei tipi di elementi di lavoro

Dopo avere personalizzato la definizione del tipo, è necessario includerlo nel progetto team per testare le modifiche e metterlo disponibile disponibili per l'utilizzo.Il file XML importato sovrascriverà il contenuto della definizione corrente del tipo.Il processo di importazione convalida la sintassi XML prima del caricamento.

Per importare un tipo di elemento di lavoro in un progetto team esistente

Dalla finestra del prompt dei comandi e dalla directory specificata nel passaggio 1, 1. Esportare una definizione dei tipi di elementi di lavoro , descritto precedentemente in questo argomento, immettere il seguente comando quindi premere il tasto Invio.
```
witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Esempio: Importare la definizione dell'elemento di backlog del prodotto

Ad esempio, Jill utilizza il comando seguente per importare la definizione del tipo dell'elemento di backlog del prodotto, che aveva esportato in FF_ProductBItem.xml, per il progetto team di FabrikamFiber.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml
```
Esempio: Importare la definizione dell'attività

E Peter utilizza il comando seguente per importare la definizione di tipo per l'attività che ha salvato su FF_Task.xml.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml
```
Al termine, viene visualizzato il seguente messaggio:

Importazione del tipo di elemento di lavoro completata.

5.Aggiornare il progetto team e verificare le modifiche apportate alla definizione del tipo

Dopo avere importato una definizione di tipo, è necessario aggiornare la cache in Team Explorer per rendere disponibili le modifiche.È necessario aggiornare la cache solo se si dispone di Visual Studio aperto e collegato a Team Foundation Server quando si importa le definizioni del tipo.

Aggiornare Team Explorer e creare un elemento di backlog del prodotto

Aggiornare il progetto team e verificare le modifiche

Aggiornare la cache

In Team Explorer, scegliere il pulsante Aggiorna.

Gli ultimi aggiornamenti vengono scaricati dal server, incluse le modifiche appena importate.

Attendere per alcuni secondi finché l'aggiornamento non viene completato.
Scegliere Work Items.
Scegliere Nuovo elemento di lavoroquindi scegliere il tipo di elemento di lavoro modificato, come Elemento backlog prodotto o Attività.
Verificare che le modifiche apportate siano presenti nel form dell'elemento di lavoro.
Scegliere il pulsante Chiudi per chiudere il nuovo elemento di lavoro.Scegliere il pulsante No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Condividi tramite