Set Up Business Process

Management Services in Cloud

Cockpit
2020-01-05
Beginner

20 min.

SAP Cloud Platform, Tutorial, Beginner

Set up services to automate and achieve operational insights into employee onboarding
process.
You will learn

 How to enable and configure workflow, business rules and process visibility services

Intelligent Business Process Management is a family of services to automate

business processes, manage decision logic and gain end-to-end visibility in your
processes.

Users can now use SAP Cloud Platform Workflow, SAP Cloud Platform Business
Rules and SAP Cloud Platform Process Visibility services together to create process
extensions on top of any business application, orchestrate tasks or build process-
centric differentiating applications.

In this tutorial mission, setup and use these services to automate and achieve
operational insights into employee onboarding process.
 Step 1: Check Entitlements
To create service instances for business process management services, you need to
ensure that you have the right set of entitlements in your trial account.

1. In your web browser, open the SAP Cloud Platform Trial cockpit.

2. Navigate into the trial subaccount

The trial account should contain one subaccount and space

3. Open Entitlements from left panel. You should have the following entitlements in

your account.

If not, then use Configure Environments to add these entitlements.

Here is an explanation of these different entitlements:

o Connectivity is needed to configure destination

o Portal and HTML5 Application is needed to access Process Visibility and Workflow
applications from Fiori Launchpad
o Business Rules, Workflow and Process Visibility is needed to create service
instances of these respective services in order to work with them.
 Done

Log on to answer question

Step 2: Download multitarget

application file
Download the BPMServicesFLP.zip from GitHub in your local file system.

This multitarget application when deployed will (a) create new service instances for
workflow, business rules and process visibility in cloud foundry environment, (b)
creates an application to access business rules editor and Fiori Launchpad for
workflow and process visibility applications.
 Done

Log on to answer question

Step 3: Access SAP Web IDE

1. In your web browser, open the SAP Cloud Platform Trial cockpit.
2. Choose Launch SAP Web IDE.

If you are new user then Web IDE Full-Stack will not be enabled for your account
and you will see a message saying “SAP Web IDE Full-Stack is not be enabled for
this account”. Follow the instructions on the Web IDE page, to enable the Web IDE.
3. In the navigation area of SAP Web IDE, choose the Preferences icon.

4. Select the Extensions preference, and search for workflow.

5. Toggle the button to switch on the Workflow Editor extension, and Save the
changes.

If a confirmation popup appears, then click Refresh to apply the changes.

6. Select Cloud Foundry preference.
7. Enter the following details, and Save the changes:

Field
Value Example
Name

Your
API https://api.cf.eu10.hana.ondemand.com or https://
trial
End api.cf.us10.hana.ondemand.com depending upon the region of
API End
Point your trial account
point

Your
Organiz trial
trial_P237800
ation organis
ation

Your
Space trial dev
space

8. In the credentials popup, enter your trial user email and password. If you normally
login via single-sign on, login with your domain password.
9.

Done

Log on to answer question

Step 4: Import multitarget

application
1. In the navigation area of the SAP Web IDE, choose the Development icon.
2. Right-click the Workspace root folder, then choose Import | File or Project.
3. In the Import dialog, browse for the BPMServicesFLP.zip file that you downloaded in
your local system and choose OK.

4. The multitarget application gets imported under the Workspace folder and the file
structure is shown below.

Ensure that have chosen Show Hidden Files to be able to view the app-router file

structure as shown.
 Done

Log on to answer question

Step 5: Build and deploy

When you build and deploy this application, there will be new service instances
created for each workflow, business rules and process visibility service in cloud
foundry.

1. Right-click on the BPMServicesFLP project and choose any of the Build option.

2. After the build completes, navigate to
the mta_archives | BPMServicesFLP_0.0.1.mtar file.
3. Right-click BPMServicesFLP_0.0.1.mtar and choose Deploy | Deploy to SAP Cloud
Platform.
In the popup, select the Cloud Foundry API Endpoint, Organisation and Space
where you would want to deploy the application.

There could be deployment errors:

o if you have not enabled the entitlements of workflow, business rules, process
visibility and portal. Ensure that you have followed Step 1 to do the necessary
entitlements.
o if you already have the instance of either workflow, business rules or process
visibility created of same name. In that case, update modules and resources section
in mta.yaml to replace that service instance name with a new unique name.

Done

Log on to answer question

Step 6: Assign roles

1. In your web browser, open the cockpit of SAP Cloud Platform Trial.
2. Click Enter Your Trial Account
3. Open Security | Role Collections and click New Role Collection to add new roles.

Enter Name as BPMServices and Description as Roles to access Intelligent BPM

services. Once done, Save the changes.
4. Click BPMServices to navigate into role collection to add roles.

5. Click Add Role and select these roles to add them to the role collection one by one.
In Add Role popup, click Save after each selection.
Application Identifier Role Template and Role

bpmrulebroker RuleRepositorySuperUser

RuleRuntimeSuperUser

pvreuserservice PVDeveloper

PVAdmin

PVEventSender

PVOperator

PVTenantOperator

workflow WorkflowAdmin

WorkflowContextViewer

WorkflowDeveloper

WorkflowInitiator

WorkflowParticipant
6. To assign the role collection to your trial user, switch to Security | Trust
Configuration and select SAP ID Service.

7. In the Role Collection Assignment page, enter your trial user email and click Show
Assignments.

If you are doing this for first time, you will get a popup to select Add User.

8. Click Assign Role Collection and select BPMServices role collection.

Which roles you added in role collections? RuleRuntimeSuperUser PVAdmin

WorkflowViewer WorkflowInitiator
Submit Answer

×
Log on to answer question
 Step 7: Create destination for API
Business Hub
The sample business rules used in this scenario is published in API Business Hub.
This destination will be used in SAP Cloud Platform Business Rules to connect to
API Business Hub to discover and import sample rules.

1. Go back to the subaccount trial and switch to Connectivity | Destinations from the

left-hand navigation.
2. Click New Destination.
3. Enter the following details:

Field Name Value

Name BUSINESSRULES_APIHUB

URL https://api.sap.com

Authentication BasicAuthentication

User your trial user id

Password your trial password

4.
5. Save the destination.
 Done

Log on to answer question

Step 8: Create destination for

Business Rules APIs
The sample workflow calls business rules to determine the list of equipment needed
for the new hire. This destination (BUSINESS_RULES) will be used while modelling the
workflow to call the business rules APIs.

Choose New Destination, and enter the following data:

Field
Value
Name

Name BUSINESS_RULES

https://bpmruleruntime.cfapps.eu10.hana.ondemand.com/rules-
URL service

Authentica
OAuth2ClientCredentials
tion

<use your client ID from the Business Rules service

Client ID instance>

Client
<use your secret from the Business Rules service instance>
Secret

Token
https://<userid>.authentication.eu10.hana.ondemand.com/
Service
oauth/token where userid is your trial account user id
URL

Replace eu10 with us10 in the URLs if your trial account is in US region. For

example, the URL in above destination will become:
https://bpmruleruntime.cfapps.us10.hana.ondemand.com/rules-service

To get Client ID, Client Secret and Token Service URL: (a) navigate into
your dev space in your trial cockpit, (b) select Service Instances from left panel, (c)
search for rules, and then select businessrules service instance and (d) navigate
into businessrules to get clientid, clientsecret, and url.

Done

Log on to answer question

Step 9: Access applications

These applications will be used in next tutorials to work with business rules, workflow
and process visibility. One link is for the Fiori Launchpad which will be used to
access workflow and process visibility applications and another link is to
access business rules editor.
 You can open both the links in different browser tabs and use them in further
tutorials.

1. Click on Spaces and then navigate into dev space.

2. In dev space, click on Applications and from among the available applications
select BPMServicesFLP_appRouter application.

3. In the Overview section, click app-router link to open workflow, business rules and

process visibility applications.

Log on with your trial user ID and password to the application.

This will open the SAP Fiori launchpad with Workflow and Process Visibility tiles.

In the same link, append /comsapbpmrule.ruleeditor/index.html after app-router
link to open business rules editor.

For example: https://trial-userid-dev-bpmservicesflp-
approuter.cfapps.eu10.hana.ondemand.com/comsapbpmrule.ruleeditor/index.html

This completes the set up of starter scenario for Intelligent Business Process
Management in your trial account. In next tutorial, you will access the sample content
of these different services, quickly set them up in your account and then run the
scenario to get an integrated experience.

Done

Log on to answer question