Pole, operátory, hodnoty a proměnné dotazů

Najít a vytvářet seznamy pracovních položek vytvořením dotazů pracovní položku. Definováním jednu či více klauzulí filtru ze všech pracovních položek v rámci týmového projektu nebo kolekce týmových projektů se vrátíte sadu pracovních položek, které vás zajímají. Pro každou klauzuli zadejte do pole, operátor a hodnota nebo proměnná. Můžete například uživatele můžete vyhledat všechny pracovní položky pro konkrétní týmový projekt tak, že určíte týmový projekt pole, operátor je rovno (=) a název týmového projektu jako hodnotu. Místo určíte hodnotu, můžete určit proměnnou, jako je například @Project, který představuje aktuální týmový projekt.

Ukázky klauzuli dotazu

A/Nebo	Pole	Operátor	Hodnota
A	Týmový projekt	=	@Project

Další obecné informace o dotazech naleznete v tématu Dotaz na pracovní položky. Informace o tom, jak procházíte editor dotazů nebo zobrazení dotazu používání klávesových zkratek naleznete v tématu Klávesové zkratky: Visual Studio Online, webový portál TFS a Průzkumník týmových projektů.

V tomto tématu

• A/Nebo

• Pole dotazu a hodnoty

• Operátory dotazů

• Proměnné dotazu

• Hledá fulltextové a částečné aplikace word

• Dotaz indexovaná pole

Kontrolní seznam pro definování klauzuli dotazu:

1. V první prázdný řádek pod pole záhlaví sloupce zvolte na šipku zobrazte seznam dostupných polí a vyberte položku v seznamu.

   Další informace naleznete v tématu pole dotazu a hodnoty.

2. Ve stejném řádku v části operátor záhlaví sloupce zvolte na šipku zobrazte seznam dostupných operátorů a vyberte položku v seznamu.

   Další informace naleznete v tématu operátory.

3. Ve stejném řádku v části hodnotu záhlaví sloupce buď zadejte hodnotu, nebo zvolte na šipku dolů a zvolte položku v seznamu.

4. Další informace o tom, jak používat proměnné k určení aktuální týmový projekt, uživatele nebo data naleznete v tématu proměnné.

5. Chcete-li přidat klauzuli, zvolte Kliknutím sem přidejte novou klauzuli nebo přidejte novou klauzuli.

   Můžete přidat klauzuli na konec dotazu, vložení klauzuli za existující klauzule () a odeberte (), skupiny () a oddělit () klauzule podle potřeby.

A/Nebo

Můžete zadat a nebo nebo k vytvoření logických výrazů vaše klauzule dotazu. Zadejte a k vyhledání pracovních položek, které splňují kritéria v klauzuli aktuální a předchozí klauzule. Zadejte nebo k vyhledání pracovních položek, které splňují kritéria stanovená v aktuální klauzuli nebo klauzuli předchozí.

Za účelem upřesnění vašich kritérií vyhledávání můžete přidat jednu novou klauzuli pro každé pole pracovní položky tak, že vrátí pouze sadu pracovních položek, které chcete. Pokud neobdržíte výsledky, které očekáváte z dotazu, můžete přidat, odebrat, seskupit nebo oddělit klauzule dotazu upřesňující výsledky dotazu.

Klauzule dotazu lze seskupovat má být použito jako jednu jednotku odlišnou od zbytkem dotazu, podobně jako uvedení závorek výrazu v matematických vztah nebo logiku příkazu. Při seskupování klauzule, a nebo OR pro první klauzuli ve skupině platí pro celou skupinu.

Následující příklad ukazuje, seskupené klauzule jsou převedeny na odpovídající logický výraz. První výraz, který vrátí pracovní položky, které jsou prioritou 1, jakož i všechny aktivní chyby všechny priority. Druhý výraz vrátí všechny aktivní priority 1 pracovních položek a navíc všechny priority 1 chyby, zda jsou aktivní, či nikoli.

Seskupené klauzule	Logický výraz
	Priorita=1 OR (Typ pracovní položky = Chyba AND Stav = Aktivní)
	Priorita=1 AND (Typ pracovní položky = Chyba OR Stav = Aktivní)

Další informace naleznete v tématu Určení filtrovacích kritérií dotazu.

Pole dotazu a hodnoty

Hodnota zadaná pro pole musí odpovídat na datový typ pro toto pole. V následující tabulce jsou uvedeny podporované datové typy:

Datový typ	Uložená data
DateTime	Koordinovaný světový čas (UTC) okamžik v čase. Můžete zadat proměnnou, jako je například @Today nebo @Today-1, nebo hodnotu, jako je například 1, 1/2012.
Double	Reálné číslo, například 0,2 nebo 3,5.
GUID	Řetězec znak, který představuje jedinečný identifikátor.
History	Vlastní ve formátu pole, které slouží ke sledování historických informací. Tento datový typ se používá pouze pro podporu Historie pole. Toto pole je automaticky index pro fulltextové vyhledávání, když je k dispozici fulltextové vyhledávání. Podívejte se na téma fulltextové a částečné slovo vyhledávání popsané dále v tomto tématu.
HTML	Textové řetězce, které podporují formátovaný popisy, jako například Popis nebo kroky pro reprodukci polí. Tato pole jsou automaticky index pro fulltextové vyhledávání, když je k dispozici fulltextové vyhledávání. Podívejte se na téma fulltextové a částečné slovo vyhledávání popsané dále v tomto tématu. Poznámka Při upgradu Team Foundation Server, Popis pole je změněno z pole typu PlainText na HTML.Pomocí witadmin changefield příkaz podle potřeby můžete vrátit datový typ pro toto pole.Podívejte se na téma Manage work item fields [witadmin].
Integer	32bitové celé číslo, které je podepsán, jako jsou 0, 1, 2, 34.
PlainText	Textové řetězce, které podporují dlouhé popisy, jako například informace o spuštění aplikace pole. Tato pole jsou automaticky index pro fulltextové vyhledávání, když je k dispozici fulltextové vyhledávání. Podívejte se na téma fulltextové a částečné slovo vyhledávání popsané dále v tomto tématu.
String	Krátký textový řetězec, který může obsahovat maximálně 255 znaků Unicode.
TreePath	Větvení stromová struktura, jako je například cestu k cesta k oblasti nebo iterace. Je třeba zvolit položku v seznamu platných hodnot. Můžete najít pracovních položek, které se rovná nebo jsou poskytovány stromové struktury. Další informace naleznete v tématu Add and modify area and iteration paths.

Zpět na začátek

Operátory dotazů

Operátory dotazu v následující tabulce slouží k určení, jak musí každou hodnotu v klauzuli souvisí s odpovídající hodnotou v pracovní položku. Informace o datovém typu, která je přiřazena k pracovní položce pole naleznete v tématu Work item field reference for Visual Studio ALM.

Operátor dotazu	Vrátí hodnotu pracovní položky, pokud je hodnota v pracovní položce odpovídá uvedených kritérií	Platných datových typů
=	Odpovídá hodnotě v klauzuli.	Číslo, které zahrnuje Double, GUID, Integer, a String, DateTime, a TreePath
<>	Hodnota v klauzuli neodpovídá.	Číslo, String, DateTime, a TreePath
>	Je větší než hodnota v klauzuli.	Číslo, String, a DateTime
& lt;	Je menší než hodnota v klauzuli.	Číslo, String, a DateTime
>=	Je větší než nebo rovna hodnotě v klauzuli.	Číslo, String, a DateTime
<=	Je menší než nebo rovna hodnotě v klauzuli.	Číslo, String, a DateTime
= [Pole]	Odpovídá hodnotě, které jsou obsaženy v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
<> [pole]	Neodpovídá hodnotě, které jsou obsaženy v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
> [pole]	Je větší než hodnota, která jsou obsažena v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
< [pole]	Je menší než hodnota, která jsou obsažena v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
> = [pole]	Je větší než nebo rovna hodnotě, které jsou obsaženy v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
< = [pole]	Je menší než nebo rovna hodnotě, které jsou obsaženy v určeném poli.	Název pole, které je stejný typ dat jako zadané pole
Obsahuje	Obsahuje v případě přesné nebo částečné shody textový řetězec v rámci pole, které jste vybrali pro filtrování.	String
Neobsahuje	V případě přesné nebo částečné shody textový řetězec v rámci vybrané pro filtrování pole neobsahuje.	String
Obsahuje slova	Obsahuje přesné textový řetězec nebo slova do pole, které jste vybrali pro filtrování. Můžete také zadat částečné slova nebo fráze, které obsahují zástupný znak *. Omezení, naleznete v části fulltextové vyhledávání pro požadavky na server a řazení.	Dlouhé textových polí indexovaných pro fulltextové vyhledávání, které odpovídají všem PlainText a HTML polí a Nadpis.
Neobsahuje slova	Neobsahuje přesné textový řetězec nebo slova do pole, které jste vybrali pro filtrování.	Textová pole, které jsou indexované pro fulltextové vyhledávání.
In	Vyhledá všechny hodnoty s oddělovači sady. Například můžete vyhledat pracovních položek, jejichž ID jsou 100, 101 a 102, pokud zadáte v poli tyto hodnoty pro ID pole. Důležité Hodnoty oddělujte oddělovač seznamu, která odpovídá místní nastavení, které jsou definovány pro klientský počítač.Můžete například použít čárkou (,).	Číslo, String, DateTime, TreePath
Ve skupině	Odpovídá hodnotě, který je členem skupiny v klauzuli. Skupiny odpovídají název kategorie nebo skupina sady TFS. Můžete například vytvořit dotaz pro vyhledání všech pracovních položek, které jsou přiřazeny na členy dané skupiny přispěvatelů nebo týmu. Tým skupiny jsou vytvářeny při vytváření týmu. Název skupiny týmu následuje vzor [Název týmového projektu] / týmu název. Jako hodnotu nelze zadat zabezpečení nebo e-mailovou distribuční skupinu. Zpracované příklady naleznete v tématu Příklad dotazy.	String která odpovídá názvu skupiny uživatele nebo skupinu kategorií v Team Foundation Server. Poznámka Můžete použít do skupiny operátor pouze s pole, které používají String datový typ nebo typ pracovní položky pole. Informace o skupinách kategorií naleznete v tématu Use categories to group work item types.
Není ve skupině	Hodnota, která je členem skupiny v klauzuli neodpovídá.	String která odpovídá názvu parametru skupinu uživatelů v Team Foundation Server nebo skupině kategorií definované pro týmový projekt. Poznámka Můžete použít není ve skupině operátor pouze s pole, které používají String datový typ nebo typ pracovní položky pole. Informace o skupinách kategorií naleznete v tématu Use categories to group work item types.
Byl vždy	Odpovídá hodnotě v klauzuli předchozí kdykoli.	String, DateTime
Pod	Odpovídá hodnotě v klauzuli nebo je obsažen v uzlu v klauzuli.	TreePath
Není pod	Neodpovídá hodnotě v klauzuli a není obsažen v uzlu v klauzuli.	TreePath

Zpět na začátek

Proměnné dotazu

Můžete používat proměnné v následující tabulce můžete najít pracovní položky, které se vztahují k aktuálnímu uživateli, aktuální projekt nebo aktuální datum.

Proměnné dotazu	Využití
@Me	Automatické vyhledávání aliasu pro aktuálního uživatele v poli, které obsahuje aliasů pomocí této proměnné. Například můžete vyhledat pracovních položek, které jste otevřeli nastavíte-li pole sloupec, který se aktivován podle, operátor sloupec, který se =, a hodnotu sloupec, který se @Me.
@Project	Tato proměnná použijte k vyhledání pracovních položek v aktuální týmový projekt. Například můžete vyhledat všechny pracovní položky v aktuální týmový projekt nastavíte-li pole sloupec, který se týmový projekt, operátor sloupec, který se =, a hodnotu sloupec, který se @Project.
@Today	Pomocí této proměnné pro hledání pro pracovní položky, které se vztahují na aktuální datum nebo na dřívější datum. Můžete také změnit @Today proměnné odečtením dnů. Například můžete vyhledat všechny položky aktivován minulý týden, pokud jste nastavili pole sloupec, který se aktivován datum, operátor sloupec, který se > =, a hodnotu sloupec, který se @Today - 7.
[Any]	Pomocí této proměnné pro hledání pro pracovní položky, které se vztahují na libovolnou hodnotu, která je definována pro určité pole.

Zpět na začátek

Hledá fulltextové a částečné aplikace word

Zadejte obsahuje nebo neobsahuje k vyhledání proti přesné nebo jeho část odpovídá slova nebo fráze. Zadejte obsahuje slova nebo nemá není obsahovat slova hledání proti Přesná fráze, nebo použijte zástupný znak *. Tyto operátory pomocí indexu fulltextové vyhledávání. Zástupný znak lze použít pouze na konci částečné slova nebo fráze.

Příklady naleznete v tématu Example work item queries a Query for work items using the History field.

Poznámka

Ne všechny nasazení podporu, fulltextové vyhledávání.Můžete například SQL Express a SQL Azure, které podporují Visual Studio Online, nepodporují fulltextové vyhledávání.V těchto případech, zobrazí se pouze obsahuje a neobsahuje operátory.

Obsahuje slova a nemá není obsahovat slova filtrovat podle indexu fulltextové vyhledávání pro dlouhé textových polí vytvořit položky. Team Foundation automaticky indexuje všech dlouhé textových polí s datovým typem objektu PlainText a HTML a Nadpis pole pro fulltextové vyhledávání. Index a operátory jsou k dispozici pouze při serveru SQL Server, který podporuje Team Foundation Server podporuje fulltextové vyhledávání.

Fulltextové vyhledávání vyžadují řazení SQL, která odpovídá jazyce, který má nástroj k dělení slov registrovány k serveru SQL Server. Pokud nastavení řazení pro členy týmu projektu databáze kolekce používaná pro vaše Team Foundation Server instance neodpovídají podporovaného jazyka, výsledky hledání nemusí odpovídat očekávání. V těchto případech může zkusit použít obsahuje nebo neobsahuje operátory.

Další informace naleznete v tématu fulltextové vyhledávání dotazy a nastavení řazení.

Dotaz indexovaná pole

Kromě index fulltextové vyhledávání je vytvořena index dotazu. Je založena na těchto polí, které mají indexování povoleno. Index dotazu vylepšuje doba odezvy při spuštění dotazy, které obsahují indexovaná pole.

Ve výchozím nastavení jsou indexované následujících polí: přiřazeno, Datum vytvoření, změnit podle, Stav, důvod, ID oblasti, iteraci ID, a typ pracovní položky. Pokud existují další pole, které váš tým často používá v jejich dotazy, přidejte je do indexu dotazu.

Můžete použít witadmin indexfield příkazu k povolení nebo zakázání indexování pro pole. Podívejte se na téma Manage work item fields [witadmin].

Viz také

Koncepty

Dotaz na pracovní položky