rally - 如何将 LookbackAPI 用于燃耗图？

Question

我需要一个使用 LookbackAPI 来获取燃尽图数据的好例子。我在 API 上看到了一些有限的问题和回复，但没有关于如何使用它的示例。我需要完成故事点和故事点的当前范围。

Answer 1

对于可用示例的稀缺性，我们深表歉意。随着 LBAPI 测试版的成熟，更多更好的例子将会出现。我绝对建议您熟悉 Lookback API (LBAPI) Documentation ，因为那里有用于制定查询的好例子。

对于燃尽图，假设您想要获取从 2013 年 1 月 15 日到 2013 年 1 月 30 日的迭代的状态快照，并且迭代适用于四层深的项目层次结构。以下 LBAPI 查询将获取计划到该迭代中的故事的 PlanEstimate、ToDo 和 Schedule State:

{
    find:
        {
           _TypeHierarchy:"HierarchicalRequirement",
           Children:null,
           _ValidFrom:{
              $gte:"2013-01-15TZ",
              $lt:"2013-01-30TZ"
           },
           Iteration:{
              $in:[
                 12345678910,
                 12345678911,
                 12345678912,
                 12345678913
              ]
           }
        },
        fields:[
           "PlanEstimate",
           "ToDo",
           "ScheduleState"
        ]
}

在哪里:

              $in:[
                 12345678910,
                 12345678911,
                 12345678912,
                 12345678913
              ]

迭代的 ObjectID 是否称为“迭代 1”。从迭代的标准 WSAPI 查询中获取这些对象 ID 可能是最简单的: (Name = "Iteration 1") 。对于复制到四层深度项目层次结构中的迭代，我们将看到与上述类似的四个迭代 OID。

对于图表，目前最困难的部分是处理时间序列数据的简单方法。当前查询和处理 LBAPI 数据的最可靠方法是直接针对 REST 端点工作，并在您自己的代码中处理返回的 JSON 结果。

对于 Javascript 应用程序，为了处理数据并将其转换为图表，首选工具包是 AppSDK2 ，特别是 SnapshotStore 。

对于 Javascript 应用程序， Lumenize javascript library 与 LBAPI 是分开的，但由 Rally 的分析主管开发并捆绑在 SDK 中。您可以在此处找到一些使用 LBAPI 和 Lumenize 生成图表的示例，作为某些 Rally 内部和 Rally 客户 Hackathon 项目的一部分:

https://github.com/RallyHackathon

出于以下几个原因，请谨慎对待这些示例:

为清楚起见，Lumenize 命名空间的几个方面将进行更改/重命名

当前版本的 Lumenize 存在一个错误，即它的 timeSeriesCalculator 没有正确考虑已删除或重新设置父级的故事。

希望很快会捆绑并发布 AppSDK2 的更新版本，以整合 Lumenize 命名空间并解决该错误，以便在 AppSDK2 和 LBAPI 之间更好地粘合 Javascript 应用程序开发。