Pole dotazů, operátory a makra

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Tento článek popisuje datové typy polí, operátory dotazů a makra dotazů, která používáte v Editoru dotazů. Některé typy, operátory a makra se vztahují pouze na konkrétní verze Azure DevOps.

Rychlé příklady a úlohy editoru najdete v tématu Rychlá reference k dotazům a Správa a uspořádání dotazů.

Požadavky

Kategorie	Požadavky
úrovně přístupu	- Zobrazení a spuštění sdílených dotazů: člen projektu. – Pro přidání a uložení sdíleného dotazu: Je vyžadován alespoň základní přístup.
oprávnění	Sada oprávnění Přispívat je nastavena na Povolit pro složku, do které chcete přidat dotaz. Ve výchozím nastavení nemá skupina přispěvatelů toto oprávnění.

Poznámka:

Uživatelé s účastníkem přístup k veřejnému projektu mají úplný přístup k funkcím dotazů stejně jako uživatelé s přístupem Basic. Další informace najdete v tématu Rychlá referenční příručka přístupu účastníků.

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

Je nutné zadat hodnotu, která odpovídá datovému typu pole. Následující tabulka uvádí podporované datové typy:

Poznámka:

Pro Azure Boards (cloud) odpovídá datový typ poli zobrazenému na stránce Procesní pole>. U místních nasazení datový typ odpovídá atributu typeFIELD v definici. Podrobnosti naleznete v části Pole pracovní položky a atributy polí.

Datový typ

Popis

Logická hodnota

Uloží hodnotu True/False.

DateTime nebo Date/Time

Použijte proměnnou data (například @Today nebo @Today-1) nebo explicitní datum, například 01/01/2025. Zadejte data ve vzoru nastaveném ve vašem profilu. Příklady dotazů najdete v Query by date or @CurrentIteration.
U dotazů WIQL můžete také zadat data ve standardu UTC. Podívejte se na syntaxi dotazovacího jazyka pro pracovní položky (WIQL).

Dvojité nebo desetinné číslo

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

GUID

Uloží jedinečný identifikační řetězec.

Historie

Vlastní formátované pole použité pro historické informace (pole Historie ) Pokud je k dispozici fulltextové vyhledávání, bude toto pole indexováno pro fulltextové dotazy. Viz Historie a auditování.

HTML

Ukládá formátovaný text (například Popis nebo Kroky pro reprodukci). Pokud je k dispozici fulltextové vyhledávání, budou tato pole indexována. 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

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

Celé číslo

Uloží 32bitové celé číslo (například 0, 1, 2, 34).

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

Ukládá dlouhé textové hodnoty (například informace o spuštění aplikace). Tato pole jsou indexována pro fulltextové vyhledávání, pokud je to podporováno. Podívejte se na dotazy podle názvů, ID a polí s formátovaným textem.

picklistDouble

Vlastní pole, které obsahuje výběrový seznam desetinných hodnot.

picklistInteger

Vlastní pole, které obsahuje výběrový seznam celočíselné hodnoty.

picklistString

Vlastní pole, které obsahuje seznam krátkých textových hodnot (255 znaků nebo méně).

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

Ukládá krátký text až 255 znaků Unicode. Týmy tato pole často používají pro rozevírací seznamy nebo nabídky.

TreePath

Představuje větvení stromu (například cesta k oblasti nebo cesta iterace). Zvolte platnou hodnotu uzlu. Můžete filtrovat podle rovnosti, nerovnosti, Pod / Není pod, nebo pomocí In / Not In operátorů zadat více hodnot. Definujte stromové struktury pro projekt – cesty oblastí a cesty iterace – a vyberte uzly, které chcete přidružit k týmům. Příklady dotazů najdete v tématu Dotaz podle oblasti nebo cesty iterace a Dotaz podle data nebo aktuální iterace.

Poznámka:

Typy picklist... se vztahují pouze na vlastní pole definovaná pro zděděný proces.

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.

Operátory dotazů

Pomocí operátorů můžete definovat, jak hodnota klauzule musí souviset s hodnotou pole pracovní položky. Informace o datových typech polí najdete v odkazu na pole pracovních položek. Nápovědu k vytváření dotazů najdete v tématu Definování dotazu.

Operátor dotazu

Když operátor vrátí odpovídající pracovní položky

Použitelné datové typy

=

Odpovídá hodnotě klauzule.

Number (Double/Decimal/GUID/Integer), String, DateTime, TreePath

<>

Neodpovídá hodnotě klauzule.

Number, String, DateTime, TreePath

>

Je větší než hodnota klauzule.

Číslo, Řetězec, Datum a čas

<

Je menší než hodnota klauzule.

Číslo, Řetězec, Datum a čas

>=

Je větší nebo roven hodnotě klauzule.

Číslo, Řetězec, Datum a čas

<=

Je menší než nebo rovno hodnotě klauzule.

Číslo, Řetězec, Datum a čas

=[Pole]

Odpovídá hodnotě v jiném zadaném poli (musí být stejný datový typ).

Název pole stejného datového typu (logická pole porovnávají rovnost s jinými poli).

<>[Pole]

Neodpovídá hodnotě v jiném zadaném poli.

Název pole stejného datového typu

>[Pole]

Je větší než hodnota v jiném zadaném poli.

Název pole stejného datového typu

<[Pole]

Je menší než hodnota v jiném zadaném poli.

Název pole stejného datového typu

>=[Pole]

Je větší nebo roven hodnotě v jiném zadaném poli.

Název pole stejného datového typu

<=[Pole]

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

Název pole stejného datového typu

Obsahuje

Obsahuje přesnou nebo částečnou shodu textu.

String

Neobsahuje

Neobsahuje přesnou nebo částečnou shodu textu.

String

Obsahuje slova.

Odpovídá přesné frázi nebo slovu (podporuje koncové zástupné znaky *). Limit: 100 znaků. Tento operátor používá fulltextové indexování; v části Fulltext v tomto článku najdete požadavky na server a kolaci.

Dlouhá textová pole indexovaná pro fulltextové vyhledávání (PlainText, HTML, History a Title).

Neobsahuje slova

Vyloučí položky, které obsahují zadanou frázi nebo slova. Limit: 100 znaků. Contains Words V doprovodných klauzulích se používá k zahrnutí nebo vyloučení klíčových slov.

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

In

Odpovídá libovolné hodnotě v oddělené sadě (použijte regionální oddělovač operačního systému, obvykle čárku).

Number, String, DateTime, TreePath

Je prázdné.

Odpovídá položkám, ve kterých pole HTML neobsahuje žádný obsah (není zadána žádná hodnota). Podporováno pro Azure Boards a Azure DevOps Server.

jazyk HTML

Není prázdné.

Odpovídá položkám, ve kterých pole HTML obsahuje obsah. Podporováno pro Azure Boards a Azure DevOps Server.

jazyk HTML

Není v

Vyloučí hodnoty v sadě s oddělenými hodnotami (použijte regionální oddělovač seznamu). Podporováno pro Azure Boards a Azure DevOps Server.

Number, String, DateTime, TreePath

Ve skupině

Odpovídá hodnotám, které jsou členy pojmenované skupiny (tým, skupina zabezpečení nebo kategorie). Použijte například skupinu Přispěvatelé nebo týmovou skupinu pojmenovanou v vzoru [Project Name]\Team Name. Příklady najdete v tématu Dotaz podle přiřazení nebo změn pracovního postupu .

Řetězec (odpovídá názvu skupiny nebo týmu) nebo typu pracovní položky

Poznámka:

Použít ve skupině pouze s poli typu řetězec nebo typu pracovní položky. Skupiny ID Microsoft Entra můžete použít, když váš účet používá Microsoft Entra ID nebo skupiny Active Directory pro místní prostředí. :::column-end:::

Není ve skupině

Vyloučí členy pojmenované skupiny.

Řetězec, který odpovídá skupině uživatelů nebo kategorii projektu.

Není v části

Vyloučí položky, které jsou stejné nebo obsažené v zadaném uzlu stromu.

TreePath

Pod

Odpovídá položkám rovnajícím se nebo obsaženým v zadaném uzlu stromu.

TreePath

Byl někdy

Odpovídá hodnotě, kterou pole drželo v jakékoliv předchozí době.

řetězec, datum a čas

Poznámka:

Editor dotazů v současné době nepodporuje Was Ever pole kalendářních dat. Pro tyto případy použijte přímou funkci WIQL. :::column-end:::

Tip

Dotazy WIQL, které používají operátory, například Was Ever, můžete vytvořit s jinými datovými typy, jako je Cesta iterace. Příklad najdete v tématu Seznam pracovních položek přesunutých ze sprintu .

Dotazování maker a proměnných

Pomocí následujících makro funkcí (makra) můžete dynamicky filtrovat dotazy.

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í typu pracovní položky nebo stavu můžete vyhledávat ve všech typech nebo stavech. Například Work Item Type=[Any] odebere filtrování založené na typech.

---

@CurrentIteration

Pomocí cesty iterace můžete filtrovat pracovní položky v aktuálním sprintu na základě kontextu aktuálního týmu. Příklady najdete v tématu Dotaz podle data nebo aktuální iterace . @CurrentIteration funguje pouze při spuštění z webového portálu (ne v rozhraních REST API nebo některých operacích kopírování/klonování).

---

@CurrentIteration +/- n

Pomocí cesty iterace můžete zahrnout sprinty vzhledem k aktuální iteraci (například @CurrentIteration-1@CurrentIteration+2). Podporuje se na webovém portálu pro Azure Boards a Azure DevOps Server.

---

@Follows

Pomocí ID a operátora In můžete v projektu zobrazit seznam pracovních položek, které sledujete. Podívejte se na Sledování pracovní položky nebo pull requestu. Toto makro funguje jenom na webovém portálu.

---

@Me

Pomocí polí identity můžete filtrovat položky propojené s vaším účtem (například Created By=@Me). Viz Dotaz podle přiřazení, pracovního postupu nebo změny panelu.

---

@MyRecentActivity

Použijte s ID a In seznam pracovních položek, které jste si zobrazili nebo aktualizovali za posledních přibližně 30 dnů. Podívejte se na stránku Pracovní položky, kde je záložka Moje aktivita pro stejný seznam.

---

@Project

Pomocí týmového projektu můžete filtrovat pracovní položky v aktuálním projektu (například Team Project=@Project). Viz Dotaz napříč projekty.

---

@RecentMentions

Použijte s ID a In pro zobrazení pracovních položek, ve kterých jste zmíněni v diskuzích. Podívejte se na stránku Pracovní položky – Zmíněno pivot.

---

@RecentProjectActivity

Použijte s ID a In, abyste zobrazili seznam naposledy aktualizovaných pracovních položek v rámci projektu. Makro vrátí až 5 000 položek; skutečné okno závisí na aktivitě projektu.

---

@StartOfDay

Pomocí polí DateTime můžete filtrovat vzhledem k dnešnímu dni (například Closed Date>=@StartOfDay-7).

---

@StartOfMonth

Pomocí polí DateTime můžete filtrovat vzhledem k začátku měsíce (například Created Date>=@StartOfMonth-3).

---

@StartOfWeek

Pomocí polí DateTime můžete filtrovat vzhledem k začátku týdne (například Changed Date>=@StartOfWeek-2).

---

@StartOfYear

Pomocí polí DateTime můžete filtrovat podle začátku roku (například Target Date>=@StartOfYear).

---

@TeamAreas

K vyhledání položek přiřazených k cestám oblasti týmu použijte pouze cestu oblasti a = operátor (například Area Path=@TeamAreas [Fabrikam Fiber]\Web). Podporuje se na webovém portálu pro Azure DevOps Server.

---

@Today

Pomocí polí DateTime můžete filtrovat vzhledem k dnešnímu dni (například Created Date>=@Today-7). Viz Dotaz podle data nebo aktuální iterace.

---

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

Pomocí funkce Obsahuje nebo Neobsahuje můžete hledat přesné nebo částečné shody u dlouhých textových polí (tyto operátory používají index dotazu). Použijte Obsahuje slova nebo Neobsahuje slova k hledání přesné fráze nebo použijte koncový zástupný znak (*); tito operátoři vyžadují fulltextový index.

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 některé cloudové konfigurace SQL nepodporují fulltextové vyhledávání. V těchto nasazeních jsou viditelné pouze operátory Obsahuje a Neobsahuje .

Související obsah

• Použití stručné reference k dotazu
• Informace o spravovaných dotazech
• Přístup k indexu polí pracovní položky
• Pochopit syntaxi 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