SAP Workflow Management

Prerequisites

Prerequisites for using SAP Workflow Management with Operations Automation are the following:

You have subscribed to a SAP Business Technology Platform account with activated Workflow Management Service in one of the sub accounts.
You are developing in your workflow management account workflows that either resolve error situations or alerts detected by SAP Cloud ALM or orchestrate and automate regular operational tasks. These workflows 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 workflow APIs using OAuth 2.0 Authentication (Client Credentials Grant) as described here.
You have enabled technical authentication as described here and granted the following authorizations:
{ "authorities": [ "WORKFLOW_INSTANCE_START", "WORKFLOW_DEFINITION_GET", "WORKFLOW_DEFINITION_GET_SAMPLE_CONTEXT", "WORKFLOW_INSTANCE_GET" ], "defaultCollectionQueryFilter": "shared" }

Configuration

Define an endpoint to the workflow management service subaccount

An end point in SAP Cloud ALM Landscape Management pointing to the workflow service in the remote sub account is required to request the list of workflow definitions, trigger a new workflow instance and check the status of executed workflow instances. Proceed as follows to create the endpoint:

Determine the service configuration parameters of the SAP Workflow Management service in the external SAP BTP workflow management service account.

Open SAP BTP Cockpit and navigate to the global account → subaccount → space where the workflow management service is active
Select Instances
Select the workflow service instance
Select Actions (3 dots icon) besides the bound workflow application
Select View
Download the JSON or copy workflow_rest_url, clientid, clientsecret, url

Define a workflow management cloud service in Landscape Management

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

Open SAP Cloud ALM Landscape Management
Select Add
Enter the workflow management subaccount name into fields Name and Tenant ID
Enter any description
Select Cloud Service Type "SAP Workflow Management"
Select the correct tenant type (Production, Test, Development)
Enter the root URL of the workflow management application (https://....hana.ondemand.com) into field root url
Enter the subdomain id into field external id.
Select Save

Add an Endpoint

Open SAP Cloud ALM Landscape Management
Select the relevant cloud service of type "SAP Workflow Management"
Select the endpoints tab
Select Add
Enter the following data:

a.       Use Case: Operations Automation
b.       Root Url: <workflow_rest_url> (overwrite existing data if required)
c.       Authentication type: OAuth2ClientCredentials
d.       Client ID: <Client ID>
e.       Client secret: <client secret>
f.        Token Service URL: <URL>/oauth/token

6. Select Save

Register Operation Flow Definitions

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

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

Select the Operations Automation tile.
Select "Register Operation Flow → SAP Workflow Management".
Choose the right endpoint from the value help.
Select the workflow id that should be triggered.
Assign a use case corresponding to the planned usage of this workflow. Example: If the workflow resolves problems or alerts detected by Integration Monitoring, assign Integration Monitoring.
Select Ok.

As a result, the new workflow definition will appear in the list of registered operation flows.