Abfragen nach Titeln, IDs und Rich-Text-Feldern in Azure Boards und Azure DevOps

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Wenn Sie Arbeitselemente basierend auf einem Schlüsselwort oder einem Ausdruck oder einem Null-Textfeld finden möchten, können Sie dies tun, indem Sie dies durch Filtern auf Einzelzeilentext (String), Mehrzeilentext (PlainText) und Rich-Text (HTML)-Felder (Rich-Text) durchführen. Wenn Sie feststellen, dass Ihre Abfragen zu lange dauern, um Ergebnisse zurückzugeben, überprüfen Sie die Anleitung zum Erstellen hoher Leistung von Abfragen.

Unterstützte Operatoren und Makros

Abfrageklauseln, die ein Text- oder Rich-Text-Feld angeben, können die Operatoren und Makros verwenden, die in der folgenden Tabelle aufgeführt sind.


Datentyp

Unterstützte Operatoren und Makros


Rich-Text (HTML)
Mehrzeilige Textzeichenfolgen (PlainText)

Enthält Wörter, enthält keine Wörter, ist leer (Hinweis 1), ist nicht leer(Hinweis 1)


Mehrzeilige Textzeichenfolgen (PlainText)

Unterstützte Operatoren und Makros


Einzelner Text (Zeichenfolge)

= , <><>><= [ Feld], <>[Feld], [Feld<>>], =[<Feld], enthält, enthält nicht, nicht in der Gruppe, nicht in der Gruppe, nicht in der Gruppe, war jemals einmal enthalten.
Makros: [Alle], gültig mit dem Feld " Arbeitselementtyp "
@Project (Hinweis 2), gültig mit dem Feld "Team Project"


GUID

= , <>>><<In, Nicht in
Makros: @Follows,@MyRecentActivity, @RecentMentions, @RecentProjectActivity gültig mit dem ID-Feldund "In" und "Nicht in Operatoren "@Project" (Hinweis 2), gültig mit dem Feld "Team Project"


Felder "Status" und "Arbeitselementtyp"

= , <><>><= [ Feld], <>[Feld], [Feld<>>], =[<Feld], enthält, enthält nicht, nicht in der Gruppe, nicht in der Gruppe, nicht in der Gruppe, war jemals einmal enthalten.
Makros: [Alle] mit beiden Feldern gültig


Hinweis

  1. Die Operatoren "Leer" und "Nicht leer" werden für Azure DevOps Server 2019 RC2 und höher unterstützte Versionen unterstützt.
  2. Das @Project-Makro wird für Azure Boards- und TFS 2015.1- und höher-Versionen unterstützt. Das System wird automatisch auf Grundlage des aktuellen Projekts gefiltert. Weitere Informationen finden Sie unter Abfrage in allen Projekten.

Verwenden Contains words von Zeichenfolgen-Übereinstimmungen

Wenn Sie auf eine Zeichenfolgenverbindung filtern möchten, versuchen Sie, anstelle des Contains WordsContainsOperators zu verwenden. Der Contains Words Operator führt eine Volltextsuche im angegebenen Feld aus, die in den meisten Fällen schneller ist. Textzeichenfolge ist auf 100 Zeichen beschränkt.

Während der Contains Operator eine Tabellenüberprüfung ausführt, die nicht nur langsamer ist, sondern auch mehr CPU-Zyklen verbraucht. Diese CPU-Zyklen tragen zu Ihrem Ressourcenverbrauchslimit bei.

Schlüsselwort- oder Ausdrucksabfrage mit Wildcards

Verwenden Sie "Enthält" oder "Wörter enthalten ", um Elemente auflisten, die teilweise oder genau mit den Wörtern oder Ausdrücken übereinstimmen, die Sie eingeben.

Editor for flat list query for filtering key words

Wählen Sie "Enthält " oder " Nicht enthalten " aus, um nach exakten oder teilweisen Übereinstimmungen eines Worts oder Ausdrucks zu suchen. Wählen Sie "Wörter" oder "Wörter nicht enthalten" aus, um nach einem genauen Ausdruck zu suchen oder das Wildcardzeichen *zu verwenden. Bei Verwendung dieser Operatoren wird der Index für die Volltextsuche verwendet.

Geben Sie z. B. "Wörter" an, und informieren Sie sich, um nach einem Textfeld zu filtern, das InformationenoderInformationen enthält.

Use wild card with Contains Words

Tipp

Informationen zum Gruppieren von AND/OR-Klauseln finden Sie unter Erstellen und Speichern verwalteter Abfragen, Gruppenklauseln. 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.

Abfrage für bestimmte Wörter und nicht andere

Verwenden Sie Wörter und enthält keineWörteroperatoren, um Elemente auflisten zu können, die genau mit den Wörtern oder Ausdrücken übereinstimmen, die Sie eingeben, und andere Wörter oder Ausdrücke ausschließen. Sie können diese Operatoren in Kombination und mit dem Platzhalterzeichen (*)verwenden.

Im folgenden Beispiel filtern diese Operatoren Arbeitselemente für diese Elemente, die die Arbeitsphase enthalten, aber nicht das Wort Phasor.

Screenshot of Query Editor to include and exclude exact words.

Nicht definierte Feldwertabfragen

Sie können Arbeitselemente finden, die über einen nicht definierten Feldwert verfügen, indem Sie den Gleichheitsoperator (=) verwenden und den Wert für das Feld leer lassen. Die folgenden Filter werden beispielsweise alle Arbeitselemente des Typs "Task" auflisten, deren Aktivitätsfeld leer ist.

Filter based on blank entries

Wenn Sie Arbeitselemente basierend auf einem Feld auflisten möchten, das nicht leer ist, verwenden Sie den Nichtoperator (<>) und lassen Sie den Wert leer.

Leere oder nicht leere HTML-Feldabfragen

Sie können Arbeitselemente finden, in denen keine Beschreibung eingegeben wurde. Die Verwendung des Felds "Leer " oder "Nicht leer " mit einem HTML-Feld unterstützt das Auflisten von Arbeitselementen mit leeren oder nicht leeren Rich-Textfeldern. Sie geben keinen Wert mit diesem Operator an.

Beispielsweise werden die folgenden Abfragefilter alle Arbeitselemente auflisten, in denen einige Einträge im Feld "Beschreibung " vorgenommen wurden.

Filter based non-empty HTML fields

Hinweis

Die Möglichkeit, Arbeitselemente abzufragen, die keine Tags enthalten, ist kein unterstütztes Feature. Wenn Sie die Anfrage zur Unterstützung dieses Features auffordern möchten, können Sie dies auf unserer Entwicklercommunity Seite tun, können Sie nach leeren Tags suchen.

Kategoriebasierte Abfragen

Um Arbeitselemente basierend auf der Kategorie zu filtern, zu der sie gehören, verwenden Sie den In-Gruppen-Operator . Beispielsweise gibt die folgenden Filterkriterien alle Arbeitselemente zurück, die sich im aktuellen Projekt befinden, dem Teammitglied zugewiesen und als teil der Fehlerkategorie definiert sind.

Query clause to find work items by category

Welche Elemente werden in den Kategorien "Anforderung" oder "Aufgabe" angezeigt?

Die Standardzuweisungen von Arbeitselementtypen zu jeder Kategorie werden für jeden Prozess aufgeführt.

Prozess Anforderungskategorie Aufgabenkategorie
Basic Problem Aufgabe
Agilität User Story Aufgabe
Scrum Produktbacklogelement, Fehler Aufgabe
CMMI Anforderung Aufgabe

Jedes Team kann bestimmen, ob der Arbeitselementtyp "Fehler" entweder in der Kategorie "Anforderung" oder "Aufgabe" angezeigt wird. Siehe Anzeigen von Fehlern auf Backlogs und Boards. Sie können benutzerdefinierte Arbeitselementtypen zu einem Backlog hinzufügen. Details finden Sie unter Hinzufügen oder Ändern eines Arbeitselementtyps, Hinzufügen eines benutzerdefinierten WIT zu einem Backlog oder Board.

Abfrage für Arbeitselemente, die Sie folgen

Sie können das @Follows Makro verwenden, um eine Liste basierend auf Arbeitselementen zu filtern, die Sie zusammen mit anderen Abfragefiltern folgen.

Die folgende Abfrage zeigt beispielsweise, wie Sie alle Projekte für aktive Arbeitselemente abfragen, die Sie folgen. Sie verwenden das ID-Feld und den In-Operator mit dem @Follows Makro.

Query Editor, with ID In @Follows query clause

Abfrage für die zuletzt verwendete Arbeitselementaktivität

Sie können die folgenden Makros verwenden, um Arbeitselemente basierend auf zuletzt verwendeten Aktivitäten auflisten:

  • @MyRecentActivity: Listenelemente, die Sie zuletzt angezeigt oder geändert haben
  • @RecentMentions: Listenelemente, zu denen Sie in den letzten 30 Tagen über eine @mention hinzugefügt wurden
  • @RecentProjectActivity: Listen Sie Elemente auf, die kürzlich in Ihrem Projekt erstellt oder geändert wurden.

Geben Sie das ID-Feld und entweder die In - oder Nicht-In-Operatoren an.

Die folgende Abfrage zeigt beispielsweise, wie Sie Arbeitselemente abfragen, die Sie zuletzt angezeigt oder geändert haben.

Query Editor, with ID In @MyRecentActivity query clause

Allgemeine Felder für die meisten Arbeitselementtypen

In der folgenden Tabelle werden allgemeine Felder beschrieben, die zum Filtern von Abfragen verwendet werden. Die ID-Felder identifizieren Arbeitselemente in einer Liste eindeutig. Verwenden Sie das Feld "Titel ", um das Arbeitselement von allen anderen personen desselben Typs zu unterscheiden. Die Felder "Beschreibung " und andere Rich-Text -Felder (Datentyp=HTML) bieten zusätzliche Informationen, die zum Implementieren von Arbeits- und Nachverfolgänderungen benötigt werden. Nachdem ein Arbeitselement erstellt wurde, können Sie alle Felder mit Ausnahme der ID ändern. Wenn Sie ein Arbeitselement hinzufügen und speichern, wird die ID vom System zugewiesen und kann nicht geändert werden.

Hinweis

Das System indexiert automatisch alle Long-Text-Felder mit einem Datentyp von PlainText und HTML-Feldern für die Volltextsuche. Dies umfasst den Titel, die Beschreibung und die Schritte zum Repro-Feld . Weitere Informationen und Server- und Sortierungsanforderungen, die für lokale Azure DevOps gelten, finden Sie unter Abfragefelder, Operatoren, Werte und Variablen – Volltext- und Teilwortsuche.

Feldname

Beschreibung

Arbeitsaufgabentyp


Annahmekriterien 1

Eine Beschreibung der Kriterien, die erfüllt werden müssen, bevor der Fehler oder das Product Backlog Item geschlossen werden kann.

Vor Beginn der Bearbeitung eines Fehlers oder eines Product Backlog Items sollten die Kriterien für die Kundenakzeptanz so eindeutig wie möglich definiert werden. Unterhaltungen zwischen dem Team und den Kunden, um die Akzeptanzkriterien zu definieren, helfen ihnen, sicherzustellen, dass Ihr Team die Erwartungen Ihrer Kunden versteht. Die Akzeptanzkriterien können als Grundlage für Akzeptanztests verwendet werden, damit Sie effektiver auswerten können, ob ein Element zufriedenstellend abgeschlossen wurde.

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

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

Beschreibung 1, 2

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

Referenzname=System.Description, Datentyp=HTML

Alle

id

Der eindeutige Bezeichner, der einem Arbeitselement zugewiesen wurde. Arbeitselement-IDs sind für alle Projekte und innerhalb einer Projektsammlung eindeutig.

Referenzname=System.Id, Datentyp=Ganze Zahl

All

Repro-Schritte (oder Schritte zum Reproduzieren) 1

Die erforderlichen Schritte zum Reproduzieren des unerwarteten Verhaltens. Zeichnen Sie ausreichende Informationen auf, sodass andere Teammitglieder sowohl die vollständigen Auswirkungen des Problems verstehen als auch sicherstellen können, dass der Fehler behoben wurde. Hierzu gehören Aktionen zum Finden oder Reproduzieren des Fehlers und des erwarteten Verhaltens.
Referenzname=Microsoft.VSTS.TCM.ReproSteps, Datentyp=HTML

Bug

Lösung

Beschreibt, wie ein Impediment aufgelöst wurde.

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

Hindernis (Scrum)

Systeminformationen1

Informationen zur Software und zur Systemkonfiguration, die für den Fehler, die Codeüberprüfung oder das Feedback relevant sind.

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

Fehler, Codeüberprüfungsanfrage, Feedbackanforderung

Teamprojekt

Das Projekt, zu dem ein Arbeitselement gehört. Fügen Sie dieses Feld einer Abfrage hinzu, wenn Sie Ihre Liste in einem oder mehreren Projekten filtern möchten.

Hinweis

  Für Azure Boards oder für TFS 2015.1 und höher müssen Sie die Option "Abfrage über Projekte hinweg" im Abfrage-Editor für dieses Feld überprüfen, um in der Dropdownfeldliste anzuzeigen. Weitere Informationen finden Sie unter Beispielabfragen, Abfragen über Projekte hinweg.

Referenzname=System.TeamProject, Datentyp=String

Alle

Titel

Eine kurze Beschreibung mit einer Zusammenfassung der Arbeitsaufgabe, anhand derer Teammitglieder sie von anderen Arbeitsaufgaben in einer Liste unterscheiden können.

Verweisname=System.Title, Datentyp=Zeichenfolge

All

Arbeitselementtyp

Der Name des Arbeitselementtyps. Arbeitselementtypen werden basierend auf dem Prozess definiert, der beim Erstellen Ihres Projekts verwendet wird. Eine Übersicht finden Sie unter "Prozess auswählen". Informationen zum Hinzufügen eines benutzerdefinierten Arbeitselementtyps finden Sie unter Hinzufügen oder Ändern eines Arbeitselementtyps.

Um Arbeitselemente basierend auf ihrer Kategoriezuweisung zu filtern, können Sie die In-Gruppe - und Nicht-Gruppenoperatoren verwenden und eine Kategorie aus der Dropdownliste auswählen.

Referenzname=System.WorkItemType, Datentyp=String

All

Hinweis

  1. Weitere Informationen zum Arbeiten mit Rich-Text-Feldern finden Sie unter Freigeben von Informationen in Arbeitselementen.
  2. Nach dem Upgrade auf Team Foundation Server 2012 wurde das Feld "Beschreibung" von einem Feldtyp von "PlainText" in HTML geändert. Mithilfe des Befehls "witadmin changefield " können Sie den Datentyp für dieses Feld zurücksetzen. Siehe "Arbeitselementfelder verwalten" (witadmin).

REST-API

Informationen zum programmgesteuerten Interagieren mit Abfragen finden Sie in einer der folgenden REST-API-Ressourcen: