Dokumentacja metadanych usługi Azure Boards Analytics

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

Usługa Analytics zbiera wszystkie działania śledzenia pracy zdefiniowane i zaktualizowane za pośrednictwem usługi Azure Boards. Analiza przechowuje jako właściwości wszystkie pola śledzenia pracy, z wyjątkiem pól HTML/rich-text i History. Właściwości niestandardowe dla pól niestandardowych są automatycznie dodawane do usługi Analytics.

W tym artykule opisano większość właściwości, których można użyć do wygenerowania raportu analizy na potrzeby śledzenia pracy. Używasz kombinacji właściwości do filtrowania zapytania, agregowania danych lub tworzenia raportu. Te zapytania można uruchamiać bezpośrednio w przeglądarce. Aby dowiedzieć się więcej, zobacz Definiowanie podstawowych zapytań przy użyciu usługi OData Analytics. Jeśli dopiero zaczynasz korzystać ze śledzenia pracy i usługi Azure Boards, zalecamy zapoznanie się z następującymi artykułami:

Uwaga

Podano opisy jednostek, właściwości i wyliczonych typów obsługiwanych przez model danych analizy. Jest to wczesna wersja robocza. Prześlij opinię na temat obszarów, w których chcesz uzyskać więcej informacji. Aby wykonywać zapytania dotyczące modelu danych, zobacz Konstruowanie zapytań OData dla analizy.

Omówienie zestawów jednostek

Podczas wykonywania zapytań dotyczących analizy pod kątem danych śledzenia pracy użyj jednego z następujących typów jednostek lub zestawów jednostek.

  • Wykonywanie zapytań w WorkItems celu generowania raportów o stanie i zestawień
  • Wykonywanie zapytań WorkItemSnapshot w celu generowania trendu, postępu i tworzenia raportów

Użyj innych typów jednostek, takich jak Area, , ProjectIteration, Teamlub inne jednostki, aby filtrować dane lub wybierać właściwości do raportowania. Aby zapoznać się z podsumowaniem przykładowych raportów, zobacz Przykładowe raporty i szybki indeks referencyjny.

Uwaga

Aby wygenerować raporty o stanie i trendach dotyczące typów elementów roboczych specyficznych dla testu, wykonaj zapytanie WorkItems dotyczące typów jednostek i WorkItemSnapshot i filtru na podstawie typu elementu roboczego. Aby uzyskać informacje na temat przebiegów testów, wyników testów lub innych danych testowych, wykonaj zapytanie dotyczące TestRunstypów jednostek , TestPoints, lub TestResultsDailyTestSuiteTestPointHistorySnapshot . Aby dowiedzieć się więcej, zobacz Dokumentacja metadanych testowych dla usługi Azure DevOps.

EntitySet EntityType opis
Obszary Obszar Ścieżki obszaru elementu roboczego z właściwościami grupowania i filtrowania według hierarchii obszarów.
Daty Daty kalendarza Daty używane do filtrowania i grupowania innych jednostek przy użyciu relacji.
Iteracji Iteracja Ścieżki iteracji elementu roboczego z właściwościami grupowania i filtrowania według hierarchii iteracji.
Tablicelokalizacyjne Lokalizacja tablicy Lokalizacje komórek tablicy Kanban, zidentyfikowane według kolumny tablicy, pływaka i podziału, obejmują historyczne ustawienia tablicy. Aby uzyskać opis każdego pola tablicy Kanban, zobacz Pola tablicy Przepływ pracy i Kanban.
Procesy Proces Informacje dotyczące listy prac używane do rozwijania lub filtrowania elementów roboczych i typów elementów roboczych. Przykład, który używa procesów do filtrowania raportu, zobacz Przykładowy raport dotyczący śledzenia wymagań. Obsługiwane w przypadku usługi Analytics w wersji 2.0 lub nowszej.
Projekty Projekt Wszystkie projekty zdefiniowane dla organizacji (chmury) lub kolekcji projektów (lokalnie).
Tagi Tag Wszystkie tagi elementów roboczych dla każdego projektu. Przykład użycia tagów do filtrowania raportu można znaleźć w artykule Release burndown sample report (Przykładowy raport dotyczący wydań).
Zespoły Zespół Wszystkie zespoły zdefiniowane dla projektu. Przykład, który używa usługi Teams do filtrowania raportu, zobacz Dodawanie fragmentatora zespołu do raportu usługi Power BI.
Użytkownicy Użytkownik Informacje o użytkowniku używane do rozwijania lub filtrowania różnych właściwości elementu roboczego, na przykład Przypisane do, Utworzone przez.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza, w tym lokalizacji tablicy Kanban, używany do generowania raportów trendów. Aby zapoznać się z przykładowym raportem, zobacz przykładowy raport diagramu przepływu skumulowanego (CFD).
WorkItemLinks WorkItemLink Łącza między elementami roboczymi, na przykład Podrzędne, Nadrzędne i Powiązane. Zawiera tylko najnowszą wersję linków, bez historii. Hiperłącza nie są uwzględniane.
WorkItemRevisions WorkItemRevision Wszystkie historyczne poprawki elementów roboczych, w tym bieżąca poprawka. Nie obejmuje usuniętych elementów roboczych.
WorkItemSnapshot WorkItemSnapshot (Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza używany do obsługi raportowania trendów. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport dotyczący trendów błędów.
Elementy robocze Workitem Bieżący stan elementów roboczych. Służy do obsługi raportów o stanie. Aby zapoznać się z przykładowym raportem, zobacz Zbiorcze wartości podrzędnych elementów roboczych do nadrzędnego przykładowego raportu.
WorkItemTypeFields WorkItemTypeField Właściwości elementu roboczego dla każdego typu i procesu elementu roboczego. Służy do obsługi tworzenia raportów.

Informacje o migawkach

Istnieją dwa zestawy jednostek migawek śledzenia pracy: WorkItemSnapshot i WorkItemBoardSnapshot.

Migawka zawiera rekord wartości zdefiniowanych dla elementu roboczego każdego dnia. Rekord jest zapisywany w usłudze Analytics raz dziennie w tym samym czasie każdego dnia. Migawki są używane, gdy chcesz wygenerować raport trendu. Domyślnie wszystkie tabele migawek są modelowane jako codzienne tabele faktów migawek. Jeśli wykonasz zapytanie dotyczące zakresu czasu, otrzyma wartość dla każdego dnia. Zakresy czasu długiego powodują dużą liczbę rekordów. Jeśli nie potrzebujesz takiej wysokiej precyzji, możesz użyć cotygodniowych lub nawet miesięcznych migawek.

Aby dowiedzieć się więcej, zobacz Wytyczne dotyczące zapytań OData, Użyj cotygodniowych lub miesięcznych migawek dla zapytań trendów obejmujących długi czas.

Informacje o poprawkach elementów roboczych

Za każdym razem, gdy aktualizujesz element roboczy, system tworzy nową poprawkę i rejestruje tę akcję w System.RevisedDate polu, co ułatwia określenie filtru historii. Zmieniona data jest reprezentowana przez RevisedDate właściwości (DateTime) i RevisedDateSK (Int32). Aby uzyskać najlepszą wydajność, użyj klucza zastępczego drugiej daty. Reprezentuje datę utworzenia poprawki lub ma wartość null dla aktywnych lub niekompletnych poprawek.

Jeśli chcesz, aby wszystkie daty od włącznie {startDate} , dodaj następujący filtr do zapytania.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Zestaw jednostek służy WorkItemRevisions do ładowania wszystkich poprawek dla danego elementu roboczego. Zapytanie zwraca wszystkie historyczne poprawki elementów roboczych, w tym bieżącą wersję, dla filtrów elementów roboczych. Nie zawiera usuniętych elementów roboczych.

Właściwości udostępnione w kilku typach jednostek

Właściwości, które można wybrać w widoku Analiza, odpowiadają zwykłym polam śledzenia pracy i wybierz właściwości analizy, takie jak dni cyklu i dni realizacji. Te właściwości, z których większość jest wymieniona i opisana w poniższej tabeli, są definiowane dla następujących typów jednostek, chyba że określono inaczej.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Uwaga

Usługa Analiza nie przechowuje żadnych danych dla długich pól tekstowych przypisanych do typu danych HTML ani tekstu sformatowanego. Obejmuje to pola Opis i Historia. Analiza nie przechowuje linków ani dołączonych plików. Aby uzyskać pełną listę pól zdefiniowanych w domyślnych szablonach procesów, zobacz Indeks pola elementu roboczego. Opisy poszczególnych typów danych można znaleźć w temacie Query fields, operators, and macros (Pola zapytań, operatory i makra).
Nie wszystkie właściwości skojarzone z polami specyficznymi dla procesu Scrum i CMMI znajdują się w poniższej tabeli. Aby uzyskać listę tych pól, zobacz Opisy pól domyślnych i pól elementów roboczych używanych w szablonach procesów, Pola używane do śledzenia elementów roboczych CMMI.

Wiele właściwości jest opartych na datach lub użytkownikach. Te właściwości są skojarzone z zestawami jednostek CalendarDate i User opisanymi w temacie Data kalendarza, Projekt i Dokumentacja metadanych użytkownika.

Nazwa wyświetlana
Property name
Typ danych Opis
Reference name
Zaakceptowane przez
Microsoft_VSTS_CodeReview_AcceptedBy
UserSK Nazwisko osoby, która odpowiedziała na przegląd kodu. (Proces CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Zaakceptowana data
AcceptedDate
DateTime Data i godzina odpowiedzi osoby na przegląd kodu. (Proces CMMI)
Microsoft.VSTS.CodeReview.AcceptedDate
Aktywowane przez
ActivatedBy
ActivatedByUserSK
UserSK Nazwa członka zespołu, który aktywował lub uaktywnił ponownie element roboczy.
Microsoft.VSTS.Common.ActivatedBy
Data aktywacji
ActivatedDate
DateTime Data i godzina aktywowania lub ponownego aktywowania usterki lub elementu roboczego przez członka zespołu.
Microsoft.VSTS.CodeReview.ActivatedDate
Activity
Activity
String Typ działania wymaganego do wykonania zadania.
Microsoft.VSTS.Common.Activity

Typ działania lub dyscypliny przypisanej do zadania. Dozwolone wartości to: Wdrażanie, projektowanie, programowanie, dokumentacja, wymagania i testowanie. (Proces Agile, Scrum i Podstawowy)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Dane i czas ostatniej aktualizacji jednostki.
Typ aplikacji String Typ aplikacji, nad którą osoby biorące udział w projekcie będą przekazywać opinie. Wartości domyślne to Aplikacja internetowa, Maszyna zdalna i Aplikacja kliencka. Prawidłowe typy są określone w pliku konfiguracji procesu dla projektów korzystających z lokalnego procesu XML.
Microsoft_VSTS_Feedback_ApplicationType
Ścieżka obszaru
AreaPath
AreaSK
String Grupuje elementy robocze w obszary funkcji produktu lub zespołu. Obszar musi być prawidłowym węzłem w hierarchii projektu.
System.AreaPath
Przypisane do
AssignedTo
AssignedToUserSK
UserSK Nazwa członka zespołu, który jest obecnie właścicielem elementu roboczego.
System.AssignedTo
Identyfikator testu zautomatyzowanego
AutomatedTestId
String Identyfikator testu, który automatyzuje przypadek testowy.
Microsoft.VSTS.TCM.AutomatedTestId
Nazwa testu zautomatyzowanego
AutomatedTestName
String Nazwa członka zespołu, który aktywował lub uaktywnił ponownie element roboczy.
Microsoft.VSTS.TCM.AutomatedTestName
Magazyn testów automatycznych
AutomatedTestStorage
String Zestaw zawierający test, który automatyzuje przypadek testowy.
Microsoft.VSTS.TCM.AutomatedTestStorage
Typ testu zautomatyzowanego
AutomatedTestType
String Typ testu, który automatyzuje przypadek testowy.
Microsoft.VSTS.TCM.AutomatedTestType
Stan automatyzacji
AutomatedStatus
String Stan przypadku testowego z następującymi akceptowanymi wartościami: Automated, Not Automated lub Planned.
Microsoft.VSTS.TCM.AutomationStatus
Priorytet listy prac
BacklogPriority
Liczba rzeczywista Liczba przypisana przez proces w tle systemu używany do stosu rangi lub śledzenia sekwencji elementów na liście prac lub tablicy. (Proces Scrum)
Microsoft.VSTS.Common.BacklogPriority
Zablokowane
Blocked
String Wskazuje, że nie można wykonać dalszej pracy na elemencie roboczym. Prawidłowe wartości to Tak lub Nie. (Proces CMMI)
Microsoft.VSTS.CMMI.Blocked
Wartość biznesowa
BusinessValue
Liczba rzeczywista Subiektywna jednostka miary, która przechwytuje względną wartość biznesową elementu lub funkcji listy prac produktu w porównaniu z innymi elementami tego samego typu. Element, który ma przypisaną wyższą liczbę, powinien być traktowany jako o większej wartości biznesowej niż element, któremu przypisano niższą liczbę.
Microsoft.VSTS.Common.BusinessValue
Zmienione przez
ChangedBy
ChangedByUserSK
UserSK Nazwisko osoby, która ostatnio zmodyfikowała element roboczy.
System.ChangedBy
Zmieniono datę
ChangedDate
DateTime Data i godzina modyfikacji elementu roboczego.
System.ChangedDate
ChangedDateSK Int32 Data modyfikacji elementu roboczego, wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
ChangedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty modyfikacji elementu roboczego w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Zamknięte przez
ClosedBy
ClosedByUserSK
UserSK Nazwisko osoby, która zamknęła element roboczy.
Microsoft.VSTS.Common.ClosedBy
Data zamknięcia
ClosedDate
ClosedDateSK
ClosedOn
DateTime Data i godzina zamknięcia elementu roboczego.
Microsoft.VSTS.Common.ClosedDate
Liczba komentarzy
CommentCount
Int32 Liczba komentarzy dodanych do sekcji Dyskusja elementu roboczego.
System.CommentCount
Popełnione
Committed
String Wskazuje, czy wymaganie zostało zatwierdzone w projekcie. Prawidłowe wartości to Tak lub Nie. (Proces CMMI)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Data właściwości nawigacji przechwycona przez usługę Analytics, która przechowuje, gdy element roboczy wprowadził stan przepływu pracy skojarzony z kategorią Ukończony stan przepływu pracy.
CompletedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty wprowadzenia elementu roboczego stanu przepływu pracy skojarzonego z kategorią Stan ukończonego przepływu pracy w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Ukończono pracę
CompletedWork
Liczba rzeczywista Miara ilości pracy wydanej na zadanie.
Microsoft.VSTS.Scheduling.CompletedWork
Utworzone przez
CreatedBy
CreatedByUserSK
UserSK Nazwisko osoby, która utworzyła element roboczy.
Microsoft.VSTS.Common.CreatedBy
Data utworzenia
CreatedDate
CreatedDateSK
DateTime Data utworzenia elementu roboczego wyrażona w strefie czasowej zdefiniowanej dla organizacji. Często używane do filtrowania i wyświetlania.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Data utworzenia elementu roboczego, wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
CreatedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty utworzenia elementu roboczego w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Czas cyklu dni
CycleTimeDays
Liczba rzeczywista Czas cyklu jest obliczany od pierwszego wprowadzenia kategorii Stanu w toku lub Rozwiązano , aby wprowadzić kategorię Ukończono stan. Aby dowiedzieć się więcej, zobacz Widżety Czas realizacji i Czas cyklu.
Dyscypliny
Discipline
String Typ działania lub dyscypliny przypisanej do zadania. Dozwolone wartości to: Analysis*, Development, Test, User Education i User Experience. (Proces CMMI)
Microsoft.VSTS.Common.Activity
Data ukończenia
DueDate
DateTime Prognozowana data ukończenia, do której zostanie rozwiązany problem lub element roboczy. (Proces Agile)
Microsoft.VSTS.Scheduling.DueDate
Wysiłku
Effort
Liczba rzeczywista Oszacowanie ilości pracy wymaganej do wdrożenia elementu listy prac produktu (procesu Scrum) lub problemu (proces podstawowy).
Microsoft.VSTS.Scheduling.Effort
Data zakończenia
FinishDate
DateTime Data i godzina, kiedy harmonogram wskazuje, że element roboczy zostanie ukończony.
Microsoft.VSTS.Scheduling.FinishDate
Znaleziono w
FoundIn
String Numer kompilacji produktu, znany również jako poprawka, w której znaleziono usterkę.
Microsoft.VSTS.Build.FoundIn
Data ruchu przychodzącego
InProgressDate
DateTime Data przechowywana w analizie, która przechwytuje datę i godzinę przeniesienia elementu roboczego do kategorii Stanw toku .
InProgressDateSK Int32 Data przeniesienia elementu roboczego do kategorii Stan , która należy do kategorii stanu W toku , wyrażona jako YYYYMMDD w strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
Kompilacja integracji
IntegrationBuild
String Numer kompilacji produktu, który zawiera kod lub naprawia usterkę.
Microsoft.VSTS.Build.IntegrationBuild
Jest aktualne
IsCurrent
Wartość logiczna Obsługuje filtrowanie danych w celu wyświetlenia najnowszej migawki filtrowanego zestawu elementów roboczych przez ustawienie wartości na True.
Prawidłowe dla tych typów jednostek: WorkItemRevision, WorkItemBoardSnapshoti BoardLocation.
Jest ostatnią wersją dnia
IsLastRevisionOfDay
Wartość logiczna Wskazuje, że migawka reprezentuje ostatnią wersję dnia, gdy ustawiono wartość True.
Jest ostatnią wersją okresu
IsLastRevisionOfPeriod
Wartość logiczna Wskazuje, że migawka reprezentuje ostatnią wersję okresu, gdy ustawiono wartość True.
Problem
Issue
String Wskazuje, że krok udostępniony jest skojarzony z oczekiwanym wynikiem. Dozwolone wartości to Tak i Nie.
Microsoft.VSTS.Common.Issue
Dni realizacji
LeadTimeDays
Liczba rzeczywista Czas realizacji jest obliczany na podstawie tworzenia elementu roboczego lub wprowadzania kategorii Stanu proponowanego do wprowadzania kategorii Stanu ukończonego. Aby dowiedzieć się więcej, zobacz Widżety Czas realizacji i Czas cyklu.
Oryginalne oszacowanie
OriginalEstimate
Liczba rzeczywista Miara ilości pracy wymaganej do wykonania zadania.
Microsoft.VSTS.Scheduling.OriginalEstimate
Identyfikator nadrzędnego elementu roboczego
ParentWorkItemId
Int32 Unikatowy identyfikator identyfikujący element roboczy połączony z elementem nadrzędnym. Przydatne do generowania raportów zestawień. Pole Nadrzędne jest dostępne w usłudze Azure DevOps Server 2020 i nowszych wersjach. Prawidłowe dla tych typów jednostek: WorkItemRevision i WorkItem.
System.Parent
Priorytet
Priority
Int32 Subiektywna ocena usterki, problemu, zadania lub przypadku testowego w odniesieniu do firmy. Wartości obejmują: - 1, 2 lub 3.
Microsoft.VSTS.Common.Priority
Nazwa projektu
ProjectName
Nawigacja Nazwa projektu, do którego należy element roboczy. Aby uzyskać szczegółowe informacje, zobacz Informacje o dacie kalendarza, projekcie i metadanych użytkownika, właściwościach projektu.
System.TeamProject
ProjectSK Identyfikator GUID Identyfikator GUID przypisany do projektu, do którego należy element roboczy.
Rating
Reason
String Liczba gwiazdek, które element otrzymuje od recenzenta w systemie klasyfikacji opartej na gwiazdce. (Odpowiedź na opinie) Liczba jest przechowywana w systemie i zapisywana w następujący sposób: - 0 - Not Rated, 1 - Poor, 2 - Fair, 3 - Good, 4 - Very Good, and 5 - Excellent. Prawidłowe dla tych typów jednostek: WorkItemRevision i WorkItem.
Microsoft.VSTS.Common.Rating
Przyczyna
Reason
String Przyczyna, dla którego element roboczy jest w bieżącym stanie. Każde przejście z jednego stanu przepływu pracy do innego jest skojarzone z odpowiednią przyczyną.
System.Reason
Praca pozostała
RemainingWork
Liczba rzeczywista Miara ilości pracy, która pozostaje do zakończenia zadania.
Microsoft.VSTS.Scheduling.RemainingWork
Rozwiązane przez
ResolvedBy
ResolvedByUserSK
UserSK Nazwa członka zespołu, który rozwiązał usterkę lub historię użytkownika.
Microsoft.VSTS.Common.ResolvedBy
Data rozwiązania
ResolvedDate
DateTime Data i godzina rozwiązania usterki lub historii użytkownika.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Data rozwiązania elementu roboczego wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
ResolvedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty rozwiązania elementu roboczego w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Rozwiązano przyczynę
ResolvedReason
String Przyczyna rozwiązania usterki (na przykład została usunięta).
Microsoft.VSTS.Common.ResolvedReason
— Zmiana
Revision
Int32 Liczba przypisana do historycznej poprawki elementu roboczego.
System.Rev
Data skorygowania
RevisedDate
DateTime Data i godzina modyfikacji lub zaktualizowania elementu roboczego.
RevisedDateSK Int32 Data zmiany elementu roboczego, wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
RevisedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty zmiany elementu roboczego w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Ryzyko
Risk
Liczba rzeczywista Subiektywna ocena względnej niepewności co do pomyślnego ukończenia historii użytkownika. Prawidłowe wartości to: 1 — Wysoki, 2 — Średni i 3 — Niski.
Microsoft.VSTS.Common.Risk
Ważność
Severity
Liczba rzeczywista Subiektywna ocena wpływu usterki, problemu lub ryzyka na projekt. Prawidłowe wartości to: 1 — Krytyczne, 2 — Wysokie, 3 — Średni i 4 — Niski.
Microsoft.VSTS.Common.Severity
Rozmiar
Size
Liczba rzeczywista Szacowanie ilości pracy wymaganej przez proces CMMI (wymaganie).
Microsoft.VSTS.Scheduling.Size
Ranga stosu
StackRank
Liczba rzeczywista Liczba przypisana przez proces w tle systemu używany do stosu rangi lub śledzenia sekwencji elementów na liście prac lub tablicy. (Procesy Agile, Scrum i Podstawowe)
Microsoft.VSTS.Common.StackRank
Data rozpoczęcia
StartDate
DateTime Data i godzina przypisana do elementu roboczego, aby rozpocząć pracę.
Microsoft.VSTS.Scheduling.StartDate
Województwo
State
String Bieżący stan elementu roboczego. Prawidłowe wartości stanu są specyficzne dla każdego typu elementu roboczego i dostosowań.
System.State
Kategoria stanu
StateCategory
String Kategorie stanów określają sposób, w jaki usługa Azure Boards i wybieranie widżetów pulpitu nawigacyjnego traktują każdy stan przepływu pracy. Kategorie stanów w użyciu to: Proponowane, W toku, Rozwiązane, Usunięte i Ukończone. Aby dowiedzieć się więcej, zobacz How to use workflow states and state categories (Jak używać stanów i kategorii stanu przepływu pracy). Prawidłowy tylko dla WorkItemRevision typu jednostki.
Data zmiany stanu
StateChangeDate
DateTime Data i godzina zmiany wartości pola Stan .
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Data zmiany stanu elementu roboczego, wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
StateChangeOn Nawigacja Właściwość nawigacji do Date jednostki dla daty zmiany stanu elementu roboczego w strefie czasowej zdefiniowanej dla organizacji. Często używane do odwołowania się do właściwości z Date jednostki w groupby instrukcjach.
Punkty historii
StoryPoints
Liczba rzeczywista Szacowanie ilości pracy wymaganej przez scenariusz użytkownika (proces Agile) jest zwykle agregowane jako suma.
Microsoft.VSTS.Scheduling.StoryPoints
Tagi
TagNames
String Rozdzielana średnikami lista tagów przypisanych do co najmniej jednego elementu roboczego na potrzeby filtrowania lub wykonywania zapytań.
System.Tags
Data docelowa
TargetDate
DateTime Prognozowana data ukończenia, według której problem lub inny element roboczy zostaną rozwiązane lub zakończone.
Microsoft.VSTS.Scheduling.TargetDate
Typ zestawu testów String Określa typ zestawu testów. Prawidłowe wartości to: Oparte na zapytaniach, Oparte na wymaganiach i Statyczne.
Microsoft_VSTS_TCM_TestSuiteType
Identyfikator typu zestawu testów Int64 Numer przypisany przez system odpowiadający kategorii zestawu testów i dotyczy tylko zestawów testów. Przypisane wartości to: 1 (statyczne), 2 (oparte na zapytaniach) i 3 (oparte na wymaganiach).
Microsoft_VSTS_TCM_TestSuiteTypeId
Krytyczne znaczenie czasu
TimeCriticality
Liczba rzeczywista Subiektywna jednostka miary, która przechwytuje, jak wartość biznesowa zmniejsza się w czasie. Wyższe wartości wskazują, że epika lub funkcja jest z natury bardziej krytyczna niż te elementy o niższych wartościach.
Microsoft.VSTS.Common.TimeCriticality
Tytuł
Title
String Krótki opis, który podsumowuje element roboczy i pomaga członkom zespołu odróżnić go od innych elementów roboczych na liście.
System.Title
Obszar wartości
ValueArea
String Obszar wartości klienta adresowany przez element epików, funkcji lub listy prac. Wartości obejmują: Architektura lub firma.
Microsoft.VSTS.Common.ValueArea
Znak wodny
Watermark
String Pole zarządzane przez system, które zwiększa się o zmiany wprowadzone w elemencie roboczym. Prawidłowe dla tych typów jednostek: WorkItemRevision i WorkItem.
System.Watermark
Identyfikator elementu roboczego
WorkItemId
Int32 Unikatowy identyfikator przypisany do elementu roboczego. Identyfikatory elementów roboczych są unikatowe we wszystkich projektach i w organizacji lub kolekcji projektów.
System.Id
WorkItemRevisionSK Int32 Unikatowy klucz analizy dla poprawki elementu roboczego, który jest używany przez narzędzia zewnętrzne do łączenia powiązanych jednostek.
Typ elementu roboczego
WorkItemType
String Nazwa typu elementu roboczego. Typy elementów roboczych są definiowane na podstawie procesu używanego podczas tworzenia projektu. Aby uzyskać więcej informacji, zobacz About processes and process templates (Informacje o procesach i szablonach procesów).
System.WorkItemType

Właściwości nawigacji w usłudze OData to atrybuty referencyjne jednostki wskazującej inną jednostkę. Poniższa tabela zawiera podsumowanie właściwości nawigacji, ich ograniczeń odwołań i typów jednostek, dla których są prawidłowe.

Display name Nazwa
Ograniczenie odwołań i właściwość
Prawidłowe dla typów jednostek
ChangedOn
ChangedDateSK, DateSK
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK
WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Obszary Area
AreaSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Lokalizacja tablicy WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iteracji Iteration
IterationSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Przypisane do AssignedTo
AssignedToUserSK, UserSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Zmienione przez ChangedBy
ChangedByUserSK, UserSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Utworzone przez CreatedBy
CreatedByUserSK, UserSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Aktywowane przez ActivatedBy
ActivatedByUserSK, UserSK
WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Zamknięte przez ClosedBy
ClosedBySK, UserSK
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Rozwiązane przez ResolvedBy
ResolvedByUserSK, UserSK
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Zespoły Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Tagi WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projekt Project
ProjectSK, ProjectSK
Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Procesy WorkItemRevision, WorkItem, WorkItemSnapshot
Poprawki WorkItem
Linki WorkItem
Dzieci WorkItem
Nadrzędny WorkItem
Elementy potomne WorkItem
Workitem WorkItemId WorkItemRevision

Przewidywanie funkcji

Następujące dwie funkcje są obsługiwane dla jednostki WorkItem . Te funkcje są używane w celu obsługi trendów predykcyjnych w przypadku wybierania wbudowanych raportów i widżetów analizy.

  • PredictTags
  • Predict

BoardLocation i WorkItemBoardSnapshot

Właściwości wymienione i opisane w poniższej tabeli są definiowane dla następujących typów jednostek, chyba że zostały określone. Za pomocą tych pól można filtrować dane elementów roboczych na podstawie stanu elementu roboczego w kolumnie tablicy Kanban zespołu, torów lub na poziomie listy prac.

  • BoardLocation
  • WorkItemBoardSnapshot

Aby zapoznać się z przykładem dotyczącym zestawu jednostek, zobacz przykładowy raport diagramu przepływu skumulowanego WorkItemBoardSnapshot (CFD).

Nazwa wyświetlana
Property name
Typ danych Opis
Reference name
Identyfikator tablicy
BoardId
Identyfikator GUID Unikatowy identyfikator GUID przypisany do tablicy Kanban. Każdy zespół jest skojarzony z co najmniej jedną tablicą Kanban.
Nazwa odwołania do kategorii tablicy
BoardCategoryReferenceName
String Nazwa przypisana do kategorii typów elementów roboczych używanych do wypełniania tablicy Kanban. Na przykład tablica listy prac produktu jest skojarzona z kategorią Wymagania. Aby dowiedzieć się więcej, zobacz Dostosowywanie listy prac lub tablic (proces dziedziczenia).
Nazwa tablicy
BoardName
String Nazwa przypisana do tablicy Kanban. Na przykład historie, elementy listy prac, funkcje i epiki.
Poziom tablicy
BoardLevel
Int32 Liczba przypisana do tablicy Kanban na podstawie miejsca, w którym znajduje się w hierarchii tablic Kanban.
Typ listy prac
BacklogType
String Nazwa typu listy prac. Na przykład iteracja, wymaganie lub portfolio.
Nazwa kolumny
ColumnName
String Nazwa kolumny tablicy Kanban, do której jest obecnie przypisany element roboczy, taki jak aktywna, zamknięta, zatwierdzona, zakończona lub inna niestandardowa etykieta kolumny.
System.BoardColumn
Kolejność kolumn
ColumnOrder
Int32 Liczba przypisana do kolumny tablicy Kanban pod względem jego sekwencji w tablicy Kanban.
Zrobić
Done
Enumerated Wskazuje lokalizację podzielonej kolumny. Prawidłowe wartości są wymienione poniżej dla tabeli BoardColumnSplit.
Limit elementów kolumny
ColumnItemLimit
Int32 Liczba przypisana do kolumny tablicy Kanban pod względem jego sekwencji.
Jest widoczna tablica
IsBoardVisible
Wartość logiczna Wskazuje, czy zespół wybrał, aby tablica stała się widoczna, czy nie.
Czy podział kolumny
IsColumnSplit
Wartość logiczna Wskazuje, czy kolumna została podzielona na kolumny Robi i Gotowe zgodnie z opisem w sekcji Podział kolumn na tablicy Kanban, aby pokazać pracę w toku.
Jest aktualne
IsCurrent
Wartość logiczna Właściwość obsługując filtrowanie danych w celu wyświetlenia najnowszej migawki filtrowanego zestawu elementów roboczych przez ustawienie wartości na True.
Jest domyślnym pasem ruchu
IsDefaultLane
Wartość logiczna Właściwość wskazująca, że element roboczy jest przypisany do domyślnego pływaka (True) lub nie (False).
Jest gotowe
IsDone
Wartość logiczna Bieżące przypisanie elementu roboczego do wykonywania (fałsz) lub Gotowe (prawda) w kolumnie Kanban. Przypisane tylko wtedy, gdy kolumny podzielone są włączone dla kolumny tablicy Kanban.
System.BoardColumnDone
Identyfikator pasa ruchu
LaneId
Identyfikator GUID Unikatowy identyfikator GUID przypisany do pasa pływania tablicy Kanban. Każdy zespół może dodać jeden lub więcej pasów pływania do tablicy Kanban. Aby dowiedzieć się więcej na temat pływaków, zobacz Speed up your team's work by using swimlanes in your Kanban board (Przyspieszanie pracy zespołu przy użyciu pływaków na tablicy Kanban).
Nazwa pasa ruchu
LaneName
String Nazwa przypisana do pływaka tablicy Kanban.
System.BoardLane
Kolejność pasa ruchu
LaneOrder
Int32 Liczba przypisana do pływaka tablicy Kanban pod względem jego sekwencji.

Wyliczone elementy członkowskie boardColumnSplit

W poniższej tabeli wymieniono nazwy elementów członkowskich dla wyliczonego BoardColumnSplit typu, który może służyć do filtrowania elementów roboczych w kolumnie Wykonywanie lub Gotowe .

Nazwa elementu członkowskiego Wartość Display name
Doing 0 Robi
Done 1 Gotowe
Unknown 2 Nieznany (nie podzielony)

Aby dowiedzieć się więcej o kolumnach tablic dla zespołu, zobacz następujące artykuły:

Obszary

Następujące właściwości są prawidłowe dla zestawu jednostek Obszary , który jest skojarzony z polem Ścieżka obszaru. Klucze zastępcze skojarzone z dołączanymi obszarami i ProjectSK.AreaSK Te właściwości umożliwiają filtrowanie lub raportowanie danych śledzenia pracy na podstawie przypisań ścieżki obszaru.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Number Int32 Wartość całkowita przypisana do węzła Ścieżka obszaru po jej utworzeniu.
Głębokość Depth Int32 Poziom, na którym zdefiniowano ścieżkę obszaru na podstawie jego głębokości z poziomu głównego.
Identyfikator obszaru AreaId Identyfikator GUID Unikatowy identyfikator przypisany do ścieżki obszaru po jej utworzeniu.
Poziom warstwy od 1 do
Poziom warstwy 14
AreaLevel1 Przez
AreaLevel14
String Nazwa skojarzona z poziomem węzła ścieżki obszaru. Obsługiwane są maksymalnie 14 poziomów zagnieżdżonych. Na przykład poziom warstwy 1 zawsze odpowiada węzłowi głównemu i nazwie projektu.
Nazwa obszaru AreaName String Nazwa zdefiniowana dla ścieżki obszaru po jej utworzeniu.
Ścieżka obszaru AreaPath String Pełna ścieżka ścieżki obszaru rozpoczynająca się od węzła głównego.

Ważne

Usunięcie ścieżek obszaru lub ponowne skonfigurowanie ścieżek iteracji może spowodować utratę danych i nie można ich przywrócić. Na przykład wykresy ze spalonymi lub wypalonymi widżetami, spaleniem przebiegu i wykresami prędkości dla zespołów, których ścieżki warstwowe są zmieniane, nie będą odzwierciedlać poprawnych danych. Historyczne wykresy trendów odwołują się do ścieżki obszaru i ścieżki iteracji zgodnie z definicją w przeszłości dla każdego elementu roboczego. Po usunięciu ścieżki obszaru lub ścieżki iteracji nie można pobrać danych historycznych.

Właściwości nawigacji dla typu jednostki Obszar i zestawu jednostek Obszary obejmują Project i Teams.

Aby dowiedzieć się więcej o ścieżkach obszaru, zobacz następujące artykuły:

Iteracje

Następujące właściwości są prawidłowe dla zestawu jednostek Iteracji , który jest skojarzony z polem Ścieżka iteracji. Klucze zastępcze skojarzone z iteracji obejmują IterationSK i ProjectSK. Te właściwości umożliwiają filtrowanie lub raportowanie danych śledzenia pracy na podstawie przypisań ścieżki iteracji.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Number Int32 Wartość całkowita przypisana do węzła Ścieżka iteracji po jej utworzeniu.
Głębokość Depth Int32 Poziom, na którym zdefiniowano ścieżkę iteracji na podstawie jego głębokości z poziomu głównego.
Data zakończenia EndDate DateTime Data zakończenia zdefiniowana dla ścieżki iteracji.
IsEnded IsEnded Wartość logiczna Po ustawieniu wartości True oznacza, że data zakończenia ścieżki iteracji przypada w przeszłości.
Identyfikator iteracji IterationId Identyfikator GUID Unikatowy identyfikator przypisany do ścieżki iteracji po jej utworzeniu.
Poziom iteracji od 1 do
Poziom iteracji 14
IterationLevel1 Przez
IterationLevel14
String Nazwa skojarzona z poziomem węzła ścieżki iteracji. Obsługiwane są maksymalnie 14 poziomów zagnieżdżonych. Na przykład poziom iteracji 1 zawsze odpowiada węzłowi głównemu i nazwie projektu.
Nazwa iteracji IterationName String Nazwa zdefiniowana dla ścieżki iteracji po jej utworzeniu.
Ścieżka iteracji IterationPath String Pełna ścieżka ścieżki iteracji rozpoczynająca się od węzła głównego. Iteracja musi być prawidłowym węzłem w hierarchii projektu.
System.IterationPath
Data rozpoczęcia StartDate DateTime Data rozpoczęcia zdefiniowana dla ścieżki iteracji.

Ważne

Usunięcie ścieżek obszaru lub ponowne skonfigurowanie ścieżek iteracji może spowodować utratę danych i nie można ich przywrócić. Na przykład wykresy ze spalonymi lub wypalonymi widżetami, spaleniem przebiegu i wykresami prędkości dla zespołów, których ścieżki warstwowe są zmieniane, nie będą odzwierciedlać poprawnych danych. Historyczne wykresy trendów odwołują się do ścieżki obszaru i ścieżki iteracji zgodnie z definicją w przeszłości dla każdego elementu roboczego. Po usunięciu ścieżki obszaru lub ścieżki iteracji nie można pobrać danych historycznych.

Właściwości nawigacji dla typu jednostki iteracji i zestawu jednostek Iteracji obejmują Project i Teams.

Aby dowiedzieć się więcej na temat ścieżek iteracji, zobacz następujące artykuły:

Procesy

Następujące właściwości są prawidłowe dla typu jednostki Proces i zestawu jednostek Procesy . Klucze zastępcze skojarzone z procesem obejmują ProcessSK, ProjectSKi TeamSK. Te właściwości umożliwiają filtrowanie lub raportowanie danych śledzenia pracy na podstawie typów elementów roboczych używanych przez projekt lub zespół.

Uwaga

Typ jednostki Proces i zestaw jednostek Procesy są obsługiwane w wersjach v-2.0, v3.0-preview i v4.0-preview usługi Analytics.

Za pomocą tych właściwości można filtrować dane śledzenia pracy na podstawie poziomu listy prac

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
ProjectSK Identyfikator GUID Klucz projektu skojarzony z procesem.
TeamSK Identyfikator GUID Klucz zespołu skojarzony z procesem.
Nazwa odwołania do kategorii listy prac BacklogCategoryReferenceName String Nazwa odwołania do kategorii przypisana do listy prac skojarzonej z typem elementu roboczego. Przykłady obejmują Microsoft.EpicCategory, , Microsoft.RequirementCategoryMicrosoft.FeatureCategory, . Microsoft.TaskCategory
Nazwa listy prac BacklogName Wartość logiczna Nazwa odwołania przypisana do listy prac skojarzonej z typem elementu roboczego
Typ listy prac BacklogType Identyfikator GUID Unikatowy identyfikator przypisany do ścieżki iteracji po jej utworzeniu.
Poziom listy prac BacklogLevel String Określa poziom listy prac skojarzony z typem elementu roboczego. Jeśli typ elementu roboczego nie jest skojarzony z poziomem listy prac, zwracana wartość to null.
Typ elementu roboczego WorkItemType String Nazwa zdefiniowana dla typu elementu roboczego.
Ma listę prac HasBacklog String Wskazuje, czy typ elementu roboczego należy do listy prac.
Jest typem ukrytym IsHiddenType Wartość logiczna Wskazuje, czy typ elementu roboczego został wyłączony.
Jest typem usterki IsBugType Wartość logiczna Wskazuje, czy typ elementu roboczego należy do kategorii Usterka.
Jest usuwany IsDeleted Wartość logiczna Wskazuje, czy typ elementu roboczego został usunięty.

Aby dowiedzieć się więcej o listach prac procesu i typach elementów roboczych, zobacz następujące artykuły:

Niestandardowe typy elementów roboczych i niestandardowe kategorie listy prac

Dane niestandardowych typów elementów roboczych są automatycznie dodawane do usługi Analytics.

Kategoria niestandardowa jest tworzona po zdefiniowaniu niestandardowego typu elementu roboczego i poziomu listy prac. Custom_ jest poprzedzany identyfikatorem GUID kategorii. Na przykład w przypadku niestandardowego typu elementu roboczego Portfolio z listą prac Portfolio identyfikator GUID jest przypisywany do kategorii niestandardowej, takiej jak Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

Tagi

Następujące właściwości są prawidłowe dla zestawu jednostek Tagi . Klucze zastępcze skojarzone z tagami include TagSK i ProjectSK. Właściwości nawigacji obejmują Project i jego ograniczenie ProjectSKodwołań. Aby dowiedzieć się więcej na temat używania tagów, zobacz Dodawanie tagów elementów roboczych w celu kategoryzowania i filtrowania list i tablic.

Tych właściwości można użyć do filtrowania lub raportowania danych śledzenia pracy.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Identyfikator tagu TagId Identyfikator GUID Unikatowy identyfikator przypisany do tagu podczas jego tworzenia.
Nazwa tagu TagName String Nazwa tagu.

Zespoły

Następujące właściwości są prawidłowe dla typu jednostki Team i zestawu jednostek usługi Teams . Klucze zastępcze skojarzone z usługą Team include TeamSK i ProjectSK. Tych właściwości można użyć do filtrowania lub raportowania danych śledzenia pracy na podstawie przypisań zespołu. Aby uzyskać informacje na temat używania i dodawania zespołów, zobacz About teams and Agile tools (Informacje o zespołach i narzędziach Agile) oraz Create or add a team (Tworzenie lub dodawanie zespołu).

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Identyfikator zespołu TeamId Identyfikator GUID Unikatowy identyfikator przypisany do zespołu podczas jego tworzenia.
Nazwa zespołu TeamName String Nazwa zespołu.

Właściwości nawigacji dla zestawu jednostek usługi Teams obejmują Projects, Areasi Iterations.

Następujące właściwości są prawidłowe dla zestawu jednostek WorkItemLinks . Klucz zastępczy odwołania do właściwości to WorkItemLinkSK. Wykonywanie zapytań względem elementu WorkItemLinks w celu raportowania elementów nadrzędnych/podrzędnych, powiązanych, poprzednika/następnika lub innych typów linków.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
WorkItemLinkSK Int32 Klucz zastępczy przypisany do WorkItemLink jednostki.
Data utworzenia CreatedDate Identyfikator GUID Data utworzenia linku.
Komentarz Comment String Komentarz dodany podczas tworzenia linku.
Data usunięcia DeletedDate String Data usunięcia linku.
Identyfikator typu łącza LinkTypeId Int32 Identyfikator przypisany do docelowego elementu roboczego połączonego.
Nazwa typu łącza LinkTypeName String Przyjazna nazwa przypisana do typu linku.
Nazwa odwołania typu łącza LinkTypeReferenceName String Nazwa odwołania przypisana do typu łącza.
Typ łącza to Acykliczne LinkTypeIsAcyclic Wartość logiczna Wartość atrybutu typu łącza wskazująca typ łącza umożliwia relacje cykliczne, gdy wartość jest ustawiona na True. Na przykład linki typu drzewa ograniczają relacje cykliczne.
Typ łącza to kierunek LinkTypeIsDirectional Wartość logiczna Wartość atrybutu typu łącza wskazująca typ łącza jest kierunkowy. Typy łączy kierunkowych są definiowane w parach ze składnikiem do przodu i odwrotnym.
Identyfikator elementu roboczego źródła SourceWorkItemId Int32 Identyfikator przypisany do źródłowego elementu roboczego połączonego.
Identyfikator docelowego elementu roboczego TargetWorkItemId Int32 Identyfikator przypisany do docelowego elementu roboczego połączonego.

Właściwości nawigacji dla typu jednostki WorkItemLink obejmują Projects, SourceWorkItemi TargetWorkItem.

Aby dowiedzieć się więcej o linkach i typach linków, zobacz następujące artykuły:

WorkItemTypeFields

Następujące właściwości są prawidłowe dla zestawu jednostek WorkItemTypeFields . Klucze odwołania do właściwości to FieldName, ProjectSKi WorkItemType.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Nazwa pola FieldName String Przyjazna nazwa przypisana do pola przez system lub po jego utworzeniu.
Nazwa odwołania do pola FieldReferenceName String Nazwa odwołania przypisana do pola przez system lub po utworzeniu pola niestandardowego.
Typ pola FieldType String Typ danych przypisany do pola.
Typ elementu roboczego WorkItemType String Nazwa typów elementów roboczych, dla których zdefiniowano pole.

Właściwości nawigacji obejmują .Project

Aby uzyskać indeks wszystkich pól zdefiniowanych dla projektu, zobacz Opisy pól dla pól elementów roboczych. Aby uzyskać więcej informacji, zobacz następujące artykuły:

Właściwości niestandardowe

Pola niestandardowe są automatycznie dodawane do usługi Analytics jako właściwość niestandardowa. Custom_ lub Custom. jest poprzedzana nazwą właściwości. Sprawdź metadane kolekcji zgodnie z opisem w artykule Konstruowanie zapytań OData dla analizy, składników adresu URL w celu wykonywania zapytań dotyczących metadanych. W poniższym przykładzie przedstawiono składnię metadanych dla pola niestandardowego Ryzyko szansy sprzedaży.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>