TestNG Integration

TestNG tests are written in the form of Java classes and methods, for example:

public class ExempleTest {

    @Test(groups = { "group-1", "group-2" })
    public void DEV_T19_testMethod1() {
        assertThat(true).isTrue();
    }

    @Test()
    public void testMethod2_DEV_T21() {
        fail("failing test");
    }

    @Test(dependsOnMethods = {"testMethod2_DEV_T21"})
    public void testMethod3() {
        assertThat(true).isTrue();
    }
}

Note that the first method name begins with DEV_T19 and the second method name ends with DEV_T21. This particular prefix will map the result of each of those test methods to the corresponding test cases in Zephyr Squad if they exist, respectively test cases with key DEV-T19 and DEV-T21.

Also, note that the last method testMethod3 is not prefixed with a test case key. Zephyr Squad will try to find an existing test case that matches the package, class, and method name, in this case, com.example.testng.ExampleTest.testMethod3, and map the result of the test method to the test case. If these test cases don’t exist, an error will be returned when the results are uploaded to Zephyr Squad.

If any test case, prefixed with the test case key or not, is not found, an error will be returned when the results are uploaded to theZephyr Squad. In this case, if you intend to automatically create test cases that don’t exist previously, a flag autoCreateTestCases=true can be set when uploading test results to Zephyr Squad.

To summarize, the rules for matching a test method to a test case are:

By default, TestNG should already generate JUnit XML results file. If the listener responsible for generating this file is disabled for some reason, it might be necessary to configure the listener org.testng.reporters.JUnitXMLReporter to make sure the JUnit XML will be generated. This configuration works either if you are using Maven or Gradle. Check our code sample in the next sections below for more information on how to configure this listener.

Once the TestNG tests have been executed, the results can be uploaded to Zephyr Squad. There are two options for uploading test results:

Both options work the same way and can be uploaded using the same API endpoint: Zephyr Squad for Jira Cloud API .

Below, an example using curl of how to use the API endpoint for uploading one single file:

curl -H "Authorization: Bearer ${TOKEN}" -F "[email protected];type=application/xml" https://prod-api.zephyr4jiracloud.com/v2/automations/executions/junit?projectKey="JQA"&autoCreateTestCases=true

and for uploading a zip file containing multiple XML files:

curl -H "Authorization: Bearer ${TOKEN}" -F "[email protected];type=application/x-zip-compressed" https://prod-api.zephyr4jiracloud.com/v2/automations/executions/junit?projectKey="JQA"&autoCreateTestCases=true

Note the query parameters on the URL. The projectKey specifies what project will be used to create the test cycle. The autoCreateTestCase will create a test case using the TestNG test method name when no matching test case is found.

Please check our code example using TestNG for more technical information on how to write tests and configure TestNG to output JUnit XML results files:

https://github.com/SmartBear/zephyr-for-jira-examples