如何实现通过钉钉接收并免登查看苍穹工作流消息通知
小编推荐
在苍穹流程服务中，预置了钉钉、企业微信、Welink等第三方系统，通过工作流审批节点属性配置和消息渠道配置，可以方便快捷地将工作流审批待办或通知发送到第三方系统，且通过集成配置，可实现一键免登苍穹应用，无需重复登录账户，方便用户业务处理，提升办公效率。
本期文章以钉钉为例，为大家详细介绍如何实现通过钉钉接收并免登查看苍穹工作流消息通知。
1 业务场景
出差申请单审批结束后，希望能够通过钉钉发送通知，以第一时间告知提单人已经审核通过，且在钉钉端查看通知详情时，无需再重新登录苍穹。
2 解决方案
整体实现方案可分为以下2大方面：
（1）苍穹集成钉钉：包括系统参数配置、人员同步配置、消息渠道配置、MC租户管理中心配置、钉钉微应用配置等；
（2）工作流审批节点消息通知属性配置：配置消息的发送时机、内容、条件、渠道、消息接收人等等。
3 关键操作
3.1苍穹集成钉钉
1. 苍穹基础配置
配置系统参数：在【配置工具】→【系统参数】中找到钉钉参数，打开“启用钉钉”开关，并填写应用标识和通讯录秘钥，如下图所示：
钉钉参数配置
同步钉钉人员信息：在【基础服务】→【人员】列表中，点击“钉钉同步”按钮，在钉钉授权的前提下，系统会将钉钉人员信息映射到苍穹系统中，后续消息中心打通钉钉渠道，会根据苍穹映射的人员属性推送消息。
注意：消息中心推送钉钉消息，必须以接收人有映射关系为基础。查询人员映射关系方式（系统库）如下：
select * from t_bas_immapping where fuserid=? and fimtypeid=2;
同步钉钉人员信息
第三方应用配置：在【系统服务云】→【配置工具】→【第三方应用配置】→【钉钉】中，新增一条钉钉配置，输入应用标识和应用秘钥，点击“保存”。
第三方应用配置
2. 消息中心配置
在【系统管理】→【消息渠道】中配置钉钉渠道信息，如下图所示：
配置钉钉渠道信息
完成上述配置之后，在使用钉钉渠道之前，可以启用该渠道，并根据不同需求将渠道配置到【消息类型】中使用。
消息类型配置钉钉渠道示例
知识小卡片
目前消息中心已经预置了钉钉、电子邮件、企业微信、WeLink、短信、云之家等多种渠道，如需扩展系统预置外的第三方渠道，需要进行二次开发，开发指引可参考金蝶云·苍穹消息中心设计使用手册
3. MC租户管理中心配置
MC租户管理中心配置的目的是实现钉钉连接进入苍穹的免登录处理。其中，Token有时效性，若是长时间未登录，可能出现点击链接出现苍穹登录界面。届时，输入账号密码登录之后，再重新点击链接即可。配置方法如下：
步骤一：打开MC管理中心，找到对应的租户。
MC租户列表
步骤二：编辑租户配置信息。增加配置项authtication.apps，值为:kd.bos.login.thirdauth.app.dingding.DDAuthtication，如需配置多个应用，如企业微信、weblink时，中间以逗号隔开。配置完成后，点击“保存”。
编辑租户配置信息
步骤三：选择集群，点击“发布”。
发布集群
4. 钉钉微应用配置
苍穹系统与钉钉渠道打通中，需要钉钉配合实现该集成过程。根据前述业务场景需求，用户需要在出差申请单审批结束后，通过钉钉发送通知，以第一时间告知提单人已经审核通过，且点击钉钉微应用，可免登录进入苍穹移动端人人差旅页面查看通知详情，因此，此处以钉钉集成移动端人人差旅应用为例，说明钉钉微应用配置方法，具体步骤如下：
步骤一：创建H5微应用
进入钉钉企业管理后台，如下所示：
进入企业管理后台
进入钉钉应用开发平台，路径为：【工作台】→【自建应用】，如下图：
自建应用
然后，在顶部导航栏中，选择【应用开发】→【企业内部开发】，点击“创建应用”按钮，如下图：
创建应用
输入应用名称、上传应用Logo，开发方式选择“企业自助开发”，然后点击“下一步”。
配置应用信息
其中，基本信息填写如下：
（1）开发模式：选择“开发应用”；
（2）开发类型：选择“微应用”；
（3）应用首页链接：客户的苍穹平台移动端首页链接地址，客户点击该微应用，可以直接进入苍穹移动端首页，访问苍穹环境；
（4）服务器出口IP：用户的苍穹系统对外服务器公网IP，针对公有云客户，由于苍穹服务器的特殊性，钉钉微应用服务器出口IP需要单独配置。
然后点击“创建”即可。
步骤二：调整微应用首页地址
若需要实现点击微应用，免登录进入苍穹移动端人人差旅页面，需要在应用首页地址调整参数，配合苍穹单点登录功能。
在基础信息中获取人人差旅应用凭证信息，包括AgentId、AppKey、AppSecret，如下图：
获取应用凭证信息
点击首页，获取企业ID（corpid），如下图：
获取企业ID
选择开发管理，点击“修改”按钮，如下图所示：
修改人人差旅应用信息
首页地址拼接方法为：添加form 、apptype=dd、corpid、appkey、agentid、appsecret参数，如下示例：
http://XXXXXX/mobile.html?form=dz_mobindex&apptype=dd&corpid=dinge9401391dcd3b5b7ee0f45d8e4f7c288&appkey=dingsn7809psa3iqyojv&agentid=782958350&appsecret=GH6_uPzOxfqSyFmRuKLW5L0y1YhOyIbmGF_F_GCCLchVIs2LIhAzJk9ZkBcwGCVR
注意：参数命名必须为全部小写，其中：
http://XXXXXX为苍穹的地址；
form为跳转表单的form；
apptype固定设置为dd；
Corpid、appkey、agentid、appsecret为上面获取到的值。
拼接好后，填写在“应用首页地址”中。
步骤三：接口权限配置
由于访问苍穹系统需要拿到用户的手机号作为登录凭证，需要开启用户的手机号码信息，如下图所示：
权限配置
此外，苍穹基础服务&消息中心需要使用到钉钉的人员、组织、审批等权限，需要一并开启。
钉钉的人员、组织、审批权限配置
完成上述步骤后，打开应用发布界面，选择“全部员工”后，点击“发布”即可。
在钉钉工作台找到配置的应用，如果能正常进入到人人差旅页面，则代表免登成功。
钉钉免登人人差旅
3.2 工作流审批节点消息通知属性配置
要实现出差申请单审批结束后，能够在钉钉接收通知，需要配置审批节点的“消息通知”属性。配置方法如下：
在【流程服务云】→【工作流服务】→【设计中心】→【流程设计】，选中出差申请单流程的最后一个审批节点，配置节点的“消息通知”。根据业务需求，希望审批同意后，在钉钉渠道给提单人发送通知，则可按下图方式配置：
消息通知属性配置
4 相关资料
2. 钉钉免登苍穹的配置说明
5 划重点
要实现通过钉钉接收并免登查看苍穹工作流消息通知，可分为以下两大环节：
1.苍穹集成钉钉，包括4大关键配置：
苍穹基础配置：系统参数配置、钉钉人员同步信息配置、第三方应用配置等；
消息中心配置：消息渠道、消息类型配置等；
MC租户管理中心配置：租户信息配置，增加配置项authtication.apps，值为kd.bos.login.thirdauth.app.dingding.DDAuthtication；
钉钉配置：创建微应用、调整微应用首页地址、接口权限配置等。
2.工作流审批节点“消息通知”属性配置，根据场景配置消息发送时机、发送渠道为“钉钉”、消息内容等。
#往期推荐#
更多精彩内容，“码”上了解！↓
如何实现通过钉钉接收并免登查看苍穹工作流消息通知
本文2024-09-23 00:34:50发表“云苍穹知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-cangqiong-140374.html
