Referenční informace o metadatech pro Azure Boards Analytics

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Služba Analytics shromažďuje všechny aktivity sledování práce definované a aktualizované prostřednictvím Azure Boards. Analýza ukládá jako vlastnosti všechna pole sledování práce s výjimkou polí HTML/rich-text a Historie. Vlastní vlastnosti vlastních polí se automaticky přidají do analýzy.

Tento článek popisuje většinu vlastností, které můžete použít k vygenerování sestavy Analýzy pro sledování práce. Pomocí kombinace vlastností můžete filtrovat dotaz, agregovat data nebo vytvořit sestavu. Tyto dotazy můžete spouštět přímo v prohlížeči. Další informace najdete v tématu Definování základních dotazů pomocí OData Analytics. Pokud s sledováním práce a Službou Azure Boards začínáte, doporučujeme vám projít si následující články:

Poznámka:

Jsou k dispozici popisy entit, vlastností a výčtů podporovaných datovým modelem Analýza. Jedná se o dřívější koncept. Pošlete nám prosím zpětnou vazbu k oblastem, které chcete získat další informace. Dotazování datového modelu najdete v tématu Vytváření dotazů OData pro analýzu.

Přehled sad entit

Při dotazování analýzy dat sledování práce použijte jeden z následujících typů entit nebo sad entit.

  • Dotaz WorkItems na generování sestav stavu a kumulativních sestav
  • Dotaz WorkItemSnapshot na generování sestav trendu, burndownu a burnup

K filtrování dat nebo výběru vlastností pro sestavu použijte jiné typy entit, například Area, , Iteration, ProjectTeam, nebo jiné entity. Souhrn ukázkových sestav najdete v tématu Ukázkové sestavy a rychlý referenční index.

Poznámka:

Pokud chcete generovat zprávy o stavu a trendu u typů pracovních položek specifických pro testování, dotazujte se na WorkItems typy entit a WorkItemSnapshot filtrování na základě typu pracovní položky. Informace o testovacích spuštěních, výsledcích testů nebo jiných testovacích datech, dotazování na TestRunstypy entit , TestPoints, TestResultsDailyTestSuite nebo TestPointHistorySnapshot entit. Další informace najdete v referenčních informacích k testovacím metadatům pro Azure DevOps.

EntitySet EntityType Popis
Oblasti Plocha Cesty oblasti pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie oblastí.
Data CalendarDate Data použitá k filtrování a seskupení dalších entit pomocí relací.
Iterací Iterace Cesty iterace pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie iterací.
BoardLocations BoardLocation Umístění buněk panelu Kanbanu, jak je identifikováno sloupcem desky, plaveckou drahou a rozdělením, zahrnuje nastavení historické desky. Popis jednotlivých polí panelu Kanban naleznete v tématu Pracovní postup a Pole panelu Kanban.
Procesy Proces Informace o backlogu používané k rozbalení nebo filtrování pracovních položek a typů pracovních položek Příklad, který používá procesy k filtrování sestavy, naleznete v části Požadavky sledování ukázkové sestavy. Podporováno pro analýzu verze 2.0 a novější.
Projekty Projekt Všechny projekty definované pro organizaci (cloud) nebo kolekci projektů (místní).
Značky Tag Všechny značky pracovních položek pro každý projekt Příklad, který k filtrování sestavy používá značky , najdete v ukázkové sestavě burndownu vydané verze.
Týmy Team Všechny týmy definované pro projekt. Příklad, který používá Teams k filtrování sestavy, najdete v tématu Přidání průřezu týmu do sestavy Power BI.
Uživatelé Uživatel Informace o uživateli, které slouží k rozbalení nebo filtrování různých vlastností pracovní položky, například Přiřazeno, Vytvořeno uživatelem.
WorkItemBoardSnapshot WorkItemBoardSnapshot (složené) Stav každé pracovní položky pro každé datum kalendáře, včetně umístění panelu Kanban, který se používá ke generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě diagramu toku (CFD).
WorkItemLinks WorkItemLink Vazby mezi pracovními položkami, například podřízené položky, nadřazené položky a související. Obsahuje pouze nejnovější revizi odkazů, bez historie. Hypertextové odkazy nejsou zahrnuty.
WorkItemRevisions WorkItemRevision Všechny revize historických pracovních položek, včetně aktuální revize. Nezahrnuje odstraněné pracovní položky.
WorkItemSnapshot WorkItemSnapshot (složené) Stav každé pracovní položky v každém kalendářním datu, který slouží k podpoře generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě trendů chyb.
Pracovní položky Workitem Aktuální stav pracovních položek. Používá se k podpoře zpráv o stavu. Ukázkovou sestavu najdete v tématu Souhrn hodnot podřízených pracovních položek do nadřazené ukázkové sestavy.
WorkItemTypeFields WorkItemTypeField Vlastnosti pracovní položky pro každý typ a proces pracovní položky. Používá se k podpoře vytváření sestav.

O snímcích

Existují dvě sady entit sledování práce: WorkItemSnapshot a WorkItemBoardSnapshot.

Snímek poskytuje záznam hodnot definovaných pro pracovní položku každý den. Záznam se zapíše do Analýzy jednou denně ve stejnou dobu. Snímky použijete, když chcete vygenerovat sestavu trendu. Ve výchozím nastavení se všechny tabulky snímků modelují jako tabulky faktů s denním snímkem. Pokud zadáte dotaz na časový rozsah, získá se hodnota pro každý den. Dlouhé časové rozsahy vedou k velkému počtu záznamů. Pokud takovou vysokou přesnost nepotřebujete, můžete použít týdenní nebo dokonce měsíční snímky.

Další informace najdete v pokynech k dotazům OData a používejte týdenní nebo měsíční snímky pro dotazy trendu, které trvají dlouhou dobu.

O revizích pracovních položek

Pokaždé, když aktualizujete pracovní položku, systém vytvoří novou revizi a zaznamená tuto akci do System.RevisedDate pole, což je užitečné pro zadání filtru historie. Revidované datum je reprezentováno vlastnostmi RevisedDate (DateTime) a RevisedDateSK (Int32). Pro zajištění nejlepšího výkonu použijte náhradní klíč druhého data. Představuje datum vytvoření revize nebo má hodnotu null pro aktivní nebo neúplné revize.

Pokud chcete mít všechna data od inkluzivního {startDate} formátu, přidejte do dotazu následující filtr.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Sadu entit použijete WorkItemRevisions k načtení všech revizí pro danou pracovní položku. Dotaz vrátí všechny revize historických pracovních položek, včetně aktuální revize, pro pracovní položky, podle které filtrujete. Nezahrnuje odstraněné pracovní položky.

Sdílené vlastnosti napříč několika typy entit

Vlastnosti, které můžete vybrat v zobrazení Analýza, odpovídají běžným polím sledování práce a vyberte Vlastnosti analýzy, například dny doby cyklu a dny předstihu. Tyto vlastnosti, z nichž většina je uvedena a popsána v následující tabulce, jsou definovány pro následující typy entit, pokud není uvedeno jinak.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Poznámka:

Služba Analytics neukládá žádná data pro dlouhá textová pole přiřazená datovému typu HTML nebo RTF. To zahrnuje pole Popis a Historie . Analýza neukládá ani počty připojených souborů. Úplný seznam polí definovaných ve výchozích šablonách procesů naleznete v indexu polí pracovní položky. Popis jednotlivých datových typů najdete v tématu Pole dotazu, operátory a makra.
V následující tabulce nejsou zahrnuty všechny vlastnosti přidružené k polím Specifické pro proces Scrum a CMMI. Seznam těchto polí naleznete v části Popisy polí pro výchozí pole a pole pracovní položky používaná v šablonách procesů, pole použitá ke sledování pracovních položek CMMI.

Mnoho vlastností je založených na datech nebo uživatelích. Tyto vlastnosti jsou přidružené k sadám entit CalendarDate a User , které jsou popsány v odkazu na metadata kalendáře, projektu a uživatele.

Zobrazovaný název
Property name		 Datový typ Popis
Reference name
Přijal(a)
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Jméno osoby, která odpověděla na kontrolu kódu. (proces CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Datum přijetí
AcceptedDate		 DateTime Datum a čas, kdy osoba odpověděla na kontrolu kódu (proces CMMI)
Microsoft.VSTS.CodeReview.AcceptedDate
Aktivoval(a)
ActivatedBy
ActivatedByUserSK		 UserSK Jméno člena týmu, který pracovní položku aktivoval nebo znovu aktivoval
Microsoft.VSTS.Common.ActivatedBy
Datum aktivace
ActivatedDate		 DateTime Datum a čas, kdy člen týmu aktivoval nebo znovu aktivoval chybu nebo pracovní položku
Microsoft.VSTS.CodeReview.ActivatedDate
Aktivita
Activity		 Řetězec Typ aktivity, která je nutná k provedení úkolu.
Microsoft.VSTS.Common.Activity

Typ aktivity nebo disciplíny přiřazené k úkolu. Povolené hodnoty jsou: nasazení, návrh, vývoj, dokumentace, požadavky a testování. (Agilní, Scrum a základní proces)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Data a čas poslední aktualizace entity.
typ aplikace Řetězec Typ aplikace, ke které budou účastníci poskytovat zpětnou vazbu. Výchozí hodnoty jsou webová aplikace, vzdálený počítač a klientská aplikace. Platné typy jsou zadány v konfiguračním souboru procesu pro projekty, které používají místní proces XML.
Microsoft_VSTS_Feedback_ApplicationType
Cesta k oblasti
AreaPath
AreaSK		 Řetězec Seskupí pracovní položky do funkcí produktu nebo týmových oblastí. Oblast musí být platným uzlem v hierarchii projektu.
System.AreaPath
Přiřazeno
AssignedTo
AssignedToUserSK		 UserSK Název člena týmu, který aktuálně vlastní pracovní položku.
System.AssignedTo
ID automatizovaného testu
AutomatedTestId		 Řetězec ID testu, který automatizuje testovací případ.
Microsoft.VSTS.TCM.AutomatedTestId
Název automatizovaného testu
AutomatedTestName		 Řetězec Jméno člena týmu, který pracovní položku aktivoval nebo znovu aktivoval
Microsoft.VSTS.TCM.AutomatedTestName
Automatizované testovací úložiště
AutomatedTestStorage		 Řetězec Sestavení obsahující test, který automatizuje testovací případ.
Microsoft.VSTS.TCM.AutomatedTestStorage
Typ automatizovaného testu
AutomatedTestType		 Řetězec Typ testu, který automatizuje testovací případ.
Microsoft.VSTS.TCM.AutomatedTestType
Stav automatizace
AutomatedStatus		 Řetězec Stav testovacího případu s následujícími akceptovanými hodnotami: Automatizované, Neautomatizované nebo Plánované.
Microsoft.VSTS.TCM.AutomationStatus
Priorita backlogu
BacklogPriority		 Hodnota s dvojitou přesností Číslo přiřazené procesem na pozadí systému, který se používá k naskládání pořadí nebo sledování posloupnosti položek v backlogu nebo panelu. (Proces Scrum)
Microsoft.VSTS.Common.BacklogPriority
Blokován
Blocked		 Řetězec Označuje, že u pracovní položky nelze provádět žádnou další práci. Platné hodnoty jsou Ano nebo Ne. (proces CMMI)
Microsoft.VSTS.CMMI.Blocked
Obchodní hodnota
BusinessValue		 Hodnota s dvojitou přesností Subjektivní jednotka míry, která zachycuje relativní obchodní hodnotu položky nebo funkce backlogu produktu ve srovnání s jinými položkami stejného typu. Položka, která má přiřazené vyšší číslo, by se měla považovat za větší obchodní hodnotu než položka, která má přiřazené nižší číslo.
Microsoft.VSTS.Common.BusinessValue
Autor změny
ChangedBy
ChangedByUserSK		 UserSK Jméno osoby, která pracovní položku naposledy upravila.
System.ChangedBy
Změněné datum
ChangedDate		 DateTime Datum a čas změny pracovní položky
System.ChangedDate
ChangedDateSK Int32 Datum změny pracovní položky vyjádřené v YYYYMMDD časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
ChangedOn Navigace Navigační vlastnost entity pro Date datum, kdy byla pracovní položka změněna, v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Uzavřeno
ClosedBy
ClosedByUserSK		 UserSK Jméno osoby, která pracovní položku zavřela.
Microsoft.VSTS.Common.ClosedBy
Datum uzavření
ClosedDate
ClosedDateSK
ClosedOn		 DateTime Datum a čas uzavření pracovní položky
Microsoft.VSTS.Common.ClosedDate
Počet komentářů
CommentCount		 Int32 Počet komentářů přidaných do oddílu Diskuze pracovní položky
System.CommentCount
Zavázala
Committed		 Řetězec Určuje, jestli je požadavek potvrzen v projektu. Platné hodnoty jsou Ano nebo Ne. (proces CMMI)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Datum navigační vlastnosti zachycené službou Analytics, které ukládá, když pracovní položka zadala stav pracovního postupu přidružený k kategorii Dokončený stav pracovního postupu.
CompletedOn Navigace Navigační vlastnost Date entity pro datum, kdy pracovní položka zadala stav pracovního postupu přidružený k kategorii Dokončený stav pracovního postupu v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Dokončená práce
CompletedWork		 Hodnota s dvojitou přesností Míra množství práce strávené na úkolu.
Microsoft.VSTS.Scheduling.CompletedWork
Autor
CreatedBy
CreatedByUserSK		 UserSK Jméno osoby, která vytvořila pracovní položku.
Microsoft.VSTS.Common.CreatedBy
Datum vytvoření
CreatedDate
CreatedDateSK		 DateTime Datum vytvoření pracovní položky vyjádřené v časovém pásmu definovaném pro organizaci. Běžně se používá pro filtrování a zobrazení.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Datum vytvoření pracovní položky vyjádřené v YYYYMMDD časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
CreatedOn Navigace Vlastnost navigace k entitě Date pro datum vytvoření pracovní položky v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Dny v čase cyklu
CycleTimeDays		 Hodnota s dvojitou přesností Doba cyklu se počítá od prvního zadání probíhající nebo vyřešené kategorie stavu k zadání kategorie Dokončeno . Další informace najdete ve widgetech Doba předstihu a Cyklus.
Disciplína
Discipline		 Řetězec Typ aktivity nebo disciplíny přiřazené k úkolu. Povolené hodnoty jsou: Analysis*, Development, Test, User Education a User Experience. (proces CMMI)
Microsoft.VSTS.Common.Activity
Splatnosti
DueDate		 DateTime Předpovídané termín splnění, do kterého se vyřeší problém nebo pracovní položka. (Agilní proces)
Microsoft.VSTS.Scheduling.DueDate
Úsilí
Effort		 Hodnota s dvojitou přesností Odhad množství práce, kterou bude muset implementovat položka backlogu produktu (proces Scrum) nebo problém (základní proces).
Microsoft.VSTS.Scheduling.Effort
Datum dokončení
FinishDate		 DateTime Datum a čas, kdy plán indikuje, že se pracovní položka dokončí.
Microsoft.VSTS.Scheduling.FinishDate
Nalezeno v
FoundIn		 Řetězec Číslo buildu produktu, označované také jako revize, ve kterém byla nalezena chyba.
Microsoft.VSTS.Build.FoundIn
InProgress Date
InProgressDate		 DateTime Analytické uložené datum, které zachycuje datum a čas, kdy byla pracovní položka přesunuta do stavu , který patří do kategorie Probíhá .
InProgressDateSK Int32 Datum, kdy byla pracovní položka přesunuta do stavu , který patří do kategorie Probíhající , vyjádřeno v YYYYMMDD časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
Sestavení integrace
IntegrationBuild		 Řetězec Číslo sestavení produktu, které obsahuje kód nebo opravuje chybu.
Microsoft.VSTS.Build.IntegrationBuild
Je aktuální
IsCurrent		 Boolean Podporuje filtrování dat pro zobrazení nejnovějšího snímku filtrované sady pracovních položek nastavením hodnoty na True.
Platné pro tyto typy entit: WorkItemRevision, WorkItemBoardSnapshota BoardLocation.
Je poslední revize dne
IsLastRevisionOfDay		 Boolean Označuje, že snímek představuje poslední revizi dne, pokud je nastavena na Truehodnotu .
Je poslední revize období
IsLastRevisionOfPeriod		 Boolean Označuje, že snímek představuje poslední revizi období, pokud je nastavena na True.
Problém
Issue		 Řetězec Označuje, že sdílený krok je přidružený k očekávanému výsledku. Povolené hodnoty jsou Ano a Ne.
Microsoft.VSTS.Common.Issue
Dny předstihu
LeadTimeDays		 Hodnota s dvojitou přesností Doba předstihu se počítá z vytvoření pracovní položky nebo zadáním kategorie Navrhovaného stavu pro zadání kategorie Dokončeno . Další informace najdete ve widgetech Doba předstihu a Cyklus.
Původní odhad
OriginalEstimate		 Hodnota s dvojitou přesností Míra množství práce, která je nutná k dokončení úkolu.
Microsoft.VSTS.Scheduling.OriginalEstimate
ID nadřazené pracovní položky
ParentWorkItemId		 Int32 Jedinečné ID, které identifikuje pracovní položku propojenou jako nadřazenou položku. Užitečné pro generování souhrnných sestav. Nadřazené pole je k dispozici v Azure DevOps Serveru 2020 a novějších verzích. Platné pro tyto typy entit: WorkItemRevision a WorkItem.
System.Parent
Priorita
Priority		 Int32 Subjektivní hodnocení chyby, problému, úkolu nebo testovacího případu v souvislosti s podnikáním. Mezi hodnoty patří: - 1, 2 nebo 3.
Microsoft.VSTS.Common.Priority
Název projektu
ProjectName		 Navigace Název projektu, do kterého pracovní položka patří. Podrobnosti najdete v tématu Datum kalendáře, Projekt a Odkaz na metadata uživatele, Vlastnosti projektu.
System.TeamProject
ProjectSK Identifikátor GUID Identifikátor GUID přiřazený k projektu, do kterého pracovní položka patří.
Rating
Reason		 Řetězec Počet hvězdiček, které položka obdrží od recenzenta v hvězdicovém systému hodnocení. (Odpověď zpětné vazby) Číslo je uloženo v systému a zapsáno takto:- 0 - Nehodnocené, 1 - Špatné, 2 - Fair, 3 - Dobré, 4 - Velmi dobré a 5 - Vynikající. Platné pro tyto typy entit: WorkItemRevision a WorkItem.
Microsoft.VSTS.Common.Rating
Důvod
Reason		 Řetězec Důvod, proč je pracovní položka v aktuálním stavu Každý přechod z jednoho stavu pracovního postupu na jiný je přidružený k odpovídajícímu důvodu.
System.Reason
Zbývající práce
RemainingWork		 Hodnota s dvojitou přesností Míra množství práce, která zbývá dokončit úkol.
Microsoft.VSTS.Scheduling.RemainingWork
Vyřešeno uživatelem
ResolvedBy
ResolvedByUserSK		 UserSK Jméno člena týmu, který vyřešil chybu nebo uživatelský příběh.
Microsoft.VSTS.Common.ResolvedBy
Vyřešené datum
ResolvedDate		 DateTime Datum a čas vyřešení chyby nebo scénáře uživatele.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Datum vyřešení pracovní položky vyjádřené YYYYMMDD v časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
ResolvedOn Navigace Vlastnost navigace k entitě Date pro datum, kdy byla pracovní položka vyřešena, v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Vyřešený důvod
ResolvedReason		 Řetězec Důvod, proč byla chyba vyřešena (například byla opravena).
Microsoft.VSTS.Common.ResolvedReason
Revize
Revision		 Int32 Číslo, které je přiřazeno k historické revizi pracovní položky.
System.Rev
Revidované datum
RevisedDate		 DateTime Datum a čas změny nebo aktualizace pracovní položky
RevisedDateSK Int32 Datum revize pracovní položky vyjádřené YYYYMMDD v časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
RevisedOn Navigace Navigační vlastnost entity Date pro datum, kdy byla pracovní položka revidována, v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Riziko
Risk		 Hodnota s dvojitou přesností Subjektivní hodnocení relativní nejistoty o úspěšném dokončení uživatelského příběhu. Mezi platné hodnoty patří: 1 – Vysoká, 2 – Střední a 3 – Nízká.
Microsoft.VSTS.Common.Risk
Závažnost
Severity		 Hodnota s dvojitou přesností Subjektivní hodnocení účinku chyby, problému nebo rizika na projekt. Mezi platné hodnoty patří: 1 – Kritická, 2 – Vysoká, 3 – Střední a 4 – Nízká.
Microsoft.VSTS.Common.Severity
Velikost
Size		 Hodnota s dvojitou přesností Odhad množství práce, kterou požadavek (proces CMMI) vyžaduje k implementaci.
Microsoft.VSTS.Scheduling.Size
Stack Rank
StackRank		 Hodnota s dvojitou přesností Číslo přiřazené procesem na pozadí systému, který se používá k naskládání pořadí nebo sledování posloupnosti položek v backlogu nebo panelu. (Agilní procesy, Scrum a Základní procesy)
Microsoft.VSTS.Common.StackRank
Počáteční datum
StartDate		 DateTime Datum a čas přiřazený pracovní položce pro zahájení práce
Microsoft.VSTS.Scheduling.StartDate
Kraj
State		 Řetězec Aktuální stav pracovní položky Platné hodnoty pro stav jsou specifické pro každý typ pracovní položky a vlastní nastavení provedené v něm.
System.State
Kategorie státu
StateCategory		 Řetězec Kategorie stavů určují, jak Azure Boards a výběr widgetů řídicího panelu zachází s každým stavem pracovního postupu. Mezi používané kategorie stavů patří: Navrhované, Probíhající, Vyřešeno, Odebráno a Dokončeno. Další informace najdete v tématu Použití stavů pracovního postupu a kategorií stavů. Platné pouze pro WorkItemRevision typ entity.
Datum změny stavu
StateChangeDate		 DateTime Datum a čas, kdy se hodnota pole Stát změnila.
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Datum změny stavu pracovní položky vyjádřené YYYYMMDD v časovém pásmu definovaném pro organizaci. Používá se externími nástroji ke spojení souvisejících entit.
StateChangeOn Navigace Vlastnost navigace k entitě Date pro datum změny stavu pracovní položky v časovém pásmu definovaném pro organizaci. Běžně se používá k odkaz na vlastnosti z Date entity v groupby příkazech.
Body příběhu
StoryPoints		 Hodnota s dvojitou přesností Odhad množství práce, kterou uživatelský příběh (agilní proces) vyžaduje k implementaci, běžně agregované jako součet.
Microsoft.VSTS.Scheduling.StoryPoints
Značky
TagNames		 Řetězec Seznam značek oddělených středníkem přiřazených k jedné nebo více pracovním položkám pro účely filtrování nebo dotazování.
System.Tags
Cílové datum
TargetDate		 DateTime Předpokládané datum splnění, do kterého se vyřeší nebo dokončí problém nebo jiná pracovní položka.
Microsoft.VSTS.Scheduling.TargetDate
Typ testovací sady Řetězec Určuje typ testovací sady. Mezi platné hodnoty patří: založené na dotazech, na základě požadavků a statické.
Microsoft_VSTS_TCM_TestSuiteType
ID typu testovací sady Int64 Číslo přiřazené systémem, které odpovídá kategorii testovací sady a vztahuje se pouze na testovací sady. Přiřazené hodnoty jsou: 1 (statické), 2 (založené na dotazech) a 3 (založené na požadavcích).
Microsoft_VSTS_TCM_TestSuiteTypeId
Kritická doba
TimeCriticality		 Hodnota s dvojitou přesností Subjektivní jednotka míry, která zachycuje, jak se obchodní hodnota v průběhu času snižuje. Vyšší hodnoty označují, že námět nebo funkce jsou ze své podstaty důležitější než ty položky s nižšími hodnotami.
Microsoft.VSTS.Common.TimeCriticality
Název
Title		 Řetězec Krátký popis, který shrnuje, co je pracovní položka, a pomáhá členům týmu odlišit ji od ostatních pracovních položek v seznamu.
System.Title
Oblast hodnot
ValueArea		 Řetězec Oblast hodnoty zákazníka adresovaná položkou námětu, funkce nebo backlogu Mezi hodnoty patří: Architektura nebo firma.
Microsoft.VSTS.Common.ValueArea
Vodoznak
Watermark		 Řetězec Pole spravované systémem, které se zvýší o změny provedené v pracovní položce. Platné pro tyto typy entit: WorkItemRevision a WorkItem.
System.Watermark
ID pracovní položky
WorkItemId		 Int32 Jedinečný identifikátor přiřazený pracovní položce. ID pracovních položek jsou jedinečná pro všechny projekty a v rámci organizace nebo kolekce projektů.
System.Id
WorkItemRevisionSK Int32 Jedinečný klíč Analýzy pro revizi pracovní položky, který externí nástroje používají k propojení souvisejících entit.
Typ pracovní položky
WorkItemType		 Řetězec Název typu pracovní položky. Typy pracovních položek se definují na základě procesu použitého při vytváření projektu. Další informace naleznete v tématu O procesech a šablonách procesů.
System.WorkItemType

Navigační vlastnosti v OData jsou referenční atributy entity, která odkazuje na jinou entitu. Následující tabulka obsahuje souhrn navigačních vlastností, jejich referenční omezení a typy entit, pro které jsou platné.

Zobrazovaný název Jméno
Referenční omezení a vlastnost		 Platné pro typy entit
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
Oblasti Area
AreaSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iterací Iteration
IterationSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Přiřazeno AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Autor změny ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Autor CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Aktivoval(a) ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Uzavřeno ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Vyřešeno ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Týmy Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Značky WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projekt Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Procesy WorkItemRevision, WorkItem, WorkItemSnapshot
Revize WorkItem
Odkazy WorkItem
Děti WorkItem
Nadřazený WorkItem
Potomci WorkItem
Workitem WorkItemId WorkItemRevision

Predikce funkcí

Pro entitu WorkItem jsou podporovány následující dvě funkce. Tyto funkce se používají při podpoře prediktivních trendů u vybraných předdefinovaných sestav a widgetů Analytics.

  • PredictTags
  • Predict

BoardLocation a WorkItemBoardSnapshot

Vlastnosti uvedené a popsané v následující tabulce jsou definovány pro následující typy entit, pokud nejsou výslovně uvedeny. Pomocí těchto polí můžete filtrovat data pracovních položek na základě stavu pracovní položky ve sloupci panelu Kanban týmu, plavecké dráhy nebo na úrovni backlogu.

  • BoardLocation
  • WorkItemBoardSnapshot

Příklad, který dotazuje WorkItemBoardSnapshot sadu entit, viz ukázková sestava diagramu kumulativního toku (CFD).

Zobrazovaný název
Property name		 Datový typ Popis
Reference name
ID panelu
BoardId		 Guid Jedinečný identifikátor GUID přiřazený k panelu Kanban. Každý tým je přidružený k jednomu nebo více panelům Kanbanu.
Název referenčního odkazu na kategorii panelu
BoardCategoryReferenceName		 Řetězec Název přiřazený kategorii typů pracovních položek, které slouží k naplnění panelu Kanban. Například panel backlogu produktu je přidružený k kategorii Požadavky. Další informace najdete v tématu Přizpůsobení backlogů nebo panelů (proces dědičnosti).
Název panelu
BoardName		 Řetězec Název přiřazený panelu Kanban. Například scénáře, položky backlogu, funkce a náměty.
Úroveň panelu
BoardLevel		 Int32 Číslo přiřazené tabuli Kanbanu podle toho, kde se nachází v hierarchii panelů Kanbanu.
Typ backlogu
BacklogType		 Řetězec Název typu backlogu. Například iterace, požadavek nebo portfolio.
Název sloupce
ColumnName		 Řetězec Název sloupce panelu Kanbanu, kterému je aktuálně přiřazena pracovní položka, například Aktivní, Uzavřeno, Potvrzeno, Hotovo nebo Jiný vlastní popisek sloupce.
System.BoardColumn
Pořadí sloupců
ColumnOrder		 Int32 Číslo přiřazené ke sloupci panelu Kanban z hlediska jeho posloupnosti v rámci panelu Kanban.
Udělal
Done		 Enumerated Označuje umístění rozděleného sloupce. Platné hodnoty jsou uvedeny níže pro BoardColumnSplit.
Limit počtu položek sloupce
ColumnItemLimit		 Int32 Číslo přiřazené sloupci panelu Kanban z hlediska jeho posloupnosti.
Je viditelné panel
IsBoardVisible		 Boolean Označuje, jestli se tým rozhodl, aby byl panel viditelný nebo ne.
Je rozdělení sloupce
IsColumnSplit		 Boolean Označuje, jestli byl sloupec rozdělený na sloupce Probíhá a Hotovo , jak je popsáno v části Rozdělení sloupců na panelu Kanban, aby se zobrazila probíhající práce.
Je aktuální
IsCurrent		 Boolean Vlastnost, která podporuje filtrování dat pro zobrazení nejnovějšího snímku filtrované sady pracovních položek nastavením hodnoty na True.
Je výchozí pruh
IsDefaultLane		 Boolean Vlastnost, která označuje, že pracovní položka je přiřazena k výchozí plavecké dráhy (True) nebo ne (False).
Hotovo
IsDone		 Boolean Aktuální přiřazení pracovní položky k provádění (Nepravda) nebo Hotovo (True) ve sloupci Kanban. Přiřazeno pouze v případě, že je pro sloupec panelu Kanban povolen rozdělení sloupců .
System.BoardColumnDone
ID pruhu
LaneId		 Guid Jedinečný identifikátor GUID přiřazený plaveckému pruhu kanbanu. Každý tým může přidat jeden nebo více plavecké dráhy na palubu Kanbanu. Další informace o plaveckých drahách najdete v tématu Zrychlení práce vašeho týmu pomocí plavecké dráhy na palubě Kanbanu.
Název pruhu
LaneName		 Řetězec Název přiřazený plavecké plavecké dráhy kanbanu.
System.BoardLane
Pořadí pruhů
LaneOrder		 Int32 Číslo přiřazené plavecké plavecké dráhy Kanbanu z hlediska jeho posloupnosti.

BoardColumnSplit – výčet členů

V následující tabulce jsou uvedeny názvy členů pro BoardColumnSplit výčtový typ, které lze použít k filtrování pracovních položek ve sloupci panelu Probíhá nebo Hotovo .

Název členu Hodnota Zobrazované jméno
Doing 0 Dělá
Done 0 Hotovo
Unknown 2 Neznámé (není rozděleno)

Další informace o sloupcích panelu pro tým najdete v následujících článcích:

Oblasti

Následující vlastnosti jsou platné pro sadu entit Oblasti , která je přidružena k poli Cesta k oblasti. Náhradní klíče přidružené k oblasti zahrnují AreaSK a ProjectSK. Pomocí těchto vlastností můžete filtrovat nebo hlásit data sledování práce na základě přiřazení cesty oblasti.

Zobrazovaný název Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
Number Int32 Celočíselná hodnota přiřazená uzlu Cesta k oblasti při jeho vytvoření.
Hloubka Depth Int32 Úroveň, na které je cesta k oblasti definována na základě jeho hloubky od kořenové úrovně.
ID oblasti AreaId Identifikátor GUID Jedinečný identifikátor přiřazený k cestě oblasti při jeho vytvoření
Úroveň oblasti 1 až
Úroveň oblasti 14		 AreaLevel1 Prostřednictvím
AreaLevel14		 Řetězec Název přidružený k úrovni uzlu cesty k oblasti. Podporuje se až 14 vnořených úrovní. Například úroveň oblasti 1 vždy odpovídá kořenovému uzlu a názvu projektu.
Název oblasti AreaName Řetězec Název definovaný pro cestu oblasti při jeho vytvoření
Cesta k oblasti AreaPath Řetězec Úplná cesta k cestě oblasti začínající kořenovým uzlem.

Důležité

Odstranění cest oblasti nebo změna konfigurace cest iterace může způsobit ztrátu dat a nejde je vrátit zpět. Například grafy burndownu nebo burnup widgetů, burndown sprintu a grafy rychlosti pro týmy, jejichž cesty oblasti se mění, nebudou odrážet správná data. Grafy historických trendů odkazují na cestu oblasti a cestu iterace definované v bodě v minulosti pro každou pracovní položku. Když se odstraní cesta k oblasti nebo cesta iterace, historická data pro ni nelze načíst.

Navigační vlastnosti pro typ entity Oblasti a sadu entit Oblasti zahrnují Project a Teams.

Další informace o cestách oblastí najdete v následujících článcích:

Iterace

Následující vlastnosti jsou platné pro sadu entit Iterací , která je přidružena k poli Cesta iterace. Náhradní klíče přidružené k iteraci zahrnují IterationSK a ProjectSK. Pomocí těchto vlastností můžete filtrovat nebo hlásit data sledování práce na základě přiřazení cesty iterace.

Zobrazovaný název Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
Number Int32 Celočíselná hodnota přiřazená uzlu Cesta iterace při jeho vytvoření.
Hloubka Depth Int32 Úroveň, na které je definována cesta iterace na základě jeho hloubky z kořenové úrovně.
Koncové datum EndDate DateTime Koncové datum definované pro cestu iterace
IsEnded IsEnded Boolean Pokud je nastavená hodnota True, znamená to, že koncové datum cesty iterace je v minulosti.
ID iterace IterationId Identifikátor GUID Jedinečný identifikátor přiřazený cestě iterace při jeho vytvoření
Iterace úrovně 1 až
Iterace úrovně 14		 IterationLevel1 Prostřednictvím
IterationLevel14		 Řetězec Název přidružený k úrovni uzlu cesty iterace. Podporuje se až 14 vnořených úrovní. Například úroveň iterace 1 vždy odpovídá kořenovému uzlu a názvu projektu.
Název iterace IterationName Řetězec Název definovaný pro cestu iterace při jeho vytvoření
Cesta iterace IterationPath Řetězec Úplná cesta cesty iterace počínaje kořenovým uzlem. Iterace musí být platným uzlem v hierarchii projektu.
System.IterationPath
Počáteční datum StartDate DateTime Počáteční datum definované pro cestu iterace

Důležité

Odstranění cest oblasti nebo změna konfigurace cest iterace může způsobit ztrátu dat a nejde je vrátit zpět. Například grafy burndownu nebo burnup widgetů, burndown sprintu a grafy rychlosti pro týmy, jejichž cesty oblasti se mění, nebudou odrážet správná data. Grafy historických trendů odkazují na cestu oblasti a cestu iterace definované v bodě v minulosti pro každou pracovní položku. Když se odstraní cesta k oblasti nebo cesta iterace, historická data pro ni nelze načíst.

Navigační vlastnosti pro typ entity iterace a sadu iterací entity včetně Project a Teams.

Další informace o cestách iterace najdete v následujících článcích:

Procesy

Následující vlastnosti jsou platné pro typ entity Process a Process entity set. Náhradní klíče spojené s procesem zahrnují ProcessSK, ProjectSKa TeamSK. Pomocí těchto vlastností můžete filtrovat nebo hlásit data sledování práce na základě typů pracovních položek používaných projektem nebo týmem.

Poznámka:

Sada entit Process a Process entity jsou podporovány ve verzích Analytics v-2.0, v3.0-Preview a v4.0-Preview.

Tyto vlastnosti můžete použít k filtrování dat sledování práce na základě úrovně backlogu.

Zobrazovaný název Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
ProjectSK Identifikátor GUID Klíč projektu přidružený k procesu
TeamSK Identifikátor GUID Klíč týmu přidružený k procesu
Název odkazu na kategorii backlogu BacklogCategoryReferenceName Řetězec Název odkazu na kategorii přiřazený k backlogu přidruženému k typu pracovní položky. Příklady: Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Název backlogu BacklogName Boolean Název odkazu přiřazený k backlogu přidruženému k typu pracovní položky
Typ backlogu BacklogType Identifikátor GUID Jedinečný identifikátor přiřazený cestě iterace při jeho vytvoření
Úroveň backlogu BacklogLevel Řetězec Určuje úroveň backlogu přidruženou k typu pracovní položky. Pokud typ pracovní položky není přidružen k úrovni backlogu, vrátí se nullhodnota .
Typ pracovní položky WorkItemType Řetězec Název definovaný pro typ pracovní položky
Obsahuje backlog HasBacklog Řetězec Určuje, jestli typ pracovní položky patří do backlogu.
Je skrytý typ. IsHiddenType Boolean Označuje, jestli je typ pracovní položky zakázaný.
Je typ chyby IsBugType Boolean Určuje, jestli typ pracovní položky patří do kategorie Chyba.
Je odstraněno. IsDeleted Boolean Označuje, jestli byl typ pracovní položky odstraněn.

Další informace o backlogech procesů a typech pracovních položek najdete v následujících článcích:

Vlastní typy pracovních položek a vlastní kategorie backlogu

Data pro vlastní typy pracovních položek se automaticky přidají do služby Analytics.

Vlastní kategorie se vytvoří, když se definuje vlastní typ pracovní položky a úroveň backlogu. Custom_ je předpřipravený k identifikátoru GUID kategorie. Například pro typ vlastní pracovní položky portfolia s backlogem Portfolia je identifikátor GUID přiřazen k vlastní kategorii, například Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

Značky

Následující vlastnosti jsou platné pro sadu entit Značky . Náhradní klíče přidružené ke značce include TagSK a ProjectSK. Navigační vlastnosti zahrnují Project a jeho referenční omezení ProjectSK. Další informace o používání značek najdete v tématu Přidání značek pracovních položek pro kategorizaci a filtrování seznamů a panelů.

Tyto vlastnosti můžete použít k filtrování nebo sestavám dat sledování práce.

Zobrazovaný název Název Datový typ Popis
ID značky TagId Identifikátor GUID Jedinečné ID přiřazené značce při jejím vytvoření
Název značky TagName Řetězec Název značky.

Teams

Následující vlastnosti jsou platné pro typ entity Týmu a sadu entit Teams . Náhradní klíče přidružené k týmu zahrnují TeamSK a ProjectSK. Tyto vlastnosti můžete použít k filtrování nebo hlášení dat sledování práce na základě týmových přiřazení. Informace o používání a přidávání týmů najdete v tématu O týmech a agilních nástrojích a vytvoření nebo přidání týmu.

Zobrazovaný název Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
ID týmu TeamId Identifikátor GUID Jedinečné ID přiřazené týmu při jeho vytvoření.
Název týmu TeamName Řetězec Název týmu.

Mezi navigační vlastnosti sady entit Teams patří Projects, Areasa Iterations.

Následující vlastnosti jsou platné pro sadu entit WorkItemLinks . Náhradní klíč odkazu na vlastnost je WorkItemLinkSK. Dotazování WorkItemLinks pro sestavu nadřazeného/podřízeného, souvisejícího, předchůdce/následníka nebo jiných typů propojení

Zobrazovaný název Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
WorkItemLinkSK Int32 Náhradní klíč přiřazený k entitě WorkItemLink .
Datum vytvoření CreatedDate Identifikátor GUID Datum vytvoření odkazu
Komentář Comment Řetězec Komentář byl přidán při vytvoření odkazu.
Datum odstranění DeletedDate Řetězec Datum odstranění odkazu
ID typu odkazu LinkTypeId Int32 ID přiřazené cílové pracovní položce propojené s.
Název typu odkazu LinkTypeName Řetězec Popisný název přiřazený k typu odkazu.
Název odkazu typu odkazu LinkTypeReferenceName Řetězec Název odkazu přiřazený k typu odkazu.
Typ propojení je acyklické LinkTypeIsAcyclic Boolean Hodnota atributu typu propojení, který označuje typ propojení, umožňuje cyklický vztah, pokud je hodnota nastavena na Hodnotu True. Například propojení typu stromu omezují cyklický vztah.
Typ odkazu je směrový LinkTypeIsDirectional Boolean Hodnota atributu typu propojení, který označuje typ propojení, je směrový. Směrové typy propojení jsou definovány ve dvojicích s dopředu a obrácenou komponentou.
ID zdrojové pracovní položky SourceWorkItemId Int32 ID přiřazené ke zdrojové pracovní položce propojené.
ID cílové pracovní položky TargetWorkItemId Int32 ID přiřazené cílové pracovní položce propojené s.

Navigační vlastnosti pro typ entity WorkItemLink zahrnují Projects, SourceWorkItema TargetWorkItem.

Další informace o odkazech a typech odkazů najdete v následujících článcích:

WorkItemTypeFields

Následující vlastnosti jsou platné pro sadu entity WorkItemTypeFields . Referenční klíče vlastností jsou FieldName, ProjectSKa WorkItemType.

Zobrazovaný název Název Datový typ Popis
Název pole FieldName Řetězec Popisný název přiřazený k poli systémem nebo při jeho vytvoření.
Název odkazu na pole FieldReferenceName Řetězec Název odkazu přiřazený k poli systémem nebo při vytvoření vlastního pole
Typ pole FieldType Řetězec Datový typ přiřazený k poli
Typ pracovní položky WorkItemType Řetězec Název typů pracovních položek, pro které je definováno pole.

Mezi navigační vlastnosti patří Project.

Index všech polí definovaných pro projekt najdete v popisu polí pracovních položek. Další informace naleznete v následujících článcích:

Uživatelské vlastnosti

Vlastní pole se automaticky přidají do služby Analytics jako vlastní vlastnost. Custom_ nebo Custom. je před názvem vlastnosti. Zkontrolujte metadata vaší kolekce, jak je popsáno v části Vytváření dotazů OData pro analýzu, komponenty adresy URL pro dotazování na metadata. Následující příklad poskytuje syntaxi metadat pro vlastní pole Riziková příležitost.

<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>