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


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)

= , <> , , , = , = , ><>< =[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
@Project (Hinweis 2), gültig mit dem Feld Team Project


GUID

= , <> , , , = , = , ><>< In, Not In
Makros:@Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity gültig mit dem Feld ID und den Operatoren In und Not In@Project (Hinweis 2), gültig mit dem Feld Team Project


Felder "Status" und "Arbeitselementtyp"

= , <> , , , = , = , ><>< =[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 beiden Feldern


Hinweis

  1. Die Operatoren Ist leer und Ist nicht leer werden für Azure DevOps Server 2019 RC2 und höhere Versionen unterstützt.
  2. Das @Project-Makro wird für Azure Boards und TFS 2015.1 und höhere Versionen unterstützt. Das System filtert standardmäßig automatisch basierend auf dem aktuellen Projekt. Weitere Informationen finden Sie unter Projektübergreifende Abfragen.

Verwenden Contains words für Zeichenfolgen-Übereinstimmungen

Wenn Sie nach einer Zeichenfolgen übereinstimmung filtern möchten, versuchen Sie, den Contains Words -Operator anstelle von zu Contains verwenden. Der Contains Words Operator führt eine Volltextsuche für das angegebene Feld aus, was in den meisten Fällen schneller ist. Die Textzeichenfolge ist auf 100 Zeichen beschränkt.

Während der Contains Operator einen Tabellenscan ausführt, der nicht nur langsamer ist, sondern auch mehr CPU-Zyklen verbraucht. Diese CPU-Zyklen tragen zu Ihrer Ratenbegrenzung für den Ressourcenverbrauch bei.

Schlüsselwort- oder Ausdrucksabfrage mit Platzhaltern

Verwenden Sie Enthält oder Enthält Wörter, um Elemente aufzulisten, die teilweise oder genau mit den eingegebenen Wörtern oder Ausdrücken übereinstimmen.

Editor for flat list query for filtering key words

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

Geben Sie z. B. Contains Words (Wörter enthält) und inform* an, um nach einem Textfeld zu filtern, das inform oder Informationen oder Information enthält.

Use wild card with Contains Words

Tipp

Informationen zur Gruppierung von AND/OR-Klauseln finden Sie unter Erstellen und Speichern verwalteter Abfragen, Gruppieren von Klauseln. Um die WIQL-Syntax für eine Abfrage anzuzeigen, installieren Sie die WIQL-Abfrage-Editor-Erweiterung, mit der Sie die WIQL-Version jedes Abfragebenutzeroberflächeneintrags anzeigen können.

Abfragen nach bestimmten Wörtern und nicht nach anderen Wörtern

Verwenden Sie die Operatoren "Contains Words" und "Does Not Contain Words", um Elemente aufzulisten, die genau mit den eingegebenen Wörtern oder Ausdrücken übereinstimmen, und schließen Sie andere Wörter oder Ausdrücke aus. Sie können diese Operatoren in Kombination und mit dem Platzhalterzeichen (*) verwenden.

Im folgenden Beispiel filtern diese Operatoren Arbeitselemente nach Elementen, 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 mit einem nicht definierten Feldwert suchen, indem Sie den Equals-Operator (=) verwenden und den Wert für das Feld leer lassen. Die folgenden Filter listen beispielsweise alle Arbeitselemente des Typs Task auf, deren Feld Aktivität leer ist.

Filter based on blank entries

Um Arbeitselemente basierend auf einem Feld aufzulisten, das nicht leer ist, verwenden Sie den Operator not ( ), und lassen Sie <> den Wert leer.

Leere oder nicht leere HTML-Feldabfragen

Sie finden Arbeitselemente, bei denen keine Beschreibung eingegeben wurde. Die Verwendung von Ist leer oder Ist nicht leer mit einem HTML-Feld unterstützt das Auflisten von Arbeitselementen mit leeren oder nicht leeren Rich-Text-Feldern. Sie geben mit diesem Operator keinen Wert an.

Mit den folgenden Abfragefiltern werden beispielsweise alle Arbeitselemente aufgeführt, in denen einige Einträge im Feld Beschreibung vorgenommen wurden.

Filter based non-empty HTML fields

Hinweis

Die Möglichkeit, Arbeitselemente abzufragen, denen keine Tags angefügt sind, wird nicht unterstützt. Wenn Sie die Anfrage zur Unterstützung dieses Features abstimmen möchten, können Sie dies auf unserer Seite Developer Community, 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 Operator In Gruppe. Die folgenden Filterkriterien geben beispielsweise alle Arbeitselemente zurück, die sich im aktuellen Projekt befinden, dem Teammitglied zugewiesen und als zur Fehlerkategorie gehörend 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 sind unten 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 ermitteln, ob der Arbeitselementtyp Fehler in der Kategorie Anforderung oder Aufgabe angezeigt wird. Weitere Informationen finden Sie unter Show bugs on backlogs and boards (Anzeigen von Fehlern in Backlogs und Boards). Sie können einem Backlog benutzerdefinierte Arbeitselementtypen hinzufügen. Weitere Informationen finden Sie unter Hinzufügen oder Ändern eines Arbeitselementtyps, Hinzufügen eines benutzerdefinierten WIT zu einem Backlog oder Board.

Abfragen von Arbeitselementen, denen Sie folgen

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

Die folgende Abfrage zeigt beispielsweise, wie Sie alle Projekte nach aktiven Arbeitselementen abfragen, denen Sie folgen. Sie verwenden das ID-Feld und den In-Operator mit dem @Follows Makro.

Query Editor, with ID In @Follows query clause

Abfragen der aktuellen Arbeitselementaktivität

Sie können die folgenden Makros verwenden, um Arbeitselemente basierend auf der aktuellen Aktivität aufzulisten:

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

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

Die folgende Abfrage zeigt beispielsweise, wie Arbeitselemente abgefragt werden, die Sie vor Kurzem 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 zum Filtern von Abfragen beschrieben. Die ID-Felder identifizieren Arbeitselemente in einer Liste eindeutig. Verwenden Sie das Feld Titel, um das Arbeitselement von allen anderen Typen desselben Typs zu unterscheiden. Die Felder Beschreibung und andere Rich-Text-Felder (Datentyp=HTML) enthalten zusätzliche Informationen, die zum Implementieren von Arbeit und Nachverfolgen von Änderungen erforderlich sind. 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 indiziert automatisch alle Langtextfelder mit dem Datentyp PlainText und HTML-Feldern für die Volltextsuche. Dies schließt die Felder Titel,Beschreibungund Schritte zum Erneuten Ausführen ein. Weitere Informationen und Server- und Sortierungsanforderungenfür lokale Azure DevOps finden Sie unter Abfragen von Feldern, Operatoren, Werten und Variablen – Volltext- und Teilwortsuche.

Feldname

Beschreibung

Arbeitsaufgabentyp


Akzeptanzkriterien 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. Konversationen zwischen dem Team und Kunden, um die Akzeptanzkriterien zu definieren, tragen dazu bei, 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.

Reference name=Microsoft.VSTS.Common.AcceptanceCriteria, Data type=HTML

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

Beschreibung 1, 2

Verwenden Sie dieses Feld, um ausführliche Informationen zu einem Arbeitselement zur Verfügung zu stellen.

Reference name=System.Description, Data type=HTML

All

id

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

Reference name=System.Id, Data type=Integer

All

Reproduktionsschritte (oder zu reproduzierende Schritte) 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.
Reference name=Microsoft.VSTS.TCM.ReproSteps, Data type=HTML

Bug

Lösung

Beschreibt, wie eine Beeinträchtigung aufgelöst wurde.

Reference name=Microsoft.VSTS.Common.Resolution, Data type=HTML

Hindernis (Scrum)

Systeminfo1

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

Reference name=Microsoft.VSTS.TCM.SystemInfo, Data type=HTML

Fehler, Code Review Request, Feedback Request

Teamprojekt

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

Hinweis

  Für Azure Boards oder TFS 2015.1 und höher müssen Sie die Option Projektübergreifende Abfrage im Abfrage-Editor aktivieren, damit dieses Feld in der Dropdownfeldliste angezeigt wird. Weitere Informationen finden Sie unter Beispielabfragen, projektübergreifende Abfragen.

Reference name=System.TeamProject, Data type=String

All

Titel

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

Reference name=System.Title, Data type=String

All

Arbeitselementtyp

Der Name des Arbeitselementtyps. Arbeitselementtypen werden basierend auf dem Prozess definiert, der beim Erstellen des Projekts verwendet wurde. Eine Übersicht finden Sie unter Auswählen des Prozesses. 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 Operatoren In Gruppe und Nicht in Gruppe verwenden und eine Kategorie aus der Dropdownliste auswählen.

Reference name=System.WorkItemType, Data type=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. Mit dem Befehl witadmin changefield können Sie den Datentyp für dieses Feld rückgängig machen. Weitere Informationen finden Sie unter Verwalten von Arbeitselementfeldern (witadmin).

REST-API

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

SDK-Ressourcen

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie unter Abfragen nach Fehlern, Aufgaben und anderen Arbeitselementen.

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

Wenn Sie Arbeitselemente basierend auf einem Schlüsselwort oder Ausdruck oder einem NULL-Textfeld suchen möchten, können Sie dazu nach Einzeilentext (String), mehrzeilenigem Text (PlainText) und Rich-Text-Feldern (HTML) filtern. Wenn Sie feststellen, dass ihre Abfragen zu lange dauern, um Ergebnisse zurück zu erhalten, lesen Sie den Leitfaden zum Erstellen leistungsstarker Abfragen.

Unterstützte Operatoren und Makros

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