Partager via


Date de calendrier, référence des métadonnées project et utilisateur pour Azure DevOps Analytics

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

Les types d’entités et les jeux d’entités répertoriés dans le tableau suivant peuvent être utilisés pour filtrer et générer des rapports basés sur des données Analytics.

EntitySet EntityType Description
Dates CalendarDate Dates utilisées pour filtrer et regrouper d’autres entités à l’aide de relations.
Projets Projet Projets définis pour une organisation (cloud) ou une collection de projets (locale).
Utilisateurs Utilisateur Informations utilisateur utilisées pour développer ou filtrer diverses propriétés d’élément de travail, par exemple Affectée à, Créé par.

Remarque

Des descriptions des entités, des propriétés et des types énumérés pris en charge par le modèle de données Analytics sont fournies. Il s’agit d’un brouillon précoce. Veuillez fournir des commentaires sur les domaines que vous souhaitez obtenir plus d’informations. Pour interroger le modèle de données, consultez Construire des requêtes OData pour Analytics.

Dates

Les propriétés suivantes sont valides pour le type d’entité CalendarDate . La clé de substitution associée à CalendarDate est DateSK. Vous pouvez spécifier des propriétés de date de calendrier pour filtrer et structurer des rapports.

Nom complet Nom Type de données Description
IsLastDayOfPeriod Énuméré Permet de filtrer les données pour déterminer si un jour se termine dans différentes périodes telles que les jours, les semaines, les mois ou les années. Les valeurs valides sont répertoriées ci-dessous pour Period.
Date Date Date/Heure Date de calendrier spécifique.
Nom du jour DayName Chaîne Nom d’un jour, tel que lundi, mardi, mercredi, etc.
Nom court du jour DayShortName Chaîne Nom court attribué à un jour, tel que Mon, Tue, Wed, etc.
Jour de la semaine DayOfWeek Int32 Nombre associé au jour dans une semaine.
Jour du mois DayOfMonth Int32 Nombre associé au jour dans un mois.
Jour de l’année DayOfYear Int32 Nombre associé au jour d’une année.
Date de début de la semaine WeekStartingDate Date/Heure Date associée au début d’une semaine.
Date de fin de semaine WeekEndingDate Date/Heure Date associée à la fin d’une semaine.
Month Month Chaîne Nom abrégé d’un mois et d’une année, par exemple, Jan 2022, Février 2022, Mar 2022, et ainsi de suite.
Nom du mois MonthName Chaîne Nom d’un mois, tel que janvier, février, mars, etc.
Nom court du mois MonthShortName Chaîne Nom abrégé d’un mois, tel que Jan, Fév, Mar, etc.
Mois de l’année MonthOfYear Int32 Numéro affecté à un mois. Par exemple, 1, 2 et 3 correspondant à janvier, février et mars.
YearMonth YearMonth Int32 Nombre correspondant à l’année concaténée et au mois. Par exemple, 202201, 202202 et 202203 correspond à janvier, février et mars 2022.
Year Year Int32 L’année, comme 2019, 2020, 2021 et ainsi de suite.

Par défaut, toutes les tables d’instantanés sont modélisées en tant que tables de faits d’instantané quotidiennes. Si vous interrogez un intervalle de temps, il obtient une valeur pour chaque jour. Les intervalles de temps longs entraînent un grand nombre d’enregistrements. Si vous n’avez pas besoin d’une telle précision, vous pouvez utiliser des instantanés hebdomadaires ou même mensuels.

Lorsque vous agrégez des données pour une entité d’instantané, vous devez inclure la ou la DateSK DateValue colonne dans une groupby clause, comme décrit dans les instructions de requête OData. Pour obtenir des exemples de rapports qui spécifient un filtre de date, consultez les articles suivants :

Membres de type énumérés de période

Les membres suivants sont définis pour le Period type énuméré que vous pouvez utiliser avec d’autres expressions de filtre pour supprimer les jours qui ne terminent pas une semaine ou un mois donné. Référencez l’un de ces membres pour spécifier une période hebdomadaire ou mensuelle pour les requêtes de tendance qui s’étendent sur une longue période. Le Period type énuméré a un attribut unique, IsFlagsqui est défini sur True.

Nom du membre Valeur Nom complet
None 0 Aucune
Day 1 Day
WeekEndingOnSunday 2 Semaine se terminant le dimanche
WeekEndingOnMonday 4 Semaine se terminant le lundi
WeekEndingOnTuesday 8 Semaine se terminant le mardi
WeekEndingOnWednesday 16 Semaine se terminant le mercredi
WeekEndingOnThursday 32 Semaine se terminant le jeudi
WeekEndingOnFriday 64 Semaine se terminant le vendredi
WeekEndingOnSaturday 128 Semaine se terminant le samedi
Month 256 Month
Quarter 512 Quarter (Trimestre)
Year 1 024 Year
All 2047 Tous

Projets

Les propriétés suivantes sont valides pour l’ensemble d’entités Projects et sa clé ProjectSKde substitution. Lors de la génération d’une requête délimitée par l’organisation, vous pouvez vous concentrer sur un ou plusieurs projets en spécifiant un ou plusieurs noms de projet. Pour plus d’informations, consultez les requêtes Project et l’étendue de l’organisation.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
ID de projet ProjectId GUID Identificateur unique affecté à un projet lors de sa création.
Nom du projet ProjectName Chaîne Nom affecté à un projet lors de sa création.
Visibilité du projet ProjectVisibility Énuméré Indique si le projet est public ou privé. Les valeurs valides sont répertoriées ci-dessous pour ProjectVisibility.

Les propriétés de navigation suivantes sont valides pour le type d’entité Project .

Membres de type énumérés ProjectVisibility

Les membres suivants sont définis pour le ProjectVisibility type énuméré. Référencez l’un de ces membres pour filtrer sur des projets spécifiques.

Nom du membre Valeur Nom complet
Private 0 Privée
Organization 1 Organisation
Public 2 Publique

Utilisateurs

Les propriétés suivantes sont valides pour l’ensemble d’entités Users et le type d’entité Utilisateur avec la clé UserSKde substitution.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
E-mail de l’utilisateur UserEmail Chaîne E-mail associé à une identité de compte d’utilisateur.
Identifiant utilisateur UserId GUID Identificateur unique affecté à une identité de compte d’utilisateur.
Nom d’utilisateur UserName Chaîne Nom attribué à un utilisateur lorsque l’identité du compte d’utilisateur est créée.
ID d’utilisateur GitHub GitHubUserId Chaîne ID d’utilisateur GitHub associé au compte d’utilisateur.
Type d’utilisateur UserType Personnalisée Type de l’utilisateur. Les valeurs valides sont répertoriées ci-dessous pour UserType.

Membres de type énumérés UserType

Les membres suivants sont définis pour le UserType type énuméré.

Nom du membre Valeur Nom complet
Unknown 0 Méconnu
Unrecognized 1 Méconnu
User 2 Utilisateur
Organization 3 Organisation
Bot 4 Robot