Condividi tramite

Definire una query elemento di lavoro per aggiungere un modello di processo

  • Articolo

È possibile creare agevolmente un file di query di elementi di lavoro (con estensione wiq) in Team Explorer. In un progetto team esistente è possibile utilizzare Team Explorer per creare qualsiasi query di elementi di lavoro che si desidera aggiungere al modello di processo e quindi seguire i passaggi in questo argomento per salvare ogni query come file con estensione wiq. Per ulteriori informazioni sulla creazione di query elemento di lavoro, vedere Specificare criteri di filtro della query.

In questo argomento

  • Salvataggio di una query di elementi di lavoro in un file con estensione wiq

  • Creazione di una query elemento di lavoro che fa riferimento a un percorso iterazione

  • Esempio di una query elemento di lavoro specifica dell'iterazione

  • Riferimento dell'elemento WorkItemQuery

Autorizzazioni necessarie

Per creare una query, è necessario essere un membro del gruppo Readers oppure che l'autorizzazione Visualizza elementi di lavoro in questo nodo sia impostata su Consenti per ogni progetto team nella query. Per salvare una query come query team, è necessario disporre delle autorizzazioni corrette. Per ulteriori informazioni, vedere Organizzare e impostare le autorizzazioni relative alle query elemento di lavoro.

Salvataggio di una query di elementi di lavoro in un file con estensione wiq

Per salvare una query elemento di lavoro in un file WIQ

  1. In Team Explorer fare clic con il pulsante destro del mouse sulla query e scegliere Visualizza query.

  2. Nel menu File fare clic su Salva [query] <nome query> con nome.

  3. Nella finestra di dialogo Salva query con nome fare clic su File e specificare un percorso e un nome per il file con estensione wiq. In alternativa, scegliere Sfoglia, specificare un nome file, selezionare il percorso in cui salvare il file e scegliere Salva.

  4. Copiare il file nella cartella \WorkItem Tracking\Queries all'interno della cartella in cui è stato scaricato il modello di processo.

  5. Aprire il file con estensione wiq in un editor di testo.

  6. Rimuovere gli elementi <TeamFoundationServer> e <TeamProject> che associano la query a uno specifico server su cui è in esecuzione Visual Studio Team Foundation Server e a uno specifico progetto team, come viene illustrato nell'esempio riportato di seguito:

    <TeamFoundationServer>CollectionURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>

    Nota

    È necessario modificare il file .wiq in un editor di testo e rimuovere gli elementi <TeamFoundationServer> e <TeamProject> che associano la query a uno specifico server e al progetto team. In caso contrario, la query non funzionerà in modo corretto se il modello di processo viene caricato in un server diverso. In alternativa, se possibile, utilizzare macro che impediscano alle query di includere il nome esplicito del progetto team corrente o altri valori espliciti specifici di un determinato ambiente.

  7. Rimuovere qualsiasi elemento aggiuntivo specifico di un utente.

Torna all'inizio

Creazione di una query elemento di lavoro che fa riferimento a un percorso iterazione

È possibile definire una query che fa riferimento a un percorso di iterazione specifico includendo la macro per il progetto team, $$PROJECTNAME$$ e il nome di un percorso di iterazione definito nel file del plug-in Classificazione. La sintassi di query indicata di seguito specifica ad esempio una query che include solo gli elementi di lavoro il cui percorso di iterazione è in Iterazione 1.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

Quando viene creato il progetto team, la macro viene sostituita con il nome del progetto team.

Tramite questa macro, è possibile definire cartelle di lavoro che fanno riferimento a percorsi di iterazione specifici. Il modello di processo per MSF Agile Software Development contiene una query specifica dell'iterazione, Iteration1Backlog.wiq che supporta la cartella di lavoro specifica dell'iterazione, Iteration Backlog.xlsm.

Quando si caricano query specifiche dell'iterazione, l'attività per elaborare il file Classification.xml deve essere completata prima dell'attività per elaborare i file di query. Per ulteriori informazioni, vedere Definizione delle aree e delle iterazione iniziali nel plug-in Classification e Definizione delle attività radice utilizzando il file del plug-in del modello di processo.

Torna all'inizio

Esempio di una query elemento di lavoro specifica dell'iterazione

Nell'esempio di seguito viene illustrata la query di elementi di lavoro Iteration1Backlog, che supporta la cartella di lavoro Backlog iterazione.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

Torna all'inizio

Riferimento dell'elemento WorkItemQuery

Nella sintassi indicata di seguito viene illustrata la struttura dell'elemento WorkItemQuery e dei relativi elementi figlio.

<WorkItemQuery Version="1">
   <TeamFoundationServer>collectionURL </TeamFoundatonServer>
   <TeamProject>TeamProjectName </TeamProject>
   <Wiql>
      WorkItemQueryLanguage
   </Wiql>
</WorkItemQuery>

Elemento

Sintassi

Descrizione

TeamFoundationServer

 
<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Elemento figlio facoltativo di WorkItemQuery.

Nota importanteImportante
In generale, è possibile eliminare questo elemento dalle query aggiunte ai modelli di processo.

Indica l'URI dell'insieme di progetti team nel formato seguente:

http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme

Se non viene utilizzata alcuna directory virtuale, utilizzare il formato dell'URI seguente:

http://NomeServer:Porta/NomeInsieme

Il tipo di attributo è ServerNameType con una lunghezza massima di 2047 caratteri.

TeamProject

 
<TeamProject>TeamProjectName</TeamProject>

Elemento figlio facoltativo di WorkItemQuery.

Nota importanteImportante
In generale, è possibile eliminare questo elemento dalle query aggiunte ai modelli di processo.

Indica il progetto team per il quale eseguire la query.

Il tipo di attributo è ProjectNameType con una lunghezza massima di 255 caratteri.

Wiql

 
<Wiql>WorkItemQueryLanguage</Wiql>

Elemento figlio obbligatorio di WorkItemQuery.

Consente di specificare una sequenza di comandi SQL che fungono da criteri di filtro per individuare un set di elementi di lavoro in un progetto team e restituire i valori assegnati a un numero preimpostato di campi.

I modelli di processo MSF forniscono vari esempi dei comandi SQL supportati dall'elemento Wiql. Questi file si trovano nella cartella Queries della cartella WorkItem Tracking. Per ulteriori informazioni su come definire query, vedere Individuazione di bug, attività e altri elementi di lavoro.

Torna all'inizio

Vedere anche

Concetti

Individuazione di bug, attività e altri elementi di lavoro

Altre risorse

Definizione e personalizzazione di oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro

Cronologia delle modifiche

Data

Cronologia

Motivo

Aprile 2011

Descritto ogni elemento WorkItemQuery e rimossi i collegamenti agli argomenti eliminati.

Miglioramento delle informazioni.