BMC Helix Integration Service


BMC Helix Integration Service

With BMC Helix Integration Service, you can easily design and automate event-driven tasks across applications.

Release notes and notices Updated 09 Dec 2024

Learn what’s new or changed for BMC Helix Integration Service version 20.08, including new features, urgent issues, documentation updates, and fixes or patches.

Tip

To stay informed of changes to this space, place a watch on this page.

If you are using or developing on-premises connectors, we recommend updating your production and development sites every time new features are released.

The following updates have been added since the release of the space:

Date

Title

Summary

February 7, 2024

This update to BMC Helix Integration Service includes enhancements including additional audit details about changes to the flow status and advanced polling mechanism for Jira and BMC Helix ITSM connectors.

January 2, 2024

Notice for deprecation of support for PSR connectors in BMC Helix Integration Service and affected integrations.

March 6, 2023

20.08 Patch 15

There was no patch with version number 20.08.14.

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including updates to the AR System, ITSM, and Jira connectors to include a configuration of items to be polled and update to the default memory allocation for the ActiveMQ container.

June 13, 2022

20.08 Patch 13

There are no patches with version numbers 20.08.10, 20.08.11, and 20.08.12.

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including connector updates for supporting the L3 use case for Proactive Service Resolution, support to update date/time fields, and the ability to automatically create service requests for BMC Helix Business Workflows cases. 

September 16, 2021

This update to BMC Helix Integration Service includes various defect fixes.

20.08 Patch 9

There are no patches with version numbers 20.08.06, 20.08.07, and 20.08.08.

August 23, 2021

This update to BMC Helix Integration Service includes various defect fixes and enhancements to the throttling and filter options for connector configuration.

July 28, 2021

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including updated data string transformation for the Date/Time format and support for Regex for advanced string transformations.

June 23, 2021

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including addition of new fields and field types for field mapping when creating flows.

May 19, 2021

This update to BMC Helix Integration Service includes various defect fixes.

May 5, 2021

Statement of direction issued for go-forward scope for BMC Helix Integration Service.

March 17, 2021

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including:

  • Product name changes in Remedy platform, Remedy ITSM, and BMC Helix Platform applications.
  • BMC Helix Innovation Suite for all service management applications.
  • Usability enhancements to BMC Helix Connector Designer.
  • Addition of Prefix IDs to error messages.
  • Ability to export and import flows in non-production environments.

September 23, 2020

This update to BMC Helix Integration Service includes various defect fixes and enhancements, including:

  • Improved usability in BMC Helix Connector Designer to easily develop custom connectors.
  • Audit reports for changes made to flows and connector configuration.

The macro display-footnotes from Confluence is no longer available.

Tip

Ready-made PDFs are available on the PDFs page. You can also create a custom PDF.

Click here to see the steps.

The BMC Documentation portal gives you the ability to generate PDF exports of multiple pages in a space.  

Creating PDF exports

You can create a PDF of a page or a set of pages. (Non-English page exports are not supported.) You can also create a Word document of the current page.

To export to PDF

  1. Click the Export icon in the upper-right. 1744830844926-963.png
  2. From the Export menu, select PDF.
  3. Follow the prompts for page selection and other options.
  4. Click Export.

 

Configuring connectors

Configure connectors and set permissions, so that connectors can connect to third-party applications and services

Developing connectors

Develop custom connectors for third-party products and services

Designing and maintaining flows

Start integrating connectors in a user-friendly interface

Installing and configuring sites to run on-premises connectors

Manage sites for your on-premises connectors

Setting up Proactive Service Resolution to enable automatic incident management

Setting up Proactive Service Resolution to enable automatic incident management

Administering

As an administrator, manage users, set up sites for on-premises connectors, address data privacy requests, and set up variables to support proxy servers in BMC Helix Integration Service.

Troubleshooting

Common issues, error messages, logs, and contacting Support.

Monitoring application usage for business effectiveness by using the Dashboard

Review reports to access application usage to make informed business decisions.
CommunitiesCommunitiesGet in touch with peers and experts.Join the Integration Service group on BMC Communities.
Knowledge BaseKnowledge BaseView knowledge articles related to BMC Helix Integration Service
VideosVideosView the BMC Helix Integration Service YouTube playlist
PDFs and videos

This topic describes and links to PDFs and videos that support this product release. If the ready-made PDFs of this space do not satisfy your requirements, you can export a custom PDF.

Tip

You can create a custom PDF for a specific topic, a topic and its children, or a group of topics with a specific label. For information about how you can export a custom PDF from this space, see Exporting-to-PDF-and-other-formats.

 

 

You must log in or register to view this page

Videos

Videos are available in the following areas:

Getting started videos

The following topics in the Getting-started section contain videos that supplement or replace the text-based documentation:


FAQs


Here are some answers to the most frequently asked questions about the  BMC Helix Integration Service product.


Why do I use BMC Helix Integration Service?

BMC Helix Integration Service is a cloud-based solution that enables you to design and automate event-driven tasks across applications. You can connect multiple applications in a single flow, and configure the flow to accomplish a task or a set of tasks required for achieving your business goal.

You can integrate applications running in the cloud, on-premises, or a combination of both. If a particular connector does not exist, or an existing connector does not meet your specific business requirements, you can build it from scratch or customize it to fit your needs.

The BMC Helix Integration Service product set includes the following components:

  • BMC Helix Integration Studio to configure connectors and design flows
  • BMC Helix Connector Designer to develop, build, and deploy custom connectors
  • Integration Controller to connect with the applications or services that run on-premises

For more information about BMC Helix Integration Service, see Getting-started.

What do I need to install to use BMC Helix Integration Service?

BMC Helix Integration Studio is a cloud application and does not require to be installed. After you receive your access credentials, you can start using BMC Helix Integration Studio to configure out-of-the-box connectors and design flows with these connectors. However, if you want to develop custom connectors, you must set up the connector development environment by installing Docker, BMC Helix Connector Designer, and Integration Controller. For more information, see Installing-and-setting-up-the-connector-development-environment.

What type of flows can I design in BMC Helix Integration Studio?

In BMC Helix Integration Studio, you can design multiple flows for automatically performing various business tasks by using the required combinations of triggers and actions of the available connectors.

You can design personal, tenant-level, and catalog flows. Additionally, you can design flows with multiple actions. For more information, see Designing-and-maintaining-flows.

Who can view and use the flows that I design?

The visibility of the flows depends on the flow type:

  • If you design a personal flow, only you can view and use the flow.
  • If you convert your personal flow to a tenant-level flow, all administrators in your tenant can view, use, and manage the flow.
  • If you publish your personal flow to the catalog, a copy of your personal flow is created, and all users in your tenant can use the catalog flow as a template for designing their personal flows. Your original personal flow remains visible only to you.

For more information, see Adding-or-copying-flows and Publishing-or-using-flows.

How often do the flows run?

The frequency of flow runs depends on the connector configuration. While configuring a connector, you can specify how often you want the connector triggers to be checked. For example, if you configure the setting to check a trigger every 30 minutes, a flow that contains this trigger will be triggered every 30 minutes (if the triggering conditions are met). For more information, see Adding-throttling-controls.

Additionally, you can initiate a flow on demand for testing purposes. For more information, see Activating-or-enabling-flows.

If I face any issues with a flow, how can I know what exactly is wrong?

To resolve the issues related to flows, you can use the flow debugger and review the common troubleshooting scenarios. For more information, see Troubleshooting-flow-issues.

What logs can I access in BMC Helix Integration Service?

For troubleshooting purposes, you can view connector logs and Integration controller logs. For more information, see Troubleshooting-BMC-Helix-Connector-Designer-issues and Troubleshooting-Integration-Controller-issues.

Frequently asked questions about connector development and configuration

This section provides answers to the frequently asked questions (FAQs) about connector development and configuration in BMC Helix Integration Service.


What connectors are available in BMC Helix Integration Studio?

BMC Helix Integration Studio includes the default connectors, such as JIRA, GitHub, or Gmail, which you can use out of the box. To view the full list of these connectors, see Out-of-the-box-connectors. Additionally, you can develop custom connectors. For more information, see Developing-connectors.

Can I develop my own connectors and use them in BMC Helix Integration Studio?

Yes, you can develop custom connectors by using BMC Helix Connector Designer or by coding them manually. After developing custom connectors, you can deploy them to BMC Helix Integration Studio and use them to design flows. For more information, see Developing-connectors and Best-practices-for-connector-development.

What programming language should I use to develop custom connectors?

BMC Helix Connector Designer currently supports Java and JavaScript. You must use one of these programming languages to develop custom connectors. You can also use any helper node modules or JAR files.

Is it possible to connect my on-premises applications to the cloud applications?

Yes, you can connect on-premises applications to the cloud by using Integration Controller.

Integration Controller safely and securely communicates with the BMC Helix Integration Service cloud by establishing an outbound connection on port 61600. The connection from Integration Controller to the BMC Helix Integration Service cloud is encrypted via Transport Layer Security (TLS). You do not need to open any inbound ports in your corporate firewall.

For more information, see Installing-and-configuring-sites-to-run-on-premises-connectors.

How do I verify my connector development environment?

You must review the system requirements for all required components. For more information, see Installing-and-setting-up-the-connector-development-environment.

After you set up the environment, use the validation utility to run health checks and ensure that the environment is set up correctly. For more information, see Validating-the-connector-development-environment.

Can I test my custom connectors before deploying them to production?

Yes, you can test newly built or existing custom connectors to check the generated code for errors. Run the BMC command-line utility before deploying the connectors to production instances. For more information, see Testing-connectors-and-validating-them-on-the-development-site.

I have developed a custom connector. How do I configure it?

Although you develop, build, and deploy custom connectors in BMC Helix Connector Designer, you must configure the connectors in BMC Helix Integration Studio. For more information, see Configuring-connectors.

Why do I see different configuration parameters for different connectors?

This is the expected behavior since the connection details might differ for different third-party or BMC application to which you are connecting. If a connector does not need additional connection details to connect to a third-party system, no additional connection details are requested in BMC Helix Integration Studio. For example, some connectors do not require authentication to connect to a third-party system; therefore, you do not need to create a connector account.

Configuration settings that are not required for a particular connector are not displayed for the connector in the BMC Helix Integration Studio UI.

Frequently asked questions about using BMC Helix Integration Service with other BMC products


How is BMC Helix Integration Service related to BMC Helix Platform?

As a customer or a partner, if you use BMC Helix Innovation Studio or a supported product, and you sign up for the developer program, an integration account is created for you. With this account, you can use the BMC Helix Integration Service tools.

In BMC Helix Innovation Studio, you can use the connectors available in BMC Helix Integration Studio to create processes and rules to enable integrations between applications without coding.

How do I use BMC Helix Integration Service to set up Proactive Service Resolution (PSR)?

You can use the out-of-the box TrueSight Ops Mgmt for PSR and ITSM for PSR connectors. Additionally, you can use the PSR catalog flows that are available in your BMC Helix Integration Studio instance by default.

For more information about PSR, see Proactive-Service-Resolution-for-automatic-incident-management-with-BMC-Helix-Integration-Service and Use-case-Automatic-incident-management.

For more information about setting up PSR, see Setting-up-Proactive-Service-Resolution-to-enable-automatic-incident-management.