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

Question

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

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

我感兴趣的属性是:

分层要求

• 计划估算
• 任务估计总计
• TaskActualTotal
• 剩余任务总数

任务

• 估计
• 待办事项
• 实际情况

我正在遍历 Revisions 以获取任务和故事的快照 View :

检索当天的这些属性很容易。但是，我需要遍历 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 天”期间只是一个示例。我的目的是创建一个表格，其中包含 Team -> Story -> Task -> Estimate -> ToDo 沿 y 轴和 Iteration -> daily-date 沿 x 轴。

蒂姆。

Answer 1

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

但是，此数据中存在一种模式。它是:

ATTRIBUTE_NAME 操作 VALUE_CLAUSE

操作是“添加”或“更改”。

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

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

OWNER 添加了 [Newt]

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

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

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

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

希望这对您有所帮助。