现在软件开发不仅要面对前端碎片化
,还要面对后端碎片化
。针对前端碎片化
,CabloyJS提供了pc=mobile+pad
的跨端自适应方案,参见:自适应布局:pc = mobile + pad
在这里,咱们重点要解决的是后端碎片化
。比如要开发一个业务系统,既需要与微信、企业微信整合,又需要与钉钉整合,该如何设计整个架构呢?
其实,不论是微信、企业微信,还是钉钉,面向实际业务层面的API都不复杂,复杂的是各自独立的账号体系如何与业务系统打通的问题。当账号接口对接完成,后续的业务开发就很顺畅了
CabloyJS设计了一套用户系统
与身份认证系统
完全分离的机制,从而可以实现一个用户可以绑定多种登录方式。而且,这些不同的登录方式都是通过Provider
的组件方式动态插入系统的。所以,剩下的工作就是按照Provider
的方式来分别对接微信、企业微信和钉钉了
Cabloy-企业微信
是基于CabloyJS全栈业务开发框架开发的企业微信接口模块
,当前整合了自建应用
和企业微信小程序
的接口,达到开箱即用
的使用效果。在Cabloy-企业微信
的基础上,可以很方便的开发各类企业微信业务系统
企业微信开发
最复杂的就是账号体系对接,比如:
消息推送系统
中,对用户进行认证网页登录
,对用户进行认证微信小程序登录
,对用户进行认证一旦完成了这些场景下的账号体系对接,真正的业务开发就很简单了
因此,Cabloy-企业微信
模块的核心目标,就是自动完成这些场景下的账号体系对接,我们所需要做的就是提供一些配置参数,然后就可以愉快的开启业务逻辑的开发了
基于CabloyJS全栈业务开发框架本身提供的特性,使得Cabloy-企业微信
模块具有以下两个显著的亮点:
许多企业微信应用存在这样一个问题:在Mobile端只能使用一部分功能,其他更多功能则需要登录PC系统进行操作
而CabloyJS框架下的Cabloy-企业微信
允许所有的业务功能同时支持PC和Mobile使用。同时又能保证以下两点:
企业从不同服务提供商采购不同的企业微信应用,必然导致数据孤岛
的出现,而且这些数据散存在不同服务商的后台,缺乏数据联动与共享机制
而CabloyJS框架本身就是基于业务模块
构建的。企业自建的模块或者使用第三方的模块,都汇集在一个CabloyJS项目之中,并进行私有部署,从而从根本上解决了数据孤岛
的问题,不仅能实现数据联动与共享,也可以更灵活的进行数据采集、处理和分析
归根结底一句话,数据和程序都掌握在自己的手中
基于CabloyJS全栈框架提供的便利性和灵活性,Cabloy-企业微信
主要有如下特性:
当前整合了企业微信自建应用
和企业微信小程序
的接口,具体如下:
场景
名称
说明
自建应用
消息推送系统
自动完成接口对接,并对用户进行认证
自建应用
网页登录
自动跳转微信登录,并对用户进行认证
自建应用
网页JSSDK
自动注入JSSDK,并自动完成配置
小程序
后台登录接口
自动完成接口对接,并对用户进行认证
小程序
前端SDK
提供SDK,便于企业微信小程序前端直接访问CabloyJS后端API
只需配置好企业微信账号参数,所有接口自动完成对接
企业微信
可以关联多个企业微信小程序
,因此,模块也提供了多小程序支持
通过CabloyJS提供的多实例
特性,可以实现多租户/多站点支持
,比如为不同的企业提供企业微信服务。请参见:EggBornJS:多实例
如上所述
在进行后续模块的安装之前,您必须先创建一个CabloyJS项目
请务必参照文档步骤配置MySQL数据库连接参数
请参见:指南:快速开始
安装企业微信模块a-wxwork
$ npm i egg-born-module-a-wxwork
企业微信测试模块
用于演示如何在模块a-wxwork
的基础上进行具体的业务开发(同时包含企业微信小程序的demo程序)。有两种方式来使用企业微信测试模块
:
如果仅仅是预览效果,可以直接安装到{project}/node_modules
$ npm i egg-born-module-test-wxwork
src/module
可以将测试模块安装到{projecct}/src/module
,然后在此模块的基础上进行自定义开发
$ mv {project}/node_modules/egg-born-module-test-wxwork src/module/test-wxwork
直接在项目配置文件中配置自建应用
和小程序
的参数
src/backend/config/config.default.js
// modules
config.modules = {
'a-wxwork': {
account: {
wxwork: {
corpid: 'ww1fe9daaaa045aaaa',
apps: {
selfBuilt: {
agentid: '1000008',
secret: 'JLz3NL6PbFaaaabp64_RJpxaaaa7xROrgxraaaa-XXs',
token: 'zNjSn7aaaaoJNk',
encodingAESKey: 'DHc6kaaaa6BuGdnD6NRHtohqbCaaaaMDfgHtoaaaaUV',
message: {
reply: {
default: 'You are welcome!',
},
},
},
contacts: {
secret: 'jwvLlaaaa-1Zfa4KaaaaL193-6Y5ChURkEDaaaa630Y',
token: 'X1g3Dooaaaa1WwWYlzaaaaB5OiN',
encodingAESKey: 'qJKICJaaaaC1DfM3Td5lr54H8Pla499EgJ9aaaaxGzg',
},
},
// minis
minis: {
default: {
secret: 'jwaaaacRK-1Zfa4K01aaaa93-6Y5ChURkEDaaaa630Y',
appID: 'wx823df0aaaab9659f',
appSecret: 'c2e4442daaaaa5e4073cf49381baaaa9',
},
},
},
},
},
};
名称
说明
apps
配置所有微信应用的参数,包括:企业微信内置应用、第三方应用,以及自建应用。如需访问其他应用提供的API接口,直接在apps
添加新的配置即可
apps.selfBuilt
自建应用
apps.contacts
企业微信内置应用 - 通讯录应用
minis
支持多个微信小程序。为了实际开发上的便利,我们默认提供一个default
小程序。如果需要开发其他微信小程序,直接在minis
添加新的配置即可
启动后端服务
$ npm run dev:backend
启动前端服务
$ npm run dev:front
由于企业微信应用一定要绑定域名。为了支持开发调试,可以有不同的策略。如果我们想在服务器上配置开发环境,然后通过nginx把前端服务和后端服务反向代理给前端,请参见:nginx配置
只有加入到企业微信通讯录中的用户才可以访问自建应用
和企业微信小程序
。因此,我们需要先进行通讯录同步操作
当第一次同步完部门和成员后,以后所有的变更(增、删、改)都会自动进行同步
依次进入:首页
->设置
->企业微信
->通讯录管理
在企业微信
中直接访问首页,系统会自动进行企业微信登录
在浏览器
中直接访问首页,登录页面会自动显示企业微信登录
按钮,点击按钮,即可显示二微信,通过手机企业微信扫描,自动完成登录
需要进入企业微信的管理后台,进入
自建应用
,在开发者接口
启用企业微信授权登录
,授权回调域
设置为
yourdomain.com
测试模块test-wxwork
已经包含了一个企业微信小程序的demo程序,使用步骤如下:
在微信开发者工具
中直接导入demo程序,目录路径:{project}/src/module/test-wxwork/front/demo/miniprogram
修改小程序中的appid
,文件路径:{project}/src/module/test-wxwork/front/demo/miniprogram/project.config.json
修改初始化参数:
{project}/src/module/test-wxwork/front/demo/miniprogram/app.js
// 初始化cabloy
const cabloyOptions = {
base: {
scene: 'default',
locale: 'en-us',
},
api: {
baseURL: 'http://yourdomain.com',
},
};
this.cabloy = Cabloy(this, cabloyOptions);
默认对应的是default
小程序,如果要开发其他小程序,只需修改如下参数
名称
说明
base.scene
小程序场景名,默认为default
base.locale
前端默认使用的语言
api.baseURL
后端服务的API地址
手机扫一扫
移动阅读更方便
你可能感兴趣的文章