Felder, Operatoren, Werte und Variablen für Abfragen

Sie können Listen von Arbeitsaufgaben suchen und erstellen, indem Sie Arbeitsaufgabenabfragen erstellen. Indem Sie eine oder mehrere Klauseln definieren können Sie aus allen Arbeitsaufgaben innerhalb eines Teamprojekts oder einer Teamprojektsammlung den für Sie interessanten Satz von Arbeitsaufgaben filtern und zurückgeben. Für jede Klausel können Sie ein Feld, einen Operator und einen Wert oder eine Variable angeben. Beispielsweise können Sie in einem bestimmten Teamprojekt nach allen Arbeitsaufgaben suchen, indem Sie das Feld Teamprojekt, den Gleichheitsoperator (=) und den Namen des Teamprojekts als Wert angeben. Anstelle eines Werts können Sie eine Variable wie @Project angeben, die das aktuelle Teamprojekt darstellt.

Beispielabfrageklausel

Und/Oder	Feld	Operator	Wert
And	Teamprojekt	=	@Project

Weitere allgemeine Informationen zu Abfragen finden Sie unter Abfragen von Arbeitsaufgaben. Informationen zur Navigation im Abfrage-Editor und in der Abfrageansicht mit Tastenkombinationen finden Sie unter Tastenkombinationen für die Arbeit in Team Web Access und Team Explorer.

In diesem Thema

• Und/Oder

• Abfragefelder und -werte

• Abfrageoperatoren

• Abfragevariablen

• Volltext- und partielle Wortsuchen

• Abfrage indizierter Felder

Prüfliste für das Definieren einer Abfrageklausel:

1. Wählen Sie in der ersten leeren Zeile unter der Spaltenüberschrift Feld auf den Pfeil nach unten aus, um die Liste der verfügbaren Felder anzuzeigen, und wählen Sie anschließend ein Element in der Liste aus.

   Weitere Informationen finden Sie unter Abfragefelder und -werte.

2. Wählen Sie in der gleichen Zeile unter der Spaltenüberschrift Operator den Pfeil nach unten aus, um die Liste der verfügbaren Operatoren anzuzeigen, und wählen Sie anschließend ein Element in der Liste aus.

   Weitere Informationen finden Sie unter Operatoren.

3. Geben Sie in der gleichen Zeile unter der Spaltenüberschrift Wert einen Wert an, oder wählen Sie den Pfeil nach unten und dann ein Element in der Liste aus.

4. Weitere Informationen zum Angeben des aktuellen Teamprojekts, Benutzers oder Datums mit Variablen finden Sie unter Variablen.

5. Um eine Klausel hinzuzufügen, wählen Sie Neue Klausel hinzufügen oder Klicken Sie hier, um eine neue Klausel hinzuzufügen aus.

   Sie können eine Klausel an das Ende der Abfrage anfügen, eine Klausel nach einer vorhandenen Klausel hinzufügen () und Klauseln nach Bedarf entfernen (), gruppieren () und die Gruppierung von Klauseln aufheben ().

Und/Oder

Sie geben Und oder Oder an, um logische Ausdrücke der Abfrageklauseln zu erstellen. Geben Sie Und an, wenn Sie nach Arbeitsaufgaben suchen möchten, die die Kriterien in dieser Klausel und in der vorherigen Klausel erfüllen. Geben Sie Oder an, wenn Sie nach Arbeitsaufgaben suchen möchten, die die Kriterien in dieser oder der vorherigen Klausel erfüllen.

Sie können eine neue Klausel für jedes Arbeitsaufgabenfeld hinzufügen, um die Suchkriterien zu präzisieren und nur den gewünschten Satz von Arbeitsaufgaben zurückzugeben. Wenn eine Abfrage nicht die erwarteten Ergebnisse liefert, können Sie Abfrageklauseln hinzufügen, entfernen, gruppieren oder ihre Gruppierung aufheben, um die Abfrageergebnisse zu optimieren.

Abfrageklauseln können gruppiert werden, sodass sie vom Rest der Abfrage getrennt als einzelne Einheit ausgeführt werden. Dies ist mit den Klammern um einen Ausdruck in einer mathematischen Gleichung oder einer Logikaussage vergleichbar. Wenn Sie Klauseln gruppieren, wird das UND oder ODER für die erste Klausel der Gruppe auf die gesamte Gruppe angewendet.

Wie das folgende Beispiel zeigt, werden die gruppierten Klauseln in den entsprechenden logischen Ausdruck übersetzt. Der erste Ausdruck gibt Arbeitsaufgaben mit Priorität 1 und alle aktiven Fehler mit beliebiger Priorität zurück. Der zweite Ausdruck gibt alle aktiven Priorität 1-Arbeitsaufgaben und alle aktiven und nicht aktiven Priorität 1-Fehler zurück.

Gruppierte Klauseln	Logischer Ausdruck.
	Priorität=1 ODER (Arbeitsaufgabentyp=Fehler UND Status=Aktiv)
	Priorität=1 UND (Arbeitsaufgabentyp=Fehler ODER Status=Aktiv)

Weitere Informationen finden Sie unter Angeben von Abfragefilterkriterien [umgeleitet].

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

Datentyp	Gespeicherte Daten
DateTime	Ein bestimmter Zeitpunkt der koordinierten Weltzeit (Coordinated Universal Time, UTC). Sie können eine Variable wie @Today oder @Today-1 angeben, oder Sie können einen Wert wie 1/1/2012 angeben.
Double	Eine reelle Zahl, z. B. 0,2 oder 3,5.
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. Siehe Volltext- und partielle Wortsuchen weiter unten in diesem Thema.
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. Siehe Volltext- und partielle Wortsuchen weiter unten in diesem Thema. Hinweis Wenn Sie Team Foundation Server aktualisieren wird das Feld Beschreibung von einem PlainText-Feldtyp zu HTML geändert.Mithilfe des Befehls witadmin changefield können Sie den Datentyp für dieses Feld bei Bedarf wiederherstellen.Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin].
Integer	Eine 32-Bit-Ganzzahl mit Vorzeichen, z. B. 0, 1, 2 oder 34.
PlainText	Textzeichenfolgen, die lange Beschreibungen unterstützen, wie das Feld Informationen zum Starten der Anwendung. Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Siehe Volltext- und partielle Wortsuchen weiter unten in diesem Thema.
String	Eine kurze Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann.
TreePath	Eine Verzweigungsstruktur, z. B. ein Bereichspfad oder ein Iterationspfad. Sie müssen in einer Liste gültiger Werte ein Element auswählen. Sie können nach Arbeitsaufgaben suchen, die einer Struktur entsprechen oder darin enthalten sind. Weitere Informationen finden Sie unter Hinzufügen und Ändern von Bereichs- und Iterationspfaden.

Zurück nach oben

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 einer Arbeitsaufgabe bestehen muss. Informationen zum Datentyp, der den Arbeitsaufgabenfeldern zugewiesen wurde, finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM.

Abfrageoperator	Gibt Arbeitsaufgaben zurück, wenn der Wert in der Arbeitsaufgabe den angegebenen Kriterien entspricht.	Anwendbare Datentypen
=	Entspricht dem Wert in der Klausel.	Zahl mit Double, GUID, Integer, String, DateTime und TreePath.
<>	Entspricht nicht dem Wert in der Klausel.	Zahl, String, DateTime und TreePath
>	Ist größer als der Wert in der Klausel.	Zahl String und DateTime
<	Ist kleiner als der Wert in der Klausel.	Zahl String und DateTime
>=	Ist größer als oder gleich dem Wert in der Klausel.	Zahl String und DateTime
<=	Ist kleiner als oder gleich dem Wert in der Klausel.	Zahl String und DateTime
=[Feld]	Entspricht dem Wert im angegebenen Feld.	Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.
<>[Feld]	Entspricht nicht dem Wert im angegebenen Feld.	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.
Enthält	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 exakte oder teilweise Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie für das 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. Informationen über 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 Titel entspricht.
Enthält keine Wörter	Enthält nicht die genaue Textzeichenfolge oder Wörter innerhalb des Felds, das Sie für das Filtern ausgewählt haben.	Textfelder, die für die Volltextsuche indiziert sind.
In	Entspricht einem beliebigen Wert in einer durch Trennzeichen getrennten Liste. Beispielsweise können Sie nach Arbeitsaufgaben mit der ID 100, 101 und 102 suchen, indem Sie die entsprechenden Werte im Feld für die ID eingeben. Wichtig 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.	Zahl, String, DateTime, TreePath
In Gruppe	Entspricht einem Wert, der ein Member der Gruppe in der Klausel ist. Gruppen korrespondierten mit dem Namen einer Kategorie oder einer TFS-Gruppe. Beispielsweise können Sie eine Abfrage erstellen, um alle Arbeitsaufgaben 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. Als Wert kann eine Sicherheits- oder E-Mail-Verteilergruppe eingegeben werden. Bearbeitete Beispiele finden Sie unter Beispielabfragen.	String die mit dem Namen einer Benutzergruppe oder einer Kategoriegruppe in Team Foundation Server übereinstimmt. Hinweis Der Operator In Gruppe kann nur mit Feldern verwendet werden, die den Datentyp String oder das Feld Arbeitsaufgabentyp verwenden. Informationen zu Kategoriegruppen finden Sie unter Verwenden von Kategorien für Arbeitsaufgabentypen.
Nicht in Gruppe	Entspricht keinem Wert, der ein Member der Gruppe in der Klausel ist.	String, die mit dem Namen einer Benutzergruppe in Team Foundation Server oder der Kategoriegruppe übereinstimmt, die für ein Teamprojekt definiert wird. Hinweis Der Operator Nicht in Gruppe kann nur mit Feldern verwendet werden, die den Datentyp String oder das Feld Arbeitsaufgabentyp verwenden. Informationen zu Kategoriegruppen finden Sie unter Verwenden von Kategorien für Arbeitsaufgabentypen.
War schon einmal	Entspricht dem Wert in der Klausel an einem vorherigen Punkt.	String, DateTime
Unter	Entspricht dem Wert in der Klausel oder ist unter dem Knoten in der Klausel enthalten.	TreePath
Nicht unter	Entspricht nicht dem Wert in der Klausel und ist nicht unter dem Knoten in der Klausel enthalten.	TreePath

Zurück nach oben

Abfragevariablen

Sie können die Variablen in der folgenden Tabelle verwenden, um nach Arbeitsaufgaben zu suchen, die sich auf den aktuellen Benutzer, das aktuelle Projekt oder das aktuelle Datum beziehen.

Abfragevariable	Verwendung
@Me	Verwenden Sie diese Variable, um in einem Feld mit Benutzeraliasen automatisch nach dem Alias des aktuellen Benutzers zu suchen. Sie können also beispielsweise nach von Ihnen geöffneten Arbeitsaufgaben suchen, indem Sie die Spalte Feld auf Aktiviert von, die Spalte Operator auf = und die Spalte Wert auf @Me festlegen.
@Project	Verwenden Sie diese Variable, um im aktuellen Teamprojekt nach Arbeitsaufgaben zu suchen. Sie können z. B. nach allen Arbeitsaufgaben im aktuellen Teamprojekt suchen, indem Sie die Spalte Feld auf Teamprojekt, die Spalte Operator auf = und die Spalte Wert auf @Project festlegen.
@Today	Verwenden Sie diese Variable, um nach Arbeitsaufgaben zu suchen, die sich auf das aktuelle Datum oder auf einen früheren Termin beziehen. Sie können die Variable @Today auch durch das Subtrahieren von Tagen ändern. Sie können beispielsweise alle Elemente suchen, die in der letzten Woche aktiviert wurden. Dazu legen Sie die Spalte Feld auf Aktivierungsdatum, die Spalte Operator auf >= und die Spalte Wert auf @Today - 7 fest.
[Any]	Verwenden Sie diese Variable, um nach Arbeitsaufgaben zu suchen, die sich auf einen Wert beziehen, der für ein bestimmtes Feld definiert wurde.

Zurück nach oben

Volltext- und partielle Wortsuchen

Geben Sie Enthält oder Enthält nicht an, um nach genauen oder teilweisen Übereinstimmungen von Worten oder Ausdrücken zu suchen. Geben Sie Enthält Wörter oder Enthält keine Wörter, 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 zu diesem Thema finden Sie unter Beispiele für Arbeitsaufgabenabfragen und Abfragen von Arbeitsaufgaben mithilfe des Felds "Versionsgeschichte".

Hinweis

Nicht alle Bereitstellungen unterstützen Volltextsuchen.Die Volltextsuche wird beispielsweise von SQL Express und SQL Azure, die Visual Studio Online unterstützen, nicht unterstützt.In solchen Instanzen finden Sie nur die Enthält und Enthält nicht-Operatoren.

Enthält Wörter- und Enthält keine Wörter-Filterelemente auf Grundlage des Index für die Volltextsuche, die für LONG-Textfelder erstellt wurden. Alle Felder mit langem Text und dem Datentyp PlainText und HTML sowie das Feld Titel werden von Team Foundation automatisch für die Volltextsuche indiziert. Der Index und die Operatoren sind nur verfügbar, wenn der SQL Server, der Team Foundation Server unterstützt, auch die Volltextsuche unterstützt.

Volltextsuchen erfordern eine SQL-Sortierreihenfolge, die einer Sprache mit einer in SQL Server registrierten Wörtertrennung entspricht. Wenn die Sortiereinstellungen der Teamprojektsammlung für Ihre Team Foundation 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 Enthält oder Enthält nicht zu verwenden.

Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortierungseinstellungen.

Abfrage indizierter Felder

Zusätzlich zum Volltextsuchindex wird ein Abfragenindex erstellt. Dieser basiert auf den Feldern, für die die Indizierung aktiviert ist. Der Abfragenindex verbessert die Antwortzeit, wenn Abfragen ausgeführt werden, die indizierte Felder enthalten.

Standardmäßig werden die folgenden Felder indiziert: Zugewiesen an, Datum der Erstellung, Geändert von, Zustand, Grund, Bereich-ID, Iterations-ID und Arbeitsaufgabentyp. Wenn das Team in seinen Abfragen häufig andere Felder verwendet, können Sie diese dem Abfragenindex hinzufügen.

Verwenden Sie den Befehl witadmin indexfield, um die Indizierung für ein Feld zu aktivieren bzw. zu deaktivieren. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin].

Siehe auch

Konzepte

Abfragen von Arbeitsaufgaben