Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Verwenden Sie Abfragen zum Auflisten von Fehlern, Benutzergeschichten oder anderen Arbeitsaufgaben basierend auf den von Ihnen angegebenen Feldkriterien. Teams führen diese Listen aus, um Arbeit zu priorisieren, Elemente massenaktualisieren oder Hierarchien zu überprüfen. Die semantische Suche bietet überlappende und ergänzende Funktionen, die untersucht werden müssen.
Verwenden Sie verwaltete Abfragen für:
- Massenaktualisierung von Arbeitsaufgaben mithilfe des Webportals
- Selektieren und Aktualisieren von Arbeitselementen
- Überprüfen einer Hierarchie von Arbeitselementen
- Eine Liste von Aufgaben mit einem Teamkollegen teilen
Sie können Abfragen und Abfrageordner über das Webportal oder visual Studio Team Explorer erstellen. Änderungen, die Sie in einem Client vornehmen, werden in den anderen angezeigt, da alle Änderungen im Datenspeicher für die Arbeitsnachverfolgung gespeichert sind.
Erste Schritte mit Abfragen
Wenn Sie gerade erst anfangen, lesen Sie „Arbeitsabfragen anzeigen, ausführen oder per E-Mail versenden“. Eine kurze Referenz zu Tasks des Abfrage-Editors und Beispielabfragen finden Sie unter Abfragekurzübersicht.
- Um Arbeitsaufgaben zu finden, die Ihnen zugewiesen sind, verwenden Sie das makro @Me als Wert für das Feld " Zugewiesen an " in einer Klausel.
- Alle gültigen Benutzer mit Standardzugriff können Abfragen und Ordner unter "Meine Abfragen" erstellen. Um Abfragen oder Ordner unter freigegebenen Abfragen zu erstellen, müssen Sie über die Berechtigung "Mitwirken" verfügen. Siehe "Berechtigungen für Abfragen festlegen".
- Ändern Sie eine beliebige Abfrage, indem Sie Kriterien hinzufügen, um sich auf einen Produktbereich, eine Iteration oder ein anderes Feld zu konzentrieren. Um eine Abfrage zu ändern, öffnen Sie den Abfrage-Editor.
- Öffnen Sie eine beliebige Abfrage in Excel , um Felder zu aktualisieren und Änderungen an der Datenbank zu veröffentlichen.
- Visualisieren Sie den Status oder Fortschritt, indem Sie ein Kreis-, Säulen- oder Trenddiagramm für Flatlistenabfragen erstellen. Ausführliche Informationen finden Sie unter "Diagramme".
Abfragemöglichkeiten
In den folgenden Abschnitten werden Funktionen zusammengefasst, die Sie zum Definieren und Verwalten von Arbeitsaufgabenabfragen verwenden.
- Definieren Sie Abfragefilter mit dem Abfrage-Editor.
- Verwenden Sie Abfragemakros in Klauseln, um Felder dynamisch als Ziel zu verwenden.
- Verwalten von Abfrageergebnissen und Ordnern auf der Seite "Abfrageergebnisse".
Abfragefilter
In der folgenden Tabelle werden die Abfragefilterfunktionen zusammengefasst, die von den einzelnen Azure DevOps-Versionen unterstützt werden.
Hinweis
Verwaltete Abfragen unterstützen im Gegensatz zu semantischen Suchvorgängen keine Näherungssuchvorgänge. Darüber hinaus unterstützen semantische Suchen sowohl * als auch ? als Platzhalterzeichen, und Sie können mehrere Platzhalterzeichen verwenden, um mehrere Zeichen abzugleichen. Weitere Informationen finden Sie unter Suche nach funktionalen Arbeitselementen.
Filterfunktion
Unterstützung von Abfragen
Unterstützte Versionen
Text-String-Suche (einfacher Text, mehrzeiliger Text, Rich Text)
Bei Abfragen wird die Groß- und Kleinschreibung nicht beachtet.
Alle Versionen
Platzhalter = *
Alle Versionen
Suchen Sie nach Arbeitselementen basierend auf direkten Links oder topologischen/hierarchischen Linktypen.
Filtern von verknüpften Arbeitselementen basierend auf MODE (WIQL-Syntax)
Alle Versionen
Gruppieren und Schachteln von Klauseln mithilfe der booleschen Operatoren AND und OR.
Alle Versionen
Suchen Sie nach Arbeitselementen basierend auf einer Feldübereinstimmung mit einem vorherigen Wert.
Unterstützter Operator: Was Ever. Suchen Sie nach Arbeitselementen basierend auf einem Wert, der für ein bestimmtes Datum definiert ist.
Unterstützter Operator: ASOF (WIQL-Syntax)
Alle Versionen
Verwenden Sie Makros, um Abfragen relativ zu einem Datum zu erstellen, und andere Tools, z. B. Teambereichspfad, Teamiteration und vieles mehr.
Alle Versionen
Suchen nach Arbeitselementen in mindestens einem Projekt in einer Organisation oder einer Sammlung. Der Standardwert ist das aktuelle Projekt. Verwenden Sie das Feld Teamprojekt, um mindestens zwei Projekte abzufragen.
Alle Versionen
Suchen Sie nach Arbeitselementen basierend darauf, wie zwei Felder miteinander verglichen werden.
Unterstützte Operatoren: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Alle Versionen
Suchen Sie nach Arbeitselementen basierend darauf, ob sie ein Tag enthalten.
Unterstützte Operatoren: Contains, Does Not Contain
Alle Versionen
Suchen Sie nach Arbeitselementen, die auf leeren oder nicht leeren HTML-/Rich-Text-Feldern basieren.
Unterstützte Operatoren: Is Empty, Is Not Empty
Alle Versionen
Suchen Sie nach Aufgaben, deren Feldwert mit einem beliebigen Wert in einer durch Trennzeichen getrennten Gruppe übereinstimmt, z. B. eine Gruppe von Arbeitselementtypen, Workflowstatus oder Auswahllistenwerten. Trennen Sie mehrere Werte mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für den Clientcomputer festgelegt wurden. Sie können z. B. ein Komma (,) verwenden.
Alle Versionen
Suchen nach Sie Arbeitselementen basierend auf dem booleschen Feldwert.
Alle Versionen
Suchen Sie nach Arbeitselementen basierend auf Schlüsselwörtern oder Ausdrücken, die über eine Diskussion hinzugefügt wurden.
Alle Versionen
Suchen Sie Workitems anhand ihrer Spalte, Swimlane oder des Status Erledigt/Erledigt.
Alle Versionen
Filtern Sie Abfrageergebnisse basierend auf einem Schlüsselwort oder ausgewählten Feldern.
Alle Versionen
Installieren und verwenden Sie den WIQL-Editor, um Abfrageklauseln mit einem Massenvorgang zu verschieben, zu kopieren oder einzufügen.
Unterstützte Makros
In der folgenden Tabelle werden die Abfragemakros oder -variablen zusammengefasst, die von den Azure DevOps-Versionen unterstützt werden. Sie können einige dieser Makros verwenden, um Benachrichtigungen zu filtern.
Hinweis
Sie können bestimmte Makros nur über das Webportal verwenden. Dazu gehören die Makros @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity und @TeamAreas. Diese Makros werden nicht unterstützt, wenn Sie eine Abfrage nach Excel exportieren, Benachrichtigungsfilter verwenden oder die Abfrage aus Team Explorer oder REST-APIs ausführen.
Ausführlichere Beschreibungen und Links zu Beispielen finden Sie unter Abfragefelder, Operatoren und Makros.
Makro
Unterstützung von Abfragen
Unterstützte Versionen
Suchet nach einem beliebigen Arbeitselementtyp (Work Item Type=[Any]) oder einen beliebigen Status (State=[Any]).
Alle Versionen
Sucht nach Aufgaben, wobei Identity field=logged in user.
Alle Versionen
Sucht nach Aufgaben, wobei Date-Time field=today.
Alle Versionen
Suchet nach Aufgaben, die in mindestens einem Projekt definiert sind.
Alle Versionen
Sucht nach Aufgaben, die in der aktuellen Iteration für ein Team definiert sind.
Alle Versionen
Sucht nach Aufgaben, die in +/- n der aktuellen Iteration für ein Team definiert sind.
Alle Versionen
Findet Aufgaben, denen der aktuell angemeldete Benutzer folgt (ID In @Follows).
Alle Versionen
Sucht nach kürzlich geänderten Arbeitselementen (ID In @MyRecentActivity). Siehe auch Anzeigen und Hinzufügen von Arbeitselementen, Seite „Arbeitselemente“.
Alle Versionen
Sucht nach Aufgaben, bei denen sich das ausgewählte Datums-/Uhrzeitfeld innerhalb des aktuellen Tages, des aktuellen Monats, der aktuellen Woche oder des aktuellen Jahres mit einem Plus/Minus-Offset befindet, Beispiel: Closed Date>=@StartOfDay-7.
Alle Versionen
Sucht nach Aufgaben, die einem Bereichs- oder Iterationspfad des angegebenen Teams zugewiesen sind. Beispiele finden Sie unter Abfragen nach Bereich oder Iterationspfad.
Alle Versionen
Abfrageergebnisse und Funktionen für Abfrageverwaltung
Die folgenden Features bieten Unterstützung für das Arbeiten mit Abfrageergebnissen, das Speichern und Freigeben von Abfragen und vieles mehr.
-
Hinzufügen eines Abfragediagramms zu einem Dashboard
-
Interaktive Filter anwenden
-
Spaltensortierung wählen
-
Abfragespaltenoptionen auswählen
-
Kopieren von Abfrageergebnissen
-
Kopieren der Abfrage-URL
-
Abfrage-Diagramme erstellen
-
Abfrageordner erstellen
Nicht unterstützte Funktionen
Abfragen unterstützen nur Arbeitsaufgaben und Arbeitsaufgaben, die mit anderen Arbeitsaufgaben verknüpft sind. Verwaltete Abfragen unterstützen nicht:
- Hierarchische Ansichten von Testplänen, Testsuiten und Testfällen (diese Elemente verwenden keine Eltern-Kind-Links). Zeigen Sie stattdessen die Hierarchie über die Seite "Testpläne > testen" an.
- Ansichten, die verknüpfte Objekte anzeigen, z. B. Builds, Versionen, Code oder andere Nicht-Arbeitsaufgabenobjekte.
- Auflisten von Arbeitsaufgaben, die von einem Projekt zu einem anderen verknüpft sind.
- Exportieren einer projektübergreifenden Abfrage nach Excel (Direktverknüpfungsabfragen werden als einfache Liste exportiert).
Abfragetypen (Flatlist, Direktlinks, Struktur)
Azure Boards unterstützt drei Abfragetypen; das Symbol neben einer Abfrage gibt seinen Typ an. Wählen Sie den Typ basierend auf den benötigten Ergebnissen aus.
Abfragetyp
Verwendungshinweise
Flache Liste von Workitems
- Auflisten von Elementen zum Ausführen von Massenaktualisierungen
- Selektieren einer Liste von Arbeitselementen
- Erstellen eines Abfragediagramms und Hinzufügen zu einem Dashboard
- Erstellen eines Diagramms zum Zählen von Elementen oder Summieren eines numerischen Felds
- Exportieren einer Liste nach Excel zum Aktualisieren von Feldern
Arbeitselemente und direkte Links
- Listenelemente, die von anderen Arbeitsaufgaben abhängen
- Suchen verwandter oder abhängiger Elemente
- Auflisten verknüpfter Arbeitsaufgaben zum Ausführen von Massenaktualisierungen
- Priorisieren verknüpfter Arbeitsvorgänge, einschließlich testbezogener Links
- Suchen verwaister Backlogelemente (Elemente ohne übergeordnetes Element)
Hinweis
Arbeitsaufgaben und direkte Links Abfragen als flache Liste nach Excel exportieren. Excel importiert sie als flache Liste, da Excel das Ändern mehrerer Verknüpfungstypen nicht unterstützt.
Baum der Arbeitsaufgaben
- Liste eine Baumstruktur von Parent-Child-bezogenen Arbeitsitems oder anderen Baumtopologie-Verknüpfungstypen
- Triage hierarchischer Listen von Arbeitsaufgaben
- Exportieren einer hierarchischen Liste nach Excel zum Aktualisieren von Feldern oder Ändern der Hierarchie
Weitere Informationen zu Linktypen finden Sie unter Referenz zu Linktypen.
Eigene Abfragen, freigegebene Abfragen und Favoriten
Nur Sie können Abfragen anzeigen und ausführen, die unter "Meine Abfragen" gespeichert sind. Legen Sie eine Abfrage als Favorit fest, damit sie in der Abfrageauswahl angezeigt wird.
Abfragen, die unter "Freigegebene Abfragen " gespeichert wurden, sind für alle Personen mit Projektzugriff sichtbar. Organisieren Sie freigegebene Abfragen in Ordnern, und legen Sie sie als Favoriten fest, um schnell darauf zuzugreifen. Sie können Berechtigungen für Ordner und Abfragen festlegen, um zu verhindern, dass andere Personen sie verschieben oder bearbeiten.
Weitere Informationen finden Sie unter:
- Verwalten von Abfragen und Abfrageordnern
- Abfrageberechtigungen festlegen
- Bevorzugen Sie eine Abfrage und Persönliche oder Team-Favoriten aktivieren
Abfrageverzeichnis, Abfrageordner und Breadcrumbs
Die Seite "Abfragen " enthält "Favoriten" und "Alle Registerkarten". Auf jeder Registerkarte wird eine Verzeichnisansicht angezeigt, die Sie filtern können, um nach bestimmten Abfragen zu suchen.
Wenn Sie in den Abfragenseiten navigieren, können Sie einen Ordner, einen Unterordner oder eine Abfrageseite öffnen.
Während Sie Eine Auswahl treffen, werden Breadcrumbs oben auf der Seite angezeigt. Verwenden Sie sie, um zu einem Ordner, Unterordner oder einer Abfrageseite zu navigieren.
Sie können auch eine bevorzugte Abfrage auswählen oder über das Dropdownmenü einer geöffneten Abfrage zur Seite Alle Abfragen zurückkehren.
Weitere Informationen finden Sie unter Häufig gestellte Fragen zu Abfragen – Navigieren und Ordner.
Abfragediagramme und -widgets
Erstellen Sie Kreis-, Balken-, Pivot- und Trenddiagramme aus einer Abfrage mit Flachliste (Abfragen müssen 1000 oder weniger Arbeitselemente zurückgeben). Fügen Sie Abfragediagramme zu Dashboards hinzu, benennen Sie sie um, und konfigurieren Sie sie nach Bedarf neu.
Abfragebasierte Widgets zeigen Abfrageinformationen auf einem Dashboard an (z. B. Anzahl der aktiven Fehler oder eine interaktive Liste von Arbeitsaufgaben). Weitere Informationen finden Sie unter:
- Diagramm einer Flatlistabfrage
- Chart für Workitems Widget
- Widget für Abfrageergebnisse
- Abfrage-Kachel-Widget
Hinzufügen eines benutzerdefinierten Felds zur Unterstützung von Abfragen
Informationen zum Hinzufügen eines benutzerdefinierten Felds für Abfragen finden Sie unter Anpassen ihrer Arbeitsverfolgungserfahrung.
Taskboardelemente im Vergleich zu Abfragelistenelementen
Wenn sich der Inhalt des Taskboards von den Ergebnissen einer erstellten Abfrage unterscheidet, finden Sie informationen unter Taskboardelemente im Vergleich zu Abfragelistenelementen .
Volltextsuchabfragen und Sortierungseinstellungen
Wenn Sie Volltext-Suchabfragen mit den Operatoren Contains oder Contains Words verwenden, stellen Sie sicher, dass die SQL Server-Sortierung einer Sprache mit einem registrierten Worttrenner entspricht. Nicht unterstützte Sprachen können zu unerwarteten Ergebnissen führen.
Weitere Informationen finden Sie unter:
REST-API
Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in den folgenden REST-API-Ressourcen:
- Azure DevOps Services REST API Referenz
- Abfragen
- Work-Element-Abfragesprache
- Work-Elemente mit Abfragen programmgesteuert abrufen