An activity "Create app item" allows you to create a new App Item during the execution of a business process.
For example, consider the Hiring process. Once a candidate is interviewed and selected for the job, an HR specialist hires him or her. At the end of the process, a new item is added to the Employees app, containing information about the candidate that was logged into the system during the process.
How to add Create app item activity
On the process page > on the panel to the right of the modeling field > open the System Elements tab. Drag the Create app item activity to the process diagram and place it in that part of the process where an app item must be created.
Depending on the activity settings, the executor can be assigned a task to create an app item, or the item will be created automatically.
How to set up Create app item activity
Double click on the activity shape to open the settings window.
In the window that opens fill in the following fields:
- Name – enter the activity name that will be displayed on the process diagram.
- Variable – specify context variable that will refer to an app item.
If the variable already exists in the business process context, you can select it from the drop-down list. To change the variable name and add a tip, click the Change variable settings button.
If the variable is not yet added to the process context, click on the Create new variable button. Please note that in the Create app item activity, only app type variables are used.
Once you've determined the variable, you will see the Fields Values tab the settings window.
On this tab, specify the fields that will be filled in automatically when you create an item. Click the Add button and select a field from the list of App fields. Then map the field with the corresponding context variable. When the process is executed, the field will be filled with the data stored in this variable.
Next, on the General tab, select the item creation method:
- Manually – The current executor will be assigned the task to create an app item. The App fields will be prefilled according to the settings specified in the "Fields Values" tab. You can change this data before completing the task and saving the item.
- Automatically – The item will be created automatically. Item fields will be prefilled according to the settings specified on the "Fields Values" tab.
After you have specified all the parameters, click Save.