Pole dotazů, operátory a makra

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

Tady najdete detailní popisy každého pole datový typ, operátory dotazů a dotaz na makra. Některé typy dat, operátory a makra jsou platné pouze pro označené Azure DevOps Server nebo verze Team Foundation Server (TFS).

Rychlé informace o úkolech dotazů a operátorech a makrech podporovaných u jednotlivých typů dat najdete v tématu rychlý přehled dotazů. Přečtěte si také pokyny k vytváření vysoce výkonných dotazů pro tipy k vytváření vysoce výkonných dotazů.

Datové typy a hodnoty polí dotazu

Hodnota, kterou zadáte pro pole, musí odpovídat datovému typu daného pole. Následující tabulka uvádí podporované datové typy:

Poznámka

U Azure Boards cloudové služby odpovídá datový typ, který je uvedený pro pole na stránce zpracovat>pole. Pro místní nasazení odpovídá datový typ type atributu přiřazenému k FIELD definici. Další informace naleznete v tématu pole pracovních položek a atributy polí.

Datový typ

Popis

Logická hodnota1

Určuje pole, které přebírá hodnotu true nebo false.

Datum a čas nebo
Datum a čas

Pole data, ve kterém můžete zadat proměnnou, jako je například @Today nebo @Today-1 , nebo hodnotu, například 1/1/2012. Zadejte data ve vzoru kalendářních dat, který jste nastavili pro váš osobní profil. (Podrobnosti najdete v tématu Nastavení osobních předvoleb .) Příklady dotazů najdete v tématu dotaz podle data or@CurrentIteration .

U dotazů WIQL můžete také zadat datum ve vzoru koordinovaného světového času (UTC). Podrobnosti najdete v tématu syntaxe pro WIQL (Work Item Query Language) (WIQL).

Double nebo Decimal

Reálné číslo, například 0,2 nebo 3,5. Příklady dotazů naleznete v tématu dotazování podle číselných polí.

HLAVNÍCH

Řetězec znaků, který představuje jedinečné ID.

Historie

Vlastní formátování pole, které slouží ke sledování historických informací. Tento datový typ slouží pouze k podpoře pole Historie . Toto pole je automaticky indexováno pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Viz fulltextová a částečná hledání v slovnících, která jsou popsána dále v tomto článku. Příklady dotazů najdete v tématu historie a auditování.

KÓDU

Textové řetězce, které podporují formátované popisy, například pole Popis nebo kroky pro reprodukci . Tato pole jsou automaticky indexována pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Viz fulltextová a částečná hledání v slovnících, která jsou popsána dále v tomto článku. Chcete-li zadat dotaz na pole s bohatým textem, přečtěte si téma dotazování podle názvů, ID a polí s bohatoutextem.

Odcizen

Krátký textový řetězec, který identifikuje identitu uživatele.

Čísla

32 celé číslo, které je podepsáno, například 0, 1, 2, 34.

Prostý text nebo
Textové pole (víceřádkové)

Textové řetězce, které podporují dlouhé popisy, jako je pole informace o spuštění aplikace . Tato pole jsou automaticky indexována pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Viz fulltextová a částečná hledání v slovnících, která jsou popsána dále v tomto článku. Chcete-li zadat dotaz na pole s prostým textem, přečtěte si téma dotazování podle titulů, ID a polí s formátováním.

picklistDouble2

Vlastní pole definované tak, aby obsahovalo seznam výběru desetinných hodnot.

picklistInteger2

Vlastní pole je definované tak, aby obsahovalo seznam výběru celočíselných hodnot.

picklistString2

Vlastní pole je definované tak, aby obsahovalo rozevírací seznam pro hodnoty krátkého textového řetězce (255 znaků nebo míň).

Řetězec nebo
Textové pole (jednořádkový řádek)

Krátký textový řetězec, který může obsahovat až 255 znaků Unicode. Řetězcová textová pole se často používají pro podporu rozevíracích seznamů nebo rozevíracích nabídek.

TreePath

Větvení stromové struktury, jako je například cesta oblasti nebo cesta k iteraci. Můžete vybrat položku ze seznamu platných hodnot. Můžete najít pracovní položky, které se rovnají, nejsou rovny, pod nebo nejsou ve stromové struktuře, nebo pomocí operátorů in nebo Not in zadat několik hodnot. Definujete stromovou strukturu pro — cesty oblasti projektu a cesty iterace — a potom vyberete ty, které chcete přidružit k týmu.

Další informace o vytváření dotazů naleznete v tématu dotaz podle oblasti nebo cesty iterace nebo dotaz podle data nebo aktuální iterace.

Poznámky:

  1. Pole datový typ Boolean je podporováno pro TFS 2017 a novější verze.
  2. Datové typy picklist... jsou přiřazeny pouze vlastním polím definovaným pro zděděný proces. Zděděný model procesu je podporován pouze pro Azure DevOps Services a Azure DevOps Server 2019.

Operátory dotazů

Operátory dotazů v následující tabulce můžete použít k určení, jak se musí každá hodnota v klauzuli vztahovat k odpovídající hodnotě v pracovní položce. Informace o datovém typu, který je přiřazen polím pracovní položky, naleznete v tématu Reference k poli pracovní položky.

Operátor dotazu Vrátí pracovní položky, pokud hodnota v pracovní položce odpovídá uvedeným kritériím. Použitelné datové typy

=

Odpovídá hodnotě v klauzuli.

Číslo — To zahrnuje Double, GUID, Integer — a String, DateTimea TreePath

<>

Neodpovídá hodnotě v klauzuli.

Number, String, DateTimea TreePath

>

Je větší než hodnota v klauzuli.

Číslo, řetězeca Datum a čas

<

Je menší než hodnota v klauzuli.

Číslo, řetězeca Datum a čas

>=

Je větší nebo rovno hodnotě v klauzuli.

Číslo, řetězeca Datum a čas

<=

Je menší nebo rovno hodnotě v klauzuli.

Číslo, řetězeca Datum a čas

= [Pole]

Odpovídá hodnotě, která je obsažena v určeném poli.

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

<>Dílčí

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

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

>Dílčí

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

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

<Dílčí

Je menší než hodnota, která je obsažena v určeném poli.

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

>= [Pole]

Je větší nebo rovno hodnotě, která je obsažena v určeném poli.

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

<= [Pole]

Je menší nebo rovno hodnotě, která je obsažena v určeném poli.

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

Zobrazí

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

Řetezce

Neobsahuje

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

Řetezce

Obsahuje slova

Obsahuje přesný textový řetězec nebo slova v rámci pole vybraného pro filtrování. Můžete také zadat částečná slova nebo fráze, které obsahují zástupný znak * . Textový řetězec je omezený na 100 znaků. Omezení naleznete v tématu fulltextové vyhledávání požadavků na server a kolaci.

Pole s dlouhým textem, která jsou indexována pro fulltextové vyhledávání, které odpovídají všem polím v prostém textu a HTML a v polích Historie a název .

Neobsahuje slova

Neobsahuje přesný textový řetězec nebo slova v rámci pole, které jste vybrali pro filtrování. Textový řetězec je omezený na 100 znaků.

Tento operátor použijte v kombinaci s klauzulí s operátorem obsahuje slova pro zahrnutí a vyloučení určitých klíčových slov.

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

V

Odpovídá jakékoli hodnotě v sadě s oddělovači. Například můžete najít pracovní položky, jejichž ID jsou 100, 101 a 102, pokud zadáte tyto hodnoty pro pole ID. Oddělte hodnoty oddělovačem seznamu, který odpovídá místnímu nastavení definovanému pro klientský počítač. Můžete například použít čárku (,).

Number, String, DateTime, TreePath

Je prázdné

Zobrazí seznam pracovních položek, které obsahují prázdné pole HTML. Ne'i byste zadat hodnotu s tímto operátorem. Tento operátor se podporuje pro Azure Boards (cloudové služby), Azure DevOps Server 2019 a novějších verzích.

KÓDU

Není prázdné

Zobrazuje seznam pracovních položek, které obsahují obsah v poli HTML. Ne'i byste zadat hodnotu s tímto operátorem. Tento operátor se podporuje pro Azure Boards (cloudové služby), Azure DevOps Server 2019 a novějších verzích.

KÓDU

Není v

Neodpovídá žádné hodnotě v sadě s oddělovači. Můžete například vyloučit pracovní položky, jejichž stavy nejsou vyřešeny, dokončeny nebo uzavřeny z výsledků dotazu, pokud zadáte hodnoty pro pole State (stav). Oddělte hodnoty oddělovačem seznamu, který odpovídá místnímu nastavení definovanému pro klientský počítač. Můžete například použít čárku (,).

Operátor Not in je k dispozici z Azure boards a TFS 2018,2 a novějších verzí.

Number, String, DateTime, TreePath

Ve skupině

Odpovídá hodnotě, která je členem skupiny v klauzuli. Skupiny odpovídají názvu týmu, skupiny zabezpečení nebo kategorie sledování práce. Můžete například vytvořit dotaz pro vyhledání všech pracovních položek, které jsou přiřazeny členům skupiny Přispěvatelé nebo týmu. Týmové skupiny jsou vytvořeny při vytvoření týmu. Název týmových skupin následuje vzor [název týmu projektu] \název týmu.

Příklady dotazů naleznete v tématu dotaz podle přiřazení nebo změny pracovního postupu.

Řetězec , který odpovídá názvu týmu, skupiny zabezpečení nebo kategorie definované v systému.

Poznámka: Operátor in Group lze použít pouze s poli, která používají datový typ řetězec nebo typ pracovní položky . Pokud je vaše místní instance serveru založená na službě Active Directory, můžete také použít skupiny definované v Azure Active Directory (AAD), když je účet Azure Boards zálohovaný pomocí AAD nebo Active Directory (AD).

Informace o skupinách kategorií naleznete v tématu použití kategorií k seskupení typů pracovních položek.

Není ve skupině

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

Řetězec , který odpovídá názvu skupiny uživatelů v Team Foundation Server nebo skupině kategorií definované pro projekt.

Poznámka: Operátor Not in Group lze použít pouze s poli, která používají datový typ řetězec nebo typ pracovní položky . Skupiny definované v AAD můžete použít také v případě, že je účet Azure Boards zálohovaný pomocí AAD nebo AD, když je vaše místní instance serveru zálohovaná službou AD.

Není pod

Neodpovídá hodnotě v klauzuli a není obsaženo v uzlu v klauzuli.

TreePath

Pod

Odpovídá hodnotě v klauzuli nebo je obsaženo v rámci uzlu v klauzuli.

TreePath

Byl někdy

Odpovídá hodnotě v klauzuli v jakémkoli předchozím bodě.

Řetězec , Datum a čas

Dotazování na makra nebo proměnné

Pomocí maker popsaných v následující tabulce můžete filtrovat dotazy na základě konkrétních polí.

Poznámka

Následující makra jsou podporována pouze z webového portálu: @CurrentIteration , @Follows , @MyRecentActivity , @RecentMentions , @RecentProjectActivity , @TeamAreas . Dotazy, které obsahují tato makra, nebudou fungovat, pokud jsou otevřeny v aplikaci Visual Studio/Team Explorer, Microsoft Excel nebo Microsoft Project.

Podokně

Description

Jakýmikoli Použijte ve spojení s polem typ pracovní položky pro hledání napříč všemi typy pracovních položek. Například Work Item Type=[Any] vyhráli', aby se na základě typu pracovní položky umístily jakékoli filtry.
@CurrentIteration1 Použijte ve spojení s polem Cesta iterace k automatickému filtrování pracovních položek přiřazených k aktuálnímu sprintu na základě aktuálního nebo kontextu týmu. Konkrétní příklady najdete v tématu dotazování podle data nebo aktuální iterace.

Toto makro funguje pouze při spuštění z webového portálu. Makro můžete'použít při kopírování nebo klonování testovacích sad a testovacích případů, Definování výstrahnebo pomocí rozhraní REST API.

@CurrentIteration +/- n 2 Použijte ve spojení s polem Cesta iterace k filtrování sady pracovních položek přiřazených k aktuálnímu sprintu +/-n sprinty na základě aktuálního nebo kontextu týmu. Konkrétní příklady najdete v tématu dotazování podle data nebo aktuální iterace.
@Follows3 . Použijte ve spojení s polem ID a v operátoru k vypsání všech pracovních položek, které v projektu provedete. Další informace o funkci sledování najdete v tématu sledování pracovní položky nebo žádosti opřijetí změn. Stejný seznam můžete zobrazit na stránce pracovní položky v zobrazení kontingenčního zobrazení.
@Me Použijte ve spojení s polem identity nebo uživatelský účet k automatickému vyhledání položek přidružených k vašemu uživatelskému jménu nebo názvu účtu. Například můžete najít pracovní položky, které jste otevřeli pomocí klauzule Created By=@Me . Další příklady najdete v tématu změny v dotazech podle přiřazení, pracovního postupu nebo kanbanové desky.
@MyRecentActivity4 . Použijte ve spojení s polem ID a v operátoru pro seznam pracovních položek, které jste v projektu prohlíželi nebo aktualizovali během posledních 30 dnů. Stejný seznam můžete zobrazit na stránce pracovní položky a v zobrazení kontingenčních aktivit .
@Project5 . Použijte ve spojení s polem týmový projekt k filtrování pracovních položek v jiných projektech. Můžete například najít všechny pracovní položky v jiném projektu s klauzulí Team Project=@Project . Další informace najdete v tématu definice dotazu, dotazování napříč projekty.
@RecentMentions4 . Použijte ve spojení s polem ID a v operátoru k vypsání pracovních položek, na které jste uvedli v části diskuze. Stejný seznam můžete zobrazit na stránce pracovní položky, v uvedeném zobrazení kontingenčníhoseznamu.
@RecentProjectActivity6 Použijte ve spojení s polem ID a v operátoru k vypsání pracovních položek, které byly aktualizovány v projektu během posledních 30 dnů. Podobné seznamy můžete zobrazit na stránce pracovní položky, nedávno vytvořené, nedávno aktualizované a nedávno dokončená zobrazení kontingenčníchseznamů.
@StartOfDay7 Použijte s DateTime polem k filtrování pracovních položek, které se vztahují k aktuálnímu datu nebo posunu plus/minus. Můžete například najít všechny položky uzavřené za poslední týden pomocí klauzule Closed Date>=@StartOfDay-7 . Další příklady najdete v tématu dotazování podle data nebo aktuální iterace.
@StartOfMonth7 Použijte s DateTime polem k filtrování pracovních položek, které se vztahují k aktuálnímu měsíci nebo posunu plus/minus. Můžete například najít všechny položky vytvořené za posledních 3 měsíce pomocí klauzule Created Date>=@StartOfMonth-3 . Další příklady najdete v tématu dotazování podle data nebo aktuální iterace.
@StartOfWeek7 Použijte s DateTime polem k filtrování pracovních položek, které se vztahují k aktuálnímu týdnu nebo posunu plus/minus. Můžete například najít všechny položky změněné za poslední dva týdny pomocí klauzule Changed Date>=@StartOfWeek-2 . Další příklady najdete v tématu dotazování podle data nebo aktuální iterace.
@StartOfYear7 Pomocí DateTime pole můžete filtrovat pracovní položky, které se vztahují k aktuálnímu roku, nebo s posunem plus/minus. Můžete například najít všechny funkce, které mají plánované datum naplánované v rámci aktuálního roku s klauzulí Target Date>=@StartOfYear . Další příklady najdete v tématu dotazování podle data nebo aktuální iterace.
@TeamAreas8 Použijte pouze s polem cesta oblasti pro filtrování pracovních položek, jejichž cesta oblasti odpovídá jednomu přiřazenému k určitému týmu. Vyžaduje použití = operátoru. Můžete například vyhledat všechny položky, které jsou přiřazeny k cestám oblastí přiřazeným k webovému týmu pomocí klauzule Area Path=@TeamAreas [Fabrikam Fiber]\Web . Další příklady najdete v tématu dotazování podle oblasti nebo cesty iterace.
@Today Použijte s DateTime polem k filtrování pracovních položek, které se vztahují k aktuálnímu datu nebo k dřívějšímu datu. Můžete také upravit @Today makro odčítáním dnů. Můžete například vyhledat všechny položky, které byly vytvořeny za poslední týden pomocí klauzule Created Date>=@Today-7 . Další příklady najdete v tématu dotazování podle data nebo aktuální iterace.

Poznámky:

  1. @CurrentIterationMakro je podporováno pro Azure boards a TFS 2015 a novější verze.
  2. Makro @CurrentIteration +/-n je podporováno pro Azure Boards, Azure DevOps Server 2019 a novějších verzí a pouze při spuštění z webového portálu.
  3. @FollowsMakro je podporováno pro Azure boards a TFS 2017 a novější verze.
  4. @MyRecentActivity @RecentMentions @RecentProjectActivity Makra jsou podporována pro Azure boards a TFS 2018,2 a novější verze.
  5. @ProjectMakro je podporováno pro Azure boards a TFS 2015,1 a novější verze. Systém automaticky vyhodnotí filtrování na základě aktuálního projektu. Další informace najdete v tématu dotazování napříč projekty.
  6. @RecentProjectActivity Makro je podporované jenom pro Azure boards (cloudové služby).
  7. @StartOfDayMakra, @StartOfWeek , @StartOfMonth a @StartOfYear jsou podporována v Azure DevOps Server 2019 Update 1 a novějších verzích.
  8. @TeamAreasMakro je podporováno pro Azure boards a Azure DevOps Server 2019 a novějších verzí.

Poznámka

Následující makra jsou podporována pouze z webového portálu: @tokenem CurrentIteration, @následuje, @MyRecentActivity, @RecentMentions, @RecentProjectActivity, @TeamAreas. Dotazy, které obsahují tato makra, nebudou fungovat, pokud jsou otevřeny v aplikaci Visual Studio/Team Explorer, Microsoft Excel nebo Microsoft Project.

Fulltextová a částečná hledání v slovnících

Zadání obsahuje nebo neobsahuje pro vyhledávání přesná nebo částečné shody slova nebo fráze. Tyto operátory filtrují položky na základě indexu fulltextového vyhledávání vytvořeného pro pole s dlouhým textem. Zadejte text obsahuje slova nebo neobsahuje slova pro vyhledávání přes přesnou frázi nebo pro použití zástupného znaku, *. Tyto operátory používají index fulltextového vyhledávání. Zástupný znak lze použít pouze na konci částečného slova nebo fráze.

Příklady naleznete v tématu Příklady dotazů na pracovní položky a dotazování na pracovní položky pomocí pole historie.

Poznámka

Ne všechna nasazení podporují fulltextové vyhledávání. Například SQL Express a SQL Azure, které podporují cloudovou službu, nepodporují fulltextové vyhledávání. V těchto případech se zobrazí pouze operátory Contains a neobsahuje.

Azure DevOps Server a Team Foundation Server automaticky indexovat všechna dlouhá textová pole s datovým typem prostých textů a HTML a polem title pro fulltextové vyhledávání. Index a operátory jsou k dispozici, pouze pokud SQL Server podporující Team Foundation Server podporuje fulltextové vyhledávání.

Fulltextové vyhledávání vyžaduje kolaci SQL, která odpovídá jazyku, ve kterém je tento modul dělení slov zaregistrován u SQL Server. Pokud nastavení kolace pro databázi kolekce projektů použité pro instanci Team Foundation Server neodpovídá podporovanému jazyku, výsledky hledání nemusí odpovídat vašim očekáváním. V těchto případech se můžete pokusit použít operátor Contains nebo Not obsahující operátory.

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

Prostředky sady SDK

Chcete-li s dotazy programově pracovat, přečtěte si téma dotaz na chyby, úlohy a další pracovní položky.