是否有任何关于如何填充修订说明以及在什么条件下填充的文档

Is there any documentation about how Revision.Description is populated and under what condition?

本文关键字：填充 在什么 条件下 文档 任何关 于如何 是否 说明      更新时间：2023-09-26

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

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

我感兴趣的属性有：

层次结构要求

  • PlanEstimate
  • 任务估计总计
  • 任务实际总计
  • 任务剩余总计

任务

  • 估算
  • 待办事项
  • 实际值

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

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

例如：以下内容被添加到修订版中。发生后的描述：

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

"滚动7天"只是一个例子。我的意图是创建一个表格，其中沿y轴细分为团队->故事->任务->估计->待办事项，沿x轴细分为迭代->每日日期。

蒂姆。

许多Rally对象类型上的Revision.description字段最初并不是为了让开发人员获取更改信息，而是为了显示我们的Rally ALM SaaS工具-这就是为什么更改被放在一个名为"description"的Revision属性中，该属性只是一个文本字段。因此，没有关于该数据格式的开发人员文档，因为它是一个文本字段，不打算被解析，并且格式可能在未来发生变化（在未来，将有更好的方法来获取对象更改信息。更多关于这一点的信息，请在本文后面…）

然而，这些数据中存在一种模式。它是：

ATTRIBUTE_NAME操作VALUE_CLAUSE

操作是"添加"或"更改"的。

value子句的格式基于操作类型。对于"added"操作，value子句为[value]。对于"changed"操作，value子句为"从[旧值]到[新值]"。

例如，对于一个现有的用户故事，其所有者从"No Entry"设置为"Newt"，则会创建一个新的修订实例，说明中会包含以下内容：

业主增加了[新]

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

所有者从[Newt]变更为[AJohn]

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

现在来看看未来更好的方法。由于您不是唯一一个想要更改对象的开发人员，我们正在开发一种新产品，该产品将公开WSAPI端点，您可以通过编程的方式获得对象的更改，从而避免需要解析数据。但由于该产品正在开发中，您将不得不做您现在正在做的事情，希望我在描述中对数据格式的解释能同时对您有所帮助。

希望这能有所帮助。

您正在查找的数据也可能存在于Rally的WSAPI:中的IterationCumulativeFlowData或ReleaseCumulativeFlow data对象中

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

这应该比遍历所有修订历史记录条目更容易（并且执行得更好）。

相关文章：