Definieren einer Arbeitselementabfrage in Azure Boards

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Arbeitselementabfragen generieren Listen von Arbeitselementen basierend auf den von Ihnen bereitgestellten Filterkriterien. Anschließend können Sie diese verwalteten Abfragen mit anderen speichern und freigeben. Im Gegensatz dazu können semantische Suchvorgänge Arbeitselemente auflisten, aber nicht gespeichert oder freigegeben werden.

Erstellen Sie Abfragen aus dem Webportal oder aus einem unterstützten Client, z. B. Visual Studio Team-Explorer und Team Explorer Everywhere. Sie können auch eine Arbeitselementabfrage mithilfe der WIQL-Syntax und einer WIQL-Datei definieren und importieren. Um Massenupdates oder Ergänzungen zu unterstützen, importieren oder exportieren Sie Abfragen mithilfe von Excel oder .csv Dateien.

Erstellen Sie Abfragen aus dem Webportal oder aus einem unterstützten Client, z. B. Visual Studio Team-Explorer und Team Explorer Everywhere. Sie können auch eine Arbeitselementabfrage mithilfe der WIQL-Syntax und einer WIQL-Datei definieren und importieren. Um Massenupdates oder Ergänzungen zu unterstützen, importieren oder exportieren Sie Abfragen mithilfe von Excel.

Query Editor, web browser.

Wenn Sie feststellen, dass Ihre Abfragen zu lange dauern, um Ergebnisse zurückzugeben, überprüfen Sie die Anleitung zum Erstellen hoher Leistung von Abfragen.

In diesem Artikel finden Sie Informationen zu Folgendem:

  • Hinzufügen oder Erstellen einer Abfrage
  • Abfragen über Projekte hinweg
  • Gruppieren und Aufheben der Gruppierungsabfrageklauseln
  • Erstellen einer Struktur von Arbeitselementen oder einer Direct-Links-Abfrage

Für den schnellen Zugriff auf alle Abfrageaufgaben, unterstützte Operatoren wie z. B. , Contains, InIn Group, und (nicht Operator) basierend auf Felddatentyp und <>Abfragebeispielen finden Sie unter Abfrage-Schnellübersicht.

Auswählen eines Abfragefilters

Führen Sie aus dem Abfrage-Editor die folgenden Filterfunktionen aus. Wählen Sie den Filter aus, um zu einem Artikel mit Beispielabfragen zu springen. Zusammen mit den Abfragefiltern können Sie Filter interaktiv auf Abfrageergebnisse anwenden.

Hinweis

Verwaltete Abfragen unterstützen keine Näherungssuche, aber semantische Suchvorgänge tun. Darüber hinaus unterstützt semantische Suchvorgänge sowohl *? als auch als Wildcardzeichen und können mehr als ein Wildcardzeichen verwenden, um mehr als ein Zeichen zu entsprechen. Weitere Informationen finden Sie unter Funktionsarbeitselementsuche.


Filterfeatures

Makros



Zusammen mit den Filtern, die Sie aus dem Abfrage-Editor verwenden, können Sie mithilfe der Filterfunktion interaktiv ein Abfrageergebnis filtern. Informationen dazu finden Sie unter Interaktive Filter-Backlogs, Boards, Abfragen und Pläne.

Voraussetzungen

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Dem Stakeholder-Zugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können die berechtigungen ändern, die für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage festgelegt sind. Ausführliche Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter freigegebenen Abfragen hinzuzufügen und zu speichern, müssen Sie dem Grundlegenden Zugriff oder höher gewährt werden. Außerdem müssen Sie über ihre Berechtigung "Mitwirken" verfügen, um den Ordner zu zulassen, dem Sie die Abfrage hinzufügen möchten. Standardmäßig verfügt die Gruppe "Mitwirkende" nicht über diese Berechtigung.

Hinweis

Benutzer mit Dem Stakeholder-Zugriff für ein öffentliches Projekt verfügen über vollständigen Zugriff auf Abfragefeatures wie Benutzer mit Grundlegendem Zugriff. Ausführliche Informationen finden Sie in der Schnellübersicht des Stakeholders.

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Dem Stakeholder-Zugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können die berechtigungen ändern, die für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage festgelegt sind. Ausführliche Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter freigegebenen Abfragen hinzuzufügen und zu speichern, müssen Sie dem Grundlegenden Zugriff oder höher gewährt werden. Außerdem müssen Sie über ihre Berechtigung "Mitwirken" verfügen, um den Ordner zu zulassen, dem Sie die Abfrage hinzufügen möchten. Standardmäßig verfügt die Gruppe "Mitwirkende" nicht über diese Berechtigung.

Öffnen von Abfragen

Überprüfen Sie in Ihrem Webbrowser (1), dass Sie das richtige Projekt ausgewählt haben, (2) Boards Queries auswählen, und wählen >Sie dann (3) "Alle" aus.

Open Boards>Queries, vertical nav

Wenn sie zum ersten Mal Abfragen öffnen, wird die Seite für Favoriten geöffnet. Auf dieser Seite sind diese Abfragen aufgeführt, die Sie angegeben haben, ein Favoriten. Andernfalls können Sie "Alle " auswählen, um alle Abfragen anzuzeigen, die Sie für das Projekt definiert und freigegeben haben.

Tipp

Abfragen, die Sie oder Ihr Team als Favoriten ausgewählt haben, werden auf der Seite "Favoriten" angezeigt. Favoritenabfragen zusammen mit anderen Objekten werden auch auf Ihrer Project Seite angezeigt. Weitere Informationen finden Sie unter Festlegen von persönlichen oder Teamfavoriten.

Öffnen Sie in Ihrem Webbrowser Boards> Queries.

From your web browser, open Boards>Queries

Definieren einer Flachlistenabfrage

Sie können eine neue, neue Abfrage auf der Registerkarte "Abfragen " im Webportal oder auf der Registerkarte "Arbeitselemente " im Team-Explorer starten.

Screenshot to Add new query, new experience.

Die Abfrage-Editor wird mit den folgenden Standardeinstellungen angezeigt: Flache Liste der Arbeitselemente, Arbeitselementtyp=[Alle] und State=[Any].

Screenshot of Query Editor with flat list of work items selected.

Sie können die Werte ändern und Klauseln hinzufügen oder entfernen. Oder ändern Sie den Typ der Abfrage in Arbeitselemente und direkte Verknüpfungen oder eine Struktur von Arbeitselementen.

Screenshot to Queries page, Choose New query from the drop down menu.

Die Abfrage-Editor wird mit den folgenden Standardeinstellungen angezeigt: Flache Liste der Arbeitsaufgaben, Team Project=@Project (das aktuelle Projekt), Arbeitselementtyp=[Alle] und State=[Any].

Screenshot of Query Editor with flat list of work items selected, TFS 2018 and earlier versions.

Sie können die Werte ändern und Klauseln hinzufügen oder entfernen. Oder ändern Sie den Typ der Abfrage in Arbeitselemente und direkte Verknüpfungen oder eine Struktur von Arbeitselementen.

Abfragen über oder innerhalb von Projekten

Neuer Abfragebereich für das aktuelle Projekt standardmäßig. 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.

Zum Auflisten von Arbeitselementen, die in zwei oder mehr Projekten definiert sind, markieren Sie "Abfrage für alle Projekte". Die folgende Abfrage findet beispielsweise alle Features, die innerhalb der letzten 30 Tage in allen Projekten erstellt wurden.

Screenshot of Query Editor with Query across projects checked.

Mit aktivierter Abfrage können Sie das Feld "Team Project" hinzufügen, um zu einer ausgewählten Anzahl von Projekten zu filtern.

Screenshot of Query Editor with Team Project and other fields added to filter.

Hinweis

Trennen Sie mehrere Projektnamen mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für Ihren Clientcomputer definiert sind, z. B. ein Komma (,).

Das Feld "Team Project" ist nur verfügbar, nachdem Sie die Abfrage über Projekte hinweg überprüft haben. Wenn "Abfrage über Projekte hinweg" deaktiviert ist, werden nur diese Felder aus diesen Arbeitselementtypen, wie im aktuellen Projekt definiert, im Dropdownmenü "Feld" angezeigt. Wenn die Abfrage über Projekte hinweg aktiviert ist, werden alle Felder aus allen Arbeitselementtypen, die in allen Projekten in der Auflistung definiert sind, im Dropdownmenü "Feld" angezeigt.

Definieren einer Klausel

Sie erstellen eine Abfrage, indem Sie eine oder mehrere Klauseln definieren. Jede Klausel definiert eine Filterkriterien für ein einzelnes Feld.

Beispielabfrageklausel

Und/Oder Feld Operator Wert
Und Zugewiesen zu = @Me

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

Alle von Ihnen hinzugefügten Klauseln werden als And-Anweisung hinzugefügt. Wählen Sie "Oder " aus, um die Gruppierung zu ändern. Sie gruppieren Klauseln, um sicherzustellen, dass die Klauselanweisungen in der erforderlichen Sequenz ausgeführt werden.

Wählen Sie "Neue Klausel hinzufügen", um eine weitere Klausel am Ende der Abfrage hinzuzufügen, und wählen Sie dann das Feld, den Operator und den Wert für diese Klausel aus.

Screenshot of Query Editor showing how to add a clause.

Suchen Sie beispielsweise nach allen Arbeitselementen, die Ihnen zugewiesen sind, indem Sie das Feld "Zugewiesen an", den Operator "Gleich" (=) und das makro "@Me " angeben, das Ihre Benutzeridentität darstellt.

Tipp

Um die WIQL-Syntax für eine Abfrage anzuzeigen und wie Klammern zum Gruppieren von Klauseln verwendet werden, installieren Sie den Marketplace Wiql-Editor. Diese Erweiterung unterstützt das Anzeigen der WIQL-Syntax und das Exportieren in eine WIQL-Datei zur Verwendung in REST-API-Aufrufen. Weitere Informationen finden Sie unter Syntax für die Arbeitselementabfragesprache (WIQL).

Prüfliste zum Definieren einer Abfrageklausel

  1. Wählen Sie in der ersten leeren Zeile unter der Überschrift " Feldspalte " den Abwärtspfeil aus, um die Liste der verfügbaren Felder anzuzeigen, und wählen Sie ein Element in der Liste aus.

    Weitere Informationen finden Sie unter Abfragefelder und -werte.

  2. Wählen Sie in derselben Zeile unter der Spaltenüberschrift " Operator " den Abwärtspfeil aus, um die Liste der verfügbaren Operatoren anzuzeigen, und wählen Sie ein Element in der Liste aus.

    Weitere Informationen finden Sie unter Operatoren.

  3. Geben Sie in derselben Zeile unter der Überschrift "Wertspalten " entweder einen Wert ein, oder wählen Sie den Abwärtspfeil aus, und wählen Sie ein Element in der Liste aus.

    Weitere Informationen zum Verwenden eines Makros oder einer Variablen zum Angeben des aktuellen Projekts, des Benutzers, des Datums oder einer anderen Auswahl finden Sie unter Variablen.

  4. Um eine Klausel hinzuzufügen, 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 Filterlinie einfügen
    • Diese Filterlinie entfernen
    • Ausgewählte Klauseln gruppieren
    • Gruppierungsklauseln aufheben

Verwenden einer Arbeitselementstruktur zum Anzeigen von Hierarchien

Verwenden Sie die Abfrage "Struktur der Arbeitselemente ", um eine mehrstufige, geschachtelte Liste der Arbeitselemente anzuzeigen. Beispielsweise können alle Backlogelemente und deren verknüpften Aufgaben angezeigt werden. Um sich auf verschiedene Teile der Struktur zu konzentrieren, wählen Sie " Alle erweitern " oder "Alle reduzieren" aus.

Hinweis

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Test Plans, Testsuiten und Testfällen anzeigt. Diese Elemente werden nicht mit übergeordneten Verknüpfungstypen verknüpft. Sie können jedoch eine Direkte Linksabfrage erstellen, die testbezogene Arbeitselemente auflisten. Außerdem können Sie die Hierarchie über die Test Plans Seite anzeigen.

Screenshot of Query Results List showing a Tree Query.

Screenshot of Query Results List showing a Tree Query, TFS 2018 view.

Definieren Sie die Filterkriterien sowohl für übergeordnete als auch untergeordnete Arbeitselemente. Um verknüpfte untergeordnete Elemente zu finden, wählen Sie zuerst Arbeitselemente auf oberster Ebene aus. Um verknüpfte Eltern zu finden, wählen Sie zuerst verknüpfte Arbeitselemente übereinstimmen.

Screenshot of Query Editor view of Tree of work items.

Verwenden Sie die Abfrage "Arbeitselemente" und "Direkte Links", um Arbeitselemente nachzuverfolgen, die von anderen nachverfolgten Arbeiten abhängig sind, z. B. Aufgaben, Fehler, Probleme oder Features. Beispielsweise können Sie Backlog Items anzeigen, die von der Implementierung anderer Elemente oder der Behebung eines Fehlers abhängig sind.

Verwenden Sie die Abfrage für direkte Links, um Abhängigkeiten in Teams nachzuverfolgen. Die Abfrage hilft Ihnen auch beim Verwalten von Verpflichtungen, die Ihr Team macht. Wählen Sie die Filterkriterien für die obersten und verknüpften Arbeitselemente aus. Wählen Sie die Typen von Links aus, um die Abhängigkeiten zu filtern.

Screenshot of Direct Links Query Results.

Screenshot of Query Editor, Direct Links Query.

Filtern Sie die Liste der Arbeitselemente der obersten Ebene durch Auswahl einer dieser Optionen:

  • Gibt nur Elemente zurück, die übereinstimmende Links haben: Zurückgeben von Arbeitselementen auf erster Ebene, aber nur, wenn sie Links zu Arbeitselementen haben, die von den kriterien für verknüpfte Arbeitselemente angegeben sind.

  • Zurückgeben aller Elemente auf oberster Ebene: Alle Arbeitselemente auf erster Ebene werden trotz der Kriterien für verknüpfte Arbeitselemente zurückgegeben. Arbeitselemente auf zweiter Ebene, die mit der ersten Ebene verknüpft sind, wenn sie den Kriterien für verknüpfte Arbeitselemente entsprechen.

  • Gibt nur Elemente zurück, die nicht über übereinstimmende Links verfügen: Arbeitselemente der ersten Ebene werden zurückgegeben, aber nur, wenn sie keine Verknüpfungen zu Arbeitselementen haben, die durch die verknüpften Arbeitselementefilterkriterien angegeben werden.

Weitere Informationen zu jedem Linktyp finden Sie unter Verknüpfen, Ablaufverfolgung und Verwalten von Abhängigkeiten.

Und/Oder logischer Ausdruck

Sie geben "And" oder " Or " an, um logische Ausdrücke Ihrer Abfrageklauseln zu erstellen. Geben Sie Arbeitselemente an, die die Kriterien sowohl in der aktuellen Klausel als auch in der vorherigen Klausel erfüllen. Geben Sie die Arbeitselemente an, die das Kriterium entweder in der aktuellen Klausel oder in 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ünschten Arbeitselemente zurückzugeben. Wenn Sie die ergebnisse, die Sie von Ihrer Abfrage erwarten, nicht erhalten, verfeinern Sie sie. Sie können Abfrageergebnisse hinzufügen, entfernen, gruppieren oder gruppieren, um die Abfrageergebnisse zu verbessern.

Gruppenabfrageklauseln, die als einzelne Einheit getrennt vom Rest der Abfrage ausgeführt werden sollen. Gruppierungsklauseln ähneln dem Einfügen von Klammern um einen Ausdruck in einer mathematischen Formel oder Logikanweisung. Wenn Sie Klauseln gruppieren, gilt die AND oder OR für die erste Klausel in der Gruppe für die gesamte Gruppe.

Gruppenklauseln

Gruppierte Klauseln funktionieren als einzelne Einheit getrennt vom Rest der Abfrage. Gruppierungsklauseln ähneln dem Einfügen von Klammern um eine mathematische Formel oder einen Logikausdruck. Der And - oder Or-Operator für die erste Klausel in der Gruppe gilt für die gesamte Gruppe.

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

Tipp

Um die WIQL-Syntax für eine Abfrage anzuzeigen, installieren Sie die WIQL-Abfrage-Editorerweiterung , mit der Sie die WIQL-Version eines beliebigen Abfrageoberflächeneintrags sehen können. Diese Erweiterung ermöglicht Es Ihnen, genau zu sehen, wie gruppierte Klauseln behandelt werden.

Abfrage Gruppierte Klauseln Logischer Ausdruck.
1 Screenshot showing a group clause query. Filters are set up for the Work item type field and either the State field or the Assigned to field. Screenshot of a logical expression. An AND operator groups the Work item type, State, and Assigned to fields. An OR operator groups the State and Assigned to fields.
2 Screenshot showing a group clause query, with filters for both the Work item type field and one of either the State field or the Assigned to field. Screenshot of a logical expression. An AND operator groups the Work item type with the State or Assigned to fields, which are grouped by an OR operator.
3 Screenshot showing a group clause query. Filters are set up for either the Work item type field or both the State field and the Assigned to field. Screenshot of a logical expression. An OR operator links the Work item type to both the State and the Assigned to fields, which are linked by an AND operator.

Diese Abfragen geben Arbeitselemente zurück, die Fehler eingeben und die folgenden logischen Ausdrücke erfüllen:

  • 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)

Wenn Sie eine oder mehrere Klauseln gruppieren möchten, wählen Sie sie aus, und wählen Sie dann das Symbol " Gruppenklauseln" aus.

Screenshot of Web portal, Query Editor, Group Selected Query Clauses.

Sie können auch mehrere gruppierte Klauseln gruppieren. Aktivieren Sie die Kontrollkästchen jeder Klausel, die bereits gruppiert wurde. Wählen Sie dann das Symbol " Gruppenklauseln" aus.

Screenshot of Web portal, Query Editor, Group multiple query clauses.

Wenn Ihre Abfrageergebnisse keine erwarteten Ergebnisse zurückgeben, führen Sie die folgenden Schritte aus:

  • Stellen Sie sicher dass jede Klausel wie beabsichtigt definiert wurde.
  • Überprüfen Sie die Und/Oder-Zuweisungen der einzelnen Klauseln. Wenn die Ergebnisse mehr Arbeitsaufgaben als erwartet enthalten, wurde häufig eine Oder-Klausel anstelle einer Und -Klausel verwendet.
  • Ermitteln Sie, ob Sie die Gruppierung der Abfrageklauseln und der Und/Oder-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, um Felder, Operatoren und Werte anzugeben.

Gruppierung einer Klausel aufheben

Wenn Sie eine Klausel aufheben möchten, wählen Sie das Symbol für die Gruppierungsklausel für die gruppierte Klausel aus.

Das ist die Grundlagen zum Definieren von Abfragen. Ein Index der Abfragebeispiele finden Sie unter Abfrage-Schnellübersicht.