Definieren einer Arbeitselementabfrage in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - 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 für andere 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.

Abfrage-Editor, Webbrowser.

Wenn Sie feststellen, dass Ihre Abfragen zu lange dauern, um Ergebnisse zurückzugeben, lesen Sie die Anleitung zum Erstellen von leistungsstarken Abfragen.

In diesem Artikel finden Sie Informationen zu Folgendem:

  • Hinzufügen oder Erstellen einer Abfrage
  • So wird's geht's: Abfragen über Projekte hinweg
  • Gruppieren und Aufheben der Gruppierungsabfrageklauseln
  • Erstellen einer Struktur von Arbeitselementen oder einer Direct-Links-Abfrage

Für schnellen Zugriff auf alle Abfrageaufgaben, unterstützte Operatoren wie z. B. , ContainsIn, In Group, und <>(nicht operator) – basierend auf Felddatentyp und Abfragebeispielen finden Sie unter "Abfrageschnellübersicht".

Auswählen eines Abfragefilters

Führen Sie im 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äherungssuchen, aber semantische Suchvorgänge tun. Darüber hinaus unterstützt semantische Suchvorgänge sowohl * als ? auch als Wildcardzeichen, und Sie können mehr als ein Wildcardzeichen verwenden, um mehr als ein Zeichen zu entsprechen. Weitere Informationen finden Sie in der Suche nach funktionalen Arbeitsaufgaben.


Filterfeatures

Makros



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

Voraussetzungen

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff 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 Einfachen Zugriff oder höher gewährt werden. Außerdem müssen Sie ihre Berechtigung "Mitwirken " auf "Zulassen" für den Ordner festlegen, dem Sie die Abfrage hinzufügen möchten. Standardmäßig verfügt die Gruppe "Mitwirkende " nicht über diese Berechtigung.

Hinweis

Benutzer mit Stakeholderzugriff für ein öffentliches Projekt haben vollständigen Zugriff auf Abfragefeatures wie Benutzer mit standardem Zugriff. Ausführliche Informationen finden Sie unter "Stakeholder access quick reference".

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff 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 Einfachen Zugriff oder höher gewährt werden. Außerdem müssen Sie ihre Berechtigung "Mitwirken " auf "Zulassen" für den Ordner festlegen, 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 im Webbrowser (1), ob Sie das richtige Projekt ausgewählt haben, (2) Die Tafelabfragen> und dann (3) "Alle".

Open Boards-Abfragen>, vertikale Navigation

Wenn Sie Abfragen zum ersten Mal öffnen, wird die Seite für Favoriten geöffnet. Auf dieser Seite sind diese Abfragen aufgeführt, die Sie angegeben haben, ein Favorit. 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 im Webbrowser Boards-Abfragen>.

Öffnen Von Ihrem Webbrowser aus öffnen Sie Boards-Abfragen>

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 zum Hinzufügen einer neuen Abfrage, neuer Oberfläche.

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

Screenshot von Abfrage-Editor mit flacher Liste ausgewählter Arbeitselemente.

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 der Seite

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

Screenshot von Abfrage-Editor mit einer flachen Liste ausgewählter Arbeitselemente, TFS 2018 und früheren Versionen.

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 von Abfrage-Editor mit aktivierter Abfrage über Projekte hinweg.

Wenn die Abfrage über Projekte hinweg aktiviert ist, können Sie das Feld "Teamprojekt " hinzufügen, um zu einer ausgewählten Anzahl von Projekten zu filtern.

Screenshot von Abfrage-Editor mit Teamprojekt und anderen zu filternden Feldern.

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 "Teamprojekt " ist nur verfügbar, nachdem Sie die Abfrage in allen Projekten ü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 von Abfrage-Editor, in dem gezeigt wird, wie Eine Klausel hinzugefügt wird.

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 Links-Abfrage erstellen, die testbezogene Arbeitselemente auflistet. Außerdem können Sie die Hierarchie über die Test Plans Seite anzeigen.

Screenshot der Abfrageergebnisseliste mit einer Strukturabfrage.

Screenshot der Abfrageergebnisseliste mit einer Strukturabfrage, TFS 2018-Ansicht.

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 ab. Wenn Sie verknüpfte Eltern suchen möchten, wählen Sie zuerst die Option "Verknüpfte Arbeitselemente anpassen" aus.

Screenshot der Abfrage-Editor Ansicht der Struktur der Arbeitselemente.

Verwenden Sie die Abfrage " Arbeitselemente" und "Direkte Links" , um Arbeitsaufgaben nachzuverfolgen, die von anderen nachverfolgten Arbeiten abhängen, 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 allen Teams nachzuverfolgen. Die Abfrage hilft Ihnen auch beim Verwalten von Verpflichtungen, die Ihr Team vornimmt. Wählen Sie die Filterkriterien für die obersten und verknüpften Arbeitselemente aus. Wählen Sie außerdem die Arten von Links aus, um die Abhängigkeiten zu filtern.

Screenshot der Ergebnisse von Direct Links-Abfrageergebnissen.

Screenshot von Abfrage-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 enthalten, die durch die kriterien für verknüpfte Arbeitselemente angegeben sind.

  • Alle Elemente der obersten Ebene zurückgeben: Alle Arbeitselemente der ersten Ebene werden trotz der Filterkriterien für verknüpfte Arbeitselemente zurückgegeben. Elemente der zweiten Ebene, die mit der ersten Ebene verknüpft sind, geben zurück, wenn sie den Filterkriterien für verknüpfte Arbeitselemente entsprechen.

  • Gibt nur Elemente zurück, die keine übereinstimmenden Links haben: Arbeitselemente der ersten Ebene werden zurückgegeben, aber nur, wenn sie keine Links zu Arbeitselementen enthalten, die durch die Filterkriterien für verknüpfte Arbeitselemente angegeben sind.

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 Arbeitselemente an, die das Kriterium entweder in der aktuellen Klausel oder in der vorherigen Klausel erfüllen.

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

Gruppieren Sie Abfrageklauseln, die als einzelne Einheit getrennt von der restlichen 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, die von der restlichen Abfrage getrennt ist. 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-Editor-Erweiterung , mit der Sie die WIQL-Version eines beliebigen Abfrage-UI-Eintrags anzeigen können. Mit dieser Erweiterung können Sie genau sehen, wie UND/ODER gruppierte Klauseln behandelt werden.

Abfrage Gruppierte Klauseln Logischer Ausdruck.
1 Screenshot einer Gruppenklauselnabfrage. Filter werden für das Feld Screenshot eines logischen Ausdrucks. Ein AND-Operator gruppiert den Arbeitselementtyp, den Status und die Felder
2 Screenshot einer Gruppenklauselabfrage mit Filtern für das Feld Screenshot eines logischen Ausdrucks. Ein AND-Operator gruppiert den Arbeitselementtyp mit dem Status oder zugewiesenen Feldern, die von einem OR-Operator gruppiert werden.
3 Screenshot einer Gruppenklauselnabfrage. Filter werden entweder für das Feld Screenshot eines logischen Ausdrucks. Ein OR-Operator verknüpft den Arbeitselementtyp sowohl mit dem Status als auch mit den Feldern

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 für Gruppenklauseln aus.

Screenshot des Webportals, Abfrage-Editor, Gruppen ausgewählte Abfrageklauseln.

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

Screenshot des Webportals, Abfrage-Editor, Gruppieren mehrerer Abfrageklauseln.

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 die Gruppierung einer Klausel aufheben möchten, wählen Sie das Symbol "Gruppierungsklauseln aufheben" für die gruppierte Klausel aus.

Das sind die Grundlagen zum Definieren von Abfragen. Ein Index der Abfragebeispiele finden Sie unter "Abfrageschnellübersicht".