从电子邮件服务导入文档

您可以将电子邮箱中的附件上传到 ABBYY Vantage。您也可以选择启用对邮件正文的导入。Input 活动块允许 Vantage 访问单个邮件文件夹。 在设置并发布 Skill 后，ABBYY Vantage 将每分钟检查一次指定的邮件文件夹。每封新邮件的处理方式如下：

• 如果邮件包含附件，将为该邮件中的所有附件创建一个新的处理事务。
• 如果启用了邮件正文导入，邮件正文将转换为 HTML 格式并附加到同一处理事务中。Vantage 还会处理第一层级的嵌入邮件及其文件附件。

以下数据会保存到处理事务的注册参数中： *这些参数中仅保存电子邮件地址。不保存发件人和收件人的姓名。

Note: Vantage 不会创建空值参数。例如，如果电子邮件没有主题，则该处理事务不会包含 EmailSubject 注册参数。

源类型（MailImport）和源文件名会保存到文档注册参数 SourceType 和 SourceFileName 中。 在 Skill Monitor 的 Transactions 部分添加相应的列后，您即可查看文档和处理事务注册参数的值。它们也会导出到包含完整数据提取结果的输出 JSON 文件中，该文件可在 Output 活动的 Exported Data 部分进行配置。处理事务注册参数也可通过 Vantage API 获取。

Note: 文件名中不允许使用以下字符，上传时会被替换为下划线：/ : ? # [ ] @ ! $ & ' ( ) * + , ; = \。原始文件名将保存到文档注册参数中。您可以使用此脚本进行检索。

如果任何附件的格式不受支持，处理事务将以错误结束，并中断其中所有其他文档的处理。具体错误消息可在 Skill Monitor 的 Error log 部分查看。如果电子邮件不包含任何附件且已禁用邮件正文导入，则不会创建处理事务，但该电子邮件仍视为已处理。 已处理的电子邮件将被永久删除，或移动到用户指定的专用文件夹。您可以在设置邮箱连接时配置此行为。无法导入的电子邮件将移动到用户指定的异常文件夹中。

Note: 如果电子邮件成功导入，但随后处理事务失败，该电子邮件将被放入 Processed 文件夹。

Tip: ABBYY Vantage 在一次导入过程中最多可导入 50 封电子邮件。如果有超过 50 封新邮件，Vantage 仅导入最早的 50 封，其余将在后续的邮件导入过程中导入。导入每分钟执行一次。如果这成为性能瓶颈，建议创建两个 Skill，并分别配置各自的邮件文件夹。这样可以让两个代理同时获取文件。

如果 Vantage 无法访问导入文件夹，它会生成一个错误，您可以在 Skill Monitor 的 Error log 部分查看。

1. 在文档处理流程中左键单击 Input 活动块。若尚未在 Skill Designer 中添加，请使用 Activities 面板添加。
2. 在 Actions 面板中，勾选 Select additional source，并选择 Email。

3. 单击 Settings。在弹出的对话窗口中，选择帐户类型（Microsoft/其他帐户），然后单击 Continue。
4. 登录该帐户。

在 Microsoft 帐户登录对话框中，您可以选择当前帐户（如果您已登录）或使用其他帐户。身份验证成功后，登录对话框将关闭。

重要！ 首次登录您的 Microsoft 帐户时，ABBYY Vantage 将请求执行以下操作的权限：

• 使用工作或学校帐户登录应用。
• 访问主要电子邮件地址和基本用户资料数据。
• 即使用户未使用该应用，也可访问并更新用户详细信息。
• 访问、更新、创建和删除（但不发送）用户邮箱中的电子邮件。

提示： 如果您使用的是 Exchange 混合配置，请将邮箱从本地迁移到 Exchange Online。有关详细说明，请单击此处。

请输入您的电子邮件凭据（地址和密码）、IMAP 服务器地址和 IMAP 端口（默认 993，通常无需更改）。然后点击 Sign in。 如果 Vantage 无法连接到服务器，账户登录对话框会保持打开，且所有输入字段旁都会显示一个图标。 如果各项信息均已正确填写，连接错误可能由以下原因之一导致：

• 电子邮件服务器阻止了可疑的登录尝试。
  解决方法：检查您的邮箱。如果收到关于阻止登录尝试的邮件，请确认该尝试确为您本人发起。
• 对于禁用双重身份验证的 Google 账户：账户限制了对低安全性应用的访问。
  解决方法：允许低安全性应用访问。如有需要，确认该 Vantage 访问尝试由您发起。
• 服务器不接受当前密码，因为需要应用专用密码。
  解决方法：某些服务（如 Yahoo 和启用双重身份验证的 Google）要求第三方应用使用应用专用密码。请根据相应服务的说明生成此类密码，并在 Input 活动块的设置中填写该密码。

身份验证成功后，ABBYY Vantage 已连接的电子邮件地址会显示在 Input Settings: Email 对话框中。

5. 指定 Vantage 用于导入电子邮件的文件夹，以及用于存放未能处理的电子邮件的文件夹。不要选择在您租户内其他 Process 技能中已用作导入文件夹的文件夹。如果多个 Process 技能访问同一输入文件夹，您将无法控制由哪个技能处理电子邮件。

注意： 发布该技能后，Vantage 会在指定的导入文件夹内创建一个 VantageProcessing 文件夹。电子邮件会先被移动到此服务文件夹，然后按您的配置进行处理。

6. 选择对成功处理的电子邮件执行的操作。可以永久删除（默认）或移动到指定文件夹。若选择 Delete，必须指定一个用于存放已删除邮件的文件夹。

7. 如有需要，启用导入电子邮件正文。
8. 点击 Save 保存设置并关闭对话框。

当选中 Input 活动块时，连接到该活动的电子邮件地址会显示在 Actions 窗格中。点击 Actions 窗格中该电子邮件地址下的 Settings 可打开设置对话框，以查看并（如有需要）更改当前生效的邮件导入设置。您也可以使用该对话框退出电子邮件账户。请注意，退出账户会重置所有设置。

重要！ 对设置所做的更改仅在发布该技能后生效。

管理员可使用 Skill Monitor 服务禁用文档导入。禁用文档导入不会影响通过 API 向此 Skill 导入文档。 删除该 Skill 后，ABBYY Vantage 将停止检查指定的电子邮件文件夹。