Fråga efter område eller iterationssökväg

  • Artikel

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.

Fråga på områdessökväg för flera områden

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.

Fråga efter nodnamn för flera områden

I det här exemplet returnerar filtret alla arbetsobjekt som tilldelats till en områdessökväg vars sista nod innehåller ordet "Azure".

Fråga efter flera sprintar

Här är ett annat exempel som använder nodnamnet och In-operatorn .

Fråga efter nodnamn för flera områden

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.

Fråga om områdessökvägar som tilldelats till ett team

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.

REST-API

Om du vill interagera programmatiskt med frågor kan du läsa någon av dessa REST API-resurser: