Freigeben über


Verwenden eines Indexes zum Abfragen von Schnellverweisdaten in Azure Boards und Azure DevOps

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

Verwenden Sie diesen Index, um schnell auf Beispielabfragen und Informationen zum Öffnen, Definieren und Arbeiten mit Abfragen zuzugreifen. Informationen zur Verwendung des Abfrage-Editors finden Sie unter Definieren einer Abfrage. Wenn Sie feststellen, dass Ihre Abfragen zu lange dauern, um Ergebnisse zurückzugeben, lesen Sie Definieren einer Abfrage/Bewährte Methoden.

Beispielabfragen

Sie können Arbeitselemente basierend auf den folgenden Kriterien auflisten...


Schlüsselwörter, Platzhalterabfragen

Tagbasierte Abfragen

Status-, Ursachen- oder Workflowänderungsabfragen

Datums- und iterationsbasierte Abfragen

Auf Link- und Anlagenanzahl basierende Abfragen


Abfrageaufgaben



Operatoren und Makros, die für jeden Datentyp unterstützt werden

In der folgenden Tabelle werden die Operatoren und Makros aufgeführt, die für die verschiedenen Felddatentypen verfügbar sind. Jedem Feld ist ein Datentyp zugeordnet. Sie finden den Datentyp in den Beschreibungen der einzelnen Felder, die Sie mithilfe des Arbeitselement-Feldindexes nachschlagen können. Operatoren, die zum Definieren einer Abfrageklausel verfügbar sind, hängen vom ausgewählten Datentyp des Felds ab. Ausführlichere Beschreibungen von Datentypen, Operatoren und Makros finden Sie unter Abfragefelder, Operatoren und Makros.

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.

Datentyp

Beschreibung

Unterstützte Operatoren und Makros

Boolescher Wert

Unterstützt einen TRUE/FALSE-Wert. Abfragebeispiele: Abfragen nach Zuweisung oder Workflowänderungen.

= , <> , =[Field] , <>[Field]

DateTime

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 dem 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 oder @CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makros: @Today, gültig für beliebiges DateTime-Feld

Weitere Makros, die in Azure DevOps 2019 Update 1 und höheren Versionen unterstützt werden:
@StartOfDay, @StartOfWeek, @StartOfMonth und @StartOfYear, gültig mit einem beliebigen DateTime-Feld

Double

Auch als Dezimal bezeichnet und enthält picklistDouble1. Eine reelle Zahl, z. B. 0,2 oder 3,5.

Abfragebeispiele: Abfragen nach numerischen Feldern.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

Eine Zeichenfolge, die eine eindeutige ID darstellt.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

History

Benutzerdefiniertes formatiertes Feld, das zum Nachverfolgen von Verlaufsinformationen verwendet wird und nur dem Feld Verlauf zugewiesen ist.

Abfragebeispiele: Verlauf und Überwachung.

Contains Words, Does Not Contain Words

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. Abfragebeispiele: Abfragen nach Titeln, IDs und Rich-Text-Feldern.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Identität

Ein Zeichenfolgenfeld, das verwendet wird, um eine Benutzeridentität zu speichern. Abfragebeispiele: Abfragen nach Zuweisung oder Workflowänderungen.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMakros: @me, gültig für alle Identitätsfelder.

Integer

Enthält auch picklistInteger1. Eine 32-Bit-Ganzzahl mit Vorzeichen, z. B. 0, 1, 2 oder 34.

Abfragebeispiele: Abfragen nach numerischen Feldern

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Makros: @Follows, @MyRecentActivity, @RecentMentions und @RecentProjectActivity, gültig, wenn sie mit dem Feld ID verwendet werden.

PlainText

Mehrzeilige Textzeichenfolgen, die lange Beschreibungen unterstützen und automatisch für Volltextsuche indiziert werden, wenn Volltextsuche verfügbar ist.
Abfragebeispiele: Abfragen nach Titeln, IDs und Rich-Text-Feldern.

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

String

Enthält auch picklistString1. Eine kurze einzeilige Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann. Zeichenfolgenfelder unterstützen das Feld Titel, Auswahllisten (Dropdownmenüs), Benutzerkonten, Tags und andere Felder.

Abfragebeispiele: Abfrage nach Titeln, IDs und Rich-Text-Feldern und Abfrage nach Auswahllistenwert.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Makros: [Any], gültig mit dem Feld Arbeitselementtyp, @Project, gültig mit dem Feld Teamprojekt.

TreePath

Ein Feldtyp, der die Felder Bereichspfad und Iterationspfad unterstützt. Sie definieren die Struktur für ein Projekt: Bereichspfade und Iterationspfade.

Abfragebeispiele: Abfrage nach Bereich oder Iterationspfad und Abfrage nach Datum oder aktueller Iteration.

Under, Not Under, =, <>, In, Not In

Makros: @TeamAreas3, gültig mit dem Feld Bereichspfad
@CurrentIteration und @CurrentIteration+/- n4, gültig mit dem Feld Iterationspfad

Hinweis

  1. Die picklist-Datentypen werden nur benutzerdefinierten Feldern zugewiesen, die für einen geerbten Prozess definiert sind. Das geerbte Prozessmodell wird nur für Azure DevOps Server 2019 und höhere Versionen unterstützt.
  2. Die Operatoren Is Empty und Is Not Empty werden für Azure DevOps Server 2019 RC2 und höhere Versionen unterstützt.
  3. Das Makro @TeamAreas wird für Azure Boards und Azure DevOps Server 2019 und höhere Versionen unterstützt.
  4. Das Makro @CurrentIteration +/- n wird für Azure DevOps Server 2019 und höhere Versionen und nur bei der Ausführung über das Webportal unterstützt.

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.

Beispielabfragen für ausgewählte Felder

In der folgenden Tabelle werden allgemeine Abfragefelder und deren Datentyp aufgeführt, für die Beispielabfragen bereitgestellt werden. Informationen zum Bestimmen des Datentyps eines Felds finden Sie unter Arbeitselementfelder und -attribute, Auflisten von Feldattributen.

Ein

B

C

D–E–F

H-P

R

S

T

V-W