Dotazování podle oblasti nebo cesty iterace

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

Pole Cesta k oblasti a Cesta iterace se zobrazují ve všech formulářích pracovních položek pro každý typ pracovní položky. Tyto cesty definujete pro svůj projekt – cesty oblastí a cesty iterace – a pak vyberete ty, které chcete přidružit k týmu.

Informace o tom, jak pracovat s oblastmi a iteračními cestami, najdete v tématu Týmy a agilní nástroje.

Prerequisites

Category	Requirements
Ú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: 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 Stakeholder k veřejnému projektu mají plný přístup k funkcím dotazů stejně jako uživatelé s Základním přístupem. Další informace naleznete v tématu Rychlý odkaz pro přístup účastníků.

Note

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

Podporované operátory a makra

Při vytváření dotazů a zadávání polí Cesta k oblasti a Cesta iterace můžete použít následující operátory:

Operator	Použijte, když chcete...
=	Zadejte jednu konkrétní oblast nebo cestu iterace.
<>	Vyfiltrujte jednu konkrétní oblast nebo cestu iterace.
In	Filtrování pro sadu oblastí nebo iteračních cest
Not In	Vyloučení položek přiřazených k sadě oblastí nebo iteračních cest
Under	Zadejte všechny cesty ve vybrané oblasti nebo cestě iterace.
Not Under	Vyloučení položek přiřazených v konkrétní oblasti nebo cestě iterace

Při výběru pole Cesta iterace můžete použít následující makra. Příklady najdete v příkladech dotazů na této stránce.

Macro	Použijte, když chcete...
@CurrentIteration	Zadejte aktuální iteraci přidruženou k vybranému kontextu týmu.
@CurrentIteration +/- n	Filtrovat položky na základě přiřazení k posuvnému oknu sprintů v rámci vybraného kontextu týmu
@TeamAreas	Filtrujte položky podle cest oblastí přiřazených konkrétnímu týmu

Note

Webový portál Azure DevOps vyhodnocuje makra, jako jsou @CurrentIteration, @CurrentIteration +/- n a @TeamAreas (Služby a Server). Ne webové klienty (Visual Studio/ Team Explorer, Excel, Project) a přímá volání WIQL/REST vyžadují explicitní cesty k oblasti nebo iteraci a nepřijímají nezpracované tokeny maker. Když dotaz uložíte ve webovém uživatelském rozhraní, portál obvykle rozšíří makra na konkrétní hodnoty v uloženém WIQL – pokud potřebujete použít dotazy mimo webové uživatelské rozhraní, ověřte toto chování ve vašem prostředí.

Dotazy na cesty v oblasti

Pracovní položky, které jsou přiřazeny k několika oblastním cestám, můžete filtrovat pomocí operátoru In, jak je znázorněno v následujícím příkladu.

Názvy uzlů a dotazy založené na klíčových slovech

Pomocí pole Název uzlu můžete filtrovat pracovní položky přiřazené k cestám oblasti na základě klíčového slova pomocí operátoru Contains . Název uzlu určuje poslední uzel cesty k oblasti , který odpovídá poslednímu uzlu ve stromové hierarchii.

Následující dotaz vytvoří stejný výsledek jako v předchozím příkladu.

V tomto příkladu filtr vrátí pracovní položky přiřazené k cestě oblasti, jejíž poslední uzel obsahuje slovo "Azure".

Tady je další příklad, který používá název uzlu a operátor In.

Dotazy na cesty oblastí týmu

Pomocí @TeamAreas makra vyhledejte položky přiřazené k cestám oblasti, které používá konkrétní tým. Zadejte operátor =. Editor dotazů vás vyzve k zadání názvu týmu; vyberte tým z navrhovaného seznamu.

Odkaz na pole klasifikace

Název pole	Description	Název odkazu
Cesta k oblasti	Seskupí pracovní položky do oblastí funkcí produktů nebo oblastí týmů. Oblast musí být platným uzlem v hierarchii projektu.	System.AreaPath
Cesta iterace	Seskupí pracovní položky podle pojmenovaných sprintů nebo časových období. Iterace musí být platným uzlem v hierarchii projektu.	System.IterationPath

Pro každé pole cesta k datům=TreePath, typ pro hlášení=Dimension, indexový atribut=True.

Pokud definujete název cesty delší než 256 znaků, nemůžete ho zadat v Microsoft Projectu. Chcete-li se tomuto problému vyhnout, definujte názvy cest o délce maximálně 10 znaků a nezanořujte uzly více než 14 úrovní hluboko.

Většinu pravidel polí nelze použít na systémová pole, jako jsou pole System.AreaPath a System.IterationPath. Další informace naleznete v tématu Pravidla a vyhodnocení pravidel.

Následující pole se nezobrazují ve formulářích pracovních položek, ale Azure DevOps je sleduje pro každý typ pracovní položky. Tato pole poskytují číselnou hodnotu pro každou klasifikační hodnotu, kterou definujete pro projekt. Tato pole můžete použít k filtrování dotazů a vytváření sestav.

Název pole	Description	Název odkazu	Datový typ
ID oblasti	Jedinečné ID oblasti, ve které přiřadíte tuto pracovní položku.	System.AreaId	Integer
ID iterace	Jedinečné ID iterace, ve které přiřadíte tuto pracovní položku.	System.IterationId	Integer
Název uzlu	Název posledního uzlu oblasti cesty. Pokud je například cesta k oblasti Project\A1\B2\C3, název uzlu je C3.	System.NodeName	String

Výchozí typ ke hlášení je žádný. ID oblasti a ID iterace mají indexy. Název uzlu nefunguje. Další informace o atributech polí najdete v tématu Pole a atributy pracovní položky.

Související obsah

• Dotaz - stručná příručka
• Definujte cesty oblastí a přiřaďte je týmu
• Stanovit cesty iterace (sprint) a nastavit týmové iterace
• Nastavení přístupu a oprávnění pro sledování práce

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í odkaz REST API služby Azure DevOps Services
• Queries
• dotazovací jazyk pracovní položky
• načítání pracovních položek pomocí dotazů prostřednictvím kódu programu