异行星低代码平台--第三方插件对接:企业微信平台对接(二)

2023-11-22 01:20

本文主要是介绍异行星低代码平台--第三方插件对接:企业微信平台对接(二),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

异行星低代码平台可以集成企业微信,实现单点登录、消息推送和组织机构同步。

提示

此功能需要异行星低代码平台企业版授权才能使用。

企业微信集成​

单点登录

异行星低代码平台集成到企业微信后,只要使用企业微信账户登录企业微信客户端,即可在企业微信中直接使用管理后台,而不需要再次使用管理后台账户来登录使用。

消息推送

异行星低代码平台集成到企业微信后,当其绑定的管理后台账户有通知消息时,企业微信会弹出消息提醒,可点击该消息直接进入管理后台查看或处理相关消息。

同步通讯录

异行星低代码平台集成到企业微信后,可以将企业微信的通讯录同步到管理后台系统中。

如何集成企业微信​

在集成企业微信前,请确保您的管理后台项目已经绑定到某个可通过互联网访问进入的域名地址,只能通过局域网IP或外网IP地址访问的管理后台项目是不可以集成到企业微信的,以下说明均假定您的项目已经绑定到域名地址https://www.test-qywx.com

创建企业微信应用​

请注册企业微信,并在企业微信后台(应用管理->应用)创建一个应用,以下说明都假设这里创建了一个名为“管理后台合同”的应用。

设置企业微信应用可见范围​

请在企业微信后台,进入刚刚创建的“管理后台合同”应用,并编辑该应用的可见范围,只有该范围内的用户可以在其企业微信客户端中看到该应用,也只有这些用户可以收到来自该应用的消息推送通知。

设置企业微信应用主页​

请在企业微信后台,进入刚刚创建的“管理后台合同”应用,并在“功能”栏中找到“工作台应用主页”并点击其下方的“设置应用主页”按钮来设置应用主页。

这里需要输入的是您的管理后台项目的域名访问地址加上/api/qiyeweixin/mainpage后缀,比如https://www.test-qywx.com/api/qiyeweixin/mainpage

异行星低代码平台集成企业微信的单点登录功能使用的就是`/api/qiyeweixin/mainpage`这个路径指向的接口。

设置企业微信应用可信域名​

请在企业微信后台,进入刚刚创建的“管理后台合同”应用,并在“开发者接口”栏中找到“网页授权及JS-SDK”并点击其下方的“设置可信域名”按钮来设置可信域名。

可作为应用OAuth2.0网页授权功能的回调域名:直接输入管理后台项目的域名访问地址即可,比如www.test-qywx.com

可调用JS-SDK、跳转小程序的可信域名(最多10个,需完成域名校验):直接输入管理后台项目的域名访问地址即可,比如www.test-qywx.com

域名归属验证:点击此处的“申请校验域名”链接并按提示操作,底下的“用于OAuth2.0回调的可信域名是否校验”勾选框也必须勾选。

要集成企业微信到管理后台,必须完成这里提到的“域名归属验证”,不排除其不支持`http`域名地址,推荐使用`https`域名地址。

设置企业微信事件订阅​

请在企业微信后台,选择管理工具,点击“通讯录同步” 开启API接口同步进行相关配置。

同步方式:API接口

权限:API编辑通讯录

Secret: 查看或者重新获取,需要配置到管理后台系统-设置-公司设置-企业微信-Secret

设置接收事件服务器:Token和EncodingAESKey随机获取后,需要配置到管理后台系统-设置-公司设置-企业微信中;URL设置前请先确保已经将Token和EncodingAESKey配置到管理后台系统中,然后再配置管理后台服务的域名地址加上api/qiyeweixin/listen后缀,比如https://www.test-qiyeweixin.com/api/qiyeweixin/listen,一定要配置公网域名访问地址。

添加企业微信插件​

异行星低代码平台企业版服务默认集成了企业微信插件。

绑定企业微信应用​

在启用企业微信插件之后,管理后台管理员可以在管理后台的“设置->公司设置->公司”界面看到新加了一栏“企业微信”,完善这些信息即可把企业微信应用绑定到管理后台中。

  • 企业ID(CorpId):在企业微信后台,“我的企业->企业信息”界面可以查看和复制该ID值。
  • AgentID:在企业微信后台,“应用管理->管理后台合同”界面可以查看和复制该ID值。
  • Secret:在企业微信后台,“应用管理->管理后台合同”界面可以查看和复制该ID值。
  • Token:在企业微信后台,“管理工具->通讯录同步->设置事件接受服务器”中随机生成。
  • AesKey:在企业微信后台,“管理工具->通讯录同步->设置事件接受服务器”中随机生成。

在企业微信中使用管理后台​

把企业微信集成到管理后台之后,还需要在管理后台中配置每个用户的“企业微信账号”才能正常在企业微信中使用管理后台。

系统管理员可以通知需要在企业微信中使用管理后台的用户前往企业微信的通讯录中查找自己的“企业微信账号”,并把它复制下来,然后在管理后台的“设置->个人账户设置->我的资料”界面上编辑保存其“企业微信账号”信息;也可以统一由系统管理员在管理后台“设置->公司设置->用户”界面上维护每个用户在企业微信通讯录上的“企业微信账号”信息。

修改本地adminos-config.yml文件,添加tenant._id、api_key和log_path,可以在设置-个人账户设置-API Key菜单下,获取用户的API Key。

tenant:_id: ${adminos_TENANT_ID}qywx:api_Key: ${APIKEY} # API Key, 接口验证需要log_path: ${QYWX_LOGPATH} # 日志文件路径,默认是./qywx_server.log

如果是用docker部署的用户,请修改docker-compose.yml文件,添加APIKEY和QYWX_LOGPATH环境变量:

  adminos:image: adminos/adminos-project-template:2.0.40restart: alwaysports:- "3000:3000"volumes:- "./docker-volumes/adminos/storage:/app/storage"environment:- PORT=3000- ROOT_URL=http://localhost:3000- MONGO_URL=mongodb://mongo:27017/adminos- MONGO_OPLOG_URL=mongodb://mongo:27017/local- adminos_CFS_STORE=local- adminos_STORAGE_DIR=/app/storage- TRANSPORTER=redis://redis:6379- CACHER=redis://redis/1- APIKEY=n32D3LeG8aIq5_jiiss23ssesf023sPGe # 配置系统中的API Key- QYWX_LOGPATH="./qywx_server.log" # 日志默认路径- adminos_TENANT_ID=7asfxossf8sfssss # 管理后台id

以上所有就绪后,管理后台用户只要登录企业微信账户就可以在企业微信客户端上无缝使用管理后台服务了。

工作台​

如果企业微信上集成了上述创建的“管理后台合同”项目,那么只要在手机或PC客户端登录了企业微信,就可以在其“工作台”栏上看到“管理后台合同”这个应用,直接点击即可进入应用主页。

消息​

如果企业微信上集成了上述创建的“管理后台合同”项目,那么只要在手机或PC客户端登录了企业微信,当其绑定的管理后台账户上有推送通知消息时,企业微信客户端会主动通知用户收到推送通知,也可以在其“消息”栏上直接看到来自管理后台的消息列表。

用户同步​

如果企业微信上集成了上述创建的“管理后台合同”项目,可以通过前台调用数据同步接口将企业微信通讯录同步到管理后台系统中,例如调用https://www.test-qiyeweixin.com/api/qiyeweixin/stockData,同步前如果管理后台系统中已经存在用户,需要将用户与企业微信中对应的用户进行绑定,这样在同步时就会更新已存在用户信息。

同步企业微信账户id​

如果企业微信上集成了上述创建的“管理后台合同”项目,对于只需要同步企业微信账户id到管理后台系统的用户,在配置完权限管理后,可以调用https://www.test-qiyeweixin.com/api/sync/qywxId进行同步。

这篇关于异行星低代码平台--第三方插件对接:企业微信平台对接(二)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/406430

相关文章

利用Python调试串口的示例代码

《利用Python调试串口的示例代码》在嵌入式开发、物联网设备调试过程中,串口通信是最基础的调试手段本文将带你用Python+ttkbootstrap打造一款高颜值、多功能的串口调试助手,需要的可以了... 目录概述:为什么需要专业的串口调试工具项目架构设计1.1 技术栈选型1.2 关键类说明1.3 线程模

Python Transformers库(NLP处理库)案例代码讲解

《PythonTransformers库(NLP处理库)案例代码讲解》本文介绍transformers库的全面讲解,包含基础知识、高级用法、案例代码及学习路径,内容经过组织,适合不同阶段的学习者,对... 目录一、基础知识1. Transformers 库简介2. 安装与环境配置3. 快速上手示例二、核心模

Java的栈与队列实现代码解析

《Java的栈与队列实现代码解析》栈是常见的线性数据结构,栈的特点是以先进后出的形式,后进先出,先进后出,分为栈底和栈顶,栈应用于内存的分配,表达式求值,存储临时的数据和方法的调用等,本文给大家介绍J... 目录栈的概念(Stack)栈的实现代码队列(Queue)模拟实现队列(双链表实现)循环队列(循环数组

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析

C++使用printf语句实现进制转换的示例代码

《C++使用printf语句实现进制转换的示例代码》在C语言中,printf函数可以直接实现部分进制转换功能,通过格式说明符(formatspecifier)快速输出不同进制的数值,下面给大家分享C+... 目录一、printf 原生支持的进制转换1. 十进制、八进制、十六进制转换2. 显示进制前缀3. 指

深入理解Apache Kafka(分布式流处理平台)

《深入理解ApacheKafka(分布式流处理平台)》ApacheKafka作为现代分布式系统中的核心中间件,为构建高吞吐量、低延迟的数据管道提供了强大支持,本文将深入探讨Kafka的核心概念、架构... 目录引言一、Apache Kafka概述1.1 什么是Kafka?1.2 Kafka的核心概念二、Ka

使用Python实现全能手机虚拟键盘的示例代码

《使用Python实现全能手机虚拟键盘的示例代码》在数字化办公时代,你是否遇到过这样的场景:会议室投影电脑突然键盘失灵、躺在沙发上想远程控制书房电脑、或者需要给长辈远程协助操作?今天我要分享的Pyth... 目录一、项目概述:不止于键盘的远程控制方案1.1 创新价值1.2 技术栈全景二、需求实现步骤一、需求

Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码

《Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码》:本文主要介绍Java中日期时间转换的多种方法,包括将Date转换为LocalD... 目录一、Date转LocalDateTime二、Date转LocalDate三、LocalDateTim

SpringBoot实现微信小程序支付功能

《SpringBoot实现微信小程序支付功能》小程序支付功能已成为众多应用的核心需求之一,本文主要介绍了SpringBoot实现微信小程序支付功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作... 目录一、引言二、准备工作(一)微信支付商户平台配置(二)Spring Boot项目搭建(三)配置文件

jupyter代码块没有运行图标的解决方案

《jupyter代码块没有运行图标的解决方案》:本文主要介绍jupyter代码块没有运行图标的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录jupyter代码块没有运行图标的解决1.找到Jupyter notebook的系统配置文件2.这时候一般会搜索到