Megosztás:

Lekérdezés címek, azonosítók és rich-text mezők szerint

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

Munkaelemek szűrése kulcsszavak, azonosítók vagy üres szövegmezők alapján egysoros szöveg (Sztring), többsoros szöveg (Egyszerű szöveg) és rich-text (HTML) mezők használatával. Ha a lekérdezések visszatérése túl sokáig tart, olvassa el a Lekérdezés létrehozása, ajánlott eljárások című témakört.

Prerequisites

Category Requirements
Hozzáférési szintek – Megosztott lekérdezések megtekintése és futtatása: Projekt tagja.
– Megosztott lekérdezés hozzáadása és mentése: Legalább alapszintű hozzáférés.
Permissions Hozzájárulás engedély beállítása engedélyezése azon mappához, amelyhez lekérdezést szeretne hozzáadni. Alapértelmezés szerint a Közreműködők csoport nem rendelkezik ezzel az engedéllyel.

Note

A nyilvános projektekhez érintett hozzáféréssel rendelkező felhasználók ugyanúgy teljes hozzáféréssel rendelkeznek a lekérdezési funkciókhoz, mint a Alapszintű hozzáféréssel rendelkező felhasználók. További információ: Érdekelt felek hozzáférésének gyors útmutatója.

Category Requirements
Hozzáférési szintek – Megosztott lekérdezések megtekintése és futtatása: Projekt tagja.
– Megosztott lekérdezés hozzáadása és mentése: Legalább Egyszerű hozzáférés.
Permissions Hozzájárulás engedély beállítása engedélyezése azon mappához, amelyhez lekérdezést szeretne hozzáadni. Alapértelmezés szerint a Közreműködők csoport nem rendelkezik ezzel az engedéllyel.

Támogatott operátorok és makrók

Használja a szöveg- és rich-text mezőkben felsorolt operátorokat és makrókat.

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 Ever
Makrók: [Any]Munkaelem típusa mezővel érvényesek, @Project2 pedig a Csapatprojekt mezővel érvényes.

ID

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makrók: @Follows, @MyRecentActivity, @RecentMentions@RecentProjectActivity érvényes az azonosító mezővel és InNot In operátorokkal.
@Project 2, a Team Project mezővel érvényes.

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

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makrók: [Any] mindkét mezővel érvényes.

Note

  1. Az Is Empty és Is Not Empty operátorok támogatottak az Azure DevOps Server 2020 és újabb verzióiban.
  2. A rendszer alapértelmezés szerint 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, inkább a Contains Words operátort válassza, mint a Contains operátort. Contains Words a teljes szöveges indexet használja, és általában gyorsabb. A szöveges sztringek legfeljebb 100 karakter hosszúságúak.

Az Contains operátor táblavizsgálatot futtat; lassabb, és több CPU-erőforrást használ fel, ami hatással lehet a sebességkorlátokra.

Note

Az Contains Words operátor sql teljes szöveges keresési indexelést használ. Amikor egy új értéket hosszú szöveges mezőbe kerül mentésre az SQL Server esetén:

  • A kifejezést szavakra osztja
  • Eltávolítja a gyakori stop szavakat (például "a" vagy "is")
  • A szavakat közös szótövükre alakítja át (például futtatás → fut)
  • Az eredményként kapott kulcsszavakat egy indexben tárolja

Az indexet használó Contains Words lekérdezések gyorsabb eredményeket adnak a hosszú szöveges mezőkhöz. További információ és kiszolgáló/rendezési követelmények: Lekérdezésmezők, operátorok, értékek és változók – Teljes szöveges és részleges szókeresések.

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

Olyan elemek kereséséhez, amelyek részben vagy pontosan egyeznek a szavakkal vagy kifejezésekkel, használja a(z) Contains vagy Contains Words kifejezéseket.

Képernyőkép a kulcsszavak szűréséhez használt egylapos lekérdezés szerkesztőjével.

Válassza a Contains vagy a Does Not Contain lehetőséget a pontos vagy részleges egyezések kereséséhez. Válassza ki Contains Words vagy Does Not Contain Words a teljes szöveges index és a helyettesítő karakter * használatához.

Például a Contains Words és inform* egyeznek inform-vel, information-mal és informational-vel.

Képernyőkép, amely a

Tip

A záradékok csoportosításának megismeréséhez AND/OR tekintse meg a csoportosítási záradékokat. 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

Használja az Contains Words és Does Not Contain Words címkéket a konkrét szavak vagy kifejezések belefoglalására, és zárjon ki másokat. Egyesítse ezeket az operátorokat, és használja a * a helyettesítő karakterek illesztéséhez.

Az alábbi példa egy olyan szűrőt mutat be, amely tartalmazza a "Fázis" műveletet, de kizárja a "Phasor" értéket.

Képernyőkép a Lekérdezésszerkesztőről, beleértve és kizárva a pontos szavakat.

Note

Bizonyos fenntartott SQL-szavak, például WHERE, THEN és AND, nem adnak vissza találatokat, ha önálló keresési kifejezésként használják a következőkkel: Contains Words vagy Does Not Contain Words.

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

A nem definiált (üres) mezőértékkel rendelkező munkaelemeket az "egyenlőség" operátorral = keresheti meg, és hagyja üresen az értéket. Az alábbi szűrők például felsorolják az összes olyan tevékenységet, amelynek tevékenységmezője üres.

Képernyőkép egy olyan szűrőről, amelyben a Tevékenység érték üres.

Ha olyan elemeket szeretne keresni, amelyekben egy mező nem üres, használja a "nem" operátort <> , és hagyja üresen az Értéket.

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

HTML-mezővel használja a Is Empty vagy Is Not Empty tagokat, hogy listázza az üres vagy nem üres rich-text mezőkkel rendelkező munkaelemeket. Ezekhez az operátorokhoz nem ad meg értéket.

Képernyőkép a nem üres HTML-mezők szerinti szűrésről.

Speciális karakterek szűrése

Amikor URL-címeket vagy kifejezéseket szűr, a speciális karakterek, mint például a / vagy -, elől használjon perjelet (\).

  • Szűrés URL-címhez:

    • Lekérdezés: Title ~ "https:\/\/example.com\/path-to-resource"
    • Eredmények: A pontos URL-címmel rendelkező munkaelemeket adja vissza.

  • Szűrjön egy kötőjellel rendelkező kifejezésre:

    • Lekérdezés: Title ~ "feature-update\-2023"
    • Eredmények: Olyan munkaelemeket ad vissza, amelyek pontosan kötőjelekkel ellátott kifejezést tartalmaznak.

Note

Nem kérdezhet le olyan munkaelemeket, amelyekhez nincs címke csatolva. A funkciókérésre való szavazáshoz látogasson el a Fejlesztői Közösségbe: Lehessen üres címkékre keresni.

Kategóriaalapú lekérdezések

Kategória szerinti szűréshez használja az operátort In Group . Az alábbi példa a csapattaghoz és a Hiba kategóriában hozzárendelt aktuális projekt elemeit adja vissza.

Képernyőkép egy olyan záradékról, amely a munkaelemeket kategória szerint keresi meg.

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

Az egyes folyamatok alapértelmezett munkaelemtípus-hozzárendelései:

Process Követelménykategória Tevékenységkategória
Alapszintű Issue Task
Agile Felhasználói szövegegység Task
Scrum Termék hátraléktétele, hiba Task
CMMI Requirement Task

A csapatok kiválaszthatják, hogy a Hiba munkaelem típusa megjelenik-e a Követelmény vagy a Feladat kategóriában. Lásd: Hibák megjelenítése hátralékokon és táblákon. Ha egyéni munkaelemtípusokat szeretne hozzáadni egy teendőnaplóhoz, olvassa el a Munkaelem-típus hozzáadása vagy módosítása című témakört.

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

Ha szükséges, a @Follows makróval és az azonosító mezővel és az In operátorral listázhatja a követett munkaelemeket a projektek között.

Képernyőkép a Lekérdezésszerkesztőről @Follows lekérdezési záradék azonosítójával

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

Ezekkel a makrókkal listázhatja az elemeket a legutóbbi tevékenységek alapján:

  • @MyRecentActivity: A legutóbb megtekintett vagy módosított elemek.
  • @RecentMentions: Az elmúlt 30 napban az ön számára @mention tulajdonsággal rendelkező elemek.
  • @RecentProjectActivity: A projektben nemrég létrehozott vagy módosított elemek.

Használja az Azonosító mezőt a következővel In : vagy Not In.

Képernyőkép a Lekérdezésszerkesztőről, amely az ID In @MyRecentActivity makró lekérdezést mutatja

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

Ez a táblázat a lekérdezésekben használt gyakori mezőket ismerteti. Az azonosító egyedileg azonosít egy munkaelemet. A Cím használatával megkülönböztetheti az azonos típusú elemeket. A leírás és más rich-text mezők részletes megvalósítási információkat nyújtanak. A létrehozás után az azonosító kivételével az összes mezőt módosíthatja; a rendszer hozzárendeli az azonosítót a munkaelem létrehozásakor.

Note

A rendszer a hosszú szöveges típusú mezőket indexeli PlainText és HTML a teljes szöveges kereséshez, beleértve a Title, Description és Steps to Repro. A helyszíni Azure DevOpsra vonatkozó részletekért és kiszolgáló-/rendezési követelményekért lásd: Lekérdezésmezők, operátorok, értékek és változók – Teljes szöveges és részleges szókeresések.

Mezőnév

Description

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.

A munka megkezdése előtt jegyezze fel a világos elfogadási feltételeket, hogy a csapat és az ügyfelek megoszthassák elvárásaikat. Az elfogadási feltételek segítenek meghatározni az elfogadási teszteket, és ellenőrizni, hogy az elem elkészült-e.

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

Bug, Epic, Feature, Termék-várólistán szereplő elem (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

All

azonosító

A munkaelemhez rendelt egyedi azonosító. Az azonosítók a projektgyűjteményen belüli projektekben egyediek.

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

All

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 elég részletet, hogy mások reprodukálhassák és érvényesítsék a javításokat.

Referencianév=Microsoft.VSTS.TCM.ReproSteps, Data type=HTML

Bug

Resolution

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 hiba vagy visszajelzés szempontjából releváns szoftver- és rendszerkonfigurációval kapcsolatos információk.

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, amely a munkaelemet birtokolja. Adja hozzá ezt a mezőt egy lekérdezéshez, hogy egy vagy több projekt alapján szűrjön. Részletekért tekintse meg a Projektek közötti lekérdezés című témakört.

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

All

Title

Rövid leírás, amely összefoglalja a munkaelemet, és segít a csapattagoknak megkülönböztetni azt másoktól.

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

All

Munkaelem típusa

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

Kategória-hozzárendelés szerinti szűréshez használja az és In Group az Not In Group operátorokat, és válasszon ki egy kategóriát a legördülő listából.

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

All

Kapcsolódó tartalom

REST API

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

  • Last updated on