Munkaelem-lekérdezés definiálása

Azure DevOps Szolgáltatások | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Az Azure Boards munkaelem-lekérdezései az Ön által megadott szűrési feltételek alapján generálnak munkaelemek listáit. Mentheti ezeket a felügyelt lekérdezéseket, és megoszthatja őket másokkal.

Tipp.

A jelen cikk későbbi részében használhatja az MI-t a feladat elvégzéséhez, vagy tekintse meg a MI-támogatás engedélyezése az Azure DevOps MCP-kiszolgálóval, hogy elkezdhessen dolgozni rajta.

Lekérdezéseket létrehozhat a webportálról vagy egy támogatott ügyfélből, például Visual Studio Team Explorerből. A tömeges frissítések és kiegészítések támogatásához importálja vagy exportálja a lekérdezéseket az Excel vagy .csv fájlok használatával.

Tekintse meg a cikk későbbi részében javasolt ajánlott eljárásokat .

Előfeltételek

Kategória Követelmények
Projektcsapat tagja A projekthez tagként kell hozzáadni.
Hozzáférési szintek – Megosztott lekérdezések megtekintéséhez és futtatásához: Project tagnak kell lennie.
– Megosztott lekérdezés hozzáadásához és mentéséhez: Legalább alapszintű hozzáféréssel kell rendelkeznie.
Jogosultságok Győződjön meg arról, hogy a Közreműködés engedély be van állítva a lekérdezést hozzáadni kívánt mappához tartozó Engedélyezés értékre. Előfordulhat, hogy a szervezetnek manuálisan kell konfigurálnia a Közreműködők csoportot az engedély megadásához.

Feljegyzés

A megosztott lekérdezések mentéséhez elegendő hozzáférési szintre és Közreműködői engedélyre is szükség van. Az alapszintű hozzáférés nem elég.

Kategória Követelmények
Projektcsapat tagja A projekthez tagként kell hozzáadni.
Hozzáférési szintek – Megosztott lekérdezések megtekintéséhez és futtatásához: Project tagnak kell lennie.
– Megosztott lekérdezés hozzáadásához és mentéséhez: Legalább alapszintű hozzáféréssel kell rendelkeznie.
Jogosultságok Győződjön meg arról, hogy a Közreműködés engedély be van állítva a lekérdezést hozzáadni kívánt mappához tartozó Engedélyezés értékre. Előfordulhat, hogy a szervezetnek manuálisan kell konfigurálnia a Közreműködők csoportot az engedély megadásához.

Feljegyzés

A megosztott lekérdezések mentéséhez elegendő hozzáférési szintre és Közreműködői engedélyre is szükség van. Az alapszintű hozzáférés nem elég.

Lekérdezésszűrő kiválasztása

A Lekérdezésszerkesztőben válassza a szűrőt, hogy ugorjon a minta lekérdezéseket tartalmazó cikkre. A lekérdezési szűrőkkel együtt interaktívan alkalmazhat szűrőket a lekérdezési eredményekre.

Feljegyzés

A felügyelt lekérdezések nem támogatják a közelségi kereséseket, de a szemantikai keresések igen. A szemantikai keresések egyaránt támogatják a *? helyettesítő karaktereket, és több helyettesítő karaktert is használhat egynél több karakter egyeztetéséhez. További információ: Funkcionális munkaelem-keresés.

Jellemzők szűrése

Makrók

A Szűrő függvénnyel interaktívan szűrheti a lekérdezéseket.

Lekérdezések megnyitása

A webböngészőben (1) ellenőrizze, hogy a megfelelő projektet választotta-e, (2) válassza a Táblák lekérdezések >lehetőséget, majd (3) válassza az Összes lehetőséget.

Képernyőkép a lekérdezések oldaláról.

A Lekérdezések lap megnyílik a Kedvencek lapra, amely felsorolja a kedvencként beállított lekérdezéseket. A Mind lapra kattintva megtekintheti a projekthez definiált és megosztott lekérdezéseket.

Tipp.

A kedvencként kiválasztott lekérdezések megjelennek a Kedvencek lapon. A kedvenc lekérdezések és más objektumok is megjelennek a Projekt lapon. További információ: Személyes vagy csapatkedvencek beállítása.

A projektből válassza a Boards > Queries, majd válassza az Összes lehetőséget.

Képernyőkép a lekérdezések oldaláról.

A Lekérdezések lap megnyílik a Kedvencek lapra, amely felsorolja a kedvencként beállított lekérdezéseket. A Mind lapra kattintva megtekintheti a projekthez definiált és megosztott lekérdezéseket.

Tipp.

A kedvencként kiválasztott lekérdezések megjelennek a Kedvencek lapon. A kedvenc lekérdezések és más objektumok is megjelennek a Projekt lapon. További információ: Személyes vagy csapatkedvencek beállítása.

Lapos lista lekérdezés definiálása

Új lekérdezés indítása a webes portál Lekérdezések lapján vagy a Team Explorer Munkaelemek lapján.

  1. Válassza az Új>lekérdezés lehetőséget.

Képernyőkép új lekérdezés hozzáadásáról, új felületről.

A Lekérdezésszerkesztő a következő alapértelmezett beállításokkal jelenik meg: A munkaelemek listája, Munkaelem típusa=[Bármely] és State=[Bármely].

A Lekérdezésszerkesztő képernyőképe a kijelölt munkaelemek egyszerű listájával.

  1. Módosítsa az értékeket, adjon hozzá vagy távolítson el záradékokat, vagy módosítsa a lekérdezés típusát Munkaelemekre, közvetlen hivatkozásokra vagy munkaelemek fájára.
  1. Válassza az Új>lekérdezés lehetőséget.

Képernyőkép új lekérdezés hozzáadásáról, új felületről.

A Lekérdezésszerkesztő a következő alapértelmezett beállításokkal jelenik meg: A munkaelemek listája, Munkaelem típusa=[Bármely] és State=[Bármely].

A Lekérdezésszerkesztő képernyőképe a kijelölt munkaelemek egyszerű listájával.

  1. Módosítsa az értékeket, adjon hozzá vagy távolítson el záradékokat, vagy módosítsa a lekérdezés típusát Munkaelemekre, közvetlen hivatkozásokra vagy munkaelemek fájára.

Lekérdezés projektek között vagy projekteken belül

Az új lekérdezések alapértelmezés szerint az aktuális projektre vonatkoznak. Létrehozhat azonban lekérdezéseket a szervezeten vagy projektgyűjteményen belül definiált munkaelemek megkereséséhez. A mentett lekérdezések azonban egy adott projekt alá kerülnek.

Ha két vagy több projektben definiált munkaelemeket szeretne listázni, válassza a Projektek közötti Lekérdezés lehetőséget. Az alábbi lekérdezés például az összes projektben az elmúlt 30 napban létrehozott összes funkciót megkeresi.

Képernyőkép a projektválaszték közötti lekérdezésről.

A Lekérdezésszerkesztő képernyőképe az ellenőrzött projektek lekérdezésével.

Feljegyzés

  • Több projektnevet különít el az ügyfélszámítógép területi beállításai által meghatározott listaelválasztóval, például vesszővel ,.
  • Ha az "Állapot" mezőt több projekt lekérdezésében használja, a megjelenített értékek az alapértelmezett projektben meghatározott elemekre korlátozódnak. Ha projekteket kérdez le, előfordulhat, hogy nem minden projekt összes lehetséges állapotértékét látja, csak az alapértelmezett projekt értékeit. Ha például három projektje van – az A projekt, a B projekt és a C projekt –, és csak az A projekt rendelkezik "Áttekintés" nevű állapotmal, míg a B és a C projekt különböző állapotokkal rendelkezik, a lekérdezés csak az A projektben meghatározott állapotokat jeleníti meg.

Ha több projektben hoz létre lekérdezéseket, a Mezők legördülő menü mezőinek rendelkezésre állása attól függ, hogy engedélyezve van-e a Projektek közötti lekérdezés beállítás. Tartsa szem előtt a következő főbb viselkedéseket:

  • A Csapatprojekt mező csak akkor válik elérhetővé, ha a Lekérdezés a projektek között lehetőséget választja.
  • Ha a Projektek közötti lekérdezés lehetőséget választja, a gyűjtemény összes projektjében definiált összes munkaelem-típus összes mezője megjelenik a Mező legördülő menüben.
  • Ha törli a projektek közötti lekérdezést, csak az aktuális projektben definiált munkaelem-típusok mezői jelennek meg a Mező legördülő menüben.

Ha a Projektek lekérdezése lehetőséget választja, hozzáadhatja a Csapatprojekt mezőt, hogy a kiválasztott számú projektre szűrjön.

A Lekérdezésszerkesztő képernyőképe a Team Projecttel és más mezőkkel a szűrőben.

A Lekérdezésszerkesztő képernyőképe a Team Projecttel és más mezőkkel a szűrőben.

Záradék definiálása

Lekérdezés létrehozásához definiáljon egy vagy több záradékot. Az egyes záradékok egyetlen mező szűrőfeltételeit határozzák meg.

Minta lekérdezési záradék

És/vagy Mező Operátor Érték
És Hozzá van rendelve = @Me

A mezőadat-típuson alapuló elérhető operátorok listáját a lekérdezésindex gyorshivatkozásában találja.

Adja hozzá az összes feltételt And állításként. Válassza a Vagy lehetőséget a csoportosítás módosításához. Csoportosítsa a záradékokat, hogy a záradék-utasítások a szükséges sorrendben fussanak.

Válassza az Új záradék hozzáadása lehetőséget, hogy egy újabb záradékot adjon a lekérdezés végéhez, majd válassza ki a Mező, Operátor, és Érték elemeket az adott záradékhoz.

Lekérdezésszerkesztő képernyőképe, amely bemutatja, hogyan adhatunk hozzá egy záradékot.

Lekérdezésszerkesztő képernyőképe, amely bemutatja, hogyan adhatunk hozzá egy záradékot.

Keresse meg például az Önhöz rendelt összes munkaelemet a Hozzárendelt mező, az egyenlő (=) operátor és a @Me makró megadásával, amely a felhasználói identitást jelöli.

Tipp.

A lekérdezés WIQL-szintaxisának megtekintéséhez és a záradékok csoportosításához használt zárójelek megtekintéséhez telepítse a Marketplace Wiql-szerkesztőt. Ez a bővítmény támogatja a WIQL-szintaxis megtekintését és egy WIQL-fájlba való exportálását a REST API-hívásokhoz való használatra. További információ: Szintaxis a munkaelem lekérdezési nyelvéhez (WIQL).

Ellenőrzőlista lekérdezési záradék meghatározásához

  1. Az első üres sorban, a Mező oszlopfejléc alatt kattintson a lefelé mutató nyílra az elérhető mezők listájának megjelenítéséhez, és válasszon egy elemet a listában. További információ: Lekérdezésmezők és értékek.

  2. Ugyanabban a sorban, az Operátor oszlopfejléc alatt válassza a lefelé mutató nyilat az elérhető operátorok listájának megjelenítéséhez, majd válasszon ki egy elemet a listában. További információ: Operátorok.

  3. Ugyanabban a sorban, az Érték oszlopfejléc alatt adjon meg egy értéket, vagy jelölje ki a lefelé mutató nyílbillentyűt, majd válasszon ki egy elemet a listában. Ha többet szeretne tudni arról, hogyan használhat makrót vagy változót az aktuális projekt, felhasználó, dátum vagy egyéb kijelölés megadásához, olvassa el a Változók című témakört.

  4. Záradék hozzáadásához válassza az Új záradék hozzáadása lehetőséget.

    Hozzáadhat egy záradékot a lekérdezés végéhez, vagy végrehajthatja a következő feladatokat a megfelelő ikonokkal:

    • Új szűrővonal beszúrása
    • A szűrővonal eltávolítása
    • Kijelölt záradékok csoportosítása
    • Csoportbontási záradékok

Munkaelemfa használata a hierarchiák megtekintéséhez

A Munkaelemek fa lekérdezésével megtekintheti a munkaelemek többrétegű, beágyazott listáját. Megtekintheti például az összes hátralékelemet és azok csatolt tevékenységeit. Ha a fa különböző részeire szeretne összpontosítani, válassza az Összes kibontása vagy az Összes összecsukása lehetőséget.

Feljegyzés

Nem hozhat létre olyan lekérdezést, amely hierarchikus nézetet jelenít meg a tesztcsomagokról, a tesztcsomagokról és a tesztelési esetekről. Ezek az elemek nem kapcsolódnak egymáshoz szülő-gyermek kapcsolattípusokkal. Létrehozhat azonban egy közvetlen csatolású lekérdezést, amely felsorolja a teszttel kapcsolatos munkaelemeket. A hierarchiát a Teszttervek lapon is megtekintheti.

Képernyőkép a lekérdezés eredménylistájáról, amelyen egy fa típusú lekérdezés látható.

Adja meg a szülő- és gyermekmunkatételek szűrési kritériumait. Csatolt gyermekek kereséséhez először válassza a Legfelső szintű munkaelemek egyeztetése lehetőséget. Csatolt szülők kereséséhez válassza először a Csatolt munkaelemek egyeztetése lehetőséget.

A munkaelemek fájának Lekérdezésszerkesztő nézetének képernyőképe

A Munkaelemek és Közvetlen hivatkozások lekérdezés használatával nyomon követheti az egyéb nyomon követett munkáktól, például tevékenységektől, hibáktól, problémáktól vagy funkcióktól függő munkaelemeket. Megtekintheti például azokat a hátralékelemeket, amelyek más implementálási vagy hibajavítási hibáktól függenek.

A közvetlen hivatkozások lekérdezésével nyomon követheti a csoportok közötti függőségeket. A lekérdezés segít a csapat által vállalt kötelezettségek kezelésében is. Válassza ki a legfőbb és a kapcsolódó munkaelemek szűrési kritériumait. A függőségek szűréséhez válassza ki a hivatkozások típusait.

Képernyőkép a közvetlen hivatkozások lekérdezési eredményeiről.

Képernyőkép a(z) Lekérdezésszerkesztőről, Közvetlen Hivatkozások Lekérdezés.

Szűrje az első szintű munkaelemek listáját az alábbi lehetőségek egyikének kiválasztásával:

  • Csak egyező hivatkozásokkal rendelkező elemeket ad vissza: Első szintű munkaelemeket ad vissza, de csak akkor, ha a csatolt munkaelemek szűrőfeltételei által megadott munkaelemekre mutató hivatkozásokat tartalmaznak.
  • Az összes legfelső szintű elem visszaadása: A csatolt munkaelemek szűrőfeltételei ellenére az összes első szintű munkaelemet visszaadja. Az első szinthez csatolt második szintű munkaelemeket adja vissza, ha azok megfelelnek a csatolt munkaelemek szűrőfeltételeinek.
  • Csak olyan elemeket ad vissza, amelyek nem rendelkeznek egyező hivatkozásokkal: Első szintű munkaelemeket ad vissza, de csak akkor, ha nem rendelkeznek a csatolt munkaelemek szűrőfeltételei által megadott munkaelemekre mutató hivatkozásokkal.

Az egyes hivatkozástípusokról további információt a Hivatkozástípus hivatkozásában talál.

És/vagy logikai kifejezés használata

Adja meg a And vagy Or jelölést a lekérdezési záradékok logikai kifejezéseinek létrehozásához. Az And aktuális záradékban és az előző záradékban szereplő feltételeknek megfelelő munkaelemeket is megkeresheti. Olyan munkaelemek megkeresésére használható Or , amelyek megfelelnek az aktuális vagy az előző záradék feltételének.

Adjon hozzá egy új záradékot minden munkaelem-mezőhöz a keresési feltételek pontosításához. Csak a kívánt munkaelemek visszaadásához adjon hozzá feltételeket. Ha nem kapja meg a lekérdezéstől várt eredményeket, finomítsa azt. A lekérdezési eredmények javítása érdekében hozzáadhat, eltávolíthat, csoportosíthat vagy megszüntethet lekérdezési záradékokat.

Csoportosítsa a lekérdezési záradékokat, hogy a lekérdezés többi részétől különálló egységként működjenek. A csoportosítási záradékok hasonlóak ahhoz, ha zárójeleket helyeznek el egy kifejezés körül egy matematikai egyenletben vagy logikai utasításban. A záradékok csoportosításakor a AndOr csoport első záradéka az egész csoportra vonatkozik.

Csoportosítási feltételek

A csoportosított záradékok a lekérdezés többi részétől különálló egységként működnek. A csoportosítási záradékok hasonlóak ahhoz, hogy zárójeleket helyezzenek egy matematikai egyenlet vagy logikai kifejezés köré. Az And vagy Or operátor az első záradékra vonatkozóan az egész csoportra érvényes.

Ahogy az alábbi példák is mutatják, a csoportosított záradékok a megfelelő logikai kifejezésre fordíthatók.

Lekérdezés Csoportosított záradékok Logikai kifejezés
1 A csoportfeltétel-lekérdezés képernyőképe. A Munkaelem típusú mezőhöz és az Állapot vagy a Hozzárendelt mezőhöz szűrők vannak beállítva. Logikai kifejezés képernyőképe. Az AND operátor a Munkaelem típust, az Állapotot és a Hozzárendelve mezőket csoportosítja. Egy VAGY operátor csoportosítja az Állapotot és a Hozzárendelve mezőket.
2 A csoportfeltétel-lekérdezést ábrázoló képernyőkép, amelyen a Munkaelem típusú mező és az Állapot mező vagy a Hozzárendelt mező szűrői láthatók. Logikai kifejezés képernyőképe. Az AND operátor a Munkaelemtípust az Állapot vagy a Hozzárendelt mezőkkel csoportosítja, amelyek OR operátorral vannak csoportosítva.
3 A csoportfeltétel-lekérdezés képernyőképe. A szűrők be vannak állítva a Munkaelem típusa mezőhöz, vagy az Állapot és a Hozzárendelt mezőhöz is. Logikai kifejezés képernyőképe. Az OR operátor a Munkaelemtípust az Állapot és a Hozzárendelt mezőkhöz is csatolja, amelyeket egy AND operátor kapcsol össze.

Ezek a lekérdezések hiba típusú munkaelemeket adnak vissza, és megfelelnek a következő logikai kifejezéseknek:

  • 1. lekérdezés: AND State=Active OR Assigned to @Me
  • 2. lekérdezés: AND (State=Active OR Assigned to @Me)
  • 3. lekérdezés: OR (State=Active AND Assigned to @Me)

Egy vagy több záradék csoportosításához jelölje ki őket, majd válassza a csoport záradékok ikonját.

A webportál képernyőképe, Lekérdezésszerkesztő, Csoportosított lekérdezési záradékok.

Több csoportosított záradékot is csoportosíthat. Jelölje be az egyes záradékok jelölőnégyzetét. Ezután válassza a csoport záradékainak ikonját.

Webportál képernyőképe, Lekérdezésszerkesztő, Több lekérdezési záradék csoportosítása.

Ha a lekérdezés eredményei nem a várt eredményeket adják vissza, próbálkozzon a következő lépésekkel:

  • Győződjön meg arról, hogy minden záradék a kívánt módon van definiálva.
  • Ellenőrizze And/Or az egyes záradékokhoz tartozó hozzárendeléseket. Ha az eredmények a vártnál több munkaelemet tartalmaznak, gyakran egy Or záradék van jelen egy And záradék helyett.
  • Határozza meg, hogy csoportosítania vagy módosítania kell-e a lekérdezési záradékok csoportosítását és az And/Or egyes csoportosított záradékok hozzárendeléseit.
  • Adjon hozzá további lekérdezési záradékokat a lekérdezésszűrő feltételeinek finomításához.
  • Tekintse át a mezők, operátorok és értékek megadásához elérhető beállításokat.
  • Tekintse meg a cikk későbbi részében ismertetett ajánlott eljárásokat.

Tagmondat csoportosításának feloldása

A záradékok csoportosításának feloldásához válassza a csoportosítás feloldásának ikonját a csoportosított záradékokhoz.

Alapértelmezett oszlopszélesség beállítása a lekérdezési eredményekben

A lekérdezési eredmények alapértelmezett oszlopszélességének beállításához kövesse az alábbi lépéseket:

  1. Nyissa meg a módosítani kívánt lekérdezést.
  2. Az oszlopfejlécek széleinek húzásával manuálisan állítsa be az oszlopszélességeket a kívánt méretre.
  3. Ha új lekérdezésként szeretné menteni, válassza a Mentés vagy a Mentés másként lehetőséget.
  4. Zárja be és nyissa meg újra a lekérdezést, hogy az oszlopszélességek megmaradjanak.

Azure DevOps jelenleg nem támogatja az összes munkamenetben megmaradó alapértelmezett oszlopszélesség beállítását. Az oszlopszélességeket lekérdezésenként menti a rendszer, ezért egyenként kell módosítania és mentenie őket az egyes lekérdezésekhez.

Lekérdezési eredmények megtekintése irányítópulton

Az alábbi két widget megjeleníti a lekérdezés eredményeit. A munkaelemeket közvetlenül ezekből a vezérlőkből nyithatja meg.

  • Hozzám rendelt munka: A bejelentkezett felhasználóhoz rendelt összes javasolt vagy aktív munkaelem listája. Az Azonosító, az Állapot és a Cím mezőket sorolja fel.
  • Lekérdezési eredmények widgete: Egy lapos, fa vagy közvetlen csatolású lekérdezés eredményeit jeleníti meg. Konfigurálhatja a widgeten keresztül megjelenített mezőket, átméretezheti az oszlopmezőket, kibonthatja és összecsukhatja a fa- és közvetlen csatolású lekérdezéseket.

További információ: Widgetek hozzáadása irányítópulthoz.

Lekérdezési eredmények widgetének megtekintése szülőcímekkel

A szülőcímmel rendelkező lekérdezés eredményeinek megtekintéséhez hajtsa végre a következő lépéseket:

  1. Hozzon létre egy lekérdezést, amely szűri a fontos munkaelemeket. A lekérdezés lehet egy lapos lista, fa vagy közvetlen linkek lekérdezése.
  2. Adja hozzá a Szülő mezőt oszlopként. Bár felveheti a Szülő mezőt, az alapértelmezett viselkedés csak a szülő munkaelem azonosítóját jelenítheti meg. Annak érdekében, hogy a név az azonosító mellett jelenjen meg, kombinálja a Munkaelem típusa és a Szülő mezőket a lekérdezési struktúra Cím mezőjével.
  3. Mentse a lekérdezést megosztott lekérdezésként vagy csoportkedvenceként.
  4. Adja hozzá a Lekérdezés eredménye widgetet az irányítópulthoz, és konfigurálja a lekérdezést. Győződjön meg arról, hogy a Szülő mező megjelenítésre van beállítva.

Az alábbi képen egy lekérdezési eredmények widget látható, amely megjeleníti a Szülő mezőt.

Képernyőkép a lekérdezési eredmények vezérlőről, amelyen egy Szülő oszlop mező látható.

Lekérdezési hivatkozások a Munkaelem-lekérdezési nyelvet (WIQL) használják, amely hasonlít a Transact-SQL-hez. További információ: Szintaxis a munkaelem lekérdezési nyelvéhez (WIQL).

Feljegyzés

A legtöbb böngésző 2000 és 2083 karakter közötti korlátot kényszerít ki egy URL-sztringre.

Kódolja az URL-szintaxis WIQL-részét. Az URL-cím kódolásához bármilyen URL-kódoló eszközt használhat.

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

Az alábbi hivatkozás például a Fabrikam-szervezet FabrikamFiber/webterület elérési útján definiált összes aktív hiba azonosítóját és címét sorolja fel.

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'

A dekódolt WIQL a következőnek felel meg:

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

Feljegyzés

A WIQL hossza nem haladhatja meg a 32 K karaktert Azure Boards lekérdezéseknél.

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

Az alábbi hivatkozás például a FabrikamFiber/Webterület elérési útján található összes hiba azonosítóját, címét és állapotát sorolja fel.

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

Lásd például a következő nem kódolt bejegyzést.

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'

Ajánlott eljárások

A létrehozható lekérdezésekre az alábbi ajánlott eljárások vonatkoznak:

Szűrt, szelektív lekérdezések létrehozása

Definiáljon egy rendkívül szelektív lekérdezést az összes szükséges szűrő alkalmazásával. Minél szelektívebb a lekérdezés, annál kisebb az eredményhalmaz. A kisebb eredményhalmaz azt jelenti, hogy a lekérdezés célzottabb és szelektívebb.

Munkaelemek kategorizálása címkék használatával

Munkaelemcímkék használatával kategorizálhatja a munkaelemeket egyéni mező használata helyett. A címkékre szűrő lekérdezések általában gyorsabban hajthatók végre, mint azok a lekérdezések, amelyek karakterlánc egyezésekre szűrnek.

Az egyéni mező egyezéseivel vagy részleges egyezéseivel ellentétben a Tags Contains művelettel rendelkező lekérdezések esetében nem szükséges az összes munkaelem-tábla teljes vizsgálata.

Használjon Contains words a karakterlánc-egyezésekhez

Ha karakterlánc-egyezésre szeretne szűrni, használja az Contains Words operátort az Contains operátor helyett. Az Contains Words operátor egy teljes szöveges keresést futtat a megadott mezőben, amely általában gyorsabban fejeződik be.

Az Contains operátor táblavizsgálatot futtat, amely lassabb művelet, mint az Contains Words operátor. Emellett több processzorciklust is használ. Ezek a processzorciklusok sebességkorlátozásokat okozhatnak. További információ: Sebesség és használati korlátok.

Kis csoportok megadása az In Group operátorral

Az In Group operátor egy értékcsoporton belüli egyezések alapján szűri a munkaelemeket. Az értékcsoport egy csapat, biztonsági csoport vagy munkakövetési kategória értékeinek felel meg. Létrehozhat például egy lekérdezést, amellyel megkeresheti a csapat bármely tagjának hozzárendelt összes munkaelemet. Vagy keresse meg az összes olyan munkaelemet, amely a követelmények kategóriájához (Microsoft.RequirementCategory) tartozik.

Ha nagy számú tagot tartalmazó csoportra szűr, az eredményhalmaz általában nagyobb és nem szelektív. Ha egy csoport egy nagy Microsoft Entra csoportnak felel meg, a lekérdezés meglehetősen nagy költséggel jár a csoport Microsoft Entra ID való feloldásához.

Kerülje a tagadott operátorok használatát

A nem kijelölt operátorok – például <>, Not In, Not Under, Not In Group– általában nem szelektív lekérdezéseket és nagy eredményhalmazokat hoznak létre.

Csak akkor használjon negált operátorokat, ha szükséges. Mindig próbáljon meg alternatívákat keresni. Ha például az 1 . mező értéke A, B, C, D; akkor a Field1 In A, B, C záradékot adja meg a nem hivatkozott Field1 <> D záradék helyett.

Sztring-összehasonlítások elkerülése

A sztring-összehasonlításokat tartalmazó lekérdezések olyan táblavizsgálatokat hoznak létre, amelyek eredendően nem hatékonyak. Ehelyett használjon címkéket vagy egy adott egyéni mezőt alternatívaként, különösen akkor, ha egy lekérdezés rosszul teljesít.

Operátorok korlátozása Or

Korlátozza a lekérdezésben definiált operátorok számát Or . Kevesebb operátor használata esetén Or a lekérdezések jobban futnak. A túl sok Or operátor csökkentheti a lekérdezésed szelektivitását. Ha a lekérdezés lassan fut, rendezze újra az Or operátor záradékot a lekérdezési záradékok tetejére.

A lekérdezés mentése

A belső optimalizálások miatt a mentett lekérdezések általában jobban teljesítenek a nem mentett lekérdezésekkel szemben. Mindig mentse a lekérdezést, amikor újra használni szeretné. Még akkor is, ha a WIQL-lekérdezések REST API-n keresztül futnak, mentse a WIQL-t a webes portálon a REST API-hívások indításához, így kevésbé lesznek hajlamosak a jövőbeli teljesítményregressziókra.

A lekérdezés futtatása

Néha néhányszor le kell futtatnia a lekérdezést a megfelelő optimalizálási terv eléréséhez. Mentse a lekérdezést, és 30 perc alatt akár tízszer is futtassa. Így a rendszer megvizsgálhatja és megkeresheti a lekérdezéshez legmegfelelőbb optimalizálási tervet.

Munkaelem-lekérdezések definiálása AI használatával

Ha konfigurálja a Azure DevOps MCP-kiszolgálót, a szükséges lekérdezést természetes nyelven is leírhatja ahelyett, hogy manuálisan kellene záradékokat építenie a Lekérdezésszerkesztő.

Feladatok Példakérés
Elemek keresése állapot és hozzárendelés szerint List all active bugs assigned to <me> in project <Contoso>
Lekérdezés iterációk között Show user stories completed in the last three sprints for <Contoso>
Fa lekérdezés létrehozása Get all tasks that are children of features in area path <Contoso\\Web>
Legutóbb frissített elemek keresése Show work items changed in the last 7 days that are tagged "performance" in <Contoso>
Többfeltételes lekérdezés Find active bugs in <Contoso> with priority 1, severity 2 or higher, and no one assigned
WIQL létrehozása Write a WIQL query that returns all user stories in the current iteration for <Contoso> with story points between 3 and 8
Lekérdezési eredmények összegzése Run a query for all active work items in <Contoso> and give me a breakdown by type, state, and area path
Egy ugrásos lekérdezés létrehozása Show all bugs in <Contoso> along with their related work items
Trend lekérdezés létrehozása Show bugs created per week for the last 8 weeks in <Contoso> grouped by area path
Lekérdezés tagadással List active user stories in <Contoso> that are not tagged "tech-debt" and not in area path <Contoso\\Maintenance>

Feljegyzés

Ha Visual Studio Code használ, agent mód különösen hasznos összetett lekérdezések létrehozásához.

Kapcsolódó tartalom

  • Last updated on