Share via

Aggiungere, utilizzare e gestire gli elenchi globali

  • Articolo

Le voci di elenco possono essere condivise tra più tipi di elemento di lavoro includendole tra uno o più elementi GLOBALLIST.

Quando si definiscono i tipi di elemento di lavoro, alcuni campi possono condividere lo stesso gruppo di valori. Questo set di valori di solito è relativo a diversi tipi di elemento di lavoro e a diversi progetti team. Alcuni di questi elenchi possono cambiare frequentemente, ad esempio il numero delle compilazioni notturne, richiedendo spesso all'amministratore di aggiornare tali elenchi in molti percorsi. Gli elenchi globali possono consentire di risolvere questo problema.

Nota

Gli elenchi globali non devono includere gruppi in ambito progetto poiché non hanno lo stesso ambito di un progetto. Gli elenchi globali vengono gestiti per un insieme di progetti.

Nelle procedure seguenti viene illustrato come creare un elenco globale denominato Discipline per il tipo di elemento di lavoro Attività.

Autorizzazioni necessarie

Per esportare un elenco globale, è necessario essere membro del gruppo Valid Users di Team Foundation per l'insieme di progetti. Per importare un elenco globale, è necessario essere membro del gruppo Administrators di Team Foundation o del gruppo Project Administrators per l'insieme di progetti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Per aggiungere un elenco globale all'insieme di progetti team

  1. In Visual Studio scegliere Nuovo nel menu File, quindi selezionare File.

  2. Nel riquadro Categorie, fare clic su Generale.

  3. Nel riquadro Modelli fare clic su File XML, quindi scegliere Apri.

  4. Aggiungere al nuovo file l'XML seguente, evidenziato nell'esempio. In questo esempio verrà definito un elenco globale di discipline rilevanti per l'organizzazione.

    <?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

  5. Fare clic su Salva nella barra degli strumenti per salvare le modifiche apportate al file XML.

    Verrà visualizzata la finestra di dialogo Salva file con nome.

  6. Nella finestra di dialogo Salva file con nome selezionare in Salva in il percorso in cui si desidera salvare il file. Assegnare un nome al file e scegliere Salva.

    Nota

    Se si esegue Windows Vista, è possibile che non si disponga delle autorizzazioni impostate per accedere ad alcune 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 il sito Web Microsoft: Virtualizzazione del Registro di sistema (la pagina potrebbe essere in inglese) e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.

  7. Aprire una finestra del prompt dei comandi di Visual Studio 2010.

  8. Per importare questo elenco globale nell'insieme di progetti, digitare il comando seguente, quindi premere Invio:

    witadmin importgloballist /collection:http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme /f:"Percorso file"

    Per ulteriori informazioni, vedere Gestione di elenchi globali per i tipi di elemento di lavoro [witadmin].

  9. Per visualizzare gli elenchi globali in Team Foundation Server, digitare il comando seguente al prompt dei comandi, quindi premere Invio:

    witadmin exportgloballist /collection:http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme

    Verrà visualizzato l'elenco appena aggiunto.

Per utilizzare elenchi globali in un tipo di elemento di lavoro

  1. Eseguire witadmin exportwitd per esportare Task.xml. Per ulteriori informazioni, vedere Personalizzazione e gestione dei tipi di elemento di lavoro [witadmin].

  2. In Visual Studio scegliere Apri dal menu File, quindi fare clic su File.

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

    Nota

    Se si esegue Windows Vista, è possibile che non si disponga delle autorizzazioni di accesso impostate per accedere ad alcune 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 il sito Web Microsoft: Virtualizzazione del Registro di sistema (la pagina potrebbe essere in inglese) e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.

  4. Selezionare Task.xml, quindi scegliere Apri. Quando viene visualizzata la richiesta relativa alle terminazioni di riga, scegliere No.

  5. Trovare la sezione del file XML seguente, in cui viene definito il campo Disciplina:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  6. Eliminare l'elenco di valori consentiti rimuovendo l'XML seguente, evidenziato nell'esempio:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  7. Impostare i valori consentiti del campo Disciplina sull'elenco globale definito in precedenza, aggiungendo l'XML seguente al file:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

  8. Fare clic su Salva nella barra degli strumenti per salvare le modifiche apportate al file XML.

  9. Importare l'attività modificata in Team Foundation Server. Per ulteriori informazioni, vedere Personalizzazione e gestione dei tipi di elemento di lavoro [witadmin].

  10. 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 di tutti i nodi. I nodi in fase di caricamento sono contrassegnati dall'etichetta In corso.

  11. Creare un'attività. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro e fare clic su Attività.

    Questa attività viene creata dal tipo di elemento di lavoro modificato e importato.

  12. Selezionare la casella Disciplina nel nuovo form dell'elemento di lavoro.

    Si noti che i valori consentiti vengono inseriti dall'elenco globale Discipline.

  13. Scegliere Chiudi per chiudere la nuova attività. Scegliere No quando viene richiesto di salvare l'attività.

Per aggiungere valori a un campo senza modificare né importare un file xml di tipo di elemento di lavoro

  1. Per aggiungere valori al campo Disciplina senza modificare né importare nuovamente il file di definizione del tipo di elemento di lavoro, aprire il file disciplines.xml utilizzando Visual Studio e aggiungere i nuovi valori seguenti, evidenziati nell'esempio:

    <GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>

  2. Fare clic su Salva nella barra degli strumenti per salvare le modifiche apportate al file XML.

  3. Aprire una finestra del prompt dei comandi di Visual Studio.

  4. Per importare questo elenco globale nell'insieme di progetti, digitare il comando seguente al prompt dei comandi, quindi premere Invio:

    witadmin importgloballist /collection:http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme /f:"Percorso file"

  5. 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 di tutti i nodi. I nodi in fase di caricamento sono contrassegnati dall'etichetta In corso.

  6. Creare un'attività. Per eseguire questa operazione, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliere Aggiungi elemento di lavoro e fare clic su Attività.

  7. Selezionare la casella Disciplina.

    Si noti che i nuovi valori nell'elenco globale vengono ora visualizzati come opzioni nella casella.

    Nota

    È possibile fare riferimento agli elenchi globali dei valori consentiti condivisi tra diversi tipi di elemento di lavoro o nei progetti team. In tal modo, un unico aggiornamento all'elenco globale sarà in grado di aggiornare automaticamente i valori consentiti di tutti i tipi di elemento di lavoro che fanno riferimento all'elenco.

  8. Scegliere Chiudi per chiudere la nuova attività. Scegliere No quando viene richiesto di salvare l'attività.

Vedere anche

Riferimenti

Elemento GLOBALLISTS (schema degli elenchi globali)

GLOBALLISTS Element (Work Item Type Definition Schema)

Concetti

Personalizzazione di dati di rilevamento, form, flusso di lavoro e gli altri oggetti del progetto

Definizione di elenchi globali

Definizione e utilizzo di elenchi, elenchi di opzioni ed elenchi globali

Altre risorse

Indice delle definizioni degli elementi XML per i tipi di elementi di lavoro