Skip to content

ALM Octane#

This integration is in beta and cannot be configured from Zebrunner UI. For more information refer to Configuration section.

ALM Octane is a web-based application lifecycle management platform that enables teams to collaborate easily, manage the product delivery pipeline, and visualize the impact of changes.

The integration allows users to consolidate automated test cases and automated runs in Octane based on the data reported in Zebrunner.

Note: integration is supported on a per-project basis, meaning that different projects in Zebrunner can be connected to different shared spaces and/or workspaces.


  • You need to have the Octane shared space id and workspace id that Zebrunner should integrate with. These ids can be taken from browser url. For example, when you have the Quality -> Overview page opened, your browser url should look like<shared-space-id>/<workspace-id>#/product-overview/hierarchy/dashboard . The ids specified in <> are the ones you need.
  • You need to have a client id and client secret with access to the shared space and workspace from previous precondition.


Currently, there is no separate page on Zebrunner UI to set up the integration. To set up the integration, you need to contact Zebrunner support and provide ids and credentials described in Preconditions section.

Set up test project#

In order to indicate the need to push results of specific test suite execution to Octane, you need to attach label to the test run in test code. The label key is, the value must be true. For more information about how to do this, please refer to the documentation of reporting agent of your choice.


For TestNG and Carina, you can attach the required label on before suite phase as in the following code snippet.

package com.qaprosoft.carina.demo;

import com.zebrunner.agent.core.registrar.Label;
import org.testng.annotations.BeforeSuite;
import org.testng.annotations.Test;

public class APISampleTest implements IAbstractTest {

    public void setUpIntegrationWithOctane() {
        Label.attachToTestRun("", "true");

    public void testCreateUser() {
        // test code

    public void testCreateUserMissingSomeFields() {
        // test code

    public void testGetUsers() {
        // test code

    public void testDeleteUsers() {
        // test code


After the first execution of the test class, 4 automated tests will be created in Unassigned application module in Octane. On the figure below, you can see 4 automated tests resided carina-demo -> api application module. These 4 tests were moved to the application module manually. All subsequent executions of the tests will not affect the location of the automated tests.

Automated Tests

Results of the test executions can be found in Runs section in Octane.

Automated Runs

By clicking on the automated run id, you open detailed information. From this page, you can open test execution results in Zebrunner. To do this, click on Open Test Run Report button which is placed at the top of the automated run details and click on the Accept button.

Automated Run Details

On the details page you can find the entire history of the automated test executions. for this, navigate to the Previous Runs tab. Each item in the history has a reference to results in Zebrunner.

Automated Run Previous Runs