1. 概述
1.1 版本
| 报表服务器版本 |
|---|
| 10.0 |
1.2 应用场景
1）需要按照部门职位、角色选择收件人。
2）当用户安全性要求比较高，希望不能手写输入非系统内的用户；当用户灵活性要求比较高，希望邮件的收件人可以手写输入非系统内的用户邮件地址。
3）需要多种格式的邮件附件。
1.3 功能简介
通过工具栏中的邮件发送按钮来实现：
1）按照部门职位、角色选择收件人。
2）控制收件人、抄送、密送是否允许自定义值。
3）邮件的附件格式允许多选，且增加 Excel03 格式。
2. 功能简介
2.1 前提条件
发邮件，需要有一个发件人，否则发送动作无法完成。每个数据决策系统的发件人是唯一的，只需要设置一次即可。
管理员登录数据决策系统，点击「管理系统>系统管理>邮箱」，配置发件人账户，点击「保存」，如下图所示：
注1：发件人邮箱类型不同，配置步骤可能不完全相同，具体请参见：邮箱。
注2：配置完成后，请点击「发送测试邮件」，确保邮箱可使用。
2.2 设置单张报表邮件按钮
如果希望用户在预览查看模板时，可以将模板内容通过邮件发送给用户，那么工具栏必须有邮件按钮。
打开对应模板，点击「模板>模板Web属性」，按照模板预览方式，选择「分页预览设置/填报页面设置/数据分析设置」。
切换为「为该模板单独设置」，勾选「使用工具栏」，双击添加邮件按钮（一般默认已添加），双击编辑邮件按钮。可设置项如下图所示：
2.3 设置服务器邮件按钮
如果希望系统中所有模板都使用默认的邮件按钮设置，可采用本节设置。
点击「服务器>服务器配置」，按照模板预览方式，选择「分页预览设置/填报页面设置/数据分析设置」。
勾选「使用工具栏」，点击「编辑」按钮，双击添加邮件按钮（一般默认已添加），双击编辑邮件按钮。可设置项如下图所示：
2.4 设置项简介
邮件按钮设置项如下表所示：
| 设置项 | 简介 |
|---|---|
显示按钮图标 控件图标 | 控制是否显示按钮的图标 可自定义图标样式：选择内置图标/自定义上传图片，建议使用16 × 16规格的PNG图片 |
| 显示按钮名称 | 控制是否显示按钮的名称 |
| 控件别名 | 可设置控件别名，主要用于参数调用 |
| 收件人允许自定义值 | 若勾选该选项，发送邮件时，允许手动输入收件人邮箱地址 若不勾选该选项，发送邮件时，仅允许选择数据决策系统中的用户，发送给用户的邮箱 |
| 按部门选择收件人 | 若勾选该选项，发送邮件时，允许按照数据决策系统中的部门选择，发送给该部门中的用户的邮箱 若不勾选该选项，则无法按照部门选择，仅允许按照用户选择 |
| 按角色选择收件人 | 若勾选该选项，发送邮件时，允许按照数据决策系统中的角色选择，发送给该角色下的用户的邮箱 若不勾选该选项，则无法按照部门选择，仅允许按照用户选择 |
预览模板时，点击「邮件」按钮，发送邮件设置如下表所示：
| 设置项 | 简介 |
|---|---|
| 发件人 | 发件人就是2.1节配置的发件人账户 |
| 收件人 | 收件人分为3种。 1）用户： 可选择数据决策系统中的用户 若勾选了「收件人允许自定义值」，可手动输入邮箱地址，使用「,」间隔 2）部门： 勾选了「按部门选择收件人」，方显示该设置项 可选择数据决策系统中的部门 3）角色： 勾选了「按角色选择收件人」，方显示该设置项 可选择数据决策系统中的角色 |
抄送 密送 | 可选择数据决策系统中有权限的用户 若勾选了「收件人允许自定义值」，可手动输入邮箱地址，使用「,」间隔 |
| 格式 | 选择邮件中附件的格式，附件内容为报表内容 可选择的附件格式为：pdf、excel07、excel03、word、svg |
| 主题 | 邮件的标题 |
| 内容 | 邮件的正文 |
| 正文预览报表内容 | 在邮件正文预览报表的内容 |
3. 示例
本文示例：
文档系统中存在模板「GettingStarted.cpt」，挂载到数据决策系统中。销售部saleLeader Lisa 可查看该模板。
某天 Lisa 觉得销售情况非常优秀，将模板内容通过邮件发送给销售部全体成员进行表扬，并抄送给领导邮箱。
3.1 设置邮件按钮
如果希望用户在预览查看模板时，可以将模板内容通过邮件发送给用户，那么工具栏必须有邮件按钮。
打开%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt，点击「模板>模板Web属性」，按照模板预览方式，选择「分页预览设置」。
切换为「为该模板单独设置」，勾选「使用工具栏」，双击添加邮件按钮（一般默认已添加），双击编辑邮件按钮。
由于领导的邮箱是数据决策系统中没有的，因此要勾选「收件人允许自定义值」。
由于需要给部门「销售部」发送邮件，因此要勾选「按部门选择收件人」。
设置项如下图所示，设置完成后点击保存，并保存模板。
3.2 设置发件人
发邮件，需要有一个发件人，否则发送动作无法完成。每个数据决策系统的发件人是唯一的，只需要设置一次即可。
管理员登录数据决策系统，点击「管理系统>系统管理>邮箱」，配置发件人账户，点击「保存」，如下图所示：
注1：发件人邮箱类型不同，配置步骤可能不完全相同，具体请参见：邮箱。
注2：配置完成后，请点击「发送测试邮件」，确保邮箱可使用。
3.3 设置收件人
由于需要给销售部的同事发送邮件，因此需要确保用户配置了邮箱，否则选择了用户也无法投递。
管理员登录数据决策系统，点击「管理系统>用户管理>所有用户」，编辑 Lisa 的用户信息，填入邮箱信息，点击「确定」。如下图所示：
注：本示例仅演示如何对用户 Lisa 配置邮箱，管理员也可在同步/手动添加用户时配置好邮箱，详情请参见：添加用户、导入用户、同步用户。
邮箱完全配置好后，如下图所示：
3.4 挂载目录
管理员登录数据决策系统，点击「管理系统>目录管理>管理目录」，点击「添加模板」，如下图所示：
添加模板对话框中勾选模板「GettingStarted.cpt」，点击下一步。
设置好目录名称、展示终端，点击「确定」，模板「GettingStarted.cpt」就被挂载到了数据决策系统主目录下。
3.5 分配目录查看权限
如果希望 Lisa 可以查看这张模板，可以使用这个模板发送邮件，必须要赋予 Lisa 目录查看权限。
管理员登录数据决策系统，点击「管理系统>权限管理>普通权限配置」,选择权限载体「部门/角色/用户」，本示例选择用户 Lisa.
选择「目录权限」Tab，为 Lisa 配置目录「GettingStarted」的「查看」权限，如下图所示：
3.6 效果预览
用户 Lisa（Lisa，123456）登录数据决策系统，查看目录「GettingStarted」，输入参数并查询模板。
点击「邮件」，设置收件人部门为销售部所有职务，抄送给领导邮箱，格式选择PDF，主题和内容如下图所示：
点击「确定」后，等待邮件发送成功，提示「邮件已发送」，如下图所示：
领导和销售部用户的邮箱收到一封邮件，如下图所示：
4. 注意事项
排查步骤1：
数据决策系统未正确设置发件人，请参考本文 2.1 节配置邮箱服务器。
排查步骤2：
邮件按钮设置中未勾选「收件人允许自定义值」，但仍手动输入邮箱地址，且该邮箱地址非数据决策系统中用户绑定的邮箱地址。
请检查是否存在手动输入的邮箱地址，或参考 3.1 节修改邮件按钮设置，并勾选「收件人允许自定义值」。
排查步骤3：
没有选择收件人，或选择的收件人用户，全部都未绑定邮箱。
请检查发送邮件时是否配置收件人，请参考 3.3 节设置发件人邮箱。
注：若存在部分用户邮箱地址为空情况，不影响其他拥有邮箱地址的用户收到邮件。