Skip to main content
 首页 » 编程设计

python之如何使用 Rally python API 获取故事变更列表

2024年10月25日6think

如何在 Rally 中获取 Story 或 Defect 的更改列表?

对于 r in rally.get('User Story', fetch=True, query=""): 打印 r.Changesets

r.Changesets 似乎总是一个空集合。

我还尝试了 rally.get('Revision'...) 方法,它似乎返回了很多很多修改,但它们不包含对对象的任何引用(故事/缺陷/...) 被修改。

还尝试使用 query="ObjectID = %s"% r.FormattedID 但这始终不返回任何内容。

我还在 https://github.com/RallyTools/RallyRestToolkitForPython/issues/29 上打开了一个错误但我不确定这是否会很快引起注意。

请您参考如下方法:

Changeset 对象,它是WS API 中Change 对象的集合与修订无关。这些对象旨在与版本控制系统集成,例如Git、GitHub、Mercurial、Subversion 连接器等,在集成上下文之外没有任何意义。

可以从工件遍历,例如使用以下端点对其修订的用户故事。例如用户故事查询 (FormattedID = US123):

https://rally1.rallydev.com/slm/webservice/v2.0/hierarchicalrequirement?query=(FormattedID%20%3D%20US123)&fetch=true 

将包含对 RevisionHistory 对象的引用,为简洁起见进行了编辑

RevisionHistory:  
{ 
_ref: "https://rally1.rallydev.com/slm/webservice/v2.0/revisionhistory/19382984273",  
_type: "RevisionHistory" 
}, 

这个端点:

https://rally1.rallydev.com/slm/webservice/v2.0/revisionhistory/19382984273 

返回具有对 Revisions 集合的引用的 Revision 历史对象

{ 
RevisionHistory:  
{ 
_ref: "https://rally1.rallydev.com/slm/webservice/v2.0/revisionhistory/19382984273",  
_objectVersion: "3", 
CreationDate: "2014-05-29T15:23:21.491Z", 
ObjectID: 19382984273, 
Revisions:  
{ 
_ref: "https://rally1.rallydev.com/slm/webservice/v2.0/RevisionHistory/19382984273/Revisions",  
_type: "Revision", 
Count: 5 
} 
} 
} 

这是一个带有缩小获取的修订端点示例

https://rally1.rallydev.com/slm/webservice/v2.0/RevisionHistory/19382984273/Revisions?fetch=RevisionNumber,User,Description,CreationDate 

一般来说,修订历史查询是昂贵的,我们不建议使用它们,除非在狭窄的场景中。

v2.0 出于性能原因删除了在同一响应中返回子集合的功能。每WS API documentation获取集合将返回一个对象,其中包含从中获取集合数据的计数和 url。要获得完整的对象,需要单独的请求。

参见 this post提到了 LookbackAPI。 LBAPI允许获取历史数据。 pyral 或除 AppSDK2 之外的任何其他 Rally 工具包中没有对 LookbackAPI 的内置支持。但 LBAPI 与语言无关。