Using Business Objects With the Oracle Process Cloud Service

Using Business Objects With the Oracle Process Cloud Service

By: Courtney Dooley | Content Developer

Imagine you’re outlining an Oracle Process Cloud Application that you need to build. You then realize you need the data that’s entered into your form to be passed to a Process, filtered through a Decision, and used as an input for a REST API call.  That scenario could have you creating a Field, Data object, Decision input object, and a REST API request body.  However, if you start by defining a Business Object that contains all the data you will need for these functions, you may find you only need one.  Below describes how you can keep your data organized within your Process Cloud Application, and shorten the time needed to create and link these objects. Oracle PCS is extremely versatile and can help you leverage the Oracle Process Cloud optimally.

Creating Application Wide Business Objects With Oracle PCS


  1. Define your Business Object to Allow the Most Versatility

A Business Object is a set of data you will be storing throughout your process.  It may be two or three string values, a combination of dates, amounts, and personal data. Or, it may be a complex set of arrays.  Business Objects can take many forms which allows for a wide range of business needs.  The key for success is to have a versatile Business Object to avoid creating new Business Objects for data at different points in your workflow process.

For example, you want to create a form that will ask for a user’s name, address, phone number, and email.  From this you will derive the user’s region where you can then perform a lookup to get the user’s account number.  A shorter process, rather than having a Form Object with field values, a Decision Object for the region derived, and then an API Request Body to do the account lookup; it is best practice to create a single Business Object with all six values defined within it.  Make sure to specify that account number is an array as the user may have more than one account.


  1. Create your Business Object in your Process Cloud Application

There are multiple ways to create business objects within the Process Cloud

Creating New Business Objects

This option does not require any code or formatting and will walk you through creating your Business Object, step by step.  For details on this option, Click Here.

Dropdown menu in Oracle Process Cloud highlighting option to create a new business object.

Importing Business Objects – From XML Schema

If you have an xsd file for a web service you will be using, or if you have an XML Schema already written, this option allows you to import that file to define your attributes.  For more information on this feature, Click Here.

Oracle Process Cloud import menu with 'From XML Schema' option highlighted for business object import.

Importing Business Objects – From JSON

If you know you will be using a REST API call within your process, this option allows you to paste in the JSON that will define your request body.  You can also write your own JSON to define what attributes you will be using in this Business Object.  Simply format your attribute as outlined below. The values are examples of the types of values you are expecting.

{
“Name” : “Your Name”,

“Phone_Number” : “123-555-9876”,
“Address” : “123 Baker St, New York NY 54321”,
“Email” : “YourEmail@Tekstream.com”,
“Account_Number” : [{
“Account_Type”:”Customer”,
“Account_Number” : 123123

},{
“Account_Type”:”Business”,
“Account_Number” : 234234
}]

}

Oracle Process Cloud import menu with 'From JSON' option selected to import business object data.


  1. Using Business Objects

Forms

Now that you have your attributes defined in your new Business Object, you can create a form in a snap.  Whether you’re creating a Web Form (Oracle’s newest form builder) or a Basic Form (Frevvo), you can drag and drop your Business Object into your form and have the fields built out for you.  Just follow the steps below:

Web Forms:

  1. Create a New Web Form, or Edit one you’ve previously created.
  2. From the Business Types Palette, drag and drop your new Business Object
  3. Business Objects 4
    All of the fields will appear as you outlined in your Business Object, including the ones your user will not be filling out.
  4. Oracle Process Cloud form editor showing mapped fields from MyBusinessObject in form design mode.
    Now you can modify the fields to the layout you prefer. You can also remove the fields you don’t want on your form.

Basic Forms:

  1. Create a New Basic Form, or Edit one you’ve previously created.
  2. Click on the Manage Business Objects
    Business Objects 6
     icon in the Form Header menu.
  3. In the Form Business Objects window, move your Business Object from the “Available” Column to the “Selected” Column.
  4. Form business objects dialog in Oracle Process Cloud showing available and selected data objects.
    After clicking “OK”, your business object will be available in the Data Sources Business Objects.
  5. Oracle Process Cloud data sources panel displaying MyBusinessObject fields like name, address and email.
    You can either click the green plus sign for the individual objects you wish to add to your form, or you can click the green plus sign for the entire object to create all fields.
  6. business object cForm design view showing MyBasicForm with fields from MyBusinessObject in Oracle PCS environment
    Now you can modify the fields to the layout you prefer, as well as remove the unwanted fields.
Processes, Decisions, and Integrations

Throughout your application development process you will find many places where you need to define the type of input and output you will be expecting.  Now that you have defined your Business Object, it can be used for any data object input or output.

Sub Processes:  Inputs and Outputs

Oracle Process Cloud process modeler interface showing 'Edit Type' dropdown with MyBusinessObject selected.

Decision Rules: Inputs and Outputs:

Oracle PCS dialog to add a data object with object type dropdown showing multiple business data options.

Integrations: Request Body and Response Body

POST endpoint setup in Oracle PCS with BusinessData.MyBusinessObject selected for request body.

As you can see, Business Objects can unify your Application Data and can significantly speed up the development process.  By planning ahead and making smart choices for your Business Objects, you can create a complex Application simply.

Contact Us for more tips and tricks on developing smart Oracle Process Cloud Applications or general use cases for the Oracle Process Cloud.