Reference of integration between BMC Helix ITSM and Jira Service Desk by using BMC Helix iPaaS
List of project variables
The following sections describe the variables that you can update as per your requirements:
BMC Helix iPaaS variables:
Project variable
Action
BHIP_API_NAME
Enter the name for the API that is created in BMC Helix iPaaS to receive BMC Helix Multi-Cloud Broker webhook requests.
The default value of this variable is set to BMCHelixITSMAndJiraServiceIssue.
If required, you can change the name.
BHIP_API_User_Roles
Enter comma-separated values of the user roles assigned for the BMC Helix iPaaS API.
Only a user with these roles can access the APIs. Leave this value blank to restrict access only to administrators.BHIP_MCB_API_Profile_User_Name
Enter the user name that should be used while creating the BMC Helix Multi-Cloud Broker API profile.
The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.
BHIP_MCB_API_Profile_User_Password
Enter the password that should be used while creating the BMC Helix Multi-Cloud Broker API profile.
The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.
BHIP_Vendor_API_Profile_Type
The default value of this variable is APIKEY.
BHIP_Vendor_API_Profile_User_Name
Enter the user name for the security profile that you want to use with the Jira Service Management API.
Important: You need to provide a value for this variable, only if you select the BASIC option in BHIP_Vendor_API_Profile_Type.
BHIP_Vendor_API_Profile_User_Password
Enter the password for the security profile that you want to use with the Jira Service Management API.
Important: You need to provide a value for this variable, only if you select the BASIC option in BHIP_Vendor_API_Profile_Type.
BHIP_Vendor_API_Profile_ApiKey_Name
The default value of this variable is apiKey. If required, you can change the value.
BHIP_Host
Enter the BMC Helix iPaaS instance URL where you want to run this project.
Important: Make sure that you do not enter any leading and trailing spaces.
BHIP_User_Name
Enter the user name for the BMC Helix iPaaS instance.
BHIP_User_Password
Enter the password for the BMC Helix iPaaS instance.
Enable_BMC_Helix_To_Vendor_Integration
Enable the creation and updates of Jira Service Management issues from BMC Helix ITSM incidents.
By default, this variable is set to true. If you want to disable updates of Jira Service Management issues, set the default value to false.Enable_Vendor_To_BMC_Helix_Integration
Enable the creation and updates of BMC Helix ITSM incidents from Jira Service Management service requests.
By default, this variable is set to true. If you want to disable updates of BMC Helix ITSM incidents, set the default value to false.Jira Service Management project variables:
Project variable
Action
Jira_Host
Enter the host URL of the Jira instance in the following format:
[http/https]://[hostname]:[port]Important: Make sure that you do not enter any leading and trailing spaces.
Jira_JQL_Query
Enter the JQL query value that you want to use in the Jira webhook configurations. You can create the query in Jira Service Management and enter that query in this variable.
Jira_User_Name
Enter the user name for accessing Jira.
Jira_User_Password
Create an API token in Jira and use that token in this variable.
JSD_Request_Type
Enter the type of request that you want to use when creating a Jira Service Management request. Get the request type from Jira Service Management and enter that type in this variable; for example, enter Get IT help.
JSD_Service_Desk
Enter the name of the service desk project where you want to create the request.
BMC Helix Multi-Cloud Broker project variables:
Project variable
Action
MCB_Host
Enter the BMC Helix Multi-Cloud Broker host URL to which Jira Service Management requests should be synchronized.
Important: Make sure that you do not enter any leading and trailing spaces.
MCB_User_Name
Enter the user name that enables users to interact with BMC Helix Multi-Cloud Broker.
MCB_User_Password
Enter the password for the provided username.
MCB_Vendor_Name
This variable is autopopulated. You must not change the value.
MCB_Assigned_Group
Enter the name of the support group to which you want to assign the incident.
MCB_Assigned_Support_Organization
Enter the name of the support organization to which you want to assign the incident.
MCB_Assigned_Support_Company
Enter the name of the support company to which you want to assign the incident.
MCB_Assigned_Company
Enter the name of the company for which you want to create the incident.
MCB_Assigned_Company_Id
Enter the ID of the company for which you want to create the incident.
MCB_Assigned_Business_Unit
Enter the name of the business unit to which you want to assign the incident.
The following variables are inputs from BMC Helix ITSM. Either enter values for these variables or map appropriate Jira Service Management fields if the data is available:
Project variable
Action
ITSM_Company_Name
Enter the company name for which the integration template needs to be run; for example, Apex Global.
ITSM_Customer_First_name
Enter the first name of the BMC Helix ITSM customer.
ITSM_Customer_Last_Name
Enter the last name of the BMC Helix ITSM customer.
ITSM_Incident_Type
Enter any of the following incident types for which a corresponding Jira service request should be created:
- User Service Restoration
- User Service Request
- Infrastructure Restoration
- Infrastructure Event
- Security Incident
The default value of this variable is set to User Service Restoration.