Definire una query elemento di lavoro per aggiungere un modello di processo
È possibile creare agevolmente un file di query di elementi di lavoro (con estensione wiq) in Team Explorer. In un progetto team esistente è possibile usare 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 altre informazioni sulla creazione di query elemento di lavoro, vedere Eseguire query di elementi di lavoro.
Requisiti
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 descritte in Impostare le autorizzazioni relative alle query.
Salvare una query elemento di lavoro come file .wiq
In Team Explorer aprire la query che si desidera salvare.
Nel menu File, scegliere Salva <nome_query> [Query] con nome.
Nella finestra di dialogo Salva query con nome scegliere File e specificare un percorso e un nome per il file .wiq. In alternativa, scegliere Sfoglia, specificare un nome file, selezionare il percorso in cui salvare il file e scegliere Salva.
Copiare il file nella cartella \WorkItem Tracking\Queries all'interno della cartella in cui è stato scaricato il modello di processo.
Aprire il file con estensione wiq in un editor di testo.
Rimuovere gli elementi <TeamFoundationServer> e <TeamProject> che associano la query a uno specifico server in cui è eseguito Visual Studio Team Foundation Server e a uno specifico progetto team, come mostrato nel seguente esempio:
<TeamFoundationServer>CollectionURL</TeamFoundationServer> <TeamProject>ProjectName</TeamProject>Nota
Per rimuovere gli elementi <TeamFoundationServer> e <TeamProject> che associano la query a un server e a un progetto team specifici, è necessario modificare il file .wiq in un editor di testo.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, usare macro che impediscano alle query di includere il nome esplicito del progetto team corrente o altri valori espliciti specifici di un determinato ambiente.
Rimuovere qualsiasi elemento aggiuntivo specifico di un utente.
Creare una query elemento di lavoro che fa riferimento a un percorso di 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 altre informazioni, vedere Definire le aree e le iterazioni iniziali nel plug-in Classification e Definire le attività radice utilizzando il file del plug-in del modello di processo.
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>
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 |
|
Elemento figlio facoltativo di WorkItemQuery. Importante In generale, è possibile eliminare questo elemento dalle query aggiunte ai modelli di processo. Indica l'URI della raccolta di progetti team nel formato seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta Se non viene usata alcuna directory virtuale, usare il formato dell'URI seguente: http://NomeServer:Porta/NomeRaccolta Il tipo di attributo è ServerNameType con una lunghezza massima di 2047 caratteri. |
TeamProject |
|
Elemento figlio facoltativo di WorkItemQuery. Importante 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 |
|
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. |