Odoo平台集成钉钉应用

前言：

本应用主要基于OdooERP开发，支持社区版和企业版，当前版本仅支持12版本可自行下载后根据实际情况进行增加完善和调整功能。

在使用本模块前，请先将钉钉中你创建的E应用或微应用权限放开和配置出口ip，得到钉钉应用的 AppKey和 AppSecret，至于钉钉后台中的配置请参照：>https://open-doc.dingtalk.com/microapp/bgb96b odoo-DingDing模块组成：

博客地址： https://sxfblog.com/index.php/archives/371.html

-主要功能：

仪表盘 (v1.0)

用于显示我的待办、公告数、待审批数、消息等相关信息
消息 (v1.0)

1.工作消息：工作消息是odoo向钉钉工作通知中推送相关消息
- 消息通知(v1.1)
1. 工作通知消息：是以企业工作通知会话中某个微应用的名义通知到员工个人，例如审批通知、任务通知、工作项通知等。
2. 群消息：向钉钉群发送消息，仅限企业内部开发使用。
3. 普通消息：员工个人在使用应用时，通过界面操作的方式把消息发送到群里或其他人，例如发送日志的场景。
2.消息模板：用于odoo各种单据创建后向钉钉推送相关单据的基本信息
待办 (v1.5)

1.待办列表：显示相关待办列表，并更新相关待办事项

2.发起待办：在odoo中向钉钉中发起待办
考勤 (v1.4)

1.考勤组：拉取钉钉相对应的考勤组及考勤组成员

2.打卡列表：拉取钉钉人员打卡信息，手动进行拉取，每次只能拉取7天的打卡信息
签到 (v1.3)

1.签到记录：获取钉钉相对应的签到记录

2.用户签到记录：用户签到记录

3.部门签到记录：部门签到记录
审批 (v1.3)需结合oa协同办公模块使用

1.审批模板：获取钉钉相对应的审批模板

2.审批单据关联：关联协同办公中相关的审批流程
回调管理 (v2.0)

1.回调管理列表：对应钉钉开放平台相关回调类型通讯录事件、群会话事件、签到事件、审批事件

2.钉钉回调管理：创建、注册、获取钉钉回调事件
智能人事 (v1.3)

1.员工花名册：获取钉钉员工花名册

2.离职员工信息：获取钉钉离职员工信息
设置 (v1.0)

1.基础设置：用于设置钉钉各种API接口信息

2.系统参数列表：
存放钉钉提供的外部各种接口地址和token值等（Token值不会马上更新，在钉钉-设置-系统参数列表中查看，默认为0000）(v1.0)

3.钉钉消息类型：用于和钉钉通讯的消息类型
手动同步基础信息 (v1.1)

在对应的联系人、员工、部门看板视图或列表视图中可点击同步按钮，拉取钉钉中的数据，也可将odoo系统中的数据上传至钉钉中，目前仅支持单个上传，批量上传将 >会在下个更新版本中体现
通讯录管理(用户、部门、联系人) (v1.2)

实现在odoo中删除(员工、部门、联系人）时，自动将信息传递至钉钉，做到实时将odoo的信息与钉钉同步；该功能需在设置项中灵活开启。

常见问题：

安装odooDingDing或者升级其中模块时候请注意

1.一定要通过主模块ali_dindin进行安装、升级，以免出现错误！
钉钉扫码登录后会报错：Internal Server Error

1.一般这样的问题不是程序出错，请检查钉钉->设置中的扫码登录AppId、扫码登录appsecret。

2.检查钉钉后台中的。移动接入应用并配置好回调地址(即odoo地址) http://ip:port/web/action_login

Ip:port为对应的IP地址和端口 /web/action_login 为回调函数。（现阶段未做优化，在回调管理中创建回调事件的时候请填写对应服务器地址）

安装扫码登录以后，记得修改所有账号的密码，不然会出现Internal Server Error错误！！！！！
仪表盘：获取公告失败,详情为:无效的USERID、代审批数、公告数

这个错误通常情况是在刚安装完成时出现的，但不影响使用，安装完成后在设置->钉钉设置中，配置好钉钉API应用信息。手动或自动同步钉钉上的员工数据到odoo中后就不会出现这样的问题
拉取考勤组成员的时候提示：考勤组有更新,请先拉取最新的考勤组!

那就点击拉取考勤组成员旁的拉取考勤组即可
考勤组成员列表无法更新

钉钉未提供odoo上更新考勤成员的api。故无法自动推送到钉钉服务器
协同办公提交审批后，已通过钉钉审批单odoo中未更新状态
1. 检查odoo钉钉中的审批模板是否存在
2. 检查odoo钉钉中审批单据关联是否正确
3. 重要：钉钉回调管理是否配置正确并已注册
满足以上三点即可正常使用审批同步

odoo中的审批单据中的信息无法回传到钉钉的审批单中，请知悉
财务审批中的表单需要自动生成凭证(日记账分录)，则需要配置凭证模板，位置：协同办公->设置->凭证模板

1.审批表单只支持单行输入框、多行输入框、图片、明细(只能包含单行输入框、图片)三种控件,请对应odoo上的审批模板对钉钉审批模板进行调整

2.拉取钉钉审批单以后，请前往钉钉->审批关联中进行配置
若看不到的请检查权限

钉钉回调管理：注册时一直提示《返回非susssuccess》

这是因为实际情况拓展了odoo原生的http.py文件而导致的。

解决办法是：将dindin_callback模块中的file文件夹下的http.py文件覆盖/替换到odoo-root/odoo/http.py文件

Odoo-root: 为odoo源码目录
关于通讯录管理(员工、部门、联系人)

拉取用户时候，请先拉取部门，再拉取用户不然会报错

拉取用户以后记得和odoo系统中相关账号进行绑定操作（用户-HR设置关联）

已经存在odoo联系人中的联系人如果需要上传到钉钉通讯录，请完善负责人和标签，不然无法进行上传到钉钉
关于其他模块

智能人事、文件存储、日志等其他功能以及更多的协同表单将在后续继续完善。但非开源模块。需要的请留言！！ 博客地址： https://sxfblog.com/index.php/archives/371.html

kalmenchia/odoo-DingDing

Odoo平台集成钉钉应用

常见问题：