Dotazování podle data nebo aktuální iterace v Azure Boards

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.

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.

Poznámky:

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

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í.

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.

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ě.

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.

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.

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.

   <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