Megosztás a következőn keresztül:

Lekérdezés címek, azonosítók és rich-text mezők alapján az Azure Boardsban és az Azure DevOpsban

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Ha kulcsszó vagy kifejezés vagy null szöveges mező alapján szeretne munkaelemeket keresni, ezt megteheti egysoros szöveg (Sztring), többsoros szöveg (Egyszerű szöveg) és rich-text (HTML) mezők szűrésével. Ha úgy találja, hogy a lekérdezések túl sokáig tartnak az eredmények visszaadásához, olvassa el a Lekérdezés létrehozása/Ajánlott eljárások című témakört.

Támogatott operátorok és makrók

A szöveget vagy rich-text mezőt meghatározó lekérdezési záradékok az alábbi táblázatban felsorolt operátorokat és makrókat használhatják.

Adattípus

Támogatott operátorok és makrók

Rich-text (HTML)
Többsoros szöveges sztringek (Egyszerű szöveg)

Contains Words, Does Not Contain Words, Is Empty1, Is Not Empty1

Egy szöveg (sztring)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMakrók: [Any], a Munkaelem típusa mezővel és @Project2, a Csapatprojekt mezővel érvényes.

Azonosító

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was EverMakrók: @Follows, @MyRecentActivity, @RecentMentions@RecentProjectActivity az Azonosító mezővel és Not In In a 2. operátorral @Projectérvényes, a Csapatprojekt mezővel együtt.

Állapot- és munkaelemtípus-mezők

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], A "Nem, szerepel, a, csoportban nem, szerepel", a "Nem szerepel a csoportban **Macros**:, , " kifejezés mindkét mezőre érvényes.

Feljegyzés

  1. Az Is Empty Azure DevOps Server 2019 RC2 és Is Not Empty újabb verziói és az operátorok támogatottak
  2. A rendszer automatikusan az aktuális projekt alapján szűr. További információ: Lekérdezés több különböző projektből.

Karakterlánc-egyezések használata Contains words

Ha sztringegyezésre szeretne szűrni, próbálkozzon az operátorral ahelyett, hogy az Contains Words operátort Containshasználná. Az Contains Words operátor teljes szöveges keresést futtat a megadott mezőben, ami a legtöbb esetben gyorsabb. A szöveges sztring legfeljebb 100 karakter hosszúságú lehet.

Míg az Contains operátor táblavizsgálatot futtat, amely nem csak lassabb, hanem több processzorciklust is használ. Ezek a cpu-ciklusok hozzájárulnak az erőforrás-felhasználás sebességkorlátjához.

Feljegyzés

Az Contains Words operátor az SQL teljes szöveges keresési indexelését használja. Ha egy új értéket hosszú szöveges mezőbe ment, az SQL Server a következőt fogja tenni:

  • A kifejezés felosztása egyes szavakra
  • Távolítsa el azokat a gyakori szavakat, amelyek nem igazán adnak értéket a kereséshez (például "a" vagy "is" angol nyelven)
  • Konvertálja a szavakat a közös szárukra (például futás, futtatás és futó is "futtatás" lesz, mivel ezek mind az adott szó variációi)
  • Tárolja ezeket az egyedi kulcsszavakat egy indexben.

Amikor egy felhasználó ezután egy lekérdezést futtat ezen a mezőben az Contains Words operátor használatával, a keresés az indexben tárolt egyedi kulcsszavakon fog futni. A hosszú szöveges mezők esetében ez sokkal hatékonyabb és gyorsabb keresést tesz lehetővé, mint egy részszűkítő keresés. Alapértelmezés szerint az SQL az írásjelek közötti karakterkészletként definiálja a "szót". A pontok például egy szó végét jelölik, de az időszak nem tekinthető a szó részének. Mivel a teljes szöveges keresési index kulcsszavakat tartalmaz a pontos kifejezések helyett, az összes olyan találatot megkapja, amely ugyanazokat a kulcsszavakat tartalmazza, ahogyan azt az indexelés határozza meg.

Kulcsszó- vagy kifejezéskeresés helyettesítő karakterekkel

Szavakat tartalmaz vagy tartalmaz a beírt szavakkal vagy kifejezésekkel részben vagy teljesen egyező elemek felsorolására.

A kulcsszavak szűréséhez használható egyszerű lista lekérdezés szerkesztője.

Ha egy szó vagy kifejezés pontos vagy részleges egyezésére szeretne keresni, válassza a Tartalmaz vagy a Nem tartalmaz lehetőséget. A Szavakat tartalmazó vagy a Nem tartalmaz szavak lehetőséget választva pontos kifejezésre kereshet, vagy helyettesítő karaktert használhat, *. Ezek az operátorok a teljes szöveges keresési indexet használják.

Adja meg például a Szavak és az informatika* lehetőséget, hogy egy olyan szövegmezőre szűrjön, amely információt vagy információt vagy információt tartalmaz.

Használjon helyettesítő kártyát szavakkal.

Tipp.

A záradékok csoportosításának megismeréséhez AND/OR lásd : Felügyelt lekérdezések létrehozása és mentése, Csoportosítási záradékok. Ha meg szeretné tekinteni egy lekérdezés WIQL-szintaxisát, telepítse a WIQL lekérdezésszerkesztő bővítményt , amely lehetővé teszi bármely lekérdezésszerkesztő bejegyzés WIQL-verziójának megtekintését.

Adott szavak lekérdezése, nem pedig mások

A Szavak és a Nem tartalmaz szavak operátorokat használva listázhatja azokat az elemeket, amelyek pontosan egyeznek a beírt szavakkal vagy kifejezésekkel, és kizárhat más szavakat vagy kifejezéseket. Ezeket az operátorokat a helyettesítő karakterrel (*) együtt használhatja.

Az alábbi példában ezek az operátorok a munkafázist tartalmazó elemek munkaelemeit szűrik, a Phasor szót nem.

Képernyőkép a pontos szavak belefoglalására és kizárására Lekérdezésszerkesztő.

Nem definiált mezőérték-lekérdezések

A nem definiált mezőértékkel rendelkező munkaelemeket az egyenlőség operátorral = keresheti meg, és üresen hagyhatja a mező értékét. Az alábbi szűrők például felsorolják az összes olyan tevékenység típusú munkaelemet, amelynek tevékenységmezője üres.

Szűrés üres bejegyzések alapján

Ha nem üres mező alapján szeretné listázni a munkaelemeket, használja a nem operátort <> , és hagyja üresen az Értéket.

Üres vagy nem üres HTML-mező lekérdezései

Üres leírássalrendelkező munkaelemeket találhat. Az Üres vagy nem üres html mező használata támogatja az üres vagy nem üres rich text mezőkkel rendelkező munkaelemek felsorolását. Ezzel az operátorral nem adhat meg értéket.

Az alábbi lekérdezésszűrők például felsorolják az összes olyan munkaelemet, amely tartalmaz néhány Leírás mezőbejegyzést.

Szűrőalapú nem üres HTML-mezők

Speciális karakterek szűrése

Ha speciális karaktereket / -tartalmazó URL-címre vagy kifejezésre szeretne szűrni, használjon fordított perjelet ezeknek a karaktereknek a kiszűréséhez. Az alábbi példák bemutatják, hogyan szűrhet egy URL-címre és egy kötőjeles kifejezésre:

  • Url-cím szűrése: Keressen rá egy munkaelem címére, amely tartalmazza a kifejezést https://example.com/path-to-resource.

    • Lekérdezés: Title ~ "https:\/\/example.com\/path-to-resource"
    • Eredmények: A megadott mezőben szereplő pontos URL-címmel rendelkező összes munkaelemet visszaadja.

  • Szűrjön egy kötőjellel rendelkező kifejezést: Keressen rá egy munkaelem címére, amely tartalmazza "your-phrase-with-dash"a kötőjelet.

    • Lekérdezés: Title ~ "feature-update\-2023"
    • Eredmények: Az összes olyan munkaelemet adja vissza, amely a megadott mezőben kötőjelekkel ellátott pontos kifejezést tartalmaz.

Feljegyzés

Nem kérdezhet le olyan munkaelemeket, amelyekhez nincsenek címkék csatolva. A funkciókérés szavazásához tegye ezt a fejlesztői közösség oldalán, és keressen üres címkéket.

Kategóriaalapú lekérdezések

Ha a munkaelemeket az általuk használt kategória alapján szeretné szűrni, használja a Csoporton belüli operátort. Az alábbi szűrőfeltételek például az aktuális projektben lévő, a csapattaghoz rendelt és a hibakategóriához tartozó munkaelemeket adnak vissza.

Lekérdezési záradék a munkaelemek kategória szerinti kereséséhez

Milyen elemek jelennek meg a Követelmény vagy a Tevékenység kategóriában?

A munkaelem-típusok alapértelmezett hozzárendelései az egyes kategóriákhoz az alábbiak szerint jelennek meg az egyes folyamatokhoz.

Feldolgozás Követelménykategória Tevékenységkategória
Alap Probléma Task
Rugalmas Felhasználói szövegegység Task
Scrum Termék hátraléktétele, hiba Task
CMMI Követelmény Task

Minden csapat meghatározhatja, hogy a Hiba munkaelemtípus megjelenik-e a Követelmény vagy a Tevékenység kategóriában. Lásd: Hibák megjelenítése hátralékokon és táblákon. Egyéni munkaelem-típusokat is hozzáadhat a hátralékokhoz. További információ: Munkaelem-típus hozzáadása vagy módosítása, Egyéni WIT hozzáadása hátralékhoz vagy táblához.

Az Ön által követett munkaelemek lekérdezése

A @Follows makróval szűrheti a listákat a követett munkaelemek és más lekérdezési szűrők alapján.

Az alábbi lekérdezés például bemutatja, hogyan kérdezhet le minden projektet az ön által követett aktív munkaelemekről. Az Azonosító mezőt és az In operátort a @Follows makróval használhatja.

Lekérdezésszerkesztő azonosítóval @Follows lekérdezési záradékkal

Legutóbbi munkaelem-tevékenység lekérdezése

Az alábbi makrókkal a legutóbbi tevékenységek alapján listázhatja a munkaelemeket:

  • @MyRecentActivity: A legutóbb megtekintett vagy módosított elemek listázása.
  • @RecentMentions: Az elmúlt 30 napban @mention hozzáadott elemek listázása.
  • @RecentProjectActivity: Listázhatja a projektben nemrég létrehozott vagy módosított elemeket.

Adja meg az azonosító mezőt és a Be vagy a Nincs operátort .

Az alábbi lekérdezés például bemutatja, hogyan kérdezheti le a legutóbb megtekintett vagy módosított munkaelemeket.

Lekérdezésszerkesztő azonosítóval @MyRecentActivity lekérdezési záradékkal

Gyakori mezők a legtöbb munkaelem-típushoz

Az alábbi táblázat a lekérdezések szűréséhez használt gyakori mezőket ismerteti. Az azonosítómezők egyedileg azonosítják a listában szereplő munkaelemeket. A Cím mezővel megkülönböztethető a munkaelem az azonos típusú többi elemtől. A Leírás és más rich-text (adattípus=HTML) mezők további információkat tartalmaznak, amelyek szükségesek a munka megvalósításához és a változások nyomon követéséhez. A munkaelem létrehozása után az azonosító kivételével az összes mezőt módosíthatja. Munkaelem hozzáadásakor és mentésekor a rendszer hozzárendeli az azonosítót, és nem módosítható.

Feljegyzés

A rendszer automatikusan indexeli az összes hosszú szöveges mezőt egyszerű szöveg típusú és HTML-mezőkkel a teljes szöveges kereséshez. Ez magában foglalja a Cím, a Leírás és a Repro mezők lépéseit. A helyszíni Azure DevOpsra vonatkozó kiszolgálói és rendezési követelményekről további információt a Lekérdezés mezők, operátorok, értékek és változók – Teljes szöveges és részleges szókeresések című témakörben talál.

Mezőnév

Leírás

Munkaelem típusa

Elfogadási feltételek 1

A hiba- vagy termékháttérelem bezárása előtt teljesítendő feltételek leírása.

Mielőtt elkezdődik a munka egy hiba- vagy termékháttérelemen, az ügyfél-elfogadás feltételeit a lehető legérthetőbb módon kell leírni. A csapat és az ügyfelek közötti beszélgetések, amelyek meghatározzák az elfogadási feltételeket, biztosítják, hogy a csapat megértse az ügyfelek elvárásait. Az elfogadási kritériumok használhatók az elfogadási tesztek alapjául, hogy hatékonyabban értékelhesse ki, hogy egy elem megfelelően befejeződött-e.

Referencianév=Microsoft.VSTS.Common.AcceptanceCriteria, Data type=HTML

Bug, Epic, Feature, Product backlog item (Scrum)

Leírás 1, 2

Ezzel a mezővel részletes információkat adhat meg egy munkaelemről.

Hivatkozás neve=System.Description, Data type=HTML

Mind

ID (Azonosító)

A munkaelemhez rendelt egyedi azonosító. A munkaelem-azonosítók minden projektben és projektgyűjteményben egyediek.

Referencianév=System.Id, Adattípus=Egész szám

Mind

Ismétlési lépések (vagy reprodukálási lépések) 1

A váratlan viselkedés reprodukálásához szükséges lépések. Rögzítsen elegendő információt, hogy a csapat többi tagja megértse a probléma teljes hatását, és hogy kijavíthassák-e a hibát. Ez a bejegyzés a hiba és a várt viselkedés megkeresésére vagy reprodukálására tett műveleteket tartalmazza.
Referencianév=Microsoft.VSTS.TCM.ReproSteps, Data type=HTML

Hiba

Resolution (Osztás)

Egy akadály megoldásának módját ismerteti.

Hivatkozás neve=Microsoft.VSTS.Common.Resolution, Data type=HTML

Akadály (Scrum)

Rendszerinformáció1

A szoftver- és rendszerkonfigurációval kapcsolatos információk, amelyek a hiba, a kód áttekintése vagy a visszajelzés szempontjából relevánsak.

Hivatkozás neve=Microsoft.VSTS.TCM.SystemInfo, Data type=HTML

Hiba, kódellenőrzési kérelem, visszajelzési kérelem

Csapatprojekt

Az a projekt, amelyhez egy munkaelem tartozik. Ha egy vagy több projekt elemeire szeretné szűrni a listát, adja hozzá ezt a mezőt egy lekérdezéshez. További információ: Példa lekérdezések, projektek közötti lekérdezések.

Referencianév=System.TeamProject, Data type=String

Mind

Cím

Rövid leírás, amely összefoglalja a munkaelemet, és segít a csapattagoknak megkülönböztetni a listában szereplő többi munkaelemtől.

Hivatkozás neve=System.Title, Data type=String

Mind

Munkaelem típusa

A munkaelemtípus neve. A munkaelem-típusok a projekt létrehozásakor használt folyamat alapján vannak definiálva. További információ: A folyamatok és a folyamatsablonok , valamint a Munkaelem-típus hozzáadása vagy módosítása.

Ha a munkaelemeket a kategória-hozzárendelésük alapján szeretné szűrni, használhatja a Csoportban és a Nem csoport operátort, és kiválaszthat egy kategóriát a legördülő listából.

Referencianév=System.WorkItemType, Data type=String

Mind

Feljegyzés

A Team Foundation Server 2012-re való frissítéskor a Leírás mező a PlainText mezőtípusról HTML-re módosult. A witadmin changefield paranccsal visszaállíthatja a mező adattípusát. Lásd: Munkaelemmezők kezelése (witadmin).

REST API

A lekérdezésekkel való programozott interakcióhoz tekintse meg az alábbi REST API-erőforrások egyikét: