Dotazování podle data nebo aktuální iterace

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

V tomto článku se dozvíte, jak vypsat pracovní položky podle toho, kdy byly vytvořeny, uzavřeny, vyřešeny nebo změněny. Můžete zadat datum nebo použít podporované makro. @Today Použijte makro a zadejte plus nebo minus počet dnů pro relativní kalendářní data. Pro dotazy, které uvádějí pracovní položky na základě jejich přiřazení k aktuálnímu sprintu týmu, použijte @CurrentIteration.

Pomocí následujícího dotazu můžete například najít pracovní položky, které byly změněny za poslední tři dny.

Makro můžete také použít CurrentIteration +/- _n_ k vytváření dotazů na základě posuvného okna týmových iterací.

Požadavky

Kategorie	Požadavky
úrovně přístupu	- Zobrazení a spuštění sdílených dotazů: člen projektu. – Přidání a uložení sdíleného dotazu: Alespoň základní přístup.
Oprávnění	oprávnění Přispívat nastavená na Povolit pro složku, do které chcete přidat dotaz. Ve výchozím nastavení nemá skupina přispěvatelů toto oprávnění.

Poznámka

Uživatelé s přístupem Zainteresovaná Strana k veřejnému projektu mají úplný přístup k funkcím dotazů stejně jako uživatelé se základním přístupem. Další informace najdete v části Rychlá příručka pro přístup účastníků.

Podporované operátory a makra

Klauzule dotazu, které určují pole DateTime nebo pole Cesta iterace, mohou používat operátory a makra uvedená v následující tabulce.

---

Datový typ

Podporované operátory a makra

---

DateTime

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

Makra: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYeara @Today. Můžete použít +/- _n_ s jednotlivými podporovanými makry.

---

TreePath

=, <>pod, ne pod
Makra: @CurrentIteration¹ a^{@CurrentIteration +/- n 2} platné s polem Cesta iterace.

---

Poznámky:

1. Pro @StartOfDayAzure DevOps Server 2019.1 a @StartOfWeek novější verze se podporují makra @StartOfMonth@StartOfYeara . Podporují se jenom při spuštění z webového portálu.
2. Makro @CurrentIteration +/- n je podporováno pro Azure DevOps Server 2019 a novější verze a podporuje se pouze při spuštění z webového portálu.

Tip

Operátor WasEver lze použít s polem Cesta iterace, ale pouze v případě, že je definován prostřednictvím syntaxe WIQL. Příklad najdete v referenční dokumentaci syntaxe jazyka WIQL (Work Item Query Language).

Vzor data a času

Vzor data a času, který zadáte pro pole DateTime , by se měl shodovat s tím, který vyberete v profilu. Pokud chcete zobrazit nebo změnit výběr, přečtěte si téma Nastavení uživatelských předvoleb.

Omezení klienta týkající se @CurrentIteration používání maker

Makro v dotazu můžete použít @CurrentIteration z následujících klientů:

• Webový portál, který se připojuje k Azure Boards
• Visual Studio 2019 nebo novější verze připojené k Azure Boards
• Rozhraní REST API

Makro můžete použít @CurrentIteration +/- n v dotazu na Azure Boards, Azure DevOps Server 2019 a novější verze a s rozhraním REST API, které zahrnuje tým jako parametr. Příklad: @CurrentIteration('[Project]\Team').

Pokud otevřete dotaz obsahující @CurrentIteration makro v dřívějších verzích sady Visual Studio nebo z Aplikace Microsoft Excel nebo Aplikace Microsoft Project, dojde k chybě. Makro také nemůžete použít při kopírování nebo klonování testovacích sad a testovacích případů, definování výstrah nebo pomocí rozhraní REST API.

Dotazy založené na datech

Vyfiltrujte pracovní položky podle data, kdy byly změněny, nebo pro určité časové období. Omezte rozsah dotazu. Tento přístup může pomoct s výkonem tak, že vrátí jenom výsledky, které odpovídají zadanému rozsahu dat. Pokud s vytvářením dotazů začínáte, přečtěte si téma Definování dotazu pracovní položky.

Ne všechna pole jsou platná pro všechny typy pracovních položek. Přejít na pole kalendářních dat pro sadu polí, která můžete zahrnout do dotazů a typů pracovních položek, na které se vztahují.

Tip

• Nezapomeňte zadat data do pole Vzor data, které jste nastavili pro svůj osobní profil.
• Informace o AND/OR seskupených klauzulích najdete v tématu Klauzule Group. Pokud chcete zobrazit syntaxi WIQL pro dotaz, nainstalujte rozšíření editoru WIQL, které umožňuje zobrazit verzi WIQL libovolné položky Editor Power Query.

---

Filtr pro

Zahrnout tyto klauzule dotazu

---

Položky vytvořené za posledních 30 dnů

---

Položky změněné k určitému datu.

---

Položky se dnes vyřešily.

---

Položky zavřené v zadaném časovém období.

---

Položky, které nejsou zavřené. Uzavřené datum má hodnotu null.

---

Položky, jejichž stav byl aktualizován v posledním týdnu

---

Položky zavřené během aktuálního sprintu. Makro <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> odkazuje na sprint definovaný pro aktuální týmový kontext.

---

Vytvoření dotazů založených na datech na začátku dne, týdne, měsíce nebo roku

Následující příklady ukazují, jak pomocí StartOf... maker filtrovat pracovní položky s různými posuny. Další informace najdete v tématu Syntaxe jazyka WIQL (Work Item Query Language).

Filtr pro

Zahrnout tyto klauzule dotazu

---

Chyby se za poslední dva týdny zavřely.

---

Položky změněné za posledních 10 dnů

---

Funkce naplánované na dokončení v následujících třech měsících.

---

Ne všechna pole jsou platná pro všechny typy pracovních položek. Přejít na pole kalendářních dat pro sadu polí, která můžete zahrnout do dotazů a typů pracovních položek, na které se vztahují.

Vytváření dotazů pro aktuální iteraci vašeho týmu

Pokud váš tým sleduje procesy Scrumu, naplánujete dokončení práce ve sprintech. Průběh požadavků, chyb a dalších prací, které se mají dokončit v aktuálním sprintu @CurrentIteration , můžete sledovat pomocí makra. Další informace najdete v tématu Správa časových os sprintů.

Dotaz najde libovolnou položku přiřazenou sprintu, která odpovídá aktuální cestě iterace týmu. Pokud je například tým ve sprintu 5, vrátí dotaz položky přiřazené sprintu 5. Později, když tým pracuje ve sprintu 6, vrátí stejný dotaz položky přiřazené sprintu 6.

Poznámka

@CurrentIteration Aby makro fungovalo, musí tým vybrat cestu iterace, jejíž rozsah kalendářních dat zahrnuje aktuální datum. Další informace najdete v tématu Výběr týmových sprintů a nastavení výchozí cesty iterace. Dotazy, které obsahují toto makro, jsou také platné pouze při spuštění z webového portálu.

Viz také Client restrictions on the use of the @CurrentIteration macros dříve v tomto článku.

Azure Boards přidá parametr týmu, když vyberete @CurrentIteration nebo @CurrentIteration +/- n maker. Parametr týmu je odvozený z aktuálního kontextu týmu.

Tip

@CurrentIteration Pokud makro nefunguje, zkontrolujte, jestli je pro váš tým vybraná očekávaná iterace a že pro něj byla nastavena data. Další informace najdete v tématu Výběr týmových sprintů.

Pokud chcete změnit parametr týmu, který systém automaticky nastaví, zvolte ho zadáním názvu týmu do pole parametru přidaného pod @CurrentIteration makrem.

Vytvoření posuvného okna dotazu iterací týmu

@CurrentIteration +/- n Makro použijte, když chcete sledovat práci, kterou tým plánuje pro nadcházející sprinty, a pochopit práci, která nebyla dokončena v předchozích sprintech.

Poznámka

@CurrentIteration +/- n Aby makro fungovalo, musí mít tým vybrané cesty iterace, které splňují +/- n kritéria. Rozsahy kalendářních dat musí zahrnovat aktuální datum .@CurrentIteration Další informace o výběru cest iterace týmu naleznete v tématu Výběr týmových sprintů a nastavení výchozí cesty iterace.

Viz také Client restrictions on the use of the @CurrentIteration macros dříve v tomto článku.

Následující obrázek ukazuje, jak zobrazit seznam všech typů pracovních položek uživatelského scénáře a chyby, které jsou přiřazeny k posuvným oknem. Okno zahrnuje poslední dva, aktuální a další dva sprinty vybrané pro tým správce cloudu a nástroje.

Pokud chcete toto makro použít, musí zadaný tým vybrat sadu sprintů , které pokrývají +/- n hodnotu zadanou pro makro.

Výpis pracovních položek přesunutých ze sprintu

Vypíše pracovní položky definované pro sprint, ale později se přesunou pomocí dotazu s klauzulí, která obsahuje Was Ever operátor pro pole Cesta iterace. Tento dotaz můžete vytvořit pouze pomocí syntaxe WIQL. Upravte syntaxi WIQL v Editor Power Query instalací rozšíření WIQL Editor Marketplace.

Například následující syntaxe dotazů na pracovní položky splňují následující kritéria:

• Definováno v aktuálním projektu.
• Typ pracovní položky se rovná uživatelskému scénáři nebo chybě.
• Pracovní položky jsou pod cestou týmu Fabrikam Fiber Web.
• Pracovní položky nejsou ve Closedstavu , Completed, Cutnebo Resolved ve stavu.
• Není v aktuální cestě iterace pro tým Fabrikam Fiber Web.
• Byly přiřazeny k aktuální iterační cestě týmu Fabrikam Fiber Web.
• Jsou nyní přiřazeny k aktuální iteraci +1 pro tým Fabrikam Fiber Web.
• Během posledních 30 dnů (délka sprintu) došlo ke změně.

WIQL

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]

Zobrazí se Editor Power Query zobrazení syntaxe, jak je znázorněno.

Poznámka

Editor Power Query vedle operátoru zobrazí Was Ever ikonu informací označující problém s klauzulí. Dotaz se ale pořád spouští a můžete vytvářet grafy dotazů. Pokud chcete upravit dotaz, musíte použít editor WIQL.

Zobrazení seznamu pracovních položek přidaných do sprintu po počátečním datu

Pokud chcete zobrazit seznam nově vytvořených pracovních položek přidaných do sprintu po počátečním datu, použijte dotaz podobný dotazu, který je zobrazený na následujícím obrázku. Tento dotaz funguje filtrováním pracovních položek přiřazených k aktuálnímu sprintu, ale byl vytvořen po zahájení data sprintu. Použijte klauzuli created Date = @Today - 28.

Další možnosti dotazování změn v oboru sprintu najdete v tématu Změna rozsahu sprintu.

Pole Cesta k datu a iteraci

K filtrování dotazů použijte pole Datum . Některá z těchto polí jsou naplněna informacemi, protože pracovní položka postupuje z jednoho stavu do druhého. Některé z těchto polí se ve formuláři pracovní položky nezobrazují, ale sledují se pro tyto typy pracovních položek uvedené v následující tabulce.

Název pole

Popis

Typy pracovních položek

---

Datum aktivace (poznámky 1 a 2)

Datum a čas, kdy byla pracovní položka vytvořena nebo kdy byl její stav změněn z Closed, Completednebo Done do nebo New do Active stavu.

Referenční název=Microsoft.VSTS.Common.ActivatedDate, Datový typ=DateTime

Chyba, žádost o změnu, námět, funkce, problém, položka backlogu produktu, požadavek, kontrola, riziko, sdílený krok, úloha, testovací případ, uživatelský scénář

Změnit datum

Datum a čas změny pracovní položky.

Referenční název=System.ChangedDate, Datový typ=DateTime

Všechny

Datum uzavření (poznámka 2)

Datum a čas uzavření pracovní položky.

Referenční název=Microsoft.VSTS.Common.ClosedDate, Datový typ=DateTime

Všechny

Datum vytvoření

Datum a čas vytvoření pracovní položky

Referenční název=System.CreatedDate, Datový typ=DateTime

Všechny

Termín splnění

Předpovídané termín splnění problému, který se má vyřešit.

Referenční název=Microsoft.VSTS.Scheduling.DueDate, Datový typ=DateTime

Problém (agilní)

Datum dokončení (poznámka 3)

Datum a čas, kdy plán označuje, že je úkol dokončen.

Referenční název=Microsoft.VSTS.Scheduling.FinishDate, Datový typ=DateTime

Požadavek, úkol, testovací plán, uživatelský scénář

Iteration Path

Seskupí pracovní položky podle pojmenovaných sprintů nebo časových období. Iterace musí být platným uzlem v hierarchii projektu. Pro projekt definujete cesty iterace a vyberete cesty iterace pro tým.

Referenční název=System.IterationPath, Datový typ=TreePath

Všechny

Vyřešené datum (poznámky 1 a 2)

Datum a čas, kdy byla pracovní položka přesunuta do Resolved stavu.

Referenční název=Microsoft.VSTS.Common.ResolvedDate, Datový typ=DateTime

Chyba, žádost o změnu, námět, funkce, problém, položka backlogu produktu, požadavek, kontrola, riziko, sdílený krok, úloha, testovací případ, uživatelský scénář

Počáteční datum (poznámka 3)

Datum a čas, kdy plán označuje, že úkol začíná.

Poznámka

Plány doručení používají pole Počáteční datum a Cílové datum k zobrazení rozsahu funkcí, námětů a dalších položek backlogu portfolia.

Referenční název=Microsoft.VSTS.Scheduling.StartDate, Datový typ=DateTime

Námět, funkce, požadavek, úkol, testovací plán, uživatelský scénář

Datum změny stavu

Datum a čas, kdy se hodnota pole Stát změnila.

Referenční název=Microsoft.VSTS.Common.StateChangeDate, Datový typ=DateTime

Všechny

Cílové datum

Datum dokončení nebo vyřešení funkce, pracovní položky nebo problému.

Poznámka

Plány doručení používají pole Počáteční datum a Cílové datum k zobrazení rozsahu funkcí, námětů a dalších položek backlogu portfolia.

Referenční název=Microsoft.VSTS.Scheduling.TargetDate, Datový typ=DateTime

Námět, funkce

Poznámky:

1. Viz také Dotaz podle přiřazení nebo změn pracovního postupu.

2. Aby tato pole byla definována pro typ pracovní položky, musí být zahrnuta v WORKFLOW části definice typu pracovní položky. Tato syntaxe je například zahrnuta v FIELDS definici při přechodu do Resolved stavu.

   XML

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

3. Hodnoty počátečního data a data dokončení se počítají, pokud v Projectu vytvoříte plán projektu a pak tento plán synchronizuje s úkoly uloženými v Azure Boards. Tato pole se nemusí zobrazit ve formuláři pracovní položky, ale počítají se pro položky backlogu a úkoly propojené s položkami backlogu. Jejich hodnoty jen pro čtení můžete zobrazit ve výsledcích dotazu nebo z Excelu.

   Důležité

   Integrace aplikace Microsoft Project a TFSFieldMapping příkaz nejsou podporovány pro:

   • Visual Studio 2019 a Azure DevOps Office Integration 2019
   • Azure DevOps Server 2019 a novější verze, včetně Azure DevOps Services

   Je zachována úplná podpora integrace Aplikace Microsoft Excel, která umožňuje hromadný import a aktualizaci pracovních položek. Alternativy k používání aplikace Microsoft Project zahrnují:

   • Plány doručení
   • Rozšíření Marketplace, jako je Project Connect nebo GANTTův diagram

Související články

• Dotazování podle změn přiřazení nebo pracovního postupu
• Definování cest iterace (sprint) a konfigurace iterací týmu
• Definování dotazu na pracovní položku v Azure Boards
• Dotazování polí, operátorů a maker
• Pole a atributy pracovní položky
• Syntaxe jazyka WIQL (Work Item Query Language)

REST API

Pokud chcete s dotazy pracovat prostřednictvím kódu programu, podívejte se na jeden z těchto prostředků rozhraní REST API:

• Referenční informace k rozhraní REST API služby Azure DevOps Services
• Dotazy
• Dotazovací jazyk pracovních položek
• Načítání pracovních položek pomocí dotazů prostřednictvím kódu programu