Procedura dettagliata: personalizzazioni di base per un tipo di elemento di lavoro

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa procedura dettagliata, verrà personalizzato un tipo di elemento di lavoro esistente nelle modalità più diffuse. Verranno fornite informazioni sugli strumenti utilizzati per personalizzare i tipi di elementi di lavoro e il linguaggio XML con cui si definiscono tali tipi.

Queste personalizzazioni vengono descritte nelle procedure riportate di seguito:

Creare un progetto Team. In questa procedura, viene creato il progetto Team contenente i tipi di elementi di lavoro da utilizzare nelle procedure successive.
Visualizzare un tipo di elemento di lavoro. In questa procedura, viene visualizzato il form di un tipo di elemento di lavoro esistente.
Esportare un tipo di elemento di lavoro. In questa procedura, viene esportata la definizione del tipo di elemento di lavoro in un file XML.
Rinominare il tipo In questa procedura viene modificato il file XML contenente la definizione del tipo di elemento di lavoro per modificare il nome del tipo di elemento di lavoro da Attività in Attività speciale.
Importare le modifiche. In questa procedura, viene importato in Team Foundation Server il tipo di elemento di lavoro modificato nella procedura precedente.
Aggiungere un campo In questa procedura viene aggiunto un nuovo campo, denominato Categoria, a un tipo di elemento di lavoro esistente.
Aggiungere regole a un campo. In questa procedura, viene aggiunta una regola che rende obbligatorio il nuovo campo Categoria.
Creare un elenco di opzioni. In questa procedura, viene aggiunto un elenco di valori consentiti per il campo Categoria. I nuovi valori saranno visualizzati come opzioni in un elemento di lavoro creato dal tipo di elemento di lavoro.
Modificare il flusso di lavoro. In questa procedura, vengono aggiunti nuovi stati e transizioni al tipo di elemento di lavoro.
Modificare il layout del form. In questa procedura, viene modificata la posizione dei campi nel form dell'elemento di lavoro.

Prerequisiti

Per completare i passaggi di queste procedure dettagliate, è necessario disporre dei seguenti elementi:

Copia di Visual Studio Team System o di Visual Studio in cui sia installato Team Explorer e sia presente una connessione a Team Foundation Server. Per ulteriori informazioni, vedere Procedura: connettersi a Team Foundation Server.

Se è possibile stabilire una connessione a un Team Foundation Server e si dispone delle autorizzazioni appropriate, è possibile apportare personalizzazioni di base a un tipo di elemento di lavoro al prompt dei comandi, da un file batch o da un file script. A tale scopo, è necessario utilizzare l'utilità Prompt dei comandi di Visual Studio 2008 o impostare alcune variabili di ambiente nel prompt dei comandi corrente tramite vsvars32, come descritto nell'esempio seguente. Per ulteriori informazioni sull'unione a un progetto Team, vedere Procedura dettagliata: connessione a un progetto Team.

Per attivare i comandi di Team Foundation al prompt dei comandi

Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008.

In alternativa, è possibile eseguire vsvars32 nel percorso di installazione di Visual Studio, in genere LetteraUnità:\Programmi\Microsoft Visual Studio 9,0\Common7\Tools.

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.

Creare un progetto Team

Per creare un progetto Team

Avviare Visual Studio.
Aprire Team Explorer facendo clic su Visualizza, quindi scegliere Team Explorer.
In Team Explorer fare clic con il pulsante destro del mouse sul nome del Team Foundation Server a cui si è connessi, quindi selezionare Nuovo progetto Team.
Nella finestra di dialogo Nuovo progetto Team su <nome Team Foundation Server>, in Specificare il nome del progetto Team, digitare WITLab, quindi scegliere Avanti.
Nella pagina Selezionare un modello di processo, in Specificare il modello di processo da utilizzare per la creazione del progetto Team, selezionare MSF for Agile Software Development - <numero di versione>, quindi scegliere Fine.

La creazione del progetto Team potrebbe richiedere alcuni minuti.
Quando viene visualizzata la pagina Progetto Team creato, deselezionare la casella Avviare le linee guida per il processo e scegliere Chiudi.

Il nuovo progetto Team, denominato "WITLab", verrà creato e visualizzato in un nodo di Team Foundation Server in Team Explorer.

Visualizzare un tipo di elemento di lavoro

Prerequisito: Creare un progetto Team è stata completata. Il progetto Team "WITLab" è disponibile.

Per visualizzare un tipo di elemento di lavoro

Avviare Visual Studio e aprire Team Explorer.
In Team Explorer espandere il progetto Team WITLab e attendere per alcuni secondi che vengano caricate le cartelle.
Nel progetto Team, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro e fare clic su Attività.

Viene visualizzato un form che rappresenta un nuovo elemento di lavoro Attività. In alcuni di questi campi sono contenuti valori predefiniti. In questa procedura dettagliata, verrà personalizzato il tipo di elemento di lavoro Attività da cui è stato creato questo elemento di lavoro.

Esportare un tipo di elemento di lavoro

Prerequisito: Creare un progetto Team è stata completata. Il progetto Team "WITLab" è disponibile.

Per esportare un tipo di elemento di lavoro

Aprire un prompt di comando Visual Studio.
Al prompt dei comandi digitare quanto segue e premere INVIO:

witexport /f "Percorso file\task.xml" /t "Nome server Team Foundation" /p WITLab /n Task

Il tipo di elemento di lavoro Attività verrà esportato da Team Foundation Server in un file XML. Al termine dell'operazione di esportazione, viene visualizzato il messaggio riportato di seguito:

Work item type export complete.
Facoltativo. Per visualizzare la definizione XML del tipo di elemento di lavoro Attività, digitare task.xml al prompt dei comandi e premere INVIO.

Rinominare il tipo

Prerequisito: la procedura Esportare un tipo di elemento di lavoro è stata completata.

Per rinominare il tipo

In Visual Studio scegliere File, quindi Apri file.

Verrà visualizzata la finestra di dialogo Apri file.

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, passare al percorso in cui è stato scaricato tale modello.

Nota:
Se si esegue Windows Vista, è possibile che non si disponga dei diritti di accesso a determinate cartelle. Se si tenta di esportare il tipo di elemento di lavoro in un percorso per il quale non si dispone di diritti di accesso, la tecnologia di virtualizzazione del Registro di sistema consente il reindirizzamento automatico del file esportato e il relativo salvataggio nell'archivio virtuale. Per ulteriori informazioni, vedere https://go.microsoft.com/fwlink/?LinkId=92325 (informazioni in lingua inglese) e https://go.microsoft.com/fwlink/?LinkId=92323. Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone dei diritti di accesso.

Se si esegue Windows Vista, è possibile che non si disponga dei diritti di accesso a determinate cartelle. Se si tenta di esportare il tipo di elemento di lavoro in un percorso per il quale non si dispone di diritti di accesso, la tecnologia di virtualizzazione del Registro di sistema consente il reindirizzamento automatico del file esportato e il relativo salvataggio nell'archivio virtuale. Per ulteriori informazioni, vedere https://go.microsoft.com/fwlink/?LinkId=92325 (informazioni in lingua inglese) e https://go.microsoft.com/fwlink/?LinkId=92323. Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone dei diritti di accesso.

Fare clic sul file task.xml, quindi scegliere Apri. Quando viene visualizzata la richiesta relativa alle terminazioni di riga, scegliere No.

Viene aperto il file XML, task.xml, che contiene la definizione per il tipo di elemento di lavoro Attività.
Individuare il seguente elemento nel file XML.
```
<WORKITEMTYPE name="Task">
```
Modificare il valore dell'attributo name in Attività speciale.
```
<WORKITEMTYPE name="Special Task">
```
Salvare la modifica in un nuovo file XML. A tale scopo, scegliere Salva task.xml con nome dal menu File di Visual Studio.

Verrà visualizzata la finestra di dialogo Salva file con nome.
Per Nome file, digitare specialtask.xml e scegliere Salva.

Importare le modifiche

Prerequisito: la procedura Rinominare il tipo è stata completata.

Per importare le modifiche

Aprire un prompt di comando Visual Studio.
Importare il tipo di elemento di lavoro modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
Selezionare il progetto Team, quindi scegliere Aggiorna dal menu Visualizza per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento di tutti i nodi. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro viene creato dal tipo di elemento di lavoro modificato e importato.

Aggiungere un campo

Prerequisito: la procedura Rinominare il tipo è stata completata.

Per aggiungere un campo

Aprire il file contenente la definizione del tipo di elemento di lavoro Attività speciale. A tale scopo, in Visual Studio selezionare la scheda con l'etichetta SpecialTask.xml.
Individuare la seguente sezione del file XML.
```
<FIELDS>
```

Creare un nuovo campo stringa denominato Categoria e un testo della Guida per la descrizione comandi, digitando il seguente XML visualizzato in grassetto.

<FIELDS>
<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String">    <HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT></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 Nomi di riferimento di campo.

Individuare la sezione del file XML in cui si descrive il form dell'elemento di lavoro.
```
<FORM>
```

Individuare le seguenti righe all'interno della 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 nuovo controllo per visualizzare il campo Categoria digitando il seguente XML visualizzato in grassetto:

<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.Category" Label="Category" LabelPosition="Left" />  </Column>
</Group>

Per salvare le modifiche apportate al file XML, scegliere Salva dal menu File.
Importare il tipo di elemento di lavoro Attività speciale modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Nota Come alternativa rapida, è possibile premere la freccia SU dalla riga di comando per visualizzare l'ultimo comando immesso.

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
In Team Explorer scegliere Aggiorna per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro viene creato dal tipo di elemento di lavoro modificato e importato.

Si noti che il nuovo campo Categoria è presente nel form. Spostare il puntatore del mouse sull'etichetta del campo per visualizzare la descrizione comandi.
Scegliere Chiudi per chiudere il nuovo campo Attività speciale. Scegliere No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Aggiungere regole a un campo

Prerequisito: la procedura Aggiungere un campo è stata completata.

Per aggiungere regole a un campo

Aprire il file contenente la definizione del tipo di elemento di lavoro Attività speciale. A tale scopo, in Visual Studio selezionare la scheda con l'etichetta specialtask.xml.
Individuare la sezione <FIELDS> del file XML e, all'interno, il campo Categoria.

Rendere il campo Categoria obbligatorio aggiungendo la seguente regola al file XML. La regola viene evidenziata in grassetto.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
</FIELD>

Per salvare le modifiche apportate al file XML, scegliere Salva dal menu File.
Importare il tipo di elemento di lavoro Attività speciale modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
In Team Explorer scegliere Aggiorna per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro viene creato dal tipo di elemento di lavoro modificato e importato.

Si noti che, a questo punto, il campo Categoria è evidenziato, a indicare che è obbligatorio.
Selezionare il campo Titolo nell'elemento di lavoro Attività speciale e digitare "Attività di esempio".
Fare clic su Salva sulla barra degli strumenti per salvare l'elemento di lavoro.

Verrà visualizzata una finestra di dialogo di errore che indica che il campo Categoria non può essere vuoto. Scegliere OK per chiudere la finestra di dialogo.
Nel campo Categoria dell'elemento Attività speciale, digitare Categoria.
Scegliere Salva per salvare l'elemento di lavoro.

Si noti che, a questo punto, è possibile salvare l'elemento di lavoro.
Scegliere Chiudi per chiudere il nuovo campo Attività speciale.

Creare un elenco di opzioni

Prerequisito: la procedura Aggiungere regole a un campo è stata completata.

Per creare un elenco di opzioni

Aprire il file contenente la definizione del tipo di elemento di lavoro Attività speciale. A tale scopo, in Visual Studio selezionare la scheda con l'etichetta specialtask.xml.
Individuare la sezione <FIELDS> del file XML e, all'interno, il campo Categoria.

Aggiungere un elenco di valori consentiti per il campo Categoria inserendo una regola ALLOWEDVALUES. La nuova regola viene visualizzata in grassetto nel seguente XML.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
<ALLOWEDVALUES>
    <LISTITEM value="Process Management" />
    <LISTITEM value="Planning" />
    <LISTITEM value="Execution" />
    <LISTITEM value="Review" /></ALLOWEDVALUES>
</FIELD>

Rendere il campo Categoria facoltativo eliminando la regola REQUIRED, visualizzata in grassetto.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
<ALLOWEDVALUES>
    <LISTITEM value="Process Management" />
    <LISTITEM value="Planning" />
    <LISTITEM value="Execution" />
    <LISTITEM value="Review" />
</ALLOWEDVALUES>
</FIELD>

Scegliere Salva per salvare le modifiche apportate al file XML.
Importare il tipo di elemento di lavoro Attività speciale modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
Nella finestra di Team Explorer in Visual Studio scegliere Aggiorna per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro viene creato dal tipo di elemento di lavoro modificato e importato.
Scegliere la casella di riepilogo per il campo Categoria.

Si noti che, a questo punto, il campo supporta soltanto i valori specificati dalle regole ALLOWEDVALUES.

Nota:

I valori consentiti nel riepilogo sono sempre visualizzati in ordine alfabetico indipendentemente dall'ordine degli elementi di LISTITEM nel file XML.
Scegliere Chiudi per chiudere il nuovo campo Attività speciale. Scegliere No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Nota:
I valori consentiti nel riepilogo sono sempre visualizzati in ordine alfabetico indipendentemente dall'ordine degli elementi di LISTITEM nel file XML.

Modificare il flusso di lavoro

Prerequisito: la procedura Creare un elenco di opzioni è stata completata.

Per modificare il flusso di lavoro

Aprire il file contenente la definizione del tipo di elemento di lavoro Attività speciale. A tale scopo, in Visual Studio selezionare la scheda con l'etichetta specialtask.xml.
Individuare la definizione del flusso di lavoro del tipo di elemento di lavoro, nella sezione <WORKFLOW> del file XML, come illustrato nell'XML riportato di seguito:
```
<WORKFLOW>
  <STATES>
    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...
```
Si noti che soltanto due stati sono definiti, Attivo e Chiuso. Vengono definite anche le transizioni tra questi due stati, nonché una transizione di apertura dallo stato null, utilizzato quando l'elemento di lavoro viene creato per la prima volta.

Aggiungere uno stato Non approvato alla definizione del tipo inserendo un altro elemento <STATE>. Il nuovo stato viene visualizzato in grassetto.

<WORKFLOW>
  <STATES>
    <STATE value="Unapproved">    </STATE>    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Creare una transizione tra lo stato null e lo stato non approvato. Per eseguire questa operazione, individuare prima la definizione del flusso di lavoro per le transizioni. Successivamente inserire il seguente XML visualizzato in grassetto. A causa di questa modifica, tutti i nuovi elementi di lavoro di questo tipo saranno avviati nello stato Non approvato con il motivo predefinito di Nuovo.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>  </TRANSITION>  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
        <COPY from="currentuser" />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <COPY from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
        <COPY from="currentuser" />
      </FIELD>
    </FIELDS>
  </TRANSITION>

Eliminare la transizione in Attivo visualizzata nel seguente XML in grassetto, dal momento che può esistere solo una transizione di apertura e che si desidera utilizzare una transizione di apertura denominata "Porting effettuato", che verrà definita nel passaggio riportato di seguito.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
  </TRANSITION>
  <TRANSITION from="" to="Active">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>    <FIELDS>      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">        <COPY from="currentuser" />      </FIELD>      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">        <COPY from="clock" />      </FIELD>      <FIELD refname="System.AssignedTo">        <COPY from="currentuser" />      </FIELD>    </FIELDS>  </TRANSITION>

Aggiungere un motivo "Porting effettuato" per la transizione di apertura inserendo il seguente XML visualizzato in grassetto. In questo modo è possibile per gli utenti stabilire se l'elemento di lavoro è nuovo oppure è stato sottoposto a porting da un altro sistema di gestione.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />    </REASONS>
  </TRANSITION>
...
```
Inserire la seguente regola COPY visualizzata in grassetto. Questa regola consente di assegnare, in modalità predefinita, il campo Assegnato a all'utente che ha creato l'elemento di lavoro e deve essere valutata soltanto durante la transizione di apertura.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>       <FIELD refname="System.AssignedTo">         <COPY from="currentuser" />       </FIELD>    </FIELDS>
  </TRANSITION>
...
```
Nota:

L'inserimento di questa regola all'interno di altri elementi <TRANSITION> o <STATE> consentirà di estendere l'ambito della regola ad altri stati o transizioni.

Nota:
L'inserimento di questa regola all'interno di altri elementi <TRANSITION> o <STATE> consentirà di estendere l'ambito della regola ad altri stati o transizioni.

Creare una transizione dallo stato Non approvato allo stato Attivo inserendo il seguente XML, visualizzato in grassetto. A causa di questa modifica, quando un'Attività speciale viene approvata, può subire questa transizione.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>
       <FIELD refname="System.AssignedTo">
         <COPY from="currentuser" />
       </FIELD>
    </FIELDS>
  </TRANSITION>
  <TRANSITION from="Unapproved" to="Active">    <REASONS>      <DEFAULTREASON value="Approved" />    </REASONS>  </TRANSITION>  <TRANSITION from="Active" to="Closed">
    <REASONS>
      <DEFAULTREASON value="Completed" />
      <REASON value="Deferred" />
      <REASON value="Obsolete" />
      <REASON value="Cut" />
    </REASONS>
...

Scegliere Salva per salvare le modifiche apportate al file XML.
Importare il tipo di elemento di lavoro Attività speciale modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
In Team Explorer scegliere Aggiorna per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro viene creato dal tipo di elemento di lavoro modificato e importato.
Si noti che l'elemento Stato iniziale è adesso Non approvato e che l'impostazione predefinita di Motivo è Nuovo. Inoltre, il valore Assegnato a viene impostato in modalità predefinita sul nome account in uso. Scegliere il campo Motivo per visualizzare una casella di riepilogo in cui sono elencati i motivi Nuovo e Porting eseguito.
Nel campo Titolo, digitare un titolo e scegliere Salva per salvare l'elemento di lavoro. Attendere il termine dell'operazione di salvataggio, come indicato da Elementi salvati sulla barra di stato.
Nel campo Stato, selezionare il valore Attivo per approvare l'elemento di lavoro ed eseguirne nuovamente la transizione. Si noti che il campo Motivo è impostato in modalità predefinita su Approvato.
Scegliere Salva per salvare questa transizione.
Scegliere Chiudi per chiudere Attività speciale.

Modificare il layout del form

Prerequisito: la procedura Modificare il flusso di lavoro è stata completata.

Per modificare il layout del form

Aprire il file contenente la definizione del tipo di elemento di lavoro Attività speciale. A tale scopo, in Visual Studio selezionare la scheda con l'etichetta specialtask.xml.
Individuare la sezione <TabGroup> del file XML. Si noti che sono presenti elementi <Tab> per collegamenti e allegati a file in cui ciascun elemento <Tab> contiene un elemento <Control> che esegue il rendering del rispettivo controllo.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```
Unire i due elementi <Tab> in un unico elemento <Tab> per collegamenti e allegati che contiene entrambi i controlli sostituendo l'XML visualizzato nel passaggio precedente con il nuovo XML riportato di seguito.
```
<Tab Label="Links and Attachments">
  <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
  <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
</Tab>
```

Individuare la sezione della definizione del <Layout> del <FORM> in cui sono descritti i gruppi Classificazione e Stato.

<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.Category" Label="Category" LabelPosition="Left" />
  </Column>
</Group>

Nota:
Per ottenere risultati ottimali, ciascun Controllo o Gruppo deve essere visualizzato in una Colonna anche se questa si estende sulla larghezza intera 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 visualizzabile.

Selezionare le seguenti righe visualizzate in grassetto, quindi scegliere Copia dal menu Modifica per copiare questo contenuto negli Appunti per un utilizzo successivo.

  <Column PercentWidth="70">
    <Group>
      <Column PercentWidth="100">
        <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.Category" Label="Category" LabelPosition="Left" />          </Column>
        </Group>

Eliminare le righe visualizzate in grassetto nel seguente XML per rimuovere il gruppo Classificazione dalla sua posizione corrente nel form.

<Layout>
  <Group>
    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
    </Column>
    <Column PercentWidth="30">
      <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
    </Column>
  </Group>
  <Group Label="Classification">    <Column PercentWidth="100">      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" />      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" />      <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />    </Column>  </Group>

Nella sezione <TabGroup> individuare le seguenti righe che definiscono la scheda Dettagli:

<Tab Label="Details">
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group Label="Schedule">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
  </Group>
</Tab>

Incollare il contenuto degli Appunti nel seguente percorso per spostare questi controlli nella scheda Dettagli.

<Tab Label="Details">
  <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.Category" Label="Category" LabelPosition="Left" />  <Group>
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Issue" LabelPosition="Left" />
...

Eseguire le seguenti modifiche, visualizzate in grassetto, per creare un gruppo dei campi spostati e per suddividere i campi in due colonne.

<Tab Label="Details">
  <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.Category" Label="Category" LabelPosition="Left" />
        </Column>      </Group>    </Column>  </Group>
  <Group>
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Issue" LabelPosition="Left" />
...

Scegliere Salva per salvare le modifiche apportate al file XML.
Importare il tipo di elemento di lavoro Attività speciale modificato in Team Foundation Server. A tale scopo, digitare il comando riportato di seguito al prompt dei comandi di Visual Studio, quindi premere INVIO.

witimport /f "Percorso file\specialtask.xml" /t "Nome server Team Foundation" /p WITLab

Questa operazione consente di importare il tipo di elemento di lavoro specialtask in Team Foundation Server. Al termine dell'operazione di importazione, viene visualizzato il messaggio riportato di seguito:

Work item type import complete.
In Team Explorer scegliere Aggiorna per scaricare gli ultimi aggiornamenti dal server.

In questi aggiornamenti sono incluse le modifiche appena importate. Attendere per alcuni secondi che venga completato il caricamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un nuovo elemento di lavoro Attività speciale. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro, quindi Attività speciale.

Questo elemento di lavoro è creato dal tipo di elemento di lavoro modificato.

Si noti che il gruppo Classificazione non è più presente nel form principale. Selezionare la scheda Collegamenti e allegati e la scheda Dettagli per visualizzare i risultati delle modifiche apportate.
Scegliere Chiudi per chiudere il nuovo campo Attività speciale. Scegliere No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Passaggi successivi

Per istruzioni dettagliate sull'esecuzione di ulteriori personalizzazioni di un tipo di elemento di lavoro, vedere Procedura dettagliata: personalizzazioni avanzate per un tipo di elemento di lavoro.

Vedere anche

Attività

Procedura dettagliata: amministrazione dei campi in un tipo di elemento di lavoro

Altre risorse

Personalizzazione dei tipi di elemento di lavoro

Personalizzazione dei tipi di elemento di lavoro per Team Foundation