This documentation is for a version that is out of support.

You may want to view the same page for the latest version, or for any of the versions available in the drop-down menu in the top-right corner.

Business Data Management

This page explains what a user with the Administrator profile in Bonita Portal or in the Bonita Administrator Application can see and do about Business Data Model (BDM) and BDM Access Control.

Processes using Business Objects with persisted data need to run with a Business Data Model deployed in Bonita Portal.
On top of that, it is possible to define access rights on some attributes of business objects based on the user profile. This file is also managed in Bonita Portal.

Here is a view of the page: BDM in UI

Manage the BDM

Only one model can be deployed at a time in Bonita Portal, so make sure it contains the Business Object definitions used in all processes that will run within this tenant. The Business Objects must match the structure used by the deployed processes. Make sure that when modifying the Business Data Model, the processes are modified accordingly.

  1. To import the Business Data Model created in Bonita Studio, first export the Business Data Model from Bonita Studio where it was designed.

  2. In the Bonita Portal, log in as the technical user (default login 'install', default password 'install').

  3. Go to the BPM Services menu.

  4. Click on Pause to pause the tenant.

    The deployment of a Business Data Model requires pausing the service during the operation, so that the update can be performed without affecting ongoing processes. For Enterprise, Efficiency and Performance editions, you must have no access control file installed in order to be able to install or update the Business Data Model.

To do so:

  1. Log in as the technical user (default login 'install', default password 'install', or refer to the internal documentation if modified as it should be).

  2. Go to the BPM Services menu.

  3. Click on the Pause button to pause the tenant.

Then, you can install or update the BDM.

Please note that existing business database tables will be modified definitively. This action cannot be reversed.

  1. It is highly recommended to back up the database before proceeding.

  2. Export the Business Data Model from Bonita Studio where it was designed.

  3. Go to the BDM menu.

  4. Click on the Install button

  5. Choose the file containing the Business Data Model exported from Bonita Studio

  6. Click on the Install button in the popup.

  7. When services are paused, go to the BDM menu.

  8. A page called Business Data Model definition is displayed.

  9. Click on install button and choose the file containing the Business Data Model exported from Bonita Studio, and click on install button in the popup.

  10. A warning is displayed:

    The Business Data Model will now be installed.

    Bonita Portal will load the file, retrieve the object definitions and enable processes to use them at runtime.
    It will also create or update the database schema (set of tables, columns, indexes…​) in the business database, so as to store business objects appropriately when modified by processes. The Business Data Model will now be installed. BPM services can be resumed.
    To do so:

  11. Go to the BPM Services menu.

  12. Click on the Resume button to resume tenant activity.

    Since business continually evolves, you may need to make some changes to a BDM already in production. Bonita uses Hibernate for data persistence, therefore some changes are handled well, like adding new objects or attributes, but some others, like changing the type of an attribute or defining a unique constraint, we cannot guarantee so far. In such cases, you will have to implement the change on your own, through careful actions in a staging environment, and after the backup of your database. This limitation is well known and will be addressed in a future Bonita version.

Manage BDM Access Control

For Enterprise, Performance, and Efficiency editions only.

It is possible to define Business Data Model access control rules in Bonita Studio and import them in Bonita Portal.
The Access control rules must match the Business Data model.

  1. To import the BDM access control rules created in Bonita Studio, first export the Access Control file from Bonita Studio where it was designed.

  2. In the Bonita Portal, log in as the technical user (default login 'install', default password 'install') or as a user with the administrator profile.

  3. As the tenant technical user or as an administrator, go to the BDM menu.

  4. A page with a section Business Data Model access control is displayed.

  5. Click Install to open import popup and choose the file containing the Business Data Model access control definition exported from Bonita Studio, and click on Install.

  6. A successful import message will be displayed.

Please note that a delay is required after the import for the engine to process the access control and for the filtering to be effective.

Contrary to the BDM definition, the deployment of a BDM Access Control file does not require pausing the BPM services during the operation.

  1. Export the BDM Access Control file from Bonita Studio where it was designed.

  2. In Bonita Portal, log in as a user with the Administrator profile, or as the Technical user

  3. Go to the BDM menu

  4. Click on the Install button to open install popup

  5. Choose the file containing the BDM Access Control definition exported from Bonita Studio

  6. Click on the Install button

  7. A successful import message will be displayed.

Please note that a delay is required after the installation, for Bonita Engine to process the access control and for the filtering to be effective.

Cluster considerations

There is nothing specific to do in a cluster environment.

When the BDM is installed / updated in a cluster environment, 2 things occur:

  • The BDM database is updated to reflect the model changes. As the database is common for all nodes, there is nothing specific to do in a cluster environment.

  • The Java classes that map the new model are created / updated and loaded in the JVM classloader (at tenant level). This triggers the refreshing of the tenant classloader of all nodes of the cluster automatically.

With that is mind, the new BDM is fully available, and deploying on a different node a process that makes usage of the new Business Data Model will be available straight away.