Condividi tramite


Esecuzione di query su campi, operatori, valori e variabili

È possibile trovare e creare liste di elementi di lavoro creando query di elemento di lavoro.Definendo una o più clausole, si filtrano tutti gli elementi di lavoro all'interno di un progetto team o di una raccolta di progetti team per restituire il set di elementi di lavoro che interessano.Per ciascuna clausola, si specifica 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 Trovare 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

  • Ricerche full-text di parola e parziale

  • Campi indicizzati query

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

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

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

  2. Nella stessa riga, 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, sotto l'intestazione della colonna Valore, digitare un valore, o fare clic sulla freccia in giù e selezionare un elemento nell'elenco.

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

  5. Per aggiungere una clausola, scegliere Fare clic qui per aggiungere una nuova clausola o Aggiungi una nuova clausola.

    È possibile aggiungere una clausola alla fine della query, inserirla dopo una clausola esistente (Inserire una clausola di query) e rimuovere (Eliminare una clausola di query), raggruppare (Raggruppare le clausole di query) e dividere (Separare le clausole di una query) le clausole a seconda delle esigenze.

And/Or

Specificare E oppure O per creare espressioni logiche delle clausole query.Specificare E per trovare elementi di lavoro che soddisfano i criteri sia della clausola corrente che di quella precedente.Specificare O per trovare elementi di lavoro che soddisfano i criteri o della clausola corrente o di quella precedente.

È possibile aggiungere una nuova clausola per ogni campo elemento di lavoro allo scopo di limitare i criteri di ricerca, in modo che restituisca 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.

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 nell'esempio riportato di seguito, le clausole raggruppate vengono convertite nell'espressione logica corrispondente.La prima espressione restituisce gli elementi di lavoro con priorità 1, nonchéé 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

Operatore OR con clausola AND raggruppata

Priority=1 OR (Work Item Type=Bug AND State=Active)

Operatore AND con clausola OR raggruppata

Priority=1 AND (Work Item Type=Bug OR State=Active)

Per ulteriori informazioni, vedere Specificare criteri di filtro della query.

Eseguire query su campi e valori

Il valore specificato per un campo deve essere conforme al tipo di dati per quel campo.Nella tabella riportata di seguito sono elencati i tipi di dati supportati.

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/2012.

Double

Un numero reale, quale 0,2 o 3,5.

GUID

Una stringa di caratteri che rappresenta un ID univoco.

History

Campo formattato personalizzato utilizzato per tenere traccia di informazioni cronologiche.Questo tipo di dati viene utilizzato solo per supportare il campo Cronologia.Questo campo viene automaticamente indicizzato per la ricerca full-text quando la ricerca full-text è disponibile.Vedere Ricerche full-text di parola e parziale descritto più avanti in questo argomento.

HTML

Stringhe di testo che supportano descrizioni formattate, quali i campi Passaggi riproduzione bug o Descrizione.Questi campi vengono automaticamente indicizzati per la ricerca full-text quando la ricerca full-text è disponibile.Vedere Ricerche full-text di parola e parziale descritto più avanti in questo argomento.

NotaNota
Quando si aggiorna Team Foundation Server, il campo Descrizione viene modificato da un tipo di campo PlainText a HTML.Utilizzando il comando di witadmin changefield è possibile ripristinare il tipo di dati per questo campo in base alle necessità.Vedere Gestire i campi degli elementi di lavoro [witadmin].

Integer

Un intero a 32 bit con segno, quali 0, 1, 2, 34.

PlainText

Stringhe di testo che supportano descrizioni lunghe, ad esempio il campo Informazioni avvio applicazione.Questi campi vengono automaticamente indicizzati per la ricerca full-text, quando la ricerca full-text è disponibile.Vedere Ricerche full-text di parola e parziale descritto più avanti in questo argomento.

String

Stringa di testo breve che può contenere un massimo di 255 caratteri unicode.

TreePath

Una struttura ad albero con rami, quale un percorso di area o un percorso di iterazione.È necessario scegliere 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.Per ulteriori informazioni, vedere Creare e modificare aree e iterazioni.

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 Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.

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.

Numeri, che include Double, GUID, Integere String, DateTimee TreePath

<>

Non corrisponde al valore nella clausola.

Numero, String, DateTimee TreePath

>

È maggiore del valore nella clausola.

Numero, Stringe DateTime

<

È minore del valore nella clausola.

Numero, Stringe DateTime

>=

È maggiore o uguale al valore nella clausola.

Numero, Stringe DateTime

<=

È minore o uguale al valore nella clausola.

Numero, Stringe DateTime

=[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 una corrispondenza esatta o parziale della stringa di testo all'interno del campo selezionato per il filtraggio.

String

Non contiene

Non contiene una corrispondenza esatta o parziale della stringa di testo all'interno del campo selezionato per il filtro.

String

Contiene parole

Contiene la stringa di testo esatta o parole all'interno del campo selezionato per il filtro.È inoltre possibile immettere le parole parziali o le frasi che contengono il carattere jolly, *.Per le restrizioni, vedere Ricerca full-text per i requisiti delle regole di confronto e del server.

Campi di A lungo testo che vengono indicizzati per la ricerca full-text, che corrispondono a tutti i campi di HTML e di PlainText e a Posizione.

Non contiene parole

Non contiene la stringa di testo esatta o parole all'interno del campo selezionato per il filtro.

I campi di testo che sono indicizzati per la ricerca full-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.

Nota importanteImportante
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, String, DateTime, TreePath

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.

NotaNota
Non è possibile specificare un gruppo di sicurezza o di distribuzione di posta elettronica come valore.

String che corrisponde al nome di un gruppo di categorie o del gruppo di utenti in Team Foundation Server.

NotaNota
È possibile utilizzare l'operatore Nel gruppo solo in campi che utilizzano il tipo di dati di String o il campo Tipo di elemento di lavoro.

Per informazioni sui gruppi di categorie, vedere Definire categorie per raggruppare tipi di elementi di lavoro.

Non nel gruppo

Non corrisponde a un valore che è un membro del gruppo nella clausola.

String che corrisponde al nome di un gruppo di utenti in Team Foundation Server o di un gruppo di categorie definite per un progetto team.

NotaNota
L'operatore Non nel gruppo può essere utilizzato solo in campi che utilizzano dati di tipo String o nel campo Tipo di elemento di lavoro.

Per informazioni sui gruppi di categorie, vedere Definire categorie per raggruppare tipi di elementi di lavoro.

Era sempre

Corrisponde al valore nella clausola in corrispondenza di qualsiasi punto precedente.

String, DateTime

Incluso

Corrisponde al valore nella clausola o contenuto nel nodo nella clausola.

TreePath

Non incluso

Non corrisponde al valore nella clausola e non è contenuto nel nodo nella clausola.

TreePath

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

Ricerche full-text di parola e parziale

Specificare contiene o non contiene per trovare e minuscole o corrispondenze parziali di una parola o una frase.Specificare contiene parole o non contiene parole per trovare in una frase completa o utilizzare il carattere jolly, *.Questi operatori utilizzano l'indice di ricerca full-text.È possibile utilizzare solo il carattere jolly alla fine di una parola parziale o una frase.

Per i relativi esempi, vedere Trovare elementi di lavoro in base a parole chiave o frasi e Visualizzazione della cronologia e ricerca degli elementi di lavoro tramite il campo Cronologia.

[!NOTA]

Non tutte le distribuzioni supportano le ricerche full-text.Ad esempio, SQL Express e SQL Azure, che supportano il servizio di Team Foundation, non supportano la ricerca full-text.In tali casi, verranno visualizzati solo gli operatori non contiene e contiene.

contiene parole e elementi del filtro non contiene parole basati sull'indice di ricerca full-text creato per i campi di a lungo testo.Team Foundation automaticamente indicizza tutti i campi di a lungo testo con un tipo di dati di PlainText e di HTML e il campo Posizione per la ricerca full-text.L'indice e operatori sono disponibili solo quando SQL Server che supporta la ricerca full-text di supportare di Team Foundation Server.

Ricerche full-text richiedono le regole di confronto SQL che corrispondono ad un linguaggio che ha un word breaker registrato con SQL Server.Se le impostazioni delle regole di confronto per il database della raccolta di progetti team utilizzato per la istanza Team Foundation Server non corrispondono alla lingua supportata, i risultati della ricerca potrebbero non corrispondere alle aspettative.In questi casi, è possibile provare ad utilizzare gli operatori Contiene o Non contiene.

Per ulteriori informazioni, vedere Query di ricerca Full-Text e Impostazioni delle regole di confronto.

Campi indicizzati query

Oltre all'indice di ricerca full-text, indice di query viene creata.Si basa sui campi che dispongono di indicizzazione abilitato.L'indice di query aggiorna il tempo di risposta in cui eseguire le query che includono i campi indicizzati.

Per impostazione predefinita, i campi seguenti vengono indicizzati: Assegnato a, Data creazione, Modificato da, Stato, Motivo, ID area, ID iterazionee Tipo di elemento di lavoro.Se esistono altri campi che il team utilizza spesso nelle query, è possibile aggiungerli all'indice di query.

Utilizzare il comando di witadmin indexfield abilitare o disabilitare l'indicizzazione per un campo.Vedere Gestire i campi degli elementi di lavoro [witadmin].

Vedere anche

Attività

Specificare criteri di filtro della query

Utilizzo di una query elenco semplice (predefinita)

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

Concetti

Trovare bug, attività e altri elementi di lavoro

Altre risorse

Utilizzo di dipendenze collegate (Collegamenti diretti)

Cronologia delle modifiche

Data

Cronologia

Motivo

Agosto 2012

Tabella corretta che descrive i tipi di dati di campo e Description rimosso dal set di campi che vengono indicizzati per la ricerca full-text.Aggiunte due sezioni su andn di ricerche full-text la query indicizza.

Miglioramento delle informazioni.