Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
In diesem Artikel werden Felddatentypen, Abfrageoperatoren und Abfragemakros beschrieben, die Sie im Abfrage-Editor verwenden. Einige Typen, Operatoren und Makros gelten nur für bestimmte Azure DevOps-Versionen.
Schnelle Beispiele und Editoraufgaben finden Sie unter "Abfrageschnellübersicht " und " Verwalten und Organisieren von Abfragen".
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | - Um gemeinsame Abfragen anzuzeigen und auszuführen: Projektmitglied. – Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff. |
| Berechtigungen | Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt. |
Hinweis
Benutzer mit Stakeholder--Zugriff für ein öffentliches Projekt haben Vollzugriff auf Abfragefunktionen, genau wie Benutzer mit Basic--Zugriff. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | - Um gemeinsame Abfragen anzuzeigen und auszuführen: Projektmitglied. – Hinzufügen und Speichern einer freigegebenen Abfrage: Mindestens Basic-Zugriff. |
| Berechtigungen | Beitragen Berechtigung festgelegt auf Zulassen für den Ordner, dem Sie eine Abfrage hinzufügen möchten. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt. |
Abfragefeld-Datentypen und -werte
Sie müssen einen Wert angeben, der dem Datentyp für ein Feld entspricht. In der folgenden Tabelle sind unterstützte Datentypen aufgeführt:
Hinweis
Bei Azure Boards (Cloud) entspricht der Datentyp dem Feld, das auf der Seite "Prozessfelder > " angezeigt wird. Bei lokalen Bereitstellungen entspricht der Datentyp dem type Attribut einer FIELD Definition. Details finden Sie unter Arbeitselementfelder und Feldattribute .
Datentyp
Beschreibung
Boolean
Speichert einen True/False-Wert.
DateTime oder Datum/Uhrzeit
Verwenden Sie eine Datumsvariable (z.B. @Today oder @Today-1) oder ein explizites Datum wie 01/01/2025. Geben Sie Datumsangaben im Muster ein, das in Ihrem Profil festgelegt ist. Beispiele für Abfragen finden Sie unter Query by date or @CurrentIteration.
Für WIQL-Abfragen können Sie auch Datumsangaben in UTC angeben. Siehe Syntax für die Arbeitsaufgabenabfragesprache (WIQL).
Doppelt oder Dezimal
Speichert eine reelle Zahl, z. B. 0,2 oder 3.5. Beispiele finden Sie unter "Abfrage nach numerischen Feldern ".
GUID
Speichert eine eindeutige Id-Zeichenfolge.
Verlauf
Benutzerdefiniertes formatiertes Feld, das für historische Informationen verwendet wird (das Feld "Verlauf "). Wenn die Volltextsuche verfügbar ist, wird dieses Feld für Volltextabfragen indiziert. Siehe Verlauf und Überwachung.
HTML
Speichert formatierten Text (z. B. Beschreibung oder Repro-Schritte). Wenn die Volltextsuche verfügbar ist, werden diese Felder indiziert. Informationen zum Abfragen von Rich-Text-Feldern finden Sie unter Abfragen nach Titeln, IDs und Rich-Text-Feldern.
Identität
Speichert eine kurze Textzeichenfolge, die eine Benutzeridentität identifiziert.
Integer
Speichert eine signierte 32-Bit-Ganzzahl (z. B. 0, 1, 2, 34).
PlainText oder Textfeld (mehrzeilig)
Speichert lange Textwerte (z. B. Anwendungsstartinformationen). Diese Felder indizieren für die Volltextsuche, wenn dies unterstützt wird. Siehe Abfrage nach Titeln, IDs und Rich-Text-Feldern.
picklistDouble
Benutzerdefiniertes Feld, das eine Auswahlliste mit Dezimalwerten enthält.
picklistInteger
Benutzerdefiniertes Feld, das eine Auswahlliste mit ganzzahligen Werten enthält.
picklistString
Benutzerdefiniertes Feld, das eine Auswahlliste mit kurzen Textwerten (255 Zeichen oder weniger) enthält.
Zeichenfolge oder Textfeld (einzeilig)
Speichert kurzen Text bis zu 255 Unicode-Zeichen. Teams verwenden diese Felder häufig für Auswahllisten oder Dropdownmenüs.
TreePath
Stellt einen Verzweigungsbaum dar (z. B. Bereichspfad oder Iterationspfad). Wählen Sie einen gültigen Knotenwert aus. Sie können nach Gleichheit, Ungleichheit, "Under" / "Nicht unter" filtern oder die In / Not In Operatoren verwenden, um mehrere Werte anzugeben. Definieren Sie Baumstrukturen für ein Projekt – Bereichspfade und Iterationspfade – und wählen Sie die Knoten aus, die Teams zugeordnet werden sollen.
Beispiele für Abfragen finden Sie unter Abfrage nach Bereich oder Iterationspfad und Abfrage nach Datum oder aktueller Iteration.
Hinweis
Die picklist... Typen gelten nur für benutzerdefinierte Felder, 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.
Abfrageoperatoren
Verwenden Sie Operatoren, um zu definieren, wie ein Klauselwert mit dem Feldwert einer Arbeitsaufgabe zusammenhängen muss. Informationen zu Felddatentypen finden Sie unter Feldreferenz für Arbeitselement. Hilfe zum Erstellen von Abfragen finden Sie unter Definieren einer Abfrage.
Abfrageoperator
Wenn der Operator übereinstimmende Arbeitsaufgaben zurückgibt
Anwendbare Datentypen
=
Entspricht dem Klauselwert.
Number (Double/Decimal/GUID/Integer), String, DateTime, TreePath
<>
Stimmt nicht mit dem Klauselwert überein.
Number, String, DateTime, TreePath
>
Ist größer als der Klauselwert.
Zahl, String, Datumszeit
<
Ist kleiner als der Klauselwert.
Zahl, String, Datumszeit
>=
Ist größer oder gleich dem Klauselwert.
Zahl, String, Datumszeit
<=
Ist kleiner oder gleich dem Klauselwert.
Zahl, String, Datumszeit
=[Field]
Entspricht dem Wert in einem anderen angegebenen Feld (muss derselbe Datentyp sein).
Name eines Felds desselben Datentyps (boolesche Felder vergleichen die Gleichheit mit anderen Feldern).
<>[Feld]
Stimmt nicht mit dem Wert in einem anderen angegebenen Feld überein.
Name eines Felds desselben Datentyps.
>[Feld]
Ist größer als der Wert in einem anderen angegebenen Feld.
Name eines Felds desselben Datentyps.
<[Feld]
Ist kleiner als der Wert in einem anderen angegebenen Feld.
Name eines Felds desselben Datentyps.
>=[Feld]
Ist größer oder gleich dem Wert in einem anderen angegebenen Feld.
Name eines Felds desselben Datentyps.
<=[Feld]
Ist kleiner oder gleich dem Wert in einem anderen angegebenen Feld.
Name eines Felds desselben Datentyps.
Enthält
Enthält eine genaue oder teilweise Textabgleichung.
String
Enthält nicht
Enthält keine exakte oder partielle Textabgleichung.
String
Enthält Wörter
Entspricht einem exakten Ausdruck oder Wort (unterstützt nachfolgende Wildcard *). Grenzwert: 100 Zeichen. Dieser Operator verwendet Volltextindizierung; Weitere Informationen zu Server- und Sortierungsanforderungen finden Sie im Abschnitt "Volltext" in diesem Artikel.
Lange Textfelder, die für die Volltextsuche indiziert sind (PlainText, HTML, History und Title).
Enthält keine Wörter
Schließt Elemente aus, die den angegebenen Ausdruck oder die angegebenen Wörter enthalten. Grenzwert: 100 Zeichen. Verwenden Sie Contains Words in Begleitsätzen, um Schlüsselwörter einzuschließen oder auszuschließen.
Textfelder, die für die Volltextsuche indiziert sind.
In
Entspricht einem beliebigen Wert in einem durch Trennzeichen getrennten Satz (verwenden Sie das regionale Listentrennzeichen des Betriebssystems, in der Regel ein Komma).
Number, String, DateTime, TreePath
Ist leer
Gleicht Elemente ab, bei denen ein HTML-Feld keinen Inhalt enthält (kein Wert angegeben). Unterstützt für Azure Boards und Azure DevOps Server.
HTML
Ist nicht leer
Gleicht Elemente ab, bei denen ein HTML-Feld Inhalt enthält. Unterstützt für Azure Boards und Azure DevOps Server.
HTML
Nicht in
Schließt Werte in einem durch Trennzeichen getrennten Satz aus (verwenden Sie das regionale Listentrennzeichen). Unterstützt für Azure Boards und Azure DevOps Server.
Number, String, DateTime, TreePath
In Gruppe
Gleicht Werte ab, die Mitglieder einer benannten Gruppe sind (Team, Sicherheitsgruppe oder Kategorie). Verwenden Sie z. B. die Gruppe "Mitwirkende" oder eine Teamgruppe, die im Muster [Project Name]\Team Namebenannt ist. Beispiele finden Sie unter "Abfrage nach Zuweisung" oder "Workflowänderungen" .
Zeichenfolge (entspricht Gruppen- oder Teamnamen) oder Arbeitselementtyp
Hinweis
Verwenden Sie „In Gruppe“ nur für Felder des Typs „String“ oder des Typs „Arbeitselement“. Sie können Microsoft Entra-ID-Gruppen verwenden, wenn Ihr Konto Microsoft Entra-ID oder Active Directory-Gruppen für lokale Geräte verwendet. :::column-end:::
Nicht in Gruppe
Schließt Mitglieder einer benannten Gruppe aus.
Zeichenfolge, die einer Benutzergruppe oder Projektkategorie entspricht.
Nicht unter
Schließt Elemente aus, die gleich dem angegebenen Strukturknoten sind oder sich unter diesem befinden.
TreePath
Under
Vergleicht Elemente, die dem angegebenen Baumknoten entsprechen oder darin enthalten sind.
TreePath
War ever
Entspricht einem Wert, den ein Feld zu einem beliebigen zeitpunkt gehalten hat.
String, DateTime
Hinweis
Der Abfrage-Editor unterstützt derzeit Was Ever bei Datumsfeldern nicht; verwenden Sie in diesen Fällen direkt WIQL.
:::column-end:::
Tipp
Sie können WIQL-Abfragen erstellen, die Operatoren (z. B. Was Ever) für unterschiedliche Datentypen wie den Iterationspfad anwenden. Ein Beispiel finden Sie unter Arbeitsaufgaben, die aus einem Sprint verschoben wurden, auflisten.
Abfragemakros und Variablen
Verwenden Sie die folgenden Makros, um Abfragen dynamisch 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]
Wird mit Arbeitselementtyp oder Zustand verwendet, um über alle Typen oder Zustände zu suchen. Entfernt beispielsweise die typbasierte Filterung Work Item Type=[Any].
@CurrentIteration
Wird mit Iterationspfad verwendet, um basierend auf dem aktuellen Teamkontext nach Arbeitsaufgaben im aktuellen Sprint zu filtern. Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration . @CurrentIteration funktioniert nur, wenn es über das Webportal ausgeführt wird (nicht in REST-APIs oder bei Kopier-/Klonvorgängen).
@CurrentIteration +/- n
Wird mit Iterationspfad verwendet, um Sprints relativ zur aktuellen Iteration einzuschließen (z. B. @CurrentIteration-1 oder @CurrentIteration+2). Unterstützt im Webportal für Azure Boards und Azure DevOps Server.
@Follows
Wird mit der ID und dem In Operator verwendet, um die Arbeitsaufgaben aufzulisten, die Sie im Projekt verfolgen. Siehe Folgen eines Arbeitselements oder Pull-Requests. Dieses Makro funktioniert nur über das Webportal.
@Me
Wird mit Identitätsfeldern verwendet, um nach Elementen Created By=@Me zu filtern, die mit Ihrem Konto verknüpft sind (z. B.). Siehe Abfrage zu Zuordnungen, Workflows oder Änderungen am Board.
@MyRecentActivity
Verwenden Sie ID und In zum Auflisten von Work Items, die Sie in den letzten ungefähr 30 Tagen aktualisiert oder angezeigt haben. Auf der Arbeitselemente-Seite sehen Sie im Pivot "Meine Aktivität" dieselbe Liste.
@Project
Mit Teamprojekt können Sie nach Arbeitsaufgaben im aktuellen Projekt filtern (z. B Team Project=@Project. ). Siehe Abfrage über Projekte hinweg.
@RecentMentions
Verwenden Sie die ID und In zum Auflisten von Arbeitseinträgen, in denen Sie in Diskussionen erwähnt werden. Auf der Seite "Arbeitsaufgaben" sehen Sie den Pivot "Erwähnt".
@RecentProjectActivity
Wird mit ID und In verwendet, um kürzlich aktualisierte Arbeitsaufgaben im gesamten Projekt aufzulisten. Das Makro gibt bis zu 5.000 Elemente zurück. das tatsächliche Fenster hängt von der Projektaktivität ab.
@StartOfDay
Wird mit DateTime-Feldern verwendet, um relativ zu heute zu filtern (z. B Closed Date>=@StartOfDay-7. ).
@StartOfMonth
Wird mit DateTime-Feldern verwendet, um relativ zum Anfang des Monats zu filtern (z. B Created Date>=@StartOfMonth-3. ).
@StartOfWeek
Wird mit DateTime-Feldern verwendet, um relativ zum Anfang der Woche zu filtern (z. B Changed Date>=@StartOfWeek-2. ).
@StartOfYear
Wird mit DateTime-Feldern verwendet, um relativ zum Anfang des Jahres zu filtern (z. B Target Date>=@StartOfYear. ).
@TeamAreas
Verwenden Sie den Bereichspfad nur mit dem =-Operator, um Elemente zu finden, die den Bereichspfaden eines Teams zugewiesen sind (z. B. Area Path=@TeamAreas [Fabrikam Fiber]\Web). Unterstützt im Webportal für Azure DevOps Server.
@Today
Wird mit DateTime-Feldern verwendet, um relativ zu heute zu filtern (z. B Created Date>=@Today-7. ). Siehe Abfrage nach Datum oder aktueller Iteration.
Volltext- und Teilwortsuchen
Verwenden Sie Contains oder Does Not Contain, um genaue oder teilweise Übereinstimmungen in Langtextfeldern zu suchen (diese Operatoren verwenden den Abfrageindex). Verwenden Sie Contains Words oder Does Not Contain Words, um nach genauen Phrasen zu suchen oder einen folgenden Platzhalter (*) zu verwenden; diese Operatoren erfordern den Volltextindex.
Sie können das Platzhalterzeichen nur am Ende eines Teilwortes oder Ausdrucks verwenden. Beispiele finden Sie unter Beispiele für Arbeitselementabfragen und Abfragen von Arbeitselementen mithilfe des Verlaufsfelds.
Hinweis
Nicht alle Bereitstellungen unterstützen die Volltextsuche. Beispielsweise unterstützen SQL Express und einige Cloud-SQL-Konfigurationen keine Volltextsuche. In diesen Bereitstellungen sind nur die Operatoren „Contains“ und „Does Not Contain“ sichtbar.
Azure DevOps Server indiziert Langtextfelder (PlainText und HTML) und das Titelfeld für die Volltextsuche, wenn der zugrunde liegende SQL Server die Volltextindizierung unterstützt.
Die Volltextsuche erfordert auch eine SQL-Sortierung mit einem registrierten Worttrennzeichen für die verwendete Sprache. Wenn die Sortierung der Sammlungsdatenbank nicht mit einer unterstützten Sprache übereinstimmt, entsprechen die Ergebnisse möglicherweise nicht den Erwartungen. In diesen Fällen sollten Sie Contains oder Does Not Contain stattdessen verwenden.
Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortiereinstellungen.
Verwandte Inhalte
- Verwenden der Schnellreferenz für die Abfrage
- Informationen zu verwalteten Abfragen
- Zugreifen auf den Arbeitsauftragfeldindex
- Verstehen der WIQL-Syntax
REST-API
Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in den folgenden REST-API-Ressourcen: