Query uitvoeren op gebied of iteratiepad
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.
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'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.
In dit voorbeeld retourneert het filter alle werkitems die zijn toegewezen aan een gebiedspad waarvan het laatste knooppunt het woord 'Azure' bevat.
Hier volgt een ander voorbeeld waarin de knooppuntnaam en de operator In worden gebruikt.
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.
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.
Verwante artikelen:
- Snelle naslaginformatie voor query's
- Gebiedspaden definiëren en toewijzen aan een team
- Iteratiepaden (sprint) definiëren en teamiteraties configureren
- Machtigingen en toegang instellen voor het bijhouden van werk
REST-API
Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources: