如何使用燃耗图表的LookbackAPI？

Question

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

Answer 1

对于可用示例的稀缺性，很抱歉。随着LBAPI测试版的成熟，将会有更多更好的示例出现。我绝对建议您熟悉Lookback API (LBAPI) Documentation，因为有一些很好的例子可以用来表达查询。

对于燃耗，假设您想要获取从2013年1月15日到2013年1月30日的迭代的状态快照，并且迭代应用于四层深度的项目层次结构。下面的LBAPI查询将获得调度到该迭代中的故事的PlanEstimate、ToDo和调度状态：

{
    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
              ]

是称为"Iteration 1“的迭代的ObjectID。在Iterations：(Name = "Iteration 1")上从标准的WSAPI查询中获取这些对象ID可能是最容易的。对于复制到四层项目层次结构中的迭代，我们将看到与上面类似的四个迭代OID。

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

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

对于Javascript应用程序，Lumenize javascript library是独立于LBAPI的，但由Rally的分析总监开发，并捆绑在SDK中。您可以在这里找到一些使用LBAPI和Lumenize生成图表的示例，作为一些Rally-internal和Rally-customer Hackathon项目的一部分：

https://github.com/RallyHackathon

请谨慎使用这些示例，原因有几个：

• Lumenize命名空间的几个方面将针对clarity
• There's进行更改/重命名，这是当前版本Lumenize中的一个错误，其timeSeriesCalculator不能正确说明已删除或重新设置父关系的故事。

希望很快就会有一个捆绑并发布的AppSDK2更新版本来整合Lumenize命名空间并解决这个错误，这样AppSDK2和LBAPI之间就可以更好地粘合Javascript App开发。

Answer 2

不幸的是，.NET、Java和Python工具包还没有更新到支持Lookback API。因此，您必须直接向Lookback API的REST端点执行HTTP POST，其主体类似于上面列出的标记W和Content-Type 'application/json‘。

我推荐使用Chrome扩展'XHR Poster‘来体验从浏览器发送的内容：https://chrome.google.com/webstore/detail/xhr-poster/akdbimilobjkfhgamdhneckaifceicen