创建表单

UiPath.Form.Activities.FormActivity

描述

使用此活动创建自定义表单。 您配置的表单会检索最终用户输入的所有数据，并将其存储在变量中，以便在自动化流程中进一步使用。 活动中的“ 执行” 块使您能够在表单打开或表单运行时执行其他操作。

项目兼容性

Windows - 旧版 | Windows

Windows、Windows - 旧版配置

设计器面板

• “打开表单设计器 ” - 打开 UiPath 表单设计器。

属性面板

常见

此类别中的属性是指常见活动设置。

• 显示名称 （字符串）- 设置此活动的名称。 例如 "User Registration Form"。
• ExecuteDoBlockFirst （布尔值）- 要在打开表单之前执行“执行” 块中的活动，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。
• “表单 标题”（字符串）- 设置表单的标题，供业务用户查看。 例如 "Registration Form"。
• 隔离 (布尔值) - 要在单独的 Windows 进程中运行表单，请选中此框。 选中此复选框可让验证站点和标注从同一流程无缝运行。 默认情况下，该复选框处于清除状态（设置为 false）。
• 计时器 (Int32) - 设置自动关闭表单之前的时间量（以秒为单位）。 例如 50。 默认情况下，不提供任何值，这意味着必须手动关闭表单。

数据绑定

此类别中的属性是指链接到自动化流程的数据。

• FormFieldsCollection (Dictionary<String, Argument>) - 将工作流变量绑定到表单字段键。 对输入表单字段使用“ 输入 ”或“输入 /输出” 方向。对输出表单字段使用 “输出” 或 “输入/输出” 方向。 例如，在“ 名称 ” 字段中添加字符串 First Name，将“ 方向” 设置为 In/Out，并将“ 类型 ” 设置为 String。
  
  

  

  
  
• 生成 输入字段 (布尔值) - 要将集合中定义的字段添加到表单，请选中此框。 默认情况下，复选框处于选中状态（设置为 true）。

数据表

此类别中的属性是指表单中的表格数据。

• MaxColumnsForSchemaGeneration (Int32) - 设置为数据表架构生成的最大列数。 默认值为 6。

调试

此类别中的属性是指调试表单和试验 CSS 样式。

• “开发工具 ” - 启用用于调试表单和对表单进行故障排除的开发者工具，称为“开发工具”。 开发者可以使用开发工具来试验 CSS 样式。 选中后，该属性将在运行时打开“开发工具” 窗口。

表单选项

此类别中的属性是指表单内的可访问性。

• “启用辅助功能 ” - 启用符合 USWDS（美国网页设计系统）的辅助功能。 启用此属性后，表单的样式可能会受到影响。

格式

此类别中的属性是指表单外观和格式。

• “禁用最大化 ”（布尔值）- 要停用表单上的“最大化”和“还原”按钮，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。
• “禁用 最小化”（布尔值）- 要停用表单上的“最小化”和“还原”按钮，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。
• DisableSanitize (布尔值) - 要停用对表单组件的最终检查并提高性能，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。

警告：如果您的表单包含未知 URL 或正在使用外部来源，请清除该复选框。

• “表单 高度 (Int32)” - 设置表单的所需高度，以像素为单位。 默认高度为 400。
• “表单 宽度 (Int32)” - 设置表单的所需宽度，以像素为单位。 默认宽度为 800。

注意: 要在最大化的窗口中打开表单，请将“表单高度” 和“表单宽度” 字段留空。

• “图标路径 ”（字符串）- 设置图标文件的本地相对路径。 该图标显示在任务栏和表单窗口中。接受 .ico 或图像格式。 （例如 "C:/Users/Icons/myIcon.ico"）。

注意： 您可以使用相对于流程的路径，只要 .ico 文件作为流程中的资源发布（例如 "myIcon.ico"）。

警告：您需要选中“ 独立 ”复选框（“通用” 属性）。 否则，不会显示该图标。

• “只读 ” (布尔值) - 要防止编辑表单字段，请选中此框。 标记为“始终启用” 的字段不受此选项影响。 默认情况下，该复选框处于清除状态（设置为 false）。
• LocalCSSFilePath (String) - 设置本地 CSS 文件的路径（例如 "/file://C:\C:\User heCssFile.css"）。
• 以最小化方式启动表单 (布尔值) - 要在任务栏上的最小化窗口中生成表单，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。
• WindowPositionX (Int32) - 设置表单左边距位置，以像素为单位。
• WindowPositionY (Int32) - 设置表单上边距位置，以像素为单位。

输入

此类别中的属性引用 JSON 输入数据。

• “表单 字段输入数据”（字符串）- 将 JSON 输入数据传递到表单，并覆盖“ 表单 字段集合”字段中定义的值。 对于数据网格组件、结构、JSON 数组。

其他

此类别中的属性是指其他设置。

• 私有 (布尔值) - 要在详细级别跳过日志记录变量和参数，请选中此框。 默认情况下，该复选框处于清除状态（设置为 false）。

输出

此类别中的属性引用输出对象数据。

• 已关闭 (布尔值) - 当最终用户在未提供任何输入的情况下关闭表单时，输出 true 。 例如"isDismissed" 。
• “表单字段输出 数据”（字符串）- 表单完成后生成的 JSON 数据。 例如"userData" 。
• “选定按钮” （字符串）- 输出与最终用户交互的表单用户界面元素。 例如 "selectedButton"。

启动表单

此类中的属性将表单绑定到“ 启动表单活动”，因此可以在后台打开表单。

• 文件夹路径 （字符串）- 输入要保存表单数据的路径。

• 表单名称 （字符串）- 输入表单数据的名称。

  
  

  

  
  

警告：要将每个“ 创建表单 ”绑定到相应的“ 启动表单”活动， Folder Path 和 Form Name 值必须与在“ 启动表单活动” > “创建表单”属性中设置的值匹配。