Specificare criteri di filtro della query

È possibile specificare i criteri di filtro della query per trovare elementi di lavoro di interesse proprio o del team.È possibile utilizzare le macro nella query per controllare le assegnazioni, e attività in corso, o per trovare gli elementi che sono stati aggiornati di recente.

Tutte le query elemento di lavoro sono costituite da una o più clausole di query.In ogni clausola cono inclusi un campo, un operatore e un valore.È possibile aggiungere, modificare e raggruppare le clausole e i campi nelle query per trovare l'insieme di elementi di lavoro di proprio interesse.La definizione di una query è spesso un processo iterativo, in cui vengono modificati i criteri di filtro fino ad ottenere i risultati desiderati.

In questo argomento

1. Selezionare il tipo di query

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

3. (Facoltativo) Specificare criteri di filtro per trovare elementi di lavoro collegati

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

5. Eseguire o annullare una query e controllare i risultati

6. 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.

Requisiti

• Per eseguire queste procedure, è necessario essere un membro del gruppo Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti.Per ulteriori informazioni sulle autorizzazione delle query, vedere Trovare bug, attività e altri elementi di lavoro.

1.Selezionare il tipo di query

1. Aprire il progetto team, scegliere la pagina Work Items, quindi scegliere Nuova query.

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

2. 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(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 Utilizzo di una query elenco semplice (predefinita).

   • 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 Utilizzo di dipendenze collegate (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 Utilizzo di gerarchie collegate (Struttura ad albero degli elementi di lavoro).

   Per un riepilogo delle attività supportate da ogni tipo di query, vedere Selezionare lo strumento appropriato di query per l'attività.

Torna all'inizio

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

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, scegliere la colonna Valore per il campo Tipo di elemento di lavoro, quindi scegliere il 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 Personalizzare le 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 scegliere Esegui e verificare che i risultati restituiti dalla query siano quelli previsti.

4. Scegliere Salva query.Per ulteriori informazioni, vedere Salvare, copiare, rinominare ed eliminare query elemento di lavoro.

Torna all'inizio

3.(Facoltativo) Specificare criteri di filtro per trovare elementi di lavoro collegati

Se è stata selezionata Elementi di lavoro e collegamenti diretti o Struttura ad albero degli elementi di lavoro, è possibile specificare i criteri di filtro per gli elementi di lavoro collegati esattamente come per gli elementi di lavoro di primo livello che vengono trovati.

Per specificare i criteri di filtro per le query di elementi di lavoro e collegamenti diretti

1. Selezionare Elementi di lavoro collegati corrispondenti alla query seguente.Aggiungere e raggruppare le clausole nello stesso modo in cui sono state definite per i criteri di primo livello.

   Criteri di filtro per elementi di lavoro collegati

   

2. Selezionare un elemento in Filtri di collegamento per filtrare un elenco gli elementi di lavoro di primo livello:

   • 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 di lavoro con collegamenti specifici: vengono restituiti gli elementi di lavoro di primo livello, ma solo se possiedono collegamenti a elementi di lavoro specificati dai criteri di filtro degli elementi di lavoro collegati.

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

3. Facoltativo: scegliere Restituisci tipi di collegamento selezionati e quindi selezionare una o più delle caselle di controllo disponibili per i tipi di collegamento da includere nei criteri di filtro.

4. Sulla barra degli strumenti delle query scegliere Esegui e verificare che i risultati restituiti dalla query siano quelli previsti.

5. Modificare i criteri di filtro ed eseguire nuovamente la query fino a ottenere il primo e il secondo livello di elementi di lavoro desiderati.

Per specificare criteri di filtro per una struttura ad albero di elementi di lavoro

1. In Filtri per elementi di lavoro collegati, aggiungere e raggruppare le clausole nello stesso modo in cui sono state definite per i criteri di primo livello.

2. Selezionare i Filtri di collegamento che consentiranno inoltre di filtrare gli elementi di lavoro di primo livello come segue:

   1. Identificare elementi di lavoro di primo livello: Esegue una ricerca dall'alto verso il basso.Tutti gli elementi di lavoro di primo livello vengono restituiti.Tutti gli elementi di lavoro collegati al primo livello vengono restituiti se corrispondono ai criteri di filtro degli elementi di lavoro collegati.

   2. Trova corrispondenza con elementi di lavoro collegati: Esegue una ricerca dal basso verso l'alto.Trova tutti gli elementi di lavoro collegati, quindi restituisce gli elementi di lavoro di primo livello collegati agli elementi trovati.

3. (Facoltativo) scegliere Tipo di struttura ad albero.Se sono stati aggiunti tipi di collegamento personalizzati con topologia a struttura ad albero, è possibile scegliere dai valori elencati in un set personalizzato di tipi di collegamenti gerarchici.Vedere Riferimento all'elemento tipo di collegamento.

4. Sulla barra degli strumenti delle query scegliere Esegui e verificare che i risultati restituiti dalla query siano quelli previsti.

5. Modificare i criteri di filtro ed eseguire nuovamente la query fino a ottenere il primo e il secondo livello di elementi di lavoro desiderati.

Torna all'inizio

4.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.

È possibile raggruppare le clausole di query 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, scegliere Fare clic per aggiungere una nuova clausola.

   2. In alternativa, per inserire una clausola, selezionare la cella nella prima colonna in cui si desidera inserire la clausola per evidenziare la riga, aprire il menu di scelta rapida e quindi 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 considerata come una clausola Or, scegliere la freccia giù accanto a Andquindi scegliere 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. Per eliminare una clausola di query, aprire il menu di scelta rapida per la clausola quindi 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 scegliendo la cella più a sinistra delle righe.Premere CTRL e fare clic per selezionare più righe.

   2. Aprire il menu di scelta rapida per le 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. Aprire il menu di scelta rapida per il gruppo, 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

5.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.

1. Sulla barra degli strumenti delle query scegliere 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, scegliere 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

6.Regolare i criteri di filtro della query

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

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

  • 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 .

  • Controllare il raggruppamento delle clausole di query e le assegnazioni And/Or 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 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

Vedere anche

Attività

Utilizzo di una query elenco semplice (predefinita)

Utilizzo di gerarchie collegate (Struttura ad albero degli elementi di lavoro)

Concetti

Esecuzione di query su campi, operatori, valori e variabili

Query elemento di lavoro di esempio

Trovare bug, attività e altri elementi di lavoro

Altre risorse

Utilizzo di dipendenze collegate (Collegamenti diretti)