Teilen über

Metadatenreferenz für Azure Boards Analytics

  • Artikel

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

Der Analytics-Dienst erfasst alle aktivitäten, die über Azure Boards definiert und aktualisiert wurden. Analytics speichert alle Felder für die Arbeitsnachverfolgung als Eigenschaften, mit Ausnahme von HTML-/Rich-Text- und Verlaufsfeldern. Benutzerdefinierte Eigenschaften für benutzerdefinierte Felder werden automatisch zu Analytics hinzugefügt.

In diesem Artikel werden die meisten Eigenschaften beschrieben, die Sie zum Generieren eines Analyseberichts für die Arbeitsnachverfolgung verwenden können. Sie verwenden eine Kombination von Eigenschaften, um eine Abfrage zu filtern, Daten zu aggregieren oder einen Bericht zu erstellen. Sie können diese Abfragen direkt in Ihrem Browser ausführen. Weitere Informationen finden Sie unter Definieren grundlegender Abfragen mithilfe von OData Analytics. Wenn Sie noch nicht mit der Arbeitsverfolgung und Azure Boards arbeiten, empfehlen wir Ihnen, die folgenden Artikel zu lesen:

Hinweis

Beschreibungen der Entitäten, Eigenschaften und enumerierten Typen, die vom Analytics-Datenmodell unterstützt werden, werden bereitgestellt. Dies ist ein früher Entwurf. Bitte geben Sie Feedback zu Bereichen, die Sie gerne mehr Informationen haben möchten. Informationen zum Abfragen des Datenmodells finden Sie unter Erstellen von OData-Abfragen für Analytics.

Übersicht über Entitätssätze

Verwenden Sie beim Abfragen von Analytics nach Arbeitsverfolgungsdaten einen der folgenden Entitätstypen oder Entitätssätze.

  • Abfragen WorkItems zum Generieren von status- und Rollupberichten
  • Abfragen WorkItemSnapshot zum Generieren von Trend-, Burndown- und Burnupberichten

Verwenden Sie andere Entitätstypen, zArea. B. , IterationProject, , Teamoder andere Entitäten, um Daten zu filtern oder Eigenschaften auszuwählen, über die Bericht erstellt werden soll. Eine Zusammenfassung der Beispielberichte finden Sie unter Beispielberichte und Kurzübersichtsindex.

Hinweis

Um status- und Trendberichte für testspezifische Arbeitselementtypen zu generieren, fragen Sie die WorkItems Entitätstypen und abWorkItemSnapshot, und filtern Sie basierend auf dem Arbeitselementtyp. Um Informationen zu Testläufen, Testergebnissen oder anderen Testdaten zu erhalten, fragen Sie die Entitätstypen TestRuns, TestPoints, TestResultsDailyTestSuite oder TestPointHistorySnapshot ab. Weitere Informationen finden Sie unter Testmetadatenreferenz für Azure DevOps.

EntitySet EntityType Beschreibung
Bereichen Bereich Das Arbeitselement Bereichspfade mit Eigenschaften zum Gruppieren und Filtern nach Bereichshierarchie.
Datumsangaben CalendarDate Die Datumsangaben, die zum Filtern und Gruppieren anderer Entitäten mithilfe von Beziehungen verwendet werden.
Iterationen Iteration Das Arbeitselement Iterationspfade mit Eigenschaften zum Gruppieren und Filtern nach Iterationshierarchie.
BoardLocations BoardLocation Die Boardzellenpositionen, wie durch Boardspalte, Verantwortlichkeitsbereich und Split identifiziert, umfassen historische Boardeinstellungen. Eine Beschreibung der einzelnen Tafelfelder finden Sie unter Workflow- und Board-Felder.
Prozesse Process Backloginformationen, die zum Erweitern oder Filtern von Arbeitselementen und Arbeitselementtypen verwendet werden. Ein Beispiel, das Prozesse zum Filtern eines Berichts verwendet, finden Sie unter Beispielbericht zur Anforderungsnachverfolgung. Unterstützt für Analytics Version 2.0 und höher.
Projekte Projekt Alle Projekte, die für eine organization (Cloud) oder Projektsammlung (lokal) definiert sind.
Schilder Tag Alle Arbeitselementtags für jedes Projekt. Ein Beispiel, das Tags zum Filtern eines Berichts verwendet, finden Sie unter Release burndown sample report.
Teams Team Alle Teams, die für das Projekt definiert sind. Ein Beispiel, in dem Teams zum Filtern eines Berichts verwendet wird, finden Sie unter Hinzufügen eines Team-Slicers zu einem Power BI-Bericht.
Benutzer Benutzer Benutzerinformationen, die zum Erweitern oder Filtern verschiedener Arbeitselementeigenschaften verwendet werden, z. B . Zugewiesen an, Erstellt von.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Zusammengesetzt) Der Status jeder Arbeitsaufgabe an jedem Kalenderdatum, einschließlich des Boardstandorts, der zum Generieren von Trendberichten verwendet wird. Einen Beispielbericht finden Sie unter Cfd-Beispielbericht (Cumulative Flow Diagram).
WorkItemLinks WorkItemLink Die Verknüpfungen zwischen Arbeitselementen, z. B . Untergeordnete Elemente, Übergeordnete Elemente und Verwandte Elemente. Enthält nur die neueste Revision von Links, keinen Verlauf. Hyperlinks sind nicht enthalten.
WorkItemRevisions WorkItemRevision Alle überarbeitungen von historischen Arbeitselementen, einschließlich der aktuellen Revision. Schließt keine gelöschten Arbeitselemente ein.
WorkItemSnapshot WorkItemSnapshot (Zusammengesetzt) Der Status der einzelnen Arbeitselemente an jedem Kalenderdatum, der zur Unterstützung der Trendberichterstattung verwendet wird. Einen Beispielbericht finden Sie unter Beispielbericht zu Fehlertrends.
WorkItems Workitem Der aktuelle Status von Arbeitselementen. Wird verwendet, um status Berichte zu unterstützen. Einen Beispielbericht finden Sie unter Rollup untergeordneter Arbeitselementwerte in einen übergeordneten Beispielbericht.
WorkItemTypeFields WorkItemTypeField Die Arbeitselementeigenschaften für jeden Arbeitselementtyp und -prozess. Wird verwendet, um das Erstellen von Berichten zu unterstützen.

Informationen zu Momentaufnahmen

Es gibt zwei Arbeitsnachverfolgungs- Momentaufnahme Entitätssätze: WorkItemSnapshot und WorkItemBoardSnapshot.

Ein Momentaufnahme stellt täglich einen Datensatz der für ein Arbeitselement definierten Werte bereit. Der Datensatz wird täglich zur gleichen Zeit in Analytics geschrieben. Sie verwenden Momentaufnahmen, wenn Sie einen Trendbericht generieren möchten. Standardmäßig werden alle Momentaufnahme Tabellen als tägliche Momentaufnahme Faktentabellen modelliert. Wenn Sie einen Zeitraum abfragen, wird ein Wert für jeden Tag abgerufen. Lange Zeitbereiche führen zu einer großen Anzahl von Datensätzen. Wenn Sie diese hohe Genauigkeit nicht benötigen, können Sie wöchentliche oder sogar monatliche Momentaufnahmen verwenden.

Weitere Informationen finden Sie unter OData-Abfragerichtlinien, verwenden Sie wöchentliche oder monatliche Momentaufnahmen für Trendabfragen, die einen langen Zeitraum umfassen.

Informationen zu Überarbeitungen von Arbeitselementen

Jedes Mal, wenn Sie ein Arbeitselement aktualisieren, erstellt das System eine neue Revision und zeichnet diese Aktion im Feld auf, wodurch sie für die System.RevisedDate Angabe eines Verlaufsfilters nützlich ist. Das überarbeitete Datum wird durch RevisedDate die Eigenschaften (DateTime) und RevisedDateSK (Int32) dargestellt. Um eine optimale Leistung zu erzielen, verwenden Sie den letzten Datumsersatzschlüssel. Sie stellt das Datum dar, an dem eine Revision erstellt wurde, oder es hat NULL für aktive oder unvollständige Revisionen.

Wenn Sie alle Datumsangaben seit dem Inklusiven {startDate} wünschen, fügen Sie der Abfrage den folgenden Filter hinzu.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Sie verwenden den WorkItemRevisions Entitätssatz, um alle Revisionen für ein bestimmtes Arbeitselement zu laden. Die Abfrage gibt alle historischen Überarbeitungen von Arbeitselementen zurück, einschließlich der aktuellen Revision, für die Arbeitselemente, nach denen Sie filtern. Es enthält keine gelöschten Arbeitselemente.

Freigegebene Eigenschaften über mehrere Entitätstypen hinweg

Die Eigenschaften, die Sie in einer Analyseansicht auswählen können, entsprechen regulären Arbeitsnachverfolgungsfeldern und wählen Analyseeigenschaften aus, z. B. Zykluszeittage und Vorlaufzeittage. Diese Eigenschaften, von denen die meisten in der folgenden Tabelle aufgeführt und beschrieben werden, werden für die folgenden Entitätstypen definiert, sofern nicht anders angegeben.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Hinweis

Der Analytics-Dienst speichert keine Daten für lange Textfelder, denen der Datentyp HTML oder Rich Text zugewiesen ist. Dies umfasst die Felder "Beschreibung" und "Verlauf ". Analytics speichert auch keine Link- oder Angefügten Dateianzahlen. Eine vollständige Liste der Felder, die in den Standardprozessvorlagen definiert sind, finden Sie unter Arbeitselementfeldindex. Beschreibungen der einzelnen Datentypen finden Sie unter Abfragefelder, Operatoren und Makros.
Nicht alle Eigenschaften, die den prozessspezifischen Scrum- und CMMI-Feldern zugeordnet sind, sind in der folgenden Tabelle enthalten. Eine Liste dieser Felder finden Sie unter Feldbeschreibungen für Standard- und Arbeitselementfelder, die in Prozessvorlagen verwendet werden, Felder, die zum Nachverfolgen von CMMI-Arbeitselementen verwendet werden.

Viele Eigenschaften sind datums- oder benutzerbasiert. Diese Eigenschaften sind den Entitätssätzen CalendarDate und User zugeordnet, die unter Kalenderdatum, Projekt und Benutzermetadatenreferenz beschrieben sind.

Anzeigename
Property name		 Datentyp Beschreibung
Reference name
Akzeptiert von
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Name der Person, die auf eine Codeüberprüfung geantwortet hat. (CMMI-Prozess)
Microsoft.VSTS.CodeReview.AcceptedBy
Datum der Akzeptierung
AcceptedDate		 DateTime Datum und Uhrzeit, zu dem die Person auf die Codeüberprüfung geantwortet hat. (CMMI-Prozess)
Microsoft.VSTS.CodeReview.AcceptedDate
Aktiviert von
ActivatedBy
ActivatedByUserSK		 UserSK Name des Teammitglieds, das das Arbeitselement aktiviert oder reaktiviert hat.
Microsoft.VSTS.Common.ActivatedBy
Aktivierungsdatum
ActivatedDate		 DateTime Datum und Uhrzeit, zu dem ein Teammitglied einen Fehler oder ein Arbeitselement aktiviert oder reaktiviert hat.
Microsoft.VSTS.CodeReview.ActivatedDate
Aktivität
Activity		 String Der Aktivitätstyp, der zum Ausführen einer Aufgabe erforderlich ist.
Microsoft.VSTS.Common.Activity

Der Typ der Aktivität oder Fachrichtung, der einer Aufgabe zugewiesen ist. Zulässige Werte sind: Bereitstellung, Entwurf, Entwicklung, Dokumentation, Anforderungen und Tests. (Agile, Scrum und Basic Process)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Die Daten und der Zeitpunkt der letzten Aktualisierung der Entität.
Anwendungstyp String Der Typ der Anwendung, zu dem Projektbeteiligte Feedback bereitstellen. Die Standardwerte sind Webanwendung, Remotecomputer und Clientanwendung. Die gültigen Typen werden in der Prozesskonfigurationsdatei für Projekte angegeben, die einen lokalen XML-Prozess verwenden.
Microsoft_VSTS_Feedback_ApplicationType
Bereichspfad
AreaPath
AreaSK		 String Gruppiert die Arbeitselemente in Produktfunktions- oder Teambereiche. Der Bereich muss ein gültiger Knoten in der Projekthierarchie sein.
System.AreaPath
Zugewiesen zu
AssignedTo
AssignedToUserSK		 UserSK Der Name des Teammitglieds, das das Arbeitselement derzeit besitzt.
System.AssignedTo
Automatisierte Test-ID
AutomatedTestId		 String Die ID des Tests, der den Testfall automatisiert.
Microsoft.VSTS.TCM.AutomatedTestId
Name des automatisierten Tests
AutomatedTestName		 String Name des Teammitglieds, das das Arbeitselement aktiviert oder reaktiviert hat.
Microsoft.VSTS.TCM.AutomatedTestName
Speicher des automatisierten Tests
AutomatedTestStorage		 String Die Assembly mit dem Test, der den Testfall automatisiert.
Microsoft.VSTS.TCM.AutomatedTestStorage
Typ des automatisierten Tests
AutomatedTestType		 String Der Typ des Tests, der den Testfall automatisiert.
Microsoft.VSTS.TCM.AutomatedTestType
Automatisierungsstatus
AutomatedStatus		 String Die status eines Testfalls mit den folgenden akzeptierten Werten: Automatisiert, Nicht automatisiert oder Geplant.
Microsoft.VSTS.TCM.AutomationStatus
Backlog Priorität
BacklogPriority		 Double Eine Zahl, die von einem Systemhintergrundprozess zugewiesen wird, der zum Stapeln von Rangfolgen oder Nachverfolgen der Sequenz von Elementen in einem Backlog oder Board verwendet wird. (Scrum-Prozess)
Microsoft.VSTS.Common.BacklogPriority
Blockiert
Blocked		 String Gibt an, dass keine weiteren Arbeiten für das Arbeitselement ausgeführt werden können. Gültige Werte sind Ja oder Nein. (CMMI-Prozess)
Microsoft.VSTS.CMMI.Blocked
Geschäftswert
BusinessValue		 Double Eine subjektive Maßeinheit, die den relativen Geschäftswert eines Product Backlog Items oder Funktionen im Vergleich zu anderen Elementen des gleichen Typs erfasst. Ein Element, dem eine höhere Zahl zugewiesen ist, hat in der Regel einen höherem Geschäftswert als ein Element, dem eine niedrigere Zahl zugewiesen ist.
Microsoft.VSTS.Common.BusinessValue
Geändert durch
ChangedBy
ChangedByUserSK		 UserSK Der Name der Person, die das Arbeitselement zuletzt geändert hat.
System.ChangedBy
Änderungsdatum
ChangedDate		 DateTime Datum und Uhrzeit der Änderung des Arbeitselements.
System.ChangedDate
ChangedDateSK Int32 Das Datum, an dem das Arbeitselement geändert wurde, ausgedrückt in YYYYMMDD der Zeitzone, die für die organization definiert ist. Wird von externen Tools verwendet, um verwandte Entitäten zu verknüpfen.
ChangedOn Navigation Navigationseigenschaft für die Date Entität für das Datum, an dem das Arbeitselement geändert wurde, in der Zeitzone, die für die organization definiert ist. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby Anweisungen zu verweisen.
Geschlossen durch
ClosedBy
ClosedByUserSK		 UserSK Der Name der Person, die eine Arbeitsaufgabe geschlossen hat.
Microsoft.VSTS.Common.ClosedBy
Geschlossen am
ClosedDate
ClosedDateSK
ClosedOn		 DateTime Datum und Uhrzeit des Schließens eines Arbeitselements.
Microsoft.VSTS.Common.ClosedDate
Kommentaranzahl
CommentCount		 Int32 Die Anzahl der Kommentare, die dem Abschnitt "Diskussion " des Arbeitselements hinzugefügt wurden.
System.CommentCount
Verpflichtet
Committed		 String Gibt an, ob die Anforderung im Projekt festgelegt wird. Gültige Werte sind Ja oder Nein. (CMMI-Prozess)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Von Analytics erfasstes Navigationseigenschaftendatum, das speichert, wenn das Arbeitselement in einen Workflowstatus eingegeben wurde, der der Kategorie "Workflowstatus abgeschlossen" zugeordnet ist.
CompletedOn Navigation Navigationseigenschaft für die Date Entität für das Datum, an dem das Arbeitselement einen Workflowstatus eingegeben hat, der der Kategorie Abgeschlossener Workflowstatus in der für den organization definierten Zeitzone zugeordnet ist. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby Anweisungen zu verweisen.
Abgeschlossene Arbeit
CompletedWork		 Double Ein Maß für den Arbeitsaufwand, der in eine Aufgabe investiert wurde.
Microsoft.VSTS.Scheduling.CompletedWork
Erstellt von
CreatedBy
CreatedByUserSK		 UserSK Der Name der Person, die das Arbeitselement erstellt hat.
Microsoft.VSTS.Common.CreatedBy
Erstellt am
CreatedDate
CreatedDateSK		 DateTime Das Datum, an dem das Arbeitselement erstellt wurde, ausgedrückt in der Zeitzone, die für die organization definiert ist. Wird häufig zum Filtern und zur Anzeige verwendet.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Das Datum, an dem das Arbeitselement erstellt wurde, ausgedrückt in YYYYMMDD der Zeitzone, die für die organization definiert ist. Wird von externen Tools verwendet, um verwandte Entitäten zu verknüpfen.
CreatedOn Navigation Navigationseigenschaft für die Date Entität für das Erstellungsdatum des Arbeitselements in der Zeitzone, die für die organization definiert ist. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby Anweisungen zu verweisen.
Zykluszeittage
CycleTimeDays		 Double Die Zykluszeit wird von der ersten Eingabe einer Statuskategorie "In Bearbeitung" oder "Aufgelöst" bis zur Eingabe einer Statuskategorie "Abgeschlossen" berechnet. Weitere Informationen finden Sie unter Lead Time and Cycle Time Widgets.
Disziplin
Discipline		 String Der Typ der Aktivität oder Fachrichtung, der einer Aufgabe zugewiesen ist. Zulässige Werte sind : Analysis*, Development, Test, User Education und User Experience. (CMMI-Prozess)
Microsoft.VSTS.Common.Activity
Fälligkeitsdatum
DueDate		 DateTime Das prognostizierte Fälligkeitsdatum, bis zu dem ein Problem oder Arbeitselement behoben wird. (Agiler Prozess)
Microsoft.VSTS.Scheduling.DueDate
Aufwand
Effort		 Double Eine Schätzung für den Arbeitsaufwand, den ein Product Backlog-Element (Scrum-Prozess) oder ein Problem (Basic-Prozess) implementieren muss.
Microsoft.VSTS.Scheduling.Effort
Beendigungsdatum
FinishDate		 DateTime Datum und Uhrzeit, an dem der Zeitplan angibt, dass ein Arbeitselement abgeschlossen wird.
Microsoft.VSTS.Scheduling.FinishDate
Gefunden in
FoundIn		 String Die Produktbuildnummer bzw. die Revision, in der ein Fehler gefunden wurde.
Microsoft.VSTS.Build.FoundIn
InProgress-Datum
InProgressDate		 DateTime Das gespeicherte Analytics-Datum erfasst das Datum und die Uhrzeit, zu der ein Arbeitselement in einen Zustand verschoben wurde, der zur Statuskategorie "In Bearbeitung" gehört.
InProgressDateSK Int32 Das Datum, an dem das Arbeitselement in einen Zustand verschoben wurde, der zur Statuskategorie In Bearbeitung gehört, ausgedrückt als YYYYMMDD in der Zeitzone, die für die organization definiert ist. Wird von externen Tools verwendet, um verwandte Entitäten zu verknüpfen.
Integrationsbuild
IntegrationBuild		 String Die Produktbuildnummer, in der der Code enthalten ist oder ein Fehler behoben wird.
Microsoft.VSTS.Build.IntegrationBuild
Ist aktuell
IsCurrent		 Boolean Unterstützt das Filtern der Daten, um die neuesten Momentaufnahme des gefilterten Arbeitselementesatzes anzuzeigen, indem der Wert auf festgelegt wirdTrue.
Gültig für diese Entitätstypen: WorkItemRevision, WorkItemBoardSnapshotund BoardLocation.
Ist letzte Überarbeitung des Tages
IsLastRevisionOfDay		 Boolean Gibt an, dass der Momentaufnahme die letzte Revision des Tages darstellt, wenn auf Truefestgelegt ist.
Ist letzte Revision des Zeitraums
IsLastRevisionOfPeriod		 Boolean Gibt an, dass der Momentaufnahme die letzte Revision des Zeitraums darstellt, wenn auf Truefestgelegt wird.
Problem
Issue		 String Gibt an, dass einem freigegebenen Schritt ein erwartetes Ergebnis zugeordnet ist. Zulässige Werte sind Ja und Nein.
Microsoft.VSTS.Common.Issue
Vorlaufzeittage
LeadTimeDays		 Double Die Durchlaufzeit wird von der Erstellung eines Arbeitselements oder der Eingabe einer Kategorie "Vorgeschlagener Zustand" bis zur Eingabe einer Statuskategorie "Abgeschlossen" berechnet. Weitere Informationen finden Sie unter Lead Time and Cycle Time Widgets.
Ursprüngliche Schätzung
OriginalEstimate		 Double Ein Maß für den Arbeitsaufwand, der zum Abschluss einer Aufgabe erforderlich ist.
Microsoft.VSTS.Scheduling.OriginalEstimate
Übergeordnete Arbeitselement-ID
ParentWorkItemId		 Int32 Die eindeutige ID, die das Arbeitselement identifiziert, das als übergeordnetes Element verknüpft ist. Nützlich zum Generieren von Rollupberichten. Das Übergeordnete Feld ist ab Azure DevOps Server 2020 und höheren Versionen verfügbar. Gültig für diese Entitätstypen: WorkItemRevision und WorkItem.
System.Parent
Priority
Priority		 Int32 Eine subjektive Bewertung des Fehlers, des Problems, der Aufgabe oder des Testfalls mit seinen Auswirkungen auf das Geschäft. Die Werte umfassen: - 1, 2 oder 3.
Microsoft.VSTS.Common.Priority
Projektname
ProjectName		 Navigation Name des Projekts, zu dem das Arbeitselement gehört. Ausführliche Informationen finden Sie unter Kalenderdatum, Projekt- und Benutzermetadatenreferenz, Projekteigenschaften.
System.TeamProject
ProjectSK GUID GUID, die dem Projekt zugewiesen ist, zu dem das Arbeitselement gehört.
Rating
Reason		 String Die Anzahl von Sternen, die ein Element von einem Reviewer in einem sternbasierten Bewertungssystem erhält. (Feedbackantwort) Die Zahl wird im System gespeichert und wie folgt geschrieben: - 0 - Nicht bewertet, 1 - Schlecht, 2 - Fair, 3 - Gut, 4 - Sehr gut und 5 - Ausgezeichnet. Gültig für diese Entitätstypen: WorkItemRevision und WorkItem.
Microsoft.VSTS.Common.Rating
`Reason`
Reason		 String Der Grund für den aktuellen Status der Arbeitsaufgabe. Jeder Übergang von einem Workflowzustand zu einem anderen wird mit einem entsprechenden Grund verknüpft.
System.Reason
Verbleibende Arbeit
RemainingWork		 Double Ein Maß für den verbleibenden Arbeitsaufwand für die Fertigstellung einer Aufgabe.
Microsoft.VSTS.Scheduling.RemainingWork
Gelöst von
ResolvedBy
ResolvedByUserSK		 UserSK Der Name des Teammitglieds, das den Fehler oder die User Story behoben hat.
Microsoft.VSTS.Common.ResolvedBy
Gelöst am
ResolvedDate		 DateTime Das Datum und die Uhrzeit der Behebung des Fehlers bzw. der User Story.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Das Datum, an dem das Arbeitselement aufgelöst wurde, ausgedrückt in YYYYMMDD der für die organization definierten Zeitzone. Wird von externen Tools verwendet, um verwandte Entitäten zu verbinden.
ResolvedOn Navigation Navigationseigenschaft für die Date Entität für das Datum, an dem das Arbeitselement aufgelöst wurde, in der für die organization definierten Zeitzone. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby -Anweisungen zu verweisen.
Grund für Lösung
ResolvedReason		 String Der Grund, warum der Fehler behoben wurde (er wurde z. B. korrigiert).
Microsoft.VSTS.Common.ResolvedReason
Revision
Revision		 Int32 Eine Zahl, die dem Revisionsverlauf eines Arbeitselement zugewiesen wurde.
System.Rev
Überarbeitungsdatum
RevisedDate		 DateTime Datum und Uhrzeit der Änderung oder Aktualisierung eines Arbeitselements.
RevisedDateSK Int32 Das Datum, an dem das Arbeitselement überarbeitet wurde, ausgedrückt in YYYYMMDD der für die organization definierten Zeitzone. Wird von externen Tools verwendet, um verwandte Entitäten zu verbinden.
RevisedOn Navigation Navigationseigenschaft für die Date Entität für das Datum, an dem das Arbeitselement überarbeitet wurde, in der für die organization definierten Zeitzone. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby -Anweisungen zu verweisen.
Risiko
Risk		 Double Eine subjektive Bewertung der relativen Ungewissheit im Hinblick auf den erfolgreichen Abschluss der User Story. Gültige Werte sind: 1 – Hoch, 2 – Mittel und 3 – Niedrig.
Microsoft.VSTS.Common.Risk
Severity
Severity		 Double Eine subjektive Bewertung der Auswirkungen eines Fehlers, Problems oder Risikos auf das Projekt. Gültige Werte sind: 1 – Kritisch, 2 – Hoch, 3 – Mittel und 4 – Niedrig.
Microsoft.VSTS.Common.Severity
Größe
Size		 Double Eine Schätzung des Arbeitsaufwands, den eine Anforderung (CMMI-Prozess) implementieren muss.
Microsoft.VSTS.Scheduling.Size
Stapelrang
StackRank		 Double Eine Zahl, die von einem Systemhintergrundprozess zugewiesen wird, der zum Stapeln von Rangfolgen oder Nachverfolgen der Sequenz von Elementen in einem Backlog oder Board verwendet wird. (Agile, Scrum und Grundlegende Prozesse)
Microsoft.VSTS.Common.StackRank
Startdatum
StartDate		 DateTime Datum und Uhrzeit, die einem Arbeitselement für den Beginn der Arbeit zugewiesen sind.
Microsoft.VSTS.Scheduling.StartDate
State
State		 String Der aktuelle Zustand des Arbeitselements. Die gültigen Werte für state sind spezifisch für jeden Typ von Arbeitselement und anpassungen, die daran vorgenommen wurden.
System.State
Statuskategorie
StateCategory		 String Statuskategorien bestimmen, wie Azure Boards und auswählen, Dashboard Widgets jeden Workflowstatus behandeln. Die verwendeten Statuskategorien umfassen: Vorgeschlagen, In Bearbeitung, Aufgelöst, Entfernt und Abgeschlossen. Weitere Informationen finden Sie unter Verwenden von Workflowzuständen und Statuskategorien. Nur für den Entitätstyp WorkItemRevision gültig.
Datum der Zustandsänderung
StateChangeDate		 DateTime Das Datum und die Uhrzeit der Änderung des Werts des Felds State .
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Das Datum, an dem der Zustand für ein Arbeitselement geändert wurde, ausgedrückt als YYYYMMDD in der für die organization definierten Zeitzone. Wird von externen Tools verwendet, um verwandte Entitäten zu verbinden.
StateChangeOn Navigation Navigationseigenschaft für die Date Entität für das Datum, an dem der Zustand für ein Arbeitselement geändert wurde, in der Zeitzone, die für die organization definiert wurde. Wird häufig verwendet, um auf Eigenschaften der Date Entität in groupby -Anweisungen zu verweisen.
Story-Punkte
StoryPoints		 Double Eine Schätzung für den Arbeitsaufwand, den ein User Story (Agile-Prozess) implementieren muss, der häufig als Summe aggregiert wird.
Microsoft.VSTS.Scheduling.StoryPoints
Tags
TagNames		 String Durch Semikolons getrennte Liste von Tags, die einem oder mehreren Arbeitselementen zum Filtern oder Abfragen zugewiesen sind.
System.Tags
Zieldatum
TargetDate		 DateTime Das prognostizierte Fälligkeitsdatum, bis zu dem ein Problem oder ein anderes Arbeitselement behoben oder abgeschlossen wird.
Microsoft.VSTS.Scheduling.TargetDate
Testsammlungstyp String Gibt den Typ der Testsammlung an. Gültige Werte sind: Abfragebasiert, Anforderungsbasiert und Statisch.
Microsoft_VSTS_TCM_TestSuiteType
Test Suite-Typ-ID Int64 Eine vom System zugewiesene Nummer, die der Testsammlungskategorie entspricht und nur für Testsammlungen gilt. Zugewiesene Werte sind: 1 (statisch), 2 (abfragebasiert) und 3 (Anforderungsbasiert).
Microsoft_VSTS_TCM_TestSuiteTypeId
Zeitliche Kritikalität
TimeCriticality		 Double Eine subjektive Maßeinheit, die erfasst, wie sich der Geschäftswert im Laufe der Zeit verringert. Ein höherer Wert steht dafür, dass das Epic oder Feature grundsätzlich schneller erledigt werden muss, als Elemente mit niedrigeren Werten.
Microsoft.VSTS.Common.TimeCriticality
Titel
Title		 String Eine kurze Beschreibung mit einer Zusammenfassung der Arbeitsaufgabe, anhand derer Teammitglieder sie von anderen Arbeitsaufgaben in einer Liste unterscheiden können.
System.Title
Wertebereich
ValueArea		 String Der Bereich des Nutzen für den Kunden, der mit Epic, Funktion oder Backlogelement behoben wird. Zu den Werten gehören: Architectural oder Business.
Microsoft.VSTS.Common.ValueArea
Wasserzeichen
Watermark		 String Ein vom System verwaltetes Feld, das änderungen an einem Arbeitselement erhöht. Gültig für diese Entitätstypen: WorkItemRevision und WorkItem.
System.Watermark
Arbeitselement-ID
WorkItemId		 Int32 Der eindeutige Bezeichner, der einem Arbeitselement zugewiesen wurde. Arbeitselement-IDs sind für alle Projekte und innerhalb einer organization- oder Projektsammlung eindeutig.
System.Id
WorkItemRevisionSK Int32 Der eindeutige Analytics-Schlüssel für die Arbeitselementrevision, die von externen Tools zum Verknüpfen verwandter Entitäten verwendet wird.
Arbeitselementtyp
WorkItemType		 String Der Name des Arbeitselementtyps. Arbeitselementtypen werden basierend auf dem Prozess definiert, der beim Erstellen Ihres Projekts verwendet wurde. Weitere Informationen finden Sie unter Informationen zu Prozessen und Prozessvorlagen.
System.WorkItemType

Navigationseigenschaften in OData sind die Verweisattribute einer Entität, die auf eine andere Entität verweist. Die folgende Tabelle enthält eine Zusammenfassung der Navigationseigenschaften, ihrer referenziellen Einschränkungen und der Entitätstypen, für die sie gültig sind.

Anzeigename Name
Referenzielle Einschränkung und Eigenschaft		 Gültig für Entitätstypen
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK		 WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
Bereiche Area
AreaSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItemWorkItemBoardSnapshot
Iterationen Iteration
IterationSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
Zugewiesen zu AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
Geändert durch ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
Erstellt von CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
Aktiviert von ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem, , WorkItemSnapshotWorkItemBoardSnapshot
Geschlossen durch ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshotWorkItemBoardSnapshot
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
Teams Area, , BoardLocationIteration, WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Tags WorkItem, WorkItemRevisionWorkItemBoardSnapshot
Projekt Project
ProjectSK, ProjectSK		 Tag, , WorkItemBoardSnapshotWorkItemLink, WorkItemRevision, WorkItemSnapshot, , WorkItemTypeField
Prozesse WorkItemRevision, WorkItemWorkItemSnapshot
Revisionen WorkItem
Links WorkItem
Children WorkItem
Parent WorkItem
Nachfolgerelemente WorkItem
Workitem WorkItemId WorkItemRevision

Funktionen vorhersagen

Die folgenden beiden Funktionen werden für die WorkItem-Entität unterstützt. Diese Funktionen werden verwendet, um Vorhersagetrends in ausgewählten integrierten Analytics-Berichten und Widgets zu unterstützen.

  • PredictTags
  • Predict

BoardLocation und WorkItemBoardSnapshot

Die in der folgenden Tabelle aufgeführten und beschriebenen Eigenschaften werden für die folgenden Entitätstypen definiert, sofern nicht ausdrücklich angegeben. Mit diesen Feldern können Sie Arbeitsaufgabendaten basierend auf dem Status einer Arbeitsaufgabe innerhalb der Boardspalte, des Verantwortlichkeitsbereichs oder der Backlogebene eines Teams filtern.

  • BoardLocation
  • WorkItemBoardSnapshot

Ein Beispiel, das den Entitätssatz WorkItemBoardSnapshot abfragt, finden Sie unter Cfd-Beispielbericht (Kumulatives Flussdiagramm).

Anzeigename
Property name		 Datentyp Beschreibung
Reference name
Board-ID
BoardId		 Guid Die eindeutige GUID, die einem Board zugewiesen ist. Jedes Team ist einem oder mehreren Boards zugeordnet.
Verweisname der Boardkategorie
BoardCategoryReferenceName		 String Der Name, der der Kategorie von Arbeitsaufgabentypen zugewiesen ist, die zum Auffüllen einer Tafel verwendet werden. Beispielsweise ist das Product Backlog Board der Kategorie Anforderungen zugeordnet. Weitere Informationen finden Sie unter Anpassen von Backlogs oder Boards (Vererbungsprozess).
Boardname
BoardName		 String Der Name, der der Tafel zugewiesen ist. Beispiel : Stories, Backlog Items, Features und Epics.
Board-Ebene
BoardLevel		 Int32 Die dem Board zugewiesene Nummer basierend auf dem Ort, an dem sie sich in der Hierarchie der Boards befindet.
Backlogtyp
BacklogType		 String Der Name des Backlogtyps. Beispiel: Iteration, Anforderung oder Portfolio.
Spaltenname
ColumnName		 String Der Name der Tafelspalte, der derzeit eine Arbeitsaufgabe zugewiesen ist, z. B. "Aktiv", "Geschlossen", "Zugesichert", "Fertig" oder eine andere benutzerdefinierte Spaltenbeschriftung.
System.BoardColumn
Spaltenreihenfolge
ColumnOrder		 Int32 Die Zahl, die der Tafelspalte in Bezug auf die Reihenfolge innerhalb der Tafel zugewiesen ist.
Fertig
Done		 Enumerated Gibt die Geteilte Spaltenposition an. Gültige Werte sind unten für BoardColumnSplit aufgeführt.
Spaltenelementlimit
ColumnItemLimit		 Int32 Die Nummer, die der Tafelspalte in Bezug auf die Reihenfolge zugewiesen ist.
Ist Board sichtbar
IsBoardVisible		 Boolean Gibt an, ob das Team sich dafür ausgewählt hat, ein Board sichtbar zu machen oder nicht.
Ist Spaltenteilung
IsColumnSplit		 Boolean Gibt an, ob eine Spalte in die Spalten "Doing " und "Done " aufgeteilt wurde, wie in geteilten Spalten auf Dem Board beschrieben, um die laufende Arbeit anzuzeigen.
Ist aktuell
IsCurrent		 Boolean Eigenschaft, die das Filtern der Daten unterstützt, um die neuesten Momentaufnahme des gefilterten Arbeitselementesatzes anzuzeigen, indem Sie den Wert auf Truefestlegen.
Ist Standardspur
IsDefaultLane		 Boolean Eigenschaft, die angibt, dass das Arbeitselement dem Standardschwimmlane (True) oder nicht (False) zugewiesen ist.
Ist fertig
IsDone		 Boolean Die aktuelle Zuordnung der Arbeitsaufgabe zu "Doing " (False) oder "Done " (True) innerhalb einer Spalte. Wird nur zugewiesen, wenn geteilte Spalten für eine Tafelspalte aktiviert sind.
System.BoardColumnDone
Lane-ID
LaneId		 Guid Die eindeutige GUID, die einer Verantwortlichkeitsspur zugewiesen ist. Jedes Team kann eine oder mehrere Schwimmspuren zu einem Board hinzufügen. Weitere Informationen zu Verantwortlichkeitslans finden Sie unter Beschleunigen der Arbeit Ihres Teams mithilfe von Verantwortlichkeitsbereichs in Ihrem Board.
Spurname
LaneName		 String Der Name, der dem Verantwortlichkeitsbereich der Tafel zugewiesen ist.
System.BoardLane
Spurreihenfolge
LaneOrder		 Int32 Die Nummer, die dem Board-Verantwortlichkeitsbereich in Bezug auf seine Reihenfolge zugewiesen ist.

BoardColumnSplit enumerierte Mitglieder

In der folgenden Tabelle sind die Membernamen für den BoardColumnSplit aufgezählten Typ aufgeführt, die zum Filtern nach Arbeitselementen in der Boardspalte "Ausführen " oder "Fertig" verwendet werden können.

Membername Wert `Display name`
Doing 0 Ausführen
Done 1 Fertig
Unknown 2 Unbekannt (nicht geteilt)

Weitere Informationen zu Tafelspalten für ein Team finden Sie in den folgenden Artikeln:

Bereiche

Die folgenden Eigenschaften sind für den Entitätssatz Areas gültig, der dem Feld Bereichspfad zugeordnet ist. Ersatzschlüssel, die Area zugeordnet sind, umfassen AreaSK und ProjectSK. Sie können diese Eigenschaften verwenden, um Daten zur Arbeitsnachverfolgung basierend auf Bereichspfadzuweisungen zu filtern oder zu melden.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Number Int32 Ein ganzzahliger Wert, der einem Knoten "Bereichspfad" zugewiesen ist, wenn er erstellt wird.
Tiefe Depth Int32 Die Ebene, auf der der Bereichspfad basierend auf seiner Tiefe von der Stammebene definiert wird.
Bereichs-ID AreaId GUID Eindeutiger Bezeichner, der einem Bereichspfad zugewiesen ist, wenn er erstellt wird.
Bereich Ebene 1 bis
Bereichsebene 14		 AreaLevel1 bis
AreaLevel14		 String Der Name, der der Knotenebene eines Bereichspfads zugeordnet ist. Bis zu 14 geschachtelte Ebenen werden unterstützt. Beispielsweise entspricht Bereichsebene 1 immer dem Stammknoten und dem Projektnamen.
Bereichsname AreaName String Name, der für den Bereichspfad definiert ist, wenn er erstellt wird.
Bereichspfad AreaPath String Vollständiger Pfad des Bereichspfads ab dem Stammknoten.

Wichtig

  • Das Löschen von Bereichspfaden oder das Neukonfigurieren von Iterationspfaden verursacht einen unwiderruflichen Datenverlust. Beispielsweise werden Burndown- und Burnup-Widgetdiagramme, Sprint-Burndown- und Geschwindigkeitsdiagramme für Teams mit geänderten Flächenpfaden keine genauen Daten angezeigt. Historische Trenddiagramme verweisen auf den Bereichspfad und den Iterationspfad, wie sie zum Zeitpunkt für jede Arbeitsaufgabe definiert wurden. Nach dem Löschen können Sie keine historischen Daten für diese Pfade abrufen.
  • Sie können nur Bereiche und Iterationspfade löschen, die nicht mehr von Arbeitsaufgaben verwendet werden.

Navigationseigenschaften für den Entitätstyp Area und den Entitätssatz Areas umfassen Project und Teams.

Weitere Informationen zu Flächenpfaden finden Sie in den folgenden Artikeln:

Iterationen

Die folgenden Eigenschaften sind für den Entitätssatz Iterationen gültig, der dem Feld Iterationspfad zugeordnet ist. Ersatzschlüssel, die der Iteration zugeordnet sind, umfassen IterationSK und ProjectSK. Sie können diese Eigenschaften verwenden, um Daten zur Arbeitsnachverfolgung basierend auf Iterationspfadzuweisungen zu filtern oder zu melden.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Number Int32 Ein ganzzahliger Wert, der einem Iterationspfadknoten zugewiesen ist, wenn er erstellt wird.
Tiefe Depth Int32 Die Ebene, auf der der Iterationspfad basierend auf seiner Tiefe von der Stammebene definiert wird.
Enddatum EndDate DateTime Enddatum, das für den Iterationspfad definiert ist.
IsEnded IsEnded Boolean Gibt bei Festlegung auf True an, dass das Enddatum des Iterationspfads in der Vergangenheit liegt.
Iterations-ID IterationId GUID Eindeutiger Bezeichner, der einem Iterationspfad zugewiesen ist, wenn er erstellt wird.
Iterationsebene 1 bis
Iterationsgrad 14		 IterationLevel1 bis
IterationLevel14		 String Der Name, der der Knotenebene eines Iterationspfads zugeordnet ist. Bis zu 14 geschachtelte Ebenen werden unterstützt. Beispielsweise entspricht die Iterationsebene 1 immer dem Stammknoten und dem Projektnamen.
Name der Iteration IterationName String Name, der für einen Iterationspfad definiert wurde, wenn er erstellt wird.
Iterationspfad IterationPath String Vollständiger Pfad des Iterationspfads ab dem Stammknoten. Die Iteration muss ein gültiger Knoten in der Projekthierarchie sein.
System.IterationPath
Startdatum StartDate DateTime Startdatum, das für den Iterationspfad definiert ist.

Wichtig

  • Das Löschen von Bereichspfaden oder das Neukonfigurieren von Iterationspfaden verursacht einen unwiderruflichen Datenverlust. Beispielsweise werden Burndown- und Burnup-Widgetdiagramme, Sprint-Burndown- und Geschwindigkeitsdiagramme für Teams mit geänderten Flächenpfaden keine genauen Daten angezeigt. Historische Trenddiagramme verweisen auf den Bereichspfad und den Iterationspfad, wie sie zum Zeitpunkt für jede Arbeitsaufgabe definiert wurden. Nach dem Löschen können Sie keine historischen Daten für diese Pfade abrufen.
  • Sie können nur Bereiche und Iterationspfade löschen, die nicht mehr von Arbeitsaufgaben verwendet werden.

Navigationseigenschaften für den Entitätstyp Iteration und iterations-Entitätssatz umfassen Project und .Teams

Weitere Informationen zu Iterationspfaden finden Sie in den folgenden Artikeln:

Prozesse

Die folgenden Eigenschaften sind für den Entitätstyp Process und den Entitätssatz Prozesse gültig. Zu den Mit Process zugeordneten Ersatzschlüsseln gehören ProcessSK, ProjectSKund TeamSK. Sie können diese Eigenschaften verwenden, um Daten zur Arbeitsnachverfolgung basierend auf Arbeitselementtypen zu filtern oder zu melden, die von einem Projekt oder Team verwendet werden.

Hinweis

Der Entitätstyp Process und der Entitätssatz Prozesse werden von den Versionen v-2.0, v3.0-preview und v4.0-preview von Analytics unterstützt.

Sie können diese Eigenschaften verwenden, um nach Arbeitsverfolgungsdaten basierend auf einer Backlogebene zu filtern.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
ProjectSK GUID Projektschlüssel, der dem Prozess zugeordnet ist.
TeamSK GUID Dem Prozess zugeordneter Teamschlüssel.
Referenzname der Backlogkategorie BacklogCategoryReferenceName String Der Kategorieverweisname, der dem Backlog zugewiesen ist, das dem Arbeitselementtyp zugeordnet ist. Beispiele hierfür sind Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Backlogname BacklogName Boolean Der Verweisname, der dem backlog zugewiesen ist, der dem Arbeitselementtyp zugeordnet ist.
Backlogtyp BacklogType GUID Eindeutiger Bezeichner, der einem Iterationspfad zugewiesen ist, wenn er erstellt wird.
Backlogebene BacklogLevel String Gibt die dem Arbeitselementtyp zugeordnete Backlogebene an. Wenn der Arbeitselementtyp keiner Backlogebene zugeordnet ist, lautet nullder zurückgegebene Wert .
Arbeitselementtyp WorkItemType String Der für einen Arbeitselementtyp definierte Name.
Hat Backlog HasBacklog String Gibt an, ob der Arbeitselementtyp zu einem Backlog gehört.
Ist ausgeblendeter Typ IsHiddenType Boolean Gibt an, ob der Arbeitselementtyp deaktiviert wurde.
Ist fehlertyp IsBugType Boolean Gibt an, ob der Arbeitselementtyp zur Kategorie Fehler gehört.
Ist gelöscht IsDeleted Boolean Gibt an, ob der Arbeitselementtyp gelöscht wurde.

Weitere Informationen zu Prozessrückgängen und Arbeitsaufgabentypen finden Sie in den folgenden Artikeln:

Benutzerdefinierte Arbeitselementtypen und benutzerdefinierte Backlogkategorien

Daten für benutzerdefinierte Arbeitselementtypen werden automatisch dem Analysedienst hinzugefügt.

Eine benutzerdefinierte Kategorie wird erstellt, wenn ein benutzerdefinierter Arbeitselementtyp und eine Backlogebene definiert sind. Custom_ wird der Kategorie-GUID vorangestellt. Beispielsweise wird für den benutzerdefinierten Arbeitselementtyp Portfolio mit einem Portfolios-Backlog der benutzerdefinierten Kategorie eine GUID zugewiesen, z Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000. B. .

Tags

Die folgenden Eigenschaften sind für den Tags-Entitätssatz gültig. Zu den Ersatzschlüsseln, die tag zugeordnet sind , gehören TagSK und ProjectSK. Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK. Weitere Informationen zur Verwendung von Tags finden Sie unter Hinzufügen von Arbeitselementtags zum Kategorisieren und Filtern von Listen und Boards.

Sie können diese Eigenschaften verwenden, um Daten zur Arbeitsnachverfolgung zu filtern oder zu berichten.

Anzeigename Name Datentyp Beschreibung
Tag-ID TagId GUID Die eindeutige ID, die dem Tag zugewiesen ist, wenn es erstellt wird.
Tagname TagName String Der Tagname.

Teams

Die folgenden Eigenschaften sind für den Team-Entitätstyp und den Teams-Entitätssatz gültig. Zu den Ersatzschlüsseln, die Team zugeordnet sind, gehören TeamSK und ProjectSK. Sie können diese Eigenschaften verwenden, um Daten zur Arbeitsnachverfolgung basierend auf Teamzuweisungen zu filtern oder zu berichten. Informationen zum Verwenden und Hinzufügen von Teams finden Sie unter Informationen zu Teams und Agile-Tools und Erstellen oder Hinzufügen eines Teams.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Team-ID TeamId GUID Die eindeutige ID, die dem Team bei der Erstellung zugewiesen wird.
Teamname TeamName String Der Teamname.

Navigationseigenschaften für den Teams-Entitätssatz umfassen Projects, Areasund Iterations.

Die folgenden Eigenschaften sind für den WorkItemLinks-Entitätssatz gültig. Der Ersatzschlüssel der Eigenschaftsverweis ist WorkItemLinkSK. Abfragen von WorkItemLinks zum Melden von übergeordneten/untergeordneten , verwandten, Vorgänger-/Nachfolgertypen oder anderen Linktypen.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
WorkItemLinkSK Int32 Der Ersatzschlüssel, der der WorkItemLink Entität zugewiesen ist.
Erstellt am CreatedDate GUID Datum, an dem der Link erstellt wurde.
Comment Comment String Kommentar hinzugefügt, wenn der Link erstellt wurde.
Gelöschtes Datum DeletedDate String Datum, an dem der Link gelöscht wurde.
Linktyp-ID LinkTypeId Int32 Die ID, die dem Zielarbeitselement zugewiesen ist, mit dem verknüpft ist.
Linktypname LinkTypeName String Der Anzeigename, der dem Linktyp zugewiesen ist.
Linktypverweisname LinkTypeReferenceName String Der Verweisname, der dem Linktyp zugewiesen ist.
Linktyp ist azyklisch LinkTypeIsAcyclic Boolean Der Wert des Linktyp-Attributs, das angibt, dass der Linktyp kreisförmige Beziehungen zulässt, wenn der Wert auf True festgelegt ist. Beispielsweise beschränken Strukturtyplinks kreisförmige Beziehungen.
Linktyp ist richtungsrichtungstyp LinkTypeIsDirectional Boolean Der Wert des Linktyp-Attributs, das angibt, dass der Linktyp richtungsweise ist. Richtungslinktypen werden in Paaren mit einer Vorwärts- und umgekehrten Komponente definiert.
Quellarbeitselement-ID SourceWorkItemId Int32 Die ID, die dem Quellarbeitselement zugewiesen ist, mit dem verknüpft ist.
Zielarbeitselement-ID TargetWorkItemId Int32 Die ID, die dem Zielarbeitselement zugewiesen ist, mit dem verknüpft ist.

Navigationseigenschaften für den WorkItemLink-Entitätstyp umfassen Projects, SourceWorkItemund TargetWorkItem.

Weitere Informationen zu Links und Linktypen finden Sie in den folgenden Artikeln:

WorkItemTypeFields

Die folgenden Eigenschaften sind für den Entitätssatz WorkItemTypeFields gültig. Die Eigenschaftenverweisschlüssel sind FieldName, ProjectSKund WorkItemType.

Anzeigename Name Datentyp Beschreibung
Feldname FieldName String Anzeigename, der einem Feld vom System oder beim Erstellen zugewiesen wird.
Feldverweisname FieldReferenceName String Verweisname, der einem Feld vom System zugewiesen ist oder wenn ein benutzerdefiniertes Feld erstellt wird.
Feldtyp FieldType String Einem Feld zugewiesener Datentyp.
Arbeitselementtyp WorkItemType String Name der Arbeitselementtypen, für die ein Feld definiert ist.

Navigationseigenschaften umfassen Project.

Einen Index aller für ein Projekt definierten Felder finden Sie unter Feldbeschreibungen für Arbeitselementfelder. Weitere Informationen finden Sie in den folgenden Artikeln:

Benutzerdefinierte Eigenschaften

Benutzerdefinierte Felder werden dem Analytics-Dienst automatisch als benutzerdefinierte Eigenschaft hinzugefügt. Custom_ oder Custom. dem Eigenschaftennamen vorangestellt ist. Überprüfen Sie die Metadaten Ihrer Sammlung wie unter Erstellen von OData-Abfragen für Analytics, URL-Komponenten zum Abfragen der Metadaten beschrieben. Im folgenden Beispiel wird die Metadatensyntax für das benutzerdefinierte Feld Risk Opportunity bereitgestellt.

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