Freigeben über

Abfragefelder, Operatoren und Makros in Azure Boards

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Dieser Artikel enthält Beschreibungen jedes Felddatentyps, Abfrageoperators und Abfragemakros. Einige Datentypen, Operatoren und Makros sind nur für die angegebene Azure DevOps-Version gültig.

Weitere Informationen finden Sie unter Abfrageschnellübersicht und Verwalten und Organisieren von Abfragen.

Abfragefeld-Datentypen und -werte

Der Wert, den Sie für ein Feld angeben, muss dem Datentyp dieses Felds entsprechen. In der folgenden Tabelle sind die unterstützten Datentypen aufgeführt:

Hinweis

Für den Azure Boards-Clouddienst entspricht der Datentyp dem Datentyp, der für das Feld auf der Seite Prozess>Felder aufgeführt wird. Bei lokalen Bereitstellungen entspricht der Datentyp dem type-Attribut, das einer FIELD-Definition zugewiesen ist. Weitere Informationen finden Sie unter Arbeitselementfelder und Feldattribute.

Datentyp

Beschreibung

Boolescher Wert

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

DateTime oder Date/Time

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).

Double oder Decimal

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

GUID

Eine Zeichenfolge, die eine eindeutige ID darstellt.

History

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.

HTML

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.

Identität

Kurze Textzeichenfolge, die eine Benutzeridentität identifiziert.

Integer

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

PlainText oder Textfeld (mehrzeilig)

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.

picklistDouble

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

picklistInteger

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

picklistString

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

Zeichenfolge oder Textfeld (einzeilig)

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

TreePath

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.

Hinweis

Die picklist-Datentypen werden nur benutzerdefinierten Feldern zugewiesen, die für einen geerbten Prozess definiert sind.

Datums- und Uhrzeitmuster

Das Datums- und Uhrzeitmuster, das Sie für DateTime-Felder eingeben, muss mit dem Muster übereinstimmen, das Sie über Ihr Profil auswählen. Informationen zum Anzeigen oder Ändern Ihrer Auswahl finden Sie unter Festlegen von Benutzereinstellungen.

Screenshot, der die Dropdown-Optionen für das Datumsmuster im Bereich Zeit und Gebietsschema zeigt.Screenshot, der die Dropdown-Optionen für Zeitmuster im Bereich Zeit und Region zeigt.

Screenshot, der den Bereich Zeit und Gebietsschema mit den Feldern Datumsmuster und Zeitmuster zeigt.

Abfrageoperatoren

Verwenden Sie die Abfrageoperatoren in der folgenden Tabelle, um anzugeben, welche Beziehung zwischen den einzelnen Werten in einer Klausel und dem entsprechenden Wert in einem Arbeitselement bestehen muss. Informationen zum Datentyp, der den Arbeitselementfeldern zugewiesen wurde, finden Sie unter Arbeitselement-Feldreferenz.

Weitere Informationen finden Sie unter Definieren einer Vorlage.

Abfrageoperator

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

=[Field]

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.

<>[Field]

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.

>[Field]

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

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

<[Field]

Ist kleiner als der Wert im angegebenen Feld.

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

>=[Field]

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

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

<=[Field]

Ist kleiner oder gleich dem Wert im angegebenen Feld.

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

Contains

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

String

Does Not Contain

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

String

Enthält Wörter

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 keine Wörter

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.

In

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

Is Empty

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

Is Not Empty

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

Not In

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

In Gruppe

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.

Hinweis

Der Operator In Group kann nur mit Feldern verwendet werden, die den Datentyp String oder das Feld Arbeitselementtyp verwenden. Sie können auch Gruppen verwenden, die in Microsoft Entra ID definiert sind, wenn Ihr Azure Boards-Konto von Microsoft Entra ID unterstützt wird, oder Active Directory, wenn Ihre lokale Serverinstanz von Active Directory unterstützt wird.

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

Nicht in Gruppe

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.

Hinweis

Der Operator Not In Group kann nur mit Feldern verwendet werden, die den Datentyp String oder das Feld Arbeitselementtyp verwenden. Sie können auch Gruppen verwenden, die in Microsoft Entra ID definiert sind, wenn Ihr Azure Boards-Konto von Microsoft Entra ID unterstützt wird, oder Active Directory, wenn Ihre lokale Serverinstanz von Active Directory unterstützt wird.

Nicht unter

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

TreePath

Under

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

TreePath

War schon einmal

Entspricht dem Wert in der Klausel an einem vorherigen Punkt.

String , DateTime

Hinweis

Was Ever (War schon einmal) wird bei Verwendung des Abfrage-Editors in Datumsfeldern derzeit nicht unterstützt. Sie werden nur bei direkter WIQL unterstützt.

Tipp

Es ist möglich, eine Abfrage mithilfe der WIQL-Syntax zu erstellen, die einen Operator verwendet, z . B. Was Ever, für andere Datentypfelder als die aufgeführten. Beispielsweise können Sie Was Ever in einer Klausel mithilfe des Iterationspfads verwenden. Ein Beispiel finden Sie unter Abfragen nach Datum oder aktueller Iteration, Auflisten von Arbeitselementen, die aus einem Sprint verschoben wurden.

Abfragemakros oder -variablen

Sie können die in der folgenden Tabelle beschriebenen Makros verwenden, um Ihre Abfragen nach bestimmten Feldern zu filtern.

Hinweis

Die folgenden Makros werden nur über das Webportal unterstützt: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity und @TeamAreas. Abfragen, die diese Makros enthalten, funktionieren nicht, wenn sie in Visual Studio/Team Explorer, Microsoft Excel oder Microsoft Project geöffnet werden.

Makro

Beschreibung

[Any]

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.

@CurrentIteration

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.

@CurrentIteration +/- n

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.

@Follows

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.

@Me

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.

@MyRecentActivity

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.

@Project

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.

@RecentMentions

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.

@RecentProjectActivity

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.

@StartOfDay

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&gt;=@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.

@StartOfMonth

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&gt;=@StartOfMonth-3-Klausel erstellt wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

@StartOfWeek

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&gt;=@StartOfWeek-2-Klausel geändert wurden. Weitere Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.

@StartOfYear

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&gt;=@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.

@TeamAreas

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.

@Today

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&gt;=@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.

Volltext- und partielle Wortsuchen

Geben Sie Contains oder Does Not Contain an, um nach genauen oder teilweisen Übereinstimmungen von Wörtern oder Ausdrücken zu suchen. Diese Vorgänge filtern Elemente auf Grundlage des Index für die Volltextsuche, der für lange Textfelder erstellt wurde. Geben Sie Contains Words oder Does Not Contain Wordsein, um für einen genauen Ausdruck zu suchen bzw. das Platzhalterzeichen * zu verwenden. Bei Verwendung dieser Operatoren wird der Index für die Volltextsuche verwendet. Sie können das Platzhalterzeichen nur am Ende eines partiellen Worts oder Ausdrucks verwenden.

Beispiele finden Sie unter Beispiele für Arbeitselementabfragen und Abfragen von Arbeitselementen mithilfe des Verlaufsfelds.

Hinweis

Nicht alle Bereitstellungen unterstützen Volltextsuchen. Die Volltextsuche wird beispielsweise von SQL Express und SQL Azure, die den Clouddienst unterstützen, nicht unterstützt. In solchen Instanzen finden Sie nur die Contains- und Does Not Contain-Operatoren.

Azure DevOps Server indiziert automatisch alle langen Textfelder mit dem Datentyp PlainText und HTML sowie dem Feld Title für die Volltextsuche. Der Index und die Operatoren sind nur verfügbar, wenn die SQL Server-Instanz, die Azure DevOps Server unterstützt, auch Volltextsuche unterstützt.

Volltextsuchen erfordern eine SQL-Sortierreihenfolge, die einer Sprache mit einer in SQL Server registrierten Worttrennung entspricht. Wenn die Sortiereinstellungen der Projektsammlung für Ihre Azure DevOps Server-Instanz keiner unterstützten Sprache entsprechen, werden die Suchergebnisse möglicherweise nicht mit Ihren Erwartungen übereinstimmen. Versuchen Sie in diesen Fällen, die Operatoren Contains oder Does Not Contain zu verwenden.

Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortiereinstellungen.

REST-API

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