Aggiungere o rimuovere un campo in un tipo di elemento di lavoro

Articolo
08/11/2011

Per aggiungere o rimuovere un campo di dati in un tipo di elemento di lavoro, modificare il file di definizione del tipo di elemento di lavoro. È necessario aggiungere o rimuovere gli elementi FIELD dalla sezione FIELDS e il layout e i controlli definiti nella sezione FORM. Dopo aver modificato il tipo di elemento di lavoro è possibile importare il file XML e iniziare a utilizzare il tipo di elemento di lavoro aggiornato.

Importante
I campi dei tipi di elemento di lavoro vengono gestiti per un insieme di progetti team. Per ulteriori informazioni, vedere Gestione di campi degli elementi di lavoro [witadmin].

In questo argomento

Esportare e aprire il file di definizione dei tipi di elemento di lavoro
Aggiungere un campo
Rimuovere un campo
Importare il file di definizione dei tipi di elementi di lavoro
Verificare che le modifiche siano presenti nel form dell'elemento di lavoro

Autorizzazioni necessarie

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 Autorizzazioni per Team Foundation Server.

Esportare e aprire il file di definizione dei tipi di elemento di lavoro

Per esportare e aprire il file di definizione dei tipi di elemento di lavoro

Eseguire uno dei passaggi seguenti in base all'ambito di personalizzazione che si desidera applicare:

Se si modifica un tipo di elemento di lavoro per un solo progetto:
1. Eseguire witadmin exportwitd per esportare il file XML per il tipo di elemento di lavoro che si desidera modificare. Digitare il comando seguente, sostituendo i dati con gli argomenti indicati:
```
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
  Per ulteriori informazioni, vedere Esportare e importare tipi di elementi di lavoro da un progetto esistente.
2. In Visual Studio scegliere Apri dal menu File, quindi fare clic su File.
  
  Viene visualizzata la finestra di dialogo Apri file.
3. In Cerca in spostarsi nel percorso in cui è stato esportato il file.
Se si modifica un tipo di elemento di lavoro per personalizzare un modello di processo:
1. Individuare il percorso in cui è stato scaricato il modello di processo.
2. Selezionare il file XML del tipo di elemento di lavoro che si desidera aggiornare, quindi scegliere Apri. Quando viene visualizzata la richiesta relativa alle terminazioni di riga, scegliere No.

Aggiungere un campo

Per aggiungere un campo a un tipo di elemento di lavoro

Individuare la seguente sezione del file XML:
```
<FIELDS>
```
Creare un campo stringa digitando l'XML seguente, evidenziato nell'esempio riportato di seguito:
```
<FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</FIELD>
```
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.
Individuare la sezione del file XML in cui si descrive il form dell'elemento di lavoro:
```
<FORM>
```

Individuare le righe seguenti nella sezione <FORM>:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>

Inserire un controllo per visualizzare il campo digitando l'XML seguente, evidenziato nell'esempio riportato di seguito:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="Issue Level" LabelPosition="Left" />
  </Column>
</Group>

Per salvare le modifiche apportate al file XML, scegliere Salva <nome file>.xml dal menu File.
Per importare il nuovo tipo di elemento di lavoro in un singolo progetto, vedere Importare il file di definizione dei tipi di elementi di lavoro. Per aggiungere il tipo di elemento di lavoro al modello di processo, vedere Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo.

Rimuovere un campo

Per rimuovere un campo da un form di elemento di lavoro

Individuare ed eliminare la definizione del campo che si desidera rimuovere dal tipo di elemento di lavoro. Nell'esempio seguente viene illustrato un campo denominato "Issue Level". Per eliminare questo campo è necessario eliminare la seguente sezione relativa al campo:

Nota

La sezione del campo nel file XML non può contenere tutti gli elementi nel codice seguente. Se, tuttavia, il campo del tipo di elemento di lavoro è stato personalizzato per includere tali elementi, questi devono anch'essi essere eliminati.

<FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level to which this special task belongs.</HELPTEXT>
  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Execution" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>
…
</FIELDS>

Per rimuovere il campo, trovare la sezione <Layout> in cui è definito il controllo per il campo elemento di lavoro ed eliminare le sezioni appropriate. Le seguenti sezioni evidenziate sono esempi di ciò che è necessario cercare.

<Group Label="Classification">
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

Scegliere Salva <nome file> dal menu File per salvare le modifiche apportate al file XML.

Importare il file di definizione dei tipi di elementi di lavoro

Per importare il file di definizione dei tipi di elementi di lavoro

Eseguire witadmin importwitd per importare il file XML per il tipo di elemento di lavoro modificato. Digitare il comando seguente, sostituendo i dati con gli argomenti indicati:
```
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
Per ulteriori informazioni, vedere Esportare e importare tipi di elementi di lavoro da un progetto esistente.

Verificare che le modifiche siano presenti nel form dell'elemento di lavoro

Per verificare le modifiche importate in un singolo progetto

In Team Explorer fare clic con il pulsante destro del mouse sul nodo del progetto team che contiene la definizione del tipo di elemento di lavoro modificato e scegliere Aggiorna.

Gli ultimi aggiornamenti vengono scaricati dal server, incluse le modifiche appena importate. Attendere alcuni secondi che venga completato l'aggiornamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un elemento di lavoro basato sul tipo di elemento di lavoro modificato facendo clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliendo Aggiungi elemento di lavoro e facendo quindi clic sul tipo di elemento di lavoro.

L'elemento di lavoro viene creato dal tipo di elemento di lavoro modificato.
Verificare che le modifiche apportate siano presenti nel form dell'elemento di lavoro.
Scegliere Chiudi per chiudere il nuovo elemento di lavoro. Scegliere No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Vedere anche

Condividi tramite