在表单操作中嵌入对象

您可以将表单操作设计为显示图像或 PDF 文件，使用徽标和图标简单地自定义外观，或者提供可帮助 Action Center 用户完成操作的材料。

此功能仅适用于“ 创建表单任务” 活动。

要嵌入对象，您可以使用“ 创建表单任务” 活动的“存储”部分下的属性来链接到 存储桶 ，并使用“ 上传存储文件 ”活动来添加文件。

您可以嵌入存储桶支持的任何类型的对象。

下面的视频显示了嵌入的 PDF 文件在 Action Center 中的行为方式：

先决条件

要使用在表单操作中嵌入对象的功能，用户需要以下权限：

用户类型	权限
Action Center 用户	此用户需要以下文件夹级别的权限：“ 存储桶 ”的“查看”权限和 “ 存储文件”的“查看”权限。
机器人 用户	此用户需要以下文件夹级别的权限：存储桶的“ 查看” 和“ 编辑 ”以及“ 存储文件”的 “查看 和 创建 ”。

嵌入存储桶中的图像

为了让 Actions Center 用户体验更好的性能，我们建议您嵌入以前上传到 存储桶的图像。

要在表单操作中嵌入图像，请执行以下操作：

1. 使用“ 上传存储文件 ”活动等活动将图像上传到“ 创建表单任务” 活动使用的存储桶。 在此步骤中，创建一个 String 变量来存储文件上传的路径，例如 imagePath。
   重要提示： 存储桶上传会将 + 符号转换为空格，这可能会导致表单呈现期间出错。
2. 在“ 创建表单任务” 活动中，单击“表单数据” 右侧的 省略号 (...)，然后添加一个以 _storage 关键字作为后缀的参数：
   • 名称: image_storage。
   • 方向： 在中。
   • 类型： 字符串。
   • 值: imagePath。
   注意： _storage 关键字用于指示这是一个可在活动的存储桶中使用的对象。 对于该值，我们添加了用于存储已上传图像路径的变量。
   提示: 对于小于 2 KB 的图像，例如徽标或图标，您可以跳过此步骤。 在使用 image_storage 参数的以下步骤中，请改用 imagePath 变量。
3. 添加 HTML 元素 组件并进行如下配置：
   • HTML 标记: div。
   • 内容: <img src="{{ data.image_storage }}" />。 这会将存储文件参数映射到表单组件。 使用 <img> 标签可在表单中显示图像。 或者，您可以使用 <a src="{{ data.image_storage }}" target=_blank> 添加在新窗口中打开图像的链接。
   • 更改时刷新: 已选中。
   注意： 您可以通过在 <a href="https://link-to-file"></a> 标签中引用特定文件的链接来添加指向特定文件的链接。 您可以忽略“ 内容 ” 字段中显示的任何验证错误，它们不会影响运行时的表单呈现。

重要: 表单操作不支持 TIFF 文件。 或者，请尝试以下操作：

• 在您正在使用的工作流中使用自定义活动，将 TIFF 文件转换为 JPEG 或 PNG ，然后再将其上传到存储桶。
• 使用 <href> 标签引用存储桶中的文件。

示例工作流

要按照本教程的步骤操作并自行尝试，请下载示例工作流。

从存储桶嵌入 PDF 文件

常规表单与高级表单嵌入存储桶中 PDF 文件的方式不同。 高级表单可提供改进的呈现性能以及组件及其逻辑的高级用法。 您可以通过在“ 创建表单任务” 活动中选择 “启用高级表单 ”来创建高级表单。

常规表单

您还可以将已上传到存储桶的 PDF 文件添加到表单操作中，以便 Action Center 用户可以对其进行审核。

要在常规表单任务中嵌入 PDF，请执行以下操作：

1. 使用“ 上传存储文件 ”活动等活动将 PDF 文件上传到“ 创建表单任务” 活动使用的存储桶。 在此步骤中，创建一个 String 变量来存储文件上传的路径，例如 docPath。
2. 在“ 创建表单任务” 活动中，单击“表单数据” 右侧的 省略号 (...)，然后添加一个以 _storage 关键字作为后缀的参数：
   • 名称: doc_storage。
   • 方向： 在中。
   • 类型： 字符串。
   • 值: docPath。
     重要提示： _storage 关键字用于指示这是在活动的存储桶中可用的对象。 对于该值，我们添加了用于存储已上传 PDF 文件路径的变量。

3. 将 HTML 元素 组件添加到表单中，并指定以下内容：

   • HTML 标记: div。
   • 内容: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>。
   • 更改时刷新：已清除。
4. 保存更改并关闭组件窗口，以返回“ 表单设计器 ”窗口。
5. 单击“编辑 JSON ” HTML 元素的图标。
6. 在“ 组件 JSON” 下，搜索 "refreshOn" 并将其值设置为表单数据属性，以便拥有 "refreshOn": "doc_storage"。
7. 确保为 _storage 字段自动生成的文本在表单中可用。 可以将其标记为隐藏字段。
   重要提示：如果使用UiPath.FormActivitiyLibrary v1.1.10 ， 请注意，“组件 JSON ”没有列出"refreshOn"选项。 但是，您可以按照上述手动添加"refreshOn"键并设置其值。

请在此处下载此示例。

高级表单

要在高级表单任务中嵌入 PDF，请执行以下操作：

1. 使用“上传存储文件”活动等活动，将 PDF 文件上传到“创建表单任务”活动使用的存储桶。 在“ 上传存储文件 ” 活动的“路径” 字段中指定文件的 路径 。在此示例中，输入sample.pdf 。
2. 在“创建表单任务”活动中，单击“表单数据” 右侧的省略号( ... )，然后添加具有以下配置的参数：
   • 键： pdf 。
   • 方向： 在中。
   • 类型： 字符串。
   • 值: "sample.pdf"。
3. 将PDF组件添加到表单中，并将先前添加的参数的名称指定为“属性名称” 。 在此示例中，指定pdf 。
4. 保存更改并关闭组件窗口，以返回“ 表单设计器 ”窗口。

请在此处下载此示例。