JIRA
  • 4 Minutes to read
  • Contributors
  • Dark
    Light

JIRA

  • Dark
    Light

Jira: Overview

AutoRABIT's Jira integration automatically posts updates to Jira tickets when you run validations and deployments, with a link back to the full report in AutoRABIT. It makes tracking the status of your user stories and support tickets faster and easier. Tasks can be organized by project, allowing an organization to transparently track issues within projects.

To put it simply: JIRA allows you to track any kind of unit of work (be it an issue, bug, story, project task, etc.) through a predefined workflow. However, in order to integrate JIRA as a plugin with AutoRABIT, it does require some steps in AutoRABIT to get it configured. The below section will help you out to get JIRA configured in AutoRABIT in easy steps.

Integrate Jira with AutoRABIT

Step 1: Store your user's JIRA credential in AutoRABIT

This is an initial step where the user's JIRA credential such as username and password is stored in AutoRABIT.

  1. Log in to your AutoRABIT account.
  2. Hover your mouse over the Admin module and click on the Credentials tab.
  3. Next, click on Create Credential from the right navigation bar.
  4. On the next pop-up screen, give a Credential name.
  5. Choose the Credential Type as 'User name with Password'.
  6. Enter your JIRA's username and password, we will store this encrypted.
  7. Please double-check that you use your JIRA username instead of the email address that you use to log in to JIRA.
  8. Click Save.
Troubleshooting
While registering JIRA with AutoRABIT, JIRA fails to connect and results in "Authentication Failure", please use the below steps to re-authenticate the JIRA.
  1. Use the "https://id.atlassian.com/manage/api-tokens" link to generate a new API token.
  2. Click on "Create API Token" and provide the label name and click on Create.
  3. The token gets created. You will be able to see the "Your new API token" popup, click on the "Copy to Clipboard".
  4. Use the copied token as a password for creating/updating the credential in AutoRABIT.
  5. Once updated please use the same credential to authenticate the JIRA.

Step 2: Integrate JIRA with AutoRABIT

  1. If you're logged out from your account, log in again into AutoRABIT with your credentials.
  2. Go to Admin > My Account section.
  3. Click on New ALM System under the ALM Management section.
  4. Select ALM type as 'JIRA' from the drop-down.
  5. Enter the label name of your own choice.
  6. Enter your Jira subdomain (e.g. https://[subdomain].atlassian.net) in the URL field.
  7. Select the same user's credential created in Step 1.
  8. Click Test Connection to check if the connection has been authenticated or not. A success message is displayed after the authentication is completed.
  9. Click Save () and your Jira integration is ready.
  10. Once you log in, JIRA is integrated with your AutoRABIT account and you can start logging bugs, issues with just one click directly to JIRA.

Mapping JIRA to Salesforce Org/ Version Control

Once you are done registering the plugins with AutoRABIT, make sure you map the JIRA ALM type with your required Salesforce Org/ Version Control. Mapping will help you manage a seamless and accurate Salesforce change management process, directly from within your Jira projects and teams. 

  1. Go to the Salesforce Org Management(Admin > SF Org Mgmt.) page.
  2. Select the Salesforce org for which you like to map the JIRA as a plugin.
  3. Under Salesforce Org- Mappings tab, choose JIRA as ALM type and click on Mapping.
  4. Select the label and the project.
  5. Click Save Mappings. The selected plugin will be mapped with your Salesforce Org.

Configuring JIRA Work items in AutoRABIT

You and your team members have a provision to perform actions on Jira issues or update the Jira work items while running a commit or during a CI job.

In EZ-Commit

In the EZ-Commit screen and under the Post Commit section, you need to:

  1. Select the checkbox: Update ALM Workitem Status
  2. Select the ALM type as JIRA.
  3. Select the ALM Label, project, and the sprint for which the commit is planned.
  4. Select the work item and the status.
  5. Once the changes are committed to the version control system, the status of the ALM work item is updated and reflected in your ALM system.

In CI Job

Important Notes:
Configuring the Jira work items are applicable for the following CI jobs:
  1. Package from Version Control
  2. Deploy from Version Control
  3. Deploy from SFDX branch to a Salesforce Org
  4. Install an Unlocked Package from Version Control Branch
  1. Go to the Build section under the New Create CI Job screen.
  2. Tick the Map ALM Project (Ex: Jira) checkbox.
  3. Go to the ALM section. Here you can configure work item type status in JIRA ALM to include in the build.
  4. Select the ALM type as JIRA.
  5. Select the ALM Label and its related Projects.
  6. The active sprint(s) for the above selected Project will be available in the Sprint drop-down. AutoRABIT has given provision to you to update multiple sprints related to tasks or bugs and update the status on the go when running the CI Job. You can select either one of the sprints or if you wish to update the status for all the sprints, leave as default i.e., keep 'All Active Sprints' in the selected mode.
  7. Select the Work Item type. Here you can select multiple work items that you like the update the status in your ALM. To use all the work item types, keep the 'All Work Item Type' option selected by default.
  8. Based on the above Work Item selected, you need to update the status for each work item type. See the screenshot attached.

What's Next