Query uitvoeren op gebied of iteratiepad

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Het gebiedspad en het iteratiepad zijn twee velden die worden weergegeven in het werktraceringsformulier voor alle typen werkitems. U definieert deze voor een project, gebiedspaden en iteratiepaden, en selecteer vervolgens de paden die u aan een team wilt koppelen.

Zie Over teams en Agile-hulpprogramma's voor meer informatie over het werken met gebieds- en iteratiepaden.

Notitie

De volgende macro's worden alleen ondersteund vanuit de webportal: @CurrentIteration, @CurrentIteration +/-n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity en @TeamAreas. Query's die deze macro's bevatten, werken niet wanneer ze worden geopend in Visual Studio/Team Explorer, Microsoft Excel of Microsoft Project.

Ondersteunde operators en macro's

Wanneer u query's maakt en de velden Gebiedspad en Iteratiepad opgeeft, kunt u de volgende operators gebruiken:

Operator Gebruik dit als u wilt...
= Eén specifiek gebied of iteratiepad opgeven
<> Filter één, specifiek gebied of iteratiepad.
In Filter op een set gebieds- of iteratiepaden.
Not In Items uitsluiten die zijn toegewezen aan een set gebieds- of iteratiepaden.
Under Geef alle paden op onder een selectiegebied of iteratiepad.
Not Under Sluit items uit die zijn toegewezen onder een specifiek gebied of iteratiepad.

Naast deze operators kunt u de volgende macro's gebruiken wanneer u het herhalingspad selecteert. Zie Query op datum of huidige iteratie voor voorbeelden.

Macro Gebruik dit als u wilt...
@CurrentIteration Geef de huidige iteratie op die is gekoppeld aan de geselecteerde teamcontext.
@CurrentIteration +/- n Filter items op basis van toewijzing naar een schuifvenster van sprints die zijn gekoppeld aan de geselecteerde teamcontext.
@TeamAreas Filter items op basis van gebiedspad(en) die zijn toegewezen aan een specifiek team.

Notitie

De @CurrentIteration +/- n en @TeamAreas macro's worden ondersteund voor Azure DevOps Server 2019 en latere versies. Deze macro's worden alleen ondersteund vanuit de webportal. Query's die deze macro's bevatten, werken niet wanneer ze worden geopend in Visual Studio/Team Explorer, Microsoft Excel of Microsoft Project.

Query's voor gebiedspaden

U kunt opgeven dat u wilt filteren op werkitems die zijn toegewezen aan verschillende vlakpaden met behulp van de operator In , zoals wordt weergegeven in het volgende voorbeeld.

Query uitvoeren op gebiedspad voor verschillende gebieden

Query's op basis van knooppuntnamen en trefwoorden

Gebruik het veld Knooppuntnaam om te filteren op werkitems die zijn toegewezen aan vlakpaden op basis van een trefwoord met behulp van de operator Contains . De naam van het knooppunt geeft het laatste knooppunt van een gebiedspad op, dat overeenkomt met het laatste knooppunt in de structuurhiërarchie.

De volgende query levert hetzelfde resultaat op als in het vorige voorbeeld.

Query uitvoeren op knooppuntnaam voor verschillende gebieden

In dit voorbeeld retourneert het filter alle werkitems die zijn toegewezen aan een gebiedspad waarvan het laatste knooppunt het woord 'Azure' bevat.

Query uitvoeren op verschillende sprints

Hier volgt een ander voorbeeld waarin de knooppuntnaam en de operator In worden gebruikt.

Query uitvoeren op knooppuntnaam voor verschillende gebieden

Padquery's voor teamgebied

Gebruik de macro @TeamAreas om snel items te vinden die zijn toegewezen aan de gebiedspaden die aan een specifiek team zijn toegewezen. Geef de = operator op. De Power Query-editor vraagt u automatisch om de naam van het team in te voeren. U kunt deze toevoegen door de naam van het team in te voeren en de teamwaarde te kiezen die wordt weergegeven in de zoekfiltercriteria.

Query uitvoeren op gebiedspaden die zijn toegewezen aan een team

Verwijzing naar classificatieveld

Veldnaam Beschrijving Verwijzingsnaam
Gebiedspad Groepen werkitems in productfuncties of teamgebieden. Het gebied moet een geldig knooppunt in de projecthiërarchie zijn. System.AreaPath
Iteratiepad Hiermee worden werkitems gegroepeerd op benoemde sprints of perioden. De iteratie moet een geldig knooppunt in de projecthiërarchie zijn. System.IterationPath

Voor elk veld, gegevenspad=TreePath, rapportbaar type=Dimension, indexkenmerk=True.

Als u een padnaam definieert die langer is dan 256 tekens, kunt u deze niet opgeven in Microsoft Project. Om dit probleem te voorkomen, definieert u padnamen van maximaal 10 tekens en nestt u knooppunten niet meer dan 14 niveaus diep.

U kunt de meeste veldregels niet toepassen op systeemvelden, zoals System.AreaPath- en System.IterationPath-velden. Zie De evaluatie van regels en regels voor meer informatie.

De volgende velden worden niet weergegeven in werkitemformulieren, maar worden bijgehouden voor elk type werkitem. Deze velden bieden een numerieke waarde voor elke classificatiewaarde die is gedefinieerd voor een project. U kunt deze velden gebruiken om query's te filteren en rapporten te maken.

Veldnaam Beschrijving Verwijzingsnaam Gegevenstype
Gebieds-id De unieke id van het gebied waaraan dit werkitem is toegewezen. System.AreaId Geheel getal
Iteratie-id De unieke id van de iteratie waaraan dit werkitem is toegewezen. System.IterationId Geheel getal
Naam van knooppunt De naam van het laatste knooppunt van een gebiedspad. Als het gebiedspad bijvoorbeeld Project\A1\B2\C3 is, is de naam van het knooppunt C3. System.NodeName String

Het standaardrapportbare type is geen. Gebieds-id en iteratie-id worden geïndexeerd, knooppuntnaam niet. Zie De velden en kenmerken van het werkitem voor meer informatie over veldkenmerken.

REST-API

Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources: