Abfragefelder, Operatoren und Makros in Azure Boards

Beschreibung

Gibt ein Feld an, das einen TRUE/FALSE-Wert annimmt.

Ein Datumsfeld, in dem Sie eine Variable angeben können, z. B. @Today oder @Today-1 oder einen Wert, z. B. 01/01/2025. Geben Sie Datumsangaben in dem Datumsmuster ein, das Sie für Ihr persönliches Profil festgelegt haben. (Weitere Informationen finden Sie unter Festlegen persönlicher Einstellungen.) Beispiele für Abfragen finden Sie unter Query by date or @CurrentIteration.

Für WIQL-Abfragen können Sie das Datum auch im UTC-Muster (Coordinated Universal Time) angeben. Weitere Informationen finden Sie unter Syntax für die Arbeitselement-Abfragesprache (Work Item Query Language, WIQL).

Eine reelle Zahl, z. B. 0,2 oder 3,5. Abfragebeispiele finden Sie unter Abfragen nach numerischen Feldern.

Eine Zeichenfolge, die eine eindeutige ID darstellt.

Benutzerdefiniert formatiertes Feld, das zur Nachverfolgung von Verlaufsinformationen verwendet wird. Dieser Datentyp wird nur verwendet, um das Feld Verlauf zu unterstützen. Dieses Feld wird automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und partielle Wortsuchen weiter unten in diesem Artikel. Abfragebeispiele finden Sie unter Verlauf und Überwachung.

Textzeichenfolgen, die formatierte Beschreibungen unterstützen, wie die Felder Beschreibung und Reproduktionsschritte. Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und partielle Wortsuchen weiter unten in diesem Artikel. Informationen zum Abfragen von Rich-Text-Feldern finden Sie unter Abfragen nach Titeln, IDs und Rich-Text-Feldern.

Kurze Textzeichenfolge, die eine Benutzeridentität identifiziert.

Eine 32-Bit-Ganzzahl mit Vorzeichen, z. B. 0, 1, 2 oder 34.

Textzeichenfolgen, die lange Beschreibungen unterstützen, wie das Feld Informationen zum Anwendungsstart. Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und partielle Wortsuchen weiter unten in diesem Artikel. Informationen zum Abfragen von Nur-Text-Feldern finden Sie unter Abfragen nach Titeln, IDs und Rich-Text-Feldern.

Benutzerdefiniertes Feld, das definiert wird, um eine Auswahlliste von Dezimalwerten zu enthalten.

Benutzerdefiniertes Feld, das definiert wird, um eine Auswahlliste von Integerwerten zu enthalten.

Benutzerdefiniertes Feld, das definiert wird, um eine Auswahlliste von kurzen Textzeichenfolgenwerten (maximal 255 Zeichen) zu enthalten.

Eine kurze Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann. Zeichenfolgentextfelder werden häufig verwendet, um Auswahllisten oder Dropdownmenüs zu unterstützen.

Eine Branchstruktur, z. B. ein Bereichspfad oder ein Iterationspfad. Wählen Sie ein Element aus einer Liste gültiger Werte aus. Suchen Sie Arbeitsaufgaben, die gleich, nicht gleich, unter oder nicht unter einer Struktur sind. Sie können auch die Operatoren In oder Not In verwenden, um mehrere Werte anzugeben. Definieren Sie die Struktur für ein Projekt – Bereichspfade und Iterationspfade – und wählen dann die Struktur aus, die Sie einem Team zuordnen möchten.

Weitere Informationen zum Erstellen von Abfragen finden Sie unter Abfrage nach Bereich oder Iterationspfad oder Abfrage nach Datum oder aktueller Iteration.

Gibt Arbeitselemente zurück, wenn der Wert in dem Arbeitselement den angegebenen Kriterien entspricht

Anwendbare Datentypen

Entspricht dem Wert in der Klausel.

Number – einschließlich Double, GUID, Integer – und String, DateTime sowie TreePath

Entspricht nicht dem Wert in der Klausel.

Number, String, DateTime und TreePath

Ist größer als der Wert in der Klausel.

Number, String und DateTime

Ist kleiner als der Wert in der Klausel.

Number, String und DateTime

Ist größer als oder gleich dem Wert in der Klausel.

Number, String und DateTime

Ist kleiner als oder gleich dem Wert in der Klausel.

Number, String und DateTime

Entspricht dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld
Überprüft, ob das boolesche Feld mit einem anderen Feld identisch ist.

Entspricht nicht dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.
Überprüft, dass das boolesche Feld nicht mit einem anderen Feld identisch ist.

Ist größer als der Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

Ist kleiner als der Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

Ist größer als oder gleich dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

Ist kleiner oder gleich dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

Enthält eine exakte oder teilweise Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie für das Filtern ausgewählt haben.

String

Enthält keine genaue oder teilweise Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie zum Filtern ausgewählt haben.

String

Enthält die genaue Textzeichenfolge oder Wörter innerhalb des Felds, das Sie für das Filtern ausgewählt haben. Sie können auch Teile von Wörtern oder Ausdrücken eingeben, die das Platzhalterzeichen * enthalten. Die Zeichenfolge darf maximal 100 Zeichen enthalten. Informationen zu Einschränkungen finden Sie in den Server- und Sortierreihenfolgenanforderungen unter Volltextsuchen.

Felder mit langem Text werden für die Volltextsuche indiziert, was allen PlainText- und HTML-Feldern sowie den Feldern History und Title entspricht.

Enthält nicht die genaue Textzeichenfolge oder die genauen Wörter innerhalb des Felds, das Sie zum Filtern ausgewählt haben. Die Zeichenfolge darf maximal 100 Zeichen enthalten.

Verwenden Sie diesen Operator in Kombination mit einer Klausel mit dem Contains Words-Operator, um bestimmte Schlüsselwörter ein- und auszuschließen.

Textfelder, die für die Volltextsuche indiziert sind.

Entspricht einem beliebigen Wert in einer durch Trennzeichen getrennten Liste. Beispielsweise können Sie nach Arbeitselementen mit der ID 100, 101 und 102 suchen, indem Sie die entsprechenden Werte im Feld für die ID eingeben. Trennen Sie mehrere Werte mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für den Clientcomputer festgelegt wurden. Sie können z. B. ein Komma , verwenden.

Number, String, DateTime, TreePath

Listet Arbeitselemente auf, die ein leeres HTML-Feld enthalten. Sie geben mit diesem Operator keinen Wert an. Dieser Operator wird für Azure Boards und Azure DevOps Server unterstützt.

HTML

Listet Arbeitselemente auf, die Inhalte im HTML-Feld enthalten. Sie geben mit diesem Operator keinen Wert an. Dieser Operator wird für Azure Boards und Azure DevOps Server unterstützt.

HTML

Entspricht keinem Wert in einer durch Trennzeichen getrennten Liste. Sie können Arbeitselemente, deren Status nicht „Gelöst“, „Abgeschlossen“ oder „Geschlossen“ ist, aus Abfrageergebnissen ausschließen, wenn Sie diese Werte für das Statusfeld angeben. Trennen Sie mehrere Werte mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für den Clientcomputer festgelegt wurden. Sie können z. B. ein Komma , verwenden.

Der Operator Not In wird für Azure Boards und Azure DevOps Server unterstützt.

Number, String, DateTime, TreePath

Entspricht einem Wert, der ein Member der Gruppe in der Klausel ist. Gruppen entsprechen dem Namen eines Teams, einer Sicherheitsgruppe oder einer Arbeitsnachverfolgungskategorie. Beispielsweise können Sie eine Abfrage erstellen, um alle Arbeitselemente zu suchen, die Mitgliedern der Gruppe „Contributors“ oder einem Team zugewiesen wurden. Teamgruppen werden erstellt, wenn ein Team angelegt wird. Der Name von Teamgruppen folgt dem Muster [Teamprojektname]\Teamname.

Beispielabfragen finden Sie unter Abfragen nach Zuweisung oder Workflowänderungen.

Zeichenfolge, die mit dem Namen eines Teams, einer Sicherheitsgruppe oder einer Kategorie übereinstimmt, das bzw. die im System definiert ist.

Weitere Informationen finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitsaufgabentypen.

Entspricht keinem Wert, der ein Member der Gruppe in der Klausel ist.

Zeichenfolge, die mit dem Namen einer Benutzergruppe in Azure DevOps Server oder einer Kategoriegruppe übereinstimmt, die für ein Projekt definiert wird.

Entspricht nicht dem Wert in der Klausel und ist nicht unter dem Knoten in der Klausel enthalten.

TreePath

Entspricht dem Wert in der Klausel oder ist unter dem Knoten in der Klausel enthalten.

TreePath

Entspricht dem Wert in der Klausel an einem vorherigen Punkt.

String , DateTime

Beschreibung

Verwenden Sie diese Option mit den Feldern Arbeitselementtyp oder Status, um alle Arbeitselementtypen oder alle Status zu durchsuchen. Work Item Type=[Any] legt beispielsweise keine Filter basierend auf dem Arbeitselementtyp fest.

Verwenden Sie dieses Makro mit dem Feld Iterationspfad, um basierend auf dem aktuellen Teamfokus oder Kontext automatisch nach Arbeitselementen zu filtern, die dem aktuellen Sprint zugewiesen sind. Spezifische Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.
Das Makro @CurrentIteration funktioniert nur, wenn es über das Webportal ausgeführt wird. Sie können das Makro nicht beim Kopieren oder Klonen von Testsammlungen und Testfällen, beim Definieren von Warnungen oder mit REST-APIs verwenden.

Verwenden Sie dieses Makro mit dem Feld Iterationspfad, um basierend auf dem aktuellen Teamfokus oder Kontext nach Arbeitselementen zu filtern, die dem aktuellen Sprint +/- n Sprints zugewiesen sind. Spezifische Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.
Das Makro @CurrentIteration +/- n wird für Azure Boards, Azure DevOps Server und nur bei der Ausführung über das Webportal unterstützt.

Verwenden Sie das Feld ID und den In-Operator, um alle Arbeitselemente aufzulisten, denen Sie im Projekt folgen. Weitere Informationen dazu finden Sie unter Einem Arbeitselement oder Pull Request folgen. Sie können dieselbe Liste auf der Seite „Arbeitselemente“, Folgen-Pivotansicht anzeigen.
Das Makro @Follows wird nur unterstützt, wenn es über das Webportal ausgeführt wird.

Verwenden Sie dieses Makro mit einem Identitäts- oder Benutzerkontofeld, um automatisch nach Elementen zu suchen, die Ihrem Benutzer- oder Kontonamen zugeordnet sind. Sie können beispielsweise Arbeitselemente finden, die Sie mit der Created By=@Me-Klausel geöffnet haben. Weitere Beispiele finden Sie unter Abfragen nach Zuweisung, Workflow oder Boardänderungen.

Verwenden Sie dieses Makro mit dem Feld ID und dem In-Operator, um Arbeitselemente auflisten, die Sie innerhalb der letzten 30 Tage im Projekt angezeigt oder aktualisiert haben. Sie können dieselbe Liste auf der Seite „Arbeitselemente“, Meine Aktivität-Pivotansicht anzeigen.

Verwenden Sie dieses Makro zusammen mit dem Feld Teamprojekt, um nach Arbeitselementen in anderen Projekten zu filtern. Beispielsweise finden Sie alle Arbeitselemente im aktuell ausgewählten Projekt mit der Team Project=@Project-Klausel. Standardmäßig filtert das System automatisch basierend auf dem aktuellen Projekt. Weitere Informationen finden Sie unter Definieren einer Abfrage, Abfragen über alle Projekte.

Verwenden Sie dieses Makro mit dem Feld ID und dem In-Operator, um Arbeitselemente aufzulisten, bei denen Sie im Diskussionsabschnitt erwähnt werden. Sie können dieselbe Liste auf der Seite „Arbeitselemente“, Erwähnt-Pivotansicht anzeigen.

Verwenden Sie dieses Makro mit dem Feld ID und dem In-Operator, um Arbeitselemente aufzulisten, die kürzlich aktualisiert wurden. Die Anzahl der aufgeführten Arbeitselemente hängt von der Arbeitsnachverfolgungsaktivität des Projekts ab. Bei extrem aktiven Projekten listet das Makro Arbeitselemente auf, die innerhalb der letzten 30 Tage im Projekt aktualisiert wurden. Bei weniger aktiven Projekten kann diese Liste jedoch Arbeitselemente enthalten, die älter als 30 Tage sind. Sie können ähnliche Listen auf der Seite „Arbeitselemente“, Pivotansichten Zuletzt erstellt, Zuletzt aktualisiert und Zuletzt abgeschlossene anzeigen. Die Anzahl der zurückgegebenen Arbeitselemente ist auf 5.000 begrenzt.

Verwenden Sie dieses Makro mit einem DateTime-Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Datum beziehen, oder auf ein Datum mit einem Plus/Minus-Versatz. Sie können mit der Closed Date>=@StartOfDay-7-Klausel beispielsweise alle Elemente finden, die in der letzten Woche geschlossen wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

Verwenden Sie dieses Makro mit einem DateTime-Feld, um nach Arbeitselementen zu filtern, die sich auf den aktuellen Monat beziehen, oder auf einen Monat mit einem Plus/Minus-Versatz. Sie können beispielsweise alle Elemente finden, die in den letzten drei Monaten mit der Created Date>=@StartOfMonth-3-Klausel erstellt wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

Verwenden Sie dieses Makro mit einem DateTime-Feld, um nach Arbeitselementen zu filtern, die sich auf die aktuelle Woche beziehen, oder auf eine Woche mit einem Plus/Minus-Versatz. Beispielsweise können Sie alle Elemente finden, die in den letzten zwei Wochen mit der Changed Date>=@StartOfWeek-2-Klausel geändert wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

Verwenden Sie dieses Makro mit einem DateTime-Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Jahr beziehen, oder auf ein J mit einem Plus/Minus-Versatz. Mit der Target Date>=@StartOfYear-Klausel können Sie beispielsweise alle Features finden, deren Zieldatum innerhalb des aktuellen Jahres geplant ist. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

Verwenden Sie dieses Makro nur mit dem Feld Bereichspfad , um nach Arbeitselementen zu filtern, deren Bereichspfad einem Bereichspfad entspricht, der einem bestimmten Team zugewiesen wurde. Erfordert die Verwendung des =-Operators. Sie können mit der Area Path=@TeamAreas [Fabrikam Fiber]\Web-Klausel beispielsweise alle Elemente finden, die den Bereichspfaden zugewiesen sind, die dem Webteam zugewiesen sind. Weitere Beispiele finden Sie unter Abfragen nach Bereich oder Iterationspfad.
Das Makro @TeamAreas wird für Azure DevOps Server und nur bei der Ausführung über das Webportal unterstützt.

Verwenden Sie dieses Makro mit einem DateTime-Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Datum , oder auf ein früheres Datum beziehen. Sie können das Makro @Today auch durch das Subtrahieren von Tagen ändern. Sie können mit der Created Date>=@Today-7-Klausel beispielsweise alle Elemente finden, die in der letzten Woche erstellt wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.