xml2jira

The xml2jira tool offers a simple way to automate creation/updating of JIRA issue tickets based on result output generated by Squish tests. It is feature-frozen and deprecated now that Test Center offers a Jira Integration that is more powerful and flexible.

xml2jira creates a JIRA ticket corresponding to a Squish test suite. When it got passed a new result.xml file, it connects to JIRA and (related to the test suite which has generated the result) creates a ticket there, or (if a related ticket already exists) it updates the already existing ticket with these new gathered, actual test results.

To make ticket creation and updating possible for xml2jira, your JIRA system needs to be configured so that 'labels' field is settable from within a project's default ticket creation dialog. xml2jira needs the 'labels' field to 'mark' a ticket, so it later can identify it as being the right ticket, corresponding to exactly that test suite which new gathered results are going to be updated.

The JIRA issue Description contains the Test suite status describing when the executed test cases passed or failed last and the test execution duration. If a corresponding issue already exists its description will be updated accordingly.

Test suite status

In addition, on every invocation of xml2jira, a comment containing an overview (Test suite summary) of the test cases executions mentioned in the specified Squish XML report file, will be added to the respective JIRA issue.

Test suite summary

Optionally the Squish XML report file can be added as file attachment to the JIRA issue for later analysis.

The xml2jira tool changes the JIRA issue status to Open if the Squish XML report file may contain any failure. If the report file does not contain failures, the status is set to Closed.

Usage

xml2jira --server <url> --user <name> --password <password> --project <project key> --reportfile <filename> --issueType <name> --component <name> --transitions <workflow> --customField <field=content> --commandFile <filename> --attachSquishReport --deleteIssue

Options

Workflow Endpoint Definitions

The --transitions option always needs 4 comma-separated parameters, given in this order, otherwise ticket creation will fail: Active=<meta-id>, AtransD=<meta-id>, Disabled=<meta-id>, DtransA=<meta-id>.

• For Active and Disabled, give the names of the states which xml2jira should use when updating results. In JIRA standard workflow, these would be called Open=1 and Closed=6. A PASSED update would lead to a ticket being Disabled and a FAILED update would lead to a ticket being Activated.
• For AtransD and DtransA names of the transitions leading from Active to Disabled state and vice versa must be given. In JIRA standard workflow, these would be called CloseIssue=2 and ReopenIssue=3.
• For each of these names also the <meta-id> must be given, separated by the equals sign (=).

A --transitions option with parameters that match the JIRA predefined standard states and transitions would look as follows:

xml2jira ... --transitions "Open=1,CloseIssue=2,Closed=6,ReopenIssue=3" ... --reportfile C:\report.xml

Examples

Here is an example invocation of the xml2jira tool which imports the Squish XML report file C:\report.xml into the specified JIRA server using the user alice and password al1ce for the project SampleProject and the component tests.

xml2jira --server http://jira:8080 --user alice --password al1ce --project SampleProject --component tests --reportfile C:\report.xml

Here is an example of using a command file called mycmd.txt:

# mycmd.txt
--reportfile C:\report.xml

You can use the command file with the xml2jira tool as follows:

xml2jira --server http://jira:8080 --user alice --password al1ce --project SampleProject --component tests --commandfile C:\mycmd.txt