Email Send 端口（已弃用）

Email Send 端口通过 SMTP 邮件服务器发送邮件。

核心功能

基于 SMTP 的邮件投递，支持现代服务商的 OAuth 2.0 认证
支持模板模式，可根据 XML 数据或 Script 生成动态内容
支持附件模式，可在发送文件的同时自定义邮件正文
支持多个收件人（To、CC 和 BCC）及动态字段填充

概览

Email Send 端口连接到 SMTP 服务器，将文件作为传出电子邮件消息发送。端口处理的输入文件可以作为电子邮件附件直接发送，也可以从输入文件中解析数据，并通过脚本模板包含在传出消息中。有关创建脚本模板的更多信息，请参阅模板模式部分。

Outlook 和 Gmail 邮件服务器的 OAuth 2.0 配置是 Email Send 端口中最常见的两种连接配置。

端口配置

本节包含所有可配置的端口属性。

设置

邮件发送配置

与端口名称和描述相关的设置。

连接

与连接到 SMTP 服务器相关的设置。

设置	描述
Host	SMTP 服务器的主机名或 IP 地址。
Port	连接到 SMTP 服务器的端口。
User	登录 SMTP 服务器的用户名。
Authentication Mechanism	用于登录服务器的身份验证类型。可用选项会根据你的选择而变化。
Password	（Basic 和 NTLM）SMTP 服务器的密码。
Auth URL	（OAuth 2.0）服务的授权 URL。点击 Connect 按钮登录并授予应用程序权限时，会定向到此 URL。
Access Token URL	（OAuth 2.0）访问令牌的 URL。
Client Id	（OAuth 2.0）注册 OAuth 时分配的客户端 Id。
Client Secret	（OAuth 2.0）注册 OAuth 时分配的密钥。
Scope	（OAuth 2.0）应用程序应有权访问的作用域列表。
Callback URL	（OAuth 2.0）所连接服务返回令牌以提供访问权限的 URL。服务通常要求你将允许的 URL 加入白名单，因此在服务中配置应用程序注册时应使用此值。
None	不需要身份验证。
TLS Type	连接到服务器时用于协商 SSL/TLS 的方法：STARTTLS：先建立明文连接，然后可以通过显式命令启动 SSL/TLS。SSL/TLS：无需先建立明文连接，立即进行协商。None (Plain Text)：建立明文连接，不使用 SSL/TLS。Automatic：端口根据配置的端口号确定 TLS 类型。

消息

与传出电子邮件消息相关的设置。大多数字段可以包含来自传出文件的动态数据（有关更多信息，请参阅动态字段）。

设置	描述
To	传出电子邮件消息收件人的电子邮件地址。使用逗号分隔的列表发送给多个收件人。
Show From	展开一个字段，用于输入传出电子邮件消息发件人的电子邮件地址。端口会尝试根据传递给 SMTP 服务器的 User 凭据自动确定此字段的值。
Add Cc / Add Bcc	展开字段，用于输入要抄送（CC）或密件抄送（BCC）的电子邮件地址。使用逗号分隔的列表发送给多个收件人。
Subject	传出电子邮件消息的主题行。
Message Type	指定处理消息的方法：Attachment：将到达端口的文件作为附件发送。有关更多信息和示例，请参阅附件模式。Template：将消息正文解释为从输入文件读取值的脚本模板。有关创建脚本模板的更多信息，请参阅模板模式。

自动化

自动化设置

设置	描述
发送	指示端口在文件准备就绪时自动发送文件的开关。
Retry Interval	端口在重试失败发送之前等待的间隔。
Max Attempts	端口尝试发送消息的次数。将此值设置为 1 会指示端口仅进行初始发送尝试而不重试。每次尝试之间，端口会等待 Retry Interval 指定的时长。

性能

警报

SLA

高级页面

代理配置

高级设置

与处理相关的额外设置。

设置	描述
Allow Script in Attachment mode	当 Message Type 为 Attachment 时，勾选此项以允许在消息正文中计算 Script。
Excluded Extensions	不应由端口处理的文件扩展名列表，以逗号分隔。
Outgoing Server Public Certificate	用于验证 TLS/SSL 服务器身份的公钥证书。如果目标服务器使用 TLS/SSL，请将此字段设置为标识服务器的证书。如果服务器证书不可用，可以将此设置留空以允许底层 OS/JVM 执行证书验证，或将其设置为 `Any Certificate` 以隐式信任服务器身份。
Extension Map	逗号分隔的名称-值对列表，用于确定附件的 Content-Type 消息头值。例如，.txt=text/plain、.dat=application/edi-x12、.edi=application/edifact。注意：在输入消息中包含 Content-Type 消息头会覆盖此设置确定的内容类型。
处理延迟	放置在交易选项卡中的文件在处理前延迟的时间（以秒为单位）。这是旧版设置。最佳做法是使用 File 端口来管理本地文件系统，而不是使用此设置。

消息

日志

与日志创建和存储相关的设置。

设置	描述
Log Level	端口生成日志的详细程度。请求支持时，请将其设置为 Debug。
Log Subfolder Scheme	指示端口按所选时间间隔对 Logs 文件夹中的文件进行分组。Weekly 选项（默认值）会指示端口每周创建一个新子文件夹，并将当周所有日志存储在该文件夹中。将此设置留空表示端口将所有日志直接保存到 Logs 文件夹。对于处理大量交易的端口，使用子文件夹有助于保持日志井然有序并提升性能。
Log Messages	勾选此项可使已处理文件的日志条目包含文件本身的副本。如果禁用此选项，可能无法从 Input 或 Output 选项卡下载文件副本。

其他设置

建立连接

建立与 SMTP 服务器的网络级连接需要以下设置：

Host
Port
TLS Type

点击 Test Connection 按钮验证端口是否可以连接到服务器。建立网络级连接后，需要以下设置才能登录服务器并开始发送电子邮件：

User
Password

发送邮件

端口 系统设置 页面上的消息部分决定要发送的电子邮件消息：

如果 Message Type 设置为 Attachment，端口处理的文件将作为电子邮件附件发送，并且应在消息文本编辑器中指定消息正文。有关更多信息，请参阅附件模式。
如果 Message Type 设置为 Template，消息文本编辑器将被视为 Script 模板。在脚本模板中，可以从端口处理的文件中解析值，并将其包含在电子邮件正文中。有关更多信息，请参阅模板模式。

要在一封电子邮件中发送多个附件，需要构建一个包含所有要包含附件的批处理组，然后将该批处理组发送到 Email Send 端口进行处理。

动态字段

To、From、CC、BCC 和 Subject 字段支持来自传出文件的动态信息（例如文件名和已处理该文件的端口）。文件信息可通过 [_message] 项获得。_message 项具有一组带有 header: 前缀的属性，对应于传出文件中可用的每个消息头。这些消息头包括文件名、与在流程中处理文件相关的任何元数据，以及通过脚本提升到文件的任何自定义消息头。与任何其他 Script 项一样，_message 项和消息头属性在方括号中引用： [_message.header:headerName] 例如，可以将 Subject 设置为以下值，以包含传出文件的文件名： [_message.header:filename]

模板模式

将 Message Type 设置为 Template 会指示端口将消息正文解释为 Script 模板。模板使用简单的语法与输入文件交互，并检索要在电子邮件正文中使用的值。这些值可以与静态文本组合，生成根据端口处理的文件动态填充的标准正文格式。要使用 Template 模式，端口必须接收 XML 文件作为输入。模板只能解析 XML 文件中的信息。

基本模板

有关模板消息的示例，请考虑以下输入 XML 文档：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

此文件在 Lead 标签内包含一组属性：Company、Email、FirstName、Description。将 Email 字段传入消息的 Script 表达式如下所示： [document.lead_email] 此表达式包含三个组件：

document 项，指向当前打开的文件。
lead_email 属性，指向 john@abcinc.com。
方括号（[]），表示使用格式化器而不是文字字符。

上述 XML 输入文件的电子邮件正文模板可能如下所示：

Hi [document.lead_firstname],
<br>
We saw that you might be interested in the following product:
<br>
[document.lead_description]
<br>
Would you like to set up a demo to learn more about how we can help you with your work at [document.lead_company]?

此消息将生成以下电子邮件：

Hi John,

We saw that you might be interested in the following product:

Blue Widget

Would you like to set up a demo to learn more about how we can help you with your work at ABC, Inc.?

XPath 格式化

XPath 格式化器（在表达式中写为 xpath）提供了从文件中检索动态值的替代方法。对于已经在其他位置使用 Script 的用户来说，这种方法可能更熟悉。XPath 要求输入文件是 XML 文件。使用与上面相同的输入文件示例：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

返回电子邮件地址的 XPath 表达式如下： [xpath(/Lead/Email)] 此表达式包含三个组件：

xpath 后跟括号，表示该表达式为 XPath 表达式。
数据路径，每个级别用斜杠分隔。
方括号（[]），表示使用格式化器而不是文字字符。

在模板模式下使用 XPath 格式化器

考虑以下 XML：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

对上面的 XML 输入文件使用 xpath 表达式的电子邮件正文模板可能如下所示：

Hi [xpath(/Items/assignee)],
<br>
You have a new project to start working on. The name of the project is [xpath(/Items/projectName)].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [xpath(/Items/resources/description)]</li>
  <li>Images: [xpath(/Items/resources/images)]</li>
  <li>Colors: [xpath(/Items/resources/colors)]</li>
</ul>
<br>
The due date for this project is [xpath(/Items/dueDate)].

此消息将生成以下电子邮件：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

代码视图编辑器

代码视图编辑器支持创建自定义 Script，以对来自 XML 文件的信息进行高级处理。要打开代码视图编辑器，请点击消息编辑器中的 Code View 按钮。

在此模式下，Script 表达式可用于一次处理多个数据条目。以下输入文件示例包含名称列表：

<record>
  <to>Dave</to>
  <items>
    <item>
      <first_name>James</first_name>
      <last_name>Satchel</last_name>
    </item>
    <item>
      <first_name>John</first_name>
      <last_name>Smith</last_name>
    </item>
    <item>
      <first_name>Gina</first_name>
      <last_name>Newberry</last_name>
    </item>
  </items>
</record>

在代码视图编辑器中编写的以下消息使用 Script 合并了来自该输入文件的数据：

Hi [document.record_to],
<br>
Here are the people you were asking about:
<br>
<arc:set attr="xml.xpath" value="/record/items/item" />
<arc:call op="xmlDOMSearch" in="xml">
  <arc:set attr="first.names" value="[xpath(first_name)]" />
  <arc:set attr="last.names" value="[xpath(last_name)]" />
  <arc:enum attr="first.names">
    [_value]
  </arc:enum>
  <arc:enum attr="last.names">
    [_value]
  </arc:enum>
  <br>
</arc:call>

此代码会循环输入 XML 文件中的所有名字和姓氏值，并将它们打印在消息正文中。使用上面的输入文件运行时，最终电子邮件如下所示：

Hi Dave,

Here are the people you were asking about:

James Satchel
John Smith
Gina Newberry

附件模式

如果将 Message Type 设置为 Attachment，请在编辑器中输入电子邮件正文。如有必要，可以引用输入消息上的消息头来丰富电子邮件正文。然后，Email Send 端口会计算这些消息头，并将输入文件附加到传出电子邮件。

This relies on a previous step in the flow to promote the necessary values as headers onto the message. Depending on the content of the file, you can do this with various Operations and connector settings.

考虑以下 XML：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

电子邮件正文可能如下所示：

Hi [_message.header:assignee],
<br>
You have a new project to start working on. The name of the project is [_message.header:projectname].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [_message.header:description]</li>
  <li>Images: [_message.header:images]</li>
  <li>Colors: [_message.header:colors]</li>
</ul>
<br>
The due date for this project is [_message.header:duedate].

此消息将生成以下电子邮件，并包含输入文件作为附件：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

入门指南

工作流

EDI 交易伙伴管理控制台

端口

映射

操作指南

脚本编写

软件许可和第三方版权

Email Send 端口（已弃用）

核心功能

概览

端口配置

设置

邮件发送配置

连接

消息

自动化

自动化设置

性能

警报

SLA

高级页面

代理配置

高级设置

消息

日志

其他设置

建立连接

发送邮件

动态字段

模板模式

基本模板

XPath 格式化

在模板模式下使用 XPath 格式化器

代码视图编辑器

附件模式

​核心功能

​概览

​端口配置

​设置

​邮件发送配置

​连接

​消息

​自动化

​自动化设置

​性能

​警报

​SLA

​高级页面

​代理配置

​高级设置

​消息

​日志

​其他设置

​建立连接

​发送邮件

​动态字段

​模板模式

​基本模板

​XPath 格式化

在模板模式下使用 XPath 格式化器

​代码视图编辑器

​附件模式

核心功能

概览

端口配置

设置

邮件发送配置

连接

消息

自动化

自动化设置

性能

警报

SLA

高级页面

代理配置

高级设置

消息

日志

其他设置

建立连接

发送邮件

动态字段

模板模式

基本模板

XPath 格式化

代码视图编辑器

附件模式