Megosztás:

Lekérdezés dátum vagy aktuális iteráció szerint

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

Ez a cikk bemutatja, hogyan listázhatja a munkaelemeket létrehozás, módosítás, felbontás vagy lezárt dátumok, valamint a dátummakrók (például @Today) és az iterációs makrók csapatsprintekhez való használata alapján. Az iterációs útvonal alapjairól és az ügyfél-/makrókorlátozásokról lásd: Lekérdezés terület vagy iterációs útvonal szerint.

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ási engedély Engedélyezve 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 referencia.

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ási engedély Engedélyezve 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 dátummakrók

Használja az alábbi operátorokat és makrókat a Lekérdezésszerkesztő DateTime és Iteration Path mezőihez.

  • DateTime operátorok: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Dátummakrók: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear, @Today
    A +/- n kombinálható a következő makrókkal (például @Today - 7).
  • Iterációs makrók: @CurrentIteration és @CurrentIteration +/- n (lásd az alábbi megjegyzést és hivatkozást az ügyfélkorlátozásokhoz és a csapatparaméter viselkedéséhez).

Note

Az iterációs makrók és az ügyfélkorlátozások részletes leírása az iterációs oldalon található: Lekérdezés terület vagy iterációs útvonal szerint. Ha nemwebes ügyfeleken vagy a webes felhasználói felületen kívüli REST/WIQL használatával szeretne lekérdezéseket futtatni, ellenőrizze a makrók támogatását a környezetben, és fontolja meg a makrók explicit elérési utakra való kiterjesztését.

Gyorsdátum-példák (gyakori lekérdezések)

  • Az elmúlt 30 napban létrehozott elemek: Képernyőkép az elmúlt 30 napban létrehozott elemek keresésére szolgáló Lekérdezésszerkesztő záradékról.

  • Adott dátumon módosított elemek: Képernyőkép az adott dátumon módosított elemek keresésére szolgáló Lekérdezésszerkesztő záradékról.

  • Ma feloldott elemek: Képernyőkép a ma feloldott elemek keresésére szolgáló Lekérdezésszerkesztő záradékról.

  • Egy megadott időszakon belül bezárt elemek: Képernyőkép a Lekérdezésszerkesztő záradékról, amely egy adott időszakon belül bezárt elemeket keres.

  • Olyan elemek, amelyeknek a lezárt dátuma null (nem zárt): Képernyőkép az üres vagy null értékű lezárt dátumú elemek keresésére szolgáló Lekérdezésszerkesztő záradékról.

  • Azon elemek, amelyek állapota az elmúlt héten módosult: Képernyőkép azoknak az elemeknek a Lekérdezésszerkesztő záradékáról, amelyek állapota az elmúlt héten frissült.

@CurrentIteration Makrók használata (rövid útmutató)

A csapat aktuális sprintjének megcélzására használja a @CurrentIteration kódot, és a @CurrentIteration +/- n kódot futamok tolóablakos létrehozására (például az utolsó két, az aktuális és a következő két sprint esetén). Fontos pontok:

  • @CurrentIteration a lekérdezés futtatásakor használt csapatkörnyezet aktuális futamához rendelt elemeket adja vissza.
  • @CurrentIteration +/- n a futamok ablakát n-sel eltolja; trend- vagy átvitelelemzésekhez használható.
  • Mivel a makrók viselkedése és az ügyféltámogatás eltérő, tekintse meg a Lekérdezés terület vagy iterációs útvonal című témakört a csapatparaméterekről, a makrók kiértékelésének és a makrók tárolásának/kibontásának módjáról a lekérdezések mentésekor.

Példaképek (webes portál lekérdezésszerkesztője):

Képernyőkép a Lekérdezésszerkesztő szűrőről a CurrentIteration makróval egy csapatparaméterrel.

Képernyőkép a CurrentIteration plusz és mínusz záradékáról a futamok tolóablakában.

Tip

Ha @CurrentIteration nem adja vissza a várt eredményeket, ellenőrizze a csapat kiválasztott iterációját és az iterációs dátumtartományokat a Csapat beállításai között.

Dátummakrók: nap/hét/hónap/év kezdete

A kezdő makrók segítenek konzisztens relatív időtartományok létrehozásában.

  • @StartOfDay, , @StartOfWeek@StartOfMonth, @StartOfYear– ezekkel a makrókkal +/- n olyan tartományokat hozhat létre, mint a "hét eleje óta" vagy az "elmúlt 3 hónap".
  • Ezeket a makrókat a webes portál felhasználói felülete értékeli ki; a nemwebes forgatókönyvekben való viselkedésük eltérő lehet – tesztelje a célügyfélben.

Példa lekérdezések:

Képernyőkép az elmúlt 10 napban módosított elemek keresésére szolgáló Lekérdezésszerkesztő záradékokról.

Képernyőkép a következő három hónapra ütemezett funkciók Lekérdezésszerkesztő záradékairól.

Mikor érdemes közvetlenül használni a WIQL-t?

A WIQL használata a következő esetekben:

  • Speciális operátorokra, például WAS EVER az iterációs útvonal módosítására van szükség.
  • A Lekérdezésszerkesztő letilt vagy megjelöl egy záradékot nem támogatottként (például néhány Was Ever felhasználási területen). A WIQL-szerkesztő bővítmény lehetővé teszi a lekérdezések szerkesztését és mentését.

Példákért lásd a Munkaelem lekérdezési nyelv (WIQL) szintaxisát és a WIQL-szerkesztő marketplace-bővítményét.

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