Definieren einer Arbeitselementabfrage in Azure Boards


Filterfunktionen

Makros



Zusammen mit den Filtern, die Sie aus dem Abfrage-Editor verwenden, können Sie ein Abfrageergebnis mithilfe der Filter-Funktion interaktiv 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 Zugriff auf Projektbeteiligten 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 Abfragenhinzuzufügen und zu speichern, muss Ihnen der Basic-Zugriff oder höher gewährt werden. 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.

Hinweis

Benutzer mit Zugriff auf Projektbeteiligten für ein öffentliches Projekt haben vollzugriff auf Abfragefeatures wie Benutzer mit Basic-Zugriff. Weitere Informationen finden Sie unter Kurzübersicht über den Zugriff auf Projektbeteiligten.

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Zugriff auf Projektbeteiligten 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 Abfragenhinzuzufügen und zu speichern, muss Ihnen der Basic-Zugriff oder höher gewährt werden. 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 Zugewiesen zu-Feld, den Operator equals ( ) und das @Me-Makro angeben, das Ihre Benutzeridentität darstellt.

Tipp

Um die WIQL-Syntax für eine Abfrage und die Verwendung von Klammern zum Gruppieren von Klauseln anzeigen zu können, 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 for the Work Item Query Language (WIQL) .

Checkliste 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, Datumsoder 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, eine -Klausel nach einer vorhandenen -Klauseleinfügen(Insert-Klauselsymbol) und nach Bedarf klauseln -Klauseln entfernen(Klauselsymbolentfernen), group (Gruppenklauselsymbol) und ungroup (ungroup clause icon) -Klauseln entfernen.

Verwenden einer Arbeitselementstruktur zum Anzeigen von Hierarchien

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

Hinweis

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht der Test Plans, Testsammlungen und Testfälle zeigt. Diese Elemente werden nicht mithilfe von Linktypen über- und untergeordneter Elemente miteinander verknüpft. Sie können jedoch eine Abfrage mit direkten Links erstellen, die testbezogene Arbeitselemente auflistet. Sie können die Hierarchie auch über die Seite Test Test Plans anzeigen.

Definieren Sie die Filterkriterien sowohl für übergeordnete als auch untergeordnete Arbeitselemente. Um verknüpfte elemente zu suchen, wählen Sie Arbeitselemente der obersten Ebene zuerst ab suchen aus. Wählen Sie verknüpfte Arbeitselemente zuerst ab suchen aus, um verknüpfte elemente zu suchen.

Verwenden Sie die Abfrage "Arbeitselemente" und "Direkte Links", um Arbeitselemente zu verfolgen, die von anderen nachverfolgten Aufgaben wie Aufgaben, Fehlern, Problemen oder Features abhängen. 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 teamsübergreifend nachverfolgung zu können. Die Abfrage hilft Ihnen auch bei der Verwaltung von Verpflichtungen, die Ihr Team trifft. 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.

Direct Links– Abfrageergebnisse

Direct Links-Abfrage, Editor

Direkte Links Abfrage-Editor

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

  • Nur Elemente zurückgeben, dieübereinstimmende Links haben: Arbeitselemente der ersten Ebene werden nur dann zurückgeben, wenn sie Links zu Arbeitselementen haben, 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ückgeben. 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.

Logischer Und/oder Ausdruck

Sie geben And oderOr an, um logische Ausdrücke ihrer Abfrageklauseln zu erstellen. Geben Sie And an, um Arbeitselemente zu suchen, die die Kriterien in der aktuellen -Klausel und der vorherigen -Klausel erfüllen. Geben Sie Oder an, um Arbeitselemente zu suchen, 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 satz von Arbeitselementen zurück zu geben, den Sie wünschen. Wenn Sie nicht die Ergebnisse erhalten, die Sie von Ihrer Abfrage erwarten, verfeinern Sie sie. Sie können Abfrageklauseln hinzufügen, entfernen, gruppieren oder die 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 gruppen, gilt die AND- oder OR-Klausel für die erste Klausel in der Gruppe für die gesamte Gruppe.

Gruppenklauseln

Gruppierte Klauseln werden als einzelne Einheit getrennt vom Rest der Abfrage verwendet. 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 grouped-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 Abfragebenutzeroberflächeneintrags anzeigen können. Mit dieser Erweiterung können Sie genau sehen, wie gruppenierte AND/OR-Klauseln behandelt werden.

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

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.