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

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Tady najdete podrobné popisy jednotlivých datových typů polí, operátorů dotazů a maker dotazů. Některé datové typy, operátory a makra jsou platné pouze pro uvedenou verzi Azure DevOps.

Stručný přehled úloh dotazů a operátorů a maker podporovaných pro každý datový typ najdete v tématu Rychlé referenční informace k dotazům. Viz také Vytvoření dotazu nebo osvědčených postupů.

Dotazování datových typů a hodnot polí

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 cloudové služby Azure Boards odpovídá datový typ, který je uvedený pro pole na stránce Pole procesu>. U místních nasazení datový typ odpovídá atributu type přiřazeného FIELD k definici. Další informace naleznete v tématu Pole pracovní položky a atributy pole.

Datový typ

Popis

Logická hodnota

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

DateTime nebo Date/Time

Pole kalendářního data, ve kterém můžete zadat proměnnou, například @Today nebo @Today-1nebo hodnotu, například 1.1.2023. 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).

Dvojité nebo desetinné číslo

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

GUID

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

Historie

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í.

HTML

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.

Identita

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

Celé číslo

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

Pole PlainText nebo Text (víceřádkové)

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.

picklistDouble¹

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

picklistInteger¹

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

picklistString¹

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

Řetězcové nebo textové pole (jeden řádek)

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.

TreePath

Struktura větvení stromu, například cesta k oblasti nebo cesta iterace. Vyberte položku ze seznamu platných hodnot. Vyhledejte pracovní položky, které se rovnají, nerovnají, pod strukturou stromu nebo používají operátory In nebo Not In k určení několika hodnot. Definujete strukturu stromu projektu – cesty oblastí a cesty iterace – a pak vyberete 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.

Poznámka:

1. Datový seznam... Datové typy jsou přiřazeny pouze k vlastním polím definovaným pro zděděný proces. Model zděděného procesu je podporován pouze pro Azure DevOps Services a Azure DevOps Server 2019.

Vzor data a času

Vzor data a času, který zadáte pro pole DateTime , by se měl shodovat s tím, který vyberete v profilu. Pokud chcete zobrazit nebo změnit výběr, přečtěte si téma Nastavení uživatelských předvoleb pro čas a národní prostředí.

Operátory dotazů

Pomocí operátorů dotazu v následující tabulce můžete určit, jak každá hodnota v klauzuli musí souviset s odpovídající hodnotou v pracovní položce. Informace o datovém typu, který je přiřazen k polím pracovní položky, naleznete v tématu Odkaz na pole Pracovní položka.

Další informace o přidávání klauzulí a použití operátorů And/Or najdete v tématu Definování dotazu.

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, 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

=[Pole]

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

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

<>[Pole]

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

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

>[Pole]

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

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

<[Pole]

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

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

>=[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

<=[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

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

Řetězec

Neobsahuje

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

Řetězec

Obsahuje slova.

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 slova

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 použijte 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í

In

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

Je prázdné.

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 (cloudovou službu), Azure DevOps Server 2019 a novější verze.

HTML

Není prázdné.

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 (cloudovou službu), Azure DevOps Server 2019 a novější verze.

HTML

Není v

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 k dispozici v Azure Boards a TFS 2018.2 a novějších verzích.

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

Poznámka:

Operátor In Group můžete použít pouze s poli, která používají datový typ Řetězec nebo pole Typ pracovní položky. Skupiny definované v MICROSOFT Entra ID můžete použít také v případě, že váš účet Azure Boards je zajištěný Microsoft Entra ID nebo Active Directory, když je vaše místní instance serveru podporována službou Active Directory.

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 Serveru nebo skupině kategorií definované pro projekt.

Poznámka:

Operátor Není ve skupině můžete použít pouze s poli, která používají datový typ Řetězec nebo pole Typ pracovní položky. Skupiny definované v MICROSOFT Entra ID můžete použít také v případě, že váš účet Azure Boards je zajištěný Microsoft Entra ID nebo Active Directory, když je vaše místní instance serveru podporována službou Active Directory.

Není v části

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

TreePath

Pod

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

TreePath

Byl někdy

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

String , DateTime

Poznámka:

Při použití Editor Power Query se v současné době nepodporuje pole kalendářních dat. Podporují se pouze při přímé wiQL.

Tip

Dotaz je možné zrušit pomocí syntaxe WIQL, která používá operátor, například Was Ever, pro jiná pole datového typu, než jsou uvedená. Pomocí cesty iterace můžete například použít klauzuli Was Ever v rámci klauzule. Příklad najdete v tématu Dotaz podle data nebo aktuální iterace, vypsat pracovní položky přesunuté mimo sprint.

Dotazování maker nebo proměnných

Makra popsaná v následující tabulce můžete použít k filtrování dotazů na základě konkrétních polí.

Poznámka:

Na webovém portálu jsou podporována pouze následující makra: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity a @TeamAreas. Dotazy, které obsahují tato makra, nebudou při otevření v sadě Visual Studio nebo Team Exploreru, Microsoft Excelu nebo Microsoft Projectu fungovat.

---

Makro

Popis

---

[Libovolná]

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 na základě typu pracovní položky.

---

@CurrentIteration

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.

---

@CurrentIteration +/- n

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 2019 a novější verze a pouze při spuštění z webového portálu.

---

@Follows

Pomocí pole ID a operátoru In můžete zobrazit seznam všech pracovních položek, které v projektu sledujete. Další informace o funkci Sledovat 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.

---

@Me

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 Dotazování podle změn přiřazení, pracovního postupu nebo panelu Kanban.

---

^{@MyRecentActivity 1}

Pomocí pole ID a operátoru In můžete zobrazit nebo aktualizovat 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.

---

@Project

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.

---

^{@RecentMentions 1}

Pomocí pole ID a operátoru In můžete vypsat pracovní položky, které jste zmínili 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.

---

^{@RecentProjectActivity 1}

Slouží s polem ID a operátorem In k zobrazení seznamu pracovních položek, které byly nedávno aktualizovány. 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, které byly v projektu aktualizovány 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.

---

^{@StartOfDay 2}

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.

---

^{@StartOfMonth 2}

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.

---

^{@StartOfWeek 2}

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.

---

^{@StartOfYear 2}

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.

---

@TeamAreas

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 2019 a novější verze a pouze při spuštění z webového portálu.

---

@Today

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.

---

Poznámka:

1. Makra @MyRecentActivity, @RecentMentions a @RecentProjectActivity jsou podporována pro TFS 2018.2 a novější verze.
2. Makra @StartOfDay, @StartOfWeek, @StartOfMonth a @StartOfYear jsou podporovaná pro Azure DevOps Server 2019 Update 1 a novější verze.

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

Zadejte hodnotu Obsahuje nebo Neobsahuje , pokud chcete hledat přesnou nebo částečnou shodu slova nebo fráze. Tyto operátory filtrují položky na základě indexu fulltextového vyhledávání vytvořeného pro dlouhá textová pole. Zadat obsahuje slova nebo neobsahuje slova , která mají hledat přesnou frázi nebo použít zástupný znak, *. Tyto operátory používají fulltextový index vyhledávání. Zástupný znak můžete použít jenom na konci částečného slova nebo fráze.

Příklady najdete v příkladech 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 Obsahuje a Neobsahuje .

Související články

• Stručná referenční příručka k dotazům
• Informace o spravovaných dotazech
• Index pole pracovních položek
• Syntaxe pro dotazovací jazyk pracovní položky (WIQL)

REST API

Pokud chcete s dotazy pracovat prostřednictvím kódu programu, podívejte se na jeden z těchto prostředků rozhraní REST API:

• Referenční informace k rozhraní REST API služby Azure DevOps Services
• Dotazy
• Dotazovací jazyk pracovních položek
• Načítání pracovních položek pomocí dotazů prostřednictvím kódu programu