Definiera en fråga för arbetsobjekt

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

Frågor om arbetsobjekt i Azure Boards genererar listor över arbetsobjekt baserat på de filtervillkor som du har angett. Du kan spara och dela dessa hanterade frågor med andra.

Läs våra rekommenderade metodtips senare i den här artikeln.

Förutsättningar

Välj ett frågefilter

Från Power Query-redigeraren väljer du filtret för att gå vidare till en artikel med exempelfrågor. Tillsammans med frågefiltren kan du använda filter interaktivt för att fråga efter resultat.

Du kan filtrera en fråga interaktivt med hjälp av funktionen Filter.

Öppna frågor

Definiera en flat-lista fråga

Starta en ny fråga från fliken Frågor i webbportalen eller fliken Arbetsobjekt i Team Explorer.

Söka mellan eller inom projekten

Nytt frågeomfång för det aktuella projektet som standard. Men du kan skapa frågor för att hitta arbetsobjekt som definierats i organisationen eller projektsamlingen. Alla frågor som du sparar sparas dock under ett visst projekt.

Definiera en sats

Om du vill skapa en fråga definierar du en eller flera satser. Varje sats definierar ett filtervillkor för ett enda fält.

Exempel på frågesats

En lista över tillgängliga operatorer baserat på fältdatatypen finns i Snabbreferens för frågeindex.

Alla satser läggs till som ett Och-uttryck. Välj Eller om du vill ändra gruppering. Gruppera satser för att säkerställa att de körs i den sekvens som krävs.

Checklista för att definiera en frågesats

1. I den första tomma raden, under kolumnrubriken Fält , väljer du nedåtpilen för att visa listan över tillgängliga fält och väljer ett objekt i listan. Mer information finns i Frågefält och Värden.

2. På samma rad, under kolumnrubriken Operator , väljer du nedåtpilen för att visa listan över tillgängliga operatorer och väljer sedan ett objekt i listan. Mer information finns i Operatorer.

3. På samma rad, under kolumnrubriken Värde , anger du antingen ett värde eller väljer nedåtpilen och väljer sedan ett objekt i listan. Mer information om hur du använder ett makro eller en variabel för att ange aktuellt projekt, användare, datum eller annat val finns i Variabler.

4. Om du vill lägga till en sats väljer du Lägg till ny sats.

   Du kan lägga till en sats i slutet av frågan eller utföra följande uppgifter med motsvarande ikoner:

   • Infoga ny filterrad
   • Ta bort den här filterraden
   • Gruppera valda satser
   • Avgruppera satser

Använda ett arbetsobjektträd för att visa hierarkier

Använd frågan Träd för arbetsobjekt för att visa en kapslad lista med arbetsobjekt med flera nivåer. Du kan till exempel visa alla kvarvarande uppgifter och deras länkade uppgifter. Om du vill fokusera på olika delar av trädet väljer du Expandera alla eller Dölj alla.

Använda direktlänkar för att visa beroenden

Använd frågan Arbetsobjekt och Direktlänkar för att spåra arbetsobjekt som är beroende av annat spårat arbete, till exempel uppgifter, buggar, problem eller funktioner. Du kan till exempel visa kvarvarande uppgifter som är beroende av att andra objekt implementeras eller ett fel som åtgärdas.

Använd direktlänkfrågan för att spåra beroenden mellan team. Frågan hjälper dig också att hantera åtaganden som ditt team gör. Välj filtervillkoren för de översta och länkade arbetsobjekten. Och välj de typer av länkar som ska filtrera beroendena.

Mer information om varje länktyp finns i Referens för länktyp.

Använd och/eller logiska uttryck

Ange And eller Or skapa logiska uttryck för dina frågesatser. Använd And för att hitta arbetsobjekt som uppfyller kriterierna i både den aktuella satsen och den tidigare satsen. Använd Or för att hitta arbetsobjekt som uppfyller kriteriet i antingen den aktuella satsen eller den tidigare satsen.

Lägg till ett nytt villkor för varje arbetsobjektfält för att förfina sökkriterierna. Lägg till satser för att endast returnera den uppsättning arbetsobjekt som du vill ha. Om du inte får de resultat du förväntar dig av din fråga förfinar du den. Du kan lägga till, ta bort, gruppera eller dela upp frågesatser för att förbättra frågeresultatet.

Gruppera frågesatser för att fungera som en enskild enhet separat från resten av frågan. Grupperingssatser liknar att placera parenteser runt ett uttryck i en matematisk ekvation eller logiksats. När du grupperar satser And gäller eller Or för den första satsen i gruppen för hela gruppen.

Gruppsatser

Grupperade satser fungerar som en enskild enhet separat från resten av frågan. Grupperingssatser liknar att placera parenteser kring en matematisk ekvation eller ett logikuttryck. Operatorn And eller Or för den första satsen i gruppen gäller för hela gruppen.

Som följande exempel visar översätts de grupperade satserna till motsvarande logiska uttryck.

Fråga	Grupperade satser	Logiskt uttryck
1
2
3

De här frågorna returnerar arbetsobjekt som är av typen Bugg och uppfyller följande logiska uttryck:

• Fråga 1: AND State=Active OR Assigned to @Me
• Fråga 2: AND (State=Active OR Assigned to @Me)
• Fråga 3: OR (State=Active AND Assigned to @Me)

Om du vill gruppera en eller flera satser väljer du dem och väljer sedan gruppsatsens ikon.

Du kan också gruppera flera grupperade satser. Markera kryssrutorna för varje klausul. Välj sedan gruppsatsens ikon.

Om frågeresultatet inte returnerar förväntade resultat gör du följande:

• Kontrollera att varje sats har definierats som du tänkt dig.
• Verifiera And/Or tilldelningar för varje sats. Om resultatet innehåller fler arbetsobjekt än förväntat finns ofta en Or sats i stället för en And sats.
• Kontrollera om du behöver gruppera eller ändra gruppering av frågesatserna och And/Or tilldelningarna för varje grupperad sats.
• Lägg till fler frågesatser för att förfina frågefiltervillkoren.
• Granska de tillgängliga alternativen för att ange fält, operatorer och värden.
• Se metodtips senare i den här artikeln.

Avgruppera en sats

Om du vill dela upp en sats väljer du ikonen för ogrupperade satser för den grupperade satsen.

Ange standardkolumnbredd i frågeresultat

Gör följande för att ange standardkolumnbredden i frågeresultatet:

1. Öppna den fråga som du vill ändra.
2. Justera kolumnbredderna manuellt till önskad storlek genom att dra kanterna på kolumnrubrikerna.
3. Välj Spara eller Spara som om du vill spara det som en ny fråga.
4. Stäng och öppna frågan igen för att säkerställa att kolumnbredderna behålls.

Azure DevOps stöder för närvarande inte att ange en standardkolumnbredd som bevaras i alla sessioner. Kolumnbredderna sparas per fråga, så du måste justera och spara dem för varje fråga individuellt.

Visa frågeresultat i en översikt

Följande två widgetar visar frågeresultat. Du kan öppna arbetsobjekt direkt från dessa widgetar.

• Arbete som tilldelats mig: Visar en lista över alla föreslagna eller aktiva arbetsobjekt som tilldelats den inloggade användaren. Visar fälten ID, Tillstånd och Rubrik.
• Frågeresultatwidget: Visar resultatet av en flat fråga, ett träd eller en direktlänkfråga. Du kan konfigurera fälten som visas via widgeten, ändra storlek på kolumnfälten och expandera och komprimera träd- och direktlänkfrågan.

Mer information finns i Lägga till widgetar på en instrumentpanel.

Definiera en fråga som en hyperlänk

En frågehyperlänk använder WIQL (Work Item Query Language), som liknar Transact-SQL. Mer information finns i Syntax för WIQL (Work Item Query Language).

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'   

Bästa praxis

Följande metodtips gäller för följande frågor som du kan skapa:

Skapa fokuserade, selektiva frågor

Definiera en mycket selektiv fråga genom att tillämpa alla filter som krävs för din fråga. Ju mer selektiv frågan är, desto mindre blir resultatuppsättningen. Ju mindre resultatuppsättningen är, desto mer riktad och selektiv är frågan.

Använda taggar för att kategorisera arbetsobjekt

Använd arbetsobjekttaggar för att kategorisera dina arbetsobjekt i stället för ett anpassat fält. Frågor som filtrerar på taggar fungerar vanligtvis snabbare jämfört med de frågor som filtrerar på strängmatchningar.

Till skillnad från anpassade fältmatchningar eller partiella matchningar kräver en fråga med en Tags Contains åtgärd inte en fullständig genomsökning av alla arbetsobjektstabeller.

Använd Contains words för strängmatchningar

Om du vill filtrera efter en strängmatchning använder du operatorn Contains WordsContains i stället för . Operatorn Contains Words kör en fulltextsökning i det angivna fältet, vilket tenderar att slutföras snabbare.

Operatorn Contains kör en tabellgenomsökning, vilket är en långsammare åtgärd än operatorn Contains Words . Det förbrukar också fler CPU-cykler. Dessa CPU-cykler kan orsaka att du stöter på hastighetsbegränsningar. Mer information finns i Takt- och användningsgränser.

Ange små grupper med operatorn In Group

Operatorn In Group filtrerar arbetsobjekt baserat på matchningar i en grupp med värden. Gruppen med värden motsvarar värdena i en grupp, säkerhetsgrupp eller arbetsspårningskategori. Du kan till exempel skapa en fråga för att hitta alla arbetsobjekt som har tilldelats alla medlemmar i ett team. Du kan också hitta alla arbetsobjekt som tillhör kravkategorin (Microsoft.RequirementCategory).

När du filtrerar på en grupp som innehåller ett stort antal medlemmar tenderar resultatuppsättningen att vara större och icke-selektiv. Om en grupp motsvarar en stor Microsoft Entra-grupp genererar frågan dessutom en ganska stor kostnad för att lösa den gruppen från Microsoft Entra-ID.

Undvik användning av negerade operatorer

Negerade operatorer, till exempel <>, Not In, Not Under, Not In Group, tenderar att generera icke-valda frågor och stora resultatuppsättningar.

Använd endast negerade operatorer vid behov. Försök alltid hitta alternativ först. Om till exempel Field1 har värdena A, B, C, D; specificera Field1 In A, B, C villkoret istället för det negaterade Field1 <> D villkoret.

Undvik strängjämförelser

Frågor som innehåller strängjämförelser genererar tabellgenomsökningar som är ineffektiva. I stället rekommenderar vi att du använder taggar eller ett specifikt anpassat fält som alternativ, särskilt när en fråga presterar dåligt.

Begränsa Or operatorer

Begränsa antalet Or operatorer som definierats i din fråga. Frågor körs mer effektivt när färre Or operatörer används. För många Or operatorer kan göra din sökfråga oselektiv. Om frågan körs långsamt ändrar du ordning på Or operatorsatsen överst i frågesatserna.

Spara din fråga

På grund av interna optimeringar tenderar sparade frågor att fungera bättre jämfört med osparade frågor. Spara alltid frågan när du planerar att återanvända den. Även för WIQL-frågor som körs via ett REST API ska du spara WIQL via webbportalen för att göra dina REST API-anrop, så att de är mindre känsliga för framtida prestandaregressioner.

Kör din sökfråga

Ibland behöver du köra frågan några gånger för att nå rätt optimeringsplan. Spara frågan och kör den upp till 10 gånger under en 30-minutersperiod. På så sätt kan systemet undersöka och söka efter den optimeringsplan som passar bäst för din fråga.

Relaterat innehåll

• Snabbreferens för frågor.
• Vanliga frågor och svar
• Diagram en flat-list-fråga
• Ändra kolumnalternativ
• Index för arbetsuppgiftsfält
• Kortkommandon