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.

Förutsättningar

Kategori	Krav
Åtkomstnivåer	För att visa och köra delade frågor: projektmedlem. – Så här lägger du till och sparar en delad fråga: Minst Grundläggande åtkomst.
Behörigheter	Contribute behörighet satt till Tillåt i mappen som du vill lägga till en sökfråga i. Som standard har gruppen Deltagare inte den här behörigheten.

Not

Användare med intressent åtkomst för ett offentligt projekt har fullständig åtkomst till frågefunktioner precis som användare med Grundläggande åtkomst. Mer information finns i snabbreferens för intressentåtkomst.

Not

Följande makron stöds bara från webbportalen: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityoch @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:

Operatör	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ådesväg(ar) som är tilldelade ett specifikt team.

Not

Makron @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.

Sökfrågor om områdesvägar

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. Nodnamn 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 Node Name och operatorn In.

Frågor om teamområdessökväg

Använd makrot @TeamAreas för att snabbt hitta objekt som tillhör de områden som är tilldelade ett visst team. Ange operatorn =. Frågeredigeraren 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
Iterationsväg	Grupperar arbetsobjekt efter namngivna sprintar eller tidsperioder. Iterationen måste vara en giltig nod i projekthierarkin.	System.Iterationsväg

För varje fält, dataväg=TreePath, rapporterbar typ=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 Regler 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	Heltal
Iterations-ID	Det unika ID för iterationen som det här arbetsobjektet har tilldelats till.	System.IterationId	Heltal
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	Sträng

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 sökfrågor
• Definiera områdessökvägar och tilldela till ett team
• Definiera iterationsvägar (sprint) och konfigurera teamets iterationer
• Ange behörigheter och åtkomst för arbetsuppföljning

REST API

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

• REST API-referens för Azure DevOps Services
• Frågor
• Frågespråk för arbetsobjekt
• Hämta arbetsobjekt med frågor programmatiskt