Pola, operatory, wartości oraz zmienne zapytania

Znajdź i tworzenie list elementów pracy przy tworzeniu kwerend elementu pracy. Definiując co najmniej jedną klauzulę filtrowanie z wszystkich elementów pracy w ramach projektu zespołowego lub kolekcji projektów zespołowych do zwrócenia zestaw elementów pracy, które Cię interesują. Dla każdej klauzuli należy określić pola, operator i wartość lub zmienna. Na przykład można wyszukiwać wszystkie elementy robocze w projektu zespołowego określonej przez podanie projektu zespołowego pola, operator równości (=) i nazwa projektu zespołowego jako wartość. Zamiast określania wartości, w przypadku określenia zmiennej takich jak @Project, który reprezentuje bieżącego projektu zespołowego.

Przykładowe klauzuli zapytania

I/Lub	Pole	Operator	Wartość
Oraz	Projekt zespołowy	=	@Project

Aby uzyskać więcej informacji dotyczących kwerend, zobacz Zapytanie dotyczące elementów roboczych. Aby uzyskać informacje dotyczące przejścia w edytorze kwerendy lub widok zapytania korzystanie ze skrótów klawiaturowych, zobacz Skróty klawiaturowe: usługa Visual Studio Online, portal sieci Web serwera TFS i program Team Explorer.

W tym temacie:

• I/Lub

• Pól kwerendy i wartości

• Operatory zapytań

• Zmienne zapytania

• Wyszukiwanie pełnotekstowe i częściowego słowa

• Pola indeksowane zapytania

Lista kontrolna sposób zdefiniowania klauzuli zapytania:

1. W pierwszym wierszu puste w obszarze pola nagłówek kolumny, wybierz strzałkę w dół, aby wyświetlić listę dostępnych pól, a następnie wybierz element na liście.

   Aby uzyskać więcej informacji, zobacz pól kwerendy i wartości.

2. W tym samym wierszu w obszarze Operator nagłówek kolumny, wybierz strzałkę w dół, aby wyświetlić listę dostępnych operatorów i wybierz element na liście.

   Aby uzyskać więcej informacji, zobacz operatorów.

3. W tym samym wierszu w obszarze wartość nagłówek kolumny, albo wartość, wpisz lub wybierz strzałkę w dół i wybierz element na liście.

4. Aby uzyskać więcej informacji na temat używania zmiennych do określania bieżącego projektu zespołowego, użytkownik lub daty, zobacz zmienne.

5. Aby dodać klauzulę, wybierz polecenie kliknij tutaj, aby dodać nową klauzulę lub Dodaj nową klauzulę.

   Możesz dodać klauzulę w celu zapytania, wstawiania klauzuli po istniejącą klauzulę () i Usuń (), grupa () i Rozgrupuj () klauzul zgodnie z potrzebami.

I/Lub

Należy określić i lub lub do tworzenia wyrażeń logicznych z klauzul zapytania. Określ i można znaleźć elementów pracy, które spełniają kryteria zarówno w bieżącej klauzuli i poprzedniego klauzuli. Określ lub można znaleźć pozycje robocze zgodne kryterium w bieżącej klauzuli lub poprzedniego klauzuli.

Tak, aby zwraca zestaw elementów pracy, które mają, możesz dodać jeden nową klauzulę dla każdego pola elementu pracy, aby uzyskać dokładniejsze kryteria wyszukiwania. Wyniki, którymi z kwerendy nie jest wyświetlany, możesz dodać, usunąć, grupy lub zgrupuj klauzule zapytania, aby uzyskać dokładniejsze wyniki zapytania.

Klauzula kwerendy można przedstawić jako pojedyncza jednostka oddzielnie od pozostałych zapytania, podobne do umieszczania nawiasów wokół wyrażeń w instrukcji matematycznych równania lub logiki. W przypadku grupowania klauzul, i lub lub dla pierwszej klauzuli w grupie ma zastosowanie do całej grupy.

Jak pokazano w poniższym przykładzie, zgrupowane klauzule są przetłumaczone na odpowiednie wyrażenie logiczne. Pierwsze wyrażenie zwraca elementów pracy, które są priorytecie 1, a także wszystkich aktywnych usterek w dowolnym priorytetu. Drugie wyrażenie zwraca wszystkie aktywne priorytet elementów roboczych 1 oraz wszystkich priorytetów 1 błędy, czy działają lub nie.

Zgrupowane klauzule	Wyrażenie logiczne
	Priorytet=1 OR (Typ elementu roboczego=Usterka AND Stan=Aktywny)
	Priorytet=1 I (Typ elementu roboczego=Usterka I Stan=Aktywny)

Aby uzyskać więcej informacji, zobacz Określ kryteria filtrów zapytania.

Pól kwerendy i wartości

Wartość określona dla pola musi być zgodna z typem danych dla tego pola. W poniższej tabeli przedstawiono obsługiwane typy danych:

Typ danych	Dane przechowywane
DateTime	Uniwersalny czas koordynowany (UTC) w jednej chwili. W przypadku określenia zmiennej, takie jak @Today lub @Today-1, lub wartość, takie jak 1/1/2012.
Double	Liczba rzeczywista, taka jak 0,2 lub 3,5.
GUID	Ciąg znaków, który reprezentuje unikatowy identyfikator.
History	Niestandardowe sformatowany pola używane do śledzenia informacji historycznych. Ten typ danych służy tylko do obsługi historii pola. To pole jest automatycznie indeksowany do wyszukiwania pełnotekstowego, po udostępnieniu wyszukiwaniem pełnotekstowym. Zobacz wyszukiwania pełnotekstowego i częściowego wyrazów opisane w dalszej części tego tematu.
HTML	Ciągów tekstowych, które obsługuje sformatowany opisy, takie jak Opis lub kroki odtwarzania pól. Te pola są automatycznie indeksowany do wyszukiwania pełnotekstowego, po udostępnieniu wyszukiwaniem pełnotekstowym. Zobacz wyszukiwania pełnotekstowego i częściowego wyrazów opisane w dalszej części tego tematu. Uwaga Po uaktualnieniu Team Foundation Server, Opis pole jest zmieniła się z typem pola PlainText do HTML.Przy użyciu witadmin changefield polecenie Typ danych dla tego pola można przywrócić zgodnie z potrzebami.Zobacz Zarządzanie polami elementów pracy [witadmin].
Integer	32-bitowa liczba całkowita, która jest podpisany, takich jak 0, 1, 2, 34.
PlainText	Ciągów tekstowych, które obsługuje długie opisy, takie jak informacje o aplikacji uruchomić pola. Te pola są automatycznie indeksowany do wyszukiwania pełnotekstowego, po udostępnieniu wyszukiwaniem pełnotekstowym. Zobacz wyszukiwania pełnotekstowego i częściowego wyrazów opisane w dalszej części tego tematu.
String	Ciąg krótki tekst, który może zawierać więcej niż 255 znaków Unicode.
TreePath	Rozgałęziania struktura drzewa, takich jak ścieżki ścieżkę obszaru lub iteracji. Należy wybrać element na liście prawidłowych wartości. Można znaleźć elementów pracy, które są równe lub znajdują się w strukturze drzewa. Aby uzyskać więcej informacji, zobacz Dodawanie i modyfikowanie obszaru i ścieżek iteracji.

Powrót do początku

Operatory zapytań

Operatory zapytań w poniższej tabeli służy do określania, jak każda wartość w klauzuli musi mieć związek z odpowiednie wartości w elementu pracy. Uzyskać informacji o typie danych przypisany do elementu pracy pola, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Operator zapytań	Zwraca elementy robocze, jeśli wartość w elemencie roboczym pasujący do kryteriów na liście	Typy danych odpowiednich
=	Pasuje do wartości w klauzuli.	Numer, który obejmuje Double, GUID, Integer, i String, DateTime, i TreePath
<>	Niezgodna z wartością w klauzuli.	Liczba, String, DateTime, i TreePath
>	Jest większa niż wartość w klauzuli.	Liczba, String, i DateTime
& lt;	Jest mniejsza niż wartość w klauzuli.	Liczba, String, i DateTime
>=	Jest mniejsza niż wartość w klauzuli.	Liczba, String, i DateTime
<=	Jest mniejsza lub równa wartości w klauzuli.	Liczba, String, i DateTime
= [Pole]	Pasuje do wartości, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
<> [pola]	Nie jest zgodna wartość, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
> [pola]	Jest większa niż wartość, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
< [pola]	Jest mniejsza niż wartość, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
> = [pole]	Jest większe niż lub równe wartość, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
< = [pole]	Jest mniejsze niż lub równe wartość, która znajduje się w określonym polu.	Nazwa pola, która jest tego samego typu danych jako określone pole
Zawiera	Zawiera dopasowania dokładnego lub jego część ciągu tekstowego w ramach wybranego filtrowania pola.	String
nie zawiera	Nie zawiera dopasowania dokładnego lub jego część ciągu tekstowego w ramach wybranego filtrowania pola.	String
Zawiera słowa	Zawiera ciąg tekstowy dokładne lub wyrazy w polu wybrane filtrowania. Można również wprowadzić częściowe słów lub wyrażeń zawierających symbol wieloznaczny, *. Dla ograniczenia, zobacz Wyszukiwanie pełnotekstowe wymagania serwera i sortowania.	Tekst długo indeksowanych polach dla wyszukiwania pełnotekstowego, które odnoszą się do wszystkich PlainText i HTML pola i Tytuł.
Nie zawiera słów	Nie zawiera ciąg tekstowy dokładne lub wyrazy w polu wybrane filtrowania.	Pola tekstowe, które jest indeksowany do wyszukiwania pełnotekstowego.
Do wewnątrz	Pasuje do zestawu rozdzielanego dowolna wartość. Na przykład można znaleźć pozycje robocze, których identyfikatory są 100, 101 i 102, w przypadku określenia tych wartości dla pola identyfikator. Ważne Oddzielne wartości separatorem listy umożliwiająca ustawienia regionalne, które są definiowane dla komputera klienta.Na przykład można na przykład wpisz.	Liczba, String, DateTime, TreePath
W grupie	Dopasowuje wartość, która jest członkiem grupy w klauzuli. Nazwa kategorii lub grupy TFS odpowiada grup. Na przykład można utworzyć kwerendę w celu znalezienia wszystkich elementów pracy, które są przypisane do członków grupy współpracowników lub zespół. Grupy zespołu są tworzone podczas tworzenia zespołu. Nazwa grupy zespołu zgodny ze wzorcem [nazwę projektu zespołowego] \ Nazwa zespołu. Nie można określić zabezpieczeń lub grupy dystrybucji wiadomości e-mail jako wartość. Opracowanego przykłady, patrz temat przykładowych kwerend.	String który jest zgodna z nazwą grupy użytkowników lub grupy kategorii w Team Foundation Server. Uwaga Można użyć do grupy operator tylko z pola używające protokołu String Typ danych lub typu elementu roboczego pola. Informacji dotyczących grupy kategorii, zobacz Używanie kategorii do grupowania typów elementów pracy.
Nie w grupie	Wartość, która jest członkiem grupy w klauzuli nie jest zgodna.	String który jest zgodna z nazwą grupy użytkowników w Team Foundation Server lub grupy kategorii zdefiniowane dla projektów zespołowych. Uwaga Można użyć nie grupy operator tylko z pola używające protokołu String Typ danych lub typu elementu roboczego pola. Informacji dotyczących grupy kategorii, zobacz Używanie kategorii do grupowania typów elementów pracy.
Było kiedykolwiek	Pasuje do wartości w klauzuli w dowolnym momencie poprzedniego.	String, DateTime
Pod	Zgodna z wartością w klauzuli lub znajduje się w klauzuli węźle.	TreePath
Nie pod	Nie jest zgodna z wartością w klauzuli i nie znajduje się w klauzuli węźle.	TreePath

Powrót do początku

Zmienne zapytania

Można używać zmiennych w tabeli poniżej, aby znaleźć elementów pracy, które odnoszą się do bieżącego użytkownika, bieżący projekt lub bieżącą datę.

Zmienna kwerendy	Użycie
@Me	Tej zmiennej używamy wtedy automatycznie wyszukiwać aliasu bieżącego użytkownika w polu zawierającym aliasów użytkownika. Na przykład można znaleźć elementów pracy, które można otworzyć po ustawieniu pola kolumny, która ma uaktywniony przez, Operator kolumny, która ma =, i wartość kolumny do @Me.
@Project	Tej zmiennej używamy wtedy do wyszukiwania elementów roboczych w bieżącym projekcie zespołowym. Na przykład można znaleźć wszystkie elementy robocze w bieżącym projektu zespołowego po ustawieniu pola kolumny, która ma projektu zespołowego, Operator kolumny, która ma =, i wartość kolumny do @Project.
@Today	Tej zmiennej używamy wtedy do wyszukiwania elementów pracy, które odnoszą się do bieżącej daty lub wcześniej. Można również modyfikować @Today zmiennej przez odjęcie ilości dni. Na przykład można znaleźć wszystkie elementy aktywowany w ostatnim tygodniu po ustawieniu pola kolumny, która ma aktywowany data, Operator kolumny, która ma > =, i wartość kolumny, która ma @Today - 7.
[Any]	Tej zmiennej używamy wtedy do wyszukiwania elementów pracy, które odnoszą się do wartości zdefiniowanej dla określonego pola.

Powrót do początku

Wyszukiwanie pełnotekstowe i częściowego słowa

Określ zawiera lub nie zawiera do wyszukiwania w odniesieniu do dokładnego lub jego część dopasowań wyrazu lub frazy. Określ zawiera wyrazy lub jest zawiera wyrazy do wyszukiwania w odniesieniu do Dokładna fraza lub użyć symbolu wieloznacznego, *. Te operatory korzystać z indeksu wyszukiwania pełnotekstowego. Symbol wieloznaczny można używać tylko na końcu częściowe wyrazu lub frazy.

Przykłady, patrz temat Przykładowe zapytania o element pracy i Wyszukiwanie elementów roboczych korzystając z pola historii.

Uwaga

Nie wszystkie wdrożenia obsługują wyszukiwanie pełnotekstowe.Na przykład SQL Express i SQL Azure, które obsługuje programu Visual Studio Online, nie obsługują wyszukiwanie pełnotekstowe.W takich przypadkach wyświetlany tylko zawiera i nie zawiera operatorów.

Zawiera wyrazy i jest zawiera wyrazy Filtruj elementy w oparciu o utworzone dla pól tekstowych długo indeks wyszukiwania pełnotekstowego. Team Foundation automatycznie zindeksowane wszystkie pola tekstowe długiej o typie danych PlainText i HTML i Tytuł pola wyszukiwania pełnotekstowego. Indeks i operatory są dostępne tylko, gdy program SQL Server, który obsługuje Team Foundation Server obsługuje wyszukiwaniem pełnotekstowym.

Wyszukiwanie pełnotekstowe wymagają sortowania bazy danych SQL umożliwiająca języku, który został zarejestrowany w programie SQL Server dzielenie wyrazów. Jeśli ustawienia sortowania dla zespołu projektu kolekcji bazy danych używanej do swojego Team Foundation Server wystąpienie nie są zgodne z obsługiwanych języków, wyniki wyszukiwania może różnić się zgodnie z oczekiwaniami. W takich przypadkach, spróbuj użyć zawiera lub nie zawiera operatorów.

Aby uzyskać więcej informacji, zobacz kwerend wyszukiwania pełnotekstowego i ustawień sortowania.

Pola indeksowane zapytania

Oprócz indeksu wyszukiwania pełnotekstowego jest tworzony indeks zapytania. Jest ona oparta na te pola, które mają indeksowania włączone. Indeks kwerendy poprawia czas odpowiedzi podczas uruchamiania zapytań, które obejmują pól indeksowanych.

Domyślnie są indeksowane następujące pola: przypisany do, Data utworzenia, zmienione przez, stanu, Przyczyna, Identyfikator obszaru, identyfikator iteracji, i typu elementu roboczego. Jeśli istnieją inne pola w ich kwerend często używane przez zespół, możesz dodać je do indeksu zapytania.

Możesz użyć witadmin indexfield polecenie, aby włączyć lub wyłączyć funkcję indeksowania dla pola. Zobacz Zarządzanie polami elementów pracy [witadmin].

Zobacz też

Koncepcje

Zapytanie dotyczące elementów roboczych