query rally using node WS-API to search for changes between two dates - node.js

Question

I am trying to use Rally WS-API to fetch those User stories and Features that were changed between two dates. The closest I got was getting to the Revision. But I am not sure on how to get the features and User stories from It. Thanks in advance
<pre>
==Request==
restApi.query({
type: 'Revision',
query: queryUtils.where('CreationDate', '>=',’2015-03-01’),
fetch: ['FormattedID', 'Name','Release','State','RevisionHistory','Revisions','PortfolioItem/Feature','ObjectID','VersionId'],
scope: {
workspace: 12345,
project: 54321
}
})
</pre>
<pre>
==Response==
{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
Errors:[
],
Warnings:[
],
TotalResultCount:2,
StartIndex:1,
PageSize:2,
Results:[
{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/revision/31480953333',
_refObjectUUID:'98e0ff40-34cb-494f-afc3-3cfeefdd1ce1',
_objectVersion:'1',
ObjectID:31480953333,
VersionId:'1',
RevisionHistory:{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/revisionhistory/31276441234',
_refObjectUUID:'dc6978c3-9fa1-4c24-b900-01d5aedd6007',
_objectVersion:'1',
ObjectID:31276441234,
VersionId:'1',
Revisions:{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/RevisionHistory/31276441234/Revisions',
_type:'Revision',
Count:7
},
_type:'RevisionHistory'
},
_type:'Revision'
},
{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/revision/31484636333',
_refObjectUUID:'4b41e138-9026-46e7-ac24-94b7dd0765f8',
_objectVersion:'1',
ObjectID:31484636333,
VersionId:'1',
RevisionHistory:{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/revisionhistory/31283675555',
_refObjectUUID:'1142d961-8928-4a9e-8ca1-bc6dd6df17b7',
_objectVersion:'1',
ObjectID:31283675555,
VersionId:'1',
Revisions:{
_rallyAPIMajor:'2',
_rallyAPIMinor:'0',
_ref:'https://rally1.rallydev.com/slm/webservice/v2.0/RevisionHistory/31283675555/Revisions',
_type:'Revision',
Count:4
},
_type:'RevisionHistory'
},
_type:'Revision'
}
]
}
</pre>

Answer 1

With Rally WSAPI, it's probably easiest to use a LastUpdateDate-bounded query:
((LastUpdateDate >= 2015-01-01T00:00Z) AND ((LastUpdateDate < 2015-03-01T00:00Z))
Rather than looking at RevisionHistories for individual artifacts.
However you would need to do a separate query for User Stories and Features, respectively.
An alternative way to accomplish this type of date-bounded change queries, especially if you are interested in a specific type of state-transition, would be to use Rally's Analytics 2.0 / Lookback API framework:
https://rally1.rallydev.com/analytics/doc/#/manual
https://www.rallydev.com/community/developer-product/analytics-20-announcing-lookback-api
I'm not sure if the Rally node toolkit has support for Lookback, but it wouldn't be too hard to extend it to do so.
There is a Java toolkit for accessing Lookback API:
https://github.com/RallyTools/Rally-Lookback-Toolkit