Freigeben über

Abfragen nach Titeln, IDs und Rich-Text-Feldern

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Filtern Sie Arbeitsaufgaben nach Schlüsselwörtern, IDs oder leeren Textfeldern mithilfe von einzeiligen Textfeldern (String), mehrzeiligen Text (PlainText) und Rich-Text -Feldern (HTML). Wenn Abfragen zu lange dauern, um zurückzugeben, lesen Sie " Erstellen einer Abfrage", "Bewährte Methoden".

Voraussetzungen

Kategorie Anforderungen
Zugriffsebenen – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied.
– Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff.
Berechtigungen Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt.

Hinweis

Benutzer mit Stakeholder--Zugriff auf ein öffentliches Projekt haben vollen Zugriff auf Abfragefunktionen, genauso wie Benutzer mit Basic--Zugriff. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.

Kategorie Anforderungen
Zugriffsebenen – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied.
– Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff.
Berechtigungen Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt.

Unterstützte Operatoren und Makros

Verwenden Sie die Operatoren und Makros, die für Text- und Rich-Text-Felder aufgeführt sind.

Datentyp

Unterstützte Operatoren und Makros

Rich-Text (HTML)
Mehrzeilige Textzeichenfolgen (PlainText)

Contains Words, Does Not Contain WordsIs Empty1, Is Not Empty1

Einzelne Textzeichenfolge (String)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makros: [Any] gültig mit dem Feld " Arbeitselementtyp " und @Project"2", gültig mit dem Feld "Teamprojekt ".

ID

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makros: @Follows, , @MyRecentActivity@RecentMentions@RecentProjectActivity gültig mit dem ID-Feld und InNot In Operatoren.
@Project 2, gültig mit dem Feld "Teamprojekt ".

Zustand und Arbeitsaufgabe Typ Felder

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makros: [Any] gültig bei beiden Feldern.

Hinweis

  1. Die Operatoren Is Empty und Is Not Empty werden für Azure DevOps Server 2020 und höhere Versionen unterstützt.
  2. Das System wird standardmäßig basierend auf dem aktuellen Projekt gefiltert. Weitere Informationen finden Sie unter Projektübergreifende Abfrage.

Verwenden von Contains Words zum Abfragen übereinstimmender Zeichenfolgen

Wenn Sie nach einer Zeichenfolgenübereinstimmung filtern möchten, bevorzugen Sie den Contains Words-Operator gegenüber Contains. Contains Words verwendet den Volltextindex und ist in der Regel schneller. Textzeichenfolgen sind auf 100 Zeichen beschränkt.

Der Contains Operator führt einen Tabellenscan aus. Er ist langsamer und verbraucht mehr CPU-Ressourcen, was sich auf Ihre Geschwindigkeitsgrenzwerte auswirken kann.

Hinweis

Der Contains Words Operator verwendet die SQL-Volltext-Suchindizierung. Wenn ein neuer Wert in einem langen Textfeld gespeichert wird, SQL Server:

  • Teilt den Ausdruck in Wörter auf.
  • Entfernt allgemeine Stoppwörter (z. B. "a" oder "is")
  • Konvertiert Wörter zu ihrem gemeinsamen Stamm (z. B. laufen → Lauf)
  • Speichert die resultierenden Schlüsselwörter in einem Index.

Abfragen, die Contains Words den Index durchsuchen, liefern schnellere Ergebnisse für Langtextfelder. Weitere Informationen und Server-/Sortieranforderungen finden Sie unter Abfragefelder, Operatoren, Werte und Variablen – Volltext- und Teilwortsuchen.

Schlüsselwort- oder ausdrucksbasierte Abfrage mit Platzhaltern

Verwenden Sie Contains oder Contains Words, um Elemente zu finden, die teilweise oder genau mit Wörtern oder Ausdrücken übereinstimmen.

Screenshot des Editors für eine flache Listenabfrage, die zum Filtern von Schlüsselwörtern verwendet wird.

Wählen Sie Contains oder Does Not Contain für genaue oder teilweise Übereinstimmungen. Wählen Sie Contains Words oder Does Not Contain Words aus, um den Volltextindex und das Wildcardzeichen * zu verwenden.

Beispielsweise passt Contains Words mit inform* zu inform, information und informational.

Screenshot der Verwendung eines Wildcards mit dem Operator

Tipp

Informationen dazu, wie AND/OR Klauseln gruppiert werden, finden Sie unter "Gruppenklauseln". Um die WIQL-Syntax für eine Abfrage anzuzeigen, installieren Sie die WIQL-Abfrage-Editor-Erweiterung, mit der Sie die WIQL-Version eines Abfrage-Editor-Eintrags anzeigen können.

Abfragen nach bestimmten Wörtern unter Ausschluss anderer Wörter

Verwenden Sie Contains Words und Does Not Contain Words, um genaue Wörter oder Ausdrücke einzuschließen und andere auszuschließen. Kombinieren Sie diese Operatoren und verwenden Sie * für den Wildcardabgleich.

Das folgende Beispiel zeigt einen Filter, der die Arbeit "Phase" enthält, aber "Phasor" ausschließt.

Screenshot des Abfrageeditors, mit Einschluss und Ausschluss von exakten Wörtern.

Hinweis

Bestimmte reservierte SQL-Wörter, wie z. B. WHERE, THEN und AND, geben keine Ergebnisse zurück, wenn sie als eigenständige Suchbegriffe mit Contains Words oder Does Not Contain Words verwendet werden.

Abfragen von nicht definierten Feldwerten

Suchen Sie Arbeitsaufgaben mit einem nicht definierten (leeren) Feldwert, indem Sie den Operator = "gleich" verwenden und den Wert leer lassen. Mit den folgenden Filtern werden beispielsweise alle Vorgänge aufgelistet, deren Aktivitätsfeld leer ist.

Screenshot eines Filters, in dem der Wert

Um Elemente zu finden, bei denen ein Feld nicht leer ist, verwenden Sie den Operator <> "nicht", und lassen Sie den Wert leer.

Abfragen von leeren oder nicht leeren HTML-Feldern

Verwenden Sie Is Empty oder Is Not Empty mit einem HTML-Feld, um Arbeitselemente mit leeren oder nicht leeren Rich-Text-Feldern aufzulisten. Sie geben keinen Wert für diese Operatoren an.

Screenshot, der das Filtern nach nicht leeren HTML-Feldern zeigt.

Filtern nach Sonderzeichen

Sonderzeichen wie / oder - mit einem Backslash escapen beim Filtern von URLs oder Ausdrücken.

  • Filtern nach einer URL:

    • Abfrage: Title ~ "https:\/\/example.com\/path-to-resource"
    • Ergebnisse: Gibt Arbeitsaufgaben mit der genauen URL zurück.

  • Filtern nach einem Ausdruck mit einem Gedankenstrich:

    • Abfrage: Title ~ "feature-update\-2023"
    • Ergebnisse: Gibt Arbeitsaufgaben zurück, die den exakten Ausdruck mit Bindestrichen enthalten.

Hinweis

Sie können keine Arbeitsaufgaben abfragen, denen keine Tags angehängt sind. Besuchen Sie die Entwickler-Community, um diese Featureanfrage zu bewerten: Nach leeren Tags suchen zu können.

Kategoriebasierte Abfragen

Verwenden Sie den In Group Operator, um nach Kategorie zu filtern. Im folgenden Beispiel werden Elemente im aktuellen Projekt zurückgegeben, die dem Teammitglied und der Kategorie "Fehler" zugewiesen sind.

Screenshot einer Klausel, die Arbeitsaufgaben nach Kategorie findet.

Welche Elemente werden in den Kategorien „Anforderung“ oder „Aufgabe“ angezeigt?

Standardmäßige Arbeitsaufgabentypzuweisungen für jeden Prozess:

Prozess Anforderungskategorie Aufgabenkategorie
Basic Problem Aufgabe
Agilität Benutzerstory Aufgabe
Scrum Product Backlog Item, Fehler Aufgabe
CMMI Anforderung Aufgabe

Teams können wählen, ob der Arbeitsitem-Typ "Fehler" in der Kategorie "Anforderung" oder "Aufgabe" angezeigt wird. Weitere Informationen finden Sie unter Anzeigen von Fehlern in Backlogs und Boards. Informationen zum Hinzufügen von benutzerdefinierten Arbeitsaufgabentypen zu einem Backlog finden Sie unter Hinzufügen oder Ändern eines Arbeitsaufgabentyps.

Abfragen von Arbeitselementen, denen Sie folgen

Verwenden Sie das @Follows Makro mit dem Feld "ID" und dem In Operator, um die Arbeitsaufgaben aufzulisten, die Sie, falls erforderlich, über alle Projekte hinweg befolgen.

Screenshot des Abfrageeditors mit

Abfragen der letzten Arbeitselementaktivität

Verwenden Sie diese Makros, um Elemente basierend auf der letzten Aktivität auflisten:

  • @MyRecentActivity: Elemente, die Sie kürzlich angezeigt oder geändert haben.
  • @RecentMentions: Elemente mit einer @mention für Sie in den letzten 30 Tagen.
  • @RecentProjectActivity: Elemente, die kürzlich in Ihrem Projekt erstellt oder geändert wurden.

Verwenden Sie das ID-Feld mit In oder Not In.

Screenshot des Abfrage-Editors mit der ID In @MyRecentActivity Makro-Abfrage

Allgemeine Felder für die meisten Arbeitselementtypen

In dieser Tabelle werden allgemeine Felder beschrieben, die in Abfragen verwendet werden. Die ID identifiziert eine Arbeitsaufgabe eindeutig. Verwenden Sie "Titel", um Elemente desselben Typs zu unterscheiden. Beschreibung und andere Rich-Text-Felder enthalten detaillierte Implementierungsinformationen. Nach der Erstellung können Sie alle Felder mit Ausnahme der ID ändern. das System weist die ID zu, wenn die Arbeitsaufgabe erstellt wird.

Hinweis

Das System indiziert Lange-Text-Felder vom Typ PlainText und HTML für die Volltextsuche, einschließlich Title, Descriptionund Steps to Repro. Ausführliche Informationen und Server-/Sortieranforderungen für lokale Azure DevOps finden Sie unter Abfragefelder, Operatoren, Werte und Variablen – Volltext- und Teilwortsuchen.

Feldname

Beschreibung

Work-Element-Typ

Akzeptanzkriterien 1

Eine Beschreibung der Kriterien, die erfüllt werden müssen, bevor das Fehler- oder Produktrückstandselement geschlossen werden kann.

Bevor die Arbeit beginnt, erfassen Sie klare Akzeptanzkriterien, damit das Team und die Kunden die Erwartungen teilen. Akzeptanzkriterien helfen dabei, Akzeptanztests zu definieren und zu bestätigen, ob das Element abgeschlossen ist.

Verweisname = Microsoft.VSTS.Common.AcceptanceCriteria, Datentyp = HTML

Fehler, Epic, Feature, Product Backlog Item (Scrum)

Beschreibung 1, 2

Verwenden Sie dieses Feld, um ausführliche Informationen zu einem Arbeitselement bereitzustellen.

Verweisname = System.Description, Datentyp = HTML

Alle

ID

Der eindeutige Bezeichner, der einer Arbeitsaufgabe zugewiesen ist. IDs sind für Projekte innerhalb einer Projektsammlung eindeutig.

Verweisname = System.Id, Datentyp = Integer

Alle

Reproduktionsschritte (oder „Zu reproduzierende Schritte“) 1

Schritte, die erforderlich sind, um unerwartetes Verhalten zu reproduzieren. Erfassen Sie genügend Details, damit andere Korrekturen reproduzieren und überprüfen können.

Verweisname=Microsoft.VSTS.TCM.ReproSteps, Datentyp=HTML

Bug

Lösung

Beschreibt, wie ein Impediment gelöst wurde.

Verweisname = Microsoft.VSTS.Common.Resolution, Datentyp = HTML

Hindernis (Scrum)

Systeminfo1

Informationen zur Software- und Systemkonfiguration, die für den Fehler oder das Feedback relevant ist.

Verweisname = Microsoft.VSTS.TCM.SystemInfo, Datentyp = HTML

Fehler, Codereviewanforderung, Feedbackanforderung

Teamprojekt

Das Projekt, das die Arbeitsaufgabe besitzt. Fügen Sie dieses Feld zu einer Abfrage hinzu, um nach einem oder mehreren Projekten zu filtern. Ausführliche Informationen finden Sie unter "Abfragen für alle Projekte".

Verweisname = System.TeamProject, Datentyp = String

Alle

Titel

Eine kurze Beschreibung, die die Arbeitsaufgabe zusammenfasst und Teammitgliedern hilft, sie von anderen zu unterscheiden.

Verweisname = System.Title, Datentyp = String

Alle

Arbeitselementtyp

Der Name des Arbeitsaufgabentyps, der durch den Prozess definiert wird, der beim Erstellen des Projekts verwendet wurde. Weitere Informationen finden Sie unter Prozesse und Prozessvorlagen und Hinzufügen oder Ändern eines Arbeitselementtyps.

Um nach Kategoriezuweisung zu filtern, verwenden Sie die In Group und Not In Group Operatoren und wählen Sie eine Kategorie aus der Dropdown-Liste aus.

Verweisname = System.WorkItemType, Datentyp = String

Alle

Verwandte Inhalte

REST-API

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in den folgenden REST-API-Ressourcen:

  • Last updated on