Udostępnij za pośrednictwem

Używanie indeksu do wykonywania zapytań dotyczących szybkich danych referencyjnych w usługach Azure Boards i Azure DevOps

  • Artykuł

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

Ten indeks umożliwia szybki dostęp do przykładowych zapytań i informacji dotyczących otwierania, definiowania i pracy z zapytaniami. Aby dowiedzieć się, jak używać Edytor Power Query, zobacz Definiowanie zapytania. Jeśli okaże się, że zapytanie trwa zbyt długo, aby zwracać wyniki, zobacz Definiowanie zapytania/najlepszych rozwiązań.

Przykładowe zapytania

Elementy robocze można wyświetlić na podstawie następujących kryteriów...

Słowa kluczowe, zapytania z symbolami wieloznacznymi

Zapytania oparte na tagach

Zapytania dotyczące zmian stanu, przyczyny lub przepływu pracy

Zapytania oparte na datach i iteracji

Zapytania dotyczące linków i liczby załączników

Zapytania oparte na tożsamościach

Liczba elementów roboczych i zapytania dotyczące pól liczbowych

Historia, dyskusja i zapytania dotyczące zmian poprawek

Zapytania fokusu zespołu

Kompilowanie i testowanie zapytań dotyczących pól

Inne

Zadania dotyczące zapytań

Operatory i makra obsługiwane dla każdego typu danych

W poniższej tabeli przedstawiono operatory i makra dostępne dla różnych typów danych pól. Każde pole jest skojarzone z typem danych. Typ danych można znaleźć w opisach każdego pola, które można wyszukać przy użyciu indeksu pola Element roboczy. Operatory dostępne do definiowania klauzuli zapytania zależą od typu danych wybranego pola. Aby uzyskać bardziej szczegółowe opisy typów danych, operatorów i makr, zobacz Pola zapytań, operatory i makra.

Uwaga

Następujące makra są obsługiwane tylko w portalu internetowym: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity i @TeamAreas. Zapytania zawierające te makra nie będą działać po otwarciu w programie Visual Studio/Team Explorer, Microsoft Excel lub Microsoft Project.

Typ danych

Opis

Obsługiwane operatory i makra

Wartość logiczna

Obsługuje wartość prawda/fałsz. Przykłady zapytań: wykonywanie zapytań według zmian przydziału lub przepływu pracy.

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

Data/godzina

Pole daty, w którym można określić zmienną, taką jak @Today lub @Today-1, lub wartość, taką jak 1.1.2012. Wprowadź daty w wzorcu daty ustawionym dla profilu osobistego. Aby uzyskać szczegółowe informacje, zobacz Ustawianie preferencji osobistych .

Aby zapoznać się z przykładami zapytań, zobacz Zapytanie według daty or@CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makra: @Today, prawidłowe z dowolnym polem DateTime

Dodatkowe makra obsługiwane w usłudze Azure DevOps 2019 Update 1 i nowszych wersjach:
@StartOfDay, @StartOfWeek, @StartOfMonthi @StartOfYear, prawidłowe z dowolnym polem DateTime

Podwójne

Określana również jako liczba dziesiętna i zawiera listę picklistDouble1. Liczba rzeczywista, taka jak 0,2 lub 3,5.

Przykłady zapytań: wykonywanie zapytań według pól liczbowych.

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

Identyfikator GUID

Ciąg znaków reprezentujący unikatowy identyfikator.

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

Historia

Niestandardowe sformatowane pole używane do śledzenia informacji historycznych i przypisane tylko do pola Historia .

Przykłady zapytań: Historia i inspekcja.

Zawiera wyrazy, nie zawiera wyrazów

HTML

Ciągi tekstowe obsługujące sformatowane opisy, takie jak pola Opis lub Kroki odtworzenia . Te pola są automatycznie indeksowane w celu wyszukiwania pełnotekstowego, gdy jest dostępne wyszukiwanie pełnotekstowe. Przykłady zapytań: wykonywanie zapytań według tytułów, identyfikatorów i pól tekstu sformatowanych.

Contains Words, , Does Not Contain WordsIs Empty2, 2 Is Not Empty

Tożsamość

Pole Ciąg używane do przechowywania tożsamości użytkownika. Przykłady zapytań: wykonywanie zapytań według zmian przydziału lub przepływu pracy.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMakra: @me prawidłowe dla wszystkich pól tożsamości.

Wartość całkowita

Zawiera również listę wyboruInteger1. 32-bitowa liczba całkowita, która jest podpisana, na przykład 0, 1, 2, 34.

Przykłady zapytań: zapytanie według pól liczbowych

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

Makra: @Follows, , @RecentMentions@MyRecentActivityi @RecentProjectActivity, prawidłowe w przypadku użycia z polem IDENTYFIKATOR.

Postaci zwykłego tekstu

Ciągi tekstowe wielowierszowe, które obsługują długie opisy i są automatycznie indeksowane do wyszukiwania pełnotekstowego, gdy jest dostępne wyszukiwanie pełnotekstowe.
Przykłady zapytań: wykonywanie zapytań według tytułów, identyfikatorów i pól tekstu sformatowanych.

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

ciąg

Zawiera również ciąg picklistString1. Krótki tekst jednowierszowy, który może zawierać maksymalnie 255 znaków Unicode. Pola ciągów obsługują pole Tytuł , listy wyboru (menu rozwijane), konta użytkowników, tagi i inne pola.

Przykłady zapytań: Wykonywanie zapytań według tytułów, identyfikatorów i pól tekstu sformatowanych oraz Zapytania według wartości listy wyboru.

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

Makra: [Any], prawidłowe z polem @ProjectTyp elementu roboczego , prawidłowe w polu Projekt zespołowy.

TreePath

Typ pola, który obsługuje pola Ścieżka obszaru i Ścieżka iteracji. Należy zdefiniować strukturę drzewa dla projektu — ścieżki obszaru i ścieżki iteracji.

Przykłady zapytań: Wykonywanie zapytań według obszaru lub ścieżki iteracji oraz Zapytanie według daty lub bieżącej iteracji.

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

Makra: @TeamAreas3, prawidłowe z polem Ścieżka obszaru
@CurrentIteration i @CurrentIteration+/- n4 prawidłowe z polem Ścieżka iteracji

Uwaga

  1. Typy danych listy wyboru są przypisywane tylko do pól niestandardowych zdefiniowanych dla dziedziczonego procesu. Model procesów dziedziczony jest obsługiwany tylko w przypadku usługi Azure DevOps Server 2019 i nowszych wersji.
  2. Operatory Is Empty i Is Not Empty są obsługiwane w przypadku usługi Azure DevOps Server 2019 RC2 i nowszych wersji.
  3. Makro @TeamAreas jest obsługiwane w przypadku usług Azure Boards i Azure DevOps Server 2019 i nowszych wersji.
  4. Makro @CurrentIteration +/- n jest obsługiwane w przypadku usługi Azure DevOps Server 2019 i nowszych wersji oraz tylko wtedy, gdy jest uruchamiane z portalu internetowego.

Wzorzec daty i godziny

Wzorzec daty i godziny wprowadzony dla pól DateTime powinien być zgodny z wzorcem wybranym przez profil. Aby wyświetlić lub zmienić wybór, zobacz Ustawianie preferencji użytkownika.

Zrzut ekranu przedstawiający opcje listy rozwijanej Wzorzec daty w okienku Czas i ustawienia regionalne.Zrzut ekranu przedstawiający opcje listy rozwijanej Wzorzec czasu w okienku Czas i ustawienia regionalne.

Zrzut ekranu przedstawiający okienko Czas i ustawienia regionalne z polami Wzorzec daty i Wzorzec godziny.

Przykładowe zapytania dotyczące wybranych pól

W poniższej tabeli wymieniono typowe pola zapytań i ich typ danych, dla których podano przykładowe zapytania. Aby określić typ danych pola, zobacz Pola i atrybuty elementu roboczego, Atrybuty pola listy.

A

B

C

D-E-F

H-P

R

S

T

V-W

  • Obszar wartości (ciąg)
  • Typ elementu roboczego (ciąg)