Configure the Integration with
SAP intelligent Robotic Process Automation

Prerequisites

Prerequisite for using SAP intelligent Robotic Process Automation with Operation Automation are the following:

  • You have subscribed to an SAP Business Technology Platform account with activated SAP intelligent RPA Service in one of the sub accounts
  • You are developing in the  intelligent Robotic Process Automation Factory automations that either resolve error situations or alerts detected by SAP Cloud ALM or orchestrate and automate regular operational tasks. These automations should be triggered automatically or manually from SAP Cloud ALM for Operations as a follow up action to an alert.
  • You have enabled access to SAP Intelligent RPA APIs as described here and are aware of the service key properties (API URl, client id, client secret, JWT token url )
  • You know the API key for each SAP intelligent RPA environment in which SAP Cloud ALM shall trigger automations

Configuration

Define an endpoint to the SAP intelligent RPA service subaccount

An end point in SAP Cloud ALM Landscape Management pointing to the SAP intelligent RPA service in the remote sub account is required to request the list of defined automations, trigger a new automation and check the status of executed automation jobs. Proceed as follows to create the endpoint:


Define a SAP intelligent RPA cloud service in Landscape Management

If the SAP intelligent RPA subaccount is already known to Landscape Management, skip these steps and proceed directly with the end point creation. Otherwise, define the SAP intelligent RPA cloud service as below:

  1. Open SAP Cloud ALM Landscape Management
  2. Select Add
  3. Enter the SAP intelligent RPA subaccount name into fields Name and Tenant ID
  4. Enter any description
  5. Select Cloud Service Type "SAP intelligent Robotic Process Automation"
  6. Select the correct tenant type (Production, Test, Development)
  7. Enter the root URL of the SAP intelligent Robotic Process Automation Factory  (https://....hana.ondemand.com) into field root url
  8. Enter the subdomain id into field external id.
  9. Select Save

Add endpoints

Create one endpoint for each intelligent RPA environment that contains automations that should be triggered from SAP Cloud ALM as below:

  1. Open SAP Cloud ALM Landscape Management
  2. Select the relevant cloud service of type "SAP intelligent Robotic Process Automation"
  3. Select the endpoints tab
  4. Select Add
  5. Enter the following data:

Use Case:  Operation Automation
Root Url: <API URL> (overwrite existing data if required)
Authentication type:  OAuth2ClientCredentials
Client ID: <Client ID>
Client secret: <client secret>
Token Service URL: <API URL>/oauth/token
API Key: <API Key of the environment>

6  Select Save


Register operation flow definitions

The registration step is required to make the relevant automations  known to SAP Cloud ALM for Operations as Operation Flows.

Perform the following for each automation that should be triggered manually or automatically from SAP Cloud ALM for Operations.

  1. Select the operation automation tile
  2. Select "Register Operation Flow --> SAP intelligent RPA" 
  3. Choose the right endpoint from the value help 
  4. Select the trigger id that should be triggered from SAP Cloud ALM
  5. Assign a use case corresponding to the planned usage of this operation flow Example: If the operation flow resolves problems or alerts detected by Integration Monitoring, assign Integration Monitoring.
  6. Select Ok

As a result, the new automation / trigger  will appear in the list of registered operation flows.


Define event processing rules to trigger operation flows automatically

If the operation flow should be triggered automatically from an event, for example an alert, you need to define an event processing rule

  1. Select the intelligent event processing tile
  2. Select "Add Rule" (+ icon)
  3. Define a rule name
  4. Select the event type according to the alert for which it should be triggered
  5. Enter the alert name as visible in alert inbox
  6. Optional: if the action should be triggered only for specific alert context enter the alert context name here. Otherwise leave the field empty.
  7. Select action type Start Operation Flow
  8. Select one of the workflow definitions from the value help. If the value help is empty, you need to register a workflow definition and assign it to the selected use case
  9. Select save
  10. Activate the new rule