This documentation supports the 21.3 and consecutive patch versions of BMC Helix Multi-Cloud Broker.To view an earlier version, select the version from the Product version menu.

Reference of integration between BMC Helix ITSM work orders and Jira issues by using BMC Helix Integration Service


To establish the integration with Jira for work order requests,  you must configure the connectors, flows, and connector targets. This section provides the required information that you need to establish the integration between BMC Helix ITSM and Jira.

List of connectors for integration with Jira

You need to configure the following connectors when setting up integration with Jira. These connectors are integration points for the respective applications. For instance, to send the data from BMC Helix Multi-Cloud Broker to Jira, you need to create a flow from Multi-Cloud connector to Jira connector.


ITSM connector
  • Configuration
    If you are integrating BMC Helix Multi-Cloud Broker with an on-premises instance of ITSM, enter the following values:

    Field

    Value

    Site

    Select the site that you created for Remedy.

    AR server

    Enter the name of your on-premises AR System server.

    AR server port

    Enter the port number for your on-premises AR System server.

  • Account
    Add a ITSM user account that has permissions to view business service requests and permissions to update incidents, change, or problem requests.


Multi-Cloud connector
  • Configuration
    While activating BMC Helix Multi-Cloud Broker, BMC configures the Multi-Cloud connector. Do not modify the default Multi-Cloud connector configuration.
  • Account
    BMC sets up the account for the Multi-Cloud connector.
    Click reauthenticate.PNGto re-authenticate after you have changed the password for your tenant administrator user account in BMC Helix Innovation Studio.
    For information about changing the user password, see Creating or modifying People data.


SMTP Email connector
  • Configuration
    To send email notifications for errors, specify values for the following fields:

    Field

    Value

    Name

    Enter a name for the connector configuration.

    Site

    Select the appropriate site for your email server.

    Connection type

    Select the type of connection for your email server.

  • Account
    Add an email account to be used for sending error notifications.


Jira connector

Excerpt named Jira was not found in document xwiki:Service-Management.IT-Service-Management.BMC-Helix-Multi-Cloud-Broker.mcbroker213.Common-connector-content.WebHome.

List of flows for integration with Jira

You can configure the following flows when setting up integration with Jira. Each flow is self descriptive, for example to create a work order in BMC Helix ITSM from Jira, you must configure Create DevOps Work Order flow.

Send Error Notification flow
  • Trigger

    Field

    Value

    Flow Target

    Multi-Cloud

  • Field Mapping

    Field

    Value

    To

    Enter the email account that will receive the error notification.

    Subject

    Flow Title

    From
    Note:
    The value of this field is set to Integration Service.

    NA

    Note

    You can change the following out-of-the-box field mappings:

    • Subject
    • From

    However, BMC recommends that you retain the existing mappings.

Create DevOps Work Order flow

Excerpt named devOpsWOJira was not found in document xwiki:Service-Management.IT-Service-Management.BMC-Helix-Multi-Cloud-Broker.mcbroker213.Common-flows-content.WebHome.

Create Work Order Activity Note flow

  • Trigger
    Field
    Value
    Broker Vendor Name
    is not empty
    Is New Workorder Work Log
    is true
  • Field Mapping
    Do not change the following out-of-the-box field mappings.
    Field
    Value
    post_type
    comment#vendor
    ticketNumber
    Work Order ID
    ticket_type
    workorder
    vendorTicketId
    Broker Vendor Ticket Id
    Attachment Object 1.name
    Attachment 1 filename
    Attachment Object 1.content
    Attachment 1
    Attachment Object 2.name
    Attachment 2 filename
    Attachment Object 2.content
    Attachment 2
    Attachment Object 3.name
    Attachment 3 filename
    Attachment Object 3.content
    Attachment 3
    NoteYou can change the out-of-the-box field mapping for the text field. Default value is set to Notes.However, BMC recommends that you retain the existing mapping.

Create Work Order Activity Note with Author flow (Remedy 9.1.07 or later)
  • Trigger

    Field

    Value

    Broker Vendor Name

    is not empty

    Is New Workorder Work Log_People

    is true

  • Field Mapping
    Do not change the following out-of-the-box field mappings.

    Field

    Value

    post_type

    comment#vendor

    ticket_type

    workorder

    ticketNumber

    Work Order ID

    vendorTicketId

    Broker Vendor Ticket ID

    Author

    Full name

    Attachment Object 1.name

    Attachment 1 filename

    Attachment Object 1.content

    Attachment 1

    Attachment Object 2.name

    Attachment 2 filename

    Attachment Object 2.content

    Attachment 2

    Attachment Object 3.name

    Attachment 3 filename

    Attachment Object 3.content

    Attachment 3

    Note

    You can change the out-of-the-box field mapping for the text field. Default value is set to Notes.

    However, BMC recommends that you retain the existing mapping.

Sync Jira Issue flow
  • Trigger
    Retain the values that are available out-of-the-box.
  • Field mapping
    Do not change the following out-of-the-box field mappings.

    Field

    Value

    Vendor

    Jira

    Vendor Ticket Id

    Issue Key

    Vendor Ticket Properties

    Retain the out-of-the-box properties mapping.

Sync Jira Issue Comment flow
  • Trigger

    Retain the values that are available out-of-the-box.

  • Field mapping

    Do not change the following out-of-the-box field mappings.

    Field

    Value

    text

    Retain the prefix Comment Body

    post_type

    comment#remedy

    Vendor

    JIRA

    Vendor Ticket Id

    Issue Key

    commentId

    Comment ID

    Attachment Object 1

    Attachment Object 1

    Attachment Object 2

    Attachment Object 2

    Attachment Object 3

    Attachment Object 3

List of connector targets for integration with Jira

To sync data, such as a brokered ticket from Jira to BMC Helix ITSM, after the data has come in to BMC Helix Multi-Cloud Broker, you must configure the BMC Helix Multi-Cloud Broker ITSM connector target and set it in the Connector Process ITSM. To send data from BMC Helix ITSM to Jira, after the data has come into BMC Helix Multi-Cloud Broker, you must configure the MCSM JIRA connector target and set it in the Connector Process JIRA.


MCSM ITSM connector target

For the MCSM ITSM connector target, define the connection configuration and profile required by the connector process.


MCSM JIRA connector target

For the Connector Targets, define the connection configuration and profile required by the connector process in BMC Helix Innovation Suite.

 

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