Specificare criteri di filtro della query

È possibile specificare i criteri di filtro della query per trovare elementi di lavoro e selezionare più facilmente i dati filtrati che si desidera utilizzare. Utilizzando criteri di filtro diversi, è possibile controllare le assegnazioni o le attività in corso relative a un utente specifico oppure visualizzare un elenco delle funzionalità assegnate a un utente o al team.

Tutte le query elemento di lavoro sono costituite da una o più clausole query. Ogni clausola include un campo, un operatore e un valore. È possibile aggiungere, modificare e raggruppare clausole e campi in query che vengono create filtrando il set di elementi di lavoro in base alle proprie esigenze.

In questo argomento

Per specificare i criteri di filtro, completare le procedure riportate di seguito finché nella visualizzazione Risultati query non sarà elencato il set di elementi di lavoro desiderato:

1. Selezionare il tipo di query

2. Specificare i criteri di filtro della query di primo livello

3. Aggiungere, rimuovere, raggruppare o separare clausole di query

4. Eseguire o annullare una query e controllare i risultati della query

5. Regolare i criteri di filtro della query

   Nota

   Le seguenti procedure sono redatte per Team Explorer. Le procedure per Team Web Access sono simili ma i dettagli possono variare leggermente.

Per filtrare i criteri in base a un valore di data o a un valore appartenente a un gruppo, vedere le procedure riportate di seguito:

• Specificare un filtro in base a un valore di data e ora

• Specificare un filtro in base all'appartenenza a un gruppo

Autorizzazioni necessarie

Per eseguire queste procedure, è necessario essere un membro del gruppo Readers oppure che l'autorizzazione Visualizza elementi di lavoro in questo nodo sia impostata su Consenti. Per salvare una query come query Team, è necessario essere un membro del gruppo Project Administrators. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Selezionare il tipo di query

Per selezionare il tipo di query in Team Explorer

1. Aprire il progetto Team, espandere il nodo Elementi di lavoro e quindi scegliere Query Team o Query.

2. Scegliere Aggiungi query dal menu Team. In alternativa, fare clic con il pulsante destro del mouse sul nodo Elementi di lavoro, Query o Query Team, quindi scegliere Aggiungi query.

   Viene visualizzata una nuova query Elenco completo di elementi di lavoro (predefinito).

3. Sulla barra degli strumenti della query selezionare un valore in Tipo di query in base al tipo di visualizzazione o di elementi di lavoro che si desidera trovare:

   • Elenco completo di elementi di lavoro (predefinito): restituisce un solo livello ( elenco semplice) di elementi di lavoro che corrispondono ai criteri di filtro. Utilizzare questo tipo di query per trovare gli elementi di lavoro che si desidera collegare ad altri elementi di lavoro, esportare elementi di lavoro in Office Excel e Office Project per gli aggiornamenti di massa ai campi colonna oppure generare un rapporto relativo a un set di elementi di lavoro. Per ulteriori informazioni, vedere Visualizzazione di un elenco di elementi di lavoro (elenco semplice predefinito).

   • Elementi di lavoro e collegamenti diretti: restituisce un set di elementi di lavoro a due livelli () che corrispondono ai criteri di filtro, nonché tutti gli elementi di lavoro ad essi collegati in base a criteri di filtro secondari. Gli elementi di lavoro vengono elencati in una visualizzazione che è possibile espandere/comprimere. Per ulteriori informazioni, vedere Visualizzare e modificare gli elementi di lavoro in una visualizzazione di collegamenti diretti.

   • Struttura ad albero elementi di lavoro: restituisce un set di elementi di lavoro a più livelli () che corrispondono ai criteri di filtro, inclusi tutti gli elementi di lavoro collegati agli elementi di lavoro di primo livello in base ai collegamenti padre-figlio. Gli elementi di lavoro vengono elencati in una visualizzazione gerarchica che è possibile espandere e comprimere. Per ulteriori informazioni, vedere Visualizzare e modificare gli elementi di lavoro in una visualizzazione struttura ad albero.

Torna all'inizio

Specificare i criteri di filtro della query di primo livello

I criteri di filtro di primo livello consentono di limitare i risultati della query a un progetto team e a un tipo di elemento di lavoro.

Nota

I criteri di filtro predefiniti specificati per una nuova query restituiscono tutti gli elementi di lavoro (Tipo di elemento di lavoro = [Any] e Stato = [Any]) assegnati a un utente (Assegnato a=@Me) per il progetto team corrente (Progetto Team=@Project).

Se si lavora su più progetti team, può essere utile eseguire ricerche in tutti i progetti con un'unica query.

Per specificare i criteri di filtro di primo livello

1. Specificare il progetto o i progetti team che contengono gli elementi di lavoro che si desidera trovare. Se si desidera che vengano restituiti elementi di lavoro per:

   • Il progetto team corrente, utilizzare Progetto Team=@Project.

   • Un altro progetto team, digitare il nome del progetto team nella colonna Valore per il campo Progetto Team.

   • Diversi progetti team, immettere i valori riportati nella tabella seguente:

     And/Or	Campo	Operatore	Valore
     	Progetto team	In	<nome primo progetto Team>, <nome secondo progetto Team>, ...

     Separare i nomi dei progetti Team con virgole (,).

2. Specificare il tipo di elementi di lavoro che si desidera trovare. Se si desidera che vengano restituiti elementi di lavoro per:

   • Tutti i tipi, utilizzare Tipo di elemento di lavoro = [Any].

   • Un solo tipo, fare clic nella colonna Valore per il campo Tipo di elemento di lavoro, quindi fare clic sul tipo di elemento di lavoro desiderato.

   • Diversi tipi di elementi di lavoro, immettere i valori riportati nella tabella seguente:

     And/Or	Campo	Operatore	Valore
     And	Tipo di elemento di lavoro	In	<primo tipo di elemento di lavoro>, <secondo tipo di elemento di lavoro>, ...

     Separare i nomi di ogni tipo di elemento di lavoro con virgole (,).

   • Tutti i tipi di elementi di lavoro appartenenti a una categoria denominata, immettere i valori riportati nella tabella seguente:

     And/Or	Campo	Operatore	Valore
     And	Tipo di elemento di lavoro	In Group	<nome del gruppo di tipi di elementi di lavoro>

     Per ulteriori informazioni sulla definizione di gruppi di tipi di elementi di lavoro, vedere Personalizzazione di categorie per tipi di elemento di lavoro [witadmin].

     Per le opzioni aggiuntive che è possibile utilizzare per filtrare criteri di primo livello, vedere la sezione "Operatori" in Esecuzione di query su campi, operatori, valori e variabili.

3. Sulla barra degli strumenti delle query fare clic su Esegui e verificare che i risultati restituiti dalla query siano quelli previsti.

4. Fare clic su Salva o su Salva con nome. Per ulteriori informazioni, vedere Salvare, copiare, rinominare ed eliminare query elemento di lavoro.

Torna all'inizio

Aggiungere, rimuovere, raggruppare o separare clausole di query

È possibile aggiungere una nuova clausola per ogni campo elemento di lavoro per limitare i criteri di ricerca e restituire solo il set di elementi di lavoro desiderati. Se la query non restituisce i risultati previsti, è possibile aggiungere, rimuovere, raggruppare o separare clausole di query per limitare i risultati della query. Per ulteriori informazioni sugli elementi di una clausola di query, vedere Esecuzione di query su campi, operatori, valori e variabili.

Ogni clausola di query include un nome di campo, un operatore di query e un valore. Al fine di ottenere risultati utili, è possibile inserire nella query un numero illimitato di clausole.

Le clausole di query possono essere raggruppate in una singola unità separata dal resto della query, analogamente a quanto avviene con l'inserimento di parentesi per separare un'espressione in un'equazione matematica o in un'istruzione logica. Quando si raggruppano clausole, l'operatore AND o OR per la prima clausola del gruppo viene applicato all'intero gruppo.

Come illustrato nella tabella riportata di seguito, le clausole raggruppate vengono convertite nell'espressione logica corrispondente. La prima espressione restituisce 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 aggiungere, rimuovere, raggruppare o separare clausole di query

1. Aggiungere una clausola in uno dei modi seguenti:

   1. Per aggiungere la clausola alla fine dei criteri di filtro, fare clic su Fare clic per aggiungere una nuova clausola.

   2. In alternativa, per inserire una clausola fare clic con il pulsante destro del mouse nel punto in cui si desidera inserirla e scegliere Inserisci clausola.

      La riga della nuova clausola di query verrà aggiunta sopra il punto in cui era posizionato il puntatore.

   3. Se si desidera che la clausola venga gestita come una clausola Or, fare clic su And, quindi su Or.

      Selezionare And se questa clausola e quella precedente devono essere entrambe true per restituire un risultato. Selezionare Or se questa clausola o quella precedente deve essere true per restituire un risultato.

   4. Specificare i valori per Campo, Operatore e Valore.

      Colonna della query	Utilizzo
      Campo	Specificare un campo per il tipo di elementi di lavoro che si desidera trovare. Il set di elementi di lavoro viene filtrato in base alle impostazioni di Operatore e Valori definite per il campo. Premere ALT+FRECCIA GIÙ oppure digitare il nome del campo che si desidera selezionare.
      Operatore	Specificare in che modo la query confronta il valore trovato nel campo specificato in un record. Alcuni operatori di esempio sono = (uguale a), <> (diverso da), > (maggiore di), < (minore di), >= (maggiore o uguale a), <= (minore o uguale a), Contiene, Non contiene, In e Era sempre.
      Valore	Specificare il valore che si desidera trovare nel campo selezionato. Se è disponibile un elenco di valori da cui effettuare una scelta, fare clic sulla freccia per selezionare quello desiderato. È possibile specificare una variabile di query per aggiungere dinamicamente valori alla query. Se è disponibile un elenco di valori da cui effettuare una scelta, fare clic sulla freccia per selezionare quello desiderato. Se sono presenti diversi valori da filtrare, utilizzare l'operatore In per specificare un elenco di valori delimitati da virgole. Per specificare un valore dinamico, specificare una variabile di query valida.

      Per ulteriori informazioni, vedere Esecuzione di query su campi, operatori, valori e variabili.

2. Eliminare una clausola di query facendo clic con il pulsante destro del mouse a sinistra della riga della clausola che si desidera eliminare e scegliere Elimina clausole.

3. Raggruppare clausole di query elemento di lavoro attenendosi alla procedura seguente:

   1. Nella query selezionare le clausole di query che si desidera combinare in un gruppo facendo clic sulla cella più a sinistra delle righe. Premere CTRL e fare clic per selezionare più righe.

   2. Fare clic con il pulsante destro del mouse sulle clausole selezionate e scegliere Raggruppa clausole.

      Nel margine sinistro della query viene visualizzata una parentesi per indicare che le clausole sono raggruppate.

4. Separare clausole di query elemento di lavoro attenendosi alla procedura seguente:

   1. Nella query selezionare l'intero gruppo di clausole di query che si desidera separare facendo clic sulla cella più a sinistra delle righe. Premere CTRL e fare clic per selezionare più righe.

   2. Fare clic con il pulsante destro del mouse sul gruppo e quindi scegliere Separa clausole.

      La parentesi viene rimossa dal margine sinistro della query e le clausole vengono separate.

      Nota

      L'opzione Separa clausole non è disponibile se non sono state selezionate tutte le clausole nel raggruppamento della query. Selezionare tutte le clausole e riprovare.

Torna all'inizio

Eseguire o annullare una query e controllare i risultati

È possibile eseguire una query elemento di lavoro per cercare nel progetto team gli elementi di lavoro che corrispondono ai criteri della query. Se si apportano modifiche a elementi di lavoro che cambiano i risultati di una query, è possibile eseguire nuovamente la query per aggiornarne i risultati.

Per eseguire o annullare una query in base ai criteri di filtro della query

1. Sulla barra degli strumenti delle query fare clic su Esegui.

   Nota

   È possibile aggiungere qualsiasi campo definito per gli elementi di lavoro di cui è in corso la ricerca, per controllare la modalità di visualizzazione e ordinamento dei risultati della query. Per ulteriori informazioni, vedere Aggiungere, rimuovere, riordinare e ordinare colonne.

2. Per annullare la ricerca tramite la query, fare clic su Interrompi query oppure scegliere Interrompi aggiornamento dal menu Team.

3. Verificare i risultati della query. Se l'elenco di elementi di lavoro non corrisponde ai criteri di ricerca previsti, rivedere e modificare i criteri di filtro secondo le esigenze.

Torna all'inizio

Regolare i criteri di filtro della query

Per regolare i criteri di filtro

• Se i risultati della query non restituiscono il set di elementi di lavoro previsto, eseguire i controlli seguenti:

  1. Controllare ogni clausola per assicurarsi che sia definita come desiderato.

  2. Controllare 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.

  3. Controllare il raggruppamento delle clausole di query e le assegnazioni And/Or di ogni clausola raggruppata.

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

  5. Rivedere le opzioni disponibili per specificare campi, operatori e valori come descritto in Esecuzione di query su campi, operatori, valori e variabili. Determinare se si desidera modificare una clausola di query per utilizzare un campo, un operatore o un valore diverso.

Torna all'inizio

Specificare un filtro in base a un valore di data e ora

È possibile ordinare gli elementi di lavoro in base alla data in cui sono stati modificati o in base a un periodo di tempo specifico. Limitando l'ambito della query è possibile migliorare le prestazioni, in quanto verranno restituiti solo i risultati che corrispondono all'intervallo di date che si desidera includere.

Per trovare elementi di lavoro in base a criteri di filtro specifici della data

1. Cercare elementi di lavoro modificati oggi attenendosi alla procedura seguente:

   1. Selezionare un valore in Campo che corrisponda a un tipo di dati relativo alla data per aggiungere o modificare una clausola di query.

      Nota

      La maggior parte dei campi data contiene la parola "data" nel nome.

   2. Nella colonna Operatore selezionare = (Uguale a).

   3. Nella colonna Valore fare clic sulla freccia e selezionare @Today per la data odierna.

      Nota

      È possibile modificare questa variabile per cercare la data corrente meno un determinato numero di giorni. Per trovare ad esempio tutti gli elementi avviati nel corso dell'ultima settimana, è necessario impostare la colonna Campo su Data di attivazione, la colonna Operatore su >= e la colonna Valore su @Today - 7.

   4. Fare clic su Esegui e controllare i risultati della query.

2. Cercare elementi di lavoro modificati in una data specifica attenendosi alla procedura seguente:

   1. Selezionare un valore in Campo che corrisponda a un tipo di dati relativo alla data per aggiungere o modificare una clausola di query.

   2. Nella colonna Operatore selezionare = (Uguale a).

   3. Nella colonna Valore digitare la data in base al formato accettato dal sistema operativo del computer.

   4. Fare clic su Esegui e controllare i risultati della query.

3. Cercare elementi di lavoro modificati in un intervallo di date attenendosi alla procedura seguente:

   1. Selezionare un valore in Campo che corrisponda a un tipo di dati relativo alla data per aggiungere o modificare una clausola di query.

   2. Nella colonna Operatoreselezionare > (maggiore di) se si desidera trovare solo gli elementi successivi alla data selezionata oppure >= (maggiore di o uguale a) se si desidera trovare gli elementi che comprendono tale data.

   3. Nella colonna Valore immettere la prima data dell'intervallo in base al formato di data accettato dal sistema operativo del computer.

   4. Inserire un'altra clausola di query direttamente sotto quella precedente.

   5. Nella colonna delle assegnazioni And/Or selezionare And.

   6. Nella colonna Operatoreselezionare < (minore di) se si desidera trovare solo gli elementi precedenti alla data selezionata oppure <= (minore di o uguale a) se si desidera trovare gli elementi che comprendono tale data.

   7. Nella colonna Valore immettere l'ultima data dell'intervallo seguendo il formato data accettato dal sistema operativo del computer.

   8. Nella colonna Operatore selezionare = (Uguale a).

   9. Nella colonna Valore digitare la data in base al formato accettato dal sistema operativo del computer.

   10. Selezionare le due clausole di query specifiche della data e raggrupparle.

   11. Fare clic su Esegui e controllare i risultati della query.

Torna all'inizio

Specificare un filtro in base all'appartenenza a un gruppo

È possibile utilizzare l'operatore In Group o Not In Group per filtrare una query in base a diversi valori, membri o meno di un gruppo. In Team Foundation Server, è possibile specificare gruppi di distribuzione oppure una o più categorie di tipi di elemento di lavoro.

Per trovare elementi di lavoro in base a un valore appartenente a un gruppo

1. Specificare i tipi seguenti di clausole:

   • Per trovare gli elementi di lavoro assegnati a un qualsiasi utente che appartiene al gruppo Project Administrators, aggiungere la clausola seguente:

     And/Or	Campo	Operatore	Valore
     And	Assegnato a	In Group	Project Administrators

   • Per trovare gli elementi di lavoro attivi di qualsiasi tipo nel gruppo della categoria Test, aggiungere la clausola seguente:

     And/Or	Campo	Operatore	Valore
     And	Stato	=	Active
     And	Tipo di elemento di lavoro	In Group	Test

   Per informazioni sui gruppi di categorie, vedere Raggruppamento dei tipi di elementi di lavoro in categorie.

2. Fare clic su Esegui query e controllare i risultati della query.

Torna all'inizio

Vedere anche

Attività

Aggiungere, rimuovere, riordinare e ordinare colonne

Salvare, copiare, rinominare ed eliminare query elemento di lavoro

Visualizzazione di un elenco di elementi di lavoro (elenco semplice predefinito)

Visualizzare e modificare gli elementi di lavoro in una visualizzazione di collegamenti diretti

Visualizzare e modificare gli elementi di lavoro in una visualizzazione struttura ad albero

Concetti

Esecuzione di query su campi, operatori, valori e variabili

Individuazione di bug, attività e altri elementi di lavoro

Cronologia delle modifiche

Data	Cronologia	Motivo
Agosto 2010	Aggiunto esempio su come viene valutata logicamente una clausola raggruppata.	Commenti e suggerimenti dei clienti.
Settembre 2010	Esempio corretto per l'operatore In Group.	Commenti e suggerimenti dei clienti.