Fråga efter område eller iterationssökväg
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Områdessökvägen och iterationssökvägen är två fält som visas i arbetsspårningsformuläret för alla typer av arbetsobjekt. Du definierar dem för ett projekt – områdessökvägar och iterationssökvägar – och väljer sedan de som du vill associera med ett team.
Mer information om hur du arbetar med områdes- och iterationsvägar finns i Om team och agila verktyg.
Kommentar
Följande makron stöds bara från webbportalen: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity och @TeamAreas. Frågor som innehåller dessa makron fungerar inte när de öppnas i Visual Studio/Team Explorer, Microsoft Excel eller Microsoft Project.
Operatorer och makron som stöds
När du skapar frågor och anger fälten Områdessökväg och Iterationssökväg kan du använda följande operatorer:
| Operator | Använd när du vill... |
|---|---|
= |
Ange en specifik områdes- eller iterationssökväg |
<> |
Filtrera bort en specifik områdes- eller iterationssökväg. |
In |
Filtrera efter en uppsättning områdes- eller iterationssökvägar. |
Not In |
Exkludera objekt som har tilldelats till en uppsättning områdes- eller iterationssökvägar. |
Under |
Ange alla sökvägar under ett markerat område eller en iterationssökväg. |
Not Under |
Exkludera objekt som tilldelats under ett visst område eller en iterationssökväg. |
Tillsammans med dessa operatorer kan du använda följande makron när du väljer iterationssökväg. Exempel finns i Fråga efter datum eller aktuell iteration.
| Makro | Använd när du vill... |
|---|---|
@CurrentIteration |
Ange den aktuella iteration som är associerad med den valda gruppkontexten. |
@CurrentIteration +/- n |
Filtrera objekt baserat på tilldelning till ett skjutfönster med sprintar som är associerade med den valda teamkontexten. |
@TeamAreas |
Filtrera objekt baserat på områdessökvägar som tilldelats till ett visst team. |
Kommentar
Makrona @CurrentIteration +/- n och @TeamAreas stöds för Azure DevOps Server 2019 och senare versioner. Dessa makron stöds endast från webbportalen. Frågor som innehåller dessa makron fungerar inte när de öppnas i Visual Studio/Team Explorer, Microsoft Excel eller Microsoft Project.
Frågor om områdessökväg
Du kan ange att du vill filtrera efter arbetsobjekt som tilldelats flera områdessökvägar med hjälp av operatorn In enligt följande exempel.
Nodnamn och nyckelordsbaserade frågor
Använd fältet Nodnamn för att filtrera på arbetsobjekt som tilldelats till områdessökvägar baserat på ett nyckelord med operatorn Contains . Nodnamnet anger den sista noden i en områdessökväg, vilket motsvarar den sista noden i trädhierarkin.
Följande fråga ger samma resultat som i föregående exempel.
I det här exemplet returnerar filtret alla arbetsobjekt som tilldelats till en områdessökväg vars sista nod innehåller ordet "Azure".
Här är ett annat exempel som använder nodnamnet och In-operatorn .
Frågor om teamområdessökväg
Använd makrot @TeamAreas för att snabbt hitta objekt som tilldelats till de områdessökvägar som tilldelats till ett visst team. Ange operatorn = . Power Query-redigeraren uppmanar dig automatiskt att ange namnet på teamet. Du kan lägga till det genom att ange namnet på teamet och välja det teamvärde som visas i sökfiltervillkoren.
Referens för klassificeringsfält
| Fältnamn | Beskrivning | Referensnamn |
|---|---|---|
| Områdessökväg | Grupperar arbetsobjekt i produktfunktioner eller teamområden. Området måste vara en giltig nod i projekthierarkin. | System.AreaPath |
| Iterationssökväg | Grupperar arbetsobjekt efter namngivna sprintar eller tidsperioder. Iterationen måste vara en giltig nod i projekthierarkin. | System.IterationPath |
För varje fält, data path=TreePath, reportable type=Dimension, indexattribut=True.
Om du definierar ett sökvägsnamn som är längre än 256 tecken kan du inte ange det i Microsoft Project. För att undvika det här problemet definierar du sökvägsnamn på högst 10 tecken och kapslar inte noder som är mer än 14 nivåer djupa.
Du kan inte tillämpa de flesta fältregler på systemfält, till exempel Fälten System.AreaPath och System.IterationPath. Mer information finns i Regel- och regelutvärdering.
Följande fält visas inte i arbetsobjektsformulär men spåras för varje typ av arbetsobjekt. De här fälten ger ett numeriskt värde för varje klassificeringsvärde som definieras för ett projekt. Du kan använda de här fälten för att filtrera frågor och skapa rapporter.
| Fältnamn | Beskrivning | Referensnamn | Datatyp |
|---|---|---|---|
| Områdes-ID | Det unika ID:t för det område som det här arbetsobjektet tilldelas till. | System.AreaId | Integer |
| Iterations-ID | Det unika ID för iterationen som det här arbetsobjektet har tilldelats till. | System.IterationId | Integer |
| Nodnamn | Namnet på den sista noden i en områdessökväg. Om områdessökvägen till exempel är Project\A1\B2\C3 är nodnamnet C3. | System.NodeName | String |
Standardtypen som kan rapporteras är ingen. Områdes-ID och iterations-ID indexeras, nodnamn är det inte. Mer information om fältattribut finns i Fält och attribut för arbetsobjekt.
Relaterade artiklar
- Snabbreferens för frågor
- Definiera områdessökvägar och tilldela till ett team
- Definiera iterationssökvägar (sprint) och konfigurera team-iterationer
- Ange behörigheter och åtkomst för arbetsspårning
REST-API
Om du vill interagera programmatiskt med frågor kan du läsa någon av dessa REST API-resurser: