There are three main required steps to configure the BTS Integration:
- Setting Up and establishing connection with your BTS
- Mapping the Applause fields to the BTS’s
- Testing the integration
Opening the Connector Creation Form
To begin configuring the BTS Integration and select your BTS, follow these steps:
- Log in to the Applause platform and select a product.
- Navigate to Configuration > Integrations from the left navigation menu.
- Here you can see all connectors set up for your company. The information displayed for each Connector includes the name, status, type and date/time of the last message processed (excluding connection testing).
- Click New Connector; the New Connector form will be displayed.
Setting Up and Establishing Connection with Your BTS
First, provide the Connector name and select the system you’re integrated with as the Connector Type.
Note that as you make your selection, the subsequent configuration options will be displayed.
After entering the connector name and type, you will need to establish connection with your BTS.
Establishing connection will ensure that the Applause platform can communicate correctly with your BTS. In addition, for BTS-specific integrations, the issue settings within your BTS will be returned to the platform.
Steps to Establish Connection with Your BTS
- Provide the connection details to your BTS - (URL, username, password or API token, project key) depending on the BTS requirements.
- For Jira Connector only:
- Check if SNI (Server Name Indication) is enabled.
- Once completed, click “Test & Establish Connection”. If all provided details are accurate and communication is enabled between the Applause platform to your BTS, you should get a message that the test was successful. If not, check your inputs and/or work with your IT and Applause Team to enable communication.
Mapping the Applause Fields to the BTS’s
In the next step, under the General Settings section, specify the products that will use this connector and whether to include attachments as files during the export.
Once the connection has been established in the first step, your BTS’s issue settings are returned to the Applause platform. You may now configure what fields you would like to send to your BTS to appear in the created issue.
Users are required to set the mapping of the Description field. Learn more about it in this course.
In addition to field mapping, in some cases, you may need to map between specific values, to add a dynamic set of values in your BTS.
- Learn more about working with specific BTS Connectors here.
Testing the Integration
Once the BTS Connector is set, it is recommended to test the integration prior to asking other users to use it. The timestamp of the latest message processed (last used date) displayed in the Connectors List will assist you with this task.
You can test the integration directly in the Field Mapping step by clicking the Test Export button which will create a test bug in the client’s BTS.
Refreshing the Connection
In the event that the issue settings on your BTS have changed, you will need to refresh the connection.
- Open the Edit view of an already existing connector and at the bottom of the first step click the Refresh the Connection link to do so.
- This will re-establish the connection and provide the Applause platform the latest issue settings from your BTS.
Managing the Connector
To edit or discard an existing connector, click the icons at the top of the Connector Details page.
Be sure to thoroughly validate your integration to make sure All Fields and Values are properly matched. Example: Applause may identify Severity level 1 as Low, whereas your company may use level 1 as Critical.
Be sure to thoroughly validate your integration to make sure All Fields and Values are properly matched. Example: Applause may identify Severity level 1 as Low, whereas your company may use level 1 as Critical.