Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titlePOST /rest/raven/1.0/import/execution/xunit
Panel
borderColor#ccc
borderStylesolid

Import the execution results created with the xUnit XML output formatter. For more information please check the documentation about xUnit integration.

Request

QUERY PARAMETERS
parametertypedescription
projectKeyString- key of the project where the Test Execution (if the testExecKey parameter wasn't provided) and the tests (if they aren't created yet) are going to be created.
testExecKeyString- key of the Test Execution.
testPlanKeyString- key of the Test Plan; if you specify the Test Plan, the Tests will be added automatically to the Test Plan if they're not part of it.
testEnvironmentsString- a string containing a list of test environments separated by ";"
revisionString- source code and documentation version used in the test execution.
fixVersionString- the Fix Version associated with the test execution (it supports only one value).

multipart/form-data:

"file" : a MultipartFormParam containing a XML file to import.

Example

Code Block
titlexUnit Report XML
<?xml version="1.0" encoding="utf-8"?>
<assemblies timestamp="08/10/2020 14:59:44">
  <assembly name="/Users/Projects/OurXunitTestsProject/OurXunitTestsProject/bin/Debug/netcoreapp3.1/OurXunitTestsProject.dll" run-date="2020-08-10" run-time="14:59:44" total="9" passed="5" failed="3" skipped="1" time="23.519" errors="0">
    <errors />
    <collection total="1" passed="0" failed="0" skipped="1" name="Test collection for OurXunitTestsProject.OurSkippableClass" time="0.001">
      <test name="OurXunitTestsProject.OurSkippableClass.AddTwoPlusTwo_EqualsFour" type="OurXunitTestsProject.OurSkippableClass" method="AddTwoPlusTwo_EqualsFour" time="0.0010000" result="Skip">
        <output>The calculation is wrong. It'll be fixed later.
</output>
        <traits />
      </test>
    </collection>
    <collection total="2" passed="1" failed="1" skipped="0" name="Test collection for OurXunitTestsProject.OurTestClass" time="0.009">
      <test name="OurXunitTestsProject.OurTestClass.AddTwoPlusThree_EqualsFive" type="OurXunitTestsProject.OurTestClass" method="AddTwoPlusThree_EqualsFive" time="0.0077767" result="Fail">
        <failure>
          <message>Assert.Equal() Failure
Expected: 5
Actual:   6</message>
          <stack-trace>   at OurXunitTestsProject.OurTestClass.AddTwoPlusThree_EqualsFive() in /Users/Projects/OurXunitTestsProject/OurXunitTestsProject/OurTestClass.cs:line 19</stack-trace>
        </failure>
        <traits />
      </test>
      <test name="OurXunitTestsProject.OurTestClass.AddTwoPlusTwo_EqualsFour" type="OurXunitTestsProject.OurTestClass" method="AddTwoPlusTwo_EqualsFour" time="0.0010802" result="Pass">
        <traits />
      </test>
    </collection>
    <collection total="4" passed="3" failed="1" skipped="0" name="Test collection for OurXunitTestsProject.OurTheoryClass" time="6.005">
      <test name="OurXunitTestsProject.OurTheoryClass.SumTwoNumbers(value1: -2, value2: 3, expected: 0)" type="OurXunitTestsProject.OurTheoryClass" method="SumTwoNumbers" time="1.5030442" result="Fail">
        <failure>
          <message>Assert.Equal() Failure
Expected: 0
Actual:   1</message>
          <stack-trace>   at OurXunitTestsProject.OurTheoryClass.SumTwoNumbers(Int32 value1, Int32 value2, Int32 expected) in /Users/Projects/OurXunitTestsProject/OurXunitTestsProject/OurTheoryClass.cs:line 21</stack-trace>
        </failure>
        <traits>
          <trait name="requirement" value="CALC-2088" />
          <trait name="labels" value="calculator theory" />
        </traits>
      </test>
      <test name="OurXunitTestsProject.OurTheoryClass.SumTwoNumbers(value1: -2147483648, value2: -1, expected: 2147483647)" type="OurXunitTestsProject.OurTheoryClass" method="SumTwoNumbers" time="1.5005778" result="Pass">
        <traits>
          <trait name="requirement" value="CALC-2088" />
          <trait name="labels" value="calculator theory" />
        </traits>
      </test>
      <test name="OurXunitTestsProject.OurTheoryClass.SumTwoNumbers(value1: 1, value2: 2, expected: 3)" type="OurXunitTestsProject.OurTheoryClass" method="SumTwoNumbers" time="1.5002999" result="Pass">
        <traits>
          <trait name="requirement" value="CALC-2088" />
          <trait name="labels" value="calculator theory" />
        </traits>
      </test>
      <test name="OurXunitTestsProject.OurTheoryClass.SumTwoNumbers(value1: -4, value2: -6, expected: -10)" type="OurXunitTestsProject.OurTheoryClass" method="SumTwoNumbers" time="1.5013213" result="Pass">
        <traits>
          <trait name="requirement" value="CALC-2088" />
          <trait name="labels" value="calculator theory" />
        </traits>
      </test>
    </collection>
    <collection total="2" passed="1" failed="1" skipped="0" name="Test collection for OurXunitTestsProject.OurTraitsClass" time="17.504">
      <test name="OurXunitTestsProject.OurTraitsClass.AddTwoPlusFour_EqualsSix" type="OurXunitTestsProject.OurTraitsClass" method="AddTwoPlusFour_EqualsSix" time="10.0027784" result="Pass">
        <traits>
          <trait name="test" value="CALC-2114" />
          <trait name="requirement" value="CALC-2088" />
          <trait name="labels" value="calculator sum core" />
        </traits>
      </test>
      <test name="OurXunitTestsProject.OurTraitsClass.AddTwoPlusFive_EqualsSeven" type="OurXunitTestsProject.OurTraitsClass" method="AddTwoPlusFive_EqualsSeven" time="7.5012751" result="Fail">
        <failure>
          <message>Assert.Equal() Failure
Expected: 7
Actual:   8</message>
          <stack-trace>   at OurXunitTestsProject.OurTraitsClass.AddTwoPlusFive_EqualsSeven() in /Users/Projects/OurXunitTestsProject/OurXunitTestsProject/OurTraitsClass.cs:line 29</stack-trace>
        </failure>
        <traits>
          <trait name="labels" value="calculator sum core" />
        </traits>
      </test>
    </collection>
  </assembly>
</assemblies>


Tip
titleExample Request

curl -H "Content-Type: multipart/form-data" -u admin:admin -F "file=@report.xml" http://yourserver/rest/raven/1.0/import/execution/xunit?projectKey=XTP

curl -H "Content-Type: multipart/form-data" -u admin:admin -F "file=@report.xml" http://yourserver/rest/raven/1.0/import/execution/xunit?testExecKey=XNP-23

curl -H "Content-Type: multipart/form-data" -u admin:admin -F "file=@report.xml" http://yourserver/rest/raven/1.0/import/execution/xunit?projectKey=XTP&testExecKey=XNP-23

curl -H "Content-Type: multipart/form-data" -u admin:admin -F "file=@report.xml" http://yourserver/rest/raven/1.0/import/execution/xunit?projectKey=XTP&testPlanKey=XTP-12&revision=v2.1.0

Responses

200 OK : application/json : Successful. The results were successfully imported to Jira.

Code Block
titleExample Output
{
   "testExecIssue":{
      "id":"12354",
      "key":"CALC-2174",
      "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12354"
   },
   "testIssues":{
      "success":[
         {
            "id":"12302",
            "key":"CALC-2122",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12302"
         },
         {
            "id":"12312",
            "key":"CALC-2132",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12312"
         },
         {
            "id":"12301",
            "key":"CALC-2121",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12301"
         },
         {
            "id":"12314",
            "key":"CALC-2134",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12314"
         },
         {
            "id":"12242",
            "key":"CALC-2114",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12242"
         },
         {
            "id":"12305",
            "key":"CALC-2125",
            "self":"http://www.examplexray-tst.xpand-it.com:28500/rest/api/2/issue/12305"
         }
      ]
   }
}

400 BAD_REQUEST : application/json : Returns the error.

401 UNAUTHORIZED : application/json : The Xray license is not valid.

500  INTERNAL SERVER ERROR : application/json : An internal error occurred when importing execution results.

...