# Generic test data

SonarQube Server supports generic formats for test coverage and test execution import. If the default output of your coverage tool is not supported by SonarQube Server, you must convert it to this format:

## Generic test coverage report format <a href="#generic-test-coverage" id="generic-test-coverage"></a>

Report paths should be passed in a comma-delimited list to:

`sonar.coverageReportPaths`

The supported format is described by the `sonar-generic-coverage.xsd`:

```xml
<xs:schema>
  <xs:element name="coverage">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="file" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="lineToCover" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:attribute name="lineNumber" type="xs:positiveInteger" use="required"/>
                  <xs:attribute name="covered" type="xs:boolean" use="required"/>
                  <xs:attribute name="branchesToCover" type="xs:nonNegativeInteger"/>
                  <xs:attribute name="coveredBranches" type="xs:nonNegativeInteger"/>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          <xs:attribute name="path" type="xs:string" use="required"/>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
      <xs:attribute name="version" type="xs:positiveInteger" use="required"/>
    </xs:complexType>
  </xs:element>
</xs:schema>
```

and looks like this:

```xml
<coverage version="1">
  <file path="xources/hello/NoConditions.xoo">
    <lineToCover lineNumber="6" covered="true"/>
    <lineToCover lineNumber="7" covered="false"/>
  </file>
  <file path="xources/hello/WithConditions.xoo">
    <lineToCover lineNumber="3" covered="true" branchesToCover="2" coveredBranches="1"/>
  </file>
</coverage>
```

The root node should be named `coverage`. Its version attribute should be set to `1`.

Insert a `file` element for each file which can be covered by tests. Its `path` attribute can be either absolute or relative to the root of the module.

Inside a `file` element, insert a `lineToCover` for each line which can be covered by unit tests. It can have the following attributes:

* `lineNumber` (mandatory)
* `covered` (mandatory): boolean value indicating whether tests actually hit that line
* `branchesToCover` (optional): number of branches which can be covered
* `coveredBranches` (optional): number of branches which are actually covered by tests

## Generic test execution report format <a href="#generic-test-execution" id="generic-test-execution"></a>

Report paths should be passed in a comma-delimited list to:

```properties
sonar.testExecutionReportPaths
```

The supported format looks like this:

```xml
<testExecutions version="1">
  <file path="testx/ClassOneTest.xoo">
    <testCase name="test1" duration="5"/>
    <testCase name="test2" duration="500">
      <skipped/>
    </testCase>
    <testCase name="test3" duration="100">
      <failure/>
    </testCase>
    <testCase name="test4" duration="500">
      <error/>
    </testCase>
  </file>
</testExecutions>
```

The root node should be named `testExecutions`. Its version attribute should be set to `1`.

Insert a `file` element for each test file. Its `path` attribute can be either absolute or relative to the project’s base directory (root module).

Unlike for coverage reports, the files present in the report must be test file names, not source code files covered by tests.

Inside a `file` element, insert a `testCase` for each test run by unit tests. It can have the following attributes/children:

* `testCase` (mandatory)
  * `name` (mandatory): name of the test case
  * `duration` (mandatory): long value in milliseconds
  * `failure|error|skipped` (optional): if the test is not OK, report its status.