Esecuzione di query su campi, operatori, valori e variabili

Quando si crea una query per cercare elementi di lavoro in Visual Studio Team Foundation Server 2010, è possibile definire una o più clausole che identificano il set di elementi di lavoro che si desidera trovare. Per ciascuna clausola, è possibile specificare un campo, un operatore e un valore o una variabile. Ad esempio, è possibile cercare tutti gli elementi di lavoro in un particolare progetto team specificando il campo Progetto Team, l'operatore di uguaglianza (=) e il nome del progetto team come valore. In alternativa al valore, è possibile specificare una variabile, quale @Progetto, che rappresenta il progetto team corrente.

Esempio di clausola di query

And/Or	Campo	Operatore	Valore
And	Progetto Team	=	@Project

Per ulteriori informazioni generali sulle query, vedere Individuazione di bug, attività e altri elementi di lavoro. Per informazioni sullo spostamento all'interno dell'editor di query o della visualizzazione query utilizzando scelte rapide da tastiera, vedere Tasti di scelta rapida per l'editor di query e per la visualizzazione dei risultati delle query.

In questo argomento

• And/Or

• Eseguire query su campi e valori

• Operatori di query

• Variabili di query

Elenco di controllo per la definizione di una clausola di query:

1. Nella prima riga vuota, fare clic sotto l'intestazione di colonna Campo, fare clic sulla freccia in giù per visualizzare l'elenco di campi disponibili e fare clic su un elemento nell'elenco.

   Per ulteriori informazioni, vedere Eseguire query su campi e valori.

2. Nella stessa riga, fare clic sotto l'intestazione di colonna Operatore, fare clic sulla freccia in giù per visualizzare l'elenco di operatori disponibili e selezionare un elemento nell'elenco.

   Per ulteriori informazioni, vedere Operatori.

3. Nella stessa riga, fare clic sotto l'intestazione di colonna Valore.

4. Digitare un valore o fare clic sulla freccia in giù e selezionare un elemento nell'elenco.

5. Per ulteriori informazioni su come utilizzare le variabili per specificare il progetto team, l'utente o la data correnti, vedere Variabili.

6. Per aggiungere una clausola, fare clic su Fare clic qui per aggiungere un'istruzione.

   È possibile aggiungere una clausola alla fine della query, inserirla dopo una clausola esistente () e rimuovere (), raggruppare () e dividere () le clausole a seconda delle esigenze. È inoltre possibile copiare e incollare il contenuto di una clausola in una nuova posizione. Per ulteriori informazioni, vedere Specificare criteri di filtro della query.

And/Or

È possibile utilizzare questa colonna per specificare come vengono testate le clausole. È possibile specificare E se si desidera trovare elementi di lavoro che soddisfano i criteri sia di questa clausola che di quella precedente. È possibile specificare O se si desidera trovare elementi di lavoro che soddisfano i criteri o di questa clausola o di quella precedente.

Eseguire query su campi e valori

Quando si specifica un valore per un campo, il valore deve essere conforme al tipo di dati di quel campo. Tutti i campi in Team Foundation dispongono di uno dei tipi di dati elencati nella tabella seguente:

Tipo di dati	Dati archiviati
DateTime	Ora UTC (Coordinated Universal Time). È possibile specificare una variabile, quale @Today o @Today-1, o un valore, quale ad esempio 1/1/2009.
Double	Un numero reale, quale 0,2 o 3,5.
GUID	Una stringa di caratteri che rappresenta un ID univoco.
HTML	Stringhe di testo che supportano descrizioni formattate.
Integer	Un intero a 32 bit con segno, quali 0, 1, 2, 34.
PlainText	Le stringhe di testo che supportano descrizioni lunghe, quali i campi Descrizione o Cronologia, vengono definite per un elemento di lavoro. È possibile trovare elementi di lavoro in base a una frase o una parola chiave contenuta all'interno di un campo di testo normale.
Stringa	Stringa di testo che contiene fino a 255 caratteri Unicode.
TreePath	Una struttura ad albero con rami, quale un percorso di area o un percorso di iterazione. È necessario fare clic su un elemento in un elenco di valori validi. È possibile trovare elementi di lavoro che sono allo stesso livello della struttura ad albero o che sono in livelli sottostanti.

Torna all'inizio

Operatori di query

È possibile utilizzare gli operatori di query indicati nella tabella seguente per specificare la relazione tra ciascun valore in una clausola e il valore corrispondente in un elemento di lavoro. Per informazioni sul tipo di dati assegnato ai campi elemento di lavoro, vedere Utilizzo dei campi di sistema e dei campi definiti tramite i modelli di processo MSF.

Operatore di query	Restituisce degli elementi di lavoro se il valore nell'elemento di lavoro corrisponde ai criteri elencati.	Tipi di dati applicabili
=	Corrisponde al valore nella clausola.	Numero, Testo, Data, Struttura ad albero
<>	Non corrisponde al valore nella clausola.	Numero, Testo, Data, Struttura ad albero
>	È maggiore del valore nella clausola.	Numero, Testo, Data
<	È minore del valore nella clausola.	Numero, Testo, Data
>=	È maggiore o uguale al valore nella clausola.	Numero, Testo, Data
<=	È minore o uguale al valore nella clausola.	Numero, Testo, Data
=[Campo]	Corrisponde al valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
<>[Campo]	Non corrisponde al valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
>[Campo]	È maggiore del valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
<[Campo]	È minore del valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
>=[Campo]	È maggiore o uguale al valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
<=[Campo]	È minore o uguale al valore che è contenuto nel campo specificato.	Nome di un campo che è dello stesso tipo di dati del campo specificato.
Contiene	Contiene il valore di testo nella clausola.	Testo
Non contiene	Non contiene il valore di testo nella clausola.	Text
In	Corrisponde a qualsiasi valore in un set delimitato. Ad esempio, è possibile trovare elementi di lavoro i cui ID sono 100, 101 e 102 se si specificano quei valori per il campo ID. Importante Separare i valori con il separatore di elenco che corrisponde alle impostazioni internazionali definite per il computer client.È ad esempio possibile utilizzare una virgola (,).	Numero, Testo, Data, Struttura ad albero
In Group	Corrisponde un valore che è un membro del gruppo nella clausola. È possibile specificare un gruppo predefinito, personalizzato o di categorie in Team Foundation Server. È possibile, ad esempio, creare una query per trovare tutti gli elementi di lavoro assegnati a membri del gruppo Contributors. Nota Non è possibile specificare un gruppo di sicurezza o di distribuzione di posta elettronica come valore.	Stringa corrispondente al nome di un gruppo utenti o di un gruppo di categorie in Team Foundation Server. Nota L'operatore Nel gruppo può essere utilizzato solo in campi che utilizzano dati di tipo stringa o nel campo Tipo di elemento di lavoro. Per informazioni sui gruppi di categorie, vedere Raggruppamento dei tipi di elementi di lavoro in categorie.
Non nel gruppo	Non corrisponde a un valore che è un membro del gruppo nella clausola.	Stringa corrispondente al nome di un gruppo utenti o di un gruppo di categorie in Team Foundation Server Nota L'operatore Non nel gruppo può essere utilizzato solo in campi che utilizzano dati di tipo stringa o nel campo Tipo di elemento di lavoro. Per informazioni sui gruppi di categorie, vedere Raggruppamento dei tipi di elementi di lavoro in categorie.
Era sempre	Corrisponde al valore nella clausola in corrispondenza di qualsiasi punto precedente.	Testo, Data
Incluso	Corrisponde al valore nella clausola o contenuto nel nodo nella clausola.	Struttura ad albero
Non incluso	Non corrisponde al valore nella clausola e non è contenuto nel nodo nella clausola.	Struttura ad albero

Torna all'inizio

Variabili di query

È possibile utilizzare le variabili indicate nella tabella seguente per trovare elementi di lavoro correlati all'utente, al progetto o alla data corrente.

Variabile di query	Utilizzo
@Me	Utilizzare questa variabile per eseguire automaticamente la ricerca dell'alias dell'utente corrente in un campo contenente alias utente. È ad esempio possibile trovare elementi di lavoro che sono stati aperti se si imposta la colonna Campo su Attivato da, la colonna Operatore su = e la colonna Valore su @Me.
@Project	Utilizzare questa variabile per cercare elementi di lavoro nel progetto team corrente. È ad esempio possibile trovare tutti gli elementi di lavoro nel progetto team corrente se si imposta la colonna Campo su Progetto Team, la colonna Operatore su = e la colonna Valore su @Project.
@Today	Utilizzare questa variabile per cercare elementi di lavoro correlati alla data corrente o a una data precedente. È inoltre possibile modificare la variabile @Today sottraendo giorni. È ad esempio possibile trovare tutti gli elementi attivati nell'ultima settimana se si imposta la colonna Campo su Data di attivazione, la colonna Operatore su >= e la colonna Valore su @Today - 7.
[Any]	Utilizzare questa variabile per cercare elementi di lavoro correlati a qualsiasi valore che è stato definito per un particolare campo.

Torna all'inizio

Vedere anche

Attività

Specificare criteri di filtro della query

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

Individuazione di bug, attività e altri elementi di lavoro

Altre risorse

Condivisione di elementi di lavoro e query con i membri del team

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2010	Informazioni corrette sul delimitatore che si utilizza specificando più valori.	Commenti e suggerimenti dei clienti.
Settembre 2010	Informazioni corrette sui valori che è possibile specificare per gli operatori Nel gruppo e Non nel gruppo.	Commenti e suggerimenti dei clienti.