Megosztás:

Lekérdezési mezők, operátorok és makrók

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

Ez a cikk a lekérdezésszerkesztőben használt mezőadattípusokat, lekérdezési operátorokat és lekérdezési makrókat ismerteti. Egyes típusok, operátorok és makrók csak bizonyos Azure DevOps-verziókra vonatkoznak.

A gyors példákért és a szerkesztői feladatokért tekintse meg a lekérdezések gyorshivatkozását , valamint a lekérdezések kezelését és rendszerezését ismertető témakört.

Előfeltételek

Kategória Követelmények
hozzáférési szintek – Megosztott lekérdezések megtekintése és futtatása: projekt tag.
– Megosztott lekérdezés hozzáadása és mentése: Legalább alapszintű hozzáférés.
engedélyek 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.

Feljegyzés

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óért lásd: Érdekelt felek hozzáférésének gyors áttekintése.

Kategória Követelmények
hozzáférési szintek – Megosztott lekérdezések megtekintése és futtatása: projekt tag.
– Megosztott lekérdezés hozzáadása és mentése: Legalább Egyszerű hozzáférés.
engedélyek 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.

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

Meg kell adnia egy mező adattípusának megfelelő értéket. Az alábbi táblázat a támogatott adattípusokat sorolja fel:

Feljegyzés

Az Azure Boards (felhő) esetében az adattípus megegyezik a Folyamatmezők > lapon látható mezővel. Helyszíni üzembe helyezések esetén az adattípus a type attribútumnak felel meg egy FIELD definícióban. Részletekért lásd : Munkaelemmezők és mezőattribútumok .

Adattípus

Leírás

Logikai

Igaz/hamis értéket tárol.

DateTime vagy Date/Time

Használjon dátumváltozót (például @Today ) vagy @Today-1explicit dátumot, például 01/01/2025. Adja meg a dátumokat a profilban beállított mintában. A lekérdezési példákért lásd: Query by date or @CurrentIteration.
WIQL-lekérdezések esetén a dátumokat UTC-ben is megadhatja. Lásd a munkaelem lekérdezési nyelvének (WIQL) szintaxisát.

Dupla vagy decimális

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

GUID

Egy egyedi azonosító sztringet tárol.

Előzmények

Az előzményadatokhoz (az Előzmények mezőhöz) használt egyéni formázott mező. Ha teljes szöveges keresés érhető el, a mező indexelve lesz a teljes szöveges lekérdezésekhez. Lásd az előzményeket és a naplózást.

HTML

Formázott szöveget (például leírást vagy repro lépéseket) tárol. Ha teljes szöveges keresés érhető el, ezek a mezők indexelve lesznek. 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 sztringet tárol.

Egész szám

Aláírt 32 bites egész számot tárol (például 0, 1, 2, 34).

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

Hosszú szöveges értékeket (például alkalmazásindítási információkat) tárol. Ezek a mezők indexelik a teljes szöveges keresést, ha támogatottak. Lásd: Lekérdezés címek, azonosítók és rich-text mezők szerint.

picklistDouble

Egyéni mező, amely a decimális értékek kivétellistáját tartalmazza.

picklistInteger

Egyéni mező, amely az egész szám értékek választékát tartalmazza.

picklistString

Olyan egyéni mező, amely rövid szöveges értékek (legfeljebb 255 karakter) listáját tartalmazza.

Sztring vagy Szöveg mező (egysoros)

Legfeljebb 255 Unicode-karakter hosszúságú rövid szöveget tárol. A Teams gyakran használja ezeket a mezőket a listákhoz vagy a legördülő menükhöz.

TreePath

Elágazási fát jelöl (például Terület útvonala vagy Iterációs útvonal). Válasszon érvényes csomópontértéket. Szűrheti az egyenlőséget, az egyenlőtlenséget, a "Under" / "Not Under" értéket, vagy használhatja az In / Not In operátorokat több érték megadására. Definiálja a projekt fastruktúráit – a területútvonalakat és az iterációs útvonalakat –, és jelölje ki a csoportokkal társítandó csomópontokat. A lekérdezési példákért tekintse meg a Lekérdezés terület vagy iterációs útvonal , valamint a Lekérdezés dátum vagy aktuális iteráció szerint című témakört.

Feljegyzés

A picklist... típusok csak az örökölt folyamathoz definiált egyéni mezőkre vonatkoznak.

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.

Képernyőkép a Dátumminta legördülő listáról az Idő és a Területi beállítás panelen. Képernyőkép az Időminta legördülő listáról az Idő és a Területi beállítás panelen.

Képernyőkép az Idő és a Területi beállítás panelről Dátumminta és Időminta mezőkkel.

Lekérdezési operátorok

Operátorok használatával meghatározhatja, hogy a záradékértéknek hogyan kell kapcsolódnia egy munkaelem mezőértékéhez. A mezőadat-típusokért lásd: Munkaelem mezőhivatkozása. A lekérdezések létrehozásához a Lekérdezés definiálása című témakörben talál segítséget.

Lekérdezési operátor

Amikor az operátor egyező munkaelemeket ad vissza

Alkalmazható adattípusok

=

Megegyezik a záradék értékével.

Szám (Dupla/Decimális/GUID/Egész szám), Sztring, DateTime, TreePath

<>

Nem egyezik a klauzula értékével.

Szám, Sztring, DateTime, TreePath

>

Nagyobb, mint a feltétel értéke.

Szám, Sztring, DateTime

<

Kisebb, mint a feltétel értéke.

Szám, Sztring, DateTime

>=

Nagyobb vagy egyenlő a záradék értékénél.

Szám, Sztring, DateTime

<=

Kisebb vagy egyenlő a záradék értékével.

Szám, Sztring, DateTime

=[Mező]

Megegyezik egy másik megadott mezőben lévő értékkel (azonos adattípusnak kell lennie).

Azonos adattípusú mező neve (a logikai mezők az egyenlőséget hasonlítják össze más mezőkkel).

<>[Mező]

Nem egyezik meg egy másik megadott mező értékével.

Azonos adattípusú mező neve.

>[Mező]

Nagyobb, mint egy másik megadott mező értéke.

Azonos adattípusú mező neve.

<[Mező]

Kisebb, mint egy másik megadott mező értéke.

Azonos adattípusú mező neve.

>=[Mező]

Nagyobb vagy egyenlő egy másik megadott mezőben lévő értékkel.

Azonos adattípusú mező neve.

<=[Mező]

Kisebb vagy egyenlő egy másik megadott mező értékével.

Azonos adattípusú mező neve.

Tartalmaz

Pontos vagy részleges szövegegyezést tartalmaz.

Lánc

Nem tartalmaz

Nem tartalmaz pontos vagy részleges szövegillesztést.

Lánc

Szavakat tartalmaz

Pontosan egyezik egy kifejezéssel vagy szavakkal (támogatja a záró helyettesítő karaktereket *). Korlát: 100 karakter. Ez az operátor teljes szöveges indexelést használ; A kiszolgálói és rendezési követelményekről a jelen cikk teljes szöveges szakaszában olvashat.

A teljes szöveges kereséshez indexelt hosszú szöveges mezők (Egyszerű szöveg, HTML, Előzmények és Cím).

Nem tartalmaz szavakat

Kizárja a megadott kifejezést vagy szavakat tartalmazó elemeket. Korlát: 100 karakter. Contains Words A kulcsszavak belefoglalására vagy kizárására társzáradékokkal együtt használható.

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

Ban

Megfelel a tagolt csoportok bármely értékének (használja az operációs rendszer területi listaelválasztóját, általában vesszőt).

Szám, Sztring, DateTime, TreePath

Üres

Azokat az elemeket tartalmazza, amelyekben egy HTML-mező nem tartalmaz tartalmat (nincs megadva érték). Az Azure Boards és az Azure DevOps Server esetében támogatott.

HTML

Nem üres

Olyan elemeket keres, amelyekben egy HTML-mező tartalommal rendelkezik. Az Azure Boards és az Azure DevOps Server esetében támogatott.

HTML

Nincs beadva

Egy elválasztó halmaz értékeinek kizárása (használja a területi listaelválasztót). Az Azure Boards és az Azure DevOps Server esetében támogatott.

Szám, Sztring, DateTime, TreePath

Csoportban

Egy elnevezett csoport (csoport, biztonsági csoport vagy kategória) tagjait tartalmazó értékeket adja meg. Használja például a Közreműködők csoportot vagy a mintában [Project Name]\Team Nameelnevezett csoportcsoportot. Példákért tekintse meg a Lekérdezés hozzárendelés vagy munkafolyamat-módosítások alapján című témakört.

Sztring (csoport vagy csoportnév egyezése) vagy munkaelem típusa

Feljegyzés

Kizárólag String típusú mezőkkel vagy munkatípusokkal használja az In Group funkciót. Microsoft Entra-azonosítócsoportokat akkor használhat, ha a fiókja Microsoft Entra-azonosítót vagy Active Directory-csoportokat használ a helyszínen. oszlop-vége

Nincs a csoportban

Egy elnevezett csoport tagjainak kizárása.

Felhasználói csoportnak vagy projektkategóriának megfelelő karakterlánc.

Nincs alatta

Kizárja az egyforma vagy a megadott facsomópont alatt található elemeket.

TreePath

Alatt

Egyezik a megadott facsomópontban lévő vagy az alatt található elemekkel.

TreePath

Volt valaha

Egy olyan értéknek felel meg, amelyet egy mező korábban tartott.

Sztring, DátumIdő

Feljegyzés

A Lekérdezésszerkesztő jelenleg nem támogatja Was Ever a dátummezőket; ezekhez az esetekhez használjon közvetlen WIQL-t. oszlop-vége

Tipp.

Létrehozhat olyan WIQL-lekérdezéseket, amelyek operátorokat (például) használnak más adattípusokhoz, Was Everpéldául az Iterációs útvonalhoz. Lásd a sprintből kikerült munkaelemek listáját példaként.

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

A lekérdezések dinamikus szűréséhez használja az alábbi makrókat.

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 állapota funkcióval minden típusban vagy állapotban kereshet. Például eltávolítja a Work Item Type=[Any] típusalapú szűrést.

@CurrentIteration

Az Iteration Path használatával szűrheti az aktuális futam munkaelemeit az aktuális csapatkörnyezet alapján. Példákért tekintse meg a lekérdezést dátum vagy aktuális iteráció szerint . @CurrentIteration csak akkor működik, ha a webportálról fut (nem REST API-kban vagy másolási/klónozási műveletekben).

@CurrentIteration +/- n

Az Iteration Path használatával az aktuális iterációhoz (például @CurrentIteration-1 vagy @CurrentIteration+2) viszonyított futamokat is belefoglalhat. Az Azure Boards és az Azure DevOps Server webes portálján támogatott.

@Follows

Az azonosítóval és az In operátorral listázhatja a projektben követett munkaelemeket. Lásd: Munkaelem vagy lekéréses kérelem követése. Ez a makró csak a webes portálról működik.

@Me

Identitásmezőkkel szűrheti a fiókjához csatolt elemeket (például Created By=@Me). Lásd : Lekérdezés hozzárendelés, munkafolyamat vagy táblamódosítások szerint.

@MyRecentActivity

Használja az azonosítót , és In listázhatja az elmúlt ~30 napban megtekintett vagy frissített munkaelemeket. Lásd a Munkaelemek lapot , a Saját tevékenység kimutatást ugyanahhoz a listához.

@Project

A Team Project használatával szűrheti az aktuális projekt munkaelemeit (például Team Project=@Project). Tekintse meg a projektek közötti lekérdezést.

@RecentMentions

Használja az ID-t és a In a munkaelemek listázásához, amelyekben a megbeszélések során említésre kerül. Lásd a Munkaelemek lap Megemlített fülét.

@RecentProjectActivity

ID és In használatával listázhatja a projekt során nemrég frissített munkaelemeket. A makró legfeljebb 5000 elemet ad vissza; a tényleges ablak a projekttevékenységtől függ.

@StartOfDay

A DateTime mezőkkel a maihoz képest szűrhet (például Closed Date&gt;=@StartOfDay-7).

@StartOfMonth

Dátum/idő mezők használatával a hónap kezdetéhez képest szűrhet (például Created Date&gt;=@StartOfMonth-3).

@StartOfWeek

Dátum/idő mezők használatával a hét kezdetéhez képest szűrhet (például Changed Date&gt;=@StartOfWeek-2).

@StartOfYear

Dátum/idő mezők használatával szűrhet az év kezdetéhez képest (például Target Date&gt;=@StartOfYear).

@TeamAreas

Csak Terület elérési útja operátorral és az = operátorral keresse meg a csapat terület elérési útjaihoz rendelt elemeket (például Area Path=@TeamAreas [Fabrikam Fiber]\Web). Az Azure DevOps Server webportálján támogatott.

@Today

A DateTime mezőkkel a maihoz képest szűrhet (például Created Date&gt;=@Today-7). Lásd : Lekérdezés dátum vagy aktuális iteráció szerint.

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

A Tartalom vagy a Nem tartalmazza funkcióval pontos vagy részleges egyezéseket kereshet hosszú szöveges mezőkben (ezek az operátorok a lekérdezési indexet használják). Szavakat tartalmaz, vagy nem tartalmaz szavakat a pontos kifejezések kereséséhez vagy záró helyettesítő karakter (*) használatához; ezek az operátorok a teljes szöveges indexet igénylik.

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 telepítés támogatja a teljes szöveges keresést. Az SQL Express és egyes felhőalapú SQL-konfigurációk például nem támogatják a teljes szöveges keresést. Ezekben az üzemelő példányokban csak a Tartalmaz és Nem tartalmaz operátorok használhatók.

Az Azure DevOps Server a hosszú szöveges mezőket (PlainText és HTML) és a Cím mezőt indexeli a teljes szöveges kereséshez, ha a mögöttes SQL Server támogatja a teljes szöveges indexelést.

A teljes szöveges kereséshez sql-rendezésre is szükség van egy regisztrált szóválasztóval a használt nyelvhez. Ha a gyűjteményadatbázis rendezése nem egyezik a támogatott nyelvvel, előfordulhat, hogy az eredmények nem felelnek meg az elvárásoknak; ezekben az esetekben használja helyette a Tartalmaz vagy a Nem tartalmaz elemet .

További információ: Teljes szöveges keresési lekérdezések és rendezési beállítások.

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