Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Velden Gebiedspad en Iteratiepad worden weergegeven op alle werkitemformulieren voor elk type werkitem. U definieert deze paden voor uw 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.
Prerequisites
| Category | Requirements |
|---|---|
| Toegangsniveaus | - Gedeelde query's weergeven en uitvoeren: Project-lid. - Een gedeelde query toevoegen en opslaan: ten minste Basic toegang. |
| Permissions | Machtiging bijdragen ingesteld op toestaan voor de map waaraan u een query wilt toevoegen. Standaard heeft de inzenders groep deze machtiging niet. |
Note
Gebruikers met toegang voor belanghebbenden voor een openbaar project hebben volledige toegang tot queryfuncties, net zoals gebruikers met Basis toegang. Zie Snelzoekgids voor toegang van belanghebbendenvoor meer informatie.
| Category | Requirements |
|---|---|
| Toegangsniveaus | - Gedeelde query's weergeven en uitvoeren: Project-lid. - Een gedeelde query toevoegen en opslaan: minimaal Basic toegang. |
| Permissions | Machtiging bijdragen ingesteld op toestaan voor de map waaraan u een query wilt toevoegen. Standaard heeft de inzenders groep deze machtiging niet. |
Note
De volgende macro's worden alleen ondersteund vanuit de webportal: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityen @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 velden gebiedspad en iteratiepad opgeeft, kunt u de volgende operators gebruiken:
| Operator | Gebruik dit als u wilt... |
|---|---|
= |
Eén specifiek gebied of iteratiepad opgeven |
<> |
Eén specifiek gebied of iteratiepad uitfilteren |
In |
Filteren op een set gebieds- of iteratiepaden |
Not In |
Items uitsluiten die zijn toegewezen aan een set gebieds- of iteratiepaden |
Under |
Alle paden opgeven onder een geselecteerd gebied of iteratiepad |
Not Under |
Items uitsluiten die zijn toegewezen onder een specifiek gebied of iteratiepad |
U kunt de volgende macro's gebruiken wanneer u het veld Iteratiepad selecteert. Zie de queryvoorbeelden op deze pagina voor voorbeelden.
| Macro | Gebruik dit als u wilt... |
|---|---|
@CurrentIteration |
De huidige iteratie opgeven die is gekoppeld aan de geselecteerde teamcontext |
@CurrentIteration +/- n |
Items filteren op basis van toewijzing naar een schuifvenster van sprints die zijn gekoppeld aan de geselecteerde teamcontext |
@TeamAreas |
Items filteren op basis van gebiedspad(en) die zijn toegewezen aan een specifiek team |
Note
De Azure DevOps-webportal evalueert macro's zoals @CurrentIteration, @CurrentIteration +/- nen @TeamAreas (Services en Server). Voor niet-webclients (Visual Studio/Team Explorer, Excel, Project) en directe WIQL-/REST-aanroepen zijn expliciete gebieds-/iteratiepaden vereist en worden geen onbewerkte macrotokens geaccepteerd. Wanneer u een query opslaat in de webgebruikersinterface, worden in de portal meestal macro's uitgebreid naar concrete waarden in de opgeslagen WIQL. Controleer dit gedrag in uw omgeving als u query's buiten de webgebruikersinterface moet gebruiken.
Queries voor gebiedspaden
U kunt 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 Naam van knooppunt om werkitems te filteren die zijn toegewezen aan vlakpaden op basis van een trefwoord met behulp van de operator Contains . De knooppuntnaam specificeert het laatste knooppunt van een gebiedspad, dat overeenkomt met het laatste knooppunt in de boomhiërarchie.
De volgende query produceert hetzelfde resultaat als in het vorige voorbeeld.
In dit voorbeeld retourneert het filter 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 @TeamAreas macro om items te vinden die zijn toegewezen aan de gebiedspaden die een specifiek team gebruikt. Geef de operator = op. De queryeditor vraagt u om de teamnaam in te voeren. selecteer het team in de voorgestelde lijst.
Verwijzing naar classificatieveld
| Veldnaam | Description | Verwijzingsnaam |
|---|---|---|
| Gebiedspad | Groepeert werkitems in productonderdelen 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 regels en regelevaluatievoor meer informatie.
De volgende velden worden niet weergegeven in werkitemformulieren, maar Azure DevOps houdt deze bij voor elk type werkitem. Deze velden bieden een numerieke waarde voor elke classificatiewaarde die u definieert voor een project. U kunt deze velden gebruiken om query's te filteren en rapporten te maken.
| Veldnaam | Description | Verwijzingsnaam | Gegevenstype |
|---|---|---|---|
| Gebieds-id | De unieke id van het gebied waar u dit werkitem toewijst. | System.AreaId | Integer |
| Iteratie-id | De unieke id van de iteratie waaraan u dit werkitem toewijst. | System.IterationId | Integer |
| 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 hebben indexen. Knooppuntnaam bestaat niet. Zie Werkitemvelden en -kenmerkenvoor meer informatie over veldkenmerken.
Verwante inhoud
- snelreferentie voor queries
- 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: