ALM – Test Management for Jira Plugin

Micro Focus ALM

Software version: 1.0

Software release date: September 2021

Document publication date: February 2022

## Overview

The ALM – Test Management for Jira plugin provides Jira users with test coverage and status information directly on native Jira epics, stories, issues, or custom types.

This allows Jira users to continue planning and working in Jira, with immediate visibility into the quality processes being managed in ALM. 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.

Supported platforms:

- Jira Data Center: 8.0.0 - 8.14.0

- Jira Server: 7.0.0 - 8.14.0

Note: This plugin does not support Jira Cloud.

ALM versions: 12.60 and later versions

## Install

To install the ALM - Test Management for Jira plugin:

1. Pre-requisite: Add test coverages for your requirements in ALM.

   For details, see the ALM help.

2. Go to Atlassian Marketplace. In the Search for apps field, search for the plug-in with the keyword "ALM – Test Management for Jira".

3. Click the ALM – Test Management for Jira card to open its details page. Click Get it now to download the plugin.

4. Sign in to Jira as a project administrator. In the masthead, click Administration > Manage apps > Upload apps > Choose File.

5. Select the JAR file you download and click Upload.

6. Click Close.

   You can find ALM CONFIGURATION SECTION on the left panel of the page.

## Configure

Complete the following tasks to set up the plugin.

Add a custom field to store ALM requirement ID

Add a custom field of the ALM Requirement Id Custom Field type in Jira. This custom field is used to store the ID of the ALM requirement that is mapped to the Jira issue.

To add a custom field:

1. Sign in to Jira as a project administrator. Go to Administration > Issues, and click Custom fields.

2. Click Add custom field.

3. In the Select a field type window, click Advanced, select ALM Requirement Id Custom Field, and click Next.

4. Enter the name and description for the custom field, and click Next.

5. Configure the context for the custom field and click Create.

6. After you create the custom field, you’ll be moved to the Screens page. Select which screen the custom field should be displayed on, and click Update.

Add an ALM server configuration

You can add multiple ALM server configurations in the ALM – Test Management for Jira plugin.

To add an ALM server configuration:

1. Sign in to JIRA as a project administrator.

2. Click Administration > Manage apps.

3. In the ALM Configuration section, click Configuration, and in the ALM Servers section, click Add an ALM server.

1. Configure the attributes of your ALM server.

   For information about managing ALM API keys, see the ALM help.

2. Click Test connection to test the connection with your ALM server.

3. Click Create.

4. If you want to use proxy, click the Proxy Settings button.

Add entity mappings

After adding an ALM server configuration, you can add entity mappings between ALM requirements and Jira issues.

To add an entity mapping:

1. Sign in to JIRA as a project administrator.

2. Click Administration > Manage apps.

3. In the ALM Configuration section, click Configuration, and in the Entity Mappings section, click Add a mapping.

4. Enter the following information, and click Create.

   Field | Description
   --- | ---
   ALM Server | Select an ALM server configuration you added.
   Domain | Select the domain where the ALM project you want to map is located.
   Project | Select the ALM project to map.
   Jira Project Keys | Select the Jira project where the Jira issue types you want to map is located.
   Jira Issue Types | Select the Jira issue types to map. The issue types of the selected Jira project that have been mapped with ALM projects are not available for selection.

## Synchronize

Data between Jira and ALM can be synchronized using Micro Focus Connect or manually.

Synchronize with Micro Focus Connect | If you use Micro Focus Connect to synchronize Jira with ALM, the value of the custom filed that stores the mapped ALM requirement ID can be set automatically. To synchronize with Micro Focus Connect, add a mapping between the ALM field Req ID and the custom field you added in Jira.
Synchronize manually | You can manually enter the value for the custom field to synchronize Jira with ALM. To edit the value for the custom field: Sign in to Jira. In the Projects menu, select your Jira project and Jira issue. Click Edit and find the custom field. Filled the field with the ALM requirement ID that covers the quality of the Jira issue you selected. Click Update.

## ALM Test Coverage widget summary

After you complete configuring the plugin, the ALM Test Coverage widget is added to issue details.

- The widget shows the number of tests related to the entity, and the test status of the last runs of these tests.

- Click the requirement ID to drill down to the requirement and the details of its related tests in ALM Client.

- Click the number of a specific test status to view the details of tests of the specific test status in a new widget. Click a test ID to drill down to the related test plan in ALM Client.

- Click View <number> linked ALM tests detail to view the details of all the tests in a new widget. Click a test ID to drill down to the related test plan in ALM Client.

© 2002 - 2022 Micro Focus

Send documentation feedback