Mezők, operátorok és makrók lekérdezése az Azure Boardsban

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

Itt részletes leírást talál az egyes mezőadattípusokról, lekérdezési operátorokról és lekérdezési makrókról. Egyes adattípusok, operátorok és makrók csak a megadott Azure DevOps-verzióra érvényesek.

Az egyes adattípusokhoz támogatott lekérdezési feladatokról, operátorokról és makrókról a Lekérdezés gyorshivatkozás című témakörben olvashat. Lásd még : Lekérdezés létrehozása/Ajánlott eljárások.

Lekérdezésmező adattípusai és értékei

A mezőhöz megadott értéknek meg kell felelnie az adott mező adattípusának. Az alábbi táblázat a támogatott adattípusokat sorolja fel:

Feljegyzés

Az Azure Boards felhőszolgáltatás esetében az adattípus megfelel a Folyamatmezők>lapon szereplő mezőnek. Helyszíni üzemelő példányok esetén az adattípus egy definícióhoz rendelt attribútumnakFIELDfelel megtype. További információ: Munkaelemmezők és mezőattribútumok.

Adattípus

Leírás

Logikai

Olyan mezőt ad meg, amely igaz/hamis értéket vesz fel.

DateTime vagy Date/Time

Dátummező, amelyben megadhat egy változót, például @Today vagy @Today-1, vagy egy értéket, például 2023.01.01. Adja meg a dátumokat a személyes profilhoz beállított dátummintában. (Lásd: Személyes beállítások megadása a részletekhez.) A lekérdezési példákért lásd: Query by date or @CurrentIteration.

WIQL-lekérdezések esetén a dátumot az egyezményes világidő (UTC) mintájában is megadhatja. További információ: Szintaxis a munkaelem lekérdezési nyelvéhez (WIQL).

Dupla vagy decimális

Valós szám, például 0,2 vagy 3,5. A lekérdezési példákért tekintse meg a Lekérdezés numerikus mezők szerint című témakört.

GUID

Egyedi azonosítót jelképező karaktersztring.

Előzmények

Egyéni formázott mező, amely az előzményadatok nyomon követésére szolgál. Ez az adattípus csak az Előzmények mező támogatására szolgál. Ezt a mezőt a rendszer automatikusan indexeli a teljes szöveges kereséshez, ha teljes szöveges keresés érhető el. Lásd a cikk későbbi részében ismertetett teljes szöveges és részleges szókereséseket . A lekérdezési példákért tekintse meg az Előzmények és a naplózás című témakört.

HTML

Formázott leírásokat támogató szöveges sztringek, például a Leírás vagy a Repro Steps mezők. Ezek a mezők automatikusan indexelve lesznek a teljes szöveges kereséshez, ha teljes szöveges keresés érhető el. Lásd a cikk későbbi részében ismertetett teljes szöveges és részleges szókereséseket . A rich-text mezők lekérdezéséhez lásd : Lekérdezés címek, azonosítók és rich-text mezők szerint.

Identitás

Egy felhasználói identitást azonosító rövid szöveges sztring.

Egész

Aláírt 32 bites egész szám, például 0, 1, 2, 34.

Egyszerű szöveg vagy szöveg mező (többsoros)

A hosszú leírásokat támogató szöveges sztringek, például az Alkalmazásindítási információ mező. Ezek a mezők automatikusan indexelve lesznek a teljes szöveges kereséshez, ha teljes szöveges keresés érhető el. Lásd a cikk későbbi részében ismertetett teljes szöveges és részleges szókereséseket . Egyszerű szöveges mezők lekérdezéséhez lásd : Lekérdezés cím, azonosító és rich-text mező alapján.

picklistDouble¹

Az egyéni mező úgy van definiálva, hogy a decimális értékek kiválasztólistáját tartalmazza.

picklistInteger¹

Egyéni mező, amely az egész szám értékeinek kiválasztólistáját tartalmazza.

picklistString¹

Olyan egyéni mező, amely rövid szöveges sztringek (255 karakter vagy annál kisebb) értékeket tartalmaz.

Sztring vagy Szöveg mező (egysoros)

Legfeljebb 255 Unicode-karaktert tartalmazó rövid szöveges sztring. A sztringszöveg-mezőket gyakran használják a picklisták vagy legördülő menük támogatására.

TreePath

Elágaztatási faszerkezet, például területút vagy iterációs útvonal. Válasszon egy elemet az érvényes értékek listájából. Keresse meg azokat a munkaelemeket, amelyek egyenlők, nem egyenlőek, nem egy faszerkezet alatt vagy sem, vagy használja a Be vagy a Nincs operátort több érték megadásához. Meg kell határoznia egy projekt fastruktúráját – területútvonalakat és iterációs útvonalakat –, majd kiválaszthatja azokat, amelyeket egy csapathoz szeretne társítani.

A lekérdezések készítésével kapcsolatos további információkért tekintse meg a Lekérdezés terület vagy iterációs útvonal vagy Lekérdezés dátum vagy aktuális iteráció szerint című témakört.

Feljegyzés

1. A picklist... adattípusok csak öröklött folyamathoz definiált egyéni mezőkhöz vannak hozzárendelve. Az örökölt folyamatmodell csak az Azure DevOps Services és az Azure DevOps Server 2019 esetében támogatott.

Dátum- és időminta

A DateTime mezőkhöz megadott dátum- és időmintának meg kell egyeznie azzal, amelyet a profilon keresztül választ ki. A kijelölés megtekintéséhez vagy módosításához tekintse meg az Idő és a Területi beállítás felhasználói beállításainak megadása című témakört.

Lekérdezési operátorok

Az alábbi táblázatban lekérdezési operátorok használatával adhatja meg, hogy a záradék egyes értékeinek hogyan kell kapcsolódniuk a munkaelem megfelelő értékéhez. A munkaelemmezőkhöz rendelt adattípussal kapcsolatos információkért lásd : Munkaelem mezőhivatkozása.

A záradékok hozzáadásáról és az And/Or operátorok használatáról a Lekérdezés definiálása című témakörben olvashat.

Lekérdezési operátor

Munkaelemeket ad vissza, ha a munkaelem értéke megfelel a felsorolt feltételeknek

Alkalmazható adattípusok

=

Megegyezik a záradékban szereplő értékkel.

Szám – amely magában foglalja a dupla, GUID, egész szám és sztring, DateTime és TreePath értéket

<>

Nem egyezik a záradékban szereplő értékkel.

Szám, Sztring, DateTime és TreePath

>

Nagyobb, mint a záradék értéke.

Szám, Sztring és DateTime

<

Kisebb, mint a záradék értéke.

Szám, Sztring és DateTime

>=

Nagyobb vagy egyenlő a záradékban szereplő értékkel.

Szám, Sztring és DateTime

<=

Kisebb vagy egyenlő a záradékban szereplő értékkel.

Szám, Sztring és DateTime

=[Mező]

Megegyezik a megadott mezőben található értékkel.

A megadott mezővel azonos adattípusú mező neve

<>[Mező]

Nem egyezik meg a megadott mezőben található értékkel.

A megadott mezővel azonos adattípusú mező neve

>[Mező]

Nagyobb, mint a megadott mezőben található érték.

A megadott mezővel azonos adattípusú mező neve

<[Mező]

Kisebb, mint a megadott mezőben található érték.

A megadott mezővel azonos adattípusú mező neve

>=[Mező]

Nagyobb vagy egyenlő a megadott mezőben található értékkel.

A megadott mezővel azonos adattípusú mező neve

<=[Mező]

Kisebb vagy egyenlő a megadott mezőben található értékkel.

A megadott mezővel azonos adattípusú mező neve

Tartalmaz

Pontos vagy részleges egyezést tartalmaz a szűréshez kijelölt mezőben lévő szöveges sztringgel.

Sztring

Nem tartalmaz

Nem tartalmaz pontos vagy részleges egyezést a szűréshez kijelölt mezőben lévő szöveges sztringgel.

Sztring

Szavakat tartalmaz

A szűréshez kijelölt mezőben található pontos szöveges sztringet vagy szavakat tartalmazza. A *helyettesítő karaktert tartalmazó részleges szavakat vagy kifejezéseket is beírhatja. A szöveges sztring legfeljebb 100 karakter hosszúságú lehet. A korlátozásokról a kiszolgálói és rendezési követelmények teljes szöveges keresésében olvashat.

A teljes szöveges kereséshez indexelt hosszú szöveges mezők, amelyek az összes PlainText- és HTML-mezőnek, valamint az Előzmények és címmezőknek felelnek meg.

Nem tartalmaz szavakat

Nem tartalmazza a szűréshez kijelölt mezőben található pontos szöveges sztringet vagy szavakat. A szöveges sztring legfeljebb 100 karakter hosszúságú lehet.

Használja ezt az operátort egy záradékkal és a Szavak tartalma operátorral kombinálva adott kulcsszavak belefoglalására és kizárására.

A teljes szöveges kereséshez indexelt szövegmezők.

In

Egy elhatárolt halmaz bármely értékének megfelel. Ha például megadja az azonosító mező értékeit, megtalálhatja például a 100, 101 és 102 azonosítójú munkaelemeket. Különítse el az értékeket az ügyfélszámítógéphez definiált területi beállításoknak megfelelő listaelválasztóval. Használhat például vesszőt(,).

Szám, Sztring, DateTime, TreePath

Üres

Üres HTML-mezőt tartalmazó munkaelemek listája. Ezzel az operátorral nem adhat meg értéket. Ez az operátor az Azure Boards (felhőszolgáltatás), az Azure DevOps Server 2019 és újabb verziók esetében támogatott.

HTML

Nem üres

A HTML-mezőben bizonyos tartalmat tartalmazó munkaelemeket sorol fel. Ezzel az operátorral nem adhat meg értéket. Ez az operátor az Azure Boards (felhőszolgáltatás), az Azure DevOps Server 2019 és újabb verziók esetében támogatott.

HTML

Nincs beadva

Nem egyezik meg a tagolt halmazok egyik értékének sem. Ha megadja az Állapot mező értékeit, kizárhatja azokat a munkaelemeket, amelyek állapota nem feloldva, befejezve vagy lezárva a lekérdezés eredményéből. Különítse el az értékeket az ügyfélszámítógéphez definiált területi beállításoknak megfelelő listaelválasztóval. Használhat például vesszőt(,).

A Not In operátor az Azure Boards és a TFS 2018.2 és újabb verziókban érhető el.

Szám, Sztring, DateTime, TreePath

Csoportban

A záradékban a csoport tagjának számító értéknek felel meg. A csoportok egy csoport, biztonsági csoport vagy munkakövetési kategória nevének felelnek meg. Létrehozhat például egy lekérdezést, amely megkeresi a Közreműködők csoport tagjaihoz vagy egy csapathoz rendelt összes munkaelemet. Csoportcsoportok létrehozásakor a rendszer csoportokat hoz létre. A csoportcsoportok neve a [Csapatprojekt neve]\Csapat neve mintát követi.

A lekérdezéseket például a Lekérdezés hozzárendelés vagy munkafolyamat-módosítások szerint című témakörben tekintheti meg.

A rendszerben definiált csoport, biztonsági csoport vagy kategória nevével egyező sztring .

Feljegyzés

A Csoporton belüli operátort csak a Sztring adattípust vagy a Munkaelemtípus mezőt használó mezőkkel használhatja. A Microsoft Entra ID-ban definiált csoportokat akkor is használhatja, ha az Azure Boards-fiókját a Microsoft Entra ID, vagy az Active Directory a helyszíni kiszolgálópéldány Active Directory által támogatott biztonsági mentésekor használja.

További információ a kategóriacsoportokról: Kategóriák használata munkaelemtípusok csoportosításához.

Nincs a csoportban

Nem egyezik meg a záradékban szereplő csoport tagjaként megadott értékkel.

Olyan sztring , amely megegyezik a Team Foundation Server felhasználói csoportjának nevével, vagy egy projekthez definiált kategóriacsoporttal.

Feljegyzés

A Nincs csoport operátort csak a Sztring adattípust vagy a Munkaelemtípus mezőt használó mezőkkel használhatja. A Microsoft Entra ID-ban definiált csoportokat akkor is használhatja, ha az Azure Boards-fiókját a Microsoft Entra ID, vagy az Active Directory a helyszíni kiszolgálópéldány Active Directory által támogatott biztonsági mentésekor használja.

Nincs alatta

Nem egyezik meg a záradékban szereplő értékkel, és nem szerepel a záradék csomópontja alatt.

TreePath

Alatta

Megfelel a záradékban szereplő értéknek, vagy a záradék csomópontja alatt található.

TreePath

Volt valaha

Megegyezik a záradékban szereplő értékkel az előző pontban.

Sztring , DateTime

Feljegyzés

Az Ever dátummezők jelenleg nem támogatottak a Lekérdezésszerkesztő használatakor. Ezek csak akkor támogatottak, ha közvetlen WIQL-t végeznek.

Tipp.

A lekérdezéseket olyan WIQL-szintaxissal lehet kontsructázni, amely a felsoroltakon kívül más adattípusú mezőkhöz is használ operátort( például Was Ever). Használhatja például a Was Evert egy záradékon belül az Iteration Path használatával. Példa: Lekérdezés dátum vagy aktuális iteráció szerint, A futamból áthelyezett munkaelemek listája.

Makrók vagy változók lekérdezése

Az alábbi táblázatban ismertetett makrókkal szűrheti a lekérdezéseket adott mezők alapján.

Feljegyzés

A következő makrók csak a webes portálról támogatottak: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity és @TeamAreas. A makrókat tartalmazó lekérdezések nem működnek a Visual Studio/Team Explorer, a Microsoft Excel vagy a Microsoft Project alkalmazásban való megnyitáskor.

---

Makró

Leírás

---

[Bármely]

A Munkaelem típusa vagy állapot mezőivel kereshet az összes munkaelem-típusban vagy az összes államban. Például Work Item Type=[Any] nem helyez el szűrőket a munkaelem típusa alapján.

---

@CurrentIteration

Az Iterációs útvonal mezővel automatikusan szűrheti az aktuális futamhoz rendelt munkaelemeket az aktuális csapatfókusz vagy környezet alapján. Konkrét példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.
A @CurrentIteration makró csak a webes portálról való futtatáskor működik. A makró nem használható tesztcsomagok és tesztesetek másolása vagy klónozása, riasztások definiálása vagy REST API-k használatával.

---

@CurrentIteration +/- n

Az Iterációs útvonal mezővel szűrheti az aktuális futamhoz rendelt munkaelemeket az aktuális csapatfókusz vagy környezet alapján. Konkrét példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.
Az @CurrentIteration +/- n makró az Azure Boards, az Azure DevOps Server 2019 és újabb verzióiban támogatott, és csak akkor, ha a webportálról fut.

---

@Follows

Az Azonosító mezővel és az In operátorral listázhatja a projektben követett összes munkaelemet. A Követés funkcióval kapcsolatos további információkért lásd : Munkaelem vagy lekéréses kérelem követése. Ezt a listát a Munkaelemek lap Következő kimutatás nézetében tekintheti meg.
A @Follows makró csak a webportálról való futtatáskor támogatott.

---

@Me

Identitás- vagy felhasználói fiókmezővel automatikusan kereshet a felhasználóhoz vagy a fiók nevéhez társított elemek között. Megtalálhatja például a záradékkal Created By=@Memegnyitott munkaelemeket. További példákért tekintse meg a Lekérdezés hozzárendelés, munkafolyamat vagy Kanban táblamódosítások alapján című témakört.

---

^{@MyRecentActivity 1}

Az Azonosító mezővel és az In operátorral listázhatja a projektben az elmúlt 30 napban megtekintett vagy frissített munkaelemeket. Ezt a listát a Munkaelemek lapon, a Tevékenység kimutatás nézetében tekintheti meg.

---

@Project

A Csapatprojekt mezővel szűrhet más projektek munkaelemeit. Az aktuálisan kijelölt projekt összes munkaelemét megtalálhatja például a záradékkal Team Project=@Project. A rendszer automatikusan az aktuális projekt alapján szűr. További információ: Lekérdezés definiálása, Projektek közötti lekérdezés.

---

^{@RecentMentions 1}

Az Azonosító mezővel és az In operátorral listázhatja azokat a munkaelemeket, amelyeket a Vita szakaszban említett. Ezt a listát a Munkaelemek lap Megemlített kimutatás nézetében tekintheti meg.

---

^{@RecentProjectActivity 1}

Az Azonosító mező és az In operátor használatával listázhatja a nemrég frissített munkaelemeket. A felsorolt munkaelemek száma a projekt munkakövetési tevékenységétől függ. A rendkívül aktív projektek esetében a makró felsorolja azokat a munkaelemeket, amelyek az elmúlt 30 napban frissültek a projektben. Kevésbé aktív projektek esetén azonban ez a lista 30 napnál régebbi munkaelemeket is tartalmazhat. Hasonló listákat a Legutóbb létrehozott, a Legutóbbi frissítés és a Legutóbb befejezett kimutatásnézetek munkaelemek lapján tekinthet meg. A visszaadott munkaelemek száma 5000-nél van leképezve.

---

^{@StartOfDay 2}

Mezővel DateTime szűrheti az aktuális dátumhoz kapcsolódó vagy plusz/mínusz eltolású munkaelemeket. A záradékkal Closed Date>=@StartOfDay-7például az elmúlt héten bezárt összes elemet megtalálhatja. További példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

---

^{@StartOfMonth 2}

Mezővel DateTime szűrheti az aktuális hónaphoz kapcsolódó vagy plusz/mínusz eltolású munkaelemeket. Az elmúlt három hónapban létrehozott összes elemet megtalálhatja például a záradékkal Created Date>=@StartOfMonth-3. További példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

---

^{@StartOfWeek 2}

Mezővel DateTime szűrheti az aktuális héthez kapcsolódó vagy plusz/mínusz eltolású munkaelemeket. A záradékkal Changed Date>=@StartOfWeek-2például az elmúlt két hétben módosított összes elem megtalálható. További példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

---

^{@StartOfYear 2}

Mezővel DateTime szűrheti az aktuális évhez kapcsolódó vagy plusz/mínusz eltolású munkaelemeket. Megtalálhatja például az összes olyan funkciót, amely az aktuális évben ütemezett céldátummal rendelkezik a záradékkal Target Date>=@StartOfYear. További példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

---

@TeamAreas

Csak a Terület elérési útja mezővel szűrhet olyan munkaelemekre, amelyek területútvonala egy adott csapathoz rendeltnek felel meg. Az operátor használatát = igényli. Megtalálhatja például a webcsapathoz hozzárendelt területútvonalakhoz rendelt összes elemet a záradékkal Area Path=@TeamAreas [Fabrikam Fiber]\Web. További példákért lásd : Lekérdezés terület vagy iterációs útvonal szerint.
A @TeamAreas makró az Azure DevOps Server 2019-es és újabb verzióiban támogatott, és csak akkor, ha a webportálról fut.

---

@Today

Mező használatával DateTime szűrheti az aktuális dátumhoz vagy egy korábbi dátumhoz kapcsolódó munkaelemeket. A @Today makrót napok kivonásával is módosíthatja. Például az elmúlt héten létrehozott összes elemet megtalálhatja a záradékkal Created Date>=@Today-7. További példákért lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

---

Feljegyzés

1. A @MyRecentActivity, @RecentMentions és @RecentProjectActivity makrók támogatottak a TFS 2018.2 és újabb verzióiban.
2. A @StartOfDay, @StartOfWeek, @StartOfMonth és @StartOfYear makrók támogatottak az Azure DevOps Server 2019 1. és újabb verzióiban.

Teljes szöveges és részleges szókeresések

Adja meg a Tartalmaz vagy a Nem tartalmaz elemet egy szó vagy kifejezés pontos vagy részleges egyezéseinek kereséséhez. Ezek az operátorok a hosszú szöveges mezőkhöz létrehozott teljes szöveges keresési index alapján szűrik az elemeket. Adjon meg szavakat, vagy nem tartalmaz szavakat a pontos kifejezés kereséséhez vagy a helyettesítő karakter használatához. * Ezek az operátorok a teljes szöveges keresési indexet használják. A helyettesítő karaktert csak egy részleges szó vagy kifejezés végén használhatja.

Ilyenek például a Példa munkaelem-lekérdezések és a Munkaelemek lekérdezése az Előzmények mezővel.

Feljegyzés

Nem minden üzemelő példány támogatja a teljes szöveges keresést. A felhőszolgáltatást támogató SQL Express és SQL Azure például nem támogatja a teljes szöveges keresést. Ezekben a példányokban csak a Tartalmaz és nem tartalmaz operátorok láthatók.

Kapcsolódó cikkek

• Rövid összefoglalás a lekérdezésekről
• A felügyelt lekérdezések ismertetése
• Munkatétel mezőindex
• A munkaelem lekérdezési nyelvének szintaxisa (WIQL)

REST API

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

• Azure DevOps Services REST API-referencia
• Lekérdezések
• Munkaelem lekérdezési nyelve
• Munkaelemek beolvasása lekérdezésekkel programozott módon