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 :
- Données de tendance des requêtes
- Définir des requêtes de base à l’aide d’OData Analytics
- Calculer le délai d’entrée dans l’état d’une vue Analytics existante
- Exemple de rapport sur les tendances des bogues
- Exemple de rapport de temps de prospect et de cycle
- Exemple de rapport de tendance du taux de transmission de pipeline
- Exemple de rapport de tendance de la durée des tâches de pipeline
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, IsFlags
qui 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é ProjectSK
de 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. |
Propriétés de navigation
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é UserSK
de 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 |