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

Seznamy pracovních položek se vyhledávají a vytvářejí tak, že vytvoříte dotazy na pracovní položku.Definováním jedné či více klauzulí filtrujete ze všech pracovních položek v rámci týmového projektu nebo kolekce projektu pro vrácení sady pracovních položek, které vás zajímají.Pro každou klauzuli určíte pole, operátor a hodnotu nebo proměnnou.Můžete například vyhledat všechny pracovní položky v týmovém projektu zadáním pole Týmový projekt, operátoru rovná se (=) a názvu týmového projektu jako hodnoty.Místo určení hodnoty můžete určit proměnnou, jako např. @Project, který představuje aktuální týmový projekt.

Ukázka klauzule 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 pro práci v aplikaci Team Web Access a Průzkumníku týmových projektů.

V tomto tématu

  • A/nebo

  • Pole a hodnoty dotazu

  • Operátory dotazů

  • Proměnné dotazu

  • Fulltextové hledání a hledání částí slov

  • Indexovaná pole dotazu

Kontrolní seznam pro definování klauzuli dotazu:

  1. V prvním prázdném řádku, pod záhlavím sloupce Pole vyberte pomocí šipky dolů zobrazení seznamu dostupných polí a zvolte položku v seznamu.

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

  2. Ve stejném řádku v záhlaví sloupce Operátor pomocí šipky dolů otevřete seznam dostupných operátorů a zvolte položku v seznamu.

    Další informace naleznete v části Operátory.

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

  4. Další informace o tom, jak použít proměnné pro aktuální týmový projekt, uživatele nebo datum, 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 (Vložit klauzuli dotazu) a odeberte (Odstranit klauzuli dotazu), skupiny (Seskupit klauzuli dotazu) a oddělit (Zrušit seskupení klauzule dotazu) klauzule podle potřeby.

A/nebo

K vytvoření logických výrazů klauzulí dotazu použijte operátor And nebo Or.Zadejte A a vyhledejte tak pracovní položky, které splňují kritéria v aktuální klauzuli i předchozí klauzuli.Zadejte Ne a vyhledejte tak pracovní položky, které splňují kritéria v aktuální klauzuli nebo předchozí klauzuli.

Můžete přidat jednu novou klauzuli do každého pole pracovních položek s cílem upřesnit kritéria vyhledávání tak, aby vrátila pouze sadu pracovních položek, kterou chcete.Pokud neobdržíte výsledky, které očekáváte od vašeho dotazu, můžete přidat, odebrat, seskupit nebo oddělit klauzule dotazu pro upřesnění výsledků dotazu.

Klauzule dotazu mohou být pro potřeby práce seskupeny jako jediná jednotka nezávislá na zbývající části dotazu, podobně jako při vložení závorek okolo výrazu v matematické rovnici nebo logickém příkazu.Při seskupování klauzulí se operátor AND nebo OR pro první klauzuli ve skupině použije pro celou skupinu.

Jak ukazuje následující příklad, seskupené klauzule jsou přeloženy na odpovídající logický výraz.První výraz vrací pracovní položky priority 1 a všechny aktivní chyby libovolné priority.Druhý výraz vrátí všechny aktivní pracovní položky priority 1 plus všechny chyby priority 1, ať jsou aktivní nebo ne.

Seskupené klauzule

Logický výraz

Operátor s klauzulí seskupených a nebo

Priorita=1 OR (Typ pracovní položky = Chyba AND Stav = Aktivní)

Operátor s SESKUPENY nebo klauzule

Priorita=1 AND (Typ pracovní položky = Chyba OR Stav = Aktivní)

Další informace naleznete v tématu Určení filtrovacích kritérií dotazu [přesměrováno].

Pole a hodnoty dotazu

Hodnota, kterou zadáte pro pole, musí odpovídat datovému typu daného pole.V následující tabulce jsou uvedeny typy dat:

Datový typ

Uložená data

DateTime

Časový bod koordinovaného univerzálního času (UTC).Můžete určit proměnnou, jako například @Today nebo @Today-1 nebo hodnotu, například 1/1/2012.

Double

Reálné číslo, jako je například 0.2 nebo 3.5.

GUID

Znakový řetězec představující jedinečné ID.

History

Vlastní formátované pole, které slouží ke sledování historických informací.Tento typ dat se používá pouze na podporu pole Historie.Toto pole je automaticky indexováno pro fulltextové vyhledávání, když je toto vyhledávání k dispozici.Viz Fulltextové a částečné vyhledávání popsané dále v tomto tématu.

HTML

Textové řetězce, které podporují formátovaný popis, jako například pole Popis nebo Kroky pro reprodukci.Tato pole jsou automaticky indexován pro fulltextové vyhledávání, když je toto vyhledávání k dispozici.Viz Fulltextové a částečné vyhledávání popsané dále v tomto tématu.

[!POZNÁMKA]

Po upgradu na Team Foundation Server se pole Popis změnilo z typu pole PlainText na HTML.Použitím příkazu witadmin changefield můžete podle potřeby vrátit datový typ dat pro toto pole.Podívejte se na téma Správa polí pracovních položek [witadmin].

Integer

32bitové celé číslo, které je podepsán, jako jsou 0, 1, 2, 34.

PlainText

Textové řetězce, které podporují dlouhé popisy, jako pole Informace o spuštění aplikace.Tato pole jsou automaticky indexován pro fulltextové vyhledávání, když je toto vyhledávání k dispozici.Viz Fulltextové a částečné 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é struktury, například cesta Oblast nebo cesta Iterace.Je třeba vybrat položku v seznamu platných hodnot.Můžete najít pracovní položky, které se rovnají nebo jsou ve stromové struktuře.Další informace naleznete v tématu Přidání a změna cest oblastí a iterací.

Zpět na začátek

Operátory dotazů

Operátory dotazu v následující tabulce můžete použít k určení, jak se mají jednotlivé hodnoty v klauzuli vztahovat k odpovídající hodnotě v pracovní položce:Informace o datovém typu, která je přiřazena k pracovní položce pole naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

Operátor dotazu

Vrátí pracovní položky, je-li hodnota pracovní položky shodná s uvedenými podmínkami

Příslušné datové typy

=

Odpovídá hodnotě v klauzuli.

Číslo, které obsahuje Double, GUID, Integer a String, DateTime a TreePath

<>

Neodpovídá hodnotě v klauzuli.

Číslo, String, DateTime a TreePath

& gt;

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ší nebo rovno hodnotě v klauzuli.

Číslo, String a DateTime

<=

Je menší nebo rovno hodnotě v klauzuli.

Číslo, String a DateTime

=[Pole]

Odpovídá hodnotě obsažené v zadaném poli.

Název pole, které je stejného datového typu, jako zadané pole

<>[Pole]

Neodpovídá hodnotě obsažené v zadaném poli.

Název pole, které je stejného datového typu, jako zadané pole

> [pole]

Je větší, než hodnota obsažená v určeném poli.

Název pole, které je stejného datového typu, jako zadané pole

< [pole]

Je menší, než hodnota obsažená v zadaném poli.

Název pole, které je stejného datového typu, jako zadané pole

>=[Pole]

Je větší než nebo rovna hodnotě obsažené v určeném poli.

Název pole, které je stejného datového typu, jako zadané pole

< = [pole]

Je menší než nebo rovna hodnotě obsažené v určeném poli.

Název pole, které je stejného datového typu, jako zadané pole

Obsahuje

Obsahuje přesné nebo částečné výskyty textového řetězce v rámci pole vybraného pro filtrování.

String

Neobsahuje

Neobsahuje přesné nebo částečné výskyty textového řetězce v rámci pole vybraného pro filtrování.

String

Obsahuje slova

Obsahuje přesné nebo částečné výskyty textového řetězce nebo slov v rámci pole vybraného pro filtrování.Můžete také zadat částečná slova nebo fráze, které obsahují zástupný znak *.Pro omezení si přečtěte téma 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é nebo částečné výskyty textového řetězce nebo slov v rámci pole vybraného pro filtrování.

Textová pole, která jsou indexována pro fulltextové vyhledávání.

V

Odpovídá libovolné hodnotě v sadě s oddělenými hodnotami.Můžete například najít pracovní položky, jejichž ID jsou 100, 101 a 102, pokud zadáte hodnoty pro pole ID.

Důležitá poznámkaDůležité

Oddělte hodnoty oddělovačem seznamu, který odpovídá místnímu nastavení definovanému pro klientský počítač.Například můžete použít ovládací čárku (,).

Čí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živatelů nebo skupině kategorií v Team Foundation Server.

[!POZNÁMKA]

Operátor Do skupiny lze použít pouze s poli používajícími datový typ String nebo Typ pracovní položky.

Informace o skupinách kategorií naleznete v tématu Seskupení typů pracovních položek pomocí kategorií.

Není ve skupině

Neodpovídá hodnotě, která je členem skupiny v klauzuli.

String odpovídající názvu skupiny uživatelů v Team Foundation Server nebo skupině kategorií definovaných pro týmový projekt.

[!POZNÁMKA]

Operátor Není ve skupině lze použít pouze s poli používajícími datový typ String nebo Typ pracovní položky.

Informace o skupinách kategorií naleznete v tématu Seskupení typů pracovních položek pomocí kategorií.

Byl někdy

Odpovídá hodnotě v klauzuli předchozí kdykoli.

String, DateTime

Pod

Odpovídá hodnotě v klauzuli a je obsaženo v klauzuli v uzlu.

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

Proměnné v této tabulce můžete použít k vyhledání pracovních položek, které se vztahují k aktuálnímu uživateli, aktuálnímu projektu nebo k aktuálnímu datu.

Proměnné dotazu

Použití

@Me

Pomocí této proměnné automaticky vyhledejte alias aktuálního uživatele v poli, které obsahuje aliasy.Můžete například vyhledat pracovní položky, které jste otevřeli, nastavíte-li sloupec Pole na možnost Aktivoval, sloupec Operátor na možnost = a sloupec Hodnota na možnost @Me.

@Project

Tato proměnná slouží k vyhledání pracovních položek v aktuálním projektu týmu.Můžete například vyhledat všechny pracovní položky v aktuálním týmovém projektu, nastavíte-li sloupec Pole na možnost Týmový projekt, sloupec Operátor na možnost = a sloupec Hodnota na možnost @Project.

@Today

Tato proměnná slouží k vyhledání pracovních položek, které se vztahují k aktuálnímu datu nebo k dřívějšímu datu.Můžete také změnit proměnnou @Today odečtením dnů.Můžete například vyhledat všechny položky, které byly aktivovány v posledním týdnu, nastavíte-li sloupec Pole na možnost Datum aktivace, sloupec Operátor na možnost >= a sloupec Hodnota na možnost @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

Fulltextové hledání a hledání částí slov

Zadejte Obsahuje nebo Neobsahuje a hledejte proti přesné nebo částečné shodě slova nebo fráze.Zadejte Obsahuje slova nebo Nebude obsahovat slova a hledejte proti přesné frázi nebo pomocí zástupného znaku *.Tyto operátory používají index fulltextového vyhledávání.Zástupný znak můžete použít pouze na konci částečného slova nebo fráze.

Příklady naleznete v tématu Ukázky dotazů na pracovní položky a Dotazy na pracovní položky využívající pole historie.

[!POZNÁMKA]

Ne všechna nasazení podporují 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 se zobrazí pouze operátory Obsahuje a Neobsahuje.

Obsahuje slova a Neobsahuje slova filtruje položky podle indexu fulltextového vyhledávání, vytvořeného pro dlouhá textová pole.Team Foundation automaticky indexuje všechna dlouhá textová pole s typem dat PlainText a HTML a pole Název pro fulltextové vyhledávání.Index a operátoři jsou k dispozici pouze pokud SQL Server podporující Team Foundation Server podporuje také fulltextové vyhledávání.

Fulltextové vyhledávání vyžaduje řazení SQL, které odpovídá jazyku, který má modul dělení na slova zaregistrován v serveru SQL Server.Pokud nastavení řazení pro databázi týmového projektu kolekce používané pro vaši instanci Team Foundation Server neodpovídá podporovanému jazyku, výsledky hledání nemusí odpovídat vašemu očekávání.V těchto případech použijte operátory Obsahuje nebo Neobsahuje.

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

Indexovaná pole dotazu

Kromě indexu fulltextového vyhledávání je vytvořen index dotazu.Je vytvořen na základě 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 následující pole indexována takto: Přiřazeno, Datum vytvoření, Změnil, Stav, Důvod, ID oblasti, ID iterace a Typ pracovní položky.Pokud existují další pole, která váš tým často používá ve svých dotazech, můžete je přidat je do indexu dotazů.

Pomocí příkazu witadmin indexfield můžete povolit nebo zakázat indexování pro pole.Podívejte se na téma Správa polí pracovních položek [witadmin].

Viz také

Koncepty

Dotaz na pracovní položky