3

是否有任何关于如何填充 Revision.Description 以及在什么条件下的文档？

我正在为 Rally 编写自定义应用程序，以便可以通过具有 7 天滚动周期的表格查看对 Task 和 HierarchicalRequirement 对象所做的更改。

我感兴趣的属性是：

分层需求

  • 计划估计
  • 任务估计总计
  • 任务实际总计
  • 任务剩余总数

任务

  • 估计
  • 去做
  • 实际数据

我正在遍历修订以获取任务和故事的快照视图：

检索当天的这些属性很容易。但是，我需要遍历 RevisionHistory -> Revisions 然后解析 Revision.Description 以应用 Task 和 HierarchicalRequirement 对象的差异。这可以提供每个对象的每日快照。

例如：发生后将以下内容附加到 Revision.Description 中：

TASK REMAINING TOTAL changed from [7.0] to [4.0]
TASK ESTIMATE TOTAL changed from [7.0] to [4.0]

“滚动 7 天”周期只是一个例子。我的意图是创建一个表格，其中包含沿 y 轴的 Team -> Story -> Task -> Estimate -> ToDo 和沿 x 轴的 Iteration -> daily-date 的细分。

蒂姆。

4

2 回答 2

3

许多 Rally 对象类型上的 Revision.description 字段最初并非旨在供开发人员获取更改信息，而是用于我们的 Rally ALM SaaS 工具的显示目的 - 这就是为什么将更改放在名为“description”的 Revision 属性中，这只是一个文本字段。因此，没有关于此数据格式的开发人员文档，因为它是一个文本字段，不打算进行解析，并且格式将来可能会更改（将来会有更好的方法来获取对象更改信息。更多关于这在这篇文章的后面......）

但是，此数据中有一个模式。这是：

ATTRIBUTE_NAME 操作 VALUE_CLAUSE

动作被“添加”或“更改”。

值子句格式基于操作类型。对于“添加”操作，value 子句是 [value]。对于“更改”操作，值子句是“从 [旧值] 到 [新值]”。

例如，对于一个现有的用户故事，其所有者从“无条目”设置为“Newt”，创建一个新的修订实例，描述将包含在其中：

所有者添加了[纽特]

如果稍后用户将所有者更改为“John”，则将创建一个新修订，如下所示：

所有者从 [Newt] 更改为 [John]

如果有多个属性更改，则更改以逗号分隔，并且无法保证更改的排序顺序。

现在为了更好的方式在未来做到这一点。由于您不是唯一想要进行对象更改的开发人员，我们正在开发一个新产品，该产品将公开 WSAPI 端点，您可以在其中以编程方式获取对象的更改，从而避免您需要解析数据。但是由于这个产品正在开发中，你必须做你现在正在做的事情，希望我对描述中数据格式的解释能在此期间对你有所帮助。

希望这可以帮助。

于 2012-01-19T16:57:16.730 回答
0

您正在寻找的数据也可能存在于 Rally 的 WSAPI 中的 IterationCumulativeFlowData 或 ReleaseCumulativeFlowData 对象中：

https://rally1.rallydev.com/slm/doc/webservice/

这应该比遍历所有修订历史条目更容易（并且性能更好）。

于 2012-01-18T23:29:23.563 回答