Definieren einer Arbeitselementabfrage in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019-| Visual Studio 2022

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 Team-Favoriten.

Öffnen Sie in Ihrem Webbrowser Boards-Abfragen>.

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

Definieren einer Flachlistenabfrage

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

Screenshot zum Hinzufügen neuer Abfrage, neuer Benutzeroberfläche.

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

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

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

Screenshot zur Seite

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

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

Sie können die Werte ändern und Klauseln hinzufügen oder entfernen. Ändern Sie auch den Abfragetyp 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.

Um Arbeitselemente auflisten zu können, die in zwei oder mehr Projekten definiert sind, markieren Sie die Abfrage über Projekte hinweg. Die folgende Abfrage findet beispielsweise alle Features, die in allen Projekten innerhalb der letzten 30 Tage erstellt wurden.

Screenshot von Abfrage-Editor mit abfrageübergreifenden Projekten überprüft.

Mit der überprüften Abfrage über Projekte können Sie das Teamprojektfeld hinzufügen, um zu einer ausgewählten Anzahl von Projekten zu filtern.

Screenshot von Abfrage-Editor mit Team Project und anderen Feldern, die zum Filtern hinzugefügt wurden.

Hinweis

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

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

Definieren einer Klausel

Sie erstellen eine Abfrage, indem Sie eine oder mehrere Klauseln definieren. Jede Klausel definiert ein 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 am Ende der Abfrage eine weitere Klausel hinzuzufügen, und wählen Sie dann " Feld", " Operator" und " Wert " für diese Klausel aus.

Screenshot von Abfrage-Editor, der zeigt, wie eine Klausel hinzugefügt wird.

Suchen Sie z. B. nach allen Arbeitselementen, die Ihnen zugewiesen sind, indem Sie das Feld "Zugewiesen an", den Operator "Gleich"(=) und das @Me-Makro 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 für die 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 Nach-unten-Pfeil 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 Nach-unten-Pfeil 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 "Wert ", entweder einen Wert ein, oder wählen Sie den Nach-unten-Pfeil 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 dem Ende der Abfrage eine Klausel hinzufügen oder die folgenden Aufgaben mit den entsprechenden Symbolen ausführen:

    • Neue Filterlinie einfügen
    • Entfernen dieser Filterlinie
    • Ausgewählte Klauseln gruppieren
    • Gruppierungsklauseln aufheben

Verwenden einer Arbeitselementstruktur zum Anzeigen von Hierarchien

Verwenden Sie die Abfrage "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 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 aus. Um verknüpfte Eltern zu finden, wählen Sie zuerst verknüpfte Arbeitselemente übereinstimmen.

Screenshot Abfrage-Editor Ansicht der Struktur der Arbeitselemente.

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 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 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 mit einer Gruppenklauselnabfrage. Filter werden für das Feld Screenshot eines logischen Ausdrucks. Ein AND-Operator gruppiert den Typ
2 Screenshot mit einer Gruppenklauselnabfrage mit Filtern sowohl 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 mit einer Gruppenklauselnabfrage. Filter sind für das Feld Screenshot eines logischen Ausdrucks. Ein OR-Operator verknüpft den Arbeitselementtyp sowohl mit dem Status als auch mit den Feldern zugewiesen, die von einem AND-Operator verknüpft sind.

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 des Webportals, Abfrage-Editor, Gruppen ausgewählte Abfrageklauseln.

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

Anzeigen von Abfrageergebnissen in einem Dashboard

Die folgenden beiden Widgets zeigen Abfrageergebnisse an. Sie können Arbeitselemente direkt aus diesen 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.
  • Abfrageergebnisse-Widget: Zeigt die Ergebnisse einer flachen, strukturbezogenen oder Direct-Links-Abfrage an. Sie können die felder konfigurieren, die über das Widget angezeigt werden, die Größe der Spaltenfelder ändern und struktur- und direktlinksabfrage erweitern und reduzieren.

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

Anzeigen des Abfrageergebnis-Widgets mit übergeordneten Titeln

Sie können die Ergebnisse einer Abfrage mit dem angezeigten Übergeordneten Titel anzeigen. Führen Sie dazu die folgenden Schritte aus:

  1. Erstellen Sie die Abfrage, die die Arbeitselemente des Interesses filtert. Die Abfrage kann eine flache Liste, eine Struktur oder eine Direct-Links-Abfrage sein.
  2. Fügen Sie das übergeordnete Feld als Spalte hinzu.
  3. Speichern Sie die Abfrage als Freigegebene Abfrage oder Als Team-Favoriten.
  4. Fügen Sie dem Dashboard das Widget "Abfrageergebnisse " hinzu und konfigurieren Sie die Abfrage. Stellen Sie sicher, dass das übergeordnete Feld auf die Anzeige festgelegt ist.

Das folgende Bild veranschaulicht ein Abfrageergebnis-Widget, das das übergeordnete Feld anzeigt.

Screenshot des Abfrageergebnis-Widgets mit einem Übergeordneten Spaltenfeld.

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