Open Category List

Setting Up Two-way Jira Integration

3 minutesread

For those with Jira 6.0 and higher, the Applause platform allows you to map your Jira issue statuses to ours. Status updates happen automatically in both directions.

Video Tutorial: Step-by-Step Walk-through

 

Two-way Integration Workflow

  • Changing the status of an issue in your Jira instance to a defined value such as “Ready for Testing,” triggers the associated Applause issue to be updated automatically to “Ready to Verify.”
  • From within the Applause platform, verification test cycles can then be created for issues with the “Ready to Verify” status.  
  • Bugs are verified by our testers as either fixed or failed, and are then Approved in the Applause platform.
  • Applause will update your Jira issue status to whatever state you desire.  Example: “Failed Testing” or “Verified.” 
  • Comments and screenshots from our testers will be included in your Jira issues.2wayjira_flowdiagram

Status Configuration Within Your Jira Instance

Before you set up the two-way BTS connection in the Applause Platform, make sure you have created all of the necessary statuses within your Jira instance. You will use these statuses to map to the Applause Platform bug statuses, and vice versa (See: How to create a custom Jira status). Once you have these established, you can begin configuration in the Applause Platform.

Test Jira Connection

With 2-way Jira integration allowing status updates on Issues to happen in both directions, there is a chance the customer’s Jira workflow will not support the Applause Platform when updating a ticket from Closed back to Open. Use the Test Statuses button to send a test bug update to your BTS platform. This will indicate right away if this feature will work. If not, you may need some adjustment in your Jira workflow.

Two-way Configuration in the Applause Platform

From the Product Edit/Create Screen…

  1. In step 4 (“Integrations”), after setting up your initial Jira connection and choosing field mappings for exported bugs, check the“Enable two-way Integration” box.
    • If you already have a Jira connection set up, you’ll need to click the “Refresh Connection” button in the UI to enable.
  2. Set up Jira to Applause mappings:
    • Map your appropriate Jira status (e.g. “Ready for Testing”) to Applause’s “Ready to Verify” status.  The values you see in the drop-down are being pulled directly from your Jira instance. (See: How to create a custom Jira status)
    • Then, map your next Jira status (e.g. “Verified”) to the Applause “Resolved” status.
  3. Set up Applause to Jira mappings:
    • An Applause bug which is set to “Verification – Fixed” maps to your Jira status (e.g. “Verified”)
    • An Applause bug set to “Verification – Failed” maps to your Jira status (e.g. “Failed Testing”)

enable2wayjiraWhen you click save you’ll be prompted to create a webhook on your Jira. We offer two methods for this:

  • Provide your Jira admin credentials (one-time only), and we’ll set it up for you automatically (we do NOT store your credentials)
  • OR, setup your Jira webhook manually 

Troubleshooting: If updates between the Applause Platform and your Jira are not working, the issue may be the workflow permission settings in Jira.  In some cases the “Verification failed” status in the Platform will fail to reopen a ticket in Jira. Make sure that the credentials used in our platform are given the correct workflow permissions for changing ticket status.

For a visual step-by-step walk-through of Two-way Integration in action, watch the video tutorial at the top of this page.

0
0
132
3 minutesread

Related Knowledge Base Posts