1 需求场景
2 使用说明
2.1 加载扩展包
扩展包：飞书集成Smartbi
扩展包部署详情请看文档：部署扩展包
注意：上传该扩展包时需进行系统升级。请勿在系统忙碌期间部署该扩展包。
2.2. 集成说明
2.2.1. 步骤1 配置飞书应用
...
注：移动端和桌面端主页都配置feishuIndex.jsp 即可，后续单点成功后，移动端会跳转到移动端首页。
添加网页应用能力：
配置网页应用的主页：
...
2.
...
2.1.6. 配置应用功能-机器人
要完成飞书推送功能，需要开启飞书应用的机器人权限。
...
2.
...
2.1.7. 配置安全设置
当前扩展包内，在跟飞书交互时，会用到Oauth2登陆认证，飞书接受到登录请求后，会重定向回smartbi，并携带相关code信息。当前扩展包内，在跟飞书交互时，会用到Oauth2登陆认证，飞书接受到登录请求后，会重定向回Smartbi，并携带相关code信息。
此处需要将smartbi解析code并登录的地址配置到重定向URL内。此处需要将Smartbi解析code并登录的地址配置到重定向URL内。
如2.12.1.5示例，smartbi部署在示例，Smartbi部署在http://10.10.27.105:8095上
...
http://10.10.27.105:8095/smartbi/vision/FeiShuOauthLogin
...
2.
...
2.1.8. 应用权限开通说明
需要给到应用配置以下权限：
权限名称 | 权限说明 | 使用场景 |
contact:contact:readonly_as_app | 以应用身份读取通讯录 | 用户同步，单点登录 |
contact:department.organize:readonly | 获取部门组织架构信息 | 用户同步，单点登录 |
contact:user.base:readonly | 获取用户基本信息 | 用户同步，单点登录 |
contact:user.employee_id:readonly | 获取用户user ID | 用户同步，单点登录 |
contact:user.phone:readonly | 获取用户手机号 | 用户同步，单点登录 |
im:message | 获取与发送单聊、群组信息 | 推送消息 |
im:message:send_multi_depts | 给一个或多个部门成员批量法消息 | 推送消息 |
im:message:send_multi_users | 给多个用户批量发消息 | 推送消息 |
im:resource | 获取与上传图片或文件资源 | 推送消息 |
contact:department.base:readonly | 获取部门基础信息 | 用户同步（部门信息），单点登录 |
contact:user.employee:readonly | 获取用户受雇信息 | 用户同步(用户状态) |
contact:user.department:readonly | 获取用户所属部门的 ID | 用户同步 |
contact:user.email:readonly | 获取用户邮箱信息 | 用户同步（email邮箱扩展属性） |
...
2.
...
2.1.9. 版本与管理
每一次修改应用信息，都要创建版本并发布后才能生效。
...
2.
...
2.2. 步骤2
...
配置Smartbi系统选项
...
2.
...
2.2.1. 正常部署扩展包
根据1.4的描述，正常部署扩展包，部署成功后，可以在系统选项内看到飞书相关配置入口。正常部署扩展包，部署成功后，可以在系统选项内看到飞书相关配置入口。
...
2.
...
2.2.2. 配置飞书相关信息
根据2.12.1.4 内获取的app_id和app_sercret,配置进smartbi系统选项内
其中smartbi外网访问地址需要配置smartbi外网可访问的IP或域名地址。其中Smartbi外网访问地址需要配置Smartbi外网可访问的IP或域名地址。
用户同步可以指定同步时的用户名，使用的飞书属性key以及同步到smartbi的默认密码；用户同步可以指定同步时的用户名，使用的飞书属性key以及同步到Smartbi的默认密码；
Ps：name属性在飞书中是可重复的，手机号、邮箱、工号是非必填属性，现场可根据实际情况设置，如不需使用自带的用户同步，可忽略；
...
