Definieren einer Arbeitselementabfrage in Azure Boards


Filterfeatures

Makros



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

Voraussetzungen

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können den Berechtigungssatz für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage ändern. Weitere Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter Freigegebene Abfragen hinzuzufügen und zuspeichern, müssen Sie Basic-Zugriff oder höher erhalten. Außerdem müssen Sie die Berechtigung Beitragen für den Ordner, dem Sie die Abfrage hinzufügen möchten, auf Zulassen festlegen. Standardmäßig verfügt die Gruppe Mitwirkende nicht über diese Berechtigung.

Hinweis

Benutzer mit Stakeholderzugriff für ein öffentliches Projekt haben vollzugriff auf Abfragefeatures wie Benutzer mit Basic-Zugriff. Weitere Informationen finden Sie in der Kurzreferenz für den Zugriff von Beteiligten.

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können den Berechtigungssatz für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage ändern. Weitere Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter Freigegebene Abfragen hinzuzufügen und zuspeichern, müssen Sie Basic-Zugriff oder höher erhalten. Außerdem müssen Sie die Berechtigung Mitwirken für den Ordner, dem Sie die Abfrage hinzufügen möchten, auf Zulassen festlegen. Standardmäßig verfügt die Gruppe Mitwirkender nicht über diese Berechtigung.

Öffnen von Abfragen

Überprüfen Sie in Ihrem Webbrowser (1), ob Sie das richtige Projekt ausgewählt haben, (2) wählen Sie Boards Abfragenaus, und wählen Sie dann (3) Alleaus.

Öffnen Boards  Abfragen, vertikaler Navigationsnavigation

Wenn Sie zum ersten Mal Abfragenöffnen, wird die Seite mit Favoritengeöffnet. Auf dieser Seite werden die Abfragen aufgelistet, die Sie als Favoriten angegeben haben. Andernfalls können Sie Alle auswählen, um alle Abfragen anzuzeigen, die Sie definiert haben, und freigegebene Abfragen anzuzeigen, die für das Projekt definiert wurden.

Tipp

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

Öffnen Sie in Ihrem Webbrowser Boards Abfragen.

Öffnen Sie in Ihrem Webbrowser Boards  Abfragen.

Definieren einer Flatlistabfrage

Sie können eine neue Abfrage über die Registerkarte Abfragen im Webportal oder über die Registerkarte Arbeitselemente in Team Explorer starten.

Neue Abfrage hinzufügen, neue Benutzeroberfläche

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

Screenshot: Abfrage-Editor mit einer flachen Liste ausgewählter Arbeitselemente

Sie können die Werte ändern und Klauseln hinzufügen oder entfernen. Alternativ können Sie den Abfragetyp in Arbeitselemente und direkte Links oder eine Struktur von Arbeitselementenändern.

Seite

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

Screenshot: 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. Alternativ können Sie den Abfragetyp in Arbeitselemente und direkte Links oder eine Struktur von Arbeitselementenändern.

Abfragen zwischen projekten oder innerhalb von Projekten

Neue Abfragen haben standardmäßig den Gültigkeitsbereich des aktuellen Projekts. Sie können jedoch Abfragen erstellen, um innerhalb der Organisation oder Projektsammlung definierte Arbeitselemente zu suchen. Alle gespeicherten Abfragen werden jedoch unter einem bestimmten Projekt gespeichert.

Um Arbeitselemente aufzulisten, die in zwei oder mehr Projekten definiert sind, aktivieren Sie das Kontrollkästchen Abfrage zwischen Projekten. Die folgende Abfrage sucht beispielsweise alle Features, die in allen Projekten innerhalb der letzten 30 Tage erstellt wurden.

Webportal, Seite

Hinweis

Das Feature Projektübergreifende Abfrage wird ab TFS 2015.1 unterstützt.

Wenn die Option Projektübergreifend abfragen aktiviert ist, können Sie das Feld Team Project hinzufügen, um nach einer ausgewählten Anzahl von Projekten zu filtern.

Azure Boards und TFS 2015.1, Webportal, Abfragen für ausgewählte Projekte mithilfe des In-Operators

Hinweis

Trennen Sie mehrere Projektnamen durch das Listentrennzeichen, das den für Ihren Clientcomputer definierten regionalen Einstellungen entspricht, z. B. ein Komma (,).

Das Feld Team Project ist erst verfügbar, nachdem Sie Projektübergreifend abfragenaktiviert haben. Wenn Die Option Projektübergreifende Abfrage deaktiviert ist, werden im Dropdownmenü Feld nur die Felder aus diesen Arbeitselementtypen angezeigt, wie im aktuellen Projekt definiert. Wenn Projektübergreifende Abfragen aktiviert ist, werden alle Felder aller Arbeitselementtypen, die in allen Projekten in der Sammlung definiert sind, im Dropdownmenü Feld angezeigt.

Entfernen Sie die Klausel Team Project=@Project aus der Abfrage, um alle In allen Projekten innerhalb der letzten 30 Tage erstellten Features zu suchen.

TFS 2013-2015, Webportal, Abfragen für ausgewählte Projekte mithilfe des In-Operators

Alle Felder aller Arbeitselementtypen, die in allen Projekten in der Sammlung definiert sind, werden immer im Dropdownmenü Feld angezeigt.

Verwenden Sie Team Project=@Project, um die Abfrage so zu beschränken, dass nur die für das aktuelle Projekt definierten Arbeitselemente gefunden werden.

Definieren einer -Klausel

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

Beispielabfrageklausel

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

Eine Liste der verfügbaren Operatoren, die auf dem Felddatentyp basieren, finden Sie unter Kurzübersicht zum Abfrageindex.

Alle klauseln, die Sie hinzufügen, 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 aus, um am Ende der Abfrage eine weitere Klausel hinzuzufügen, und wählen Sie dann die Felder, Operatorund Wert für diese Klausel aus.

Definieren Sie eine -Klausel.

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

Tipp

Installieren Sie den Marketplace Wiql-Editor,um die WIQL-Syntax für eine Abfrage anzuzeigen und zu erfahren, wie Klammern zum Gruppieren von Klauseln verwendet werden. 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 Work Item Query Language (WIQL).

Prüfliste zum 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 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 Pfeil nach unten 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 Spaltenüberschrift Wert entweder einen Wert ein, oder wählen Sie den Pfeil nach unten aus, und wählen Sie 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. Wählen Sie neue Klausel hinzufügen aus, um eine -Klauselhinzuzufügen.

    Sie können am Ende der Abfrage eine -Klausel hinzufügen, eine -Klausel nach einer vorhandenen -Klausel einfügen(Insert-Klauselsymbol)und (Klauselentfernen-Symbol), Group(Gruppenklauselsymbol)und Gruppierung aufheben(Ungroup-Klauselsymbol) klauseln nach Bedarf entfernen.

Verwenden einer Arbeitselementstruktur zum Anzeigen von Hierarchien

Verwenden Sie die Abfrage Struktur von Arbeitselementen, um eine mehrstufige, geschachtelte Liste von Arbeitselementen anzuzeigen. Beispielsweise können alle Backlogelemente und deren verknüpften Aufgaben angezeigt werden. Erweitern (Knoten erweitern (Knoten erweitern, Webportal)oder Reduzieren(Knoten reduzieren, Webportal),um sich auf verschiedene Teile der Struktur zu konzentrieren.

Hinweis

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Test Plans, Testsammlungen und Testfällen anzeigt. Diese Elemente werden nicht mithilfe von über- und untergeordneten Linktypen miteinander verknüpft. Sie können jedoch eine Abfrage mit direkten Links erstellen, die testbezogene Arbeitselemente auflistet. Außerdem können Sie die Hierarchie über die Seite Test Test Plans anzeigen.

Definieren Sie die Filterkriterien sowohl für übergeordnete als auch untergeordnete Arbeitselemente. Um verknüpfte untergeordnete Elemente zu suchen, wählen Sie zuerst Arbeitselemente der obersten Ebene abgleichenaus. Um verknüpfte elemente zu finden, wählen Sie zuerst Verknüpfte Arbeitselemente abgleichenaus.

Verwenden Sie die Abfrage Arbeitselemente und Direkte Links, um Arbeitselemente nachzuverfolgen, die von anderen nachverfolgten Aufgaben 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 mit direkten Links, um Abhängigkeiten teamsübergreifend nachzuverfolgen. Die Abfrage hilft Ihnen auch bei der Verwaltung von Verpflichtungen, die Ihr Team eingegangen ist. 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.

Ergebnisse der Direktlinkabfrage

Direct Links-Abfrage, Editor

Direct Links Abfrage-Editor

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

  • Nur Elemente mit übereinstimmenden Links zurückgeben:Arbeitselemente der ersten Ebene werden zurückgegeben, jedoch nur, wenn sie Links zu Arbeitselementen enthalten, die durch die Filterkriterien für verknüpfte Arbeitselemente angegeben werden.

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

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

Weitere Informationen zu den einzelnen Linktypen finden Sie unter Verknüpfen, Nachverfolgbarkeit 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 And an, um Arbeitselemente zu suchen, die die Kriterien sowohl in der aktuellen als auch in der vorherigen Klausel erfüllen. Geben Sie Oder an, um Arbeitselemente zu suchen, die das Kriterium 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ünschten Arbeitselemente zurückzugeben. Wenn Sie die von Ihrer Abfrage erwarteten Ergebnisse nicht erhalten, verfeinern Sie sie. Sie können Abfrageklauseln hinzufügen, entfernen, gruppieren oder deren Gruppierung aufheben, um die Abfrageergebnisse zu verbessern.

Gruppieren Von Abfrageklauseln, die als einzelne Einheit getrennt vom Rest der Abfrage ausgeführt werden. Gruppierungsklauseln ähneln dem Setzen von Klammern um einen Ausdruck in einer mathematischen Gleichung oder Logik-Anweisung. Wenn Sie Klauseln gruppieren, gilt and oder OR für die erste Klausel in der Gruppe für die gesamte Gruppe.

Gruppenklauseln

Gruppierte Klauseln funktionieren als einzelne Einheit, die vom Rest der Abfrage getrennt ist. Gruppierungsklauseln ähneln dem Setzen von Klammern um eine mathematische Gleichung 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 jedes Abfragebenutzeroberflächeneintrags anzeigen können. Mit dieser Erweiterung können Sie sehen, wie und/oder gruppierte Klauseln behandelt werden.

Abfrage Gruppierte Klauseln Logischer Ausdruck.
1 Screenshot: Abfrage einer Gruppenklausel Filter werden für das Feld Arbeitselementtyp und entweder für das Feld Status oder für das Feld Zugewiesen an eingerichtet. Screenshot eines logischen Ausdrucks Ein AND-Operator gruppiert die Felder Arbeitselementtyp, Zustandund Zugewiesen zu. Ein OR-Operator gruppiert die Felder State und Assigned to.
2 Screenshot einer Gruppenklauselabfrage mit Filtern für das Feld Arbeitselementtyp und eines der Felder Screenshot eines logischen Ausdrucks Ein AND-Operator gruppiert den Arbeitselementtyp mit den Feldern Zustand oder Zugewiesen an, die nach einem OR-Operator gruppiert werden.
3 Screenshot: Abfrage einer Gruppenklausel Filter werden entweder für das Feld Arbeitselementtyp oder sowohl für das Feld Status als auch für das Feld Zugewiesen an eingerichtet. Screenshot eines logischen Ausdrucks Ein OR-Operator verknüpft den Arbeitselementtyp mit den Feldern State und Assigned to , die durch einen AND-Operator verknüpft werden.

Diese Abfragen geben Arbeitselemente vom Typ Bug 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)

Um eine oder mehrere Klauseln zu gruppieren, wählen Sie sie und dann das Symbol gruppenklauseln aus.

Webportal, Ausgewählte Abfrageklauseln gruppieren

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.

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 zum Angeben von Feldern, Operatoren und Werten.

Aufheben der Gruppierung einer Klausel

Wählen Sie zum Aufheben der Gruppierung einer Klausel das Symbol ungroup clauses (Gruppierungsklauseln aufheben) für die gruppierte Klausel aus.

Dies sind die Grundlagen zum Definieren von Abfragen. Einen Index mit Abfragebeispielen finden Sie unter Abfrageschnellreferenz.

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

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

Arbeitselementabfragen generieren Listen von Arbeitselementen basierend auf den von Ihnen aufgeführten Filterkriterien. Anschließend können Sie diese verwalteten Abfragen speichern und für andere freigeben. Im Gegensatz dazu listen semantische Suchvorgänge Arbeitselemente auf, können jedoch nicht gespeichert oder freigegeben werden.

Erstellen Sie Abfragen über das Webportal oder einen unterstützten Client, z. B. Visual Studio Team Explorer und Team Explorer Everywhere. Sie können eine Arbeitselementabfrage auch mithilfe der WIQL-Syntax und einer WIQ-Dateidefinieren und importieren. Um Massenaktualisierungen oder -ergänzungen zu unterstützen, importieren oder exportieren Sie Abfragen mit Excel oder .csv Dateien.

Erstellen Sie Abfragen über das Webportal oder einen unterstützten Client, z. B. Visual Studio Team Explorer und Team Explorer Everywhere. Sie können eine Arbeitselementabfrage auch mithilfe der WIQL-Syntax und einer WIQ-Dateidefinieren und importieren. Um Massenaktualisierungen oder -ergänzungen zu unterstützen, importieren oder exportieren Sie Abfragen mit Excel.

Abfrage-Editor, Webbrowser.

Wenn Sie feststellen, dass ihre Abfragen zu lange dauern, bis Ergebnisse zurückgegeben werden, lesen Sie den Leitfaden zum Erstellen leistungsstarker Abfragen.

In diesem Artikel finden Sie Informationen zu Folgendem:

  • Hinzufügen oder Erstellen einer Abfrage
  • Vorgehensweise: Projektübergreifende Abfragen
  • Gruppieren und Aufheben der Gruppierung von Abfrageklauseln
  • Erstellen einer Struktur von Arbeitselementen oder einer Direktlinkabfrage

Einen schnellen Zugriff auf alle Abfragetasks, unterstützten Operatoren wie Contains , In , und In Group<> (nicht Operator) basierend auf dem Felddatentyp und Abfragebeispiele finden Sie unter Contains

Auswählen eines Abfragefilters

In der Abfrage-Editor können Sie die folgenden Filterfunktionen ausführen. 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. Darüber hinaus unterstützt die semantische Suche sowohl *? als auch als Platzhalterzeichen, und Sie können mehrere Platzhalterzeichen verwenden, um mehr als ein Zeichen abzugleichen. Weitere Informationen finden Sie unter Funktionale Arbeitselementsuche.