Udostępnij za pośrednictwem


Wyświetlić, uruchomić lub wysłać zapytanie o elementy robocze pocztą e-mail

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2022

W tym artykule opisano sposób uzyskiwania dostępu do elementów roboczych usługi Azure Boards i interakcji z nimi przez uruchamianie i udostępnianie zapytań. Możesz wyświetlać i uruchamiać wbudowane lub udostępnione zapytania, aby zidentyfikować elementy robocze przypisane do Ciebie lub spełniające inne kryteria.

Wymagania wstępne

  • Projekt usługi Azure DevOps z elementami roboczymi przypisanymi do Ciebie lub śledzonymi przez Ciebie oraz zapytaniami zdefiniowanymi przez Ciebie lub udostępnionymi Tobie. Aby zdefiniować zapytanie, zobacz Definiowanie zapytania elementu roboczego.
Kategoria Wymagania
poziomy dostępu - Aby wyświetlić i uruchomić udostępnione zapytania: członek projektu.
— Aby dodać i zapisać udostępnione zapytanie: co najmniej dostęp podstawowy.
Uprawnienia uprawnienia na Współpracę ustawione na Zezwalaj dla folderu, do którego chcesz dodać zapytanie. Domyślnie grupa Współautorzy nie ma tego uprawnienia.

Uwaga

Użytkownicy z dostępem uczestników projektu publicznego mają pełny dostęp do funkcji zapytań, takich jak użytkownicy z dostępem podstawowym . Aby uzyskać więcej informacji, zobacz Stakeholder access quick reference (Dostęp uczestnika projektu — krótki przewodnik).

Kategoria Wymagania
poziomy dostępu - Aby wyświetlić i uruchomić udostępnione zapytania: członek projektu.
— Aby dodać i zapisać udostępnione zapytanie: co najmniej dostęp podstawowy.
Uprawnienia uprawnienia na Współpracę ustawione na Zezwalaj dla folderu, do którego chcesz dodać zapytanie. Domyślnie grupa Współautorzy nie ma tego uprawnienia.

Otwórz stronę Zapytania

Aby otworzyć stronę Zapytania dla projektu, wybierz pozycję Tablice>Zapytania. Strona Zapytania zostanie otwarta na karcie Ulubione z wyświetlonymi zapytaniami wybranymi przez Ciebie lub Twój zespół jako ulubione. Aby uzyskać więcej informacji, zobacz Ustawianie ulubionych osobistych lub zespołowych.

Karta Ulubione zawiera również ostatnie otwarte zapytania pod Kontynuuj od miejsca przerwania.

Zrzut ekranu przedstawiający kartę Ulubione na stronie Zapytania.

Aby wyświetlić wszystkie zapytania osobiste i udostępnione w projekcie, wybierz kartę Wszystkie na stronie Zapytania . Karta Wszystkie zawiera wbudowane zapytania, zdefiniowane zapytania i zapytania, które są współużytkowane w projekcie. Rozwiń foldery Moje zapytania, Udostępnione zapytania oraz inne, aby uzyskać dostęp do ich zapytań.

Zrzut ekranu przedstawiający kartę Wszystkie zapytania.

Zrzut ekranu przedstawiający kartę Wszystkie na stronie Zapytania.

Na karcie Wszystkie na stronie Zapytania folder Moje zapytania zawiera następujące wbudowane zapytania oprócz zdefiniowanych przez Ciebie:

  • Przypisane do mnie używa makra @Me, aby wyświetlić listę wszystkich elementów roboczych przypisanych do ciebie w bieżącym projekcie.
  • Obserwowane elementy robocze wykorzystują makroID @Follows w @Follows, aby wyświetlić listę wszystkich obserwowanych elementów roboczych. Aby uzyskać więcej informacji, zobacz Obserwowanie elementu roboczego lub pull requestu.

Zadania obsługiwane na karcie Wszystkie i Ulubione

Większość zadań związanych z wyświetlaniem i uruchamianiem zapytań można wykonać z karty Wszystkie lub Ulubione na stronie Zapytania, jak pokazano w poniższej tabeli.


Zadanie
Ulubione wszystkie
Wyświetl listę wszystkich ulubionych zapytań, Twoich lub zespołu, do którego należysz ✔️
Wyświetlanie listy wszystkich zapytań lub udostępnionych zapytań dla bieżącego projektu ✔️
Dodaj do ulubionych zapytanie ✔️
Usuń z ulubionych kwerendę ✔️ ✔️
Filtrowanie listy zapytań ✔️ ✔️
Rozwijanie lub zwijanie folderów ✔️ ✔️
Uruchamianie zapytania lub otwieranie menu kontekstowego dla zapytania ✔️ ✔️

W obszarze Moje zapytania są wyświetlane tylko wbudowane zapytania i zapytania zapisywane w obszarze Moje zapytania. Tylko ulubione zapytania są wyświetlane w obszarze Moje ulubione. Tylko zapytania zapisane w obszarze Udostępnione zapytania mogą być ulubione przez zespół.

Filtrowanie listy zapytań

Wprowadź słowo kluczowe w polu filtru na kartach Ulubione lub Wszystkie na stronie Zapytania , aby filtrować wyświetlane zapytania. Aby uzyskać więcej informacji, zobacz Interakcyjnie filtruj listy prac, tablice, zapytania i plany.

Zrzut ekranu przedstawiający wszystkie zapytania w projekcie filtrowane według kryteriów słowa kluczowego.

Zrzut ekranu przedstawiający wszystkie zapytania w projekcie filtrowane według kryteriów słowa kluczowego.

Na karcie Ulubione lub Wszystkie na stronie Zapytania możesz przejść, aby znaleźć i otworzyć określone zapytania.

Na karcie Wszystkie strony zapytania mogą być wyświetlane bezpośrednio lub znajdować się w folderach lub podfolderach. Możesz przejść do folderu, podfolderu lub strony zapytania.

Podczas wybierania i otwierania folderów na górze strony wyświetlane są nawigacje ścieżkowe.

Zrzut ekranu przedstawiający ścieżkę nawigacji na stronie zapytania.

Zrzut ekranu przedstawiający ścieżkę nawigacji na stronie zapytania.

Możesz wybrać folder w ścieżce nawigacyjnej (pasku nawigacyjnym), aby go otworzyć.

Zrzut ekranu przedstawiający przykład ścieżki nawigacyjnej zapytań.

Możesz również otworzyć ulubione zapytanie lub wrócić do strony Wszystkie zapytania z menu rozwijanego otwartego zapytania.

Zrzut ekranu z rozwijaną listą zapytań.

Zrzut ekranu listy rozwijanej nawigacji zapytań.

Uruchamianie zapytania

Aby uruchomić zapytanie z zakładki Ulubione lub Wszystkie strony Zapytania, w razie potrzeby rozwiń jego folder i wybierz zapytanie. Zostanie otwarta strona Wyniki zapytania.

Możesz również wybrać ikonę Więcej akcji obok zapytania na stronie Zapytania i wybrać pozycję Uruchom zapytanie lub inne opcje z menu kontekstowego.

Zrzut ekranu przedstawiający menu kontekstowe zapytania na stronie Zapytania.

Uruchamianie zapytania z poziomu interfejsu wiersza polecenia usługi Azure DevOps

Zapytanie usługi Azure Boards można uruchomić przy użyciu polecenia az boards query w interfejsie wiersza polecenia usługi Azure DevOps. Aby rozpocząć, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

az boards query [--id] [--org] [--path] [--project] [--wiql] 

Parametry

  • id: identyfikator istniejącego zapytania. Wymagane, chyba że określono --path lub --wiql.
  • wiql: zapytanie w formacie WIQL (Work Item Query Language). Ignorowane, jeśli określono --id lub --path.
  • path: ścieżka istniejącego zapytania. Ignorowane, jeśli --id jest określony.
  • org: adres URL organizacji usługi Azure DevOps, taki jak --org https://dev.azure.com/MyOrganizationName/. Wymagane, chyba że skonfigurowano jako domyślne lub odebrane przy użyciu polecenia git config. Skonfiguruj domyślną organizację przy użyciu polecenia az devops configure -d organization=ORG_URL.
  • project: nazwa lub identyfikator projektu. Wymagane, jeśli wartość domyślna nie jest skonfigurowana lub została wybrana przy użyciu polecenia git config. Skonfiguruj projekt domyślny przy użyciu polecenia az devops configure -d project=NAME_OR_ID.

Przykłady

Następujące polecenie uruchamia zapytanie z określonym identyfikatorem i pokazuje wynik w formacie tabeli.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form

Następujące polecenie uruchamia zapytanie WIQL i wyświetla wynik w formacie tabeli.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions

Wyślij wiadomość e-mail lub udostępnij zapytanie

W widoku Edytor zapytań lub Wyników możesz wysłać wiadomość e-mail z sformatowaną listą elementów zapytania do członków projektu lub skopiować adres URL zapytania do udostępnienia.

Wybierz ikonę Więcej akcji w prawym górnym rogu, a następnie wybierz pozycję Zapytanie e-mail lub Kopiuj adres URL zapytania z menu kontekstowego.

Zrzut ekranu przedstawiający wybieranie zapytania e-mail lub adresu URL kopiowania zapytania.

Zrzut ekranu przedstawiający wybieranie zapytania e-mail lub adresu URL kopiowania zapytania.

Wiadomość e-mail można wysyłać tylko do poszczególnych członków projektu rozpoznawanych przez system. Wysyłanie do grupy roboczej lub grupy zabezpieczeń nie jest obsługiwane. Adresaci muszą mieć uprawnienia do odczytywania wysłanych elementów roboczych.

Wiadomość e-mail jest wysyłana za pomocą domyślnego programu pocztowego użytkownika i zawiera link do zapytania, które zwraca tylko wymienione elementy robocze. Aby uzyskać więcej informacji, zobacz Kopiowanie lub klonowanie elementów roboczych.

Uwaga

Aby wysłać wiadomość e-mail zawierającą sformatowaną listę do osób, które nie są członkami projektu, zobacz Kopiuj lub wyślij wiadomość e-mail zawierającą listę elementów roboczych.

Uwaga

W przypadku lokalnej usługi Azure DevOps wszystkie akcje poczty e-mail wymagają skonfigurowania serwera SMTP (Simple Mail Transfer Protocol ). Jeśli nie masz skonfigurowanego serwera SMTP, możesz obejść to wymaganie, używając polecenia Kopiuj jako kod HTML zgodnie z opisem w temacie Kopiuj lub wyślij wiadomość e-mail na listę elementów roboczych.

Wyświetlanie elementów roboczych w programie Visual Studio

Na stronie Elementy robocze programu Visual Studio Team Explorer można wyświetlić listę elementów roboczych dla połączonych projektów. Tworzenie zapytań i zarządzanie nimi należy wykonać w interfejsie internetowym usługi Azure Boards.

W okienku Wyszukiwanie elementów roboczych można zastosować filtry, aby wyświetlić wymienione elementy robocze według pozycji Przypisane,Utworzone przez, Stan lub Typ elementu roboczego.

Możesz rozwinąć listę Elementy robocze i wybrać strzałkę listy rozwijanej obok bieżącego widoku, aby wybrać wbudowane widoki Przypisane do mnie, Następujące, Wymienione lub Moje działania .

Zrzut ekranu przedstawiający stronę Elementy robocze z opcjami widoku.

W przypadku elementów roboczych wymienionych na liście można wykonywać następujące czynności:

  • Umieść kursor na elemencie roboczym, aby wyświetlić informacje.
  • Wybierz tytuł elementu roboczego, aby zmienić nazwę elementu roboczego.
  • Kliknij prawym przyciskiem myszy element roboczy, aby przypisać go do siebie lub ukończyć element roboczy.
  • Kliknij dwukrotnie element lub kliknij prawym przyciskiem myszy i wybierz polecenie Otwórz, aby otworzyć element roboczy w interfejsie użytkownika usługi Azure Boards.

Zrzut ekranu przedstawiający opcje elementów roboczych na stronie Elementy robocze programu Team Explorer.

Elementy robocze można również utworzyć, wybierając pozycję Nowy element roboczy i wprowadzając tytuł elementu roboczego. Zmiany wprowadzone w programie Visual Studio są odzwierciedlane w usłudze Azure Boards.

Następny krok