Chapter 5. MortgageApprovalProcess business process in Business Central


A business process is a diagram that describes the order in which a series of steps must be executed using a flow chart. A business process consists of a collection of nodes that are linked to each other using connections. Each of the nodes represents one step in the overall process while the connections specify how to transition from one node to the other.

The sample Mortgage_Process contains the following predefined MortgageApprovalProcess business process.

finalBP

For this tutorial, delete the existing MortgageApprovalProcess business process and recreate it to gain a better understanding of creating a business process. Creating a new business process using the same name ensures that the sample project deploys and tests without error.

Procedure

  1. In Business Central, go to Menu Design Projects Mortgage_Process.
  2. Input MortgageApprovalProcess.bpmn in to the project’s asset search box and click MortgageApprovalProcess.
  3. Select Delete from the toolbar, and click Delete to confirm that you want to delete this asset.

The following procedures guide you through the creation of each task, connection, and gateway that comprises the MortgageApprovalProcess business process.

Red Hat Process Automation Manager contains a predefined selection of node types to simplify business process creation. The predefined node panel is located on the left side of the diagram editor.

node panel

5.2.1. Validating the mortgage

The mortgage validation business process determines whether the new application contains the required data before proceeding. If all of the specified data requirements are met, the application moves on to the mortgage calculation business process.

Procedure

  1. In Business Central, go to Menu Design Projects Mortgage_Process.
  2. Click Add Asset Business Process.
  3. Enter the following values:

    • Business Process: MortgageApprovalProcess
    • Package: Select com.myspace.mortgage_app

      The Package specifies the location inside the existing project where the asset will be created. In this example, it is created in com/myspace/mortgage_app.

  4. Click Ok. The diagram editor opens.
  5. In the upper-right corner, click the Diagram properties diagram properties icon.
  6. Scroll down and expand Process Data and click btn plus in the Process Variables section.
  7. Enter the following values:

    • Name: application.
    • Data Type: Application [com.myspace.mortgage_app]

Create an outgoing connection to an exclusive gateway. Exclusive gateways are used to make decisions and react to events based on the available data.

Procedure

  1. Click on the start event and create an outgoing connection from the start event to an exclusive gateway.

  2. Create an outgoing connection from the exclusive gateway to a task.

  3. Convert the new task to a business rule task.

  4. Click on the business rules task and enter Validation in the Name field of the Diagram properties panel.
  5. Expand Implementation/Execution, select validation in the Rule Flow Group field.
  6. Define the following Java expression in the On Exit Action field :

    System.out.println(application.getProperty());
    Copy to Clipboard Toggle word wrap
  7. Scroll down and expand the Data Assignments section and click btn assign next to Assignments.
  8. In the Validation Data I/O window, click Add to create the following assignments:

  9. Click Save.
  10. In the diagram editor, click Save, and Save, to confirm your changes.

5.2.3. Defining the validation data

This section describes how to define the data that determines whether the application data is correct or contains an error or any missing information.

Procedure

  1. Click on the Validation task and create an outgoing connection to an exclusive gateway.

  2. Create an outgoing connection from the exclusive gateway to a new business rule task.

  3. Click the created connection.

  4. In the Diagram properties panel, input Invalid in the Name field.
  5. Expand Implementation/Execution, select Expression in the Condition Expression section.
  6. Enter ValidationErrorDO() in the drools expression field.
  7. Click on the business rule task and enter Retract Validation in the Name field of the Diagram properties panel.
  8. Expand Implementation/Execution and enter error in the Rule Flow Group field.
  9. Create an outgoing connection from the Retract Validation task to a new user task.

  10. Click the user task and in the Diagram properties panel, input Correct Data in the Name field.
  11. Expand Implementation/Execution and enter the following values:

    • Task Name: CorrectData
    • Groups: broker
  12. Click btn assign next to Assignments. In the Correct Data Data I/O window, click Add to create the following assignments:
  13. In the Correct Data Data I/O window, click Add to create the following assignments:

  14. Click Save.
  15. Connect the Correct Data back to the first exclusive gateway. Your workflow should look similar to the following diagram:

5.2.4. Calculating the mortgage

The mortgage calculation business process determines the applicant’s mortgage borrowing limit.

Procedure

  1. Return to the second exclusive gateway. Create an outgoing connection to a business rule task.

  2. Click the created connection and in the Diagram properties panel, input Valid in the Name field.
  3. Expand Implementation/Execution, select Expression in the Condition Expression section, and enter not ValidationErrorDO() in the drools expression field.
  4. Click the created business rule task and in the Diagram properties panel, input Mortgage Calculation in the Name field.
  5. Expand Implementation/Execution and select mortgagecalculation from the Rule Flow Group drop-down menu.
  6. Expand Data Assignments and click btn assign next to Assignments.
  7. In the Mortgage Calculation Data I/O window, click Add to create the following assignments and click Save.

  8. Click on an empty space on the canvas, scroll down, expand Process Data, and click btn plus next to Process Variables. Enter the following values:

    • Name: inlimit
    • Date Type: Boolean
  9. Create an outgoing connection from the Mortgage Calculation task to a user task.

  10. Click on the user task, enter Qualify in the Name field, expand Implementation/Execution, and enter the following values:

    • Task Name: Qualify
    • Groups: approver
    • Click btn assign next to Assignments. In the Qualify Data I/O window, click Add to create the following assignments:

  11. Click Save. Above the canvas, click Save, and Save, to confirm your changes.
  12. Create an outgoing connection from the Qualify task to an exclusive gateway.

    1. Click on the GATEWAYS icon in the node panel.
    2. Click on Exclusive and drag it to the right of the Qualify task.
  13. Create an outgoing connection from the exclusive gateway and connect it to a user task.
  14. Click the connection and input in Limit in the Name field of the Diagram properties panel.
  15. Expand Implementation/Execution and select Condition in the Condition Expression section.
  16. Select inlimit from the Process Variable drop-down menu and select Is true from the Condition drop-down menu.

  17. Click the user task, enter Final Approval in the Name field, expand Implementation/Execution, and enter the following values:

    • Task Name: FinalApproval
    • Groups: manager
  18. Click btn assign next to Assignments. In the Final Approval Data I/O window, click Add to create the following assignments:

  19. Click Save. Above the canvas, click Save, and Save, to confirm your changes.

5.2.5. Increasing the down payment

The increasing the down payment business process checks to see if the applicant qualifies for the loan by increasing their down payment. The final result is either the final loan approval, or loan denial based on the applicant’s inability to increase the down payment.

Procedure

  1. Create an outgoing connection from the Final Approval user task and connect it to an end event.

  2. Return to the exclusive gateway that connects with the Final Approval user task. Create a second outgoing connection and connect it to a new user task.

  3. Click the connection and input Not in Limit in the Name field of the Diagram properties panel.
  4. Expand Implementation/Execution and select Condition in the Condition Expression section.
  5. Select inlimit from the Process Variable drop-down menu and select Is false from the Condition drop-down menu.
  6. Click on an empty space on the canvas, scroll down, expand Process Data, and click btn plus next to Process Variables. Enter the following values:

  7. Click the new user task and in the Diagram properties panel, input Increase Down Payment in the Name field.
  8. Expand Implementation/Execution and enter the following values:

    • Task Name: IncreaseDownPayment
    • Groups: broker
    • Click btn assign next to Assignments. In the Increase Down Payment Data I/O window, click Add to create the following assignments:

  9. Click Save. Above the canvas, click Save, and Save, to confirm your changes.
  10. Create an outgoing connection from the Increase Down Payment user task to an exclusive gateway.
  11. Create an outgoing connection from the exclusive gateway to an end event.
  12. Click the connection and input Down payment not increased in the Name field of the Diagram properties panel.
  13. Expand Implementation/Execution and select Condition in the Condition Expression section.
  14. Select incdownpayment from the Process Variable drop-down menu and select Is false from the Condition drop-down menu.
  15. Create an outgoing connection from the exclusive gateway and connect it to the first exclusive gateway.
  16. Click the connection and input Down payment increased in the Name field of the Diagram properties panel.
  17. Expand Implementation/Execution and select Condition in the Condition Expression section.
  18. Select incdownpayment from the Process Variable drop-down menu and select Is true from the Condition drop-down menu.
  19. Click Save, and Save, to confirm your changes.

Figure 5.1. Final version of the business process

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top