作業項目の履歴テーブル

[アーティクル]
08/09/2011

更新 : 2010 年 7 月

次の図に示すように、FactWorkItemHistory およびそれに関連付けられているディメンションテーブルを使用して、バグ、タスク、およびその他の種類の作業項目に関する履歴データを照会できます。履歴データでは、作業項目のステータスに関する情報や、時間の経過とともに変化した作業項目のフィールドの値に関する情報が提供されます。作業項目の履歴テーブルから作成されるレポートの一例として、進行状況グラフやバーンダウングラフが挙げられます。データは補正レコードを使用して格納されます。補正レコードの詳細については、「Visual Studio ALM におけるレポート作成に関する新機能」を参照してください。

"作業項目の履歴" のファクトテーブル

FactWorkItemHistory は、FactCurrentWorkItem テーブルおよび次のディメンションテーブルに関連付けられています。

DimArea
DimIteration
DimPerson
DimTeamProject

次のサンプルクエリを使用すると、特定のユーザーストーリーについて 2009 年 9 月 21 日から 2009 年 9 月 30 日までの履歴作業負荷の傾向を調べることができます。このクエリは、チームプロジェクトの各ユーザーストーリーについて、合計の実績作業、最初の見積もり作業、残存作業時間、およびこの期間の日の合計のストーリーポイントに関する情報を返します。ユーザーストーリーの詳細については、「ユーザーストーリー (アジャイル)」を参照してください。

注意

このクエリでは、ユーザーストーリーが子リンクを介して他の作業項目にリンクされていると想定しています。

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