4

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

4

2 回答 2

2

对不起,可用的例子很少。随着 LBAPI beta 的成熟,将会有更多更好的例子出现。我绝对建议您熟悉Lookback API (LBAPI) 文档,因为那里有很好的示例用于制定查询。

对于燃耗,假设您想要获取从 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
              ]

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

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

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

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

https://github.com/RallyHackathon

出于以下几个原因,请谨慎使用这些示例:

  • 为了清楚起见,Lumenize 命名空间的几个方面将被更改/重命名
  • 当前版本的 Lumenize 中存在一个错误,它的 timeSeriesCalculator 无法正确说明已删除或重新设置的故事。

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

于 2013-02-10T22:44:06.607 回答
2

不幸的是,.NET、Java 和 Python 工具包尚未更新以支持 Lookback API。因此,您必须直接向 Lookback API 的 REST 端点执行 HTTP POST,其正文类似于上面列出的 Mark W 和 Content-Type 'application/json'。

我建议使用 Chrome 扩展程序“XHR 海报”来试验您从浏览器发送的内容: https ://chrome.google.com/webstore/detail/xhr-poster/akdbimilobjkfhgamdhneckaifceicen

于 2013-02-11T15:05:57.623 回答