RQM REST API: testphases vs. iterations
I'm having trouble finding information on testphases and iterations. My main resource thus far has been:
https://jazz.net/wiki/bin/view/Main/RqmApi
My issue is when I pull the TC result and TS result information, each result maps to a "testphase id" in the XML. So I pull the testphase information so I can get the testphase/iteration titles (I'm expecting that "testphases" are really RQM timeline Iterations). I run the following:
java -jar RQMUrlUtility.jar -command GET -user <user> -password <password> -filepath /tmp/output/testphase.xml -url "https://jazzsdi05.svl.ibm.com:9446/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/Swordfish QA (New)/testphase?fields=feed/entry/content/testphase/(*)"
This gives me XML that looks like:
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
<ns4:testphase xmlns:ns4="http...
<ns6:identifier>https://jazzsdi05.svl.ibm.com:9446/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/Swordfish+QA+%28New%29/testphase/urn:com.ibm.rqm:testphase:1266</ns6:identifier>
....break...
<ns4:iteration href="https://jazzsdi05.svl.ibm.com:9446/qm/process/project-areas/_RMkHTsGVEeO578RCTqaMVw/timelines/_Fj3YWMG1EeO578RCTqaMVw/iterations/_Fj3YW8G1EeO578RCTqaMVw" />
The problem is I will see multiple entries for "Swordfish_Test_Iteration" in the XML that each have a unique <ns6: identifier>, and this is what TC results and TS results map to (they have a "testphase id" field). But, as implied, the <ns6: identifier> is NOT unique to an iteration. What *IS* unique to a iteration is the <ns4: iteration href>.
1) I don't see "iteration" as a property for testphase in the REST API documentation here:
https://jazz.net/wiki/bin/view/Main/RqmApi
Why is that?
2) It seems to map a TC result or TS result to a unique iteration I have to go TCR -> Testphase ID -> Iteration ID. Is this the right approach? If yes, why isn't there a more direct path for something so fundamental as mapping a TCR to a Iteration?
3) Can someone explain what a testphase is and what a iteration is? And how they relate?
Please help me understand this. This is preventing us from reporting results.
https://jazz.net/wiki/bin/view/Main/RqmApi
My issue is when I pull the TC result and TS result information, each result maps to a "testphase id" in the XML. So I pull the testphase information so I can get the testphase/iteration titles (I'm expecting that "testphases" are really RQM timeline Iterations). I run the following:
java -jar RQMUrlUtility.jar -command GET -user <user> -password <password> -filepath /tmp/output/testphase.xml -url "https://jazzsdi05.svl.ibm.com:9446/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/Swordfish QA (New)/testphase?fields=feed/entry/content/testphase/(*)"
This gives me XML that looks like:
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
<ns4:testphase xmlns:ns4="http...
<ns6:identifier>https://jazzsdi05.svl.ibm.com:9446/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/Swordfish+QA+%28New%29/testphase/urn:com.ibm.rqm:testphase:1266</ns6:identifier>
<ns6:title>Swordfish_Test_Iteration</ns6:title>
<ns4:iteration href="https://jazzsdi05.svl.ibm.com:9446/qm/process/project-areas/_RMkHTsGVEeO578RCTqaMVw/timelines/_Fj3YWMG1EeO578RCTqaMVw/iterations/_Fj3YW8G1EeO578RCTqaMVw" />
The problem is I will see multiple entries for "Swordfish_Test_Iteration" in the XML that each have a unique <ns6: identifier>, and this is what TC results and TS results map to (they have a "testphase id" field). But, as implied, the <ns6: identifier> is NOT unique to an iteration. What *IS* unique to a iteration is the <ns4: iteration href>.
1) I don't see "iteration" as a property for testphase in the REST API documentation here:
https://jazz.net/wiki/bin/view/Main/RqmApi
Why is that?
2) It seems to map a TC result or TS result to a unique iteration I have to go TCR -> Testphase ID -> Iteration ID. Is this the right approach? If yes, why isn't there a more direct path for something so fundamental as mapping a TCR to a Iteration?
3) Can someone explain what a testphase is and what a iteration is? And how they relate?
Please help me understand this. This is preventing us from reporting results.
Accepted answer
If you check the "Resources and their Supported Operations " table, you will see that the "testphase" resource is the Test Schedule of a Test Plan.
https://jazz.net/wiki/bin/view/Main/RqmApi#Resources_and_their_Supported_Op
A test schedule is not the same as an iteration, but rather a combination of a test plan and an iteration (or iterations). This article explains it pretty well.
https://jazz.net/library/article/810
I'm not sure why "iteration" is not listed as a property of a "testphase" in the specification. From what I can see, the "iteration" property refers to an iteration (of a timeline) literally.
https://jazz.net/wiki/bin/view/Main/RqmApi#Resources_and_their_Supported_Op
A test schedule is not the same as an iteration, but rather a combination of a test plan and an iteration (or iterations). This article explains it pretty well.
https://jazz.net/library/article/810
I'm not sure why "iteration" is not listed as a property of a "testphase" in the specification. From what I can see, the "iteration" property refers to an iteration (of a timeline) literally.
Comments
Kellen Bombardier
Oct 02 '14, 12:18 p.m.I am seeing the same issue with a project we are working on. Can someone with information on these questions help out here?