Referential Business Data Management
Learn how to create, update, delete and import referential Business Data in your Bonita applications, and how to design pages to manage them.
Introduction
With the BDM REST API, technical users and administrators can perform real-time updates on aggregated BDM data through secure endpoints: modify existing entries, delete outdated records, or bulk-import data via file upload.
All actions are authenticated, authorized, and fully traceable through Bonita’s existing logging mechanism.
These APIs are recommended for referential business data only, and are limited to Business Data that do not have references to other business data.
Moreover, if BDM Access Control is set, these APIs are only available to users without any restriction on the business data being created, updated or deleted.
Example Use Case: Referential Data Maintenance
An organization needs to update its list of countries stored in the BDM—used across multiple processes for forms and compliance. With the new API, an admin can securely update this reference data at runtime, without redeploying processes or risking data integrity. All changes are logged for full traceability.
Reacting to BDM Operations
If you need to react to BDM operations, the following specific events are triggered:
-
BUSINESS_DATA_CREATED
-
BUSINESS_DATA_UPDATED
-
BUSINESS_DATA_DELETED
As for any event, you can implement your custom logic in a Bonita Event Handler to react to these events.
These three events are always triggered, whether through APIs or through operations on tasks.
Traceability of BDM Operations
Each operation on the BDM through these REST APIs is traced using the standard Bonita queriable log system.
Business Data Management in Bonita UI Builder
This how-to page explains the procedure to create Bonita UI Builder pages that allows to bulk import, create, edit and delete referential Business Data.
Business Data Management in the UI Designer
This how-to page explains the procedure to create a Bonita UI Designer page that allows uploading a CSV-formatted file containing referential Business Data to import into your BDM.