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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Wenn Sie Arbeitselemente basierend auf einem Schlüsselwort oder Einem Ausdruck oder einem Null-Textfeld suchen möchten, können Sie dies tun, indem Sie nach einzeiligen Textfeldern (String), mehrzeiligen Text (PlainText) und Rich-Text (HTML)-Feldern filtern. Wenn Sie feststellen, dass Ihre Abfragen zu lange dauern, um Ergebnisse zurückzugeben, lesen Sie die Anleitung zum Erstellen von leistungsstarken 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)

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


Einzelner Text (Zeichenfolge)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMakros: [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 EverMakros: @Follows, , @RecentMentions@MyRecentActivity@RecentProjectActivity gültig mit dem FELD "ID" und Not InIn "Operatoren@Project 2", gültig mit dem Feld "Teamprojekt".


Felder "Status " und "Arbeitselementtyp "

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Enthält nicht in ", Nicht in, , ", Gruppe" enthalten, wurde **Macros**: in beiden Feldern nie [alle]', gültig.,


Hinweis

  1. Die und Is Not Empty Operatoren Is Empty werden für Azure DevOps Server 2019 RC2 und höhere Versionen unterstützt.
  2. Das System wird automatisch basierend auf dem aktuellen Projekt gefiltert. Weitere Informationen finden Sie unter "Abfrage für alle Projekte".

Verwendung Contains words für Zeichenfolgen-Übereinstimmungen

Wenn Sie nach einer Zeichenfolgenzustimmung filtern möchten, versuchen Sie, den Contains Words Operator anstelle von Contains. Der Contains Words Operator führt eine Volltextsuche im angegebenen Feld aus, was in den meisten Fällen schneller ist. Die 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 Ressourcenverbrauchsratenlimit bei.

Schlüsselwort- oder Ausdrucksabfrage mit Wildcards

Verwenden Sie "Enthält " oder "Wörter" zum Auflisten von Elementen, die teilweise oder genau mit den von Ihnen eingegebenen Wörtern oder Ausdrücken übereinstimmen.

Editor für flache Listenabfrage zum Filtern von Schlüsselwörtern.

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" aus, oder enthält keine Wörter , um nach einem genauen Ausdruck zu suchen oder das Leerzeichen *zu verwenden. Bei Verwendung dieser Operatoren wird der Index für die Volltextsuche verwendet.

Geben Sie z. B. "Wörter" und "Inform*" an, um nach einem Textfeld zu filtern, das Informationen oder Informationen enthält.

Verwenden Sie die Freihalterkarte mit

Tipp

Informationen dazu, wie AND/OR Klauseln gruppiert werden, finden Sie unter Erstellen und Speichern von verwalteten Abfragen, 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 und nicht für andere

Use Contains Words and Does Not Contain Words operator to list items that exactly match the words or phrase that you enter, and exclude other words or phrases. 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 einen nicht definierten Feldwert haben, indem Sie den Gleichheitsoperator (=) verwenden und den Wert für das Feld leer lassen. In den folgenden Filtern werden beispielsweise alle Arbeitselemente des Typs "Vorgang" aufgelistet, 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-Text-Feldern. Sie geben keinen Wert mit diesem Operator an.

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

Filterbasierte nicht leere HTML-Felder

Hinweis

Die Möglichkeit zum Abfragen nach Arbeitselementen, die keine Tags an sie angefügt haben, ist kein unterstütztes Feature. Wenn Sie die Anforderung zur Unterstützung dieses Features abstimmen möchten, können Sie dies auf unserer Entwicklercommunity Seite tun, um nach leeren Tags zu suchen.

Kategoriebasierte Abfragen

Um Arbeitselemente basierend auf der Kategorie zu filtern, zu der sie gehören, verwenden Sie den In-Gruppenoperator . Die folgenden Filterkriterien geben beispielsweise alle Arbeitselemente zurück, die im aktuellen Projekt enthalten sind, 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 Arbeitsaufgabentypen zu jeder Kategorie sind für jeden Prozess aufgeführt.

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

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

Abfragen nach 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 folgen.

In der folgenden Abfrage wird beispielsweise gezeigt, wie Sie alle Projekte für aktive Arbeitselemente abfragen, denen 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 Aktivität der Arbeitsaufgabe

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

  • @MyRecentActivity: Listenelemente, die Sie kürzlich angezeigt oder geändert haben.
  • @RecentMentions: Listenelemente, 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 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 für lokale Azure DevOps 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

All

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. Weitere Informationen finden Sie unter Beispielabfragen, Abfragen über Projekte hinweg.

Referenzname=System.TeamProject, Datentyp=String

All

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" aus 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: