EmailOutput 节点

使用 EmailOutput 节点向一个或多个收件人发送电子邮件。

本主题包含以下几部分：

用途

EmailOutput 节点将电子邮件消息从消息流传递到您指定的 SMTP 服务器。

您可以通过 IBM® App Connect Enterprise 工具包中的节点属性配置 EmailOutput 该节点，或从与邮件关联的本地环境和邮件输出标头（ EmailOutputHeader ）中动态配置（更多信息请参阅生成动态电子邮件 ）。 您可以配置节点 EmailOutput 以生成包含单个附件的电子邮件。 以动态方式生成电子邮件时，可以指定多个附件。

该 EmailOutput 节点位于消息流节点调色板的电子邮件抽屉中，在 IBM App Connect Enterprise 工具包中由以下图标表示：

FileOutput 节点图标

配置 EmailOutput 节点

将 EmailOutput 节点的实例放入消息流后，可以对其进行配置。 有关更多信息，请参阅 配置消息流节点。 节点的属性在“属性”视图中显示。

所有必须输入值（未定义缺省值）的必需属性用星号标记。

以下是 EmailOutput 节点的四个配置级别的描述:
  • 选项 1：通过 IBM App Connect Enterprise 工具包中的节点属性配置 EmailOutput 节点，向静态定义的收件人列表发送一封具有静态定义主题和正文的电子邮件。 同一电子邮件将发送给同一类型的收件人，并且电子邮件不附带附件。 此方法适用于需要测试节点 EmailOutput 的情况，或仅需通知功能即可满足需求的情形。 有关更多详细信息，请参阅 发送电子邮件。
  • 选项 2：此选项与选项 1 相同，但包含附件。 此选项使得电子邮件以 MIME 消息格式进行构造。 收件人的主题，文本和列表保持静态，但在运行时从传递到 EmailOutput 节点的消息中动态查找附件的内容。 消息中附件的位置以静态方式定义。 有关更多详细信息，请参阅 发送带有附件的电子邮件。
  • 选项 3：此选项使选项 1 和选项 2 中的属性可选，并在运行时被局部环境、电子邮件输出头 (EmailOutputHeader) 或消息主体中指定的值覆盖。 此选项允许动态生成电子邮件，邮件的 SMTP 服务器、收件人列表、主题、文本和多个附件均可在运行时确定。 此选项需要消息流中以前的节点来构造这些覆盖。 如果未在电子邮件主体的节点属性中指定文本值，那么将使用传递到 EmailOutput 节点的消息主体。 但是，电子邮件文本属性中设置的内容将覆盖消息体中动态生成的文本。 有关更多详细信息，请参阅 生成动态电子邮件消息。
  • 选项 4: 此选项将 MIME 消息传递到 EmailOutput 节点。 EmailOutput 节点使用 MIME 解析器将 MIME 消息写入位流。 然后，此消息将发送到 SMTP 头中的接收方列表。 传递 MIME 消息时，不会考虑局部环境覆盖项。 有关更多详细信息，请参阅 发送 MIME 消息。

电子邮件输出头

电子邮件输出头 (EmailOutputHeader) 是 Root 的子代。 这个头中指定的值将覆盖您对节点设置的等效属性。 使用 SMTP 输出头可以指定任何电子邮件属性，例如收件人。
位置 描述
Root.EmailOutputHeader.To 以逗号分隔的电子邮件地址列表。
Root.EmailOutputHeader.Cc 以逗号分隔的电子邮件地址列表。
Root.EmailOutputHeader.Bcc 以逗号分隔的电子邮件地址列表。
Root.EmailOutputHeader.From 以逗号分隔的电子邮件地址列表。
Root.EmailOutputHeader.Reply-To 以逗号分隔的电子邮件地址列表。
Root.EmailOutputHeader.Subject 电子邮件主题。
Root.EmailOutputHeader.Sender 单个电子邮件地址。 如果在 Root.EmailOutputHeader.From 字段中指定了多个电子邮件地址，那么此头是必需的。

Root.EmailOutputHeader 元素的任何其他子代都将被视为定制头，并且还将添加到外发电子邮件中。

本地环境

使用局部环境可以指定 SMTP 服务器连接信息和附件的覆盖信息。
本地环境 描述
Destination.Email.SMTPServer SMTP 服务器的“服务器:端口”。 端口可选；如果不指定，缺省值为 25。
Destination.Email.SecurityIdentity 用于向 SMTP 服务器进行认证的安全身份，可以是使用 mqsisetdbparms 命令定义的用户标识和密码对的名称，也可以引用具有 securityIdentity 属性的外部资源，该属性引用使用 mqsisetdbparms 命令定义的用户标识和密码。 在这两种情况中，该值都附加在“smtp::”字符串后面。 例如，如果使用 mqsisetdbparms 命令创建用户名和密码为 smtp::myUseridPassword 的用户名和密码，则在节点上指定或在外部资源中间接指定的 securityIdentity 为 myUseridPassword 。
Destination.Email.BodyContentType 指定电子邮件正文包含的是 HTML 而不是纯文本。 此属性可设置为文本/纯文本、文本/html 或文本/xml；文本/纯文本是缺省值。
要设置消息体的内容类型，请使用以下表示法。
SET OutputLocalEnvironment.Destination.Email.BodyContentType = 
"text/html"
另外，要设置发送消息体时所使用的字符集，请使用以下表示法。
SET OutputLocalEnvironment.Destination.Email.BodyContentType = 
"text/html; charset=utf-8"
此示例将发送使用 UTF-8 字符集的文本/HTML 电子邮件。
Destination.Email.MultiPartContentType 多重部件类型，包括相关、混合和备用。 可以在此设置任意值。
Destination.Email.Attachment.Content 这是引用了某个元素（例如，消息树或本地环境中的元素）的附件（BLOB/文本）或 XPath 或 ESQL 表达式。 引用元素的值被取用为附件的内容。
  • 如果元素是 BLOB，它是一个附件。
  • 如果元素是文本，请检查是否可以将它解析成消息树或本地环境中的另一元素。 如果可以，使用此元素。 否则，添加此元素作为附件。
Destination.Email.Attachment.ContentType 附件类型（也称因特网媒体类型），文本/纯文本、文本/html 和文本/xml。 可以在此设置任意值。
Destination.Email.Attachment.ContentName 附件名。
Destination.Email.Attachment.ContentEncoding 附件编码：7 位、基本 64 位或可引用 - 可打印。
  • 7 位是适用于 ASCII 文本的缺省值。
  • 基本 64 位适用于非 ASCII 数据，无论是非英文还是二进制数据。 这种格式很难读取。
  • 可引用 - 可打印是基本 64 位的备用编码，当大部分数据是 ASCII 编码，同时有部分数据是非 ASCII 编码时适合用此编码。 这种格式更易读；因为不对 ASCII 部分进行编码，此格式提供的编码更简洁。

连接终端

将 In 终端连接到传递出站消息绑定的节点。

将此节点的 Out 或 Failure 终端连接到该消息流的另一个节点，以进一步处理消息、处理错误或将消息发送到其他目标。

如果您将这些输出终端中的某个终端连接到消息流中的另一个节点，那么对于此节点将消息放入到的每个目标，与该消息关联的本地环境将通过以下信息进行增强：
位置 描述
WrittenDestination.Email.smtpServer SMTP 服务器的“服务器:端口”。
WrittenDestination.Email.messageId 这是电子邮件发送的消息的标识。

这些值将写入本地环境树结构内的 WrittenDestination。

如果未连接任何终端，那么局部环境树将保持不变。

终端和属性

下表描述了 EmailOutput 节点终端。

终端 描述
输入 接受节点处理的消息的输入终端。
失败 这是传播消息期间检测到故障时该消息所路由到的输出终端。 请将此节点的 Failure 终端连接到消息流中的另一个节点以处理错误。
输出 这是传播消息成功时该消息所路由到的输出终端。 请将此节点的 Out 终端连接到消息流中的另一个节点以进一步处理该消息，或者将该消息发送到另一个目标。

下表描述了此节点的属性。 标题为 M 的列指出属性是否为必需（如果未定义缺省值时您必须输入值，那么将以星号标记）；标题为 C 的列指出属性是否可配置（在部署时，将消息流添加到 BAR 文件时可以更改此值）。

下表描述了 EmailOutput 节点的 "描述" 属性。

属性 M C 缺省 描述
节点名 否 否 节点类型， EmailOutput 节点的名称。
简短描述 否 否   节点的简要描述。
详细描述 否 否   描述消息流中节点用途的文本。

下表描述了使用 EmailOutput 节点的基本属性。

属性 M C 缺省 描述 mqsiapplybaroverride 命令属性
SMTP 服务器和端口 否 是   此属性定义从此节点发出的电子邮件将到达的 SMTP 服务器和端口，其格式为 server:port；例如：my.smtp.server:25。 端口值可选，但是如果不指定端口值，其缺省值为 25。

可为此属性指定别名值。 如果运行时存在别名，将使用指定的值。 如果此别名在运行时不存在，那么集成节点将假定此值是有效的 SMTP 主机。

您还可以将此属性设置为包含连接详细信息的 SMTP 策略的名称 (请参阅 SMTP 策略)。 按 {policyProjectName}:PolicyName 格式指定策略项目和策略的名称。

 smtpServer

下表描述了 EmailOutput 节点的 "电子邮件" 属性。

属性 M C 缺省 描述
收件人地址 否 否   电子邮件的主要收件人。 此属性可以包含单个电子邮件地址，也可以包含以逗号分隔的电子邮件地址列表。
抄送地址 否 否   电子邮件的抄送收件人。 此属性可以包含单个电子邮件地址，也可以包含以逗号分隔的电子邮件地址列表。
密件抄送地址 否 否   电子邮件的密件抄送收件人。 此属性可以包含单个电子邮件地址，也可以包含以逗号分隔的电子邮件地址列表。
发件人地址 否 否   电子邮件发件人的电子邮件地址。
回复地址 否 否   电子邮件收件人进行回复的电子邮件地址。
电子邮件主题 否 否   电子邮件主题。
电子邮件文本 否 否   电子邮件的正文。 使用此属性可以提供电子邮件的静态正文。

如果使用此属性，那么它将覆盖在传递到输入节点的消息树的主体中提供的内容。 如果未指定此属性的值，那么电子邮件的文本是传递到 EmailOutput 节点的消息树的主体。
主体内容类型 否 否 文本/纯文本 使用此属性可以强制规定电子邮件主体的内容类型。 有效值为：
  • 无
  • 文本/纯文本
  • 文本/html
  • 文本/xml

下表描述了 EmailOutput 节点的 "安全性" 属性。

属性 M C 缺省 描述 mqsiapplybaroverride 命令属性
安全身份 否 是   这是一个安全标识，用于检索在集成节点运行时配置的用户标识和密码。 securityIdentity

下表描述了 EmailOutput 节点的 "附件" 属性。

属性 M C 缺省 描述
附件内容 否 否   这是引用了某个元素（例如，消息树或本地环境中的元素）的 XPath 或 ESQL 表达式。 附件的内容是所引用元素的值。
附件内容名称 否 否   电子邮件收件人看到的附件名。 此属性为可选属性。 如果不指定名称，将使用缺省值。
附件内容类型 否 否 文本/纯文本 附件类型。 此属性可选，即使已指定附件。 有效值为：
  • 文本/纯文本是纯文本。
  • 文本/html 是 HTML。
  • 文本/xml 是 XML。
  • 应用程序/八字节数据流是非文本和 HTML（二进制数据）内容的缺省类型。
附件内容编码 否 否 7bit 附件编码。 此属性为可选属性。 如果不指定值，将使用缺省编码。 有效值为：
  • 7 位是 ASCII 文本的缺省值。
  • 基本 64 位适用于非 ASCII 数据，无论是非英文还是二进制数据。
  • 可引用 - 可打印是基本 64 位编码更易读取的备用编码。 当大部分数据是 ASCII 编码，同时有部分数据是非 ASCII 编码时使用引用 - 可打印编码方式。 因为不对 ASCII 部分进行编码，此选项提供的编码更简洁。
多部分内容类型 否 否 混合 多重部件的类型。 有效值为：
  • 混合型：每个 MIME 主体部分都彼此独立。
  • 替代型：每个 MIME 主体部分都可替代其他部分。
  • 相关型：所有 MIME 主体部分都仅应视为聚集的一部分。

下表描述了 EmailOutput 节点的 "验证" 属性。

请参阅 验证属性 以获取这些属性的完整描述。

属性 M C 缺省 描述 mqsiapplybaroverride 命令属性
验证 是 是 继承 此属性控制是否进行验证。 有效值为无、内容和值、内容和继承。 validateMaster
失败操作 是 否 异常 此属性控制验证失败时采取的措施。 只有将验证设置为内容或内容和值，才可以设置此属性。 有效值为用户跟踪、本地错误日志、例外项和例外项列表。  
下表中描述了该节点的监控属性。
属性 M C 缺省 描述
事件 否 否 无 您为节点定义的事件将显示在此选项卡上。 缺省情况下，不会在消息流中的任何节点上定义任何监视事件。 使用 添加， 编辑和 删除 来创建，更改或删除节点的监视事件; 请参阅 使用监视属性配置监视事件源 以获取详细信息。

通过选中或取消选中启用复选框，可以启用或禁用此处显示的事件。