JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Designing Oracle Java CAPS Business Process Manager Projects     Java CAPS Documentation
search filter icon
search icon

Document Information

Designing Oracle Java CAPS Business Process Manager Projects

Business Process Model Overview

Business Process Components

Java CAPS Components

Java CAPS Component Activities

JMS Activities

Editing Business Processes

The Business Process Designer

Business Process Activities

Activity Elements

Branching Activities

Intermediate Events

Scope Element

While Element

The Business Rule Designer

The Business Rule Editor

Reset Destination

Building a Business Process Model

Adding a Business Process to a Project

To Add a Business Process to a Project

Creating the Business Process Components

Adding Activities

Adding Components from the Project Tree

Linking Modeling Elements

Incorporating Business Rules

Adding Business Rules Activities

Adding a Business Rule to a Link

Defining Business Rules

Editing Business Rules

Validating a Business Process Model

To Check the Business Process for Errors or Warnings

Saving a Business Process Model

To Save a Business Process Model

Incorporating Sub-Processes Into Business Models

Creating a Sub-Process

To Create a Sub-Process

Adding the Sub-Process to the Main Business Process

To Add the Sub-Process to the Main Business Process

Using Predicates with Repeating Nodes

Creating a New Predicate

To Create a New Predicate

Editing a Predicate

To Edit a Predicate

Deleting a Predicate

To Delete a Predicate

Predicate Example

Customizing the Business Process Display

Changing Link Styles

To Change Link Styles

Changing Grid Properties

To Change Grid Properties for a Business Process

Aligning and Distributing Modeling Elements

To Automatically Align or Distribute Modeling Elements

Automatically Arranging Modeling Elements

To Automatically Arrange Modeling Elements

Auto Layout Options

Generating Business Process Reports

To Generate a Business Process Report

Building a Business Process Model

When developing a Business Process, you first create and name a new Business Process in a Java CAPS Project, and then add modeling elements and other Java CAPS component operations to the Business Process canvas to develop a logical process flow. Like other objects, Business Processes appear in the NetBeans Projects window. Perform the following steps to create a Business Process model.

Once you create the Business Process, you need to might configure the properties. Once you have finalized the Business Process, you need to create a Connectivity Map, Environment, and Deployment Profile. You can then deploy the Project to the server.

Adding a Business Process to a Project

The first step in creating a Business Process is to add a new Business Process to a Java CAPS Project.

To Add a Business Process to a Project

  1. From the NetBeans Projects window, right-click a CAPS Repository-based Project.
  2. Point to New, and then select Business Process from the context menu.
  3. Enter a new name for the Business Process.
  4. Click Save.

Creating the Business Process Components

You create Business Process components by dragging, dropping, and linking the available modeling elements in the Business Process Designer.

Perform the following steps to create the components of a Business Process.

Adding Activities

There are several different kinds of activities you can include in a Business Process model. For more information about each of the different kinds of activities you can use and an illustration of their toolbar icons, see Business Process Activities.

To Add Activities

  1. Do one of the following:
    • On the Business Process Designer toolbar, click the activity icon and drag it to the canvas.

    • For intermediate or branching activities, click Intermediate Events or Branching Activities on the Business Process Designer toolbar, click the activity you want to use, and then drag it to the canvas.

  2. Click the activity name and type a new name for the activity. This is optional. You can accept the default name.

    Note - The activity name must contain at least one character (A-Z, a-z, or 0-9), it must start with a letter or an underscore (_), and it can contain spaces.


  3. Add Java CAPS components from the NetBeans Projects window as described in Adding Components from the Project Tree (optional).
  4. Link the activities as described in Linking Modeling Elements.

Adding Components from the Project Tree

Elements from the Project tree can either be dropped directly onto the canvas or onto an activity. Many elements provide custom settings so you can model every detail of your process.

To Add Project Tree Components

  1. In the NetBeans Projects window, expand the project tree until the element you want to add is visible.

    Note - Elements that can be added to a Business Process appear in the NetBeans Projects window with a yellow rectangular icon, like the FileClient receive and write activities or Visual Page Designer show operations.


  2. Click the element and drag it to the Business Process Designer canvas.
  3. Link the modeling elements as described in Linking Modeling Elements.

Linking Modeling Elements

Links indicate the flow of the Business Process by connecting activities together. BPM does not allow invalid links, ensuring the model is properly linked. Links can also accept business rules. A link with a business rule is marked with a blue icon.

To Link a Modeling Element

  1. Move your cursor over the connector portion of a modeling element.
  2. Hold the cursor over the outside edge of the modeling element until it changes from the arrow pointer to a hand.
  3. Drag a line from the first activity to the connector of the second activity, and then release the mouse.
  4. To change the link style, right-click the Business Process in the NetBeans Projects window, and then click Toggle Link Style.
  5. Click Save.
  6. Add business rules to the links, as described in Incorporating Business Rules below (optional).

Incorporating Business Rules

You can configure logic in a business rule activity or add a business rule to a link. Business rules are defined using the Business Rule Designer, which appears when you click the Display Business Rule Designer icon or double-click a business rule activity or a business rule icon on a link. It is active when you add or select a link with a business rule and when you add or select a business rule activity. The Business Rules Editor, available from the Business Rule Designer, allows you to further modify business rules.

Adding Business Rules Activities

A business rule activity allows you to map and manipulate data in an activity in the Business Rule Designer.

To Add a Business Rule Activity

  1. From the Business Process Designer toolbar, click Business Rule Activity and drag it to the Business Process Designer canvas.
  2. On the Business Process Designer toolbar, click Display Business Rule Designer.

    The Business Rule Designer appears in the lower part of the Business Process Designer.

  3. Define the business rules for the activity as described in Defining Business Rules.

Adding a Business Rule to a Link

You can add a business rule to a link in order to map and manipulate data between activities using the Business Rule Designer.

To Add a Business Rule to a Link

  1. Right-click a link in the Business Process, and then click Add Business Rule.
  2. On the toolbar, click Display Business Rule Designer.

    The Business Rule Designer appears in the lower part of the Business Process Designer.

  3. Define the business rules for the activity as described in Defining Business Rules.

Defining Business Rules

A business rule can be a direct mapping of data, or can include multiple methods to manipulate data during the mapping.

To Define a Business Rule

  1. In the Business Process Designer, double-click the business rule activity or link you want to edit.

    The Business Rule Designer appears.

  2. Expand the trees in the right and left panels until the nodes you want to map are visible.
  3. Do any of the following:
    • Drag a direct link between nodes in the right and left panels.

    • Select a method from the Method Palette. You can populate the method parameters and return values by linking them to nodes in the left and right panels, by linking them with additional methods, or by creating literal values.


      Note - See Using the Method Palette for more information about each method available in the Method Palette.


  4. When you are done creating business rules, click Save in the NetBeans toolbar.

Editing Business Rules

Once you create business rules, you can modify them in the Business Rule Designer. You can also use the Business Rules Editor, provided with the Business Rule Designer, The editor provides an advanced view of the business rules for your Business Process

To Edit Business Rules

  1. In the Business Process, double-click the business rule activity or business rule you want to modify.
  2. Do any of the following:
    • Add new mappings.
    • Incorporate new methods into the rules.
    • Delete an existing link by clicking the link and then pressing the Delete key (this cannot be undone).
  3. To modify rules in the Business Rules Editor, click the bottom gray triangle to the left of the Business Rule Designer title bar.

    The Business Rules Editor appears.

  4. By default, the rules are in read-only mode. Click Show Single Mapping to place the editor in edit mode.
  5. Do any of the following in the Business Rules Editor.
    • To delete a rule or set of rules, right-click the node and then click Delete. Use caution when deleting rules. This can result in modeling elements being removed from the Business Process and cannot be undone.

    • To activate the reset destination feature for a rule, right-click the rule, and then click Reset Destination (for more information about this feature, see Reset Destination).

      When you right-click the node again, Reset Destination appears with a check mark.

    • To deactivate the reset destination feature for a rule, right-click the rule, and then click Reset Destination.

      When you right-click the node again, Reset Destination no longer appears with the check mark.

    • To expand the tree nodes, right-click a node, and then click Expand, or click Expand All to expand all nodes.

    • To collapse a tree node, right-click the node, and then click Collapse.

    • To change the order of the rules, select the rule you want to move and then click either the down or up arrows in the toolbar until the rule is where you want it. You can only move a node if there a multiple nodes at the same level.

  6. To close the Business Rules Editor, click the top gray triangle to the left of the Business Rule Designer title bar.
  7. When you are done making changes, click Save in the NetBeans toolbar.

Validating a Business Process Model

After creating a Business Process model, you can check to see if there are any errors or warnings in the processing code. Errors are critical issues and will stop the Business Process. For example, activities that are not connected or an incorrect number of output links from an activity will cause an error. Warnings appear when there is a problem, but it is not critical enough to stop the Business Process. For example, unused containers in a Business Process cause warnings, you can still build, deploy, and run the process.

To Check the Business Process for Errors or Warnings

  1. On the Business Process Designer toolbar, click Validate Business Process Model.

    The Business Process Validation dialog box appears.

  2. If an error or warning is encountered, the dialog box displays information about the error or warning.
  3. If there are multiple errors or warnings, the Next button is enabled, allowing you to view information for each additional error or warning.
  4. If there are no errors or warnings, a message appears stating so.
  5. After you have reviewed any error messages, click Close.

Saving a Business Process Model

Even if a Business Process model is not complete or contains errors, you can save it as a “work in progress” and return to it later.

To Save a Business Process Model