Abfragen von Feldern, Operatoren und Makros in Azure Boards und Azure DevOps


Makro

Beschreibung


[Any]

Verwenden Sie mit den Feldern Arbeitselementtyp oder Status , um alle Arbeitselementtypen oder Zustände zu durchsuchen. Beispielsweise werden Work Item Type=[Any] von keine Filter basierend auf dem Arbeitselementtyp angewendet.


@CurrentIteration

Verwenden Sie mit dem Feld Iterationspfad , um automatisch nach Arbeitselementen zu filtern, die dem aktuellen Sprint basierend auf dem aktuellen Teamfokus oder Kontext zugewiesen sind. Spezifische Beispiele finden Sie unter Abfragen nach Datum oder aktueller Iteration.
Das @CurrentIteration-Makro wird für Azure Boards und TFS 2015 und höher unterstützt. Dieses Makro funktioniert nur, wenn es über das Webportal ausgeführt wird. Sie können das Makro nicht verwenden, wenn Sie Testsammlungen und Testfälle kopieren oder klonen, Warnungen definierenoder mit REST-APIs verwenden.


@CurrentIteration +/- n

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


@Follows

Verwenden Sie mit dem Feld ID und dem Operator In , um alle Arbeitselemente auflisten zu können, denen Sie im Projekt folgen. Weitere Informationen zum Follow-Feature finden Sie unter Folgen eines Arbeitselements oder Pull Requests. Sie können diese Liste auf der Seite Arbeitselemente unter Folgende Pivotansicht anzeigen.
Das @Follows-Makro wird für Azure Boards und TFS 2017 und höher unterstützt und nur bei Ausführung über das Webportal.


@Me

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


@MyRecentActivity1

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente auflisten zu können, die Sie innerhalb der letzten 30 Tage im Projekt angezeigt oder aktualisiert haben. Sie können diese Liste auf der Seite Arbeitselemente unter Meine Aktivitätspivotansicht anzeigen.


@Project

Verwenden Sie mit dem Feld Team Project, um nach Arbeitselementen in anderen Projekten zu filtern. Beispielsweise können Sie alle Arbeitselemente im aktuell ausgewählten Projekt mit der -Klausel Team Project=@Project suchen.
Das @Project-Makro wird für Azure Boards und TFS 2015.1 und höher unterstützt. Das System filtert standardmäßig basierend auf dem aktuellen Projekt. Weitere Informationen finden Sie unter Definieren einer Abfrage, Projektübergreifende Abfrage.


@RecentMentions1

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente auflisten zu können, in denen Sie im Abschnitt Diskussion erwähnt wurden. Sie können diese Liste auf der Seite Arbeitselemente unter Mentioned pivot view (Erwähnte Pivotansicht) anzeigen.


@RecentProjectActivity

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente auflisten zu können, die innerhalb der letzten 30 Tage im Projekt aktualisiert wurden. Sie können ähnliche Listen auf der Seite Arbeitselemente, Zuletzt erstellt, Zuletzt aktualisiert und Zuletzt abgeschlossen Pivotansichten anzeigen.
Das @RecentProjectActivity-Makro wird für Azure Boards (Clouddienst) nur zu diesem Zeitpunkt unterstützt.


@StartOfDay2

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


@StartOfMonth2

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


@StartOfWeek2

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


@StartOfYear2

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


@TeamAreas

Verwenden Sie nur mit dem Feld Bereichspfad, um nach Arbeitselementen zu filtern, deren Bereichspfad einem bestimmten Team zugewiesen ist. Erfordert, dass Sie den = -Operator verwenden. Beispielsweise können Sie alle Elemente finden, die den Bereichspfaden zugewiesen sind, die dem Webteam mit der -Klausel zugewiesen Area Path=@TeamAreas [Fabrikam Fiber]\Web sind. Weitere Beispiele finden Sie unter Abfragen nach Bereich oder Iterationspfad.
Das @TeamAreas-Makro wird für Azure DevOps Server 2019 und höher unterstützt und nur, wenn es über das Webportal ausgeführt wird.


@Today

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


Hinweis

  1. Die makros @MyRecentActivity, @RecentMentionsund @RecentProjectActivity werden für Azure Boards und TFS 2018.2 und höher unterstützt.
  2. Die makros @StartOfDay, @StartOfWeek, @StartOfMonthund @StartOfYear werden für Azure DevOps Server 2019 Update 1 und höher unterstützt.

Volltext- und partielle Wortsuchen

Geben Sie Contains oder Does Not Contain an, um nach genauen oder partiellen Übereinstimmungen eines Worts oder Ausdrucks zu suchen. Diese Operatoren filtern Elemente basierend auf dem Volltextsuchindex, der für Langtextfelder erstellt wurde. Geben Sie Contains Words oder Does Not Contain Words an, um nach einem genauen Ausdruck zu suchen oder 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 Beispielabfragen für Arbeitselemente und Abfragen nach Arbeitselementen mithilfe des Felds Verlauf.

Hinweis

Nicht alle Bereitstellungen unterstützen Volltextsuchen. Beispielsweise unterstützen SQL Express und SQL Azure, die den Clouddienst unterstützen, keine Volltextsuche. In diesen Instanzen werden nur die Operatoren Contains und Does not Contain (Enthält nicht) verwendet.

Azure DevOps Server und Team Foundation Server automatisch alle Langtextfelder mit dem Datentyp PlainText und HTML und dem Feld Title für die Volltextsuche indizieren. Der Index und die Operatoren sind nur verfügbar, wenn die SQL Server, die Team Foundation Server unterstützt, die Volltextsuche unterstützt.

Volltextsuchen erfordern eine SQL, die einer Sprache entspricht, in der eine Wörter wörterbrechend registriert SQL Server. Wenn die Sortierungseinstellungen für die Projektsammlungsdatenbank, die für Ihre Team Foundation Server-Instanz verwendet wird, nicht einer unterstützten Sprache entsprechen, stimmen Ihre Suchergebnisse möglicherweise nicht ihren Erwartungen überein. In diesen Fällen können Sie versuchen, die Operatoren Contains oder Does Not Contain zu verwenden.

Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortierungsabfragen Einstellungen.

REST-API

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

SDK-Ressourcen

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie unter Abfragen nach Fehlern, Aufgaben und anderen Arbeitselementen.

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

Hier finden Sie ausführliche Beschreibungen der einzelnen Felddatentypen, Abfrageoperatoren und Abfragemakros. Einige Datentypen, Operatoren und Makros sind nur für die angegebene TFS-Version (Azure DevOps Server oder Team Foundation Server) gültig.

Eine kurzübersicht über Abfragetasks und -operatoren und -makros, die für jeden Datentyp unterstützt werden, finden Sie unter Kurzübersicht über Abfragen. Tipps zum Erstellen leistungsstarker Abfragen finden Sie auch unter Anleitung zum Erstellen leistungsstarker Abfragen.

Abfragen von Felddatentypen und -werten

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 Azure Boards Clouddienst entspricht der Datentyp dem Datentyp, der für das Feld auf der Seite Prozessfelderaufgeführt ist. Bei lokalen Bereitstellungen entspricht der Datentyp dem Attribut, das type einer typezugewiesen ist. Weitere Informationen finden Sie unter Arbeitselementfelder und Feldattribute.

Datentyp

Beschreibung

Boolescher Wert1

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. 1.1.2012. Geben Sie Datumsangaben in das Datumsmuster ein, das Sie für Ihr persönliches Profil festgelegt haben. (Weitere Informationen finden Sie unter Festlegen persönlicher Einstellungen.) Abfragebeispiele finden Sie unter Abfragen nach Datum or@CurrentIteration.

Für WIQL-Abfragen können Sie auch das Datum im koordinierte Weltzeit muster (UTC) angeben. Weitere Informationen finden Sie unter Syntax für die 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 zur Unterstützung des Felds Verlauf verwendet. Dieses Feld wird automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Volltext- und Teilwortsuchen. Abfragebeispiele finden Sie unter Verlauf und Überwachung.

HTML

Textzeichenfolgen, die formatierte Beschreibungen unterstützen, z. B. die Felder Beschreibung oder Reproduktionsschritte. Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Volltext- und Teilwortsuchen. 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 (mehrzeiliges Feld)

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

picklistDouble2

Benutzerdefiniertes Feld, das eine Auswahlliste von Dezimalwerten enthalten soll.

picklistInteger2

Benutzerdefiniertes Feld, das definiert ist, um eine Auswahlliste ganzzahliger Werte zu enthalten.

picklistString2

Benutzerdefiniertes Feld, das eine Auswahlliste kurzer Textzeichenfolgenwerte (maximal 255 Zeichen) enthält.

Zeichenfolge oder Textfeld (einzelne Zeile)

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 Arbeitselemente, die gleich, ungleich, unter oder nicht unter einer Struktur sind, oder verwenden Sie die Operatoren In oder Not In, um mehrere Werte anzugeben. Sie definieren die Struktur für ein Projekt –Bereichspfade und Iterationspfade– und wählen dann diejenigen aus, die Sie einem Team zuordnen möchten.

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

Hinweis

  1. Das boolesche Datentypfeld wird für TFS 2017 und höhere Versionen unterstützt.
  2. Die Datentypen picklist... werden nur benutzerdefinierten Feldern zugewiesen, die für einen geerbten Prozess definiert sind. Das geerbte Prozessmodell wird nur für Azure DevOps Services und Azure DevOps Server 2019 unterstützt.

Abfrageoperatoren

Sie können die Abfrageoperatoren in der folgenden Tabelle verwenden, um anzugeben, welche Beziehung zwischen den einzelnen Werten in einer Klausel und dem entsprechenden Wert in einem Arbeitselement bestehen muss. Informationen zum Datentyp, der Arbeitselementfeldern zugewiesen ist, finden Sie unter Arbeitselementfeldreferenz.

Informationen zum Hinzufügen von Klauseln und zur Verwendung der And/Or-Operatoren finden Sie unter Definieren einer Abfrage und/oder eines logischen Ausdrucks.

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,Integerund String,DateTimeund TreePath

<>

Entspricht nicht dem Wert in der -Klausel.

Number,String,DateTimeund TreePath

>

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

Number,Stringund DateTime

<

Ist kleiner als der Wert in der Klausel.

Number,Stringund DateTime

=

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

Number,Stringund DateTime

=

Ist kleiner als oder gleich dem Wert in der Klausel.

Number,Stringund DateTime

=[Feld]

Entspricht dem Wert im angegebenen Feld.

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

[Feld]

Entspricht nicht dem Wert, der im angegebenen Feld enthalten ist.

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

[Feld]

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

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

[Feld]

Ist kleiner als der Wert im angegebenen Feld.

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

=[Feld]

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

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

=[Feld]

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

Enthält nicht

Enthält keine genaue oder teilweise Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie für die Filterung 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 Textzeichenfolge ist auf 100 Zeichen beschränkt. Einschränkungen finden Sie unter Volltextsuchen nach Server- und Sortierungsanforderungen.

Langtextfelder, die für die Volltextsuche indiziert sind, die allen PlainText- und HTML-Feldern entsprechen, sowie die Felder Verlauf und Titel.

Enthält keine Wörter

Enthält nicht die genaue Textzeichenfolge oder die Wörter innerhalb des Felds, das Sie für die Filterung ausgewählt haben. Die Textzeichenfolge ist auf 100 Zeichen beschränkt.

Verwenden Sie diesen Operator in Kombination mit einer -Klausel mit dem Contains Words-Operator, um bestimmte Schlüsselwörter einzuschließen 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

Ist leer

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

HTML

Ist nicht leer

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

HTML

Not In

Entspricht keinem Wert in einem durch Trennzeichen getrennten Satz. Sie können Arbeitselemente, deren Status nicht Aufgelöst, Abgeschlossen oder Geschlossen ist, aus Abfrageergebnissen ausschließen, wenn Sie diese Werte für das Feld Status 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 Not In-Operator ist ab Azure Boards und TFS 2018.2 verfügbar.

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 der Teamgruppen folgt dem Muster [Team Project Name]\Teamname.

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

Zeichenfolge, die dem Namen eines Teams, einer Sicherheitsgruppe oder einer Kategorie entspricht, die im System definiert ist.

Hinweis

Sie können den In Group-Operator nur mit Feldern verwenden, die den String-Datentyp oder das Feld Arbeitselementtyp verwenden. Sie können auch Gruppen verwenden, die in Azure Active Directory (AAD) definiert sind, wenn Ihr Azure Boards-Konto durch AAD gesichert wird, oder Active Directory (AD), wenn Ihre lokale Serverinstanz von Active Directory unterstützt wird.

Informationen zu Kategoriegruppen finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitselementtypen.

Nicht in Gruppe

Entspricht keinem Wert, der Mitglied der Gruppe in der -Klausel ist.

Zeichenfolge, die mit dem Namen einer Benutzergruppe in Team Foundation Server oder einer für ein Projekt definierten Kategoriegruppe übereinstimmt.

Hinweis

Sie können den Operator Nicht in Gruppe nur mit Feldern verwenden, die den String-Datentyp oder das Feld Arbeitselementtyp verwenden. Sie können auch in AAD definierte Gruppen verwenden, wenn Ihr Azure Boards-Konto durch AAD gesichert wird, oder AD, wenn Ihre lokale Serverinstanz von AD unterstützt wird.

Nicht unter

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

TreePath

Unter

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

Tipp

Es ist möglich, eine Abfrage mithilfe der WIQL-Syntax zu kontruieren, die einen Operator wie Was Everfür andere Datentypfelder als die aufgeführten verwendet. Beispielsweise können Sie Was immer in einer -Klausel verwenden, indem Sie den Iterationspfad verwenden. Ein Beispiel finden Sie unter Abfragen nach Datum oder aktueller Iteration, Auflisten von Arbeitselementen, die aus einem Sprint verschoben wurden.

Abfragen von Makros oder Variablen

Sie können die in der folgenden Tabelle beschriebenen Makros verwenden, um Ihre Abfragen anhand bestimmter Felder zu filtern.

Hinweis

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