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
- Die Operatoren "Leer" und "Nicht leer" werden für Azure DevOps Server 2019 RC2 und höher unterstützte Versionen unterstützt.
- 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.
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.
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.
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.
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.
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.
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 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.
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
- Weitere Informationen zum Arbeiten mit Rich-Text-Feldern finden Sie unter Freigeben von Informationen in Arbeitselementen.
- 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).
Verwandte Artikel
- Abfrage-Editor
- Add work items (Hinzufügen von Arbeitselementen)
- Arbeitselement-Feldindex
- Informationen zu verwalteten Abfragen
REST-API
Informationen zum programmgesteuerten Interagieren mit Abfragen finden Sie in einer der folgenden REST-API-Ressourcen: