电子邮件端点使用户能够通过向指定的电子邮件帐户发送一个或多个文档(作为电子邮件附件)来调用服务。 电子邮件收件箱充当附件的收集点。 该服务监视收件箱并处理附件。 转换结果将转发到端点中定义的用户。
对于电子邮件端点,授权用户可以通过通过电子邮件将文件发送到相应的帐户来调用进程。 结果将返回给提交用户(默认情况下)或端点设置中定义的用户。
在配置电子邮件端点之前,请创建供端点使用的POP3或IMAP电子邮件帐户。 为每种类型的转换分别设置一个帐户。 例如,一个帐户可以配置为从传入文件附件生成标准PDF文档,而另一个帐户可以配置为生成安全PDF文档。
每个电子邮件地址必须仅映射到一个电子邮件端点。 您不能将多个电子邮件端点配置为单个电子邮件地址,即使其他电子邮件端点被禁用也是如此。
所有电子邮件端点都配置了电子邮件收件箱的授权用户名和密码,这是调用服务时必需的。 电子邮件帐户受其配置的邮件服务器系统的保护。
如果用户发送的文件名和转换路径名中包含西欧语言字符的文档,则必须使用支持所需编码类型的电子邮件应用程序(Latin1 [ISO-8859-1],西欧 [Windows],或UTF-8)。 欲了解更多信息,请参见 安装和部署AEM Forms 应用程序服务器的文档。
在配置电子邮件端点之前,请配置电子邮件服务。 (请参阅 配置默认电子邮件端点设置.) 电子邮件服务的配置参数有两个用途:
您可以将POP3、IMAP或SMTP配置为对电子邮件端点使用安全套接字层(SSL)。
在电子邮件服务器上,根据制造商的文档为POP3、IMAP或SMTP启用SSL。
从电子邮件服务器导出客户端证书。
使用keytool程序将客户端证书文件导入到应用程序服务器的Java虚拟机(JVM)证书存储区。 此步骤的过程将取决于JVM和客户端安装路径。
例如,如果在Microsoft Windows Server® 2003上使用JDK 1.5.0的默认OracleWebLogic Server安装,请在命令提示符下键入以下文本:
keytool -import -file client_certificate -alias myalias -keystore BEA_HOME\jdk150_04\jre\security\cacerts
出现提示时,输入密码(对于Java,默认密码为 changeit
)。 您将收到一条消息,说明证书已成功导入。
使用管理控制台将电子邮件端点添加到服务。
在管理控制台中创建电子邮件端点。 配置端点设置时,为传入消息选择POP3/IMAP SSL已启用,为传出消息选择SMTP SSL已启用,并相应地更改端口属性。
提示:如果您在使用SSL时遇到问题,请使用电子邮件客户端(如Microsoft Outlook)检查它是否可以使用SSL访问电子邮件服务器。 如果电子邮件客户端无法访问电子邮件服务器,则此问题与证书或电子邮件服务器的配置有关。
可以使用“服务管理”页配置所有电子邮件端点的通用属性,并提供所有电子邮件端点的默认值。
要使表单工作流接收和处理来自用户的传入电子邮件,您需要为Complete Task服务创建电子邮件端点。 此电子邮件端点需要其他设置,如中所述 为完成任务服务创建电子邮件端点.
Cron表达式: Quartz用来安排对输入目录进行轮询的cron表达式。
重复间隔: 重复目录轮询的次数。 如果未在终结点配置中指定此值,则默认重复间隔为秒。 默认值为 10。此值不能小于10。
重复计数: 轮询输入目录的次数。 如果未在终结点配置中指定此值,则使用默认重复计数。 值为–1表示无限扫描目录。 缺省值为–1。
作业开始时的延迟: 作业开始扫描端点之前的延迟的默认值(以秒为单位)。 默认值为 0。
批次大小: 每次扫描接收者为获得最佳性能而处理的电子邮件数量。 值为–1表示所有电子邮件。 默认值为 2。
异步: 将调用类型标识为异步或同步。 只能同步调用瞬态和同步进程。 默认值为asynchronous。
域模式: 用于过滤传入电子邮件的域名模式。 例如,如果使用adobe.com,则只会处理来自adobe.com的电子邮件;而忽略来自其他域的电子邮件。
文件模式: 提供程序接受的传入文件附件模式。 这包括具有特定扩展名(*.dat、*.xml)、特定名称(数据)以及名称和扩展名()中的复合表达式的文件。[dD][aA]'端口')。 缺省值为*。*。
成功作业的收件人: 一个或多个电子邮件地址,用于发送电子邮件以指示成功的作业。 默认情况下,始终向初始作业的发送者发送成功的作业消息。 支持最多100个收件人。 要关闭此设置,请将此字段留空。
失败的作业的收件人: 一个或多个电子邮件地址,用于发送电子邮件以指示失败的作业。 默认情况下,始终将失败的工作消息发送给发送初始工作的发送者。 支持最多100个收件人。 要关闭此设置,请将此字段留空。
收件箱主机: 要扫描的电子邮件提供程序的收件箱主机名或IP地址。
收件箱端口: 电子邮件提供商要扫描的收件箱端口号。 如果该值为0,将使用默认的IMAP或POP3端口。
收件箱协议: 用于扫描收件箱的电子邮件端点的电子邮件协议。 选项为IMAP或POP3。 收件箱主机邮件服务器必须支持这些协议。
收件箱超时: 指定在尝试连接到收件箱时,终结点在取消之前等待的时间。 如果在达到超时值之前未获得连接,则不会轮询收件箱。
收件箱用户: 登录电子邮件帐户所需的用户名。 根据电子邮件服务器和配置,此名称可能只是电子邮件的用户名部分,也可能是完整的电子邮件地址。
收件箱密码: 收件箱用户的密码。
POP3/IMAP SSL已启用: 选中后,将启用SSL。
SMTP主机: 电子邮件提供商用于发送结果和错误消息的邮件服务器的主机名。 例如,mail.example.com。
SMTP端口: 用于连接到邮件服务器的端口。 默认值为 25。
SMTP用户: 电子邮件提供商在发送有关结果和错误的电子邮件时使用的用户帐户。
SMTP密码: SMTP帐户的密码。 某些邮件服务器不需要SMTP密码。
发送自: 用于发送结果和错误的电子邮件通知的电子邮件地址(例如,user@company.com)。 如果未指定“发送自”值,则电子邮件服务器会尝试通过将“SMTP用户”设置中指定的值与在电子邮件服务器上配置的默认域结合来确定电子邮件地址。 如果您的电子邮件服务器没有默认域,并且您没有指定“发送自”的值,则可能会发生错误。 为确保电子邮件的发件人地址正确,请为“发件人”设置指定一个值。
已启用SMTP SSL: 选中后,将启用SMTP上的SSL。
将原始电子邮件正文作为附件包含: 默认情况下,当您将电子邮件发送到表单服务器时,消息的原始文本将包含在消息正文中。 要改为将文本包含为附件,请选择此选项。
对结果电子邮件使用原始主题行: 默认情况下,发送结果电子邮件时,Forms服务器使用成功电子邮件主题和错误电子邮件主题设置中指定的值作为主题行。 若要改用与发送到服务器的原始电子邮件相同的主题行,请选择此选项。
成功电子邮件主题: 向电子邮件端点发送电子邮件以启动或继续流程后,您将从AEM表单服务器收到一封返回电子邮件。 如果电子邮件成功,您将收到一封成功电子邮件。 如果电子邮件失败,您将收到一封失败电子邮件,通知其失败原因。 此设置允许您指定为此端点发送的成功电子邮件的主题行。
成功电子邮件正文: 允许您指定为此端点发送的成功电子邮件的正文文本。
错误电子邮件主题前缀: 允许您指定为此端点发送的失败电子邮件主题行开头使用的文本。
错误电子邮件主题: 使您可指定为此端点发送的失败电子邮件的主题行。 此文本显示在错误电子邮件主题前缀之后。
错误电子邮件正文: 允许您指定为此端点发送的失败电子邮件正文的第一行。
电子邮件摘要信息: 每条成功或失败消息都包含一个部分,其中包含您发送到表单服务器的原始电子邮件文本。 此设置指定该部分上方显示的文本。
在创建/更新此端点之前验证收件箱: 选择此选项时,表单服务器会在创建端点之前检查SMTP/POP3设置是否正确。 单击“添加”后,将显示一条消息,说明收件箱帐户是否有效。 如果未选择此选项,则AEM Forms服务器将在不验证收件箱的情况下创建端点。
字符集编码: 用于电子邮件的编码格式。 默认值为UTF-8,日本以外的大多数用户都将使用该格式。 日本环境中的用户可选择ISO2022-JP。
电子邮件发送文件夹失败: 指定在SMTP邮件服务器不工作时用于存储结果的目录。
使用以下设置配置电子邮件端点。
名称: 标识端点的强制设置。 不要包含<字符,因为它会截断Workspace中显示的名称。 如果您输入URL作为端点的名称,请确保它符合RFC1738中指定的语法规则。
描述: 端点的描述。 不要包含<字符,因为它会截断Workspace中显示的描述。
Cron表达式: 如果必须使用cron表达式来计划电子邮件,请输入cron表达式。
重复计数: 电子邮件端点扫描文件夹或目录的次数。 值–1表示无限扫描。 缺省值为–1。
重复间隔: 接收者用于检查传入邮件的扫描速率。
作业开始时的延迟: 计划程序启动后等待扫描的时间。
批次大小: 每次扫描接收者为获得最佳性能而处理的电子邮件数量。 值为–1表示所有电子邮件。 默认值为 2。
用户名: 强制设置,从电子邮件调用目标服务时使用的用户名。 默认值为SuperAdmin。
域名: 强制设置,即用户的域。 默认值为DefaultDom。
域模式: 指定提供程序接受的传入电子邮件的域模式。 例如,如果使用adobe.com,则只会处理来自adobe.com的电子邮件;而忽略来自其他域的电子邮件。
文件模式: 指定提供程序接受的传入文件附件模式。 这包括具有特定扩展名(&ast;.dat、&ast;.xml)、特定名称(数据)或名称和扩展名(&ast;)中的复合表达式的文件。[dD][aA]'端口')。
成功作业的收件人: 发送消息以指示作业成功的电子邮件地址。 默认情况下,成功的工作消息始终发送给发件人。 如果键入sender ,则会向发件人发送电子邮件结果。 支持最多100个收件人。 使用以逗号(,)分隔的电子邮件地址指定其他收件人。
要关闭此设置,请将设置留空。 在某些情况下,您希望触发一个进程,而不希望收到关于结果的电子邮件通知。
失败的作业的收件人: 发送消息以指示失败的作业的电子邮件地址。 默认情况下,始终向发件人发送失败的作业消息。 如果键入sender ,则会向发件人发送电子邮件结果。 支持最多100个收件人。 使用以逗号(,)分隔的电子邮件地址指定其他收件人。
要关闭此设置,请将设置留空。 在某些情况下,您希望触发一个进程,而不希望收到关于结果的电子邮件通知。
收件箱主机: 要扫描的电子邮件提供程序的收件箱主机名或IP地址。
收件箱端口: 电子邮件服务器使用的端口。 POP3的默认值为110,IMAP的默认值为143。 如果启用了SSL,则POP3的默认值为995,而IMAP的默认值为993。
收件箱协议: 用于扫描收件箱的电子邮件端点的电子邮件协议。 值为IMAP或POP3。 收件箱主机邮件服务器必须支持这些协议。
收件箱超时: 电子邮件提供商等待收件箱响应的超时(以秒为单位)。
收件箱用户: 登录电子邮件帐户所需的用户名。 根据电子邮件服务器和配置,此值可能只是电子邮件的用户名部分,也可能为完整的电子邮件地址。
收件箱密码: 收件箱用户的密码。
POP3/IMAP SSL已启用: 选择此设置可强制电子邮件提供商使用SSL扫描收件箱。 确保邮件服务器支持SSL。
SMTP主机: 电子邮件提供商用于发送结果和错误消息的邮件服务器的主机名。
SMTP端口: SMTP端口的缺省值为25。
SMTP用户: 电子邮件提供商在发送有关结果和错误的电子邮件通知时使用的用户帐户。
SMTP密码: SMTP帐户的密码。 某些邮件服务器不需要SMTP密码。
发送自: 用于发送结果和错误的电子邮件通知的电子邮件地址(例如,user@company.com)。 如果未指定“发送自”值,则电子邮件服务器会尝试通过将“SMTP用户”设置中指定的值与在电子邮件服务器上配置的默认域结合来确定电子邮件地址。 如果您的电子邮件服务器没有默认域,并且您没有指定“发送自”的值,则可能会发生错误。 为确保电子邮件的发件人地址正确,请为“发件人”设置指定一个值。
已启用SMTP SSL: 选择此设置可强制电子邮件提供商使用SSL扫描收件箱。 确保邮件服务器支持SSL。
电子邮件发送文件夹失败: 指定在SMTP邮件服务器不工作时用于存储结果的目录。
异步: 当设置为synchronous时,将处理所有输入文档并返回单个响应。 当设置为异步时,将为处理的每个文档发送响应。
例如,为接受单个Word文档并以PDF文件形式返回该文档的服务创建电子邮件端点。 可以将电子邮件发送到包含多(3)个Word文档的端点收件箱。 处理完所有三个文档后,如果端点配置为同步,则会发送一封包含所有三个文档的响应电子邮件。 如果端点是异步的,则在每个Word文档转换为PDF后都会发送一封响应电子邮件。 结果是3封电子邮件,每封都带有一个PDF附件。
默认值为asynchronous。
将原始电子邮件正文作为附件包含: 默认情况下,当您将电子邮件发送到表单服务器时,消息的原始文本将包含在消息正文中。 要改为将文本包含为附件,请选择此选项。
对结果电子邮件使用原始主题行: 默认情况下,发送结果电子邮件时,Forms服务器使用成功电子邮件主题和错误电子邮件主题设置中指定的值作为主题行。 若要改用与发送到服务器的原始电子邮件相同的主题行,请选择此选项。
成功电子邮件主题: 向电子邮件端点发送电子邮件以启动或继续流程后,您将从AEM表单服务器收到一封返回电子邮件。 如果电子邮件成功,您将收到一封成功电子邮件。 如果电子邮件失败,您将收到一封失败电子邮件,通知其失败原因。 此设置允许您指定为此端点发送的成功电子邮件的主题行。
成功电子邮件正文: 允许您指定为此端点发送的成功电子邮件的正文文本。
错误电子邮件主题前缀: 允许您指定为此端点发送的失败电子邮件主题行开头使用的文本。
错误电子邮件主题: 使您可指定为此端点发送的失败电子邮件的主题行。 此文本显示在错误电子邮件主题前缀之后。
错误电子邮件正文: 允许您指定为此端点发送的失败电子邮件正文的第一行。
电子邮件摘要信息: 每条成功或失败消息都包含一个部分,其中包含您发送到表单服务器的原始电子邮件文本。 此设置指定该部分上方显示的文本。
在创建/更新此端点之前验证收件箱: 选择此选项时,表单服务器会在创建端点之前检查SMTP/POP3设置是否正确。 单击“添加”后,将显示一条消息,说明收件箱帐户是否有效。 如果未选择此选项,则AEM Forms服务器将在不验证收件箱的情况下创建端点。
操作名称: 此设置是必需的。 可分配给电子邮件端点的操作列表。 您在此处选择的操作决定在“输入参数映射”和“输出参数映射”部分中显示哪些字段。
输入参数映射: 用于配置处理服务和操作所需的输入。 两种类型的输入是文本输入和变量输入:
文本: 电子邮件使用在显示的字段中输入的值。
变量: 您可以映射来自电子邮件主题、正文、标题或发件人电子邮件地址的字符串。 要执行此操作,请使用以下关键字之一: %SUBJECT%、%BODY%、%HEADER%或%SENDER%。 例如,如果您使用%SUBJECT%,则将电子邮件主题内容用作输入参数。 要选取附件,请输入电子邮件端点可用于选择附加文档的文件模式。 例如,输入&ast;.pdf会选择任何具有.pdf文件扩展名的附加文档。 输入&ast;选择任何附加的文档。 输入example.pdf将选择任何名为example.pdf的附加文档。
输出参数映射: 用于配置服务和操作的输出。 输出参数映射值中的以下字符在附件文件名中展开:
%F 表示源文件的文件名(不包括扩展名)。
%E 表示源文件的扩展名。
任何反斜线()的出现情况都将被替换为%%。
注释:如果服务请求消息包含多个文件附件,则无法为端点的输出参数映射属性使用%F和%E参数。 如果服务响应返回多个文件附件,则不能为多个附件指定相同的文件名。 如果不遵循这些建议,则调用的服务将为返回的文件创建名称,而这些名称是不可预测的。
可以使用以下值:
单个对象: 电子邮件提供商没有源文件夹目标;结果作为附件返回。 模式为Result/%F.ps,并返回Result%%sourcefilename.ps作为文件名附件。
列表: 模式为Result/%F/,并返回Result%%sourcefilename%%file1作为文件名附件。
映射: 模式为Result/%F/,源目标为Result%%sourcefilename%%file1和Result%%sourcefilename%%file2。 如果映射包含多个对象并且模式为Result/%F.ps,则响应文件附件为Result%%sourcefilename1.ps (输出1)和Result%%sourcefilename2.ps (输出2)。
要使表单工作流接收和处理来自用户的传入电子邮件,您需要为Complete Task服务创建电子邮件端点。
*.*
在相邻的框中。 这会将入站邮件中的所有附件发送到“完成任务”流程的映射变量。%BODY%
在相邻的框中。%SENDER%
在相邻的框中。 这会将发件人地址映射到“完成任务”流程数据。results
. 这会导致“完成任务”或“启动进程”返回结果字符串。