This documentation supports the 20.08 version of BMC Helix Platform. 
To view an earlier version, select 20.02 from the Product version menu.

Integrating applications by using process connector elements

From Process designer in BMC Helix Innovation Studio, use the Connector element to integrate your application with a third-party service or application. Connector element invokes the actions defined for a connector.

An action can be creating or updating an event or a task in your target application or using a query expression to fetch data from your target application. You add one or more actions to a process, but each action is defined by a single Connector element.

For information about the connector development process and out-of-the box connectors, see Connectors overview.

To add connector in a process

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Select the application in which your process exists.
  3. In the application, click Processes.
  4. Click the process name where you want to add connectors.
    The system opens the Process designer and displays the process diagram on the canvas.
  5. As per your requirements, add the input and output variables required for the process. 

    For information about adding input and output process variables, see Adding variables to processes.
  6. Drag the Connector element to the canvas and place it where you want to add it in the process and provide the input and output connections.
    Select the Connector element and enter the values for the following properties:

    LabelEnter the label for the Connector element.
    DescriptionDescribe the details about the connector, such as the applications which will be integrated by using this connector, other properties, and so on.
    Connection NameEnter the same name as entered for the Connection tab for this connection.
    ConnectionSelect the name from the list. The list includes all the connectors that are configured in Connector Configurations from the Administration tab.
    Use as aliasEnable the option if you want to use the connector element as an alias. For more information about processes related to aliases, see Adding connector configurations and Mapping an alias to connector configuration

    Select the action that you want to perform for the Connector element.

    • Action—To create or update an event or a task in your target application, select the action .
    • Query—To fetch data from your target application, use a query expression .
    RetrieveSelect one of the following options to specify the number of records that should be returned if the query condition is met.
    • (Default) First Matching Record—Returns only the first matching record after the query condition is met.
    • All Matching Records—Returns all the matching records after the query condition is met.
    NameSelect the process output from the list and map it with the action output. The process output is already created as a part of process.
    SourceEnter the value based on the Action you choose in the INPUT MAP. The value in this field varies depending upon the Action you select.
    Loop TypeSelect Parallel or Sequential from the list. For information about Multi instance loop, see Creating process steps or activities.
  7. Enter the values for the parameters as described in the table above.
    You can add the optional parameters by using the Add/Remove Parameters property.
  8. Save the process.

Example: Process to create record instance for a JIRA issue by using JIRA connector

The following process integrates an application with JIRA services. The process adds a comment to a JIRA issue, creates a new record instance, and adds the comment to the Description field of the record instance. The process consists of a Connector element, a Create Record element, and a process input variable inputComment.

When you run the process, the process performs the following tasks:

  1. The process variable inputComment (input parameter of the process) provides input to the JIRA Connector.
  2. JIRA Connector adds the comment to the JIRA issue by using the parameter Issue Key
    The inputComment details are added as a comment in the JIRA issue.
  3. JIRA Connector passes the inputComment details to the Create Record element.
  4. Create Record element creates a new record instance of the selected record definition and populates the Description field with the inputComment details.

General properties sample values

The following table illustrates sample values for the General properties in the process example:

PropertySample value
NameDemo Rule
DescriptionRule to create a JIRA issue
Run asAdministrator
Add/Remove Record DefinitionsDemo Record (primary record definition)
EditDemo Set

JIRA connector sample values

PropertySample value
LabelJIRA Connector
DescriptionProcess to create JIRA issue
Connection NameJIRA Configuration
ConnectionJIRA Configuration

Create Change

NameFrom the list
SourceAction specific
Loop TypeParallel

Create Record sample values

PropertySample value
Action Type NameCreate Record
LabelCreate Record
DescriptionRecord specific
Run asCurrent user
Record Definition NameTask
NameFrom the list
SourceAction specific
Loop TypeParallel

Related topics

Integrating applications by using rule connector elements

Troubleshooting integration service connection issues

Process designer elements

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