Procurement Living Application

About

This is an official Living Application example for Bonita Community and Enterprise Editions. The latest release is built using Bonita 2021.1 and is compatible with any future releases of Bonita.

ℹ️ If you are using an older version of Bonita, download the release corresponding to the version in question.

This example demonstrates the following concepts:

• Living Application
• Forms, pages and custom widgets built in the UI Designer
• Process using BDM and contracts
• Variable initialization using BonitaUsers templates
• Document generation and Sharepoint integration (optional)

This example contains 3 process diagrams:

• Init sample procurement data: The purpose of this process is to create a bunch of suppliers. The process declares one business variable suppliers that is used to create a list of suppliers. Suppliers to create are defined in the business variable default value. Executing this process will create the suppliers. :warning: This process should not be executed twice to avoid suppliers duplication (The process instantiation form includes a warning message if suppliers already exists).
• Procurement request: This is the main process diagram. A user fill a procurement request and identify potential suppliers. This request is sent to those suppliers for quotation. After completed, the quotations are sent back to the requestor for review and selection.
• Create supplier: This additional process does not have any tasks. It is used to automatically create a new supplier based on the data provided by the user in the instantiation form.

Procurement Request process - Diagram

Installation

1. Download the project .bos file
2. Import the .bos file in your Bonita Studio. (Optional: configure Sharepoint and Azure parameter values or put "test")
3. Deploy all 3 processes: select the process in the project explorer, do a right click and select Deploy
4. Run the sample data initialization process once and remove it from the Portal (using administration view)
5. Deploy the two application pages: in the project explorer, select Pages/Forms/Layouts, select a page, do a right click and select Deploy. Do the same for the second page. You can read more about pages from the official documentation.
6. Deploy the application: in the project explorer, select Application descriptors, select Procurement_application.xml, do a right click and select Deploy. You can read more about applications in the official documentation.
7. Run the Procurement application by accessing to this URL (the port number may vary):
   http://localhost:8080/bonita/apps/procurement

ℹ️ Note: this simplified version of the Procurement Request process only uses one actor.
The same user can fill a procurement request and approve it himself.

Screenshots

Procurement Living Application

Procurement Request process - Fill request form

Procurement Request process - Review request form