Tables Historique de l'élément de travail

Article
08/10/2011

Vous pouvez rechercher les données d'historique relatives aux bogues, tâches et autres types d'éléments de travail à l'aide de la table FactWorkItemHistory et des tables de dimension associées, comme illustré ci-dessous. Les données d'historique fournissent des informations sur l'état d'un élément de travail ou une valeur d'un champ pour un élément de travail qui a changé dans le temps. Les graphiques de progression et d'avancement sont des exemples de rapports construits à partir de tables d'historique d'élément de travail. Les données sont stockées à l'aide des enregistrements de compensation. Pour plus d'informations sur les enregistrements de compensation, consultez Nouveautés de la création de rapports pour Visual Studio ALM.

Table de faits pour l'historique des éléments de travail

FactWorkItemHistory est associée à FactCurrentWorkItem et aux tables de dimension suivantes :

DimArea
DimIteration
DimPerson
DimTeamProject

Vous pouvez utiliser la requête d'exemple suivante pour rechercher la tendance de charge de travail historique pour la période entre le 21-09-2009 et le 30-09-2009 pour certains récits utilisateur. Pour chaque récit utilisateur dans le projet d'équipe, cette requête retourne les informations sur le total du travail effectué, le travail d'origine estimé, le travail restant et le total des points de récit pour chaque jour de cette période. Pour plus d'informations sur les récits utilisateur, consultez Récits utilisateur (Agile).

Notes

Cette requête suppose qu'un récit utilisateur est lié à d'autres éléments de travail via des liens enfants.

declare @TeamProjectNodeSK int
select @TeamProjectNodeSK = ProjectNodeSK from GetProjectNodeInfoFromReportFolder(N'/TfsReports/VSTSDF/ProcessDev10')
-- This table value function returns the ProjectNodeSK: the Surrogate Key of a team project under a certain area path.

declare @TeamProjectCollectionGuid nvarchar(36)
select @TeamProjectCollectionGuid = pc.ProjectNodeGUID from DimTeamProject p inner join DimTeamProject pc on p.ParentNodeSK = pc.ProjectNodeSK where p.ProjectNodeSK = @TeamProjectNodeSK
-- This query finds the team project collection GUID by joining TeamProject.ParentNodeSK to TeamProject.ProjectNodeSK

select 
    d.DateSK
    ,wi.System_Title
    ,wi.System_Id
    ,coalesce(sum(wih_child.Microsoft_VSTS_Scheduling_CompletedWork),   0) as Total_CompletedWork, -- Finds the total number of hours of completed work.
    coalesce(sum(wih_child.Microsoft_VSTS_Scheduling_OriginalEstimate), 0) as Total_OriginalEstimate --Finds the total number of hours of original estimate.
    ,coalesce(sum(wih_child.Microsoft_VSTS_Scheduling_RemainingWork), 0) as Total_RemainingWork--Finds the total number of hours of remaining work.
    ,coalesce(sum(wih_child.Microsoft_VSTS_Scheduling_StoryPoints), 0) as Total_StoryPoints --Finds the total story points.
from
    DimDate d
cross apply
    DimWorkItem wi
cross apply
    GetWorkItemsTree(@TeamProjectCollectionGuid, wi.System_Id,      
N'Child', d.DateSK) wit 
left join          
    FactWorkItemHistory wih_child   
        on wih_child.WorkItemSK = wit.ChildWorkItemSK
where
    d.DateSK >= N'2009-09-21 00:00:00.000' 
    and d.DateSK <= N'2009-9-30 00:00:00.000'
    and wi.TeamProjectSK = @TeamProjectNodeSK 
    and wi.System_WorkItemType = N'User Story' 
    and wi.System_ChangedDate <= d.DateSK
    and wi.System_RevisedDate > d.DateSK
    and wi.System_State = N'Active'
    and (wih_child.RecordCount != -1 or wih_child.RecordCount is null)
group by d.DateSK, wi.System_Id, wi.System_Title

Ressources supplémentaires

Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : COALESCE (Transact-SQL)

Pour plus d'informations sur les enregistrements de compensation, consultez la page suivante sur le site Web Microsoft : NEricson's Weblog (page éventuellement en anglais).