Synchronizing incidents with Jira Service Management tickets via BMC Helix Integration Service
You can configure BMC Helix Multi-Cloud Broker for consolidating your incidents from Jira Service Management (formerly, Jira Service Desk) to your BMC Helix ITSM application. After enabling the integration, you can broker incidents from Jira Service Management to BMC Helix ITSM and the converse is true. The trigger conditions that you define in BMC Helix Integration Service flows evaluate the criteria for creating BMC Helix ITSM incidents or Jira Service Management incidents.
Important
Jira Service Desk has been renamed to Jira Service Management. However, some instances in the product UI and documentation might refer to the old product name.
Before you begin
Complete all preconfiguration tasks before you configure Jira Service Management integration.
To select the integration option for Jira Service Management
- Log in to BMC Helix Innovation Suite.
- On Workspace, click Multi-Cloud Broker.
To launch BMC Helix Multi-Cloud Broker, click Visit Deployed Application.
Tip
You can access BMC Helix Multi-Cloud Broker directly by entering the URL https://hostName:portNumber/helix/index.html#/com.bmc.dsm.mcsm/login and logging in as a tenant administrator.
- To open the configuration page, click Settings .
- Select Start Here > Quick Configuration Guide.
In the Step 1: Choose configuration tab, perform the following steps:
From the Choose configuration list, select the Helix integration service.
b. Based on how you want to create an incident, select one of the following options and click Next:
To create an incident from Jira Service Management to BMC Helix ITSM, under Ticket Consolidation, select Jira Service Desk to Remedy Incident.
To create an incident from BMC Helix ITSM to Jira Service Management, under DevOps Integration, select ITSM Incident to Jira Service Desk Request.
The Perform configurations tab displays a list of the common configurations, connectors, flows, and connector targets, and processes that you need to configure as described in the next tasks.
To map Jira Service Management vendor data to BMC Helix ITSM
Configuring vendor data includes setting up a vendor organization and defining vendor mappings for the technology provider. Vendor mapping ensures that your vendor is notified about changes to the BMC Helix ITSM fields by sending updates as a comment to the corresponding vendor ticket.
If you have not already done so, to set up the vendor organizations, on the Perform configurations tab, click Manage Vendor Organizations. For instructions, see Performing common preconfiguration tasks.
- To add or update the vendor mapping, on the Perform configurations tab, click Manage Vendor Metadata.
On the Configure Vendor Metadata page, click to open the Map New Vendor page.
Enter a Description that makes it easy for you to identify the vendor metadata configuration.
Select the Ticketing Technology Provider.
The Ticketing Technology Provider is the application the vendor uses to manage tickets.Vendor Ticketing Technology Provider Amazon AWS JIRA Software JIRA Salesforce Service Cloud Service Cloud CA Agile Central Agile Central BMC Helix ITSM Vendor Remedy ITSM JIRA Software Service Desk JIRA Service Desk Microsoft Azure Devops Azure DevOps Azure Monitor Azure Alerts IBM QRadar QRadar BMC TSOM TrueSight Ops Mgmt for PSR Click Add Mapping.
BMC Helix Multi-Cloud Broker displays the default Instance URL, Vendor Field Mapping and Display Field Mapping.- Update the Instance URL with the ticketing technology provider server and port details.
To add or delete mapped field values, click Click { } to open the JSON editor, and modify Vendor Field Mapping and Display Field Mapping.
If required, update the existing Vendor Field Mapping.
Vendor field mapping defines how BMC Helix Multi-Cloud Broker maps BMC Helix ITSM fields to vendor ticket fields.
If required, update the existing Display Field Mapping.
Display field mapping defines how vendor ticket fields map to the fields on the Smart IT console.
- From the Integration Platform list, select Integration Service.
To configure connectors for integrating BMC Helix ITSM and Jira Service Management with BMC Helix Multi-Cloud Broker
For each feature you selected, complete the following procedure for the connectors listed on the Configuration Links page.
To navigate to BMC Helix Integration Service, on the Configuration Links page, click Configure connectors in Integration Studio under Required Common Configurations.
You must configure the connectors listed for each feature, in addition to the connectors listed under Required Common Configuration.To enter field values, select a connector, such as ITSM, and click Configuration.
You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.- To update the configuration defaults, enter the appropriate field values by referring to the list of connectors at the end of this procedure.
- To add or update the user account that is used to access the vendor application, click Accounts.
List of connectors for integration with Jira Service Management
To configure flow triggers and field mappings between BMC Helix ITSM, BMC Helix Multi-Cloud Broker, and Jira Service Management
For each feature you selected, complete this procedure for the flows listed on the Configuration Links page.
To navigate to BMC Helix Integration Service, on the Configuration Links page, click Configure flows in Integration Studio under Required Common Configurations.
You need to configure the flows listed for each feature, in addition to the flows listed under Required Common Configuration.
To open the flow template page, on the Catalog tab in Integration Studio, click the flow you want to configure.
- To create a copy of the flow template, click
- Select the appropriate accounts for the end-point connectors of the selected flow.
You specify the connector accounts when configuring connectors. - To update the name of the flow that you have copied from the flow template, select My Flow, open the flow that you copied, and update the title.
Specify the trigger Conditions and Field mapping, and click OK.
For more information about trigger conditions and field mappings, see the list of flows at the end of this procedure.- Click My Flows and select the flow that you created from the flow template.
- To verify the target values for the trigger conditions and the field mappings, in the right pane, click Details.
List of flows for integration with Jira Service Management
To update connector targets for Jira Service Management integration
BMC preconfigures the out-of-the-box connector targets for all BMC Helix Multi-Cloud Broker features. If you want to update the connector configuration or account information, update the connector target for the feature.
Warning
Do not delete the out-of-the-box connector targets.
- To navigate to BMC Helix Innovation Suite, in the Configuration Links page, click Configure Connector Targets in Innovation Studio under Required Common Configurations.
You need to configure the connector targets listed for each feature on the Configuration Links page, in addition to the ones listed under Required Common Configuration. - Click the connector target you want to configure or click to configure a new connector target.
Enter or update the following values and save the configuration.
Field Instructions Name Enter a unique name for the configuration.
The name is associated with the process that is related to the connector you are configuring.Connector Type Select the connector type from the list of connectors available to you in BMC Helix Integration Service.
Configuration Select a configuration from the list.
For example, if you select qradar as the Connector Type, all the configurations that you have made for qradar are displayed in the Configuration list.
Profile Select a profile. For example, if you select qradar as the Connector Type, all the profiles that you have created for qradar are displayed in the Configuration list.
List of connector targets for integration with Jira Service Management
When you complete the configuration for all the components, verify that incidents are being brokered from Jira Service Management to BMC Helix ITSM.
To enable mapping between BMC Helix ITSM fields and custom fields created in Jira Service Management
You can send and receive the value of custom fields created in Jira Service Management from a field in BMC Helix ITSM by updating the Jira Service Desk connector, flow and vendor data configuration.
Create a custom field in Jira Service Management.
Log in to Jira Service Management and add the custom fields that you need.
Ensure that the custom fields are available on all the screens and issue types that you want to integrate with.
Synchronize the Jira Service Desk connector.
Log in to BMC Helix Integration Studio.
Navigate to Catalog and click Connectors.
Select the Jira Service Desk connector and click Custom Fields in the Configuration pane.
You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.
Select the connector configuration that you want to update for custom fields and click Generate or Re-Generate.
Update the Sync JIRA Service Desk Issue flow to synchronize the new field.
Get the internal ID from Jira Service Management for your custom fields:
Run
echo -n username:password| base64
to generate base64 encoded string for subsequent requests.Run
wget --no-check-certificate --header='X-Requested-With: XMLHttpRequest' --header='Authorization: Basic [base64 encoded username:password]' --output-document applications.json 'https://[host]/api/v1.0/apps/search?lower_case_name=[connector name]'
This command creates
applications.json
file that contains response from the Integration Service. Copy value from id field from the json file and use it in the application Id field in the next command. Find from the list of appConfig your configuration by name and copy value from the Id field. Use the value that you have copied in the configuration Id field in the next command.Run
wget --no-check-certificate --header='X-Requested-With: XMLHttpRequest' --header='Authorization: Basic [base64 encoded username:password]' --output-document app_triggers.json 'https://[host]/api/v1.0/apps/[application Id]/configs/[configuration Id]/triggers'
This request creates
app_triggers.json
file with available triggers. Each trigger object contains a fields field that is an array of available fields. Copy value from systemName field. Use this value in step f.Run
wget --no-check-certificate --header='X-Requested-With: XMLHttpRequest' --header='Authorization: Basic [base64 encoded username:password]' --output-document app_actions.json 'https://[host]/api/v1.0/apps/[application Id]/configs/[configuration Id]/actions'
This request creates
app_actions.json
file with available actions. Each action object contains a fields field that is an array of available fields. Copy the value of systemName field. These fields can be used as Vendor field mapping properties.
Log in to BMC Helix Integration Studio.
Navigate to My Flows and select the Sync JIRA Service Desk Issue flow.
On the Details tab, click Field Mapping, locate Vendor Ticket Properties.
Click Add Property for each field that you want to use.
Enter the systemName field and select the field in which the value of the custom field needs to be populated.
To display the custom field, update Display Mapping in Vendor Data configuration.
Log in to BMC Helix Multi-Cloud Broker and click Settings
.Navigate to Configure Vendors > Map Vendors.
Select the Jira Service Management metadata that you want to update and click Edit.
Add the vendor specific values, if required, for the custom fields.
Vendor Field Mapping defines how BMC Helix Multi-Cloud Broker maps BMC Helix ITSM fields to vendor ticket fields.
Display Field Mapping defines how the vendor ticket fields map to the fields on the Smart IT console.
The configuration enables you to send data from the custom Jira Service Management field to the BMC Helix ITSM field mapped in Vendor Field Mapping.
To sync the values of mapped fields between Jira Service Management and BMC Helix ITSM
You can configure the prebuilt integration between Jira Service Management and BMC Helix ITSM to automatically update the values of fields mapped between Jira Service Management and BMC Helix ITSM in the applications, instead of adding them as a comment. If you update the value of a mapped field in one application, the value is automatically updated in the other application. For example, after brokering the incident, the initial value of the Status field in Jira Service Management and BMC Helix ITSM incidents is In Progress. Now, when you update the status of the Jira Service Management incident to Closed, the status of the BMC Helix ITSM incident is automatically updated to the same status.
To update the Jira Service Management field value when ITSM field value is changed
You must first map the BMC Helix ITSM and Jira Service Management fields that you want to keep in sync in the Jira Service Management Vendor Field Mapping. Then, configure the flows required to update the value of the Jira Service Management fields.
The following table lists the steps that you must perform to update a Jira Service Management field value when a BMC Helix ITSM field value is changed:
Product | Steps |
---|---|
BMC Helix Multi-Cloud Broker |
|
BMC Helix Integration Service |
Important: In the flows that you create, ensure that you map the fields that are defined in the Remedy to Vendor Sync Fields property in the vendor metadata. If you map additional fields in the flow that are not listed in the vendor metadata, the values of these fields are also updated in Jira Service Management. |
To update the BMC Helix ITSM field value when Jira Service Management field value is changed
You must first map the Jira Service Management and BMC Helix ITSM fields that you want to keep in sync in the Jira Service Management Vendor Field Mapping. Then, configure the flows required to update the value of the BMC Helix ITSM fields.
The following table lists the steps that you must perform to update a BMC Helix ITSM field value when a Jira Service Management field value is changed:
Product | Steps |
---|---|
BMC Helix Multi-Cloud Broker |
|
BMC Helix Integration Service |
Important: In the flows that you create, ensure that you map the fields that are defined in the Remedy to Vendor Sync Fields property in the vendor metadata. If you map additional fields in the flow that are not listed in the vendor metadata, the values of these fields are also updated in Jira Service Management. |
To store custom field values in BMC Helix ITSM or Jira Service Management
By enabling the custom field mapping with Jira Service Management, you can display the value of custom fields in Smart IT Ticket Details section. However, you can also store the custom field values in BMC Helix ITSM or Jira Service Management by modifying the required flow and connector process. To send the custom field values created in Jira Service Management to BMC Helix ITSM, perform the following task.
Create the custom field in Jira Service Management.
Log in to Jira Service Management and add the custom fields that you need.
Ensure that the custom fields are available on all the screens and issue types that you want to integrate with.
Create similar custom field in Incident record definition in Ticket Brokering Library
Login to BMC Helix Innovation Suite.
Go to Ticket Brokering Library > Incident.
Click + New Field to create a new field.
Create a custom field in BMC Helix ITSM to store the custom field value from Jira Service Management.
Synchronize the Jira Service Desk connector.
Log in to BMC Helix Integration Studio.
Navigate to Catalog and click Connectors.
Select the Jira Service Desk connector and click Custom Fields in the Configuration pane.
You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.
Select the connector configuration that you want to update for custom fields and click Generate or Re-Generate.
Repeat step 4 for Multi Cloud and Helix ITSM connector.
Update the Create Incident from Jira Service Desk flow to send the value of the new custom field to BMC Helix ITSM.
Login to BMC Helix Integration Studio.
To create a flow from Jira Service Management to BMC Helix ITSM, if you do not have an existing flow, create Create Incident from Jira Service Desk flow from the template.
If you have an existing flow, refresh the schema to populate the Jira Service Management custom field in the flow mapping.
Open the flow. Go to Details tab and click FIELD MAPPING to display the fields mapped to the flow.
Find the custom field created in Ticket Brokering Library and map it to Jira Service Management custom field.
Update the Connector Process ITSM to pass the value to BMC Helix ITSM.
Login to BMC Helix Innovation Suite.
Go to Ticket brokering library > Processes > Connector Process ITSM.
Select Create Incident block.
In Properties section, click Add/Remove parameters and select the custom field from BMC Helix ITSM you want to store the value into.
Map the custom field to the field from the Ticket Brokering Library.
Save the connector process.
Related topic
Configuring BMC Helix Multi-Cloud Broker
Comments
Log in or register to comment.