BMC Helix Multi-Cloud Broker connector powered by Jitterbit

Use the BMC Helix iPaaS BMC Helix Multi-Cloud Broker connector to integrate BMC Helix ITSM with other third-party applications to broker ITSM records. A specific BMC Helix Multi-Cloud Broker connection and its activities are referred to as a BMC Helix Multi-Cloud Broker endpoint.  Use the connector to perform the following actions:

  • Configure the connection to create an authenticated BMC Helix Multi-Cloud Broker connection by entering credentials.
  • Configure associated BMC Helix Multi-Cloud Broker activities that interact with the connection to be used either as a source to provide data within an operation, or as a target to consume data within an operation.
  • Use the connector activities to perform the following actions: 
    • Create, retrieve, and update ITSM records
    • Retrieve attachments from the ITSM records

Supported API versions and prerequisites

The BMC Helix Multi-Cloud Broker connector requires the use of an agent version  10.1  or later. These agent versions automatically download the latest version of the connector when required.

To configure the BMC Helix Multi-Cloud Broker connection

  1. From the design canvas, open the Connectivity tab of the design component palette.
  2. Perform one of the following actions
    • To configure a new BMC Helix Multi-Cloud Broker connection, use the Show option to filter the connectors. Then, click the BMC Helix Multi-Cloud Broker connector block:
    • To configure an existing BMC Helix Multi-Cloud Broker connection, use the Show option to filter the endpoints. Then, click the BMC Helix Multi-Cloud Broker connector block:
  3. On the configuration screen, enter the following configuration values:

    Tip

    Fields with a variable icon  support using  global variables project variables , and Jitterbit variables . Begin either by typing an open square bracket [ into the field or by clicking the variable icon to display a list of the existing variables to choose from.

    Field NameAction
    Endpoint Name

    Enter a name to identify the BMC Helix Multi-Cloud Broker connection. The name must be unique for each BMC Helix Multi-Cloud Broker connection and must not contain forward slashes (`/`) or colons (`:`). This name is also used to identify the BMC Helix Multi-Cloud Broker endpoint, which refers to both a specific connection and its activities.

    HostEnter the BMC Helix Multi-Cloud Broker host URL.
    UsernameEnter the user name to log in to BMC Helix Multi-Cloud Broker.
    PasswordEnter the password for the username to log in to BMC Helix Multi-Cloud Broker.


     

    Important

    If you click Delete while creating a new connection, an error is displayed. For more information, see  Component Dependencies, Deletion, and Removal .

  4. Click Save Changes
    After configuring the BMC Helix Multi-Cloud Broker connection, configure one or more associated activities with that connection. For more information about creating an activity, see Creating a BMC Helix Multi-Cloud Broker Create activity.

To create a BMC Helix Multi-Cloud Broker activity

  1. From the design canvas, open the Connectivity tab of the design component palette:
  2. To display activities that are available to be used with BMC Helix Multi-Cloud Broker connection, use Show to filter on Endpoints, and then click the BMC Helix Multi-Cloud Broker connector block:


    The following activities are available. For more information about configuring these activities, see the specific activity sections.

    Activity nameDescription
    CreatePlaces an object into a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a target in an operation.
    GetFinds an object at a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a source in an operation.
    Get AttachmentsFinds an object at a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a source in an operation.
    UpdatePlaces an object into a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a target in an operation.
  3. To create an activity that can be configured, drag the activity block  from the palette to the operation.

For more information about the parts of an operation and adding activities to operations, see  Operation Creation and Configuration

To configure a BMC Helix Multi-Cloud Broker Create activity

A BMC Helix Multi-Cloud Broker Create activity places an object into a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a target to consume data in an operation. After configuring a BMC Helix Multi-Cloud Broker connection, you can configure as many BMC Helix Multi-Cloud Broker activities as you like for each BMC Helix Multi-Cloud Broker connection. The Create activity supports only the following BMC Helix ITSM objects:

  • Incident
  • Change
  • Problem
  • Work Order
  • Known Error
  • Vendor data
  • Worklog
  • Flow transaction
  • Service unavailability
  • Service notification

The Create activity also supports any custom fields for the supported list of objects.

To configure a BMC Helix Multi-Cloud Broker Create activity, complete the following steps:

  1. After you add the activity to an operation, double-click the activity block.
  2. On the configuration screen, enter a name and specify the following activity settings:

    Field NameAction
    Name

    Enter a name to use to identify the BMC Helix Multi-Cloud Broker Create activity. The name must be unique for each BMC Helix Multi-Cloud Broker Create activity and must not contain forward slashes (`/`) or colons (`:`).

    Select an Object for the resource

    This section displays the objects available in the BMC Helix Multi-Cloud Broker endpoint. When reopening an existing activity configuration, only the selected service code is displayed instead of reloading the entire service code list.

    Selected Object

    After an object is selected, it is listed here. Within the table, click anywhere on a row to select an object. Only one object can be selected. The information available for each object is fetched from the BMC Helix Multi-Cloud Broker endpoint:

    • Name: The object name from BMC Helix Multi-Cloud Broker.
    • Description: A short description of the selected object.

    Important: If the table does not populate with available objects, the BMC Helix Multi-Cloud Broker connection may not be successful. Ensure you are connected by reopening the connection and retesting the credentials

    Search

    Enter any part of the object name into the search box to filter the list of objects. The search is not case-sensitive. If the objects are already displayed within
    the table, the table results are filtered in real time with each keystroke. To reload the list of objects from the endpoint when searching, enter search criteria and then refresh, as described below.


  3. Click Next.
  4. Review the request and response data schemas displayed.
    The data schemas list the fields available for the BMC Helix Multi-Cloud Broker Create activity. If the operation uses a transformation, the data schemas are displayed again later during the transformation mapping process. In the transformation mapping process, map target fields by using source objects, scripts, variables, custom values, and more.
  5. Click Finished.
    After the activity is created, menu actions for that activity are accessible from the project pane in either the Workflows or the Components tab, and from the design canvas. For more information, see Activity Actions Menu .

To complete the configuration of the operation, add and configure other activities, transformations, or scripts as steps in an operation. You can also configure an operation's settings, which include the ability to chain operations together that are in the same or different workflows.

BMC Helix Multi-Cloud Broker Create activity operation patterns

BMC Helix Multi-Cloud Broker Create activities can be used as a target with these operation patterns:

  • Transformation Pattern
  • Two-Transformation Pattern  (as the first or second target)

Other patterns are not valid using BMC Helix Multi-Cloud Broker Create activities. See the validation patterns on the  Operation Validity  page.

A typical use case is to use a BMC Helix Multi-Cloud Broker Create activity in the Two-Transformation Pattern. In this example, the first transformation (BMC Helix Multi-Cloud Broker Create Request) creates a request structure that is passed to the BMC Helix Multi-Cloud Broker Create activity. The second transformation (BMC Helix Multi-Cloud Broker Create Response) receives the response structure, which is then written to a variable by a Variable Write activity (Write BMC Helix Multi-Cloud Broker  Create Response) and a message is then logged by the Write to Operation Log script:

Tip

To use the activity with scripting functions, write the data to a temporary location and then use that temporary location in the scripting function.

When ready, deploy and run the operation and validate behavior by checking the Operation logs .

To configure a BMC Helix Multi-Cloud Broker Update activity

A BMC Helix Multi-Cloud Broker Update activity places an object into a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a target to consume data in an operation. After configuring a BMC Helix Multi-Cloud Broker connection, you can configure as many BMC Helix Multi-Cloud Broker activities as you like for each BMC Helix Multi-Cloud Broker connection.

The Update activity supports the following objects:

  • Incident
  • Change
  • Problem
  • Work Order
  • Known Error
  • Vendor data

The Update activity also supports any custom fields for the supported list of objects.

To configure a BMC Helix Multi-Cloud Broker Update activity, complete the following steps:

  1. After you add the activity to an operation, double-click the activity block.
  2. On the configuration screen, enter a name and specifcy the following activity settings:

    Field NameAction
    Name

    Enter a name to use to identify the BMC Helix Multi-Cloud Broker Get activity. The name must be unique for each BMC Helix Multi-Cloud Broker Get activity and must not contain forward slashes (`/`) or colons (`:`).

    Ticket GUIDEnter the record instance ID for which you want to get the details.
    Select an Object for the resourceThis section displays the objects available in the BMC Helix Multi-Cloud Broker endpoint. When reopening an existing activity configuration, only the selected service code is displayed instead of reloading the entire service code list.
    Selected Object

    After an object is selected, it is listed here. Within the table, click anywhere on a row to select an object. Only one object can be selected. The information available for each object is fetched from the BMC Helix Multi-Cloud Broker endpoint:

    • Name: The object name from BMC Helix Multi-Cloud Broker.
    • Description: A short description of the selected object.

    Important: If the table does not populate with available objects, the BMC Helix Multi-Cloud Broker connection may not be successful. Ensure you are connected by reopening the connection and retesting the credentials

  3. Click Next
  4. Review the request and response schema. 
    The data schemas list the fields available for the BMC Helix Multi-Cloud Broker Update activity. If the operation uses a transformation, the data schemas are displayed again later during the transformation mapping process. In the transformation mapping process, map target fields by using source objects, scripts, variables, custom values, and more. 
  5. Click Finished.
    After the activity is created, menu actions for that activity are accessible from the project pane in either the Workflows or the Components tab, and from the design canvas. For more information, see Activity Actions Menu .

To complete the configuration of the operation, add and configure other activities, transformations, or scripts as operation steps. You can also configure an operation's settings, which include the ability to chain operations together that are in the same or different workflows.

BMC Helix Multi-Cloud Broker Update activity operation patterns

BMC Helix Multi-Cloud Broker Update activity can be used as a target with these operation patterns:

  • Transformation Pattern
  • Two-Transformation Pattern  (as the first or second target)

Other patterns are not valid using BMC Helix Multi-Cloud Broker Update activities. See the validation patterns on the  Operation Validity  page. 

A typical use case is to use a BMC Helix Multi-Cloud Broker Update activity in the Two-Transformation Pattern. In this example, the first transformation (BMC Helix Multi-Cloud Broker Update Request) creates a request structure that is passed to the BMC Helix Multi-Cloud Broker Update activity. The second transformation (BMC Helix Multi-Cloud Broker Update Response) receives the response structure, which is then written to a variable by a Variable Write activity (Write BMC Helix Multi-Cloud Broker  Update Response) and a message is then logged by the Write to Operation Log script:

To use the activity with scripting functions, write the data to a temporary location and then use that temporary location in the scripting function.

When ready, deploy and run the operation and validate behavior by checking the  Operation Logs .

To configure the BMC Helix Multi-Cloud Broker Get activity

A BMC Helix Multi-Cloud Broker Get activity finds an object at a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a source to provide data to an operation. After configuring a BMC Helix Multi-Cloud Broker connection, you can configure as many BMC Helix Multi-Cloud Broker activities as you like for each BMC Helix Multi-Cloud Broker connection.

The Get activity supports any object from the Ticket Brokering library in BMC Helix Multi-Cloud Broker.

To configure the BMC Helix Multi-Cloud Broker Get activity, complete the following steps:

  1. After you add the activity to an operation, double-click the activity block.
  2. On the configuration screen, enter a name and specifcy the following activity settings:

    Field NameAction
    Name

    Enter a name to use to identify the BMC Helix Multi-Cloud Broker Get activity. The name must be unique for each BMC Helix Multi-Cloud Broker Get activity and must not contain forward slashes (`/`) or colons (`:`).

    Ticket GUIDEnter the record instance ID for which you want to get the details.
    Select an Object for the resourceThis section displays the objects available in the BMC Helix Multi-Cloud Broker endpoint. When reopening an existing activity configuration, only the selected service code is displayed instead of reloading the entire service code list.
    Selected Object

    After an object is selected, it is listed here. Within the table, click anywhere on a row to select an object. Only one object can be selected. The information available for each object is fetched from the BMC Helix Multi-Cloud Broker endpoint:

    • Name: The object name from BMC Helix Multi-Cloud Broker.
    • Description: A short description of the selected object.

    Important: If the table does not populate with available objects, the BMC Helix Multi-Cloud Broker connection may not be successful. Ensure you are connected by reopening the connection and retesting the credentials

  3. Click Next.
  4. Review the request and response schema.
  5. The data schemas list the fields available for the BMC Helix Multi-Cloud Broker Get activity. If the operation uses a transformation, the data schemas are displayed again later during the transformation mapping process. In the transformation mapping process, map target fields by using source objects, scripts, variables, custom values, and more.
  6. Click Finished.
    After the activity is created, menu actions for that activity are accessible from the project pane in either the Workflows or the Components tab, and from the design canvas. For more information, see Activity Actions Menu .

To complete the configuration of the operation, add and configure other activities, transformations, or scripts as operation steps. You can also configure an operation's settings, which include the ability to chain operations together that are in the same or different workflows.

BMC Helix Multi-Cloud Broker Get activity operation patterns

BMC Helix Multi-Cloud Broker Get activity can be used as a source with these operation patterns:

  • Transformation Pattern
  • Two-Target Archive Pattern (as the first source only)
  • Two-Transformation Pattern (as the first or second source)

Other patterns are not valid using BMC Helix Multi-Cloud Broker Get activities. For more information about the validation patterns, see the  Operation Validity
page.

A typical use case is to use a BMC Helix Multi-Cloud Broker Get activity in the Two-Transformation Pattern. In this example, the first transformation (BMC Helix Multi-Cloud Broker Get Request) creates a request structure that is passed to the BMC Helix Multi-Cloud Broker Get activity. The second transformation (BMC Helix Multi-Cloud Broker Get Response) receives the response structure, which is then written to a variable by a Variable Write activity (Write BMC Helix Multi-Cloud Broker Get  Response) and a message is then logged by the Write to Operation Log script:

Tip

To use the activity with scripting functions, write the data to a temporary location and then use that temporary location in the scripting function. 

When ready, deploy and run the operation and validate behavior by checking the Operation Logs .

To configure the BMC Helix Multi-Cloud Broker Get Attachments activity

A BMC Helix Multi-Cloud Broker Get Attachments activity finds an attachment at a BMC Helix Multi-Cloud Broker endpoint and is intended to be used as a source to provide data to an operation. BMC Helix Multi-Cloud Broker extracts all the related attachments to the attachment group, by the attachment group ID. After configuring a BMC Helix Multi-Cloud Broker connection, you can configure as many BMC Helix Multi-Cloud Broker activities as you like for each BMC Helix Multi-Cloud Broker connection.

To configure a BMC Helix Multi-Cloud Broker Get Attachments activity, complete the following steps:

  1. After you add the activity to an operation, double-click the activity block.
  2. On the configuration screen, enter a name and specifcy the following activity settings:

    Field NameAction
    Name

    Enter a name to identify the BMC Helix Multi-Cloud Broker Get Attachments activity. The name must be unique for each BMC Helix Multi-Cloud Broker Get Attachments activity and must not contain forward slashes (`/`) or colons (`:`).

    Attachment Group ID When a work note with an attachment is created in a ticket, an entry in the worklog record definition in BMC Helix Multi-Cloud Broker is also created. The entry in the worklog record contains an ID for the attachments.


  3. Click Next.
  4. Review the request and response schema.
    The data schemas list the fields available for the BMC Helix Multi-Cloud Broker Get Attachments activity. If the operation uses a transformation, the data schemas are displayed again later during the transformation mapping process. In the transformation mapping process, map target fields by using source objects, scripts, variables, custom values, and more.
  5. Click Finished.
    After the activity is created, menu actions for that activity are accessible from the project pane in either the Workflows or the Components tab, and from the design canvas. For more information, see Activity Actions Menu .

To complete the configuration of the operation, add and configure other activities, transformations, or scripts as operation steps. You can also configure an operation's settings, which include the ability to chain operations together that are in the same or different workflows.

BMC Helix Multi-Cloud Broker Get Attachments activity operation patterns

BMC Helix Multi-Cloud Broker Get Attachments activity can be used as a source with these operation patterns:

  • Transformation Pattern
  • Two-Target Archive Pattern (as the first source only)
  • Two-Transformation Pattern (as the first or second source)

Other patterns are not valid using BMC Helix Multi-Cloud Broker Get Attachments activities. See the validation patterns on the Operation Validity  page.

A typical use case is to use a BMC Helix Multi-Cloud Broker Get Attachments activity in the Two-Transformation Pattern. In this example, the first transformation (BMC Helix Multi-Cloud Broker  Get Attachments Request) creates a request structure that is passed to the BMC Helix Multi-Cloud Broker Get Attachments activity. The second transformation (BMC Helix Multi-Cloud Broker Get Attachments Response) receives the response structure, which is then written to a variable by a Variable Write activity (Write BMC Helix Multi-Cloud Broker Get Attachments Response) and a message is then logged by the Write to Operation Log script:

Tip

To use the activity with scripting functions, write the data to a temporary location and then use that temporary location in the scripting function.

When ready, deploy and run the operation and validate behavior by checking the operation logs .

Was this page helpful? Yes No Submitting... Thank you

Comments