1. 概述
1.1 应用场景
对于已经制作好的「数据开发」和「数据管道」任务,希望能将任务的运行结果进行邮件通知,通知给对应的用户。
1.2 功能简介
FineDataLink 支持邮件的接收和发送。不论是邮件的接收还是发送,都需要邮箱账户信息。
1)支持设置多个系统发件人邮箱。支持设置默认发件人邮箱。
2)支持查看历史邮件发送记录。支持根据发件人、收件人邮箱、模板名称等条件查询发送记录。
1.3 前提条件
使用邮箱需要确保 FineDataLink 系统和邮箱服务器之间可以连通。
1)使用外网的邮箱服务器,如 QQ 邮箱,163 邮箱等,需要保证工程能正常访问到外网。
2)使用用户自己的内网邮箱服务器,则无需连接到外网,保证 FineDataLink 系统和邮箱服务器之间连通即可。
2. 设置发件人账户
设置发件人账户分为两步:
1)添加发件人
2)从已添加的发件人中选择系统默认发件人
注:若未配置「系统默认发件人」,则认为邮箱未配置。
2.1 添加发件人
管理员登录FineDataLink系统,点击「管理系统>系统管理>邮箱」,点击「添加发件人」,可以设置发件人账户,如下图所示:
「发件人账户设置」各设置项说明如下表所示:
邮箱设置项 | 简介 |
---|---|
邮件服务器 | 选择邮件服务器
注:如果邮箱为腾讯企业微信邮箱,请手动修改为 SMTP.exmail.qq.com |
端口和加密方式 | 设置邮件服务的端口和加密方式
注1:建议用户使用更安全的 TLS 协议。 注2:此处若设置加密方式,请确保加密的证书已加入 Java 证书受信任列表中,否则将导致客户端无法读取加密后的响应 |
发件人地址 | 填写发件人邮箱地址
|
密码 | 大部分邮箱输入邮箱密码即可 QQ 邮箱和 163 邮箱、QQ企业邮箱、Ooutlook 邮箱需要填写「授权码」,详情请参见本文第三章 |
显示姓名 | 邮箱发件人的名称,可手动编辑填写 必填项,不填会导致在设计器里面发送邮件事件时,识别不到邮箱配置 |
发送测试邮件 | 测试邮件服务器是否配置成功 |
配置完「发件人账户设置」后,点击「发送测试邮件」,填写一个收件人邮箱,点击「确定」。
收件人邮箱中收到测试邮件,内容为「恭喜您!您的邮件服务器已经配置成功」,代表邮件服务器已配置成功。
点击「确定」,该收件人添加成功,如下图所示:
注:「邮件正文」以 HTML 格式显示,部分字体不支持会显示为 SimSun 字体
不支持字体的具体特征为:字体名称中间含有空格、「-」等特殊符号,例如「Windding 3」。
一个系统支持配置多个发件人地址,支持编辑/删除发件人地址。如下图所示:
2.2 设置默认发件人
添加完发件人后,管理员可在已添加的发件人中选择一个作为系统默认发件人,点击「保存」生效,如下图所示:
注:若系统默认发件人对应的发件人地址被删除了,那么系统默认发件人为空,邮箱配置未完成。
3. 开启 POP3/SMTP 服务与生成授权码
POP3/SMTP 服务开启可以用客户端收发邮件,若没有开启可能导致邮箱配置失败。
目前配置发件人账号,若是 QQ 个人邮箱和 163 邮箱需要通过授权码来验证。
注:如果用户邮箱系统是使用账号登录而非邮箱地址,可以在「显示姓名」属性中配置账号名实现账号名认证。
3.1 QQ 个人邮箱
登录 QQ 邮箱,点击「设置>账户」,找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务>开启服务>POP3/SMTP服务」,如下图所示:
点击「开启」,提示「验证密保」,按照提示发送短信,点击「我已发送」,验证成功即可。如下图所示:
验证完成后,提示「成功开启 POP3/SMTP服务」,「FineDataLinK 系统管理>邮箱>密码」一栏需填入「授权码」,而不是邮箱密码。如下图所示:
3.2 163 邮箱
登录 163 邮箱,点击「设置>POP3/SMTP/IMAP」,开启「POP3/SMTP服务」,如下图所示:
注:网易邮箱客户端无法进行该设置,请在网页端登录进行配置。
点击「开启」,提示「账号安全验证」,按照提示发送短信,点击「我已发送」,验证成功即可。如下图所示:
验证完成后,提示「成功开启 POP3/SMTP服务」,「FineDataLink 系统管理>邮箱>密码」一栏需填入「授权码」,而不是邮箱密码。如下图所示:
注:该授权码仅显示一次,请牢记,以防日后需要。
3.3 QQ 企业邮箱
1)开启POP/SMTP服务
打开 QQ 企业邮箱,点击「设置>客户端设置」,找到「开启服务」。
确认勾选「开启POP/SMTP服务」并保存更改。
2)获取端口和加密方式
打开 QQ 企业邮箱,点击「设置>客户端设置」,找到「设置方法>发送服务器」。
数据决策系统配置发件人账户时,加密方式和端口需要发送服务器一致(例如下图,端口为465,加密方式为SSL)。
3)获取客户端密码
点击「微信绑定」,绑定微信。如下图所示:
成功绑定微信后,需要「开启安全登录」。如下图所示:
开启后,须重新登录邮箱,无法使用原密码登录。网页版请使用微信扫码,客户端请使用「客户端专用密码」登录。
之后,点击「设置>微信绑定」,首先绑定微信。开启安全登录后,点击「客户端专用密码>生成新密码」,如下图所示:
数据决策系统配置发件人账户时,密码输入下图的客户端密码,而非邮箱密码。
3.4 Outlook邮箱
用户登录 Outlook 邮箱,点击「设置>邮件>同步电子邮件」,开启 POP 服务,如下图所示:
开启后可看到服务器信息,记录 SMTP 设置中的服务器名称,端口,加密方式等。如下图所示:
FineDataLink 系统配置发件人账户时,邮件服务器输入下图的服务器名称,端口和加密方式按照下文的端口和加密方式配置。
3.5 Exchange 邮箱
在添加「发件人账户」前,请收集以下信息:
邮件服务器 (SMTP) :邮件服务器所在 IP 地址
发件人地址:Exchange 邮箱地址
密码:Exchange 邮箱地址的登录密码
管理员登录数据决策系统,点击「管理系统>系统管理>邮箱」,点击「添加发件人」,设置发件人账户。填入提前收集的信息,加密方式选择「不加密」,如下图所示:
配置完「发件人账户设置」后,点击「发送测试邮件」,填写一个收件人邮箱,点击「确定」。
收件人邮箱中收到测试邮件,内容为「恭喜您!您的邮件服务器已经配置成功」,代表邮件服务器已配置成功。
点击「确定」,该收件人添加成功,如下图所示:
4. 发送记录
用户可根据发件人、收件人邮箱、模板名称、邮件发送日期等条件,查询系统发送出的历史邮件发送记录。
发送记录显示发件人、IP地址、收件人地址、模板名称、被访问资源、发送事件、发送结果等信息。如下图所示: