Abfragen nach Bereichs- oder Iterationspfad

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

Der Bereichspfad und der Iterationspfad sind zwei Felder, die im Formular für die Arbeitsnachverfolgung für alle Arbeitselementtypen angezeigt werden. Sie definieren Bereichspfade und Iterationspfade für ein Projekt und wählen dann die aus, die Sie einem Team zuordnen möchten.

Informationen zum Arbeiten mit Bereichs- und Iterationspfaden finden Sie unter Informationen zu Teams und Agile-Tools.

Hinweis

Die folgenden Makros werden nur über das Webportal unterstützt: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity und @TeamAreas. Abfragen, die diese Makros enthalten, funktionieren nicht, wenn sie in Visual Studio/Team Explorer, Microsoft Excel oder Microsoft Project geöffnet werden.

Unterstützte Operatoren und Makros

Wenn Sie Abfragen erstellen und die Felder „Bereichspfad“ und „Iterationspfad“ angeben, können Sie die folgenden Operatoren verwenden:

Operator Zweck
= Angeben eines bestimmten Bereichs- oder Iterationspfads
<> Herausfiltern eines bestimmten Bereichs- oder Iterationspfads
In Filtern nach bestimmten Bereichs- oder Iterationspfaden
Not In Ausschließen von Elementen, die Bereichs- oder Iterationspfaden zugewiesen sind
Under Angeben aller Pfade unter einem ausgewählten Bereichs- oder Iterationspfad
Not Under Ausschließen von Elementen, die unter einem bestimmten Bereichs- oder Iterationspfad zugewiesen sind

Zusammen mit diesen Operatoren können Sie die folgenden Makros verwenden, wenn Sie den Iterationspfad auswählen. Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

Makro Zweck
@CurrentIteration Angeben der aktuellen Iteration, die dem ausgewählten Teamkontext zugeordnet ist
@CurrentIteration +/- n Filtern von Elementen basierend auf der Zuweisung zu einem gleitenden Fenster von Sprints, die dem ausgewählten Teamkontext zugeordnet sind
@TeamAreas Filtern von Elementen basierend auf Bereichspfaden, die einem bestimmten Team zugewiesen sind

Hinweis

Die Makros @CurrentIteration +/- n und @TeamAreas werden für Azure DevOps Server 2019 und höhere Versionen unterstützt. Diese Makros werden nur im Webportal unterstützt. Abfragen, die diese Makros enthalten, funktionieren nicht, wenn sie in Visual Studio/Team Explorer, Microsoft Excel oder Microsoft Project geöffnet werden.

Bereichspfadabfragen

Sie können angeben, dass nach Arbeitselementen gefiltert wird, die mehreren Bereichspfaden zugewiesen sind, indem Sie den Operator In verwenden, wie im folgenden Beispiel gezeigt:

Abfragen des Bereichspfads für mehrere Bereiche

Auf Knotenname und Schlüsselwort basierende Abfragen

Verwenden Sie das Feld Knotenname, um mithilfe des Operators Contains nach Arbeitselementen zu filtern, die Bereichspfaden auf der Grundlage eines Schlüsselworts zugeordnet sind. Der Knotenname gibt den letzten Knoten eines Bereichspfads an, der dem letzten Knoten in der Strukturhierarchie entspricht.

Die folgende Abfrage liefert das gleiche Ergebnis wie das vorherige Beispiel:

Abfragen des Knotennamens für mehrere Bereiche

In diesem Beispiel gibt der Filter alle Arbeitselemente zurück, die einem Bereichspfad zugeordnet sind, dessen letzter Knoten das Wort „Azure“ enthält.

Abfragen mehrerer Sprints

Hier sehen Sie ein weiteres Beispiel, in dem der Knotenname und der Operator In verwendet werden:

Abfragen des Knotennamens für mehrere Bereiche

Pfadabfragen von Teambereichen

Verwenden Sie das Makro @TeamAreas, um schnell Elemente zu finden, die den einem bestimmten Team zugeordneten Bereichspfaden zugewiesen sind. Geben Sie den Operator = an. Der Abfrage-Editor fordert Sie automatisch zur Eingabe des Teamnamens auf. Sie können es hinzufügen, indem Sie den Namen des Teams eingeben und den Teamwert auswählen, der in den Suchfilterkriterien erscheint.

Abfragen von Bereichspfaden, die einem Team zugewiesen sind

Klassifizierungsfeldverweis

Feldname Beschreibung Verweisname
Bereichspfad Gruppiert Arbeitselemente in Produktfunktions- oder Teambereichen. Der Bereich muss ein gültiger Knoten in der Projekthierarchie sein. System.AreaPath
Iterationspfad Gruppiert Arbeitselementen nach benannten Sprints oder Zeiträumen. Die Iteration muss ein gültiger Knoten in der Projekthierarchie sein. System.IterationPath

Für die einzelnen Felder gilt Folgendes: Datenpfad=TreePath, berichtsfähiger Typ=Dimension, Indexattribut=True.

Wenn Sie einen Pfadnamen mit mehr als 256 Zeichen definieren, können Sie ihn nicht in Microsoft Project angeben. Sie vermeiden dieses Problem, indem Sie Pfadnamen mit höchstens 10 Zeichen definieren und keine Knoten in einer Tiefe von mehr als 14 Ebenen schachteln.

Die meisten Feldregeln können nicht auf die Systemfelder wie „System.AreaPath“ und „System.IterationPath“ angewendet werden. Weitere Informationen finden Sie unter Regeln und Regelauswertung.

Die folgenden Felder werden nicht in Arbeitselementformularen angezeigt, sondern für die einzelnen Arbeitselementtypen nachverfolgt. Diese Felder liefern einen numerischen Wert für jeden Klassifizierungswert, der für ein Projekt definiert wird. Sie können diese Felder verwenden, um Abfragen zu filtern und Berichte zu erstellen.

Feldname Beschreibung Verweisname Datentyp
Bereichs-ID Die eindeutige ID des Bereichs, dem diese Arbeitsaufgabe zugewiesen ist. System.AreaId Integer
Iterations-ID Die eindeutige ID der Iteration, der diese Arbeitsaufgabe zugewiesen ist. System.IterationId Integer
Node Name (Knotenname) Der Name des letzten Knotens eines Bereichspfads. Wenn der Bereichspfad z. B. "Project\A1\B2\C3" ist, ist der Name des Knotens "C3". System.NodeName Zeichenfolge

Der standardmäßige berichtsfähige Typ ist „none“. Bereichs-ID und Iterations-ID sind indiziert, der Knotenname hingegen nicht. Weitere Informationen zu Feldattributen finden Sie unter Arbeitselementfelder und -attribute.

REST-API

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in den folgenden REST-API-Ressourcen: