Abfragen nach Datum oder aktueller Iteration in Azure Boards

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

Wenn Sie Arbeitselemente basierend auf dem Zeitpunkt auflisten möchten, wann sie erstellt, geschlossen, aufgelöst oder geändert wurden, können Sie ein Datum angeben oder ein unterstütztes Makro verwenden. Verwenden Sie das @Today Makro, und geben Sie eine Plus- oder Minusanzahl von Tagen für relative Datumsangaben an. Verwenden Sie für Abfragen, die Arbeitselemente basierend auf ihrer Zuweisung zum aktuellen Sprint eines Teams auflisten @CurrentIteration.

Sie können beispielsweise Arbeitselemente finden, die in den letzten drei Tagen mit der folgenden Abfrage geändert wurden.

Screenshot: Abfrage-Editor, Geändertes Datum >= 3.

Screenshot: Abfrage-Editor, Filter basierend auf den letzten Änderungen.

Außerdem können Sie das CurrentIteration +/- _n_ Makro verwenden, um Abfragen basierend auf einem gleitenden Fenster von Teamiterationen zu erstellen.

Unterstützte Operatoren und Makros

Abfrageklauseln, die ein DateTime-Feld oder den Iterationspfad angeben, können die in der folgenden Tabelle aufgeführten Operatoren und Makros verwenden.


Datentyp

Unterstützte Operatoren und Makros


DateTime

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

Makros: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYearund @Today.
Sie können +/- n mit jedem der unterstützten Makros verwenden.


TreePath

= , <> unter, nicht unter
Makros: @CurrentIteration2 und @CurrentIteration +/- n3 gültig mit dem Feld Iterationspfad .


DateTime

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makros: @Today , die Sie mit +/- n Integer angeben können.


TreePath

=, <> , Under, MakrosNot Under: @CurrentIteration2 ist für das Feld Iterationspfad gültig.


Hinweise:

  1. Die @StartOfDayMakros , @StartOfWeek, @StartOfMonthwerden @StartOfYear für Azure DevOps Server 2019.1 und höhere Versionen und nur dann unterstützt, wenn sie über das Webportal ausgeführt werden.
  2. Das @CurrentIteration +/- n Makro wird für Azure DevOps Server 2019 und höhere Versionen und nur bei Ausführung über das Webportal unterstützt.

Tipp

Der WasEver Operator kann mit dem Feld Iterationspfad verwendet werden, aber nur, wenn er über die WIQL-Syntax definiert ist. Ein Beispiel finden Sie unter WiQL-Syntaxreferenz (Work Item Query Language).

Datums- und Uhrzeitmuster

Das Datums- und Uhrzeitmuster, das Sie für DateTime-Felder eingeben, sollte mit dem übereinstimmen, das Sie in Ihrem Profil auswählen. Informationen zum Anzeigen oder Ändern Ihrer Auswahl finden Sie unter Festlegen von Benutzereinstellungen, Uhrzeit und Gebietsschema.

Seite

Seite

Clienteinschränkungen für die Verwendung der @CurrentIteration Makros

Sie können das @CurrentIteration Makro in einer Abfrage von den folgenden Clients verwenden:

  • Webportal, das eine Verbindung mit Azure Boards herstellt
  • Visual Studio 2019 oder höhere Versionen, die mit Azure Boards verbunden sind
  • Verwenden der REST-API.

Sie können das @CurrentIteration +/- n Makro in einer Abfrage für Azure Boards, Azure DevOps Server 2019 und höhere Versionen und mit einer REST-API verwenden, die das Team als Parameter enthält, @CurrentIteration('[Project]/Team')z. B. .

Ein Fehler tritt auf, wenn Sie eine Abfrage öffnen, die das @CurrentIteration Makro in früheren Versionen von Visual Studio oder aus Excel oder Project enthält. Außerdem können Sie das Makro nicht beim Kopieren oder Klonen von Testsammlungen und Testfällen, beim Definieren von Warnungen oder mit REST-APIs verwenden.

Datumsbasierte Abfragen

Sie können Arbeitsaufgaben nach dem Änderungsdatum oder nach einem bestimmten Zeitraum filtern. Das Einschränken des Bereichs Ihrer Abfrage kann bei der Leistung hilfreich sein, indem nur Ergebnisse zurückgegeben werden, die dem von Ihnen eingeschlossenen Datumsbereich entsprechen. Wenn Sie mit dem Erstellen von Abfragen noch nicht fertig sind, finden Sie weitere Informationen unter Verwenden des Abfrage-Editors zum Auflisten und Verwalten von Abfragen.

Nicht alle Felder sind für alle Arbeitselementtypen gültig. Springen Sie zu Datumsfeldern für den Satz von Feldern, die Sie in Abfragen einschließen können, und für welche Arbeitselementtypen sie gelten.

Tipp

Denken Sie daran, Datumsangaben in das Datumsmuster einzugeben, das Sie für Ihr persönliches Profil festgelegt haben.


Filtern nach

Einschließen dieser Abfrageklauseln


Elemente, die in den letzten 30 Tagen erstellt wurden

Screenshot: Abfrage-Editor, Klausel zum Suchen von Elementen, die in den letzten 30 Tagen erstellt wurden


Elemente, die zu einem bestimmten Datum geändert wurden

Screenshot: Abfrage-Editor: Klausel zum Suchen von Elementen, die zu einem bestimmten Datum geändert wurden.


Elemente, die heute aufgelöst wurden

Screenshot: Abfrage-Editor, Klausel zum Suchen von Elementen, die heute aufgelöst wurden.


Elemente, die innerhalb eines angegebenen Zeitraums geschlossen wurden

Screenshot: Abfrage-Editor, Klausel zum Suchen von Elementen, die innerhalb eines angegebenen Zeitraums geschlossen wurden.


Elemente, die nicht geschlossen wurden (Geschlossener Termin ist NULL)

Screenshot: Abfrage-Editor, Klausel zum Suchen von Elementen, deren Geschlossener Termin leer oder NULL ist.


Elemente, deren Status innerhalb der letzten Woche aktualisiert wurde

Screenshot: Abfrage-Editor, Klausel für Elemente, deren Status innerhalb der letzten Woche aktualisiert wurde


Während des aktuellen Sprints geschlossene Elemente (das @CurrentIteration Makro verweist auf den Sprint, der für den aktuellen Teamkontext definiert ist)

Screenshot: Abfrage-Editor, Klausel für Elemente, die während des aktuellen Sprints geschlossen wurden


Tipp

Informationen zum Gruppieren AND/OR von Klauseln finden Sie unter Erstellen und Speichern von verwalteten Abfragen, Gruppenklauseln. Um die WIQL-Syntax für eine Abfrage anzuzeigen, installieren Sie die WIQL-Abfrage-Editor-Erweiterung , mit der Sie die WIQL-Version eines beliebigen Abfrage-Editor-Eintrags anzeigen können.

Erstellen von datumsbasierten Abfragen am Anfang von Tag, Woche, Monat oder Jahr

Die folgenden Beispiele zeigen, wie Sie die StartOf...- Makros verwenden, um nach Arbeitselementen mit verschiedenen Offsets zu filtern. Weitere Beispiele für die Verwendung dieser Makros finden Sie unter WIQL-Syntax.

Hinweis

Erfordert Azure DevOps Server 2019 Update 1 oder höher.

Filtern nach

Einschließen dieser Abfrageklauseln


Fehler wurden in den letzten zwei Wochen geschlossen

Screenshot: Abfrage-Editor: Klauseln zum Ermitteln von Fehlern, die in den letzten zwei Wochen geschlossen wurden.


Elemente, die in den letzten 10 Tagen geändert wurden

Screenshot: Abfrage-Editor, Klausel zum Suchen von Elementen, die in den letzten 10 Tagen geändert wurden


Features, die in den nächsten drei Monaten abgeschlossen werden sollen

Klauseln für Features, die in den nächsten 3 Monaten abgeschlossen werden sollen.


Nicht alle Felder sind für alle Arbeitselementtypen gültig. Springen Sie zu Datumsfeldern für den Satz von Feldern, die Sie in Abfragen einschließen können, und für welche Arbeitselementtypen sie gelten.

Erstellen von Abfragen für die aktuelle Iteration Ihres Teams

Wenn Ihr Team Scrum-Prozesse befolgt, planen Sie die Ausführung der Arbeit in Sprints. Sie können den Fortschritt von Anforderungen, Fehlern und anderen Arbeiten, die im aktuellen Sprint abgeschlossen werden sollen, mithilfe des makros @CurrentIteration nachverfolgen.

Es wird ein element gefunden, das einem Sprint zugewiesen ist, das dem aktuellen Iterationspfad für das Team entspricht. Wenn sich ein Team beispielsweise in Sprint 5 befindet, gibt die Abfrage Elemente zurück, die Sprint 5 zugewiesen sind. Wenn das Team später in Sprint 6 arbeitet, gibt dieselbe Abfrage Elemente zurück, die Sprint 6 zugewiesen sind.

Hinweis

Damit das @CurrentIteration Makro funktioniert, muss das Team einen Iterationspfad ausgewählt haben, dessen Datumsbereich das aktuelle Datum umfasst. Ausführliche Informationen finden Sie unter Definieren von Iterationspfaden (auch als Sprints bezeichnet) und Konfigurieren von Teamiterationen. Außerdem sind Abfragen, die dieses Makro enthalten, nur gültig, wenn sie über das Webportal ausgeführt werden.

Siehe auch Client restrictions on the use of the @CurrentIteration macros weiter unten in diesem Artikel.

Azure Boards fügt einen Teamparameter hinzu, wenn Sie die Makros @CurrentIteration oder @CurrentIteration +/- n auswählen. Der Teamparameter wird aus Ihrem aktuellen Teamkontext abgeleitet.

Abfragefilter mithilfe des CurrentIteration-Makros mit team-Parameter

Tipp

Wenn das @CurrentIteration Makros nicht funktioniert, überprüfen Sie, ob die erwartete Iteration für Ihr Team ausgewählt ist und dass dafür Datumsangaben festgelegt wurden.

Um den team-Parameter zu ändern, den das System automatisch festlegt, wählen Sie ihn aus, indem Sie den Namen des Teams in das Parameterfeld eingeben, das unterhalb des makros @CurrentIteration hinzugefügt wurde.

Auswählen des Teamparameters

Stellen Sie vor dem Erstellen oder Aktualisieren einer Abfrage zur Verwendung des @CurrentIteration Makros sicher, dass Sie Ihr Team auswählen. Das makro @CurrentIteration verweist auf das aktuelle Team, das im Webportal ausgewählt wurde.

Abfragefilter mithilfe des CurrentIteration-Makros

Erstellen eines gleitenden Fensters der Iterationsabfrage Ihres Teams

Verwenden Sie das Makro @CurrentIteration +/- n , wenn Sie die Arbeit nachverfolgen möchten, die ein Team für bevorstehende Sprints geplant hat, und um Die Arbeit zu verstehen, die in früheren Sprints noch nicht abgeschlossen wurde.

Hinweis

Damit das Makro @CurrentIteration +/- n funktioniert, muss das Team Iterationspfade ausgewählt haben, die die +/- n Kriterien erfüllen, und Datumsbereiche umfassen das aktuelle Datum für die @CurrentIteration. Ausführliche Informationen zur Teamauswahl von Iterationspfaden finden Sie unter Definieren von Iterationspfaden (Sprintpfaden) und Konfigurieren von Teamiterationen.

Siehe auch Client restrictions on the use of the @CurrentIteration macros weiter unten in diesem Artikel.

Hier wird gezeigt, wie Sie alle User Storys und Fehler auflisten, die dem gleitenden Fenster zugewiesen sind, das sich über die letzten beiden, den aktuellen und die nächsten beiden Sprints erstreckt, die für das Cloud Admin- und Tools-Team ausgewählt sind.

CurrentIteration-Plus- und Minusklauseln

Um dieses Makro verwenden zu können, muss das angegebene Team eine Reihe von Sprints ausgewählt haben, die den +/- für das Makro eingegebenen Wert n umfassen.

Auflisten von Arbeitselementen, die aus einem Sprint verschoben wurden

Sie können Arbeitselemente auflisten, die für einen Sprint definiert, aber später verschoben wurden, indem Sie eine Abfrage mit einer Klausel verwenden, die den Was Ever-Operator für den Iterationspfad enthält. Sie können diese Abfrage nur mit der WIQL-Syntax erstellen. Sie können die WIQL-Syntax im Abfrage-Editor bearbeiten, indem Sie die Marketplace-Erweiterung für Wiql-Editor installieren.

Die folgende Syntax fragt beispielsweise Arbeitselemente ab, die die folgenden Kriterien erfüllen:

  1. Definiert im aktuellen Projekt
  2. Arbeitselementtyp entspricht User Story oder Bug
  3. Arbeitselemente befinden sich unter dem Bereichspfad des Fabrikam Fiber-Webteams.
  4. Arbeitselemente befinden sich nicht im Status "Geschlossen", "Abgeschlossen", "Ausschneiden" oder "Aufgelöst"
  5. Nicht im aktuellen Iterationspfad für das Fabrikam Fiber Web-Team
  6. Sie wurden jedoch dem aktuellen Iterationspfad für das Fabrikam Fiber Web-Team zugewiesen.
  7. Sind jetzt der aktuellen Iteration +1 für das Fabrikam Fiber Web-Team zugewiesen
  8. Und wurden innerhalb der letzten 30 Tage (die Länge des Sprints) geändert.
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]

Die Abfrage-Editor Ansicht der Syntax wird wie gezeigt angezeigt angezeigt.

Hinweis

Die Abfrage-Editor zeigt ein Informationssymbol neben dem Was Ever-Operator an, das auf ein Problem mit der -Klausel hinweist. Die Abfrage wird jedoch weiterhin ausgeführt, und Sie können Abfragediagramme erstellen. Zum Ändern der Abfrage müssen Sie jedoch den WIQL-Editor verwenden.

Screenshot: Abfrage-Editor, Arbeitselemente wurden aus einem Sprint verschoben.

Auflisten von Arbeitselementen, die einem Sprint nach dem Startdatum hinzugefügt wurden

Um neu erstellte Arbeitselemente auflisten, die einem Sprint nach dem Startdatum hinzugefügt wurden, verwenden Sie eine Abfrage ähnlich der in der folgenden Abbildung gezeigten. Diese Abfrage filtert nach Arbeitselementen, die dem aktuellen Sprint zugewiesen sind, aber nach dem Start des Sprintdatums erstellt wurden. In diesem Beispiel wird dies mit der klausel erstellt Date = @Today - 28 erreicht.

Screenshot: Abfrage-Editor, Arbeitselemente neu erstellt und einem Sprint nach dem Startdatum hinzugefügt

Weitere Optionen zum Abfragen von Änderungen am Sprintbereich finden Sie unter Informationen zu Sprints, Scrum und Projektmanagement, Änderung des Sprintbereichs.

Datums- und Iterationspfadfelder

Sie können Datumsfelder verwenden, um Ihre Abfragen zu filtern. Einige dieser Felder werden mit Informationen aufgefüllt, wenn ein Arbeitselement von einem Zustand in einen anderen fortschreitet. Einige dieser Felder werden nicht im Arbeitselementformular angezeigt, werden aber für die in der folgenden Tabelle aufgeführten Arbeitselementtypen nachverfolgt.

Feldname

Beschreibung

Arbeitselementtypen


Aktiviertes Datum (Hinweise 1 und 2)

Das Datum und die Uhrzeit, zu der die Arbeitsaufgabe erstellt wurde oder zu der ihr Status von "Geschlossen", "Abgeschlossen" oder "Fertig" in den Zustand "Neu" oder "Aktiv" geändert wurde.
Reference name=Microsoft.VSTS.Common.ActivatedDate, Data type=DateTime

Bug, Change Request, Epic, Feature, Issue, Product Backlog Item, Requirement, Review, Risk, Shared Step, Task, Test Case, User Story

Datum ändern

Das Datum und die Uhrzeit der Änderung eines Arbeitselements.
Verweisname=System.ChangedDate, Datentyp=DateTime

All

Stichtag (Hinweis 2)

Das Datum und die Uhrzeit, zu der ein Arbeitselement abgeschlossen wurde.
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

All

Erstellt am

Das Datum und Uhrzeit, zu der ein Arbeitselement erstellt wurde.
Verweisname=System.CreatedDate, Datentyp=DateTime

All

Due Date

Das geplante Fälligkeitsdatum, bis zu dem ein Problem behoben wird.
Reference name=Microsoft.VSTS.Scheduling.DueDate, Data type=DateTime

Problem (Agile)

Enddatum (Hinweis 3)

Das Datum und die Uhrzeit für den Abschluss der Aufgabe gemäß dem Zeitplan.
Reference name=Microsoft.VSTS.Scheduling.FinishDate, Data type=DateTime

Anforderung, Aufgabe, Testplan, User Story

Iterationspfad

Gruppiert Arbeitselementen nach benannten Sprints oder Zeiträumen. Die Iteration muss ein gültiger Knoten in der Projekthierarchie sein. Sie definieren Iterationspfade für ein Projekt und wählen Iterationspfade für ein Team aus, definieren Iterationspfade für ein Projekt und wählen Iterationspfade für ein Team aus.
Verweisname=System.IterationPath, Datentyp=TreePath

All

Datum der Auflösung (Hinweise 1 und 2)

Das Datum und die Uhrzeit, zu dem das Arbeitselement in den Status Aufgelöst verschoben wurde.
Reference name=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime

Bug, Change Request, Epic, Feature, Issue, Product Backlog Item, Requirement, Review, Risk, Shared Step, Task, Test Case, User Story

Startdatum (Hinweis 3)

Das Datum und die Uhrzeit für den Start der Aufgabe gemäß dem Zeitplan.

Hinweis

Übermittlungspläne verwenden das Startdatum und das Zieldatum , um die Spanne von Features, Epics und anderen Portfoliobacklogelementen anzuzeigen.

Reference name=Microsoft.VSTS.Scheduling.StartDate, Data type=DateTime

Epic, Feature, Anforderung, Aufgabe, Testplan, User Story

Datum der Zustandsänderung

Das Datum und die Uhrzeit, zu der das Zustandsfeld geändert wurde.
Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

All

Zieldatum

Das Datum, bis zu dem ein Feature, ein Arbeitselement oder ein Problem abgeschlossen oder behoben werden soll.

Hinweis

Übermittlungspläne verwenden das Startdatum und das Zieldatum , um die Spanne von Features, Epics und anderen Portfoliobacklogelementen anzuzeigen.

Reference name=Microsoft.VSTS.Scheduling.TargetDate, Data type=DateTime

Epic, Feature

Hinweise:

  1. Weitere Informationen finden Sie unter Abfragen nach Zuordnung oder Workflowänderungen, Datum und Identität.

  2. Damit diese Felder für ein WIT definiert werden können, müssen sie im WORKFLOW Abschnitt der WIT-Definition enthalten sein. Diese Syntax ist beispielsweise in der FIELDS Definition enthalten, wenn sie in den Status Aufgelöst übergehen:

     <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
        <SERVERDEFAULT from="clock"  />  
     </FIELD >  
    
  3. Die Felder Startdatum und Enddatum werden berechnet, wenn Sie einen Projektplan in Microsoft Project erstellen und diesen Plan dann mit Vorgängen synchronisieren, die in Azure Boards gespeichert sind. Diese Felder werden möglicherweise nicht im Arbeitselementformular angezeigt, werden aber für die Backlogelemente und Aufgaben berechnet, die mit Backlogelementen verknüpft sind. Sie können ihre schreibgeschützten Werte in Ergebnissen aus einer Abfrage oder aus Microsoft Excel anzeigen.

    Wichtig

    Die Microsoft Project-Integration und der TFSFieldMapping-Befehl werden für Folgendes nicht unterstützt:

    • Visual Studio 2019 und Azure DevOps Office® Integration 2019
    • Azure DevOps Server 2019 und höher, einschließlich Azure DevOps Services.

    Die Vollständige Unterstützung für die Microsoft Excel-Integration wird jedoch beibehalten und unterstützt den Massenimport und die Aktualisierung von Arbeitselementen. Alternativen zur Verwendung von Microsoft Project sind die folgenden:

Informationen zum Abfragen von Elementen basierend auf Text, der im Feld Verlauf eingegeben wurde, finden Sie unter Verlauf und Überwachung.

REST-API

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie unter einer der folgenden REST-API-Ressourcen: