Reference of integration between BMC Helix ITSM and Jira Service Desk by using BMC Helix iPaaS


You can integrate BMC Helix ITSM with Jira Service Management (formerly known as Jira Service Desk) to synchronize BMC Helix ITSM incidents with Jira Service Management issues. The integration helps your agents to consolidate Jira Service Management issues into BMC Helix ITSM, and then broker the incidents to create Jira Service Management service requests.

BMC Helix Multi-Cloud Broker, along with BMC Helix iPaaS provides the Broker_incidents_between_BMC_Helix_ITSM_and_Jira_Service_Management.json integration template that you can use to integrate BMC Helix ITSM and Jira Service Management. You configure the integration in BMC Helix Multi-Cloud Broker and deploy the integration template to your BMC Helix iPaaS, powered by Jitterbit environment.

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.

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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*