文件上传工具

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

备注：

公共应用程序不支持“文件上传器”控件。

使用 IResource

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

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

重要提示：

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

• .toLocalResource
• .toAppsFile

常规

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

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

Events

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

样式

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

  备注：

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

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

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

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

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

VB 属性

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

使用文件上传器

此示例说明如何将文件上传器与存储桶一起使用。

1. 打开现有应用程序，或创建新应用程序。
   • 添加“文件上传器”控件。
   • 选择“事件” 。在“添加的文件”中，选择“定义自动化” 。
2. 将“上传存储文件”活动添加到工作流中。
   • 指定 Orchestrator 文件夹路径和存储桶名称。
   • 在“文件”字段中，选择表达式Controls.MainPage.FileUploader.Value 。
   • 在“上传位置” 字段中，选择表达式Controls.MainPage.FileUploader.Value.FullName 。
3. 测试或运行您的应用程序。

当您运行应用程序并在文件上传器中添加文件时，应用程序会将存储文件上传到存储桶。