For an application to work perfectly the different components of the application need to be seamlessly integrated together to work as a single unit. ONEWEB provide built in integration points to help the developers integrate without writing a single piece of code.
Process Flow can be easily integrated with both Smart Form as well as Page.
Process with Smart Form Assume if you have a request form that needs to be approved by a supervisor. Once you click "submit" after completing the information, system should call workflow to send your request to the supervisor. And once the request is assigned to the supervisor, system should notify him and open the request form on UI for the supervisor to approve or reject. Thus you need to integrate the forms on App Designer with the business process on Process Designer to make it work.
The first part of this scenario involves integrating smart form to process using Process buttons as explained in 6.3.6.1 Smart Form Integration with Process. The second part of the scenario is explained in this section as a step by step process. That is, from the Process to the Smart Form.
Open Process flow that you want to integrate with an Entity. Click on the Human Activity node that you want to map with the Entity. Click on ‘Load Entity’ Tab in the configuration panel. Choose the Entity name that you want to integrate with this task. Choose the process parameter that is passed from process to Entity. Choose the field on Entity where the parameter value passed from BO is set. Click ‘Done’ to save your mapping
Now once a task reaches this human activity and is assigned to a user, when the user selects this task to work on from his inbox, system will open the entity mapped to this human activity for the user to work on.
Process with Page Assume if you have a mobile or web page that needs to be submitted to a supervisor, once you click "submit" after completing the information. For this we use Microflow as the integration gateway between Page and Process Engine, to submit details on page to the process and also to send data back from process to the page in the form of notification. Please check the details for integrating process using Microflow in the Integrate Process with Microflow section. Also please refer 6.3.6.2. Page Integration with Microflow.
Process can also be integrated with external UX/UI or can be integrated with other system by using the REST APIs provided by ONEWEB Process Designer. Please check the Process Runtime REST API for more information on the APIs
Process can be integrated with an external UX/UI or can be integrated with other systems using the REST APIs provided by ONEWEB Process Designer. Though Process Runtime provides REST APIs sometimes they are integrated using Microflows to provide a common API for integrating with multiple systems. In this section we will talk about how to control and execute the process flow using Microflow engine.
In the Microflow we will use the Web Service node to call the different APIs of the process Runtime.
Start a Process from Microflow Assume if you need to start a process inside your Microflow. 1. Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel 2.Open the Web Service Parameter tab 3. Select Web Service Type as REST 4. Click on the REST Tab
5. In the REST tab enter the details for the Process API to start flow URL -http://:/BPMREST/service/runtime/process//start HTTP Type - POST Header - Application/json Content Type - application/json Authentication - Basic
6. Click on Open Mapping Parameter to map the input as given below.
7. Click on 'Done' once completed.
Now the user can deploy the Microflow and call this microflow to start your process.
Get Task list of a Process from Microflow Once a process is started, if there is a human task to be completed, user needs to retrieve the taskID for the task to claim that task. In this section we will show how to retrieve a task using your Microflow.
1. Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel
2. Open the Web Service Parameter tab
3. Select Web Service Type as REST
4. Click on the REST Tab
5. In the REST tab enter the details for the Process API to complete the task URL - http://:/BPMREST/service/runtime/tasks//complete?user= HTTP Type - POST Header - Application/json Content Type - application/json Authentication - Basic
6. Click on Open Mapping Parameter to map the input and output as given below.
Output
7. Click on 'Done' once completed.
Complete a Process from Microflow Once a process is started, user needs to complete each task in the process. In this section we will show how to complete a task using your Microflow. Before you start you need the taskID of the instance which needs to be completed. 1. Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel 2. Open the Web Service Parameter tab 3. Select Web Service Type as REST 4. Click on the REST Tab
5. In the REST tab enter the details for the Process API to complete the task URL - http://:/BPMREST/service/runtime/tasks//complete?user= HTTP Type - POST Header - Application/json Content Type - application/json Authentication - Basic
6. Click on Open Mapping Parameter to map the input as given below.
7. Click on 'Done' once completed.
NOTE: A process can be integrated with a microflow, which can further be easily integrated to page and thus we can achieve the integration of a page with process. To know about integrating Page with Microflow please refer 6.3.6.2. Page Integration with Microflow.
