Criar Formulário

UiPath.Form.Activities.FormActivity

Description

Use this activity to create a custom form. The form you configure retrieves all the data the end user inputs and stores it in variables, which can be further used in the automation process. The Do block in the activity enables you to perform additional actions when the form opens or while the form is running.

Compatibilidade do projeto

Windows - Legacy | Windows

Windows, Windows - configuração herdada

Painel do Designer

• Open Form Designer - opens the UiPath Form Designer.

Painel de Propriedades

Comum

As propriedades nesta categoria referem-se a configurações de atividade comuns.

• Display Name (String) - Sets the name for this activity. For example, "User Registration Form".
• ExecuteDoBlockFirst (Boolean) - To execute the activities in the Do block before opening the form, check this box. By default, the checkbox is cleared (set to false).
• FormTitle (String) - Sets the title for your form, seen by the business users. For example, "Registration Form".
• Isolated (Boolean) - To run the form in a separate Windows process, check this box. Selecting this check box enables Validation Station and Callouts to run seamlessly from the same process. By default, the checkbox is cleared (set to false).
• Timer (Int32) - Sets the amount of time in seconds until the form is automatically closed. For example, 50. By default, no value is provided, meaning the form must be closed manually.

Associações de Dados

As propriedades desta categoria referem-se a dados que estão vinculados ao processo de automação.

• FormFieldsCollection (Dictionary<String, Argument>) - Binds workflow variables to the form Field Keys. Use In or In/Out directions for input form fields. Use Out or In/Out directions for output form fields. For example, in the Name field add the string First Name, set the Direction to In/Out, and set the Type to String.

  

• GenerateInputFields (Boolean) - To add the fields defined in the collection to the form, check this box. By default, the checkbox is selected (set to true).

Tabela de Dados

A propriedade nesta categoria refere-se aos dados da tabela em formulários.

• MaxColumnsForSchemaGeneration (Int32) - Sets the maximum number of generated columns for DataTable schemas. The default value is 6.

Depuração

A propriedade nesta categoria refere-se à depuração de formulários e à experimentação de estilos CSS.

• Dev Tools - Enables the developer tool for debugging and troubleshooting forms, called Dev Tools. Developers can use Dev Tools to experiment with CSS styles. When checked, the property opens the Dev Tools window at runtime.

Opções de Formulário

A propriedade desta categoria refere-se à acessibilidade dentro dos formulários.

• Enable Accessibility - Enables accessibility in conformance with USWDS (United States Web Design System). When this property is enabled, the styling of the form might be impacted.

Format

As propriedades desta categoria referem-se à aparência e ao formato do formulário.

• DisableMaximize (Boolean) - To deactivate the Maximize, and Restore buttons on forms, check this box. By default, the checkbox is cleared (set to false).
• DisableMinimize (Boolean) - To deactivate the Minimize and Restore buttons on forms, check this box. By default, the checkbox is cleared (set to false).
• DisableSanitize (Boolean) - To deactivate final checks on the form components, and improve performance, check this box. By default, the checkbox is cleared (set to false).

Warning: If your form contains unknown URLs or it is using external sources, keep the checkbox cleared.

• FormHeight (Int32) - Sets the desired height for the form, in pixels. The default height is 400.

• FormWidth (Int32) - Sets the desired width for the form, in pixels. The default width is 800.

  Observação:

  Para abrir o formulário em uma janela maximizada, deixe os campos AlturaDoFormulário e LarguraDoFormulário vazios.

• IconPath (String) - Sets the local relative path to the icon file. The icon is displayed on the taskbar and in the form window. Accepts .ico or image formats . (for example, "C:/Users/Icons/myIcon.ico").

  Observação:

  Você pode usar um caminho relativo ao processo, desde que o arquivo .ico seja publicado como um recurso dentro do processo (por exemplo, "myIcon.ico").

Warning: You need to select the Isolated checkbox (Common properties). Otherwise, the icon doesn't get displayed.

• IsReadOnly (Boolean) - To prevent form fields from being edited, check this box. Fields marked as Always Enabled are not affected by this option. By default, the checkbox is cleared (set to false).
• LocalCSSFilePath (String) - Sets the path to a local CSS file (for example, "/file://C:\C:\User heCssFile.css").
• Start Form As Minimized (Boolean) - To generate the form in a minimized window on the taskbar, check this box. By default, the checkbox is cleared (set to false).
• WindowPositionX (Int32) - Sets the form left margin position, in pixels.
• WindowPositionY (Int32) - Sets the form top margin position, in pixels.

Entrada

A propriedade nesta categoria refere-se aos dados de entrada JSON.

• FormFieldsInputData (String) - Passes JSON input data to the form and overwrites the values defined in the FormFieldsCollection field. For Data Grid components, structure, the JSON as an array.

Diversos

A propriedade nesta categoria refere-se a configurações diversas.

• Private (Boolean) - To skip logging variables and arguments at Verbose level, check this box. By default, the checkbox is cleared (set to false).

Saída

As propriedades nesta categoria referem-se aos dados do objeto de saída.

• Dismissed (Boolean) - Outputs true when the end user closes the form without providing any input. For example, "isDismissed".
• FormFieldsOutputData (String) - The JSON data that results from the form upon completion. For example, "userData".
• SelectedButton (String) - Outputs the form UI elements the end user interacts with. For example, "selectedButton".

Iniciar Formulário

As propriedades nesta categoria vinculam o formulário à Atividade Start Form, para que o formulário possa ser aberto em segundo plano.

• Folder Path (String) - Enter the path where you want to save the form data to.

• Form Name (String) - Enter a name for your form data.

  

Aviso: para vincular cada Criar formulário à atividade de Início do formulário correspondente, os valores Folder Path e Form Name devem corresponder aos valores definidos em Atividade de início de formulário > propriedades Criar formulário.