工作项架构
更新:2007 年 11 月
有关工作项的数据将围绕 Team System 的数据仓库中的四个事实数据表进行组织。以下各部分介绍了每个事实数据表的内容以及它们与维度表之间的关系,还介绍了那些特定于工作项架构的维度表。 有关事实数据表和维度表的更多信息,请参见事实数据表和维度表。
工作项的事实数据表包括:
“当前工作项”事实数据表 (dbo.Current Work Item)
“工作项变更集”事实数据表 (dbo.Work Item Changeset)
“工作项历史记录”事实数据表 (dbo.Work Item History)
“相关工作项”事实数据表 (dbo.Related Current Work Item)
工作项的事实数据表引用以下维度表:
“工作项”维度表 (dbo.Work Item)
“变更集”维度表 (dbo.Changeset)
“生成”维度表 (dbo.Build)(请参见生成架构)
“团队项目”维度表 (dbo.Team Project)(请参见共享维度)
“人员”维度表 (dbo.Person)(请参见共享维度)
“日期”维度表 (dbo.Date)(请参见共享维度)
“区域”维度表 (dbo.Area)(请参见共享维度)
“迭代”维度表 (dbo.Iteration)(请参见共享维度)
“当前工作项”事实数据表
此事实数据表存储所有工作项的当前版本。下表介绍事实数据表中的各列。
字段 |
说明 |
---|---|
__ID |
表中记录的标识号(内部使用)。 |
Logical Tracking ID |
工作项跟踪仓库适配器用于确定仓库中已经有多少工作项历史记录的标识号。 |
__LastUpdatedTime |
上次插入或更新记录的日期和时间。 |
__TrackingId |
仓库基础结构用于跟踪记录的标识号。 |
Work Item |
“工作项”维度表的外键。 |
Assigned To |
表示 Assigned To(指派给)值的“人员”维度表的外键。 |
Changed By |
表示 Changed By(更改者)值的“人员”维度表的外键。 |
Created By |
表示 Created By(创建者)值的“人员”维度表的外键。 |
Area |
“区域”维度表的外键。 |
Iteration |
“迭代”维度表的外键。 |
Team Project |
指示团队项目的“团队项目”维度表的外键。 |
Date |
“日期”维度表的外键。 |
System_CreatedDate |
指示工作项创建日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ActivatedDate |
指示工作项上次激活日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ResolvedDate |
指示工作项上次解决日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ClosedDate |
指示工作项上次关闭日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Test_TestName |
在任务代码中运行的测试的名称。 |
Microsoft_VSTS_Test_TestId |
在任务代码中运行的测试的 ID 号。 |
Microsoft_VSTS_Test_TestPath |
在任务代码中运行的测试的完整路径。 |
Microsoft_VSTS_Build_FoundIn |
指示以下生成的“生成”表的外键:在此生成发现了工作项。在 MSF for Agile Software Development 过程模板中,它只能用于 Bug 工作项类型。 |
Microsoft_VSTS_Build_IntegrationBuild |
指示以下生成的“生成”维度表的外键:此生成包含解决了该工作项的代码更改。 |
_Microsoft_VSTS_Scheduling_RemainingWork |
完成任务尚需小时数的估计值。 |
_Microsoft_VSTS_Scheduling_CompletedWork |
该任务已完成的小时数。 |
_Microsoft_VSTS_Scheduling_BaselineWork |
基线计划中的工时数。 |
Microsoft_VSTS_Scheduling_StartDate |
指示该工作项关联开始日期的“日期”维度表的外键。 |
Microsoft_VSTS_Scheduling_FinishDate |
指示该工作项关联完成日期的“日期”维度表的外键。 |
“工作项变更集”事实数据表
此事实数据表存储工作项和变更集之间的链接。下表介绍事实数据表中的各列。
字段 |
说明 |
---|---|
__ID |
表中记录的标识号(内部使用)。 |
__LastUpdatedTime |
上次插入或更新记录的日期和时间。 |
__TrackingId |
仓库基础结构用于跟踪记录的标识号。 |
Work Item |
“工作项”事实数据表中的工作项的记录 ID。 |
Changeset |
“变更集”事实数据表中的变更集的记录 ID。 |
Team Project |
在其中存储链接的团队项目。 |
“工作项历史记录”事实数据表
此事实数据表包含所有工作项的所有历史记录。该表使用补偿记录策略来记录任意时间点的历史记录。下表介绍事实数据表中的各列。
字段 |
说明 |
---|---|
__ID |
表中记录的标识号(内部使用)。 |
Logical Tracking ID |
工作项跟踪仓库适配器用于确定仓库中已经有多少工作项历史记录的标识号。 |
Record Count |
1 或 -1。创建新工作项时会插入一条记录,并会将 Record Count(记录计数)设置为 1。修改工作项时会插入两条记录。第一条记录与上一条记录相同,只是它的 Record Count(记录计数)为 -1 而不是 1。第二条记录的 Record Count(记录计数)为 1,而记录的其余部分则表示工作项中的新值。 |
Revision Count |
每次修订工作项时此值都会设置为 1。对于 Record Count(记录计数)设置为 -1(表示对工作项进行了更改)的记录,此值为 NULL。选择 Revision Count(修订计数)设置为 1 的行将返回工作项的所有修订。 |
State Change Count |
用于显示诸如 Bug 解决率或任务完成率的活动。当“状态”字段更改时,State Change Count(状态更改计数)会设置为 1。对于未更改状态的工作项的任何修订,以及 Record Count(记录计数)为 -1 的所有记录,State Change Count(状态更改计数)会设置为 NULL。 |
__LastUpdatedTime |
上次插入或更新记录的日期和时间。 |
__TrackingId |
仓库基础结构用于跟踪记录的标识号。 |
Work Item |
“工作项”维度表的外键。 |
Assigned To |
表示 Assigned To(指派给)值的“人员”维度表的外键。 |
Changed By |
表示 Changed By(更改者)值的“人员”维度表的外键。 |
Date |
“日期”维度表的外键。该字段指示上次更改工作项的日期。 |
Created By |
表示 Created By(创建者)值的“人员”维度表的外键。 |
Area |
“区域”维度表的外键。 |
Iteration |
“迭代”维度表的外键。 |
Team Project |
“团队项目”维度表的外键。 |
System_CreatedDate |
指示工作项创建日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ActivatedDate |
指示工作项上次激活日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ResolvedDate |
指示工作项上次解决日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Common_ClosedDate |
指示工作项上次关闭日期的 Date(日期)维度的外键。 |
Microsoft_VSTS_Test_TestName |
在任务代码中运行的测试的名称。 |
Microsoft_VSTS_Test_TestId |
在任务代码中运行的测试的 ID 号。 |
Microsoft_VSTS_Test_TestPath |
在任务代码中运行的测试的完整路径。 |
Microsoft_VSTS_Build_FoundIn |
指示以下生成的“生成”表的外键:在此生成发现了工作项。在 MSF for Agile Software Development 过程模板中,它只能用于 Bug 工作项类型。 |
Microsoft_VSTS_Build_IntegrationBuild |
指示以下生成的“生成”维度表的外键:此生成包含解决了该工作项的代码更改。 |
_Microsoft_VSTS_Scheduling_RemainingWork |
完成选定维度的工作尚需工时数的估计值。 |
_Microsoft_VSTS_Scheduling_CompletedWork |
所选维度的已完成的小时数。 |
_Microsoft_VSTS_Scheduling_BaselineWork |
基线计划中所选维度的工时数。 |
Microsoft_VSTS_Scheduling_StartDate_Date_ID |
指示该工作项关联开始日期的“日期”维度表的外键。 |
Microsoft_VSTS_Scheduling_FinishDate_ID |
指示该工作项关联完成日期的“日期”维度表的外键。 |
“当前相关工作项”事实数据表
此事实数据表存储相关工作项之间的链接,如下表所述。
字段 |
说明 |
---|---|
Current Work Item_TrackingIDLeft |
链接源的“当前工作项”事实数据表的外键。 |
Current Work Item_TrackingIDRight |
链接目标的“当前工作项”事实数据表的外键。 |
__LastUpdatedTime |
最近插入或更新记录的日期和时间。 |
可以将此事实数据表与“当前工作项”事实数据表联接起来,以查询工作项和链接的工作项。
FROM [Related Current Work Item] Link
INNER JOIN [Current Work Item] Left
On Link.[Current Work Item_TrackingIDLeft] = Left.__TrackingID
INNER JOIN [Current Work Item] Right
On Link.[Current Work Item_TrackingIDRight] = Right.__TrackingID
“工作项”维度表
此维度表存储工作项字段的值,这些字段的值不会另外存储在共享维度中。例如,State(状态)字段的值存储在工作项的维度表中,但 Assigned To(指派给)字段的值存储在共享的人员维度表中。下表描述工作项维度表中的列。
字段 |
说明 |
---|---|
__ID |
表中记录的标识号(内部使用)。 |
Work Item |
派生自工作项 ID 和修订号的标识符。 |
Previous State |
上一次修订工作项时的状态。 |
__LastUpdatedTime |
上次插入或更新记录的日期和时间。 |
__DimensionMemberActive |
是否已完全填充维度成员(内部使用)。 |
System_Id |
当工作项在操作系统中已知时表示其工作项 ID。 |
System_Title |
工作项的标题。 |
System_State |
工作项的状态。 |
System_Rev |
工作项修订号。 |
System_Reason |
与上次状态更改相关的原因。 |
System_WorkItemType |
工作项的类型(Bug 和任务等)。 |
Microsoft_VSTS_Common_Issue |
用于标记要显示在问题报告中的工作项的值。 |
Microsoft_VSTS_Common_ActivatedBy |
上次激活工作项的人员。 |
Microsoft_VSTS_Common_ResolvedBy |
上次解决工作项的人员。 |
Microsoft_VSTS_Common_ClosedBy |
上次关闭工作项的人员。 |
Microsoft_VSTS_Common_Priority |
用于确定先完成哪些任务的主观重要性分级。有效值为 1、2 和 3。 |
Microsoft_VSTS_Common_Triage |
等待会审决定的任务的子状态(在“已建议”状态期间使用)。有效值为“挂起”(默认值)、“详细信息”、“收到信息”、“已会审”。 |
Microsoft_VSTS_Common_ExitCriteria |
用于确定是否应在项目检查表上跟踪该工作项的标志。 |
Microsoft_VSTS_Common_Rank |
用于确定工作优先级的堆栈级别。 |
Microsoft_VSTS_Scheduling_TaskHierarchy |
一个表示给定任务的 Microsoft Project 上下文的字符串。 |