In this section we will learn how to create a business process from scratch. From version 4.0.19.10 and higher user can create an application only from AppSpace. User can then create a Process inside the application. Once the process is created, AppSpace will redirect you to Process Designer to design the process.
In this section we will show how to create an application and create a process in the application and also how to deploy this process to a real environment.
Process Template Diagram can be created by dragging each item and dropping to the diagram panel. User can double click on each node task to configure the data needed for execution. Shown below is an example to create a sample flow.
1. First, user must drag a Horizontal lane and drop to the diagram panel.
2. To start the flow user must drag the Start event and End event. Now for the example we are using, we need the Exclusive gateway, Human task and Database task as well. Drag these node tasks to the diagram panel.
3. Now the user must create the links between the node tasks. Move the mouse over at the source node task, click on any one of the circle ports that are highlighted and drag the port to the target node task and create the links as given below in the process design.
4. Double click on Database Tasks to change name to "Get User Information from DB" and "Save User Status to DB" as shown in the diagram below. Change name of Human Task to "Approve Inbox". Change name of Exclusive to be "Check Approve". User can double click on the link out of gateway to set the values. Double click on link out of Exclusive gateway and change name to "Approve".
Change the other lane to "Reject". For Gateways user can configure condition at the Gateway tab. To modify condition of link by using Formula Editor, click on the Condition button.
5. Configure the business object on each the node task,
Double click on node task to show Configuration Panel and open the Business Object tab.
Click to check both Input and Output checkbox to set input parameter and out parameter of that node task.
Click Open Mapping Parameter button, the mapping parameter page is shown for mapping input parameter and output parameter of the process to the node task.
Click the line between Input box and Mapping box.
Click on the Object in Input Process Parameter on the left hand side and drag into the Object containing in Activity Parameter on the right hand side.
Note: If both objects are same system will the mapping automatically for you.
Now click on line between Mapping box and Output box.
Click the Object in Activity Parameter on the left hand side and drag into the text in Output Process Parameter on the right hand side.
Click Done button on the top right hand side to go back to diagram.
6. Configure the Database Parameter for Database node.
Double on Database node task to show the Configuration Panel and open third tab. Note: Before doing this step user must set input and output parameters as described in step 5.
Enter the data regarding the database parameters. e.g. Enter Connection Type as "JNDI", JNDI Name is "jdbc/pd", Command Type is "Select" and Command - "select username, cost, date, status from user".
If the business object is already configured as per Step 5 in the Business Object tab, user can click Open Mapping Parameter button on Database Parameter tab and map parameter to the database query following the same step 5.
7. Configure the Assignment Policy for Human Task.
Double click on Human task to show Configuration Panel and open Assignment Policy tab. Enter value of Setting is "Pull" and value of Work party Name is "Approve".
8. Configured the value of Load Entity of the Human Task.
Double click on node task to show Configuration Panel and open Load Entity tab. Enter value of Entity as "Application" (This is the name of the entity from App Designer that will be used as the UI for the user to work on, when the human task is assigned to a user). Enter value of Key and Value as "APPLICATION_ID" (Key of the entity from AD) and "${UserRequest.id}" (PD Business Object parameter) to map data from this process flow to entity which forms the UI.
9. Finally, when each item on the process diagram is completely configured, user can save the process and deploy it to the destination environment to be integrated with other systems.
Once the process is complete and is validated successfully, user might want to test to see if the process is working as expected. For this ONEWEB provides the Simulator Utility to simulate the steps in the process.
To simulate a process, go to the Simulation Test tab. The utility provides the flow diagram for review and an input box with the input BO parameters in JSON format to start the flow.
Update the Input BO parameters with the actual value you need to send to test the flow.
Click on the Start button.
System will initiate an instance of the process with the sample values and highlight the path taken by the process with the current input values. It will also display the task Id for the current process.
User can continue through the different steps in the process until completion by clicking on the Complete button. Or user can click on the Retest button to start a new instance of the process.
How to Create a Process in ONEWEB
To create an application on AppSpace first login to AppSpace and click on the Create new app button.
When creating an application, user can create it as a Web Application or a Mobile App. Choose the right platform for your application and enter the details.
Click on Create button. The new application is created for you now. Click on the application icon to open your app. System will redirect user to the components page.
Click on Create Process icon.
On the Create Process dialog, enter the process details. User can click on Create button to simply create an empty process and can choose to start designing later. Alternately, user can click on Start Design button to create the process and to start designing now itself.
If user clicks on the Start Design button, system will create process and redirect user to the Page Designer. The system will now display the Create Flow page for creating the Process Template Diagram.
If the user is creating an application for the first time, then the system will redirect user to a wizard page instead of the workflow page.
Create Application Wizard has 4 steps for creating the process.
1. Define Business Object step. User can create the input and output parameters of the process.
User can add further details to the BO by clicking on the Add Parameter icon on the BO and add the parameters inside the BO.
After creating business object, user can click Next button to go to next step or click on Previous button to go to previous step.
NOTE: At any step during the wizard, user can click on the Save Wizard button at the top to save the steps and come back to create the rest of the steps later by clicking on View All Wizard menu.
2. Create Work Party step. User can define the Work Party to be used in the process. This step has Add button to add a row of Work Party and Remove button to remove Work Party. After entering the value for Work Party, user can move to the next step.
Property
Mandatory
Default
Description
Work Party Name
Y
Name of Work Party.
Type
Y
User Role
Type of Work Party, there is only 1 types as of now: User Role.
Work Party Lead
N
Lead of Work Party.
3. Create User/ Member step. User can create the members of Work Party. This step has Add button to add a row of member, Lookup existing member button can be used to select existing member from the system and Remove button to remove a member.
Property
Mandatory
Default
Description
Member ID
Y
ID of member.
Member Name
Y
Name of member.
Member Type
Y
USER
Type of member, there 2 types as following: USER and ROLE.
Work Party
Y
Work Party of member.
4. Create Process step is last step for creating an application. The system will now display the Create Flow page for creating the Process Template Diagram.
Once the process diagram is complete and each node task is fully configured, user might need the process to integrate with other systems. User will have to successfully deploy the process to start using this process.
Procedure
Before deploy user must use Deployment Validation for validating each node task of the process. It verifies that each node is completely configured, and no settings or details are missed out.
User must already have the destination environment ready for deployment because system will deploy the process to the runtime environment. Please refer Process Deployment from development environment section on details of how-to setup deployment environment.
Choose Deploy menu and select Deploy option.
Enter details of the target environment and then click Deploy button to deploy the process to the target environment.
Once the process is deployed successfully, user can test the process by using Simulator or any REST client. The steps to do so are elaborated in Process Test & Debug Guideline section.
If user chooses to click on Create. System will create the process and display the list of components to the user. User can later click on the edit icon to start working on the process.
User can choose from an existing BO in the system by clicking on Add existing business object icon or user can create a new BO by clicking on the Add parameter icon . Enter the details for the new BO on the Parameter dialog
