Sdílet prostřednictvím

Dotazování podle data nebo aktuální iterace

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

Tento článek ukazuje, jak zobrazit seznam pracovních položek podle data vytvoření, změny, vyřešení nebo uzavření, a jak používat makra kalendářních dat (například @Today) a makra iterací pro použití při týmových sprintech. Základní informace o cestě iterace a omezení klienta nebo makra najdete v tématu Dotazování podle oblasti nebo cesty iterace.

Prerequisites

Category Requirements
Úrovně přístupu - Zobrazení a spuštění sdílených dotazů: člen projektu.
– Přidání a uložení sdíleného dotazu: Alespoň základní přístup.
Permissions oprávnění Přispívat nastavená 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í.

Note

Uživatelé s přístupem Zainteresovaná Strana k veřejnému projektu mají úplný přístup k funkcím dotazů stejně jako uživatelé se základním přístupem. Další informace najdete v části Rychlá příručka pro přístup účastníků.

Category Requirements
Úrovně přístupu - Zobrazení a spuštění sdílených dotazů: člen projektu.
- Přidání a uložení sdíleného dotazu: Alespoň Základní přístup.
Permissions oprávnění Přispívat nastavená 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í.

Podporované operátory a makra kalendářních dat

V Editoru dotazů použijte následující operátory a makra pro pole DateTime a Iteration Path.

  • Operátory DateTime: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Kalendářní makra: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear, @Today
    S těmito makry můžete kombinovat +/- n (například @Today - 7).
  • Makra iterace: @CurrentIteration a @CurrentIteration +/- n (viz následující poznámka a odkaz na omezení klienta a chování parametru týmu).

Note

Makra iterace a omezení klienta jsou podrobně popsána na stránce iterace: Dotazování podle oblasti nebo cesty iterace. Pokud potřebujete dotazy ke spuštění v jiných než webových klientech nebo prostřednictvím rozhraní REST/WIQL mimo webové uživatelské rozhraní, ověřte podporu maker ve vašem prostředí a zvažte rozšíření maker na explicitní cesty.

Příklady rychlých dat (běžné dotazy)

  • Položky vytvořené za posledních 30 dnů: Snímek obrazovky znázorňující klauzuli Editor dotazů pro hledání položek vytvořených za posledních 30 dnů

  • Položky změněné v určitém datu: Snímek obrazovky znázorňující klauzuli Editor dotazů pro vyhledání položek změněných v určitém datu

  • Vyřešené položky dnes: Snímek obrazovky, který zobrazuje klauzuli Editor dotazů pro hledání položek vyřešených dnes

  • Položky zavřené v zadaném časovém období: Snímek obrazovky znázorňující klauzuli Editor dotazů pro hledání položek uzavřených v zadaném časovém období

  • Položky, jejichž uzavřené datum má hodnotu null (není uzavřeno): Snímek obrazovky, který zobrazuje klauzuli Editor dotazů pro hledání položek, jejichž datum uzavření je prázdné nebo má hodnotu null.

  • Položky, jejichž stav se v posledním týdnu změnil: Snímek obrazovky znázorňující klauzuli Editor dotazů pro položky, jejichž stav byl aktualizován v posledním týdnu

Použití @CurrentIteration makro (stručná příručka)

Slouží @CurrentIteration k cílení na aktuální sprint týmu a @CurrentIteration +/- n k vytvoření posuvného okna sprintů (například poslední dva, aktuální a další dva sprinty). Důležité body:

  • @CurrentIteration vrátí položky přiřazené aktuálnímu sprintu pro týmový kontext použitý při spuštění dotazu.
  • @CurrentIteration +/- n posune tento časový rámec sprintů o n, užitečné pro analýzy trendů nebo analýzy přenosů.
  • Vzhledem k tomu, že se chování maker a podpora klientů liší, prostudujte Dotaz podle oblasti nebo cesty iterace pro podrobnosti o parametrech týmu, které makra vyhodnocují klienti, a o způsobu ukládání či rozbalování maker při ukládání dotazů.

Ukázkové obrázky (Editor dotazů webového portálu):

Snímek obrazovky znázorňující filtr Editoru dotazů pomocí makra CurrentIteration s parametrem týmu

Snímek obrazovky znázorňující klauzule CurrentIteration plus a minus pro posuvné okno sprintů

Tip

Pokud @CurrentIteration nevrátí očekávané výsledky, ověřte v nastavení týmu vybranou iteraci týmem a časové rozmezí iterace.

Kalendářní makra: začátek dne,týdne/měsíce/roku

Počáteční makra pomáhají vytvářet konzistentní rozsahy relativních kalendářních dat:

  • @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear – pomocí těchto maker vytvořte rozsahy s +/- n, jako je například "od začátku týdne" nebo "posledních 3 měsíců".
  • Tato makra se vyhodnocují uživatelským rozhraním webového portálu; jejich chování v jiných než webových scénářích se může lišit – otestujte v cílovém klientovi.

Příklady dotazů:

Snímek obrazovky znázorňující klauzule editoru dotazů pro vyhledání položek změněných za posledních 10 dnů.

Snímek obrazovky znázorňující klauzule Editoru dotazů pro funkce naplánované k dokončení v následujících třech měsících.

Kdy použít WIQL přímo

Použití TECHNOLOGIE WIQL v případech:

  • Potřebujete pokročilé operátory, jako je WAS EVER pro změny cesty iterace.
  • Editor dotazů blokuje nebo označuje klauzuli jako nepodporovanou (například některá Was Ever použití). Rozšíření EDITORu WIQL umožňuje vytvářet tyto dotazy a ukládat je.

Příklady najdete v syntaxi jazyka WIQL (Work Item Query Language) a rozšíření MARKETPLACE editoru WIQL.

Související obsah

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:

  • Last updated on