Udostępnij przez


Wykonywanie zapytań o elementy robocze według linku lub liczby załączników

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

Połącz elementy robocze, aby śledzić powiązaną pracę i zależności oraz dołączać pliki, aby udostępniać informacje zespołowi. Wykonywanie zapytań względem elementów roboczych przy użyciu następujących pól:

  • Liczba dołączonych plików
  • (Dyskusja) Liczba komentarzy
  • Liczba linków zewnętrznych
  • Liczba hiperłączy
  • Komentarz do linka
  • Liczba linków pokrewnych
  • Liczba linków zdalnych
  • Liczba dołączonych plików
  • (Dyskusja) Liczba komentarzy
  • Liczba linków zewnętrznych
  • Liczba hiperłączy
  • Komentarz do linka
  • Liczba linków pokrewnych

Aby uzyskać szczegółowe opisy pól, zobacz Pola skojarzone z linkami i załącznikami.

Warunki wstępne

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

Uwaga

Użytkownicy z dostępem Uczestnik projektu dla projektu publicznego mają pełny dostęp do funkcji zapytań, takich jak użytkownicy z dostępem Basic. Aby uzyskać więcej informacji, zobacz Podręczny przewodnik po dostępie dla interesariuszy.

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 Podstawowy dostęp.
uprawnienia uprawnienia Współtworzenie ustawione na Zezwalaj dla folderu, do którego chcesz dodać zapytanie. Domyślnie grupa współautorów nie ma tego uprawnienia.

Obsługiwane operatory i makra

Użyj następujących operatorów dla klauzul, które określają pole liczby całkowitej:

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

Wyświetlanie listy elementów hierarchicznych w widoku drzewa

Utwórz zapytanie i wybierz pozycję Drzewo elementów roboczych , aby rozpocząć. Edytor zapytań przedstawia następujące przykłady:

Uwaga

Nie można skonstruować zapytania, które pokazuje hierarchiczny widok planów testów, zestawów testów i przypadków testowych, ponieważ te elementy nie łączą się ze sobą przy użyciu typów łączy nadrzędny-podrzędny. Użyj zapytania linków bezpośrednich, aby wyświetlić listę elementów roboczych związanych z testami lub wyświetlić hierarchię na stronie Plany testów.

Opcje filtrów i klauzul zapytania

Zmień opcje filtrowania połączonych elementów roboczych i dodaj klauzule zapytania, używając opcji w Edytorze zapytań.

Filtruj według

Uwzględnij te klauzule zapytania

Tylko elementy podrzędne elementu roboczego 645

Dodaj filtry do elementów roboczych najwyższego poziomu:
ID = 645

Zadania lub usterki

Dodaj do filtrów dla połączonych elementów roboczych:
Work Item Type In Task,Bug

Elementy przypisane do mojego zespołu (sieć Web)

Dodaj do filtrów u góry i dolnej:
Assigned to In Group [Fabrikam Fiber]\Web

Nadrzędne elementy zadań przydzielonych mi

Zmień opcje filtru na Najpierw dopasuj połączone elementy robocze
Dodaj do filtrów dla połączonych elementów roboczych:
Assigned To = @Me

Wyświetlanie listy elementów opartych na połączonych zależnościach

W poniższym przykładzie pokazano zależne zapytanie powiązane, które zwraca elementy mające zależności od pracy zarządzanej przez inne zespoły i projekty.

Poniższe zapytanie wyszukuje elementy robocze we wszystkich projektach, które są powiązane z elementami roboczymi w ramach ścieżki obszaru Fabrikam i projektu przy użyciu typów łączy Poprzednik i Następca.

Zrzut ekranu przedstawiający zapytanie linków bezpośrednich w portalu internetowym.

  • Wybierz Zapytanie między projektami, aby uwzględnić zależne powiązane elementy robocze z innych projektów.
  • Dodaj klauzulę Ścieżka obszaru w obszarze Fabrikam , aby filtrować elementy robocze, które łączą się z elementami zdefiniowanymi w projekcie Fabrikam.
  • Wybierz Tylko elementy, które mają pasujące linki, a następnie wybierz Zwróć wybrane typy łączy, aby zwrócić tylko elementy robocze połączone jako poprzednik lub następnik.

Lista osieroconych historii użytkowników

Jeśli organizujesz scenariusze użytkowników w ramach funkcji, szybko znajdź nieprzypisane scenariusze, wykonując jedną z następujących czynności:

  1. Otwórz listę prac produktu i włącz opcję Rodzice w widoku.
  2. Przewiń do sekcji Unparented Stories (Agile) lub Unparented Backlog items (Scrum).

Zrzut ekranu przedstawiający listę prac produktu z nieprzypisanymi historiami.

Możesz też znaleźć elementy rejestru zadań bez przypisanego nadrzędnego przy użyciu zapytania elementy robocze i bezpośrednie linki. Na przykład poniższe zapytanie zawiera listę aktywnych historii użytkowników dla zespołu usługi Azure DevOps, który nie ma linku nadrzędnego.

Zrzut ekranu przedstawiający Edytor zapytań dla nieparzyszonych historii użytkowników w portalu internetowym.

W poniższej tabeli opisano pola skojarzone z linkami i załącznikami. Większość tych pól nie jest wyświetlana w formularzu elementu roboczego, ale jest śledzona dla wszystkich typów elementów roboczych.

Liczba dołączonych plików

Liczba plików dołączonych do elementu roboczego i przechowywanych w bazie danych śledzenia elementów roboczych.
Nazwa odwołania=System.AttachedFileCount, Typ danych=Liczba całkowita

Uwaga

W przypadku usługi Azure Boards (usługa w chmurze) można dodać do 100 załączników do elementu roboczego. Podjęcie próby dodania większej liczby elementów skutkuje pojawieniem się komunikatu o błędzie podczas zapisywania elementu roboczego.

Liczba komentarzy

Liczba komentarzy dodanych do sekcji Dyskusja elementu roboczego.
Nazwa odwołania=System.CommentCount, Typ danych=Liczba całkowita

Liczba linków zewnętrznych

Liczba łączy z elementu roboczego do artefaktów, które nie są elementami roboczymi, takimi jak żądania ściągnięcia, zatwierdzenia, zestawy zmian lub inne typy łączy.
Nazwa odwołania=System.ExternalLinkCount, Typ danych=Liczba całkowita

Liczba hiperłączy

Liczba hiperlinków zawartych w elemencie roboczym.

Nazwa odwołania=System.HyperLinkCount, Typ danych=Liczba całkowita

Komentarz do linku

Zawiera komentarze od członka zespołu, który utworzył link. To pole można skonfigurować tak, aby było wyświetlane jako kolumna na liście łączy w formularzu elementu roboczego. (Edytor zapytań nie obsługuje tego pola).

Nazwa=System.Links.Comment odwołania, Typ danych= Zwykły tekst

Opis łącza

Zawiera typ elementu roboczego, identyfikator i tytuł elementu roboczego, który jest elementem docelowym łącza. To pole można skonfigurować tak, aby było wyświetlane jako kolumna na liście łączy w formularzu elementu roboczego. (Edytor zapytań nie obsługuje tego pola).

Nazwa=System.Links.Description odwołania, Typ danych= Zwykły tekst

Rodzic

W przypadku uwzględnienia jako opcji kolumny w zaległościach lub na liście wyników zapytania system wyświetla tytuł elementu nadrzędnego zadania. Wewnętrznie system przechowuje ID elementu roboczego w polu typu Integer.

Uwaga

Możesz dodać pole Nadrzędne jako kolumnę lub określić je w klauzuli zapytania, podając identyfikator elementu roboczego nadrzędnego.
Nazwa odwołania=System.Parent, Typ danych=Liczba całkowita

Liczba linków pokrewnych

Liczba łączy zdefiniowanych dla elementu roboczego, wykorzystująca typy łączy takie jak Rodzic-Dziecko, Poprzednik-Następca i Powiązane. Aby uzyskać pełną listę, zobacz Odniesienie do typu linku.
Nazwa odwołania=System.RelatedLinkCount, Typ danych=Liczba całkowita

Liczba linków zdalnych

Dostępne tylko dla usług Azure DevOps Services. Liczba łączy z elementu roboczego do elementów roboczych zdefiniowanych w innej organizacji. Ten sam identyfikator Microsoft Entra musi zarządzać organizacjami. Obsługiwane typy linków obejmują konsumpcję z, produkowane dla i zdalnie powiązane. Aby uzyskać więcej informacji, zobacz, Dodaj link do elementów roboczych, Link do zdalnego elementu roboczego.
Nazwa odwołania=System.RemoteLinkCount, Typ danych=Liczba całkowita

Wyświetlanie powiązanych elementów roboczych i obiektów w elemencie roboczym przy użyciu rozszerzenia wizualizacji elementu roboczego dostępnego na karcie Visual Studio Marketplace i Azure DevOps.

Aby dodać typy linków, zobacz Zarządzanie typami linków [witadmin].

Wszystkie karty obsługujące tworzenie łączy między elementami roboczymi używają elementu LinksControl w formularzu elementu roboczego. Ten element zarządza filtrowaniem i ogranicza typy elementów roboczych, z którymi można się połączyć. Steruje również typami łączy, które można utworzyć i czy można łączyć elementy robocze w innym projekcie. Aby dostosować kontrolki i ograniczenia linków, zmodyfikuj definicję LinksControlOptions dla typu elementu roboczego; zobacz elementy XML LinksControlOptions.

Możesz dodawać lub usuwać kolumny z listy łączy, a także dostosować domyślne kolumny i kolejność kolumn. Aby uzyskać więcej informacji, zobacz elementy XML LinksControlOptions.