“获取电子邮件”活动

获取电子邮件活动是一个启动方活动。在将以获取电子邮件活动开始的编排部署到 Integration Appliance 中之后,Integration Appliance 会按指定时间间隔轮询 POP3 服务器以获取指定帐户的电子邮件消息。

注: Get Email 活动要求 POP3 服务器支持 TOP 和 UIDL 命令。虽然这些命令是 POP3 协议中的可选项,但大多数服务器还是支持它们。

所轮询的 POP3 服务器和电子邮件帐户在与获取电子邮件活动关联的电子邮件端点中进行了定义。

在运行时期间,获取电子邮件活动轮询 POP3 服务器以获取特定电子邮件帐户的传入电子邮件消息,如下图中所示。

图 1.

如果找到任何电子邮件消息,那么将对各个电子邮件消息执行以下操作:针对传入邮件消息的主题检查为主题字段定义的正则表达式,并针对传入电子邮件消息的发送方电子邮件帐户检查为发件人字段定义的正则表达式。如果两个正则表达式匹配,那么将创建编排作业以处理电子邮件,并会在 POP3 服务器上标记该邮件以便删除。此过程完成后,将从 POP3 服务器中删除该电子邮件。有关正则表达式匹配的更多信息,请参阅配置活动过程。
注: 两个获取电子邮件活动不应同时使用同一电子邮件帐户从同一 POP3 服务器进行轮询,即使在活动的配置任务中指定的正则表达式不同也如此。如果两个获取电子邮件活动是尝试使用同一电子邮件帐户来获取电子邮件,那么当第一个获取电子邮件活动处理来自 POP3 服务器的电子邮件并从服务器中除去电子邮件时,第二个获取电子邮件活动会保持重试检索来自 POP3 服务器的电子邮件,并且可能会抛出以下异常:
Protocol exception: com.jscape.inet.pop.PopException: Error in TOP 671 0: -ERR The requested message is no longer available; it may have been deleted.

访问电子邮件消息附件

要访问传入电子邮件消息的附件,您必须在编排中的获取电子邮件活动之后添加读取 MIME 活动,如上图所示。此外,还必须将获取电子邮件活动的两个输出参数映射至编排中的变量,然后再将这些变量映射至读取 MIME 活动的输入参数。在运行时期间,读取 MIME 活动会读取消息的 MIME 头和主体,然后分解消息主体中所含的附件并将结果放置到 XML 输出参数部分中。有关更多信息,请参阅读 MIME 活动。

向编排中添加“获取电子邮件”活动

  1. 创建或打开编排。这样会以图形形式显示编排。
  2. 选择活动选项卡并展开“电子邮件”文件夹。
  3. 获取电子邮件活动拖至编排上。
  4. 选择该活动。这样会显示核对表

创建、选择或编辑电子邮件端点

  1. 单击核对表中的选取端点任务,然后选择下列操作之一:
    • 选择现有端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定。完成配置活动步骤。
    • 选择现有端点并编辑该端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定
      3. 单击编辑。这样会显示编辑端点窗格。
    • 创建新端点:选择新建。这样会显示创建端点窗格。
  2. 创建或编辑电子邮件端点。有关更多信息,请参阅创建或编辑电子邮件端点

配置活动

  1. 核对表中选择配置任务。这样会显示配置窗格。
  2. 配置此窗格中的所有字段,如下表所述。在此任务中,您可以指定用于匹配所轮询电子邮件消息的主题发件人字段的正则表达式。必须为这两个字段指定正则表达式;即使正则表达式等于 *(意味着所有字符串都匹配),也是如此。为了处理传入邮件,邮件的主题发件人字符串必须与其相应的正则表达式匹配。在各个正则表达式字段中,下列通配符都是受支持的:
    • *(星号)- 代表零个或多个字符
    • ? (问号)- 表示零个或一个字符
    表 1.
    字段 描述
    主题匹配 输入与电子邮件消息主题匹配的正则表达式,以启动可处理电子邮件消息的编排作业。在正则表达式中,可以指定字符和通配符的组合。
    发件人匹配 输入用于定义电子邮件消息发送方电子邮件地址的正则表达式,以启动可处理电子邮件消息的编排作业。在正则表达式中,可以指定字符和通配符的组合。
    下表显示了一些示例正则表达式以及这些正则表达式与样本文本的匹配结果。
    表 2.
    正则表达式 样本文本 结果
    *test* test 匹配
    *test* ttttesttt 匹配
    test test 匹配
    test ttttesttt 不匹配,必须与正则表达式字符串 test 精确匹配
    test est 不匹配,必须与正则表达式字符串 test 精确匹配
    ?est test 匹配
    ?est best 匹配
    ?est est 匹配

指定交付规则

  1. 核对表中选择交付规则任务。这样会显示交付规则窗格。
  2. 指定用于轮询 POP3 服务器以获取新电子邮件消息的时间间隔:
    1. 从菜单中选择时间单位:秒、分钟、小时或天。
    2. 使用下列输入选项之一来指定时间量:
      • 通过在轮询更改时间间隔字段中单击并输入新值。
      • 使用向上和向下箭头。
有关更多信息,请参阅轮询时间间隔行为

指定重试选项

  1. 核对表中选择重试任务。这样会显示重试窗格。
  2. 配置用于连接 POP3 服务器的重试选项。下表定义了用于连接 POP3 服务器的重试选项:
    表 3.
    字段 描述
    重试  
    1) 在前后两次重试之间等待 __ 秒。 指定 Integration Appliance 在尝试与 POP3 服务器建立连接之前等待的秒数。
    2) 尝试连接 __ 次后失败。 指定重试计数 - Integration Appliance 在发出错误之前尝试与 POP3 服务器建立连接的最大次数。

    如果已部署以获取电子邮件活动开始的编排,并且 Integration Appliance 无法连接到指定的 POP3 服务器,那么 Integration Appliance 会在系统日志中将连接错误记录为警告,直至达到重试计数值。在达到了重试计数时,Integration Appliance 会在系统日志中记录错误,将连接错误计数重置为零,并且继续尝试与 POP3 服务器建立连接。

    例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误并将连接错误计数重置为零。因此,第五个连接错误会在系统日志中生成警告。Integration Appliance 会继续尝试与 POP3 服务器建立连接。

映射活动的输出

  1. 核对表中选择映射输出任务。活动的输出参数会显示在自活动窗格中。
  2. 在此任务中,将 mailheader(XML 类型)和 body(字符串类型)输出参数映射到变量。您必须映射活动的输出参数,以使编排成为有效编排。 请参阅创建映射,以获取与映射有关的常规指示信息。mailheader 输出参数包含有关电子邮件消息的元数据信息,例如:消息要发送到的电子邮件地址以及消息本身的 MIME 头。body 输出参数包含电子邮件消息的主体以及关联的附件。
    警告:
    附件和主体在主体输出中的顺序取决于发送消息的电子邮件客户机以及消息的类型(纯文本或 HTML)。.
注: 使用非英语有效内容时,mailheadermimeHeaderotherheaders 需要映射到编排内的 getEmail 活动中,并且从编排映射回 sendMail 活动中。