为电子邮件导入设置 Google Mail (OAuth)

您可以将导入处理器配置为使用 Google Mail OAuth 将附加到传入电子邮件的文件以及电子邮件元素（如主题和正文文本）导入 Content Capture 中。每个导入的电子邮件都成为一个批处理，其中的电子邮件元素（如附件、邮件正文）或整个电子邮件作为批处理中的单独文档创建。

以下是设置 Google (OAuth) 电子邮件导入需要执行的操作：

获取用于创建 Google Mail 应用程序的重定向 URL

为了能够配置 Google Mail 应用程序，您需要您想连接到的 Oracle Content Management 实例的 Content Capture 主机名和授权 URL 详细信息。

要获得重定向 URL，请执行以下操作：

  1. 以管理员身份登录到 Oracle Content Management，然后转到 Content Capture。
  2. 打开您的过程并转至捕获选项卡。

  3. 在导入处理器作业表中，单击 添加导入处理器作业 创建新作业。

  4. 在“一般设置”页上：
    1. 在导入作业名字段中输入名称，在批处理前缀字段中输入前缀。导入的批处理会使用此前缀进行命名，后跟一个随每个新批处理递增的数字。
    2. 在导入源字段中，确保选择电子邮件源。
  5. 在“导入源设置”页上的连接协议部分中，选择 Google Mail (OAuth)。

    此时将显示重定向 URL。复制此 URL，其格式为 https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization。您的 URL 可能包含端口，也可能不包含端口。如果没有端口，该 URL 将采用以下格式：https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    注：

    请不要提交您的输入或离开此页。创建 Google Mail 应用程序并获得客户端 ID 和客户端密钥后，需要返回此页以配置 Google Mail OAuth。您将在“客户端 ID”和“客户端密钥”字段中输入该客户端 ID 和客户端密钥。

为电子邮件导入设置 Google Mail 应用程序

要配置 Google Mail 应用程序，请执行以下操作：

  1. 在另一个浏览器窗口中转至 Google API 控制台。
  2. 在 Manage resources 页上，如果您已经在 Google 开发人员控制台中创建了项目，则会看到它们的列表。如果尚未执行此操作，请执行以下操作：
    1. 单击 CREATE PROJECT。
    2. 在 Project name 中输入项目名称。
    3. 为了帮助您轻松地在控制台中标识您的项目，请通过单击 EDIT 并输入有意义的 ID 来编辑 Project ID。
    4. 如果您定义了任何组织资源或文件夹，则需要选择一个位置。如果未定义，则接受默认值并单击 CREATE。

      此时将创建您的项目，您将重定向到控制台中您的项目列表。

  3. 单击左上角的 Google 开发人员导航图标，依次选择 APIs & Services 和 Dashboard。

    注：

    如果您不是在查看最近创建的项目的仪表盘，请从左上角的下拉列表中选择您的项目。
  4. 在左侧子工具栏中，单击 Library 以转至 API Library 页。然后搜索 Gmail API 库并启用它。
  5. 单击左上角的 Google 开发人员导航图标，依次选择 APIs & Services 和 OAuth consent screen。在 "OAuth consent screen" 上选择您的目标用户，然后单击 CREATE。
  6. 在 "Edit app registration" 页上的 OAuth consent screen 选项卡上：
    • 在 App name 字段中，输入您的产品名称，例如 Gmail App。
    • 在 User support email 下拉列表中，选择您用于用户支持的电子邮件地址。
    • 向下滚动到 Developer contact information 部分，在 Email addresses 字段中，输入您的电子邮件地址。
    • 单击 SAVE AND CONTINUE。
  7. 在 Scopes 选项卡上：
    1. 单击 ADD OR REMOVE SCOPES。
    2. 在 Update selected scopes 部分中，选中以下 GMail API 范围的复选框，或者在 Manually add scopes 框中手动输入这些范围并单击 ADD TO TABLE。然后单击 UPDATE。
    3. 单击 SAVE AND CONTINUE。

      userinfo.email 和 userinfo.profile 范围显示在 Scopes 选项卡上的 Your non-sensitive scopes 部分中，gmail.modify 范围显示在 Your restricted scopes 部分中。

  8. 在 Test users 选项卡上，单击 SAVE AND CONTINUE。
  9. 在 Summary 选项卡上，您可以查看您的设置，然后单击 BACK TO DASHBOARD。
  10. 在 Publishing Status 下，在 Testing 部分中，单击 PUBLISH APP，然后在 Push to production? 对话框中，单击 CONFIRM 以发布应用程序。
  11. 在左侧子工具栏上，单击 Credentials，然后执行以下操作：
    1. 在 Credentials 页上，单击 CREATE CREDENTIALS，然后选择 OAuth client ID。
    2. 在 Application type 下拉列表中，选择 Web application。
    3. 命名该客户端，例如 Gmail OAuth App Client。
    4. 在 Authorized redirect URIs 中，单击 ADD URI 并粘贴您从 Content Capture 过程中复制的重定向 URL。
    5. 在 Authorized JavaScript origins 中，单击 ADD URI 并粘贴重定向 URL，但删除域后面或端口后面（如果您的 URI 包括端口）的所有内容。
    6. 单击 CREATE。

      您的客户端 ID 和客户端密钥值显示在 OAuth client created 对话框中。记下这些值，然后单击 OK。

      现在返回 Oracle Content Management 中的 Content Capture 实例并从您离开的地方开始。即，首先输入客户端 ID 和密钥来配置 Google Mail OAuth。

配置 Google Mail OAuth 以捕获电子邮件导入

要配置 Google Mail OAuth 电子邮件导入处理器作业设置，请执行以下操作：

  1. 返回捕获过程并从您离开的地方开始。
  2. 在电子邮件账户选项卡上，您选择了 Google Mail (OAuth) 连接协议。现在，在客户端 ID 和客户端密钥字段中输入您在配置您的 Google Mail 应用程序时复制的客户端 ID 和密钥。

  3. 在要处理的电子邮件账户表中，单击 添加电子邮件账户。

  4. 要为电子邮件处理器作业提供对电子邮件账户的访问权限，在 Google Mail 登录页上，输入您要使用的电子邮件 ID 的电子邮件地址和密码。

  5. 单击允许确认您的选择。

    电子邮件 ID 显示在要处理的电子邮件账户表中的电子邮件地址列下。其状态应为已验证。

    您可以按照之前的步骤在此表中添加更多 Google Mail ID。要删除某个电子邮件 ID，请在表中选择该电子邮件 ID 所在行，然后单击 删除电子邮件 ID。

  6. 在邮件筛选器选项卡上，指定在何处以及如何搜索电子邮件和/或附件。

    1. 在要处理的文件夹字段中，输入一个或多个文件夹以在指定的电子邮件账户中进行搜索。默认值为该服务器的收件箱。要指定多个文件夹，请使用 ;（分号）分隔它们。要指定子文件夹，需在文件夹/子文件夹中添加适用于邮件服务器的路径分隔符，例如 /（正斜杠）。

    2. 默认情况下，除非将邮件过滤器应用于作业，否则 Content Capture 会处理指定文件夹中的所有电子邮件。也可以在邮件筛选器表中，为每个要搜索的电子邮件元素选择已启用字段，然后在字段包含字段中输入要查找的字符。

      例如，要搜索主题或邮件正文中包含 payment 一词的电子邮件，您可以为两个搜索字段选择已启用，在每个字段包含条目中输入 payment，然后选择或搜索运算符。

    3. 在搜索运算符字段中，选择要用于指定邮件筛选器的搜索运算符：与（默认）仅在所有搜索条件都匹配时才会导入，而或在匹配任一搜索条件时就会导入。

  7. 在处理选项卡上，指定如何处理电子邮件及其附件。您可以根据电子邮件优先级，指定要包括的信息以及要分配给批处理的优先级。

    1. 在电子邮件选项下，指定是否应导入邮件正文文件。指定其导入格式（文本或 EML）、在不存在附件时是否应将其包括在内，以及是否应将整封电子邮件（包括附件）作为 EML 文件导入。

    2. 在包括与这些掩码匹配的附件字段中，根据附件文件的掩码指定附件文件。可以输入多个文件掩码，用逗号或分号分隔。例如，您可能包括所有 PDF 文件 (*.pdf)。

    3. 在排除与这些掩码匹配的附件字段中，根据附件文件的掩码指定要排除的附件文件。可以输入多个文件掩码，用逗号或分号分隔。

    4. 也可以选择当附件不匹配掩码时始终执行后处理、包括与这些掩码匹配的附件和排除与这些掩码匹配的附件。如果启用了此字段，并且附件不匹配指定的掩码，则将电子邮件导入视为失败，并按照您在后处理选项卡中的导入失败时字段下指定的设置进行后处理。

      注：

      当一起启用了导入邮件正文文件和当附件不存在时包括字段时，会禁用当附件不匹配掩码时始终执行后处理字段。

    5. 在文档排序下，指定将电子邮件中的元素（例如，邮件正文和附件）作为导入批处理中的文档进行排序时的顺序。

    6. 在包含在批处理注释中下，选择邮件元素（例如，接收日期/时间、发件人地址、收件人地址、主题和邮件正文）。

    7. 在批处理优先级下，可以根据电子邮件优先级（低、普通或高）为每个新的批处理分配优先级。例如，在高字段中输入 8 可以为 Content Capture 中的高优先级电子邮件分配批处理优先级 8。将没有分配优先级的电子邮件视为普通优先级。

  8. 在后处理选项卡上，指定在导入成功或失败之后电子邮件会出现的情况。您可以删除邮件、将其移动到电子邮件账户内的指定文件夹，也可以在导入失败的情况下防止邮件被删除。例如，如果作业定期运行，则可以通过将导入的电子邮件移动到指定的文件夹中，防止已成功导入的电子邮件再次导入。

  9. 按照添加或编辑导入处理器作业中所述完成其他导入处理器作业页。

现在，您可以测试电子邮件导入作业。导入处理器会检查配置的电子邮件账户中是否有邮件，并在文件夹中搜索匹配的电子邮件。如果找到匹配的电子邮件，导入处理器则会为从电子邮件导入的每个文档创建一个 Content Capture 批处理和一个文档。导入处理器也可以使用电子邮件元数据填充元数据字段，并删除已成功导入的邮件，或者将其移动到文件夹中。

Content Capture 会定期从您在电子邮件账户选项卡上配置的电子邮件账户中提取电子邮件。但是，如果要在特定时间触发电子邮件导入，则在导入处理器作业表中选择一个电子邮件导入作业，然后单击 检查电子邮件 图标。如果您的电子邮件导入作业处于脱机状态，则此图标会被禁用。