一、概述
支持与政务钉钉集成,包括“通讯录同步”“应用集成到政务钉钉"”消息互通“,即实现在公众号上使用我们的应用,包括推送消息。
二、操作说明
【云桥对外域名】配置说明
集成企业微信需要配置外网域名地址,在【云桥】-【基础参数设置】配置当前系统的外网域名地址,配置好之后点击保存,如下图所示:
1.在【后台管理中心】-【平台引擎】-【云桥】中进入云桥集成页面
2.选中【政务钉钉集成】-【新建政务钉钉】进入创建政务钉钉配置页面,如下图
登录政务钉钉后台(https://openplatform-portal.dg-work.cn/devPage/#/myApp),点击【组织内部应用】旁的【创建应用】,如下图
应用类型选择【H5微应用】,其他内容可自由填写,如下图:
点击【详情】,如下图:
复制应用凭证AppKey,AppSecret,如下图:
在云桥中点击【新建政务钉钉】进入如下页面
企业名称:根据需要填写政务钉钉的名称
租户ID:根据客户实际情况填写
API服务地址:
专有钉钉填 https://openplatform.dg-work.cn (默认)
浙政钉填https://openplatform-pro.ding.zj.gov.cn
回到前面的政务钉钉后台,添加权限应用的权限(如果是专有钉钉,可以开通所有权限),如下图:
最后发布应用,如下图:
点击【通讯录管理】的设置按钮进入设置页面
接口权限-只读:只能执行从企业号同步到云桥,不能在云桥通讯录调整数据,一切以企业号的组织架构为准。
选择应用:选择同步依赖的应用
政务钉钉组织架构同步分为两种:
1. 将政务钉钉的组织架构同步到云桥(不修改OA的组织架构)
2. 将政务钉钉的组织结构同步到云桥同时同步到OA(修改OA的组织架构)
新用户关联系统账号:设置本次同步过来的新成员(即云桥中不存在对应账号的成员)是否要自动建立于集成系统的关联关系
用户字段:设置政务钉钉中成员字段对应eteams系统中人员字段的对应关系,若字段值可以匹配,则从政务钉钉同步可以自动关联上,具体说明可在界面点击查看用户自动说明文档
定时同步:设置是否开启定时自动执行从政务钉钉同步操作,开启之后,系统会定时的将政务钉钉数据同步到移动平台中并自动建立与eteams的关联关系,具体设置建议为每隔一天同步一次,同步开始时间建议设置为凌晨2点或3点,例如开始时间设置为2019-02-02 02:00:00 则表示从2019年2月2日凌晨2点开始同步,并且每隔一天2点进行一次同步,结束时间一般不用填写
是否同步到eteams:若选择是,可在从政务钉钉同步时修改eteams的用户数据,可根据需求开启,具体规则见文档从云桥同步到E10,如图:
导出用户账号关联关系表:根据需求选择需要导出的用户范围,以及用户在云桥的关联状态、政务钉钉状态、添加状态,之后点击导出人员账号关联关系表
在导出的文件中配置【关联字段】,再进行导入:首先选择关联字段类型,再在第一步中导出的excel表中进行对该字段的维护,然后点击上传附件将excel表导入,即可实现人员批量关联
根据配置的条件,比如:政务钉钉账号 匹配 OA工号,如果匹配上了,就会自动将关联关系写入,如下图
应用管理功能主要是在移动平台中将政务钉钉应用与业务系统(eteams)功能模块进行对接,即实现在政务钉钉中使用业务系统的相关业务功能
1. 点击添加应用
2. 参考【企业集成】章节,在政务钉钉后台创建应用,并复制AppKey和AppSecret,填到应用的基本信息里,输入应用名称后单击保存
3. 应用主页是设置政务钉钉应用的主页功能,调用模块默认为打开应用,选择应用中心已经存在的主页型应用,如下图所示
将应用主页地址复制至政务钉钉后台后提交审核即可
也可使用自定义链接,将地址填入自定义链接处即可
应用发布之后可在【控制台】里设置应用使用范围
然后访问工作台管理后台(https://admin-work.dg-work.cn/workbench),选择应用配置到工作台上,如下图
消息管理功能主要是将OA应用消息推送到政务钉钉中,即实现在政务钉钉中接收并处理业务系统的消息。消息正常推送的前提是,政务钉钉用户要关联OA系统用户账号。
1. 在【云桥】-【消息推送设置】-【消息推送规则】 页面,点击新建,如下图所示:
例如将 日报 的消息推送到政务钉钉:填写好规则名称,消息来源选择日报,如下图所示
在规则详情页面,点击【新建】,设置推送目标,第三方企业类型选择【政务钉钉】,企业和应用根据实际需要,选择对应的企业团队和应用,如下图所示
消息类型可选择【通知】或者【待办】:
将 日报 的消息推送到政务钉钉:除了第二点中所述将消息来源选择日报之外,还可以将消息来源选择为全部,如下图所示:
注意:若消息来源选择全部,OA其他应用的消息(例如审批,出勤等)也会通过这条消息推送规则推送到政务钉钉。
此功能主要实现通过政务钉钉自带的扫一扫功能扫描OA系统首页的二维码进行登录OA系统
开启按钮选择依赖应用即可,不在依赖应用可见范围的人员将无法使用
将OA用户和政务钉钉人员绑定的方式有多种:
1.手动绑定(需要配置应用)
用户完成应用集成之后,可以直接访问应用,然后输入正确的系统账号密码后,对应集成的政务钉钉-通讯录中会记录用户的政务钉钉账号信息以及绑定关系。
2.自动绑定
用户字段有两个设置的地方:一个地方配置之后,其他一处也会开启自动同步;修改任意一处,也会变更其他一处的设置。
用户单点通讯录->用户绑定设置
从政务钉钉同步->新用户关联系统账号
根据配置的条件,比如:政务钉钉账号code 匹配 OA工号,如果匹配上了,就会自动将关联关系写入,如下图
3.关联导入
将已经同步到云桥本地的数据(单点写入或者从政务钉钉同步写入)导出,并且将需要绑定的OA人员的对应字段写入到文档中,上传文档,点击导入按钮,即可将关联关系写入,详情可见2.2.2
4.人员卡片绑定/解绑
将云桥本地的数据和OA的人员进行绑定或者解绑
5.批量解绑
解除云桥本地所有人员和OA人员的关联关系。
执行【从政务钉钉同步】,把人员在政务钉钉中的身份和在OA系统中的身份关联上,可使用如下任何一种方式。
方法一:手动关联。
方法二:在从政务钉钉同步时进行自动关联:需要在【从政务钉钉同步】时,开启【新用户关联系统账号】,配置关联字段之后,进行同步。
后续可以在 【从政务钉钉家同步】时,开启定时同步,每隔一段时间将政务钉钉的组织架构的变动更新到云桥。
若希望从政务钉钉同步的同时可以修改系统的组织架构,可开启同步到系统