Share via

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

  • Cikk

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

Ebből a cikkből megtudhatja, hogyan listázhatja a munkaelemeket azok létrehozása, bezárása, feloldása vagy módosítása alapján. Megadhat egy dátumot, vagy használhat támogatott makrót. Használja a makrót @Today , és adjon meg plusz vagy mínusz számú napot a relatív dátumokhoz. Az olyan lekérdezések esetében, amelyek munkaelemeket listáznak a csapat aktuális futamához való hozzárendelésük alapján, használja a következőt @CurrentIteration: .

Keresse meg például az elmúlt három napban módosított munkaelemeket az alábbi lekérdezéssel.

Képernyőkép a Lekérdezésszerkesztő a Módosított dátum mező = 3 értékre >történő beállításával.

Emellett a CurrentIteration +/- _n_ makróval lekérdezéseket is létrehozhat a csapat iterációinak egy tolóablaka alapján.

Támogatott operátorok és makrók

A DateTime mezőt vagy az Iterációs útvonal mezőt meghatározó lekérdezési záradékok az alábbi táblázatban felsorolt operátorokat és makrókat használhatják.

Adattípus

Támogatott operátorok és makrók

Dátum/idő

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Makrók: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYearés @Today. A támogatott makrók mindegyikével használható +/- _n_ .

TreePath

= , <> Under, Not Under
Makrók: @CurrentIteration1 és @CurrentIteration +/- n2 érvényes az Iterációs útvonal mezővel.

Megjegyzések:

  1. A @StartOfDay, @StartOfWeek, @StartOfMonthés @StartOfYear makrók az Azure DevOps Server 2019.1-es és újabb verzióiban támogatottak, és csak akkor, ha a webes portálról futnak.
  2. A @CurrentIteration +/- n makró az Azure DevOps Server 2019-es és újabb verzióiban támogatott, és csak akkor, ha a webes portálról fut.

Tipp.

Az WasEver operátor használható az Iteration Path mezővel, de csak akkor, ha a WIQL szintaxisa határozza meg. Példa: Munkaelem lekérdezési nyelve (WIQL) szintaxishivatkozása.

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.

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.

A makrók használatára @CurrentIteration vonatkozó ügyfélkorlátozások

A makrót a @CurrentIteration következő ügyfelek lekérdezéseiben használhatja:

  • Az Azure Boardshoz csatlakozó webportál
  • Az Azure Boardshoz csatlakoztatott Visual Studio 2019 vagy újabb verziók
  • A REST API

A makrót az Azure Boards, az @CurrentIteration +/- n Azure DevOps Server 2019 és újabb verziói, valamint egy OLYAN REST API használatával használhatja, amely paraméterként tartalmazza a csapatot. Például: @CurrentIteration('[Project]/Team').

Hiba történik, ha megnyit egy olyan lekérdezést, amely a Visual Studio korábbi verzióiban vagy a Microsoft Excelben vagy a Microsoft Projectben tartalmazza a @CurrentIteration makrót. Emellett nem használhatja a makrót tesztcsomagok és tesztelési esetek másolása vagy klónozása, riasztások definiálása vagy REST API-k használata esetén.

Dátumalapú lekérdezések

Szűrjön a munkaelemekre a módosítás dátuma vagy egy adott időszak szerint. Korlátozza a lekérdezés hatókörét, ami segíthet a teljesítményben, ha csak a megadott dátumtartománynak megfelelő eredményeket ad vissza. Ha még nem hozott létre lekérdezéseket, olvassa el a Lekérdezésszerkesztő használata lekérdezések listázásához és kezeléséhez című témakört.

Nem minden mező érvényes minden munkaelem-típusra. A lekérdezésekben szerepelhető mezők és azok a munkaelem-típusok, amelyekre vonatkoznak, a dátummezőkre ugorhat.

Tipp.

Szűrés a következőre:

A lekérdezési záradékok belefoglalása

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.

Az elemek ma feloldva.

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

Meghatározott időszakon belül bezárt elemek.

Képernyőkép a megadott időszakon belül bezárt elemek keresésére vonatkozó Lekérdezésszerkesztő záradékról.

Nem lezárt elemek (a lezárt dátum null).

Képernyőkép a Lekérdezésszerkesztő záradékról az üres vagy null értékű lezárt dátumú elemek kereséséhez.

Azok az elemek, amelyek állapota az elmúlt héten frissült.

Képernyőkép a Lekérdezésszerkesztő záradékról azoknak az elemeknek, amelyek állapota az elmúlt héten frissült.

Az aktuális futam során bezárt elemek. (A <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> makró az aktuális csapatkörnyezethez definiált futamra hivatkozik.)

Képernyőkép az aktuális futam során bezárt elemek Lekérdezésszerkesztő záradékról.

Nap, hét, hónap vagy év kezdő dátumalapú lekérdezéseinek létrehozása

Az alábbi példák bemutatják, hogyan szűrhet a StartOf... makrókkal különböző eltolásokkal rendelkező munkaelemekre. További információ: Munkaelem lekérdezési nyelve (WIQL) szintaxisa.

Feljegyzés

Az Azure DevOps Server 2019 1-es vagy újabb verziójára van szükség.

Szűrés a következőre:

A lekérdezési záradékok belefoglalása

Az elmúlt két hétben bezárták a hibákat.

Képernyőkép az elmúlt két hétben bezárt hibák keresésére szolgáló Lekérdezésszerkesztő záradékról.

Az elmúlt 10 napban módosított elemek.

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.

Az ütemezett funkciók a következő három hónapban fejeződnek be.

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

Nem minden mező érvényes minden munkaelem-típusra. A lekérdezésekben szerepelhető mezők és azok a munkaelem-típusok, amelyekre vonatkoznak, a dátummezőkre ugorhat.

Lekérdezések létrehozása a csapat aktuális iterációjához

Ha a csapat a Scrum-folyamatokat követi, a munkát úgy ütemezi , hogy a futamokban befejeződjön. A makróval nyomon követheti az aktuális futamban teljesítendő követelmények, hibák és egyéb feladatok előrehaladását @CurrentIteration .

A csapat aktuális iterációs útvonalának megfelelő sprinthez rendelt elemek megtalálhatók. Ha például egy csapat a Sprint 5-ben van, a lekérdezés a Sprint 5-höz rendelt elemeket adja vissza. Később, amikor a csapat a Sprint 6-ban dolgozik, ugyanaz a lekérdezés a Sprint 6-hoz rendelt elemeket adja vissza.

Feljegyzés

Ahhoz, hogy a @CurrentIteration makró működjön, a csapatnak ki kell választania egy iterációs útvonalat, amelynek dátumtartománya magában foglalja az aktuális dátumot. További információ: Iterációs útvonalak definiálása (más néven futamok) és csapat iterációk konfigurálása. Emellett a makrót tartalmazó lekérdezések csak akkor érvényesek, ha a webportálról futnak.

Lásd még Client restrictions on the use of the @CurrentIteration macros a cikk korábbi szakaszát.

Az Azure Boards hozzáad egy csapatparamétert a @CurrentIteration vagy @CurrentIteration +/- n makrók kiválasztásakor. A csapatparaméter az aktuális csapatkörnyezetből származik.

Képernyőkép a Lekérdezés szűrőről a CurrentIteration makró és a csapatparaméter használatával.

Tipp.

Ha a @CurrentIteration makró nem működik, ellenőrizze, hogy a várt iteráció ki van-e jelölve a csapat számára, és hogy a dátumok meg lettek-e adva.

Ha módosítani szeretné a rendszer által automatikusan beállítandó csapatparamétert, a @CurrentIteration makró alatt hozzáadott paramétermezőbe írja be a csapat nevét.

A csapatparaméter kiválasztását bemutató képernyőkép.

A csapat iterációs lekérdezésének csúsztatási ablakának létrehozása

@CurrentIteration +/- <i>n</i> A makrót akkor használja, ha nyomon szeretné követni azt a munkát, amelyet egy csapat tervezett a közelgő futamokra, és megismerheti a korábbi futamokban nem befejezett munkát.

Feljegyzés

A makró működéséhez a @CurrentIteration +/- <i>n</i> csapatnak olyan iterációs útvonalakat kell kiválasztania, amelyek megfelelnek a +/- _n_ feltételeknek. A dátumtartományoknak tartalmazniuk kell az aktuális dátumot a @CurrentIteration. Az iterációs útvonalak csapatkiválasztásáról további információt az iterációs (sprint) útvonalak definiálása és a csapat iterációinak konfigurálása című témakörben talál.

Lásd még Client restrictions on the use of the @CurrentIteration macros a cikk korábbi szakaszát.

Az alábbi kép bemutatja, hogyan listázhatja az összes olyan Felhasználói történet és hiba munkaelemtípust, amely a csúsztatási ablakhoz van rendelve, amely az utolsó kettőre, az aktuálisra és a következő két, a Felhő Rendszergazda és eszközök csapatához kiválasztott futamra terjed ki.

Képernyőkép a CurrentIteration plusz és mínusz záradékokról.

A makró használatához a megadott csapatnak ki kell választania a makróhoz megadott értéket lefedő +/- _n_ futamokat.

A futamból áthelyezett munkaelemek listázása

Listázhatja a futamhoz definiált, de később áthelyezett munkaelemeket egy olyan lekérdezéssel, amely tartalmazza az Was Ever Iteration Path mező operátorát. Ezt a lekérdezést csak a WIQL szintaxissal hozhatja létre. Szerkessze a WIQL szintaxist Lekérdezésszerkesztő a WIQL Editor Marketplace bővítmény telepítésével.

A munkaelemekre vonatkozó alábbi szintaxisos lekérdezések például megfelelnek a következő feltételeknek:

  • Az aktuális projektben definiálva.
  • A munkaelem típusa megegyezik a Felhasználói szövegegység vagy a Hiba értékekkel.
  • A munkaelemek a Fabrikam Fibre Web csapat területútvonala alatt találhatók.
  • A munkaelemek nincsenek , Completed, Cutvagy Resolved állapotbanClosed.
  • A Fabrikam Fibre Web csapatának jelenlegi iterációs útvonalán nem.
  • A Fabrikam Fibre Web csapatának jelenlegi iterációs útvonalához lettek rendelve.
  • A Fabrikam Fibre Web csapata most már a +1 iterációhoz van rendelve.
  • Az elmúlt 30 napban módosultak (a futam hossza).
SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

A szintaxis Lekérdezésszerkesztő nézete az ábrán látható módon jelenik meg.

Feljegyzés

A Lekérdezésszerkesztő egy információs ikont jelenít meg az Was Ever operátor mellett, amely a záradékkal kapcsolatos problémát jelzi. A lekérdezés azonban továbbra is fut, és létrehozhat lekérdezésdiagramokat. A lekérdezés módosításához a WIQL-szerkesztőt kell használnia.

Képernyőkép Lekérdezésszerkesztő sprintből áthelyezett munkaelemekről.

A kezdési dátum után a futamhoz hozzáadott munkaelemek listázása

Ha egy futamhoz a kezdési dátum után hozzáadott újonnan létrehozott munkaelemeket szeretné listázni, használjon az alábbi képen láthatóhoz hasonló lekérdezést. Ez a lekérdezés úgy működik, hogy szűri az aktuális futamhoz rendelt munkaelemeket, de a futamdátum kezdete után lettek létrehozva. Használja a záradékot created Date = @Today - 28.

Képernyőkép az újonnan létrehozott és a futamhoz hozzáadott Lekérdezésszerkesztő munkaelemekről a kezdési dátum után.

A futamtartomány módosításainak lekérdezésére vonatkozó további lehetőségekért lásd : About Sprints, Scrum and project management, Sprint scope change.

Dátum- és iterációs útvonal mezői

A Lekérdezések szűréséhez használja a Dátum mezőket. Ezen mezők némelyike információval van feltöltve, amint egy munkaelem egyik állapotból a másikba halad. Ezen mezők közül több nem jelenik meg a munkaelem-űrlapon, de az alábbi táblázatban felsorolt munkaelem-típusok nyomon vannak követve.

Mezőnév

Leírás

Munkaelem-típusok

Aktivált dátum (1. és 2. megjegyzés)

A munkaelem létrehozásának dátuma és időpontja, illetve annak állapota Closed, Completedilletve DoneNewActive állapota. Hivatkozás neve=Microsoft.VSTS.Common.ActivatedDate, Data type=DateTime

Hiba, változáskérés, epikus, funkció, probléma, termékhátrelmező-elem, követelmény, felülvizsgálat, kockázat, megosztott lépés, feladat, teszteset, felhasználói történet

Dátum módosítása

A munkaelem módosításának dátuma és időpontja. Referencianév=System.ChangedDate, Data type=DateTime

Mind

Záró dátum (2. megjegyzés)

A munkaelem bezárásának dátuma és időpontja. Hivatkozás neve=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

Mind

Létrehozás dátuma

A munkaelem létrehozásának dátuma és időpontja. Referencianév=System.CreatedDate, Data type=DateTime

Mind

Esedékesség dátuma

A megoldandó probléma előre jelzett határideje. Hivatkozás neve=Microsoft.VSTS.Scheduling.DueDate, Data type=DateTime

Probléma (Agilis)

Befejezési dátum (3. megjegyzés)

Az ütemezés dátuma és időpontja azt jelzi, hogy a tevékenység befejeződött. Referencianév=Microsoft.VSTS.Scheduling.FinishDate, Data type=DateTime

Követelmény, feladat, tesztterv, felhasználói történet

Iteráció elérési útja

Elnevezett futamok vagy időszakok szerint csoportosítja a munkaelemeket. Az iterációnak érvényes csomópontnak kell lennie a projekthierarchiában. Megadhatja egy projekt iterációs útvonalait, és kiválaszthatja a csapat iterációs útvonalait. Referencianév=System.IterationPath, Adattípus=TreePath

Mind

Megoldott dátum (1. és 2. megjegyzés)

A munkaelem állapotba helyezésének Resolved dátuma és időpontja. Referencianév=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

Hiba, változáskérés, epikus, funkció, probléma, termékhátrelmező-elem, követelmény, felülvizsgálat, kockázat, megosztott lépés, feladat, teszteset, felhasználói történet

Kezdő dátum (3. megjegyzés)

Az ütemezés dátuma és időpontja azt jelzi, hogy a tevékenység elindul.

Feljegyzés

A kézbesítési tervek a Kezdési dátum és a Céldátum mezők használatával jelenítik meg a funkciók, eposzok és egyéb portfolió-hátralékelemek hatókörét.

Hivatkozás neve=Microsoft.VSTS.Scheduling.StartDate, Data type=DateTime

Epic, Feature, Requirement, Task, Test Plan, User Story

Állapotváltozás dátuma

Az a dátum és idő, amikor az Állapot mező értéke megváltozott. Hivatkozás neve=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

Mind

Céldátum

A funkció, a munkaelem vagy a probléma befejezésének vagy megoldásának dátuma.

Feljegyzés

A kézbesítési tervek a Kezdési dátum és a Céldátum mezők használatával jelenítik meg a funkciók, eposzok és egyéb portfolió-hátralékelemek hatókörét.

Hivatkozás neve=Microsoft.VSTS.Scheduling.TargetDate, Data type=DateTime

Epikus, funkció

Megjegyzések:

  1. Lásd még : Lekérdezés hozzárendelés vagy munkafolyamat-módosítások, Dátum és Identitás mezők szerint.

  2. Ahhoz, hogy ezek a mezők munkaelem-típushoz legyenek definiálva, szerepelniük kell a WORKFLOW munkaelem típusdefiníciójának szakaszában. Ez a szintaxis például az állapotra Resolved való áttéréskor szerepel a FIELDS definícióban.

     <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
    <SERVERDEFAULT from="clock"  />  
 </FIELD >

  3. A kezdési dátum és a befejezési dátum értékei akkor lesznek kiszámítva, ha projekttervet hoz létre a Projectben, majd szinkronizálja a tervet az Azure Boardsban tárolt feladatokkal. Előfordulhat, hogy ezek a mezők nem jelennek meg a munkaeleműrlapon, de a rendszer a hátralékelemekhez csatolt hátralékelemekhez és tevékenységekhez számítja ki őket. Az írásvédett értékek egy lekérdezésből vagy az Excelből származó eredményekben tekinthetők meg.

    Fontos

    A Microsoft Project Integration és a TFSFieldMapping parancs nem támogatott:

    • Visual Studio 2019 és Azure DevOps Office Integration 2019.
    • Az Azure DevOps Server 2019 és újabb verziói, beleértve az Azure DevOps Servicest is.

    A Microsoft Excel-integráció teljes körű támogatása megmarad, és támogatja a munkaelemek tömeges importálását és frissítését. A Microsoft Project használatának alternatívái a következők:

REST API

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