Eseguire query di elementi di lavoro

Le query consentono di trovare gli elementi di lavoro da rivedere, valutare, aggiornare o per cui generare un report.

Usare la casella di ricerca per trovare gli elementi di lavoro. Immettere l'ID oppure usare i filtri. Se si desidera un elenco semplice di elementi di lavoro, un elenco gerarchico che usa una query di struttura ad albero o un elenco che mostri le dipendenze tramite una query di collegamenti diretti, usare l'editor di query per scegliere il tipo di query.

È possibile creare query in Visual Studio Online, Team Web Access (TWA) e Team Explorer. Inoltre, è possibile aprire una query in Excel o Project per eseguire modifiche in blocco.

Usare la casella di ricerca per trovare un elemento di lavoro in base al relativo ID.

Digitare l'ID nella casella Cerca elementi di lavoro, quindi scegliere l'icona di ricerca.

Se si usa il menu di scelta rapida , è possibile aggiungere filtri agli elementi di elenco in base all'assegnazione, allo stato, a una parola chiave o a un tipo di elemento di lavoro.

Ad esempio, immettere A=@Me T=Task per elencare tutte le attività assegnate a un utente.

Aprire e modificare una query di elenco semplice

Il modo più semplice per definire una query consiste nell'iniziare con una query condivisa esistente. Nell'esempio seguente viene illustrato come trovare tutti i bug chiusi modificando la query condivisa Bug attivi fornita con il modello di processo Agile. Gli esempi sono basati sull'interfaccia utente fornita tramite il Web browser.

1. Aprire una query condivisa. Ad esempio, aprire i bug attivi o la query di elenco semplice simile.

   

      

2. Modificare la query per trovare i bug chiusi, quindi eseguire la query. Usare (Inserisci nuova riga di filtro) per inserire una clausola sopra la clausola corrente. Usare (Rimuovi questa riga di filtro) per eliminare una clausola.

   

      

3. Salvare la query nella cartella Query personali.

   

      

   Per salvare una query nella cartella Query condivise, è necessario essere amministratore del team, membro del gruppo Project Administrators o avere le autorizzazioni Collaborazione per la cartella impostate su Consenti.

Creare una query

Iniziare dal menu Nuovo nella pagina delle query in TWA o nella pagina degli elementi di lavoro in Team Explorer.

Raggruppare le clausole per rifinire l'elenco

Le clausole raggruppare operano come una singola unità separata dal resto della query, analogamente a quanto avviene con l'inserimento di parentesi in un'equazione matematica o in un'espressione logica. L'operatore OR o AND per la prima clausola del gruppo viene applicato all'intero gruppo.

Nel prossimo esempio, la prima espressione restituisce tutti gli elementi di lavoro con priorità 1 e tutti i bug attivi di qualsiasi priorità. La seconda espressione restituisce tutti gli elementi di lavoro attivi con priorità 1 e tutti i bug con priorità 1, a prescindere che siano attivi o meno.

Clausole raggruppate	Espressione logica
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	Priority=1 AND (Work Item Type=Bug OR State=Active)

Per raggruppare una o più clausole, selezionarle, quindi scegliere l'icona delle clausole di gruppo .

Se i risultati della query non restituiscono il set di elementi di lavoro previsto, seguire i seguenti passaggi:

• Assicurarsi che ogni clausola sia definita come desiderato.

• Verificare le assegnazioni And/Or di ogni clausola. Se i risultati contengono più elementi di lavoro di quelli previsti, spesso è presente una clausola Or anziché And.

• Valutare se si desidera raggruppare o modificare il raggruppamento delle clausole di query e le assegnazioni E/O di ogni clausola raggruppata.

• Aggiungere più clausole di query per limitare i criteri di filtro della query.

• Rivedere le opzioni disponibili per specificare campi, operatori e valori.

Usare una query di struttura ad albero per visualizzare un elenco gerarchico

Usare la query di struttura ad albero () per visualizzare un elenco di elementi di lavoro a più livelli e annidato. Ad esempio, è possibile visualizzare tutti gli elementi backlog e le relative attività collegate.

Espandere () o comprimere i () nodi foglia per concentrarsi su parti diverse dell'albero.

Definire i criteri di filtro per gli elementi di lavoro padre e figlio.

Per trovare elementi figlio collegati, selezionare Trova corrispondenza prima con elementi di lavoro di livello principale. Per trovare elementi padre collegati, selezionare Trova corrispondenza prima con elementi di lavoro collegati.

Usare una query di collegamenti diretti per visualizzare le dipendenze.

Usare la query di collegamenti diretti () per tenere traccia degli elementi di lavoro che dipendono da altro lavoro rilevato, ad esempio attività, bug, problemi o funzionalità. Ad esempio, è possibile visualizzare gli elementi backlog che dipendono dall'implementazione di altri elementi o dalla correzione di un bug.

Usare la query di collegamenti diretti per tenere traccia delle dipendenze del team dalle attività di altri team o gestire gli impegni del team verso altri team. Specificare i criteri di filtro per entrambi gli elementi di lavoro collegati e di primo livello e selezionare i tipi di collegamenti usati per filtrare le dipendenze.

Filtrare l'elenco di elementi di lavoro di primo livello scegliendo una di queste opzioni:

• Restituisci solo gli elementi di lavoro con collegamenti specifici: vengono restituiti gli elementi di lavoro di primo livello, a condizione che siano collegati a elementi di lavoro specificati dai criteri di filtro degli elementi di lavoro collegati.

• Restituisci tutti gli elementi di lavoro di primo livello: vengono restituiti tutti gli elementi di lavoro di primo livello indipendentemente dai criteri di filtro degli elementi di lavoro collegati. Gli elementi di lavoro di secondo livello collegati al primo livello vengono restituiti se corrispondono ai criteri di filtro degli elementi di lavoro collegati.

• Restituisci solo gli elementi senza collegamenti specifici: vengono restituiti gli elementi di lavoro di primo livello, a condizione che siano privi di collegamenti a elementi di lavoro specificati dai criteri di filtro degli elementi di lavoro collegati.

Domande e risposte

D: Quali operatori di query e variabili è possibile usare?

R: Gli operatori e le variabili disponibili per la selezione dipendono dal campo selezionato. Le quattro variabili sono @Project per il campo nome del progetto, @Me per i campi nome di persona, @Today per i campi di data e ora e [Qualsiasi]. Vedere Eseguire query su campi, operatori, valori e variabili.

D: Quali altri esempi di query sono presenti?

R: Vedere Query elemento di lavoro di esempio e Query della casella di ricerca di esempio.

D: Come si crea un grafico dei risultati di una query?

R: In Visual Studio Online e TWA è possibile inserire in un grafico i risultati di una query di elenco semplice. È necessario essere un membro del gruppo dotato di accesso avanzato in TWA.

In alternativa, è possibile aprire query in Excel e usare le funzionalità di Excel per generare un grafico.

D: Come si aggiornano automaticamente le query basate sullo sprint o sull'iterazione corrente?

R: Non esiste un sistema automatico a tale scopo; è necessario aggiornare manualmente le query per indicare lo sprint corrente. Se il progetto team è basato su Scrum o su Agile, è disponibile un set di query nelle cartelle Sprint corrente o Iterazione corrente. Affinché ogni query restituisca gli elementi definiti per lo sprint corrente, è necessario aggiornare il percorso iterazione all'iterazione corrente in base alla data.

È possibile modificare molte query salvandole come file con estensione wiq. Aprire la query in Team Explorer, scegliere Modifica queryquindi scegliere File, Salva come per salvare ogni query come file con estensione wiq. Di seguito è riportato un esempio di query di lavoro in corso è stata aggiornata per supportare Release 2\Sprint 59.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.AssignedTo],
           [System.State],
           [Microsoft.VSTS.Scheduling.RemainingWork],
    FROM WorkItems 
      WHERE [System.TeamProject] = @project and 
            [System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and 
            [System.WorkItemType] in group 'Microsoft.TaskCategory' and 
            [System.State] = 'In Progress' 
      ORDER BY [System.AssignedTo],
               [Microsoft.VSTS.Common.BacklogPriority],
               [System.Id] 
   </Wiql>
</WorkItemQuery>

D: Come si aggiungono o si modificano le colonne nell'elenco dei risultati?

R: Aprire Opzioni colonne per aggiungere o rimuovere colonne, modificare la sequenza di colonne e modificare l'ordinamento all'interno di una colonna.

Dall'elenco risultati è inoltre possibile trascinare una colonna in una nuova posizione e selezionare il titolo della colonna per modificare l'ordinamento per colonna.

D: È possibile filtrare una query usando tag?

R: Sì, se si usa Visual Studio Online o se l'istanza locale di TFS contiene gli aggiornamenti aggiunti con TFS 2013 Update 2. In caso contrario, no se si usano distribuzioni locali.

Per Visual Studio Online e con Visual Studio 2013 Update 2 è possibile scegliere Tag come campo da usare per il filtro. Inoltre, è possibile aprire una query da Excel ed effettuare una modifica in blocco dei tag assegnati agli elementi di lavoro. È anche possibile aggiungere tag agli elementi di lavoro mediante Visual Studio.

Dal plug-in di Team Explorer per Eclipse è possibile filtrare le query in base ai tag. Tuttavia, non è possibile aggiungere o modificare i tag dall'interfaccia utente. È necessario usare il portale Web per aggiungere e modificare i tag.

Per l'istanza locale di TFS senza TFS 2013 Update 2 è possibile visualizzare i tag come colonna nei risultati della query e filtrare un elenco in base a un tag. Tuttavia, non è possibile aggiungere tag come clausole ai criteri di filtro.

D: È possibile usare i risultati della query per modificare rapidamente le relazioni collegate?

R: Dal plug-in di Team Explorer per Visual Studio è possibile impostare un rientro (), ridurre un rientro () e trascinare gli elementi di lavoro per modificare la gerarchia.

Inoltre, è possibile aprire una query in Excel o Project per modificare in blocco le relazioni di collegamento padre-figlio e predecessore-successore.

D: Come si impedisce ad altri utenti di modificare una query che un utente condivide con il team?

R: Impostare le autorizzazioni per la query sulla lettura.

D: Come si aggiunge una query a Query condivise o a Preferiti team?

**R:**Per salvare una query nella cartella delle query condivise, aggiungerla al gruppo amministratori di progetto oppure aver impostato le autorizzazioni per una cartella in Query condivise.

Per aggiungere una query come preferita team, aprire il menu di scelta rapida per la query e aggiungerla come preferita team. È necessario essere amministratore del team per aggiungere query ai preferiti del team.

È possibile aggiungere le query condivise solo ai preferiti del team e solo se si dispone di autorizzazioni di amministratore del team.

D: È possibile aggiungere cartelle ai preferiti del team?

R: No. È possibile aggiungere le cartelle solo in Query personali e in Query condivise.

D: È possibile inviare tramite posta elettronica una query?

R: Sì. Vedere Inviare tramite posta elettronica collegamenti URL a elementi di lavoro e query di TFS.

D: È possibile definire un collegamento ipertestuale che apre una query?

R: Sì. Il modo più semplice per definire un collegamento ipertestuale consiste nel creare una query in base alle necessità e quindi copiare l'URL dalla query. Il collegamento ipertestuale usa il linguaggio WIQL (Work Item Query Language) analogo a Transact-SQL che corrisponde a questa sintassi:

**http://NomeServer:**Porta/ /tfs/NomeRaccolta/NomeProgettoTeam/**q.aspx?pname=Progetto&wiql=**LinguaggioQueryElementoLavoro

Ad esempio, nel collegamento ipertestuale seguente vengono elencati l'ID, il titolo e lo stato di tutti i bug con un numero di build 9.0.30304 definito per il progetto AdventureWorksProject.

http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035

D: È possibile esportare una query?

R: Sì. Nell'editor di query di Team Explorer usare il menu File per salvare una query come file con estensione wiq. Quando si crea un progetto team, le query condivise vengono create in base ai file con estensione wiq definito nel modello di processo.

D: Perché il contenuto della lavagna delle attività è diverso da quanto viene elencato con la query creata?

R: È possibile assegnare attività a un'iterazione, ma non collegarle a un elemento backlog padre. Tali elementi verranno visualizzati nella query creata ma non nella lavagna delle attività vera e propria. TFS esegue la query e quindi applica alcuni processi in background prima di visualizzare gli elementi della lavagna delle attività.

I tre motivi seguenti possono essere causa della mancata visualizzazione di elementi di lavoro appartenenti alla categoria attività in un backlog sprint o in una lavagna delle attività:

• L'attività non è stata collegata a un elemento di backlog padre. Nella pagina di backlog sprint verranno visualizzati solo i bug e le attività che sono stati collegati a un elemento del backlog di prodotto padre (Scrum), a una storia utente (Agile) o a un requisito (CMMI) e il cui percorso di iterazione è impostato sullo sprint stesso.

• L'attività è l'elemento padre di un'altra attività. Se si è creata una gerarchia di attività, vengono visualizzate solo le attività di livello figlio in fondo alla gerarchia.

• L'elemento padre collegato dell'attività corrisponde a un elemento backlog definito per un altro team. Oppure, il percorso area dell'elemento backlog padre dell'attività è diverso dal percorso area dell'attività.

D: È possibile eseguire query a livello di codice per gli elementi di lavoro?È possibile creare una query dinamica?

R: Sì. Vedere Eseguire una query per trovare bug, attività e altri elementi di lavoro.

Vedere anche

Concetti

Scegliere il client di Team Foundation per eseguire le attività