Felder, Operatoren, Werte und Variablen von Abfragen

Aktualisiert: August 2012

Sie suchen und Erstellen von Arbeitsaufgabenlisten, indem Sie Arbeitsaufgabenabfragen erstellen.Wenn Sie eine oder mehrere Klauseln definieren, filtern Sie aus allen Arbeitsaufgaben innerhalb eines Teamprojekts oder einer Teamprojektsammlung, die Arbeitsaufgaben zurückzugeben, die für Sie interessanten.Für jede Klausel geben Sie ein Feld, einen Operator und einen Wert oder eine Variable.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.Anstatt, einen Wert anzugeben, 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 Suchen nach Fehlern, Aufgaben und anderen Arbeitsaufgaben.Informationen zur Navigation im Abfrage-Editor und in der Abfrageansicht mit Tastenkombinationen finden Sie unter Tastenkombinationen für den Abfrage-Editor und die Abfrageergebnisansicht.

In diesem Thema

• Und/Oder

• Abfragefelder und -werte

• Abfrageoperatoren

• Abfragevariablen

• Ganztext- und partielles Wortsuchen

• Abfrage indizierte Felder

Prüfliste für das Definieren einer Abfrageklausel:

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

   Weitere Informationen finden Sie unter Abfragefelder und -werte.

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

   Weitere Informationen finden Sie unter Operatoren.

3. In der gleichen Zeile unter der Spaltenüberschrift Wert, entweder Typ ein Wert oder wählen den Pfeil nach unten aus und wählen 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 Klicken Sie hier, um eine neue Klausel hinzuzufügen oder Neue Klausel hinzufügen.

   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, um Arbeitsaufgaben zu suchen, die die Kriterien in der aktuellen Klausel und in der vorherigen Klausel erfüllen.Geben Sie Oder an, um Arbeitsaufgaben zu suchen, die die Kriterien in der aktuellen Klausel oder in der vorherigen Klausel erfüllen.

Sie können eine neue Klausel für jedes Arbeitsaufgabenfeld hinzufügen, um die Suchkriterien zu verfeinern, sodass nur die Arbeitsaufgaben zurückgibt, die Sie möchten.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 im folgenden Beispiel dargestellt, die gruppierten Klauseln in den entsprechenden logischen Ausdruck übersetzt werden.Der erste Ausdruck gibt Arbeitsaufgaben, die Priorität 1 sind, sowie alle aktiven Fehler jeder Priorität zurück.Der zweite Ausdruck gibt alle aktiven Arbeitsaufgaben mit Priorität 1, sowie alle Fehler mit Priorität 1 zurück, ob oder nicht aktiv sind.

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.

Abfragefelder und -werte

Der Wert, den Sie für ein Feld angeben, muss sich an den Datentyp für dieses Feld anpassen.In der folgenden Tabelle werden die unterstützten Datentypen auf:

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	benutzerdefinierte formatierte das Feld, das verwendet wurde, um historische Informationen.Dieser Datentyp wird nur verwendet, um das Feld Verlauf zu unterstützen.Dieses Feld wird automatisch für die Volltextsuche indiziert, wenn Volltextsuche verfügbar ist.Siehe Ganztext- und partielles Wortsuchen, das weiter unten in diesem Thema beschrieben wird.
HTML	Textzeichenfolgen, die formatierte Beschreibungen unterstützen, wie die Beschreibung oder Reproduktionsschritte Felder.Diese Felder werden automatisch für die Volltextsuche indiziert, wenn Volltextsuche verfügbar ist.Siehe Ganztext- und partielles Wortsuchen, das weiter unten in diesem Thema beschrieben wird. Hinweis Wenn Sie Team Foundation Server aktualisieren, wird das Feld Beschreibung aus einem Feldtyp von PlainText zu HTML geändert.Verwenden des Befehls witadmin changefield können Sie den Datentyp für dieses Feld nach 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 Volltextsuche verfügbar ist.Siehe Ganztext- und partielles Wortsuchen, das weiter unten in diesem Thema beschrieben wird.
String	kurze Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann.
TreePath	Eine Verzweigungsstruktur, z. B. ein Bereichspfad oder ein Iterationspfad.Sie müssen ein Element in einer Liste gültiger Werte auswählen.Sie können nach Arbeitsaufgaben suchen, die einer Struktur entsprechen oder darin enthalten sind.Weitere Informationen finden Sie unter Erstellen und Ändern von Bereichen und Iterationen.

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 Arbeitsaufgabenfeldverweis 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.	Nummerieren Sie, das Double, GUID, Integer und String, DateTime und TreePath enthält
<>	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, der im angegebenen Feld enthalten ist.	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, der im angegebenen Feld enthalten ist.	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 genaue Übereinstimmung oder partielle der Textzeichenfolge innerhalb des Felds, das Sie zum Filtern ausgewählt haben.	String
Enthält nicht	Enthält oder partielle keine genaue Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie zum Filtern ausgewählt haben.	String
Enthält Worde	Enthält die genaue Textzeichenfolge oder die Wörter innerhalb des Felds, das Sie zum Filtern ausgewählt haben.Sie können partielle Wörter oder Ausdrücke, die das Platzhalterzeichen, * enthalten auch eingeben.Für Einschränkungen finden Sie unter Volltextsuchen für Server- und Sortierreihenfolgenanforderungen.	LONG-Textfelder, die für die Volltextsuche indiziert werden, die allen PlainText und HTML Feldern und zu Titel entsprechen.
Enthält nicht Worde	Enthält nicht die genaue Textzeichenfolge oder die Wörter innerhalb des Felds, das Sie zum Filtern ausgewählt haben.	Textfelder, die für die Volltextsuche indiziert werden.
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.Sie können in Team Foundation Server eine Standard-, Kategorie- oder benutzerdefinierte Gruppe angeben.Beispielsweise können Sie eine Abfrage erstellen, um alle Arbeitsaufgaben zu suchen, die Mitgliedern der Gruppe "Contributors" zugewiesen wurden. Hinweis Als Wert darf keine Sicherheits- oder E-Mail-Verteilergruppe eingegeben werden.	String, die den Namen einer Benutzergruppe oder einer Kategoriegruppe in Team Foundation Server übereinstimmt. Hinweis Sie können den In Gruppe-Operator nur mit Feldern verwendet werden, die den String Datentyp oder das Feld Arbeitsaufgabentyp verwenden. Informationen zu Kategoriegruppen finden Sie unter Definieren von Kategorien für Arbeitsaufgabentypen.
Nicht in Gruppe	Entspricht keinem Wert, der ein Member der Gruppe in der Klausel ist.	String, die den Namen einer Benutzergruppe oder einer Kategoriegruppe in Team Foundation Server, die für ein Teamprojekt definiert wird übereinstimmt. Hinweis Sie können den Nicht in Gruppe-Operator nur mit Feldern verwendet werden, die den String Datentyp oder das Feld Arbeitsaufgabentyp verwenden. Informationen zu Kategoriegruppen finden Sie unter Definieren 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.Um beispielsweise nach allen in der letzten Woche aktivierten Elementen zu suchen, 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

Ganztext- und partielles Wortsuchen

Geben Sie Enthält oder Enthält nicht an, die in der genauen oder teilweisen Übereinstimmungen eines Worts 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 oder an das Platzhalterzeichen, * zu verwenden.Diese Operatoren verwenden den Volltextsucheindex.Sie können das Platzhalterzeichen am Ende eines partiellen Wörtern oder Ausdrücken nur verwenden.

Beispiele zu diesem Thema finden Sie unter Suchen von Arbeitsaufgaben nach Schlüsselwörtern oder Ausdrücken und Anzeigen der Versionsgeschichte und Suchen nach Arbeitsaufgaben mithilfe des Felds "Versionsgeschichte".

Hinweis
Nicht alle Bereitstellungen Volltextsuchen unterstützen.Beispielsweise unterstützen SQL Express und SQL Azure, die den Team Foundation-Dienst unterstützen, nicht Volltextsuche.In diesen 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 Volltextsucheindex erstellt für LONGTextfelder.Team Foundation indiziert automatisch alle LONGTextfelder mit einem Datentyp PlainText und HTML und dem Feld Titel für die Volltextsuche.Der Index und die Operatoren sind bei der SQL Server nur verfügbar, der Team Foundation Server Stützvolltextsuche unterstützt.

Volltextsuchen erfordern eine SQL-Sortierreihenfolge, die einer Sprache entspricht, die eine Wörtertrennung verfügt, die mit SQL Server registriert ist.Wenn die Sortierungseinstellungen für die Datenbank für die Teamprojektsammlung, die für die Team Foundation Server-Instanz verwendet wird, nicht zu einer unterstützten Sprache entsprechen, gleichen Suchergebnisse möglicherweise nicht Ihren Erwartungen ab.In diesen Fällen versucht haben Sie möglicherweise, die Enthält oder Enthält nicht-Operatoren zu verwenden.

Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortierungseinstellungen.

Abfrage indizierte Felder

In der Addition zum Volltextsucheindex, wird ein Abfragenindex erstellt.Er basiert auf der Felder, die die Indizierung aktiviert haben.Der Abfragenindex verbessert die Antwortzeit, als Sie Abfragen ausführen, die indizierte Felder enthalten.

Standardmäßig werden die folgenden Felder indiziert: Zugewiesen zu, Erstellungsdatum, Geändert von, Zustand, Grund, Bereichs-ID, Iterations-ID und Arbeitsaufgabentyp.Wenn es andere Felder gibt, die das Team häufig in ihren Abfragen verwendet, können Sie diese dem Abfragenindex hinzufügen.

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

Siehe auch

Aufgaben

Angeben von Abfragefilterkriterien

Verwenden einer Abfrage vom Typ "Flache Liste" (Standard)

Arbeiten mit verknüpften Hierarchien (Arbeitsaufgabenstruktur)

Konzepte

Suchen nach Fehlern, Aufgaben und anderen Arbeitsaufgaben

Weitere Ressourcen

Arbeiten mit verknüpften Abhängigkeiten (Direktlinks)

Änderungsverlauf

Datum	Versionsgeschichte	Grund
August 2012	Die Tabelle, welche die Felddatentypen und entfernte Description aus dem Satz von Feldern beschrieben, die für die Volltextsuche indiziert werden.Zwei Abschnitte auf Volltextsuchen hinzugefügt andn indizieren die Abfrage.	Informationsergänzung.