Crucible REST API filter fromDate & toDate

Question

/rest-service/reviews-v1/filter?fromDate=&toDate= What is the meaning of fromDate and of toDate? Can someone provide a definition? The official online document says nothing about it. Thx. (I understand the time is in unix time (milliseconds) ) Assume this notation: time t1 < time t2 < time t3, ... Take this simple example, if a review CR-ABC-3 is created at time t5, summarized and closed at time t10. If I specify (fromDate=t1, toDate=t7), shall I expect to find the review? How about (fromDate=t7, toDate=t9)? How about (fromDate=t7, todate=t11)? How about (fromDate=t11, toDate=t15) Thanks, Wei

Wei-Hwan Chiang · Answer

Hi Piotr, thx for the clarification!

Wei

Piotr Swiecicki · Answer

Hi @Wei-Hwan Chiang,

Apologies for the confusion, the same issue was recently identified on https://jira.atlassian.com/browse/CRUC-6941 issue.  The documentation will be clarified in the upcoming 3.7 release.

Basically both dates as you guessed represent unix time expressed in milliseconds.  They are compared against the last activity on the review.   In your case as the review was last updated at time t10, you should expect this review to be returned when filter (fromDate=t7, toDate=t11) is specified.

Hope that helps,
Piotr