Pole, operátory a makra dotazů v Azure Boards

Popis

Určuje pole, které přebírá hodnotu True/False.

Pole kalendářního data, ve kterém můžete zadat proměnnou, například @Today nebo @Today-1nebo hodnotu, například 01/01/2025. Zadejte data do vzoru data, který jste nastavili pro svůj osobní profil. (Viz Nastavení osobních předvoleb pro podrobnosti.) Příklady dotazů najdete v tématu Query by date or @CurrentIteration.

U dotazů WIQL můžete také zadat datum ve vzoru UTC (Coordinated Universal Time). Další informace najdete v tématu Syntaxe pro dotazovací jazyk pracovní položky (WIQL).

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

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

Vlastní formátované pole sloužící ke sledování historických informací. Tento datový typ slouží pouze k podpoře pole Historie . Toto pole se automaticky indexuje pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Podívejte se na fulltextové a částečné hledání slov popsané dále v tomto článku. Příklady dotazů najdete v tématu Historie a auditování.

Textové řetězce, které podporují formátované popisy, například pole Popis nebo Kroky pro reprodukci. Tato pole se automaticky indexují pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Podívejte se na fulltextové a částečné hledání slov popsané dále v tomto článku. Pokud chcete dotazovat pole s formátem textu, přečtěte si téma Dotazování podle názvů, ID a textových polí s formátováním.

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

32bitové celé číslo, které je podepsané, například 0, 1, 2, 34.

Textové řetězce, které podporují dlouhý popis, například pole Informace o spuštění aplikace. Tato pole se automaticky indexují pro fulltextové vyhledávání, pokud je k dispozici fulltextové vyhledávání. Podívejte se na fulltextové a částečné hledání slov popsané dále v tomto článku. Dotazování na pole ve formátu prostého textu najdete v tématu Dotazování podle názvů, ID a textových polí ve formátu RTF.

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

Vlastní pole definované tak, aby obsahovalo výběrový seznam celočíselné hodnoty.

Vlastní pole definované tak, aby obsahovalo seznam krátkých textových řetězců (255 znaků nebo méně) hodnot.

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

Struktura větvení stromu, například cesta k oblasti nebo cesta iterace. Vyberte položku ze seznamu platných hodnot. Najděte pracovní položky, které se rovnají, nerovnají se, pod strukturou stromu nebo ne. K zadání více hodnot můžete použít In také operátory nebo Not In operátory. Definujte strukturu stromu projektu – cesty oblastí a cesty iterace – a pak vyberte ty, které chcete přidružit k týmu.

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

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, které zahrnuje Double, GUID, Integer a String, DateTime a TreePath

Neodpovídá hodnotě v klauzuli.

Number, String, DateTime a TreePath

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

Number, String a DateTime

Je menší než hodnota v klauzuli.

Number, String a DateTime

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

Number, String a DateTime

Je menší než nebo rovno hodnotě v klauzuli.

Number, String a DateTime

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

Název pole se stejným datovým typem jako zadané pole
Zkontroluje, jestli je logické pole rovno jinému poli.

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

Název pole se stejným datovým typem jako zadané pole
Zkontroluje, jestli se logické pole nerovná jinému poli.

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

Název pole se stejným datovým typem jako zadané pole

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

Název pole se stejným datovým typem jako zadané pole

Je větší nebo roven hodnotě obsažené v zadaném poli.

Název pole se stejným datovým typem jako zadané pole

Je menší než nebo rovno hodnotě obsažené v zadaném poli.

Název pole se stejným datovým typem jako zadané pole

Obsahuje přesnou nebo částečnou shodu textového řetězce v poli, které jste vybrali pro filtrování.

Řetězec

Neobsahuje přesnou nebo částečnou shodu textového řetězce v poli, které jste vybrali pro filtrování.

Řetězec

Obsahuje přesný textový řetězec nebo slova v poli, které jste vybrali 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í najdete v tématu Fulltextové vyhledávání požadavků na server a kolaci.

Dlouhá textová pole indexovaná pro fulltextové vyhledávání, která odpovídají všem polím Prostého textu a HTML a polím Historie a Název .

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

Tento operátor můžete použít v kombinaci s klauzulí s operátorem Contains Words k zahrnutí a vyloučení konkrétních klíčových slov.

Textová pole indexovaná pro fulltextové vyhledávání

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

Number, String, DateTime, TreePath

Zobrazí seznam pracovních položek, které obsahují prázdné pole HTML. U tohoto operátoru nezadáte hodnotu. Tento operátor je podporovaný pro Azure Boards a Azure DevOps Server.

HTML

Zobrazí seznam pracovních položek, které obsahují nějaký obsah v poli HTML. U tohoto operátoru nezadáte hodnotu. Tento operátor je podporovaný pro Azure Boards a Azure DevOps Server.

HTML

Neodpovídá žádné hodnotě v sadě s oddělovači. Pokud zadáte tyto hodnoty pro pole Stát, můžete z výsledků dotazu vyloučit pracovní položky, jejichž stavy nejsou Vyřešeno, Dokončeno nebo Uzavřeno. Hodnoty oddělte oddělovačem seznamu, který odpovídá místnímu nastavení definovanému pro váš klientský počítač. Můžete například použít čárku ,.

Operátor Not In je podporovaný pro Azure Boards a Azure DevOps Server.

Number, String, DateTime, TreePath

Odpovídá hodnotě, která je členem skupiny v klauzuli. Skupiny odpovídají názvu týmu, skupiny zabezpečení nebo kategorii 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 se vytvoří při vytváření týmu. Název skupin týmů se řídí vzorem [Název týmového projektu]\Název týmu.

Například dotazy najdete v tématu Dotaz podle přiřazení nebo změn pracovního postupu.

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

Informace naleznete v tématu Použití kategorií k seskupení typů pracovních položek.

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

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

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

TreePath

Odpovídá hodnotě v klauzuli nebo je obsažena v uzlu v klauzuli.

TreePath

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

String , DateTime

Popis

Pomocí polí Typ pracovní položky nebo Stav můžete vyhledávat ve všech typech pracovních položek nebo ve všech stavech. Work Item Type=[Any] Například neumisťuje žádné filtry založené na typu pracovní položky.

Pomocí pole Cesta iterace můžete automaticky filtrovat pracovní položky přiřazené aktuálnímu sprintu na základě aktuálního týmového fokusu nebo kontextu. Konkrétní příklady najdete v tématu Dotaz podle data nebo aktuální iterace.
Makro @CurrentIteration funguje pouze při spuštění z webového portálu. Makro nemůžete použít při kopírování nebo klonování testovacích sad a testovacích případů, definování výstrah nebo pomocí rozhraní REST API.

Pomocí pole Cesta iterace můžete filtrovat sadu pracovních položek přiřazených k aktuálnímu sprintu +/- n sprintů na základě aktuálního týmového fokusu nebo kontextu. Konkrétní příklady najdete v tématu Dotaz podle data nebo aktuální iterace.
Makro @CurrentIteration +/- n se podporuje pro Azure Boards, Azure DevOps Server při spuštění z webového portálu.

Pomocí pole ID a operátoru In můžete zobrazit seznam všech pracovních položek, které v projektu sledujete. Další informace najdete v tématu Sledování pracovní položky nebo žádosti o přijetí změn. Stejný seznam můžete zobrazit na stránce Pracovní položky v kontingenčním zobrazení.
Makro @Follows se podporuje pouze při spuštění z webového portálu.

Pomocí pole s identitou nebo uživatelským účtem můžete automaticky hledat položky přidružené k vašemu uživatelskému jménu nebo názvu účtu. Můžete například najít pracovní položky, které jste otevřeli pomocí klauzule Created By=@Me. Další příklady najdete v tématu Dotaz podle přiřazení, pracovního postupu nebo změn panelu.

Pomocí pole ID a operátora In můžete vypsat pracovní položky, které jste v projektu zobrazili nebo aktualizovali během posledních 30 dnů. Stejný seznam můžete zobrazit na stránce Pracovní položky v kontingenčním zobrazení Moje aktivita.

Pomocí pole Týmový projekt můžete filtrovat pracovní položky v jiných projektech. Můžete například najít všechny pracovní položky v aktuálně vybraném projektu pomocí klauzule Team Project=@Project. Systém automaticky filtruje na základě aktuálního projektu. Další informace najdete v tématu Definování dotazu, dotazování napříč projekty.

Pomocí pole ID a operátoru In můžete vypsat pracovní položky, které jsou uvedené v části Diskuze. Stejný seznam si můžete prohlédnout ze stránky Pracovní položky se zmíněným kontingenčním zobrazením.

Slouží s polem ID a operátorem In k výpisu nedávno aktualizovaných pracovních položek. Počet uvedených pracovních položek závisí na aktivitě sledování práce projektu. U vysoce aktivních projektů jsou v makrech uvedené pracovní položky aktualizované v projektu během posledních 30 dnů nebo tak. U méně aktivních projektů ale tento seznam může obsahovat pracovní položky starší než 30 dnů. Podobné seznamy můžete zobrazit na stránce Pracovní položky, nedávno vytvořené, naposledy aktualizované a nedávno dokončené kontingenční zobrazení. Počet vrácených pracovních položek je omezen na 5 000.

DateTime Slouží k filtrování pracovních položek, které souvisejí s aktuálním datem nebo posunem plus/minus. Pomocí klauzule Closed Date>=@StartOfDay-7můžete například najít všechny položky uzavřené v posledním týdnu . Další příklady najdete v tématu Dotaz podle data nebo aktuální iterace.

DateTime Pomocí pole můžete filtrovat pracovní položky, které se vztahují k aktuálnímu měsíci nebo se posunem plus/minus. Pomocí klauzule Created Date>=@StartOfMonth-3můžete například najít všechny položky vytvořené v posledních třech měsících. Další příklady najdete v tématu Dotaz podle data nebo aktuální iterace.

DateTime Pomocí pole můžete filtrovat pracovní položky, které se vztahují k aktuálnímu týdnu nebo s posunem plus/minus. Pomocí klauzule Changed Date>=@StartOfWeek-2můžete například najít všechny změněné položky za poslední dva týdny . Další příklady najdete v tématu Dotaz podle data nebo aktuální iterace.

DateTime Pomocí pole můžete filtrovat pracovní položky, které souvisejí s aktuálním rokem nebo se posunem plus/minus. Pomocí klauzule Target Date>=@StartOfYearmůžete například najít všechny funkce, které mají naplánované cílové datum v aktuálním roce. Další příklady najdete v tématu Dotaz podle data nebo aktuální iterace.

Pomocí pole Cesta oblasti můžete filtrovat jenom pracovní položky, jejichž cesta k oblasti odpovídá jedné přiřazené určitému týmu. Vyžaduje použití operátoru = . Můžete například najít všechny položky přiřazené k cestám k oblasti přiřazené webovému týmu pomocí klauzule Area Path=@TeamAreas [Fabrikam Fiber]\Web. Další příklady najdete v tématu Dotaz podle oblasti nebo cesty iterace.
Makro @TeamAreas se podporuje pro Azure DevOps Server pouze při spuštění z webového portálu.

DateTime Slouží k filtrování pracovních položek, které souvisejí s aktuálním datem nebo dřívějším datem. Makro @Today můžete také upravit odečtením dnů. Pomocí klauzule Created Date>=@Today-7můžete například najít všechny položky vytvořené v posledním týdnu . Další příklady najdete v tématu Dotaz podle data nebo aktuální iterace.