Definieren einer Arbeitselementabfrage

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

Visual Studio 2019 | Visual Studio 2022

Arbeitselementabfragen in Azure Boards generieren Listen von Arbeitselementen basierend auf den von Ihnen angegebenen Filterkriterien. Sie können diese verwalteten Abfragen speichern und für andere freigeben.

Sehen Sie sich die empfohlenen bewährten Methoden weiter unten in diesem Artikel an.

Voraussetzungen

Auswählen eines Abfragefilters

Wählen Sie im Abfrage-Editor den Filter aus, um zu einem Artikel mit Beispielabfragen zu wechseln. Zusammen mit den Abfragefiltern können Sie Filter interaktiv auf Abfrageergebnisse anwenden.

Mithilfe der Funktion Filtern können Sie eine Abfrage interaktiv filtern.

Öffnen von Abfragen

Definieren einer Abfrage für eine Flatlist

Starten Sie eine neue Abfrage über die Registerkarte Abfragen im Webportal oder über die Registerkarte Arbeitselemente in Team Explorer.

Projektübergreifende Abfragen oder Abfragen innerhalb von Projekten

Neue Abfragen beziehen sich standardmäßig auf das aktuelle Projekt. Sie können jedoch Abfragen erstellen, um Arbeitselemente zu finden, die innerhalb der Organisation oder Projektsammlung definiert sind. Alle Abfragen, die Sie speichern, werden jedoch unter einem bestimmten Projekt gespeichert.

Definieren einer Klausel

Um eine Abfrage zu erstellen, definieren Sie mindestens eine Klausel. Jede Klausel definiert ein Filterkriterium für ein einzelnes Feld.

Beispielabfrageklausel

Eine Liste der verfügbaren Operatoren basierend auf dem Felddatentyp finden Sie unter Abfrageindex-Kurzreferenz.

Alle Klauseln werden als AND-Anweisung hinzugefügt. Wählen Sie OR aus, um die Gruppierung zu ändern. Sie können Klauseln gruppieren, um sicherzustellen, dass die Klauselanweisungen in der festgelegten Reihenfolge ausgeführt werden.

Prüfliste für das Definieren einer Abfrageklausel

1. Wählen Sie in der ersten leeren Zeile unter der Spaltenüberschrift Feld den Pfeil nach unten aus, um die Liste der verfügbaren Felder anzuzeigen, und wählen Sie anschließend ein Element in der Liste aus. Weitere Informationen finden Sie unter Abfragefelder und -werte.

2. Wählen Sie auf der gleichen Zeile unter der Spaltenüberschrift Operator den Pfeil nach unten aus, um die Liste der verfügbaren Operatoren anzuzeigen, und wählen Sie anschließend ein Element in der Liste aus. Weitere Informationen finden Sie unter Operatoren.

3. Geben Sie auf der gleichen Zeile unter der Spaltenüberschrift Wert einen Wert ein, oder wählen Sie den Pfeil nach unten und dann ein Element in der Liste aus. Weitere Informationen zur Verwendung eines Makros oder einer Variablen zum Angeben des aktuellen Projekts, Benutzers, Datums oder einer anderen Auswahl finden Sie unter Variablen.

4. Wenn Sie eine Klausel hinzufügen möchten, wählen Sie Neue Klausel hinzufügen aus.

   Sie können am Ende der Abfrage eine Klausel hinzufügen oder die folgenden Aufgaben mit den entsprechenden Symbolen ausführen:

   • Neue Filterzeile einfügen
   • Diese Filterzeile entfernen
   • Ausgewählte Klauseln gruppieren
   • Gruppierung der Klauseln aufheben

Verwenden einer Arbeitselementstruktur zum Anzeigen von Hierarchien

Verwenden Sie die Abfrage Tree of Work Items (Struktur der Arbeitselemente), um eine geschachtelte Arbeitselementliste mit mehreren Ebenen anzuzeigen. Beispielsweise können alle Backlogelemente und deren verknüpften Aufgaben angezeigt werden. Wenn Sie sich auf verschiedene Teile der Struktur konzentrieren möchten, wählen Sie Alle erweitern oder Alle reduzieren aus.

Verwenden von Direktlinks zum Anzeigen von Abhängigkeiten

Verwenden Sie die Abfrage Work items and Direct links (Arbeitselemente und Direktlinks), um Arbeitselemente nachzuverfolgen, die von anderen nachverfolgten Aufgaben abhängig sind, z. B. Tasks, Fehler, Probleme oder Funktionen. Beispielsweise können Sie Backlog Items anzeigen, die von der Implementierung anderer Elemente oder der Behebung eines Fehlers abhängig sind.

Verwenden Sie die Direktlinkabfrage, um Abhängigkeiten teamübergreifend nachzuverfolgen. Die Abfrage hilft Ihnen auch bei der Verwaltung der von Ihrem Team getätigten Zusagen. Wählen Sie die Filterkriterien für die obersten und verknüpften Arbeitselemente aus. Wählen Sie außerdem die Typen von Links aus, um die Abhängigkeiten zu filtern.

Weitere Informationen zu den einzelnen Linktypen finden Sie unter Referenz zu Linktypen.

Verwenden logischer AND-/OR-Ausdrücke

Sie geben And oder Or an, um logische Ausdrücke der Abfrageklauseln zu erstellen. Verwenden Sie And, wenn Sie nach Arbeitselementen suchen möchten, die die Kriterien in der aktuellen Klausel und in der vorherigen Klausel erfüllen. Verwenden Sie Or, wenn Sie nach Arbeitselementen suchen möchten, die die Kriterien in der aktuellen oder der vorherigen Klausel erfüllen.

Fügen Sie eine neue Klausel für jedes Arbeitselementfeld hinzu, um Ihre Suchkriterien zu verfeinern. Fügen Sie Klauseln hinzu, um nur die gewünschte Arbeitselementmenge zurückzugeben. Wenn Sie nicht die Ergebnisse erhalten, die Sie von Ihrer Abfrage erwarten, verfeinern Sie sie. Sie können Abfrageklauseln hinzufügen, entfernen, gruppieren oder eine Gruppierung aufheben, um Ihre Abfrageergebnisse zu verbessern.

Gruppieren Sie Abfrageklauseln, um als einzelne Einheit getrennt vom Rest der Abfrage zu arbeiten. Das Gruppieren von Klauseln ähnelt dem Einschließen eines Ausdrucks in Klammern in einer mathematischen Gleichung oder Logikanweisung. Wenn Sie Klauseln gruppieren, wird der And- bzw. Or-Operator für die erste Klausel der Gruppe auf die gesamte Gruppe angewandt.

Gruppieren von Klauseln

Gruppierte Klauseln werden als einzelne Einheit getrennt vom Rest der Abfrage ausgeführt. Das Gruppieren von Klauseln ist vergleichbar mit dem Einfügen von Klammern in eine mathematische Gleichung oder einen logischen Ausdruck. Der And- bzw. Or-Operator für die erste Klausel der Gruppe gilt für die gesamte Gruppe.

Wie die folgenden Beispiele zeigen, werden die gruppierten Klauseln in den entsprechenden logischen Ausdruck übersetzt.

Abfrage	Gruppierte Klauseln	Logischer Ausdruck.
1
2
3

Diese Abfragen geben Arbeitselemente vom Typ „Fehler“ zurück und erfüllen die folgenden logischen Ausdrücke:

• Abfrage 1: AND State=Active OR Assigned to @Me
• Abfrage 2: AND (State=Active OR Assigned to @Me)
• Abfrage 3: OR (State=Active AND Assigned to @Me)

Zum Gruppieren von Klauseln wählen Sie diese und dann das Symbol zum Gruppieren von Klauseln aus.

Sie können auch mehrere gruppierte Klauseln gruppiert. Aktivieren Sie die Kontrollkästchen jeder Klausel. Wählen Sie dann das -Gruppenklauselnsymbol aus.

Wenn die Abfrageergebnisse nicht den erwarteten Ergebnissen entsprechen, führen Sie die folgenden Schritte aus:

• Stellen Sie sicher dass jede Klausel wie beabsichtigt definiert wurde.
• Überprüfen Sie die And/Or-Zuordnungen jeder Klausel. Wenn die Ergebnisse mehr Arbeitselemente als erwartet enthalten, wurde häufig eine Or-Klausel anstelle einer And-Klausel verwendet.
• Ermitteln Sie, ob Sie die Gruppierung der Abfrageklauseln und der And/Or-Zuweisungen der einzelnen gruppierten Klauseln gruppieren oder ändern müssen.
• Fügen Sie weitere Abfrageklauseln hinzu, um die Abfragefilterkriterien zu präzisieren.
• Überprüfen Sie die verfügbaren Optionen zum Angeben von Feldern, Operatoren und Werten.
• Weitere Informationen finden Sie unter den bewährten Methoden weiter unten in diesem Artikel.

Aufheben der Gruppierung einer Klausel

Um die Gruppierung einer Klausel aufzuheben, wählen Sie das Symbol zum Aufheben der Gruppierung von Klauseln für die gruppierte Klausel aus.

Festlegen der Standardspaltenbreite in Abfrageergebnissen

Führen Sie die folgenden Schritte aus, um die Standardspaltenbreite in Abfrageergebnissen festzulegen:

1. Öffnen Sie die Abfrage aus, die Sie ändern möchten.
2. Passen Sie die Spaltenbreiten manuell an die gewünschte Größe an, indem Sie die Ränder der Spaltenüberschriften ziehen.
3. Wählen Sie Speichern oder Speichern als aus, wenn Sie sie als neue Abfrage speichern möchten.
4. Schließen Sie die Abfrage, und öffnen Sie sie erneut, um sicherzustellen, dass die Spaltenbreiten beibehalten werden.

Azure DevOps unterstützt derzeit nicht das Festlegen einer Standardspaltenbreite, die in allen Sitzungen beibehalten wird. Die Spaltenbreiten werden pro Abfrage gespeichert, daher müssen Sie sie für jede Abfrage einzeln anpassen und speichern.

Anzeigen von Abfrageergebnissen in einem Dashboard

Die folgenden beiden Widgets zeigen Abfrageergebnisse an. Sie können Arbeitselemente direkt über diese Widgets öffnen.

• Mir zugewiesene Arbeit: Listet alle vorgeschlagenen oder aktiven Arbeitselemente auf, die dem angemeldeten Benutzer zugewiesen sind. Listet die Felder „ID“, „Status“ und „Titel“ auf.
• Abfrageergebniswidget: Zeigt die Ergebnisse einer Flatlist-, Struktur- oder Direktlinkabfrage an. Sie können die über das Widget angezeigten Felder konfigurieren, die Größe der Spaltenfelder ändern sowie Struktur- und Direktlinkabfragen erweitern und reduzieren.

Weitere Informationen finden Sie unter Hinzufügen von Widgets zu einem Dashboard.

Definieren einer Abfrage als Link

Für einen Abfragelink wird die mit Transact-SQL vergleichbare Work Item Query Language (WIQL) verwendet. Weitere Informationen finden Sie unter Syntax für die Arbeitselement-Abfragesprache (Work Item Query Language, WIQL).

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'   

Bewährte Methoden

Die folgenden bewährten Methoden gelten für die folgenden Abfragen, die Sie erstellen können:

Erstellen gezielter selektiver Abfragen

Definieren Sie eine hochgradig selektive Abfrage, indem Sie alle Filter anwenden, die für Ihre Abfrage erforderlich sind. Je selektiver die Abfrage, desto kleiner das Resultset. Je kleiner das Resultset, desto gezielter und selektiver die Abfrage.

Kategorisieren von Arbeitselementen mithilfe von Tags

Verwenden Sie Arbeitselementtags, um Ihre Arbeitselemente zu kategorisieren, anstelle eines benutzerdefinierten Felds. Abfragen mit tagbasierter Filterung sind in der Regel schneller als Abfragen, bei denen nach Zeichenfolgenüberstimmungen gefiltert wird.

Anders als bei Übereinstimmungen mit benutzerdefinierten Feldern oder bei partiellen Übereinstimmungen ist bei einer Abfrage mit einem Vorgang vom Typ Tags Contains keine vollständige Überprüfung aller Arbeitselementtabellen erforderlich.

Verwenden von Contains words zum Abfragen übereinstimmender Zeichenfolgen

Wenn Sie nach einer Zeichenfolgenübereinstimmung filtern möchten, verwenden Sie den Operator Contains Words anstelle des Operators Contains. Der Operator Contains Words führt eine Volltextsuche für das angegebene Feld aus, die in der Regel schneller abgeschlossen wird.

Der Contains-Operator führt einen Tabellenscan durch. Dieser Vorgang ist langsamer als beim Contains Words-Operator. Außerdem werden mehr CPU-Zyklen beansprucht. Diese CPU-Zyklen können zu Ratenbegrenzungen führen. Weitere Informationen finden Sie unter Grenzwerte für Rate und Nutzung.

Angeben kleiner Gruppen mit dem Operator In Group

Der Operator In Group filtert Arbeitselemente basierend auf Übereinstimmungen innerhalb einer Gruppe von Werten. Die Gruppe von Werten entspricht denen, die in einem Team, einer Sicherheitsgruppe oder einer Arbeitsüberwachungskategorie enthalten sind. So können Sie beispielsweise eine Abfrage erstellen, um nach allen Arbeitselementen zu suchen, die einem beliebigen Mitglied eines Teams zugewiesen sind. Ein anderes Beispiel wäre eine Suche nach allen Arbeitselementen, die zur Anforderungskategorie (Microsoft.RequirementCategory) gehören.

Wenn Sie nach einer Gruppe filtern, die eine große Anzahl von Mitgliedern enthält, ist Ihr Resultset in der Regel größer und nicht selektiv. Wenn eine Gruppe einer großen Microsoft Entra-Gruppe entspricht, ist die Abfrage außerdem ziemlich aufwendig, da diese Gruppe in Microsoft Entra ID aufgelöst werden muss.

Vermeiden negierter Operatoren

Negierte Operatoren (z. B. <>, Not In, Not Under, Not In Group) generieren in der Regel nicht selektive Abfragen und große Resultsets.

Verwenden Sie negierte Operatoren nur, wenn es sich nicht vermeiden lässt. Versuchen Sie immer zuerst, Alternativen zu finden. Wenn also beispielsweise Field1 die Werte A, B, C, und D aufweist, geben Sie nicht die negierte Klausel Field1 In A, B, C an, sondern die Klausel Field1 <> D.

Vermeiden von Zeichenfolgenvergleichen

Abfragen, die Zeichenfolgenvergleiche enthalten, generieren Tabellenscans, die von Natur aus ineffizient sind. Stattdessen empfiehlt es sich, alternativ Tags oder ein bestimmtes benutzerdefiniertes Feld zu verwenden – insbesondere bei Abfragen mit unbefriedigender Leistung.

Einschränken von Or-Operatoren

Schränken Sie in Ihrer Abfrage die Anzahl definierter Or-Operatoren ein. Abfragen funktionieren besser, wenn weniger Or-Operatoren verwendet werden. Zu viele Or-Operatoren können dazu führen, dass Ihre Abfrage nicht mehr selektiv ist. Wenn Ihre Abfrage langsam ausgeführt wird, platzieren Sie die Or-Operatorklausel im oberen Bereich der Abfrageklauseln.

Speichern Ihrer Abfrage

Aufgrund interner Optimierungen funktionieren gespeicherte Abfragen in der Regel besser als nicht gespeicherte Abfragen. Speichern Sie Ihre Abfrage immer, wenn Sie sie wiederverwenden möchten. Auch bei WIQL-Abfragen, die über eine REST-API ausgeführt werden, empfiehlt es sich, die WIQL über das Webportal zu speichern, um Ihre REST-API-Aufrufe weniger anfällig für zukünftige Leistungsregressionen zu machen.

Ausführen Ihrer Abfrage

Manchmal müssen Sie Ihre Abfrage mehrmals ausführen, um den richtigen Optimierungsplan zu erzielen. Speichern Sie Ihre Abfrage, und führen Sie sie bis zu 10-mal über einen Zeitraum von 30 Minuten aus. Dadurch kann das System den Optimierungsplan untersuchen und den Plan ermitteln, der für Ihre Abfrage am besten geeignet ist.

Verwandte Artikel

• Kurzübersicht zu Abfragen
• Häufig gestellte Fragen zu Abfragen
• Diagramm einer Flatlistabfrage
• Optionen zum Ändern von Spalten
• Arbeitselement-Feldindex
• Tastenkombinationen