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

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

Ez a cikk az egyes mezőadattípusok, lekérdezési operátorok és lekérdezési makrók leírását tartalmazza. Egyes adattípusok, operátorok és makrók csak a megadott Azure DevOps-verzióra érvényesek.

További információ: Lekérdezések gyorshivatkozása , lekérdezések kezelése és rendszerezése.

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útumnakFIELD felel 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 01/01/2025. 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 szám

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. Olyan munkaelemeket kereshet, amelyek egy faszerkezet alatt egyenlők, nem egyenlők, alá vagy nem. Az operátorok használatával Not In több értéket is In megadhat. Definiálja a projekt fastruktúráját – területútvonalakat és iterációs útvonalakat –, majd jelölje ki 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

A picklist... adattípusok csak öröklött folyamathoz definiált egyéni mezőkhöz vannak hozzárendelve.

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 olvassa el a Felhasználói beállítások 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.

További információ: Lekérdezés definiálása.

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
Ellenőrzi, hogy a logikai mező egyenlő-e egy másik mezővel

<>[Mező]

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

A megadott mezővel azonos adattípusú mező neve
Ellenőrzi, hogy a logikai mező nem egyenlő-e egy másik mezővel

>[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ím mező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 az Contains Words operátorral kombinálva adott kulcsszavak belefoglalására és kizárására.

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

Ban

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 és az Azure DevOps Server 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 és az Azure DevOps Server esetében támogatott.

HTML

Nincs beadva

Nem egyezik meg a tagolt halmazok egyik értékének sem. Kizárhatja azokat a munkaelemeket, amelyek állapota nem feloldva, befejezve vagy lezárva a lekérdezés eredményéből, ha megadja az Állapot mező értékeit. 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 az Azure DevOps Server esetében támogatott.

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ó: 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.

Az Azure DevOps Server felhasználói csoportjának nevével vagy egy projekthez definiált kategóriacsoport nevével egyező sztring .

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

Alatt

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

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

Tipp.

A felsoroltaktól eltérő adattípusú mezőkhöz olyan WIQL-szintaxissal is létrehozható lekérdezés, amely operátort (például Was Ever) használ. 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.
A @CurrentIteration +/- n makró támogatott az Azure Boards és az Azure DevOps Server esetében, 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. További információ: 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 táblamódosítások szerint című témakört.

---

@MyRecentActivity

Az Azonosító mező és az In operátor használatával 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

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

---

@RecentProjectActivity

Az Azonosító mezővel és az In operátorral a legutóbb frissített munkaelemek listázására használható. 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 a projektben az elmúlt 30 napban frissített munkaelemeket. 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

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

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

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

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ó csak akkor támogatott az Azure DevOps Serverhez, 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.

---

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

• A lekérdezés gyorshivatkozásának használata
• A felügyelt lekérdezések ismertetése
• A munkaelem mezőindexének elérése
• A munkaelem lekérdezési nyelvének (WIQL) szintaxisának ismertetése

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