This page is specific to the Applause DX platform. If you are looking for Jira integration steps using our Applause In-The-Wild platform, please refer to this documentation.
The Applause DX Bug Tracking System integration offers users the ability to turn the Applause platform into a direct extension of their own backend BTS. Applause DX supports JIRA (REST API) Versions 5.0 or later.
Customers can access the BTS settings page from the settings drop-down menu, locating in the top-right corner.
An Applause BTS Connector is a configuration that allows Issues to be exported to your Jira server.
- Test/Refresh Connection: After entering all the required fields for a new connector, or, if you’ve updated information about a previous connector: (e.g. URL, Username, Password, Project Key), click the ‘Test Connection’ button. For a pre-existing connector, click the ‘Refresh Connection’ button. This will allow Applause to (re)test the connection and pull in any custom fields and custom values that may exist within your BTS implementation.
- To enable/disable a pre-existing connector: click on the ‘Enable’ or ‘Disable’ button.
- To edit a connector: click on the ‘Edit Credentials’ button for a newly added or pre-existing connector.
- Required vs Optional Fields: For a newly added connector if the connection has been tested, or for a pre-existing connector, Applause will populate the ‘JIRA Field Mapping’ section with all required/optional fields for JIRA. Required fields can NOT be removed. Option fields can be removed by clicking on the ‘x‘ icon to the right of that field.
What if my Bug Tracking System is behind a firewall?
If your BTS sits behind a firewall, please configure your firewall or security settings to permit the following IPs for the Applause platform to access your bug tracking system remotely:
- 21.127.192/28 (CIDR notation) OR 126.96.36.199 to 188.8.131.52 (range notation)
Getting Started: Creating a BTS Connector
To create a new BTS connector, first enter the Jira URL, Jira credentials, and Jira Project information. Then, click “Test Connection” to verify that Applause can reach your Jira server. Once a connection is successful, any mandatory Jira fields will be displayed for you to configure. Finally, click “Save” to persist the connector so it can be used to export issues.
Helpful Hint: For easier tracking, create a new user within your user system with Applause in the name. This will help you quickly locate bugs exported from Applause into JIRA. It is important to assign project visibility in JIRA to the account being used for the connection in order for bugs to appear.
- URL: Configure your web-based access to JIRA, less than 200 characters.
- User: Case sensitive. Requires the username to have create and save permissions within the JIRA system.
- Password: Case sensitive.
- Project Key: Case sensitive, and needs to exist within the JIRA system prior to seeing up a new connector. Assign where you would like Applause SDK-exported bugs to be located in the JIRA system. For example, if your Jira tickets appear as ABC-123, then ABC is your project key.
- Issue Type: Case sensitive, the default issue type for bugs sent from the Applause platform.
- Enable SNI: Enables SNI (Server Name Indication) for JIRA server. Use this option if your BTS server has TLS SNI enabled.
Add/Update JIRA Field Mappings
For a newly added connector if the connection has been tested, or for a pre-existing connector, Applause will populate the ‘JIRA Field Mapping’ section with all required/optional fields for JIRA.
Adding fields is very easy. Simply click on the ‘+ Add Field’ button, and select from a list of available fields.
Note: If you have recently added new fields to your JIRA implementation but do not see them listed as options, you may need to refresh the connector’s database by clicking the ‘Refresh Connector’ button.
Note: As a reminder, any fields that have an ‘x‘ icon to the right of them are optional and can be deleted. Fields with star in the name or lacking the icon are required and can not be removed.
To send a static value for a particular field, simply click on the drop down menu and select the static value you would like to post to that field.
Note that this value will be sent for ALL bugs sent from Applause.
Note: If you have recently added new value options to your JIRA implementation but do not see them listed as options for a particular field, you may need to refresh the connector’s database by clicking the ‘Refresh Connector’ button.
Updating an Existing BTS Connector
If your Jira project has changed, such as you’ve added new fields or new hires, you can “Refresh” your connection to get the new fields and/or options. Then, you can edit the appropriate field mappings. Finally, “Save” the connector to persist your changes.
Exporting your DX Issues
There are two ways to export issues to Jira:
- From the project results “Issues” tab, you can select one to many issues at a time (use checkboxes to select), click the Actions menu, and choose “Send selected to BTS”
You will get a confirmation screen:
Once you click OK, the status of those Issues will update to “Queued”, and then ultimately will update to reflect the Jira ticket ID in the bug tracking system (e.g., UDU-142 below). That ID will be a link to the actual Jira ticket.
- The other way to export an issue to Jira, is from the individual issue detail view. From the issues list, click on any Issue you want to view detail for. Then, from the Actions menu at top right, click “Send to BTS”. The “Export Status” will update to “Queued” and ultimately to the Jira ticket ID when it’s successfully exported. Note: You may have to refresh you page to see the status updated.