Configure the Integration with SAP Build Process Automation

Prerequisites

Prerequisites for using SAP Build Process Automation with Operations Automation are the following:

  • You have subscribed to a SAP Business Technology Platform account with activated SAP Build Process Automation in one of the sub accounts.
  • You are developing in your SAP Build Process Automation management account workflows or automations  that either resolve error situations or alerts detected by SAP Cloud ALM or orchestrate and automate regular operational tasks. These workflows or automations should be triggered automatically or manually from SAP Cloud ALM for Operations as a follow up action to a monitoring event or an alert.

Configuration

Obtain Service Key

  1.  Logon to SAP BTP Cockpit.  
  2.  Navigate to the subaccount where SAP Build Process Automation is subscribed.
  3. Select Instances and Subscriptions. 
  4.  Select the service instance for SAP Build Process Automation.
  5.  Select tab Service Keys. 
  6.  Select Actions --> Download.

Create API key

  1.  Logon to SAP Build Process Automation. 
  2.  Select Control Tower.
  3.  Create an API key with scopes trigger_read and trigger_execute for the environments you want to use.
  4.  Copy the generated API key.

Define a SAP Build Process Automation cloud service in Landscape Management (if required)

If the SAP Build Process Automation service was assigned to the same customer number as SAP Cloud ALM then the service is already listed in Landscape Management as cloud service of type SAP Build Process Automation. In this case  skip the service creation and proceed directly with the end point creation.  

Only if the SAP Build Process Automation Service is not yet shown in Landscape Management, define the SAP Build Process Automation cloud service manually as below:

  1. Logon to SAP Cloud ALM .
  2. Select Landscape Management.
  3. Select Add. 
  4. Enter the SAP Build Process Automation subaccount name into fields Name and Tenant ID. 
  5. Enter any description. 
  6. Select Cloud Service Type " SAP Build Process Automation ". 
  7. Select the correct tenant type (Production, Test, Development). 
  8. Enter the root URL of the workflow management application (https://.... build.cloud.sap) into fields Root URL and Logon URL.
  9.  Enter the subdomain id into field external id.
  10.  Select Save.

Add an endpoint

  1.  Logon to SAP Cloud ALM.
  2. Select Landscape Management. 
  3. Select the relevant cloud service of type "SAP Build Process Automation". 
  4. Select Edit. 
  5. Select the endpoints tab. 
  6. Select Add.
  7.  Optionally overwrite the proposed name and add a description.
  8. Ensure that you have the service key json in your clipboard and select button Paste Service Key.
  9.  Enter the API key.
  10.  Select Save.

Note:  

  • Save the endpoint only after you have entered Service Key and API key and not in between.
  • The connection check in the endpoint definition will fail. This can be ignored. 

Register operation flow definitions

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

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

  1. Select the Operations Automation tile.
  2. Select "Register Operation Flow → SAP Build Process Automation".
  3.  Choose the right endpoint from the value help.
  4.  Select the workflow/automation id that should be triggered.
  5.  Assign a use case corresponding to the planned usage of this workflow/automation.
    Example: If the workflow or automation should be triggered for monitoring events or alerts from Integration Monitoring, choose integration Monitoring.
  6.  Select Ok.

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

Optionally: Define event actions.

You can trigger the operation flow either manually from alerts or automatically as an event action for a monitoring event.

The configuration of operation flows as event actions for monitoring events is done in the configuration UI of the monitoring use cases.