Test Management for Jira plugin

The ALM Octane – Test Management for Jira plugin provides Jira users test coverage and status information directly on native Jira epics, stories, issues, or custom types. The plugin is available in two versions: either for Jira on-premises environments, or for Jira Cloud with OpenText ValueEdge.


The ALM Octane – Test Management for Jira plugin allows Jira users to continue planning and working in Jira, with immediate visibility into the quality processes being managed in ALM Octane. This plugin helps Jira users understand test coverage and pass/fail status, while providing QA with full visibility and alignment to the development process being managed in Jira.

For details on supported Jira and ALM Octane versions, see Support Matrix.

Note: For details on the plugin REST API, see Test Management for Jira plugin API.

Benefits of the plugin and Micro Focus Connect

The ALM Octane – Test Management for Jira plugin helps Jira users establish visibility into the quality process being managed in ALM Octane. For example, you can see the test coverage of an ALM Octane user story in Jira.

With Micro Focus Connect you can synchronize entities and issue types between ALM Octane and Jira, including releases, sprints, and backlog items, but not including tests. For details, see Use-case: Syncing ALM Octane and Jira.

If you use both Micro Focus Connect and the ALM Octane – Test Management for Jira plugin, backlog items are synced from ALM Octane to Jira using Micro Focus Connect. For those backlog items you see test coverage in Jira using the plugin.

The plugin works based on a user-defined field that is created in ALM Octane that contains the Jira issue type key. This way the plugin knows where to put the test coverage details. Using Micro Focus Connect can make this easier by populating the ALM Octane UDF with Jira key values.

Back to top


This section describes how to install the plugin for Jira on-premises and Jira Software Cloud environments.

Jira On-Premises

You can install the plugin from within Jira as described in Installation.

Alternatively, you can download the plugin as a .jar file from Atlassian Marketplace or AppDelivery Marketplace, and install it as follows:

  1. Log into your Jira instance as admin.

  2. From the Admin dropdown, choose Add-ons.

    The Manage add-ons screen appears.

  3. Click Manage add-ons.

  4. Click Upload add-on, and navigate to the location of the downloaded .jar file.

Jira Software Cloud

Follow these steps to install the plugin for Jira Cloud with ValueEdge:

  1. In AppsManage apps, select Find new apps.

  2. Search for ALM Octane, and select ALM Octane - Test Management for Jira Cloud.

  3. Click Get app.

  4. After loading, go to Manage apps and configure the plugin.

Back to top


You can configure multiple ALM Octane spaces, and multiple workspaces in each space.

  1. Create a UDF of type string containing the Jira issue key. Add this to your ALM Octane features, user stories, defects, application modules, and requirement documents.

    You can do this when you synchronize Jira with ALM Octane, or without synchronization. For example, if you have a user story in ALM Octane to cover the quality of a user story in Jira, you can create a UDF and manually enter its Jira issue key.

  2. In the plugin configuration screen > Spaces area (Shared Spaces in the Cloud version), click Create.

  3. Enter a name for the space, the ALM Octane URL, and the client ID and client secret used to access the space. For details, see API access.

    Note: When configuring for Jira Cloud, the ALM Octane URL should point to an ALM Octane SaaS (HTTPS) location.

  4. In the plugin configuration screen > Workspaces area, click Create.

  5. Create one or more workspace configurations as follows:

    1. Select a space from the list of spaces you defined, using the space name.

    2. Select a workspace.

      If you are using the Jira on-premises plugin, you can select multiple workspaces.

    3. Enter the ALM Octane UDF in the Mapping field area (for example, jira_key_udf).

      The icon next to the Mapping field area provides suggestions for relevant UDFs based on the workspace you selected. These are the fields that include jira in their name.

      If you selected multiple workspaces in Jira on-premises, the Mapping field suggestions list the intersection of the relevant UDFs, meaning those that appear in all of the selected workspaces.

    4. The Entity types field is automatically populated with the ALM Octane entities that have this UDF defined, to help you verify that you entered the correct Mapping field.

      If you selected multiple workspaces in Jira on-premises, this shows the intersection of all the selected workspaces.

    5. Select one or more Jira projects and Jira issue types where you want to see quality from ALM Octane.

    Note: When installing in a Jira on-premises environment, if you experience connection problems add a proxy in the upper right corner of the screen.

Back to top

ALM Octane Test Coverage Widget Summary

After setting up the plugin, the ALM Octane Test Coverage widget is added to issue details. The widget shows the number of tests related to the entity, and the summary of the last runs of these tests.

In Jira on-premises, use the dropdown to select an ALM Octane workspace. The entity mapped to the current Jira issue appears.

Each test can be executed using more than one configuration, for example using different browsers. The widget shows a summary of the last run status of all the configurations. As a result, an entity might have (for example) 1 test and 3 test runs, since each run reflects a different configuration.

You can drill from the widget to the entity in ALM Octane, and to its related test details.

Back to top

Data Security and Privacy Statement (On-Premises)

The ALM Octane – Test Management for Jira plugin does not exfiltrate any of your data from the machine that hosts Jira.

The only information that the plugin stores is the configuration details listed in the Configuration section above, that specify which ALM Octane space you are mapping to which Jira project. This is stored in the database management system that you have configured Jira to use.


The ALM Octane – Test Management for Jira plugin does not store any personally identifiable information in our databases.

OpenText encourages the customer to ensure secure connection between the plugin and the ALM Octane server by configuring communication over HTTPS, which is not provided by OpenText. By not implementing communication over HTTPS you may be exposing the system to increased security risks. You understand and agree to assume all associated risks and hold OpenText harmless for the same. It remains at all times the Customer’s sole responsibility to assess its own regulatory and business requirements. OpenText does not represent or warrant that its products comply with any specific legal or regulatory standards applicable to Customer in conducting Customer's business.

Back to top

See also: