Udostępnij przez

Dokumentacja metadanych usługi Azure Boards Analytics

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

Usługa Analytics zbiera wszystkie definicje śledzenia pracy i działanie aktualizacji usługi Azure Boards. Zapytania analizy można uruchamiać bezpośrednio w przeglądarce i używać kombinacji właściwości do filtrowania zapytania, agregowania danych lub tworzenia raportu. Aby uzyskać więcej informacji, zobacz Definiowanie podstawowych zapytań przy użyciu usługi OData Analytics.

W tym artykule opisano większość właściwości, których można użyć do wygenerowania raportu analizy śledzenia pracy. Analiza przechowuje wszystkie pola śledzenia pracy jako właściwości z wyjątkiem pól HTML/rich-text i historii. Pola niestandardowe są automatycznie dodawane do usługi Analytics jako właściwości niestandardowe.

Uwaga

Ten artykuł zawiera opisy jednostek, właściwości i wyliczonych typów obsługiwanych przez model danych analizy. Aby wykonywać zapytania dotyczące modelu danych, zobacz Konstruowanie zapytań OData dla analizy.

Omówienie zestawów jednostek

Podczas wykonywania zapytań dotyczących analizy danych śledzenia pracy wykonaj zapytanie dotyczące jednostki WorkItems ustawionej w celu wygenerowania raportów o stanie i zestawień. Użyj jednostki WorkItemSnapshot , aby wygenerować trend, spalenie i spalić raporty.

Użyj innych typów jednostek, takich jak Area, Iteration, Project lub Team , aby filtrować dane lub wybierać właściwości do raportowania. Na przykład raporty można znaleźć w temacie Przykładowe raporty i szybki indeks referencyjny.

Uwaga

Aby wygenerować raporty o stanie i trendach na przebiegach testów, wynikach testów lub innych danych testowych, wykonaj zapytania dotyczące typów jednostek WorkItemSnapshot i filtru na podstawie typów jednostek TestRuns, TestPoints, TestResultsDaily, TestSuite lub TestPointHistorySistorySnapshot. Aby uzyskać więcej informacji, zobacz Test metadata reference for Azure DevOps (Dokumentacja metadanych testowych dla usługi Azure DevOps).

Zestaw encji Typ encji 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 elementów roboczych z właściwościami grupowania i filtrowania według hierarchii iteracji.
LokalizacjeZarządu Lokalizacja tablicy Lokalizacje komórek tablicy, zidentyfikowane przez kolumnę tablicy, pływak i podział, w tym ustawienia tablicy historycznej. Aby uzyskać opis każdego pola tablicy, zobacz Pola przepływu pracy i tablicy.
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 lub kolekcji projektów.
Tagi Znacznik 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.
Users Użytkownik Informacje o użytkowniku używane do rozszerzania lub filtrowania różnych właściwości elementu roboczego, na przykład Przypisane do lub Utworzone przez.
ZrzutTablicyElementówRoboczych ZrzutTablicyElementówRoboczych Typ jednostki złożonej opisujący stan każdego elementu roboczego w każdej dacie kalendarza, w tym lokalizacji tablicy. Służy do generowania raportów trendów. Aby zapoznać się z przykładowym raportem, zobacz przykładowy raport diagramu przepływu skumulowanego (CFD).
LinkiDoElementówPracy WorkItemLink Łącza między elementami roboczymi, na przykład Podrzędne, Nadrzędne i Powiązane. Zawiera tylko najnowszą wersję linków bez historii i nie zawiera hiperlinków.
WorkItemRevisions WorkItemRevision Wszystkie historyczne poprawki elementów roboczych, w tym bieżąca poprawka. Nie obejmuje usuniętych elementów roboczych.
WorkItemSnapshot WorkItemSnapshot Typ jednostki złożonej opisujący stan każdego elementu roboczego w każdej dacie kalendarza. Służy 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 zadaniowe Element roboczy 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 PoleTypuElementuRoboczego Właściwości elementu roboczego dla każdego typu i procesu elementu roboczego. Służy do obsługi tworzenia raportów.

Migawki

Zestawy jednostek migawki śledzenia pracy to WorkItemSnapshot i WorkItemBoardSnapshot. Migawka jest zapisywana w usłudze Analytics w tym samym czasie każdego dnia i zawiera rekord wartości zdefiniowanych dla elementu roboczego tego dnia. Możesz użyć migawek do generowania raportów trendów.

Domyślnie wszystkie tabele migawek są modelowane jako codzienne tabele faktów migawek. Zapytanie dotyczące zakresu czasu pobiera wartość dla każdego dnia, a zakresy czasu długiego powodują dużą liczbę rekordów. Jeśli nie potrzebujesz takiej wysokiej precyzji, możesz użyć migawek cotygodniowych lub miesięcznych. Aby uzyskać więcej informacji, zobacz Używanie cotygodniowych lub miesięcznych migawek dla zapytań trendów obejmujących długi czas.

Poprawki elementów roboczych

Za każdym razem, gdy aktualizujesz element roboczy, system tworzy nową poprawkę i rejestruje ją w System.RevisedDate polu, co jest przydatne do określania filtru historii. Można przedstawić poprawioną datę według RevisedDate (DateTime) właściwości i RevisedDateSK (Int32) .

Aby uzyskać najlepszą wydajność, użyj właściwości klucza zastępczego tej daty. Ten klucz pokazuje datę utworzenia poprawki lub pokazuje wartość "9999-01-01T00:00:00Z" null daty/godziny OData dla aktywnych lub niekompletnych poprawek. Jeśli chcesz, aby wszystkie daty od daty {startDate}, włącznie, dodaj następujący filtr do zapytania: RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Aby załadować wszystkie poprawki dla danego elementu roboczego, należy użyć jednostki WorkItemRevisions . Zapytanie zwraca wszystkie historyczne poprawki elementów roboczych, w tym bieżącą poprawkę, dla filtrowanych elementów roboczych, a nie w tym usuniętych elementów roboczych.

Właściwości udostępnione między typami jednostek

Właściwości, które można wybrać w widoku Analiza, odpowiadają zwykłym polam śledzenia pracy i wybranym właściwościom analizy, takim jak dni cyklu i dni realizacji. Te właściwości są definiowane dla następujących typów jednostek, chyba że określono inaczej:

  • Element roboczy
  • WorkItemRevision
  • WorkItemSnapshot
  • ZrzutTablicyElementówRoboczych

Uwaga

W poniższej tabeli wymieniono i opisano większość właściwości, które można wybrać w widoku Analiza, w tym zwykłe pola śledzenia pracy i inne właściwości analizy.

nazwa wyświetlana Nazwa właściwości Typ danych opis Nazwa odwołania
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 Data i Czas 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 Data i Czas Data i godzina aktywowania lub ponownego aktywowania usterki lub elementu roboczego przez członka zespołu. Microsoft.VSTS.CodeReview.ActivatedDate
Aktywność Activity Sznurek Typ działania lub dyscypliny przypisanej do wykonania zadania. Dozwolone wartości to: Wdrażanie, projektowanie, programowanie, dokumentacja, wymagania i testowanie. (Procesy Agile, Scrum i Podstawowe) Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate PrzesunięcieDatyICzasu Dane i czas ostatniej aktualizacji jednostki.
Typ aplikacji Sznurek Typ aplikacji, nad którą osoby biorące udział w projekcie przekazują opinię. Wartości domyślne to Aplikacja internetowa, Maszyna zdalna i Aplikacja kliencka. Prawidłowe typy są określane w pliku konfiguracji procesu dla projektów korzystających z lokalnego procesu XML. Microsoft_VSTS_Feedback_ApplicationType
Ścieżka obszaru AreaPath, AreaSK Sznurek Funkcja produktu lub grupa elementów roboczych obszaru zespołu. 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 Sznurek Identyfikator testu, który automatyzuje przypadek testowy. Microsoft.VSTS.TCM.AutomatedTestId
Nazwa testu zautomatyzowanego AutomatedTestName Sznurek Nazwa członka zespołu, który aktywował lub uaktywnił ponownie element roboczy. Microsoft.VSTS.TCM.AutomatedTestName
Magazyn testów automatycznych AutomatedTestStorage Sznurek Zestaw zawierający test, który automatyzuje przypadek testowy. Microsoft.VSTS.TCM.AutomatedTestStorage
Typ testu zautomatyzowanego AutomatedTestType Sznurek Typ testu, który automatyzuje przypadek testowy. Microsoft.VSTS.TCM.AutomatedTestType
Stan automatyzacji AutomatedStatus Sznurek Stan przypadku testowego z zaakceptowanymi wartościami Automated, Not Automated lub Planned. Microsoft.VSTS.TCM.AutomationStatus
Priorytet listy prac BacklogPriority Liczba rzeczywista Numer przypisany przez proces w tle systemu używany do klasyfikacji stosu lub śledzenia sekwencji elementów na liście prac lub tablicy. (Proces Scrum) Microsoft.VSTS.Common.BacklogPriority
Zablokowane Blocked Sznurek Wskazanie, że nie można wykonać dalszych prac nad elementem 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. Większa liczba przypisanych elementów jest uznawana za większą wartość biznesową niż elementy przypisane do niższych liczb. Microsoft.VSTS.Common.BusinessValue
Zmienione przez ChangedBy, ChangedByUserSK UserSK Nazwisko osoby, która ostatnio zmodyfikowała element roboczy. System.ChangedBy
Zmieniono datę ChangedDate Data i Czas Data i godzina modyfikacji elementu roboczego. System.ChangedDate
ChangedDateSK Int32 Data modyfikacji elementu roboczego, wyrażona w YYYYMMDDstrefie 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 Imię i nazwisko osoby, która zamknęła element roboczy. Microsoft.VSTS.Common.ClosedBy
Data zamknięcia ClosedDate, , ClosedDateSKClosedOn Data i Czas 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
Oddany Committed Sznurek Wskazanie, 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ńczono stan.
CompletedOn Nawigacja Właściwość nawigacji do Date jednostki dla daty wprowadzenia stanu przepływu pracy skojarzonego z kategorią Ukończono 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 Data i Czas 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 jako YYYYMMDD w 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 obliczony na podstawie pierwszego wprowadzenia kategorii Stanu w toku lub Rozwiązano , aby wprowadzić kategorię Ukończono stan. Aby uzyskać więcej informacji, zobacz Widżety Czas realizacji i Czas cyklu.
Dyscyplina Discipline Sznurek Typ działania lub dyscypliny przypisanej do zadania. Dozwolone wartości to : Analiza, Programowanie, Testowanie, Edukacja użytkowników i Środowisko użytkownika. (Proces CMMI) Microsoft.VSTS.Common.Activity
Data ukończenia DueDate Data i Czas Prognozowana data ukończenia problemu lub elementu roboczego, który ma zostać rozwiązany. (Proces Agile) Microsoft.VSTS.Scheduling.DueDate
Wysiłek Effort Liczba rzeczywista Szacowana ilość pracy wymagana do wdrożenia elementu listy prac produktu (proces Scrum) lub problemu (proces podstawowy). Microsoft.VSTS.Scheduling.Effort
Data zakończenia FinishDate Data i Czas Data i godzina, według których harmonogram wskazuje, że element roboczy ma zostać ukończony. Microsoft.VSTS.Scheduling.FinishDate
Znaleziono w FoundIn Sznurek Numer kompilacji produktu, znany również jako poprawka, w której znaleziono usterkę. Microsoft.VSTS.Build.FoundIn
Data ruchu przychodzącego InProgressDate Data i Czas Data przechowywana w analizie, która przechwytuje datę i godzinę przeniesienia elementu roboczego do stanu w toku .
InProgressDateSK Int32 Data przeniesienia elementu roboczego do kategorii Stan , który należy do kategorii stanu W toku , wyrażonej jako YYYYMMDD w strefie czasowej zdefiniowanej dla organizacji. Używane przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
Kompilacja integracji IntegrationBuild Sznurek Numer kompilacji produktu, który zawiera kod lub naprawia usterkę. Microsoft.VSTS.Build.IntegrationBuild
Jest aktualne IsCurrent logiczny Obsługa filtrowania danych w celu wyświetlenia najnowszej migawki filtrowanego zestawu elementów roboczych przez ustawienie wartości na True. Prawidłowe dla typów jednostek WorkItemRevision, WorkItemBoardSnapshot i BoardLocation.
Jest ostatnią wersją dnia IsLastRevisionOfDay logiczny Wskazuje, że migawka reprezentuje ostatnią wersję dnia, gdy ustawiono wartość True.
Jest ostatnią wersją okresu IsLastRevisionOfPeriod logiczny Wskazuje, że migawka reprezentuje ostatnią wersję okresu, gdy ustawiono wartość True.
Problem Issue Sznurek 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 obliczany na podstawie tworzenia elementu roboczego lub wprowadzania kategorii Proponowany stan do wprowadzania kategorii Ukończono . Aby uzyskać więcej informacji, zobacz Widżety Czas realizacji i Czas cyklu.
Oryginalne oszacowanie OriginalEstimate Liczba rzeczywista Mierzenie 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 prawidłowe dla 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 Właściwości projektu. System.TeamProject
ProjectSK GUID Identyfikator GUID przypisany do projektu, do którego należy element roboczy.
Ocena Reason Sznurek Liczba gwiazdek odbieranych od recenzenta w systemie klasyfikacji opartej na gwiazdce (odpowiedź na opinie). Liczba jest przechowywana w systemie i zapisywana jako 0 - Not Rated, 1 - Poor, 2 - Fair, 3 - Good, 4 - Very Good, or 5 - Excellent. Prawidłowe dla typów jednostek WorkItemRevision i WorkItem . Microsoft.VSTS.Common.Rating
Przyczyna Reason Sznurek Powód, 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 Data i Czas 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 Sznurek Przyczyna rozwiązania usterki, na przykład Naprawiono. Microsoft.VSTS.Common.ResolvedReason
Rewizja Revision Int32 Numer przypisany do historycznej poprawki elementu roboczego. System.Rev
Data skorygowania RevisedDate Data i Czas 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 elementu roboczego. Prawidłowe wartości obejmują 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 obejmują 1 — Krytyczne, 2 — Wysokie, 3 — Średni i 4 — Niski. Microsoft.VSTS.Common.Severity
Rozmiar Size Liczba rzeczywista Szacowanie ilości pracy wymaganej do wdrożenia przez wymaganie. (Proces CMMI) Microsoft.VSTS.Scheduling.Size
Ranga stosu StackRank Liczba rzeczywista Numer przypisany przez proces w tle systemu używany do klasyfikacji stosu lub śledzenia sekwencji elementów na liście prac lub tablicy. (Procesy Agile, Scrum i Podstawowe) Microsoft.VSTS.Common.StackRank
Data rozpoczęcia StartDate Data i Czas Data i godzina przypisana do elementu roboczego, aby rozpocząć pracę. Microsoft.VSTS.Scheduling.StartDate
Województwo State Sznurek 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 Sznurek Jak usługa Azure Boards i wybieranie widżetów pulpitu nawigacyjnego traktują każdy stan przepływu pracy. Kategorie stanów obejmują proponowane, w toku, rozwiązane, usunięte i ukończone. Aby uzyskać więcej informacji, zobacz How to use workflow states and state categories (Jak używać stanów przepływu pracy i kategorii stanów). Prawidłowy tylko dla WorkItemRevision typu jednostki.
Data zmiany stanu StateChangeDate Data i Czas 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 Oszacowanie ilości pracy wymaganej przez scenariusz użytkownika do zaimplementowania, często agregowane jako suma. (Proces Agile) Microsoft.VSTS.Scheduling.StoryPoints
Tagi TagNames Sznurek Rozdzielana średnikami lista tagów przypisanych do co najmniej jednego elementu roboczego na potrzeby filtrowania lub wykonywania zapytań. System.Tags
Data docelowa TargetDate Data i Czas Prognozowana data ukończenia problemu lub innego elementu roboczego, który ma zostać rozwiązany lub ukończony. Microsoft.VSTS.Scheduling.TargetDate
Typ zestawu testów Sznurek Typ zestawu testów. Prawidłowe wartości obejmują oparte na zapytaniach, oparte na wymaganiach i statyczne. Microsoft_VSTS_TCM_TestSuiteType
Identyfikator typu zestawu testów Int64 Przypisany przez system numer odpowiadający kategorii zestawu testów. 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ż elementy o niższych wartościach. Microsoft.VSTS.Common.TimeCriticality
Tytuł Title Sznurek Krótki opis podsumowujący element roboczy, który ułatwia członkom zespołu odróżnienie go od innych elementów roboczych na liście. System.Title
Obszar wartości ValueArea Sznurek Obszar wartości klienta adresowany przez element epików, funkcji lub listy prac. Wartości obejmują architekturę lub firmę. Microsoft.VSTS.Common.ValueArea
Znak wodny Watermark Sznurek Pole zarządzane przez system, które zwiększa się o zmiany wprowadzone w elemencie roboczym. Prawidłowe dla typów jednostek WorkItemRevision i WorkItem . System.Watermark
Identyfikator elementu roboczego WorkItemId Int32 Unikatowy identyfikator przypisany do elementu roboczego. Identyfikator elementu roboczego jest unikatowy we wszystkich projektach w organizacji lub kolekcji projektów. System.Id
WorkItemRevisionSK Int32 Unikatowy klucz analizy dla poprawki elementu roboczego używany przez narzędzia zewnętrzne do dołączania powiązanych jednostek.
Typ elementu roboczego WorkItemType Sznurek Nazwa typu elementu roboczego. Dostępne typy elementów roboczych są oparte na procesie używanym przez projekt. 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 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.

nazwa wyświetlana Name Ograniczenie odwołań Właściwość odwołań Prawidłowe typy 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 Element roboczy
Linki Element roboczy
Dzieci Element roboczy
Nadrzędny Element roboczy
Elementy potomne Element roboczy
Element roboczy* WorkItemId WorkItemRevision

*Jednostka WorkItem obsługuje PredictTags również funkcje i Predict , które obsługują trendy predykcyjne dla wybranych wbudowanych raportów i widżetów analizy.

BoardLocation i WorkItemBoardSnapshot

W poniższej tabeli wymieniono i opisano właściwości zdefiniowane dla typów jednostek BoardLocation i WorkItemBoardSnapshot , chyba że zostały zanotowane. Za pomocą tych pól można filtrować dane elementów roboczych na podstawie stanu elementu roboczego w kolumnie tablicy zespołu, toru lub na poziomie listy prac. Przykład, który wysyła zapytanie do zestawu jednostek WorkItemBoardSnapshot, zobacz przykładowy raport diagramu przepływu skumulowanego (CFD).

nazwa wyświetlana Nazwa właściwości Typ danych opis
Identyfikator tablicy BoardId Identyfikator GUID Unikatowy identyfikator GUID przypisany do tablicy. Każdy zespół jest skojarzony z co najmniej jedną tablicą.
Nazwa odwołania do kategorii tablicy BoardCategoryReferenceName Sznurek Nazwa przypisana do kategorii typu elementu roboczego używana do wypełniania tablicy. Na przykład tablica listy prac produktu jest skojarzona z kategorią Wymagania. Aby uzyskać więcej informacji, zobacz Dostosowywanie listy prac lub tablic (proces dziedziczenia).
Nazwa tablicy BoardName Sznurek Nazwa przypisana do tablicy, na przykład Historie, Elementy listy prac, Funkcje lub Epiki.
Poziom tablicy BoardLevel Int32 Numer przypisany do tablicy na podstawie miejsca, w którym znajduje się w hierarchii tablic.
Typ listy prac BacklogType Sznurek Nazwa typu listy prac, na przykład Iteracja, Wymaganie lub Portfolio.
Nazwa kolumny ColumnName Sznurek Nazwa kolumny tablicy, do której jest obecnie przypisany element roboczy, taki jak Active, Closed, Committed, Done lub niestandardowa etykieta kolumny. Nazwa odwołania: System.BoardColumn
Kolejność kolumn ColumnOrder Int32 Numer przypisany do kolumny tablicy pod względem jego sekwencji w tablicy.
Gotowy Done Wyliczony Wskaźnik lokalizacji podzielonej kolumny.*
Limit elementów kolumny ColumnItemLimit Int32 Liczba przypisana do kolumny tablicy pod względem jego sekwencji.
Jest widoczna tablica IsBoardVisible logiczny Wskazanie, czy zespół zdecydował się na uwidocznienie tablicy.
Czy podział kolumny IsColumnSplit logiczny Wskazanie, czy kolumna jest podzielona na kolumny Robi i Gotowe zgodnie z opisem w sekcji Podział kolumn na tablicy w celu pokazania postępu pracy.
Jest aktualne IsCurrent logiczny Właściwość, która obsługuje filtrowanie danych w celu wyświetlenia najnowszej migawki filtrowanych elementów roboczych po ustawieniu wartości True.
Jest domyślnym pasem ruchu IsDefaultLane logiczny Wskazuje, że element roboczy jest przypisany do domyślnego toru, gdy jest ustawiony na True.
Jest gotowe IsDone logiczny Bieżące przypisanie elementu roboczego w kolumnie Do wykonywania , jeśli False lub Gotowe , gdy True. Prawidłowe tylko wtedy, gdy kolumny podzielone są włączone dla kolumny tablicy. Nazwa odwołania: System.BoardColumnDone
Identyfikator pasa ruchu LaneId Identyfikator GUID Unikatowy identyfikator GUID przypisany do pływaka tablicy. Każdy zespół może dodać do tablicy co najmniej jeden pływak. Aby uzyskać więcej informacji na temat pływaków, zobacz Speed up your team's work by using swimlanes in your board (Przyspieszanie pracy zespołu przy użyciu pływaków na tablicy).
Nazwa pasa ruchu LaneName Sznurek Nazwa przypisana do pływaka pokładowego. Nazwa odwołania: System.BoardLane
Kolejność pasa ruchu LaneOrder Int32 Numer przypisany do pływaka pokładowego pod względem jego sekwencji.

*W poniższej tabeli wymieniono nazwy składowych typu wyliczonego BoardColumnSplit , którego można użyć do filtrowania elementów roboczych w kolumnach Tablica Wykonywanie lub Gotowe .

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

Aby uzyskać więcej informacji na temat kolumn tablicy 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 AreaSK.ProjectSK Tych właściwości można użyć do filtrowania lub raportowania danych śledzenia pracy na podstawie przypisań ścieżek obszaru.

nazwa wyświetlana Name Typ danych opis
AnalyticsUpdatedDate Data i Czas Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Number Int32 Wartość całkowita przypisana do węzła ścieżki obszaru podczas tworzenia.
Głębokość Depth Int32 Poziom ścieżki obszaru na podstawie jego głębokości z poziomu głównego.
Identyfikator obszaru AreaId GUID Unikatowy identyfikator przypisany do ścieżki obszaru podczas tworzenia.
Poziom warstwy 1 do poziomu warstwy 14 AreaLevel1 do AreaLevel14 Sznurek Poziom węzła ścieżki obszaru do 14 poziomów zagnieżdżonych. Poziom warstwy 1 zawsze odpowiada węzłowi głównemu i nazwie projektu.
Nazwa obszaru AreaName Sznurek Nazwa zdefiniowana dla ścieżki obszaru podczas tworzenia.
Ścieżka obszaru AreaPath Sznurek Pełna ścieżka ścieżki obszaru rozpoczynająca się od węzła głównego.

Ważne

Usunięcie wartości ścieżki obszaru lub ponowne skonfigurowanie wartości ścieżki iteracji powoduje nieodwracalną utratę danych na następujących wykresach:

  • Burndown and burn up widget charts (Burndown i burn up widget charts)
  • Wykresy spalania sprintu
  • Wykresy prędkości dla zespołów ze zmienionymi ścieżkami obszaru
  • Historyczne wykresy trendów odnoszące się do wartości Ścieżka obszaru i Ścieżka iteracji zdefiniowane w danym momencie dla każdego elementu roboczego

Ścieżki obszaru i iteracji można usuwać tylko wtedy, gdy nie są już używane przez żadne elementy robocze. Po usunięciu tych ścieżek nie można już pobierać ich danych historycznych.

Właściwości nawigacji dla typu jednostki Obszar i zestaw jednostek Obszary obejmują projekt i aplikację Teams.

Aby uzyskać więcej informacji na temat ścieżki 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 Name Typ danych opis
AnalyticsUpdatedDate Data i Czas Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Number Int32 Wartość całkowita przypisana do węzła ścieżki iteracji podczas tworzenia.
Głębokość Depth Int32 Poziom ścieżki iteracji na podstawie jego głębokości z poziomu głównego.
Data zakończenia EndDate Data i Czas Data zakończenia zdefiniowana dla ścieżki iteracji.
IsEnded IsEnded logiczny Wskazuje, że data zakończenia ścieżki iteracji przypada w przeszłości, gdy jest ustawiona na Truewartość .
Identyfikator iteracji IterationId GUID Unikatowy identyfikator przypisany do ścieżki iteracji podczas tworzenia.
Poziom iteracji 1 do poziomu iteracji 14 IterationLevel1 do IterationLevel14 Sznurek Poziom węzła ścieżki iteracji do 14 poziomów zagnieżdżonych. Poziom iteracji 1 zawsze odpowiada węzłowi głównemu i nazwie projektu.
Nazwa iteracji IterationName Sznurek Nazwa zdefiniowana dla ścieżki iteracji podczas tworzenia.
Ścieżka iteracji IterationPath Sznurek Pełna ścieżka iteracji rozpoczynająca się od węzła głównego. Iteracja musi być prawidłowym węzłem w hierarchii projektu. Nazwa odwołania: System.IterationPath
Data rozpoczęcia StartDate Data i Czas Data rozpoczęcia zdefiniowana dla ścieżki iteracji.

Ważne

Usunięcie wartości ścieżki obszaru lub ponowne skonfigurowanie wartości ścieżki iteracji powoduje nieodwracalną utratę danych na następujących wykresach:

  • Burndown and burn up widget charts (Burndown i burn up widget charts)
  • Wykresy spalania sprintu
  • Wykresy prędkości dla zespołów ze zmienionymi ścieżkami obszaru
  • Historyczne wykresy trendów odnoszące się do wartości Ścieżka obszaru i Ścieżka iteracji zdefiniowane w danym momencie dla każdego elementu roboczego

Ścieżki obszaru i iteracji można usuwać tylko wtedy, gdy nie są już używane przez żadne elementy robocze. Po usunięciu tych ścieżek nie można już pobierać ich danych historycznych.

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

Aby uzyskać więcej informacji 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. Użyj tych właściwości, aby filtrować lub zgłaszać dane śledzenia pracy dla typów elementów roboczych dla projektu lub zespołu.

Uwaga

Wersje wersji 2.0, 3.0-preview i 4.0-preview Analytics obsługują zestaw jednostek Process i Processes.

Te właściwości umożliwiają filtrowanie danych śledzenia pracy na podstawie poziomu listy prac.

nazwa wyświetlana Name Typ danych opis
AnalyticsUpdatedDate Data i Czas Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
ProjectSK GUID Klucz projektu skojarzony z procesem.
TeamSK GUID Klucz zespołu skojarzony z procesem.
Nazwa odwołania do kategorii listy prac BacklogCategoryReferenceName Sznurek Nazwa odwołania do kategorii przypisana do listy prac skojarzonej z typem elementu roboczego. Przykłady obejmują Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, i Microsoft.TaskCategory.
Nazwa listy prac BacklogName logiczny Nazwa odwołania przypisana do listy prac skojarzonej z typem elementu roboczego
Typ listy prac BacklogType GUID Unikatowy identyfikator przypisany do listy prac podczas tworzenia.
Poziom listy prac BacklogLevel Sznurek Poziom listy prac skojarzony z typem elementu roboczego. Wartość null zwraca wartość, jeśli typ elementu roboczego nie jest skojarzony z poziomem listy prac.
Typ elementu roboczego WorkItemType Sznurek Nazwa zdefiniowana dla typu elementu roboczego.
Ma listę prac HasBacklog Sznurek Wskazuje, czy typ elementu roboczego należy do listy prac.
Jest typem ukrytym IsHiddenType logiczny Wskazuje, czy typ elementu roboczego jest wyłączony.
Jest typem usterki IsBugType logiczny Wskazuje, czy typ elementu roboczego należy do kategorii Usterka .
Jest usuwany IsDeleted logiczny Wskazuje, czy typ elementu roboczego jest usuwany.

Aby uzyskać więcej informacji na temat list prac procesów i typów elementów roboczych, zobacz następujące artykuły:

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ą program Project i jego ograniczenie ProjectSKodwołań. Aby uzyskać więcej informacji 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 Name Typ danych opis
Identyfikator tagu TagId GUID Unikatowy identyfikator przypisany do tagu podczas tworzenia.
Nazwa tagu TagName Sznurek 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 Name Typ danych opis
AnalyticsUpdatedDate Data i Czas Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Identyfikator zespołu TeamId GUID Unikatowy identyfikator przypisany do zespołu podczas tworzenia.
Nazwa zespołu TeamName Sznurek Nazwa zespołu.

Właściwości nawigacji dla zestawu jednostek usługi Teams obejmują projekty, obszary i iteracji.

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 Name Typ danych opis
AnalyticsUpdatedDate Data i Czas Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
WorkItemLinkSK Int32 Klucz zastępczy przypisany do jednostki WorkItemLink .
Data utworzenia CreatedDate GUID Data utworzenia łącza.
Komentarz Comment Sznurek Komentarz dodany podczas tworzenia linku.
Data usunięcia DeletedDate Sznurek Data usunięcia łącza.
Identyfikator typu łącza LinkTypeId Int32 Identyfikator przypisany do docelowego połączonego elementu roboczego.
Nazwa typu łącza LinkTypeName Sznurek Przyjazna nazwa przypisana do typu łącza.
Nazwa odwołania typu łącza LinkTypeReferenceName Sznurek Nazwa odwołania przypisana do typu łącza.
Typ łącza to Acykliczne LinkTypeIsAcyclic logiczny Wskazuje, że typ łącza zezwala na relacje cykliczne po ustawieniu wartości True. Na przykład linki typu drzewa ograniczają relacje cykliczne.
Typ łącza to kierunek LinkTypeIsDirectional logiczny Wskazanie, czy 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 łącza.
Identyfikator docelowego elementu roboczego TargetWorkItemId Int32 Identyfikator przypisany do docelowego elementu roboczego łącza.

Właściwości nawigacji dla typu jednostki WorkItemLink obejmują Projekty, SourceWorkItem i TargetWorkItem.

Aby uzyskać więcej informacji na temat linków i typów linków, zobacz następujące artykuły:

PolaTypuElementuRoboczego

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 Name Typ danych opis
Nazwa pola FieldName Sznurek Przyjazna nazwa przypisana do pola przez system lub podczas tworzenia.
Nazwa odwołania do pola FieldReferenceName Sznurek Nazwa odwołania przypisana do pola przez system lub podczas tworzenia pola niestandardowego.
Typ pola FieldType Sznurek Typ danych przypisany do pola.
Typ elementu roboczego WorkItemType Sznurek Typ elementu roboczego, dla którego zdefiniowano pole.

Właściwości nawigacji obejmują projekt. 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ści niestandardowe. Custom_ lub Custom. jest poprzedzana nazwą właściwości. Sprawdź metadane kolekcji zgodnie z opisem w artykule Wykonywanie 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>

Niestandardowe typy elementów roboczych i 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 z identyfikatorem Custom_ GUID kategorii lub Custom. jego prepend. Na przykład kategoria niestandardowa, taka jak Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 może być przypisana do niestandardowego typu elementu roboczego portfolio na liście prac Portfolio.

Treści powiązane

  • Last updated on