如何将LookbackAPI用于燃耗图表?

时间:2013-02-08 22:14:17

标签: rally lumenize

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

2 个答案:

答案 0 :(得分:2)

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

对于刻录,假设您希望从2013年1月15日到2013年1月30日获得迭代的状态快照,并且迭代适用于深度为4的项目层次结构。以下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
              ]

Iteration的ObjectID是否称为“Iteration 1”。从迭代:(Name = "Iteration 1")的标准WSAPI查询中获取这些对象ID可能最容易。对于复制到四深项目层次结构中的迭代,我们会看到四个迭代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 App开发。

答案 1 :(得分:2)

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

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