Setting Up SAP Cell and Gene Therapy Orchestration Business Rules and SAP Build Process Automation (or Workflow Service) Setup

Objectives

After completing this lesson, you will be able to:
  • Add service plans for SAP Build Process Automation (or Workflow), Business Rule Service
  • Create subscription, instances, and service keys
  • Configure business rule service integration with SAP Cell and Gene Therapy Orchestration
  • Define SAP Business Technology Platform destination
  • Maintain the business rules

Business Rule Service

Why Business Rules?

Customers who subscribe to SAP Cell and Gene Therapy Orchestration must create a subscription of Business rule service. Setting up the Business Rule is a mandatory step to run the end-to-end business process for SAP Cell and Gene Therapy Orchestration. It is required to maintain the rule project to support the "confirm flow version" business process step in the SAP Cell and Gene Therapy Orchestration which a pre-requisite of manufacturing the treatment order.

What is Business Rules Service?

The Business Rules service allows you to digitize and automate decision making in various scenarios in SAP Cell and Gene Therapy Orchestration.

The business rules also has the capability that allows you to digitize and automate decision making for ERP Sales Order Create/Update Integration scenario. In SAP Cell and Gene Therapy Orchestration system, the business rules automatically made decisions for the following scenarios:

  • Business Partner determination for sales order and purchase order
  • Location Type determination for processing activities
  • ERP system ID and extension information determination, such as sales area, purchase organization, and so on refer to Business Rules for ERP Sales Order Integration for scenario examples

Note

In order to setup and access the business rule application, you need to subscribe to Workflow Management SaaS application. The business rule application is embedded into workflow management portal.

Optionally, you can also use the Workflow Service to extend the SAP Cell and Gene Therapy Orchestration scenarios based on various outbound business events.

How to Configure Business Rules?

In order to setup and access the business rule application, you need to subscribe to SAP Build Process Automation or Workflow Management - SaaS application as an alternative Service. The business rules project application is embedded into SAP Build Process Automation framework.

SAP Cell and Gene Therapy Orchestration customer need to get the additional license or purchase the additional entitlement to get the SAP Build Process Automation service plan added into their SAP Business Technology Platform account.

Note

Optionally, you can also configure the Workflow Service also. However, SAP recommends to use the latest service SAP Build Process Automation. In this tutorial, both services plans are configured for your implementation help purpose.

Workflow Management

To configure the business rule with Workflow Management, you need to add service plans under the entitlement section.

Screenshot of an SAP Cloud Platform interface showing the Entitlements section for a subaccount. The top part displays a list of services with columns for Service, Technical Name, Plan, Assign Quota, Subaccount Assignment, and Remaining Global Quota. An Add Service Plans button is highlighted. The bottom part shows details for Workflow Management under Entitlements. The pane includes the search term workflow mana and options for available plans, including saas-application (Application), with information about enabling Digital Process Automation. The left sidebar offers navigation options like Services, Cloud Foundry, and Security.

Steps

  1. In the same subaccount, go to Entitlements section.

  2. Configure Entitlements  Add Service Plans.

  3. In the Subaccount Entitlements dialog box, choose the Workflow Management service.

  4. In the Service Details, choose the application plan.

  5. Choose Add 1 Service Plans to add in your subaccount.

SAP Build Process Automation

To configure the business rule with SAP Build Process Automation, you need to add service plans as follows.

Steps

  1. In the same subaccount, go to Entitlement section.

  2. Configure Entitlements  Add Service Plans.

  3. In the Subaccount Entitlements dialog box, choose the SAP Build Process Automation.

    Screenshot of the Entitlements section in SAP Cloud Platform for a subaccount. The search term build is used to filter results. The highlighted option is SAP Build Process Automation, showing available plans on the right. Two plans, standard and free (Application), are listed. The free (Application) plan is selected and mentions community support with terms and conditions. Other solutions like SAP Build Apps and SAP Build Work Zone, standard edition are also visible.

  4. In the Service Details, choose the application plan as Standard.

  5. Choose Add 1 Service Plans to add in your subaccount.

  6. Repeat the steps from 1 to 5 to add the "workflow" and "Business rule" plans these plans will be used to build the integration with SAP Cell and Gene Therapy Orchestration application.

    Screenshot showing two sections for service entitlements in SAP Cloud Platform. The top section, labeled Workflow Plan (optional), displays a search for work, highlighting the Workflow entitlement with a selected standard plan, described as the default for using workflow. The bottom section, labeled Business Rules, features a search for Business Rules, highlighting the Business Rules entitlement. The standard plan is selected, offering features for creating, modifying, managing, and invoking business rules. Each section includes a search bar and service details pane.

  7. Choose Save.

    Note

    If entitlement is not available then go to global account level and add the entitlement on global account level. If no entitlement is available at the global account level, then reach to the SAP Business Technology Platform support.

Add Service Plan - Results

All plans will be added into the subaccount.

Screenshot showing entitlement details for various SAP services. The first section lists Business Rules with the technical name business-rules and standard plan. The second section shows Workflow with standard plan and Workflow Management SaaS with saas-application (Application) plan. The third section details SAP Build Process Automation with the technical name process-automation-service and standard plan, assigned 1 shared unit of quota. Each section includes columns for Service, Technical Name, Plan, Assign Quota, Subaccount Assignment, Remaining Global Quota, and Actions, with options to delete entries.

Create Subscription - Workflow Management

In this step, you will create the subscription for Workflow Management service. The service plan added in the previous step will be visible and used to create the subscription. Complete the following steps:

Steps

  1. On the subaccount level, navigate to Instance and Subscription menu. Go to the Subscription tab, choose Create.

    Screenshot of the SAP Cloud Platform interface showing Instances and Subscriptions for a subaccount. The highlighted Subscriptions (2) tab lists two subscribed applications: SAP Cell and Gene Therapy Orchestration - Preprod with prerel plan and Event Mesh with standard plan. Both applications show Subscribed status. The page includes options to filter by Service, Plan, and Status, along with a Create button in the top right corner. Column headers include Application, Plan, Created On, Changed On, and Status.

  2. In the dialog box, search the service plan using Workflow Management as a search term.

  3. Choose the service, Workflow management.

  4. Select the plan saas-application.

  5. Choose Create.

    Screenshot of the New Instance or Subscription setup in SAP Cloud Platform. The Basic Info step requests entry of service details. The Service dropdown is set to Workflow Management, and the Plan dropdown is set to saas-application. Required fields are indicated by asterisks. Buttons for Create and Cancel are at the bottom.

Result

Workflow Management Subscription is created and application link is enabled.

Screenshot of SAP Cloud Platform showing managed services under Subscriptions with Workflow Management highlighted. The status is Subscribed with the plan saas-application. The right pane offers an Overview tab, mentioning digitizing workflows and managing decisions for visibility. A Go to Application button is in the top right corner. No labels are assigned to the subscription. Other subscribed applications like SAP Cell and Gene Therapy Orchestration - Preprod and Event Mesh are also listed.

Rules Project Application - Workflow Management

Try to launch the application using Go to Application. A separate window is opened with all the related workflow applications.

Screenshot of the SAP interface showing tools categorized under Productivity, Development, and Monitoring Tools tabs. The Productivity Tools section includes My Inbox, Process Flexibility Cockpit, and Process Workspace. Under Development Tools, options are Manage Packages, Configure Visibility Scenarios, and a highlighted Manage Rule Projects. The Monitoring Tools section lists Monitor Workflows for Definitions and Instances, Monitor Visibility Scenarios, and Event Acquisition. The interface offers a structured navigation for SAP's various functionalities.

Note

Application name Manage Rule Project is used to configure the business rules/decision tables to enable the SAP Cell and Gene Therapy Orchestration business process steps. This is mandatory step to create the rules project for confirm flow version step in SAP Cell and Gene Therapy Orchestration business process.

Add Roles - Workflow Management

Screenshot sequence showing the creation and management of a role collection in SAP. The process begins with selecting Manage Rule Projects. A Create Role Collection window is displayed, where the role collection cgto_business_rule_admin is created with the description CGTO Business Rule Administrator. The bottom image shows the role collection cgto_business_rule_admin selected, displaying details in the right pane with options to edit, copy, or delete the role. The interface includes tabs for Roles, Users, User Groups, and Attribute Mappings.

In order to provide the access to Manage Rule Projects application, you need to add the required roles to respective users.

Complete the following steps to add the required roles:

Steps

  1. Navigate to your subaccount in the SAP Business Technology Platform cockpit.

  2. In the navigation area, choose Security → Role Collections.

  3. To create a new role collection:

    • Choose Create New Role Collection.
    • Enter a name and optionally a description, then choose Create.

  4. To copy an existing role collection:

    • Choose Copy at the end of the row of an existing role collection that you want to use as a template.
    • Enter a new name and optionally a description, then choose Create.

  5. You can find the new role collection created in the list of role collections.

  6. Choose the new role collection, then choose Edit.

  7. In the Roles tab, under Role Name search for the Application Identifier that begins with bpmrulebroker.

  8. Choose the required role name and the corresponding role template from the dropdown list, and then choose Add.

    For more information on roles, see Authorization Configuration.

  9. Optional: Keep adding roles or create additional role collections according to your requirements.

  10. Choose Save.

  11. Assign the created role collection to the user in your organization as per business role.

Result

Screenshot showing the Manage Rule Projects feature in SAP. The interface, labeled Business Rules, displays a dashboard for managing projects. The Projects section shows columns for Project Name, Project Label, Description, Status, and Created On, but presently indicates No data available. The SAP interface permits the design and configuration of systems, with options to view history, create, refresh, download, delete, filter, and access help.

You should be able to open the business rule projects and create the projects with corresponding decision tables for handling the SAP Cell and Gene Therapy Orchestration scenarios.

Create Subscription – SAP Build Process Automation

Follow the same steps and create the subscription for the SAP Build Process Automation.

This image shows a screenshot of a web application dashboard that displays information about instances and subscriptions. The main content area shows a table with details about the user's subscribed applications, including the application name, plan, creation date, and status. The image also includes sections for New Instance or Subscription and Subscriptions at the bottom.

Assign Roles - SAP Build Process Automation

In order open the SAP Build Process Automation application, you need to assign the following three roles Process Automation Roles to your user:

  1. ProcessAutomationAdmin
  2. ProcessAutomationDeveloper
  3. ProcessAutomationParticipant
The image shows a web application dashboard displaying a table with three roles: ProcessAutomationAdmin, ProcessAutomationDeveloper, and ProcessAutomationParticipant. The description for each role is provided, indicating their functionality and permissions. The Role Collections section on the left side of the image also displays the same role names and descriptions.

Note

You can create your own role collection and assign the roles according to the job position of user.

Result

After assigning roles, your Role Collections section should look like what is shown in reference image.

For more information, refer to the standard help documentation: Authorizations.

To launch SAP Build Process Automation → Navigate to Instances and Subscriptions and choose the Go to Application. You can find the Business Rule Application under the Monitoring tab.

The image shows a web application dashboard with two main sections. The top section displays information about a SAP Build Process Automation subscription, including its status. The bottom section shows various monitoring and management features for the application, such as Processes and Workloads, Automation Jobs, Required Events, Automation Designer, and Business Rules.

The Business Rules application is similar to the Manage Rules Project app in the Workflow Management service.

The image shows a web application dashboard for managing business rules. The main section displays a table with details about various rule projects, including the project name, label, description, status, and creation date. The image also includes a button to access the Business Rules feature in the application.

Create Instance

In this step, you will create the instance for the Business Rules service, generate service keys, create the SAP Business Technology Platform destination, and configure the settings in SAP Cell and Gene Therapy Orchestration.

The objective of creating the instance of the Business Rule service is to provide access of business rules created in "business rule projects application" to SAP Cell and Gene Therapy Orchestration application through SAP Business Technology Platform destination.

Since the SAP Cell and Gene Therapy Orchestration application can't access the business rule data directly, we need to create the instance of business rule service, generate the service keys, create SAP Business Technology Platform destination, and configure the settings in SAP Cell and Gene Therapy Orchestration application to access the business rule data based on the scenario.

Complete the following steps:

Steps

  1. On the subaccount level, navigate to the Instance and Subscription menu. Go to the Instance tab and choose Create.

    The image shows a web application dashboard with various service options, including Service Marketplace, Instances and Subscriptions, Cloud Foundry, and more. The main content area displays a table titled Instances that is currently empty, indicating no service instances have been created.

  2. In the dialog box, search for the service plan using Business Rules as search term.

  3. Choose the service plan, Business Rules.

  4. Select the standard plan.

  5. Choose runtime environment as Cloud Foundry.

  6. Choose Space.

    Note

    The space was created in the previous lesson.

  7. Enter the Instance Name (for example, cgto-dev-brf).

    The image shows a web application form for creating a new instance or subscription. The form is divided into three sections: Basic Info, Parameters, and Review. The Basic Info section includes fields for Service, Plan, Runtime Environment, Space, and Instance Name. The Parameters section is empty, and the Review section is not visible in the image.

  8. Choose Create Directly.

  9. Create a service key for the service instance that you created.

    Note

    You need a service key to setup the SAP Business Technology Platform destination so that SAP Cell and Gene Therapy Orchestration can use the name of this SAP Business Technology Platform destination and call the business rules from subscriber account. For more information, see Service Keys.

  10. Create a service key for the service instance that you created.

    • Go to business rule instance created, choose create under service key tab. For more information, see Create Service Keys in Cloud Foundry.
    • On the dialog screen, enter the Service key name (for example, cgto-dev-brf-sk) and choose Create.
    The image shows a web application interface for creating a new service key. The main section displays a form with fields for Service Key Name, Configure Binding Parameters, and the ability to upload a JSON file or specify the parameters in JSON format. Below the form, there is a section for Bound Applications, Service Keys, and Labels, all of which currently show no data. The interface also includes Create and Cancel buttons at the bottom.

Result

The Business Rule instance is created along with service key.

You need a service key to setup the SAP Business Technology Platform destination so that SAP Cell and Gene Therapy Orchestration can use the name of this SAP Business Technology Platform destination and call the business rules from subscriber account.

The image displays a web application dashboard showing details of a service instance named cgto-dev-brf. The service is of type Business Rules and is running on the standard plan in the Cloud Foundry runtime environment. The instance has a status of Created and is listed under the Instances section. The image also shows a table of service keys associated with the instance, including one named cgto-dev-brf-sk that has a status of Created.

Create SAP Business Technology Platform Destination

Create the SAP Business Technology Platform destination in line with the information provided into the reference image.

The image displays a web application form with fields for configuring a service. It includes instructions on how to copy the runtime URL and add it as a suffix to the rule-service/rest path, as well as how to copy the client ID and client secret from the UAA section and append the /oauth/token as a suffix to the token service URL.

Keep the information ready from the service key that was created for the Business Rule instance in the previous section - that is, the service key named "cgto-dev-brf-sk".

Configure Destinations App

Steps

  1. Go to the SAP Cell and Gene Therapy Orchestration system and open the Configure Destination app under the tab configuration.

    The image shows a web application dashboard for an enterprise software platform. The dashboard has a navigation menu with various configuration options, including Configure Organization Location Types, Configure Flow Section Types, Configure Number Range, Configure Rules, and Configure Post-Processing Events. The main content area displays a configuration interface for Configure Destinations, which allows users to view and manage various destinations and their associated settings.

  2. Choose Create.

  3. Enter the rule provider, BR.

    Note

    You can also use the search help to find the rule provider.

  4. Enter the Destination Name, BR_SERVICE, created in the previous steps.

  5. Choose Save and Activate.

    The image shows a web application interface for creating a new business rule. The main interface displays a form with a Rule Provider field, and a Continue and Cancel button. Below the form, there is a Select: Rule Provider section that displays a list of available rule providers, including one named BR which is described as a Business Rule. The image also shows a business rule detail view, which includes general information about the rule and a field for specifying the destination name.

Result

Using this configuration setup, SAP Cell and Gene Therapy Orchestration can access the Rule set service of Business Rule application from the customer subscriber account.

Rules for Order Processing

The next step is to maintain the business rules.

Let's take an example of Treatment Order Processing Scenario, which is a mandatory step to process the treatment order and to confirm manufacturing schedule of treatment order by confirming the flow version business step.

Provide an ALT-Text for the image loaded to fulfill all accessibility requirements. The overall description should use as less words as possible. Ensure the output is plain text only, and avoid any formatting.

The user needs to leverage the Maintain Rule Projects application (as shown below in previous steps) and create the project, define rule service, and create the decision table to confirm the flow version step as per your business needs.

For detailed development steps, refer to standard help business rules documentation: Development.

In the reference image above, a rules project Order is created and a rule service FlowVersion is deployed with dummy data maintained in the decision table for the purpose of the simulation. You need copy the ID that is generated after deploying the business rule project.

For other SAP Cell and Gene Therapy Orchestration scenarios, refer to the following: Business Rules for ERP Sales Order Integration.

For detailed development steps, refer to standard help business rules documentation: Development.

Configure Rule

Steps

  1. Go to the SAP Cell and Gene Therapy Orchestration system and open the Configure Rules app under the tab configuration.

  2. Create the mapping of the rule ID captured from the Business Rule application with Entity, Scenario, and Rule Provider.

    The image shows a web application dashboard for an enterprise software platform. The dashboard has a navigation menu with various configuration options, including Configure Organization Location Types, Configure Flow Section Types, Configure Number Range, Configure Rules, and Configure Post-Processing Events. The main content area displays details of an Order item, including its status, general information, and a change log. The image also includes a search bar at the top.

Result

While confirming the flow version of a treatment order, the SAP Cell and Gene Therapy Orchestration application with do the search for this rule config, get the Rule provider ID, read the destination settings, prepare the URL internally, call the rule service, and get the required flow versions maintained from decision table.

Create Instance - Workflow

The image shows a web application interface for managing cloud-based services and applications. The main section displays a form with various fields for configuring a new instance or subscription, including Service, Plan, Cloud Foundry, and Instance Name. Below the form, there is a list of existing service instances, with details such as name, status, and creation information. The interface also includes a Create button to initiate the new instance or subscription.

Using Workflow Service, SAP Cell and Gene Therapy Orchestration provides in-built capabilities for triggering workflows for certain business events. Workflows deployed in the subscriber account can be configured against various business events. When a business event occurs, a workflow instance for the configured workflow definition is instantiated.

If you would like to extend the business process by consuming the various business events triggered by CGTO. You need to create the Workflow instance, create service key(s) as shown in the reference image above. Furthermore, follow the Configuration steps provided in CGTO admin guide Using Workflow Service | SAP Help Portal: https://help.sap.com/docs/sap-cell-and-gene-therapy-orchestration/administration-guide/using-workflow-service?q=bTP%20destination

Note

Use SAP Build Process Automation service to build the workflow scenarios.

Log in to track your progress & complete quizzes

Learning

SAP FacebookSAP YoutubeSAP LinkedIn