ALM Management

Overview

We've added a new section called ALM Management to the Admin module with the release of ARM 21.6. This section contains detailed information on all of your ALM's active and inactive sprints. It also lists work items and allows you to establish criteria for updating work item status by mapping your ALM with your version control repository.

Registering an ALM

1. Log in to AutoRABIT as an administrator.
2. Navigate to Admin > ALM Mgmt.
3. Click Register ALM on the ALM Mgmt. screen.
   
4. Configure the following settings:
   1. For IBMRTC, CA Agile Central, VersionOne, and Azure DevOps:
      
      • ALM Name: Enter a name for your ALM connection.
      • ALM Type: Select the ALM type.
      • ALM URL: Add the ALM server URL.
      • Credentials: Specify your credentials. For more info on creating and storing your credential inside ARM, refer to the Credential Manager section.
   2. For JIRA: 
      
      • ALM Name: Enter a name for your ALM connection.
      • ALM Type: Select the ALM type as JIRA.
      • Access Type: Select the Access Type:
        • Standard: Add the ALM server URL for the standard access type and specify your credentials as mentioned above.
        • OAuth: Select the access type as OAuth, and click on Validate & Save. You will be redirected to the ALM's website to authenticate your credentials and grant permission. Jira OAuth access type is currently supported for Cloud versions only. This function is on-demand, so if you'd want to make it available for your organization, please get in touch with our experts at support@autorabit.com.
          
          The Access Token expires in one hour. The Refresh Token expires every 90 days.
5. Click on Test Connection to authenticate your credentials.
6. Click Save.
7. Once your ALM is registered successfully, you will be able to view it in the ALM List menu.
8. Use the AR Comments toggle button to turn off the Jira comments from AR. By default, the Jira comments are ON for newly registered and existing ALMs.
9. Use the Access Type drop-down list to switch between Standard and OAuth. Click on Re-Authenticate if your credentials have expired. This is only applicable to Jira ALMs.

Integration Settings

By default, we do not display the work items from the inactive sprints; however, if you would like to view the hidden items, you can do so from this section.

1. Select the following checkbox to view the work items from the inactive sprints: Display work items from inactive sprints (we recommend setting up global filter criteria if are enabling this)
2. Enable global filter criteria on workitems: This checkbox allows you to specify filter criteria.
   • You can select which fields are displayed by selecting the necessary column/field. However, you can further refine the list of work items that are displayed by configuring a worklist filter.
   • Repeat these steps for each field if you want to set filter criteria.
3. Click Save Settings.
   

Note: To remove a field's filter criteria, click on the  icon to the right of the rule.

Smart Commits

In this section, you can select the pattern that will be used to read the comment in a revision associated with your ALM story. For example, 'git commit m [project123] # add README file into the project'

Repository Mappings

Map your ALM with your version control repository, and set the criteria to update the work item status from one stage to another stage.

1. Select your version control repository.
2. Select the branch. If you're not able to view your branch from the dropdown list, please click on the 'Don't see your branch? Register here' link at the bottom of the page.
3. Select your configured project.
4. When you click on the ALM Work Item Status field, a popup page appears, which allows you to select the work item type and current item status and set the item status to update.
   
5. Click Save.
   
   Important Note:

   Only those branches and Repo configurations for which the user has permissions will be visible in the respective dropdown lists. The Repos or branches for which the user does not have permissions will be hidden.
6. Also, the ALM can be configured not to send e-mail notifications of work item updates to the concerned person. You need to type in the email address(es) in the Status Update exception Email field.