我需要一个使用 LookbackAPI 来获取燃尽图数据的好例子。我在 API 上看到了一些有限的问题和响应,但没有关于如何使用它的示例。我需要完成故事点和故事点的当前范围。
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 应用程序开发。
不幸的是,.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