Create Form Task

Prerequisites

• Install the UiPath.FormActivityLibrary package version 2.0.7 or higher to enable the form designer.
• Form tasks have a limit of maximum 1MB. To fit in this 1MB limit, you need to embed images inside forms, using Storage Buckets only. Also, we suggest using images of type base64 only for logos and icons smaller than 2KB.

Designer panel

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  Important: Make sure the action catalog exists prior to the action creation. Otherwise, action creation fails with the following error message: "No task catalog exists with name [action_catalog_name] Error code: 2451".
• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• TaskObject(Output) - The task object that is returned from Orchestrator as a FormTaskData object after the action is created. This object can be passed to the Wait for Form Task and Resume activity in order to suspend the execution of the workflow until the action is completed.

Properties panel

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

• DisplayName - The display name of the activity.
• TimeoutMS - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 30000 milliseconds (30 seconds).

• Enable Advanced Forms - enables enhanced features and customization options for form rendering and logic, such as:
  • Customizable templates for Edit Grids.
  • Buttons functioning as Events.
  • The ability to customize forms using ES6 and modern JavaScript.
  • The availability of the instance and options variables for customizing forms.
• Enable Bulk Edit - If selected, the Open Bulk Form Designer button becomes available in the body of the activity. This option allows you to generate form actions that can be bulk edited or completed from the Actions tab in Action Center.
  
  

  

  
  
• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add additional form fields to the designer.
• Labels - The robot adds the inputted labels to the action, allowing future filtering. This field support string values only and has naming restrictions.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  Important: Make sure the action catalog exists prior to the action creation. Otherwise, action creation fails with the following error message: "No task catalog exists with name [action_catalog_name] Error code: 2451".
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

  After you select Use Local Form File, click Open Form Designer, select New, and start building a form. When you finish , select Save As, and save it inside the corresponding project folder. Now you have the form that you previously created stored inside a JSON file. Input the path to this JSON file inside the Form File Path field to use that form at runtime.

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

• TaskObject(Output) - The task object that is returned from Orchestrator as a FormTaskData object after the action is created. This object can be passed to the Wait for Form Task and Resume activity in order to suspend the execution of the workflow until the action is completed.

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.
  Tip:

  Using image embedding with the Storage Buckets must be done in conjunction with the Upload Storage File activity. The argument name must be suffixed in the FormDataCollection property and mapped to an image in the form, by using underscore (_) in an HTML Element component.

  The argument name (<key>_storage) must be mapped to the storage value in the Destination property of the Upload Storage File activity.

  Note that image file names must not contain plus (+), as this character is masked by the storage bucket upload process resulting in an error.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  Important: Make sure the action catalog exists prior to the action creation. Otherwise, action creation fails with the following error message: "No task catalog exists with name [action_catalog_name] Error code: 2451".
• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• TaskObject(Output) - The task object that is returned from Orchestrator as a FormTaskData object after the action is created. This object can be passed to the Wait for Form Task and Resume activity in order to suspend the execution of the workflow until the action is completed.

Advanced options

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

• TimeoutMS - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 30000 milliseconds (30 seconds).

• Enable Advanced Forms - enables enhanced features and customization options for form rendering and logic, such as:
  • Customizable templates for Edit Grids.
  • Buttons functioning as Events.
  • The ability to customize forms using ES6 and modern JavaScript.
  • The availability of the instance and options variables for customizing forms.
• Enable Bulk Edit - If selected, the Open Bulk Form Designer button becomes available in the body of the activity. This option allows you to generate form actions that can be bulk edited or completed from the Actions tab in Action Center.
  
  

  

  
  
• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.
• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add form fields to the designer.
• Labels - The robot adds the inputted labels to the action, allowing future filtering. This field support string values only and has naming restrictions.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.
• Form File Path - input the relative path to the form JSON file that you saved inside the current project.

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.

1. Open the Form Designer.
2. Edit any component within the form and then save the changes.
3. Save the entire form.
4. Reopen the form, undo the previous changes you made, and save it again.

   Now the form should be reset and the new columns should be visible.