文章目录

应用管理

钉钉端开发小程序/微应用，实现钉钉与LCP平台的深度集成

运行环境

当前存在两套钉钉环境

应用类型

钉钉开放平台支持小程序和H5微应用两种类型的应用开发。

• 小程序是指使用钉钉自有语法，使用专用工具开发移动端应用。小程序暂不支持PC端部署。
• 微应用是指传统的H5方式开发的移动端应用。
• 原则上选择微应用，即H5原生开发。自行展开H5开发具备最大的开发灵活性。

编程模式

当前存在两套编程模式

前端API

后台API

风神工作台

在每个人的钉钉工作台，显示 风神工作台 应用图标

• 在PC端点击后，免密进入PC端统一门户页面
• 手机端点击后，免密进入移动端待办面板页面

进入钉钉工作台管理后台，创建微应用。选择企业内部自主开发，开发模式选择开发应用，开发应用类型选择微应用，录入名称与Logo，应用首页链接输入移动端待办面板页面链接，PC端首页地址输入PC端统一门户页面，最后录入服务器出口IP，之后发布至所有用户即可。

默认情况下，新加入的应用显示在钉钉工作台最下端。管理员可通过移动端管理工作台功能，调整显示分组与顺序。

基础应用信息

不同环境，出口IP与各页面地址配置如下。内网需要同步作Nginx配置，将外网域名请求转发到正确的内网服务器端口上

接口权限

后台服务端向钉钉服务器请求数据的接口权限

应用发布

发布后，该应用将会出现在钉钉的工作台上，企业组织内部的用户将会看到该应用。

钉钉集成

将钉钉SDK集成至本平台，简化钉钉对接难度

参数设置

# 消息通知相关，当前系统的路径
sys.webroot.url=https://dingtest.fslgz.com/portal

# 钉钉配置
dingtalk.corp.id=ding6b6ffebcd75ef63335c2f4657eb6378f
dingtalk.app.key=dinggkwxz61kgu7vvw8a
dingtalk.app.secret=VnA-wL-bqviMkIsw_Qn81TqH-Q7fqzCchOglmBjplbjeBZvdzH5MZ8e66vDNefo-
dingtalk.default.agentid=280426666

当项目不作修改时，平台内置的默认参数来源如下

钉钉接口

com.fsl.lcp.dingding.service.IDingDingService：提供调用钉钉服务的服务端接口

地址常量

com.fsl.lcp.dingding.constant.UrlConstant：封装常用的钉钉服务地址信息

钉钉集成登录

对于引用了移动端头页面 mobile_header.html 的页面，如果当前是钉钉执行环境且当前用户未登录系统，平台将使用钉钉提供的免登接口通过两次ajax请求自动完成系统登录。不再有使用cas登录时的页面三次跳转，首次使用体验大幅提升。

首先，在 applicationContext-security.xml 文件中，启用钉钉集成。可以看到，非钉钉环境依然延用cas登录

<!-- 根据项目需求选择登录方式：标准，CAS，钉钉CAS联合 -->
<beans:import resource="ddAndCasSecurity.xml"/>
<!-- <beans:import resource="casSecurity.xml"/> -->
<!-- <beans:import resource="standardSecurity.xml"/> -->

然后，尽可能将页面初始化代码都放到Lcp.ready方法里。页面所有对后台接口的调用，都必须在Lcp.ready里、或之后执行。Lcp.ready函数保证了代码执行顺序，其一定会在(mui完成初始化、dd完成初始化、页面完成登录)这三者之后执行。建议使用Lcp.ready替代mui.ready或dd.ready。

var viewM = null;
Lcp.ready(function () {
	viewM = new Vue({
		el: '#mui-content',
		methods: {
			pickEmployee: function () {
				dd.biz.util.openLink({
					url: document.location.origin + '${base.contextPath}/hr/mb_employee_picker.html?multiSelect=false'
				});
			}
		}
	});
});

如果存在需要鉴权才使用的api，可以使用Lcp.ddConfig函数。建议Lcp.ddConfig在Lcp.ready之外调用。示例如下:

Lcp.ddConfig({
	jsApiList: [
		'runtime.info',
		'biz.contact.choose',
		'device.notification.confirm',
		'device.notification.alert',
		'device.notification.prompt',
		'biz.ding.post',
		'biz.util.openLink',
		'biz.util.scanCard',
		'device.geolocation.get',
	]
})
Lcp.ready(function() {
	...
)}

钉钉事件回调

当在钉钉上做指定操作时，钉钉会将相关事件主动推送至指定RESTFul接口，实现事件通知。

接口注册

向钉钉服务器指定地址发起请求，将回调URL作为参数告知钉钉(注册回调接口)。钉钉服务器会立刻向回调URL发起【测试回调URL】事件，来验证URL的合法性，回调URL服务器需要在接收到回调之后返回字符串“success”的加密json数据，才能完成注册。

通讯录事件回调

群会话事件回调

签到事件回调

审批事件回调

日志管理

通过 IDingDingService.execute 方法调用接口，系统会自动记录接口调用日志，方便问题查看和调试。

mber|群会话删除人员|
|chat_quit|群会话用户主动退群|
|chat_update_owner|群会话更换群主|
|chat_update_title|群会话更换群名称|
|chat_disband|群会话解散群|

签到事件回调

审批事件回调

日志管理

通过 IDingDingService.execute 方法调用接口，系统会自动记录接口调用日志，方便问题查看和调试。