Dotazování podle oblasti nebo cesty iterace

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

Pole Cesta k oblasti a cesta iterace se zobrazují ve formuláři sledování práce pro všechny typy pracovních položek. Definujete je pro projekt —cesty oblasti a cesty iterace— a následně vyberte ty, které chcete přiřadit týmu.

Pokud chcete lépe pochopit, jak pracovat s oblastmi a iteračními cestami, přečtěte si o týmech a agilních nástrojích.

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: Alespoň Základní přístup.
oprávnění	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í.

Poznámka

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

Poznámka

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:

Operátor	Použijte, když chcete...
=	Zadejte jednu konkrétní oblast nebo cestu iterace.
<>	Vyfiltrujte jednu, konkrétní oblast nebo cestu iterace.
In	Umožňuje filtrovat sadu oblastí nebo iteračních cest.
Not In	Vylučte položky přiřazené sadě oblastí nebo cest iterace.
Under	Zadejte všechny cesty v oblasti výběru nebo cesty iterace.
Not Under	Vylučte položky přiřazené v určité oblasti nebo cestě iterace.

Spolu s těmito operátory můžete při výběru cesty iterace použít následující makra. Příklady najdete v části Dotaz podle data nebo aktuální iterace.

Makro	Použijte, když chcete...
@CurrentIteration	Zadejte aktuální iteraci přidruženou k vybranému kontextu týmu.
@CurrentIteration +/- n	Vyfiltrujte položky na základě přiřazení do posuvného okna sprintů spojeného s vybraným kontextem týmu.
@TeamAreas	Filtrovat položky na základě cest oblastí přiřazených konkrétnímu týmu.

Poznámka

Makra @CurrentIteration +/- n a @TeamAreas jsou podporována pro Azure DevOps Server 2019 a novější verze. Tato makra jsou podporována pouze na webovém portálu. Dotazy, které obsahují tato makra, nebudou při otevření v sadě Visual Studio nebo Team Exploreru, Microsoft Excelu nebo Microsoft Projectu fungovat.

Dotazy na cestu k oblasti

Pomocí operátoru In můžete určit filtrování pracovních položek, které jsou přiřazeny k několika oblastem, jak je uvedeno v následujícím příkladu.

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

Pomocí pole pro název uzlu můžete filtrovat pracovní položky přiřazené k cestám v 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 získá stejný výsledek jako v předchozím příkladu.

V tomto příkladu vrátí filtr všechny pracovní položky přiřazené cestě k 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í makra @TeamAreas můžete rychle najít položky přiřazené oblastním cestám určeným konkrétnímu týmu. Zadejte operátor =. Editor dotazů vás automaticky vyzve k zadání názvu týmu. Můžete ho přidat tak, že zadáte název týmu a zvolíte hodnotu týmu, která se zobrazí v kritériích filtru hledání.

Odkaz na pole klasifikace

Název pole	popis	název reference
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
Iterační cesta	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 sledují se pro každý typ pracovní položky. Tato pole poskytují číselnou hodnotu pro každou klasifikační hodnotu definovanou pro projekt. Tato pole můžete použít k filtrování dotazů a vytváření sestav.

Název pole	popis	název reference	datový typ
ID oblasti	Jedinečné ID oblasti, ke které je tato pracovní položka přiřazena.	Systém.OblastId	Celé číslo
ID iterace	Jedinečné ID iterace, ke které je tato pracovní položka přiřazena.	System.IterationId	Celé číslo
Název uzlu	Název posledního uzlu cesty k oblasti. Pokud je například cesta k oblasti Project\A1\B2\C3, název uzlu je C3.	System.NodeName	Řetězec

Výchozí typ ke hlášení je žádný. ID oblasti a ID iterace jsou indexovány, ale název uzlu není. Další informace o atributech polí najdete v tématu Pole a atributy pracovní položky.

Související články

• Dotaz - stručná příručka
• Definování cest oblastí a přiřazení 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
• Dotazy
• dotazovací jazyk pracovní položky
• načítání pracovních položek pomocí dotazů prostřednictvím kódu programu