Example of using Create a Request action

The Create a Request action from the Process Composer package enables you to create a new request in Automation Co-Pilot on the web through a bot. In this example, use the Create a Request action to pass data through bot variables to initial form of the process.

Prerequisites

You must have a Bot Creator license and be assigned a custom role with the following permissions:
- Check-in and check-out permission
- Create folder permission
Create a process and check-in the process to the public workspace
Assign at least one team to the process with the default team selected
Select the by bot option in the Request creation field

In this example, we will create a process to register new employee details in the company database. The initial form contains basic information such as Name, ID, Date of Birth, Gender, and Location. We will pass the initial form data through bot variables.

Procedure

Create the initial form.

Create a form.

On the left plane, click Automation.
Click Create new > Form.
Enter the form name employee_register_initial_form.
Enter the folder location Bots\Employee Registration.
To change where your form is stored, click Choose and follow the prompts.
Click Create & edit.

Use the following Elements and Element label in the form.


Elements	Element label
TextBox	`Full Name`
Number	`ID`
Date	`Date of Joining`
Dropdown	`Gender`
Checkbox	`Location`
Select File	`Resume`

For the Dropdown element, enter Male, Female in the Enter list items separated by commas field.
For the Checkbox element, click the plus icon in Checkbox content field and add the locations San Jose, Tokyo, India.
For the Select File element, you can limit the file type which can be uploaded by specifying it in the Enter supported file format separated by commas field. For example; doc, gif, pdf, png, txt, xls.

Click Save.
Click Close.

Create a new process.
1. In the same folder location, click Create new > Process.
  Create a process automation in Process Composer.
2. Enter the process name employee_register.
3. Click Create & edit.
4. Click Start to add an initial form to the process.
5. In the Select initial data form field, browse and select the initial form, employee_register_initial_form.
6. Select AARI Storage in the File upload storage dropdown.
7. Provide Request title as Employee Registration.
8. Click Save.
9. Click Close.
10. Check in this process to the public workspace.
Create a new bot.
1. In the same folder location, click Create new > Bot.
2. Enter the bot name employee_register_request_bot.
3. Click Create & edit.

Create the following variables:

emp_name: String type; use as input.
emp_id: Number type; use as input.
emp_date_of_joining: Datetime type; use as input.
emp_gender: String type; use as input.

emp_location: Dictionary type, Boolean subtype; use as input. From the check box attributes given above, if you want to select the value San Jose for the location attribute in the initial form field, click the plus and create the dictionary variable in the format as given below:

Name: emp_location


Attributes	Key	Value
San Jose	`CheckBoxGroup0_0`	`True`
Tokyo	`CheckBoxGroup0_1`	`False`
India	`CheckBoxGroup0_2`	`False`

emp_resume: File type; use as input, select Desktop folder or file for the Default value and browse and select the file you want to upload.
employee_registration_request_id: Number type; use as output.

Use the Create a Request action from Automation Co-Pilot Web package.

In the Actions palette, double-click or drag the Create a Request action from the Process Composer package.
In the Public Process field, browse and select the public process employee_register. The initial form fields from the process are displayed in the Input values field. These fields are from supported interactive form elements.

In the Input values field, enter the values or variables to complete the required information to the initial form as given below:

emp_name: $emp_name$
emp_id: $emp_id$
emp_date_of_joining: $emp_date_of_joining$
emp_gender: $emp_genders$

emp_location: $emp_location$ . To select the location San Jose in the initial form field, add the key and value pair for the attributes as given below:


Attributes	Key	Value
San Jose	`CheckBoxGroup0_0`	`True`
Tokyo	`CheckBoxGroup0_1`	`False`
India	`CheckBoxGroup0_2`	`False`

emp_resume: $emp_resume$
employee_registration_request_id: $employee_registration_request_id$

Click Save.
Click Close.

Deploy the bot.
1. Click Run.
2. In the Set input variables field, enter the values for the input variable.
3. Click Confirm.
The bot deploys successfully and a new request is created through the default team assigned to the process. The initial form fields are filled with the input provided through the bot. In the web interface, an Automation Co-Pilot admin can verify that a new request is created, and the data has been selected properly.

Automation 360

Example of using Create a Request action