文件上传工具

UiPath Apps 现在支持以IResource格式进行文件处理。

使用 IResource

如果您以ILocalResource形式获取文件，则系统会使用以下方法自动将其转换为IResource ：

JobAttachment.fromResource(file) // file is a ILocalResource

重要提示：

以下函数已弃用，不应再使用：

• .toLocalResource
• .toAppsFile

页面导航

您可以使用以下命令，以编程方式导航到文档查看器中的特定页面：

appsFile.NavigateToPage(pageNumber)

常规

• “最大文件大小” - 用户可以上传的最大文件大小。建议的最大文件大小为 10 MB。
• “允许的文件类型” - 用户可以上传的文件类型。使用“ , ”分隔文件扩展名。例如，如果您写入.jpg, .png, .svg ，则仅允许上传这些文件类型。列出文件类型时， .符号不是必需的。
• “帮助程序文本”- 设置要在 Runtime 显示的帮助文本。
• “工具提示” - 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。
• “标签”- 控件的显示文本。
• “必需” - 如果为 True，则应用程序用户必须在控件中提供数据。要在运行时将控件标记为必需，请在标签文本后添加星号* 。
• “自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。
• 隐藏 - 如果为 true，则在 Runtime 隐藏该控件。
• “已禁用”- 如果为 True，则在 Runtime 禁用该控件。
  备注：

  • “文件选取器”控件一次只能上传一个文件。
  • 移动浏览器中的应用程序不支持上传原生基于相机的照片。 相反，请将照片保存到您的设备，然后使用“文件上传器”控件上传保存的文件。

Events

• 已添加文件- 配置添加文件时会发生的情况。
• 已删除文件- 配置删除文件时会发生的情况。

样式

• “控件对齐”- 默认情况下，继承父级对齐。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  备注：

  对齐方式取决于为父元素选择的布局（垂直与水平）。

• “标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。

• “字体” - 标签和输入文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “大小” - 控件的宽度和高度。默认情况下，大小设置为auto 。要设置最小值或最大值，请单击三点图标 (...)。

使用文件上传器

此示例说明如何将文件上传器与存储桶和实体的文件字段一起使用。

1. 在您的应用程序中，添加一个存储桶和一个具有文件字段的 Data Service 实体。
2. 添加“文件上传器”和“按钮”控件。
3. 创建一个IResource类型的变量，并将其命名为“SB_file_var”。使用此变量存储从存储桶下载的文件。
4. 将“上传文件到存储桶”规则添加到按钮控件的“已单击”事件中。
   1. 在“要上传的文件”字段中，引用通过“文件上传器”控件上传的文件，如下所示：

      MainPage.FileUploader.Value
      

   2. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
   3. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成上传。
5. 将“从存储桶下载文件”规则添加到按钮控件的“已单击”事件中。
   1. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
   2. 在“文件名（带扩展名）”字段中，写入用户应下载的文件的名称。
   3. 在“将文件分配给应用程序”变量中，引用先前创建的变量“SB_file_var”。
   4. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成下载。
6. 向应用程序添加“标签”控件。
   1. 在控件的“文本”字段中，引用已下载文件的名称，如下所示，其中“SB_file_var”是用于存储有关已下载文件的数据的变量:

      SB_file_var.Name
      

7. 运行应用程序并使用“文件上传器”控件上传文件。单击按钮。

屏幕顶部应会显示一条成功消息，通知您已成功完成上传/下载。现在，检查 Orchestrator 中的存储桶时，您应该会看到使用“文件上传器”控件上传的文件。

同时，单击按钮将“从存储桶下载文件”规则中指示的文件下载到本地设备，并将其数据存储在变量中。“标签”控件显示已下载文件的名称。

VB 属性

VB 属性	数据类型	描述
Tooltip	字符串	当用户将鼠标悬停在“文件上传器”上时，出现的信息文本。
Label	字符串	文件上传器的标签 通常是显示在控件之前的文本。
Value	IResource	当前上传的文件的名称。
Required	布尔值	指定是否必须上传文件。
RequiredErrorMessage	字符串	需要上传文件但未提供时会显示消息。
Hidden	布尔值	确定“文件上传器”控件的可见性。如果设置为“true”，则在 Runtime 隐藏该控件。
Disabled	布尔值	确定“文件上传器”控件是否可交互。如果设置为 “true”，则禁用在运行时与文件上传器的交互。
IsValid	布尔值	检查“文件上传器”值的有效性。如果为 true，则表示有效。