Dotazování podle oblasti nebo cesty iterace

  • Článek

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

Cesta k oblasti a cesta iterace jsou dvě pole, která se zobrazují ve formuláři sledování práce pro všechny typy pracovních položek. Definujete je pro projekt – cesty oblastí a cesty iterace – a pak vyberte ty, které chcete přidružit k týmu.

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

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.

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 tématu 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í k posuvným oknem sprintů přidružených k vybranému kontextu týmu.
@TeamAreas Filtrovat položky na základě cest oblastí přiřazených konkrétnímu týmu.

Poznámka:

Tato @CurrentIteration +/- n makra jsou @TeamAreas 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 přiřazených k několika cestám oblasti, jak je znázorněno v následujícím příkladu.

Dotaz na cestu k oblasti pro několik oblastí

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

Dotaz na název uzlu pro několik oblastí

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

Dotaz na několik sprintů

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

Dotaz na název uzlu pro několik oblastí

Dotazy na cesty k týmové oblasti

Pomocí @TeamAreas makra můžete rychle najít položky přiřazené k cestám k oblasti přiřazené konkrétnímu týmu. = Zadejte operátor. Editor Power Query automaticky zobrazí výzvu 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í.

Dotazování na cesty oblastí přiřazené týmu

Odkaz na pole klasifikace

Název pole Popis Název odkazu
Cesta k oblasti Seskupí pracovní položky do funkcí produktu nebo týmových oblastí. 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, data path=TreePath, reportable type=Dimension, index attribute=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 maximálně 10 znaků a nevynořujte uzly delší než 14 úrovní.

Většinu pravidel polí nelze použít na systémová pole, jako jsou pole System.AreaPath a System.IterationPath. Další informace najdete 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 odkazu Datový typ
ID oblasti Jedinečné ID oblasti, ke které je tato pracovní položka přiřazena. System.AreaId 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 String

Výchozí typ, který lze sestavovat, není žádný. ID oblasti a ID iterace se indexují, název uzlu není. Další informace o atributech polí najdete v tématu Pole a atributy pracovní položky.

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: