Udostępnij za pośrednictwem


Pola, operatory, wartości oraz zmienne zapytania

Możesz znajdować i tworzyć listy elementów roboczych tworząc zapytania dotyczące elementów roboczych.Poprzez określenie jednej lub więcej klauzul filtrujesz z wszystkich elementów pracy w ramach projektu zespołu lub kolekcji projektów zespołu, aby uzyskać zestaw elementów pracy, które Cię interesują.Dla każdej klauzuli należy określić pole, operator oraz wartość lub zmienną.Na przykład można wyszukać wszystkie elementy robocze w określonym projekcie zespołowym, określając pole Projekt zespołowy, operator równości (=) i nazwa projektu zespołowego jako wartość.Zamiast określania wartości można określić zmienną taką jak @Project, która reprezentuje bieżący projekt zespołowy.

Przykładowa klauzula zapytania

I/lub

Pole

Operator

Wartość

I

Zespół projektu

=

@Project

Aby uzyskać więcej informacji dotyczących kwerend, zobacz Zapytanie o elementy pracy.Aby uzyskać informacje dotyczące przejścia w edytorze kwerendy lub widok zapytania korzystanie ze skrótów klawiaturowych, zobacz Skróty klawiaturowe do pracy w programach Team Web Access i Team Explorer.

W tym temacie

  • I/Lub

  • Pola zapytania i wartości

  • Operatory zapytań

  • Zmienne zapytania

  • Wyszukiwania pełnotekstowe i częściowe słów

  • Indeksowane pola zapytania

Lista kontrolna sposób zdefiniowania klauzuli zapytania:

  1. W pierwszym pustym wierszu pod nagłówkiem kolumny Pole wybierz strzałkę w dół, aby wyświetlić listę dostępnych pól, i wybierz element z listy.

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

  2. W tym samym wierszu pod nagłówkiem kolumny Operator wybierz strzałkę w dół, aby wyświetlić listę dostępnych operatorów, i wybierz element z listy.

    Aby uzyskać więcej informacji, zobacz Operatory.

  3. W tym samym wierszu pod nagłówkiem kolumny Wartość wpisz wartość lub wybierz strzałkę w dół i wybierz element z listy.

  4. Aby uzyskać więcej informacji dotyczących sposobu używania zmiennych do określania bieżącego projektu zespołowego, użytkownika 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ę (Wstawianie klauzuli zapytania) i Usuń (Usuwanie klauzuli zapytania), grupa (Grupowanie klauzul zapytania) i Rozgrupuj (Rozgrupowywanie klauzul zapytania) klauzul zgodnie z potrzebami.

I/Lub

Określasz I lub Lub, aby tworzyć wyrażenia logiczne z klauzul zapytań.Określ I, aby znaleźć elementy robocze, które spełniają kryteria zarówno w klauzuli bieżącej, jak i poprzedniej.Określ Lub, aby znaleźć elementy robocze, które spełniają kryterium w klauzuli bieżącej lub poprzedniej.

Możesz dodać jedną nową klauzulę dla każdego pola elementu roboczego, aby zawęzić kryteria wyszukiwania, dzięki czemu zwracany będzie tylko pożądany przez Ciebie zestaw elementów roboczych.Jeśli nie są wyświetlane wyniki, których można oczekiwać od zapytania, można dodać, usunąć, zgrupować lub rozgrupować klauzule zapytania, aby uściślić wyniki zapytania.

Grupowanie klauzul zapytania do działania jako pojedyncza jednostka oddzielnie od reszty zapytania jest podobne do umieszczania nawiasów wokół wyrażenia równania matematycznego lub zdania logicznego.Gdy klauzule grupy I lub LUB dla pierwszej klauzuli w grupie mają zastosowanie do całej grupy.

Jak pokazano na poniższym przykładzie, zgrupowane klauzule są tłumaczone na odpowiednie wyrażenie logiczne.Pierwsze wyrażenie zwraca elementy robocze, które są priorytetem 1, jak również wszystkie aktywne błędy o dowolnym priorytecie.Drugie wyrażenie zwraca wszystkie aktywne elementy robocze priorytet 1 oraz wszystkie błędy priorytet 1, niezależnie od tego, czy są one aktywne, czy nie.

Zgrupowane klauzule

Wyrażenie logiczne

Operator z klauzulą zgrupowane i lub

Priorytet=1 OR (Typ elementu roboczego=Usterka AND Stan=Aktywny)

Operator z ZGRUPOWANE lub klauzuli

Priorytet=1 I (Typ elementu roboczego=Usterka I Stan=Aktywny)

Aby uzyskać więcej informacji, zobacz Określanie kryteriów filtrów zapytania [redirected].

Pola zapytania i wartości

Wartość określona dla pola musi odpowiadać typowi danych dla tego pola.Poniższa tabela zawiera listę obsługiwanych typów danych:

Typ danych

Dane przechowywane

DateTime

Uniwersalny czas koordynowany (UTC) w danej chwili.Możesz określić zmienną, taką jak @Today lub @Today-1, lub wartość, na przykład 1-1-2012.

Double

Liczba rzeczywista, takich jak 0,2 lub 3.5.

GUID

Ciąg znaków, który reprezentuje unikatowy identyfikator.

History

Niestandardowo sformatowane pole, używane do śledzenia informacji historycznych.Ten typ danych jest używany tylko do obsługi pola Historia.To pole są automatycznie indeksowane dla wyszukiwania pełnotekstowego, jeśli jest ono dostępne.Zobacz Wyszukiwanie pełnotekstowe i wyszukiwanie według słów częściowych opisano w dalszej części tego tematu.

HTML

Ciągi tekstowe, które obsługują sformatowane opisy, takie jak pola Opis lub Odtwórz kroki.Te pola są automatycznie indeksowane dla wyszukiwania pełnotekstowego jeśli wyszukiwanie pełnotekstowe jest dostępne.Zobacz Wyszukiwanie pełnotekstowe i wyszukiwanie według słów częściowych opisano w dalszej części tego tematu.

[!UWAGA]

Podczas uaktualniania Team Foundation Server, pole Opis zostało zmienione z typu pola PlainText w HTML.Korzystając z polecenia witadmin changefield, można w razie potrzeby przywrócić typ danych dla tego pola.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ągi tekstowe, które obsługują długie opisy, takie jak pole Informacja o uruchamianiu aplikacji.Te pola są automatycznie indeksowane dla wyszukiwania pełnotekstowego, jeśli wyszukiwanie pełnotekstowe jest dostępne.Zobacz Wyszukiwanie pełnotekstowe i wyszukiwanie według słów częściowych opisano 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łęziona struktura drzewa, taka jak ścieżki Obszar lub Iteracja.Musisz wybrać element z listy prawidłowych wartości.Możesz znaleźć elementy robocze, 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ń

Można używać operatorów zapytania w poniższej tabeli, aby określić, jak każda wartość w klauzuli musi się odnosić do odpowiedniej wartości w elemencie roboczym.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 spełnia wymienione kryteria

Odpowiednie typy danych

=

Porównuje wartość w klauzuli.

Liczba, która może być typu Double, GUID, Integer, String, DateTime lub TreePath

<>

Nie odpowiada wartości w klauzuli.

Liczba, String, DateTime, and TreePath

& gt;

Jest większa od wartości w klauzuli.

Liczba, String, i DateTime

& lt;

Jest mniejsza od wartości w klauzuli.

Liczba, String, i DateTime

>=

Jest większa niż lub równa wartości w klauzuli.

Liczba, String, i DateTime

<=

Jest mniejsza lub równa wartości w klauzuli.

Liczba, String, i DateTime

=[Pole]

Porównuje wartość zawartą w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

<> [pola]

Nie odpowiada wartości zawartej w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

> [pola]

Jest większa niż wartość zawarta w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

< [pola]

Jest mniejsza niż wartość zawarta w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

> = [pole]

Jest większa niż lub równa wartości zawartej w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

< = [pole]

Jest mniejsza niż lub równa wartości zawartej w określonym polu.

Nazwa pola, o tym samym typie danych co określone pole

Zawiera

Zawiera dopasowanie dokładne lub częściowe ciągu tekstowego w ramach pola wybranego do filtrowania.

String

Nie zawiera

Nie zawiera dopasowania dokładnego lub częściowego ciągu tekstowego w ramach pola wybranego do filtrowania.

String

Zawiera wyrazy

Zawiera dokładny ciąg tekstowy lub wyrazy w ramach pola wybranego do filtrowania.Możesz również wprowadzić częściowe wyrazy lub frazy, które zawierają symbol wieloznaczny, *.Aby uzyskać informacje o ograniczeniach, zobacz Wyszukiwania pełnotekstowe w celu zapoznania się z wymaganiami dotyczącymi 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 wyrazów

Nie zawiera dokładnego ciągu tekstowego ani wyrazów w ramach pola wybranego do filtrowania.

Pola tekstowe, które są indeksowane w celu wyszukiwania pełnotekstowego.

W

Porównuje dowolną wartość w zestawie rozdzielanym.Na przykład można znaleźć elementy robocze, których identyfikatorami są 100, 101 i 102, jeśli określisz te wartości dla pola Identyfikator.

Ważna uwagaWażne

Oddzielaj wartości separatorem listy, który odpowiada ustawieniom regionalnym, które są zdefiniowane dla komputera klienckiego.Na przykład można użyć przecinka (,).

Liczba, String, DateTime, TreePath

W grupie

Porównuje wartość, która jest elementem członkowskim 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 pasuje do nazwy grupy użytkowników lub grupy kategorii w Team Foundation Server.

[!UWAGA]

Możesz użyć operatora W grupie tylko dla pól używających typu danych String lub pola Typ elementu roboczego.

Informacji dotyczących grupy kategorii, zobacz Używanie kategorii do grupowania typów elementów pracy.

Nie w grupie

Nie odpowiada wartości, która jest elementem członkowskim grupy w klauzuli.

String który pasuje do nazwy grupy użytkowników w Team Foundation Server lub grupy kategorii zdefiniowanych dla projektu zespołowego.

[!UWAGA]

Możesz użyć operatora Nie w grupie tylko dla pól używających typu danych String lub pola Typ elementu roboczego.

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

W obszarze

Porównuje wartość w klauzuli lub zawiera się w węźle w klauzuli.

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żesz użyć zmiennych w poniższej tabeli, aby znaleźć pozycje robocze, które odnoszą się do bieżącego użytkownika, bieżącego projektu lub daty bieżącej.

Zmienna zapytania

Użycie

@Me

Użyj tej zmiennej, aby automatycznie wyszukać alias bieżącego użytkownika w polu, które zawiera aliasy użytkowników.Na przykład można znaleźć elementy robocze, które zostały otwarte, po ustawieniu kolumny Pole na Aktywowane przez, kolumny Operator na =, a kolumny Wartość na @Me.

@Project

Użyj tej zmiennej, aby wyszukiwać elementy robocze w bieżącym projekcie zespołowym.Na przykład można znaleźć wszystkie elementy robocze w bieżącym projekcie zespołowym po ustawieniu kolumny Pole na Projekt zespołowy, kolumny Operator na =, a kolumny Wartość na @Project.

@Today

Użyj tej zmiennej, aby wyszukiwać elementy robocze, które odnoszą się do bieżącej daty lub daty wcześniejszej.Możesz również modyfikować zmienną @Today przez odejmowanie 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

Wyszukiwania pełnotekstowe i częściowe słów

Określ Zawiera lub Nie zawiera, aby przeprowadzać wyszukiwanie dla dokładnego lub częściowego dopasowania wyrazu lub frazy.Określ Zawiera wyrazy lub Nie zawiera wyrazów, aby przeprowadzać wyszukiwanie dokładnej frazy lub użyć symbolu wieloznacznego, *.Te operatory korzystają z indeksu wyszukiwania pełnotekstowego.Możesz używać symbolu wieloznacznego tylko na końcu częściowego 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 tych przypadkach widoczne będą tylko operatory Zawiera i Nie zawiera.

Zawiera wyrazy i Nie zawiera wyrazów filtrują elementy oparte na indeksie wyszukiwania pełnotekstowego utworzonym dla długich pól tekstowych.Team Foundation automatycznie indeksuje wszystkie długie pola tekstowe z typem danych PlainText i HTML, i pole Tytuł dla wyszukiwania pełnotekstowego.Indeks i operatorzy są dostępne tylko jeśli SQL Server obsługujący Team Foundation Server obsługuje wyszukiwanie pełnotekstowe.

Wyszukiwania pełnotekstowe wymagają sortowania SQL, które odnosi się do języka, który ma dzielenie wyrazów zarejestrowane w programie SQL Server.Jeśli ustawienia sortowania dla bazy danych zbierania projektu zespołowego używanej dla Twojego wystąpienia programu Team Foundation Server nie odpowiadają obsługiwanemu językowi, wyniki wyszukiwania mogą odbiegać od oczekiwanych.W tych przypadkach możesz spróbować użyć operatorów Zawiera lub Nie zawiera.

Aby uzyskać więcej informacji, zobacz Pełnotekstowe zapytania wyszukujące i ustawienia sortowania.

Indeksowane pola zapytania

Oprócz indeksu wyszukiwania pełnotekstowego tworzony jest indeks zapytania.Bazuje na tych polach, które mają włączone indeksowanie.Indeks kwerendy poprawia czas odpowiedzi podczas uruchamiania zapytań, które obejmują pól indeksowanych.

Domyślnie indeksowane są następujące pola: Przypisane do, Data utworzenia, Zmienione przez, Stan, Przyczyna, Identyfikator obszaru, Identyfikator iteracji i Typ elementu roboczego.Jeśli istnieją inne pola, które są często używane w zapytaniach przez zespół, można je dodać do indeksu zapytań.

Użyj polecenia witadmin indexfield, aby włączyć lub wyłączyć indeksowanie dla określonego pola.Zobacz Zarządzanie polami elementów pracy [witadmin].

Zobacz też

Koncepcje

Zapytanie o elementy pracy