Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Felder "Bereichspfad" und "Iterationspfad" werden in allen Arbeitsaufgabenformularen für jeden Arbeitsaufgabentyp angezeigt. Sie definieren diese Pfade für Ihr Projekt – Bereichspfade und Iterationspfade – und wählen dann die Pfade aus, die Sie einem Team zuordnen möchten.
Informationen zum Arbeiten mit Bereichs- und Iterationspfaden finden Sie unter "Informationen zu Teams und Agile-Tools".
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied. – Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff. |
| Berechtigungen | Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt. |
Hinweis
Benutzer mit Beteiligtenzugriff für ein öffentliches Projekt besitzen ebenso wie Benutzer mit Standardzugriff Vollzugriff auf Abfragefunktionen. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied. – Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff. |
| Berechtigungen | Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt. |
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 Felder für Den Bereichspfad und Iterationspfad angeben, können Sie die folgenden Operatoren verwenden:
| Operator | Zweck |
|---|---|
= |
Spezifizieren Sie einen bestimmten Bereich oder einen Iterationspfad |
<> |
Filtern eines bestimmten Bereichs oder Iterationspfads |
In |
Filtern nach einer Gruppe von Bereichs- oder Iterationspfaden |
Not In |
Ausschließen von Elementen, die einem Satz von Bereichen oder Iterationspfaden zugewiesen sind |
Under |
Angeben aller Pfade unter einem ausgewählten Bereich oder Iterationspfad |
Not Under |
Elemente ausschließen, die einem bestimmten Bereich oder Iterationspfad zugewiesen sind |
Sie können die folgenden Makros verwenden, wenn Sie das Feld "Iterationspfad" auswählen. Beispiele finden Sie in den Abfragebeispielen auf dieser Seite.
| Makro | Zweck |
|---|---|
@CurrentIteration |
Angeben der aktuellen Iteration, die dem ausgewählten Teamkontext zugeordnet ist |
@CurrentIteration +/- n |
Filtern von Elementen basierend auf der Zuordnung zu einem Gleitfenster von Sprints, die dem ausgewählten Teamkontext zugeordnet sind |
@TeamAreas |
Filtern von Elementen auf der Grundlage von Bereichspfaden, die einem bestimmten Team zugewiesen sind |
Hinweis
Das Azure DevOps-Webportal wertet Makros wie @CurrentIteration, @CurrentIteration +/- nund @TeamAreas (Dienste und Server) aus. Nicht-Webclients (Visual Studio/Team Explorer, Excel, Project) und direkte WIQL/REST-Aufrufe erfordern explizite Bereichs-/Iterationspfade und akzeptieren keine unformatierten Makrotoken. Wenn Sie eine Abfrage in der Web-UI speichern, erweitert das Portal makros in der Regel auf konkrete Werte im gespeicherten WIQL– überprüfen Sie dieses Verhalten in Ihrer Umgebung, wenn Sie Abfragen außerhalb der Web-UI verwenden müssen.
Bereichspfadabfragen
Sie können mithilfe des In-Operators wie im folgenden Beispiel gezeigt nach Arbeitsaufgaben filtern, die mehreren Bereichspfaden zugewiesen sind.
Auf Knotenname und Schlüsselwort basierende Abfragen
Verwenden Sie das Feld Knotenname, um mit dem Operator Contains Arbeitsaufgaben nach einem Schlüsselwort zu filtern, die Bereichswegen zugewiesen sind. Der Knotenname gibt den letzten Knoten eines Bereichspfads an, der dem letzten Knoten in der Strukturhierarchie entspricht.
Die folgende Abfrage erzeugt dasselbe Ergebnis wie im vorherigen Beispiel.
In diesem Beispiel gibt der Filter Arbeitsaufgaben zurück, die einem Bereichspfad zugewiesen sind, dessen letzter Knoten das Wort "Azure" enthält.
Hier sehen Sie ein weiteres Beispiel, in dem der Knotenname und der Operator In verwendet werden:
Pfadabfragen von Teambereichen
Verwenden Sie das makro @TeamAreas , um Elemente zu finden, die den Bereichspfaden zugewiesen sind, die ein bestimmtes Team verwendet. Geben Sie den Operator = an. Der Abfrage-Editor fordert Sie auf, den Teamnamen einzugeben; wählen Sie das Team aus der vorgeschlagenen Liste aus.
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 jedes Feld gilt: Datenpfad =TreePath, meldefähiger Typ =Dimension, Indexattribut =True.
Wenn Sie einen Pfadnamen definieren, der länger als 256 Zeichen ist, können Sie ihn in Microsoft Project nicht angeben. Um dieses Problem zu vermeiden, definieren Sie Pfadnamen von nicht mehr als 10 Zeichen und verschachteln Sie Knoten nicht tiefer als 14 Ebenen.
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 Arbeitsaufgabenformularen angezeigt, aber Azure DevOps verfolgt sie für jeden Arbeitsaufgabentyp. Diese Felder stellen einen numerischen Wert für jeden Klassifizierungswert bereit, den Sie für ein Projekt definieren. 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, in dem Sie diese Arbeitsaufgabe zuweisen. | System.AreaId | Ganzzahl |
| Iterations-ID | Die eindeutige ID der Iteration, bei der Sie diese Arbeitsaufgabe zuweisen. | System.IterationId | Ganzzahl |
| 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 | String |
Der standardmäßige berichtsfähige Typ ist „none“. Bereichs-ID und Iterations-ID weisen Indizes auf. Der Knotenname funktioniert nicht. Weitere Informationen zu Feldattributen finden Sie unter Arbeitselementfelder und -attribute.
Verwandte Inhalte
- Kurzübersicht zu Abfragen
- Definieren von Bereichspfaden und Zuweisen zu einem Team
- Definieren von Iterationspfaden (Sprints) und Konfigurieren von Teamiterationen
- Berechtigungen und Zugriff für die Arbeitsverfolgung festlegen
REST-API
Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in den folgenden REST-API-Ressourcen: