Odoo集成钉钉模块说明-基础应用

QQ截图20210707210906.png

本文将介绍odoo集成钉钉模块-基础应用(dingtalk_base )模块的配置和使用。

github地址: https://github.com/suxuefeng20/odooDingTalk

基础模块包含功能

  • 参数配置

配置钉钉的api参数,用于odoo与钉钉的通信

  • 回调配置

向钉钉服务器注册我们的odoo回调地址,用于钉钉向odoo推送消息。

  • 钉钉部门同步

模块支持从配置的钉钉中同步部门数据,若注册了回调,在钉钉中修改部门数据后,odoo也会同步修改

  • 钉钉员工同步

支持自动、手动从钉钉中同步部门员工数据到odoo系统中,并支持钉钉回调。

  • 联系人同步

本功能支持同步钉钉联系人数据至odoo系统中

  • 同步员工头像

支持将odoo中钉钉员工的头像替换为钉钉员工头像。

一、模块的安装

在安装模块前,务必先安装额外的三方库 requirements.txt 文件中

pip3 install -r $PATH/requirements.txt    // 注意$PATH为你的实际路径!.

载所需要的钉钉模块后,刷新应用列表,在应用中搜索 “dingtalk” 即可查看所有的钉钉模块,基础模块只需要安装dingtalk_base 就好了。点击安装后,耐心等待系统安装完成...

t2.png

二、参数配置

1. 基本参数

参照钉钉官方文档创建一个企业内部开发小程序用于对钉钉模块进行授权等, 创建钉钉企业内部应用流程

  • 配置odoo钉钉模块参数:

t3.png

创建好钉钉应用后,前往已安装好的钉钉模块中,参数配置项下,创建一个属于该公司的参数配置信息

t4.png

t5.png

  • 填写完成后点击保存即可。到这里后一般来说就可以正常拉取基础数据了

t6.png

2.应用回调

回调功能主要用于钉钉主动推动消息到odoo系统,odoo系统根据钉钉的消息内容来处理各种信息,比如当钉钉端的员工数据发生了变化时,钉钉会主动推送发生变化的员工数据至odoo系统,odoo系统收到消息后,主动从钉钉中去同步该员工的最新信息。这里有钉钉官方的介绍:https://developers.dingtalk.com/document/app/push-events 在钉钉模块下,配置菜单-钉钉回调中创建或拉取已存在的回调记录

t7.png

一般情况下,点击创建后,默认生成的参数不需要修改。你可以根据实际情况修改要注册的回调事件。确认无误后点击“注册回调事件”按钮,此时系统会向钉钉服务器发出注册请求。钉钉服务器同时会向我们的服务器发送一个检查请求。注册成功后这个回调列表将会显示为“已注册”。

t8.png

注: 要使用钉钉回调功能,odoo服务器的ip地址必须为公网ip,并且外网可通过这个地址访问到odoo。否则将导致注册失败,或钉钉无法将消息内容发送到odoo中。

三、常见问题.

  • 安装完成后主界面不存在钉钉模块

解决办法: 出现此问题时,请检查本用户是否配置了钉钉的操作权限,在系统设置-用户下选择对应的用户,给该用户的“钉钉-基础配置”设置为【管理员】即可。 然后刷新界面,不出意外主界面上的钉钉图标已经出来了。

  • 安装模块时报错

由于安装时可能会受系统环境的诸多因素,一般都是为正确安装第三方python依赖包导致的, 安装失败时,可手动安装["pycryptodome", "dingtalk-sdk", "pendulum"]这三个包, 注意:如果操作系统中存在多个python环境时,特别注意要在odoo运行的python环境下安装。

  • 同步部门、员工时不成功

出现这个问题时,请首先根据报错的提示去修改参数配置,或则检查odoo服务器ip地址是否加入到了钉钉服务器出口IP。 具体参考:

  • 其他错误时请在QQ群(1019231617)或Email反馈给开发者。
最后修改:2021 年 07 月 07 日 09 : 20 PM
如果觉得我的文章对你有用,请随意赞赏