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

Mapping the REST API web service request alias to an appropriate connection


You can connect your application to the REST API web service of another application without using code or connectors. After configuring web requests in a business process, an alias is created for the web request. An alias is a placeholder for tenant-specific configurations. To ensure that the appropriate authentication credentials are used when a RESTful web service is invoked from the business process, administrators must map the alias with the appropriate web API connection.

For example, if you want to connect to a JIRA RESTful service, you must map the JIRA Web API alias with JIRA connection. Administrators should have already configured the JIRA connection with authentication credentials. 

Before you begin

To map the web request alias with an appropriate web API connection

  1. Log in to BMC Helix Innovation Studio and navigate to the Administration tab. 
  2. Select Configure My Server Connection Mappings Web API, as shown in the following image:
    1811_REST alias mapping.png
  3. From the Select Application list, select the application from which you want to connect to the REST API web service.

    Note

    If you have not created the REST API web request definition in any application, the list is blank.

    A list of web request aliases that you configured for the selected application are displayed as Connection Target. 
    Example: JIRA 

  4. In Connection Configuration, select the appropriate authentication credentials for the web request alias. 
  5. Click Save

After you have completed all the tasks, when the process in which you have configured the web request is triggered, a connection is established between your application and the REST API web service.

Related topics

Expression-Editor

Process-designer-elements