本文档是苍穹集成钉钉的操作手册,包括苍穹配置(系统参数、消息平台等)、钉钉配置(创建微应用、配置微应用、设置权限及发布)以及集成后的一些注意事项。详细介绍了在苍穹和钉钉间同步人员信息、配置消息渠道和类型、创建并配置钉钉微应用以及解决集成后可能遇到的问题等步骤。
苍穹集成钉钉操作手册
一、苍穹配置
1.系统参数
(1)路径:【系统服务云】-【配置工具】-【系统参数】-【系统服务云】-【基础服务】
(2)钉钉参数:
(3)参数解释:
① 启用钉钉:开启
② 应用标识对应钉钉的AppKey
③ 应用密钥对应钉钉的AppSecret
④ 企业ID对应钉钉的CorpId
(4)同步钉钉人员信息
① 路径:【系统服务云】-【基础服务】-【人员管理】-【人员】
②
③ 点击钉钉同步按钮,在钉钉授权的前提下,系统会将钉钉人员信息映射到苍穹系统中,后续消息中心打通钉钉渠道,会根据苍穹映射的人员属性推送。
④ 注意:消息中心推送钉钉消息,必须以接收人有映射关系为基础。
⑤ 查询人员映射关系方式:(系统库)
Select * from t_bas_immapping where fuserid=? and fimtypeid=2;
2.消息平台
(1)消息渠道
① 路径:【系统服务云】-【系统管理】-【消息平台】-【消息渠道】
② 选中钉钉,点击【修改】
③
④ 配置消息渠道参数
⑤ 应用ID对应的是钉钉创建的应用的AgentId
⑥ 启用日志之上的参数使用系统默认参数
(2)消息类型
① 路径:【系统服务云】-【系统管理】-【消息平台】-【消息渠道】
② 选中需要修改的消息类型,点击修改
③
④ 选择消息发送渠道
⑤
3.……
二、钉钉配置
1.创建微应用
(1)路径:【钉钉开放平台】-【应用开发】-【企业内部开发】-【创建应用】
(2)应用类型选择H5微应用,填写应用名称、应用描述、应用图标,开发方式选择企业自主开发
2.微应用配置
(1)开发管理
① 开发模式:开发应用
② 服务器出口IP:公有云出口IP找总部运维老师获取
应用首页地址:新增apptype=dd、corpid、appkey、agentid、appsecret等参数, apptype固定设置为dd,如图所示
http://192.168.36.3:2024/bjpatch/mobile.html?&apptype=dd&corpid=ding662b6000bd88a9fc35c2f4657eb6378f&appkey=dingmmx7xaqawlkfxgqh&agentid=281989539&appsecret=DdlaN6X1z1mH_SNyuJunhyW6wVl3OE7NjSfJjI_Af3oyp-qZpV08vxySp_j1YmBE
Corpid、appkey、agentid、appsecret发现位置
③ 配置完之后点保存提交
3.设置微应用权限
(1)由于访问苍穹系统需要拿到用户的手机号作为登录凭证,需要开启用户的手机号码信息
通讯录权限全部申请开通
(2)此外,苍穹基础服务&消息中心需要使用到钉钉的人员、组织、审批等权限,需要一并开启。
4.发布微应用
进入版本与管理发布,添加可使用人员,点击【确认发布】
发布之后修改可使用范围为全部员工,点击保存。
三、其他注意事项
1.钉钉收不到苍穹的流程助手消息推送和待办没有待办任务
进入钉钉待办页面,点击左下角【设置】,检查是否勾选订阅组织待办。
2.……
推荐阅读