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 Teamprojektfeld


GUID

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


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 unterstützte 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 für Flachlistenabfrage für das Filtern nach Schlüsselwörtern

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.

Verwenden von Wildcard mit Wörtern

Tipp

Informationen zum AND/OR Gruppieren von 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 Abfrage-Editoreintrags anzeigen 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 von Abfrage-Editor, um genaue Wörter einzuschließen und auszuschließen.

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.

Auf der Grundlage von leeren Einträgen filtern

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.

Filtern von nicht leeren HTML-Feldern

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.

Abfrageklausel zum Suchen nach Arbeitselementen nach Kategorie

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.

Abfrage-Editor mit ID In @Follows Abfrageklausel

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: Listenelemente, die kürzlich in Ihrem Projekt erstellt oder geändert wurden.

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

In der folgenden Abfrage wird beispielsweise gezeigt, wie Sie Arbeitselemente abfragen, die Sie kürzlich angezeigt oder geändert haben.

Abfrage-Editor mit ID in @MyRecentActivity Abfrageklausel

Allgemeine Felder für die meisten Arbeitsaufgabentypen

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 die Arbeitsaufgabe von allen anderen Personen desselben Typs zu unterscheiden. Die Felder "Beschreibung " und andere Rich-Text-Felder (Datentyp=HTML) enthalten zusätzliche Informationen, die zum Implementieren von Arbeits- und Nachverfolgänderungen erforderlich sind. Nachdem ein Arbeitselement erstellt wurde, können Sie alle Felder mit Ausnahme der ID ändern. Wenn Sie eine Arbeitsaufgabe hinzufügen und speichern, wird die ID vom System zugewiesen und kann nicht geändert werden.

Hinweis

Das System indiziert automatisch alle Long-Text-Felder mit einem Datentyp von PlainText - und HTML-Feldern für die Volltextsuche. Dies umfasst die Felder Title, Description und Steps to Repro . Weitere Informationen und Server- und Sortierungsanforderungen für lokale Azure DevOps finden Sie unter Abfragefelder, Operatoren, Werte und Variablen – Volltext- und Teilwortsuchen.

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. Unterhaltungen zwischen dem Team und den Kunden, um die Akzeptanzkriterien zu definieren, sorgen dafür, 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=Integer

Alle

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, Feedbackanfrage

Teamprojekt

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

Hinweis

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

Referenzname=System.TeamProject, Datentyp=Zeichenfolge

Alle

Titel

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

Referenzname=System.Title, Datentyp=Zeichenfolge

Alle

Arbeitselementtyp

Der Name des Arbeitselementtyps. Arbeitselementtypen werden basierend auf dem Prozess definiert, der beim Erstellen des 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 Operatoren "In Gruppe " und " Nicht in Gruppen " verwenden und eine Kategorie aus der Dropdownliste auswählen.

Referenzname=System.WorkItemType, Datentyp=Zeichenfolge

Alle

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 zurücksetzen. Siehe Verwalten von Arbeitsaufgabenfeldern (witadmin).

REST-API

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