钉钉智能考勤统计,接入智能考勤登记需要登陆开发者后台,在创建的应用中添加“查询企业考勤数据权限“;需要开启考勤智能统计。架构形态是一个Java单体应用,钉钉用户可以在页面上点击获取用户考勤信息根据日期和用户ID获取用户考勤信息,点击获取用户智能考勤统计信息根据日期范围统计用户考勤信息。包含功能:
- 获取用户考勤信息:调用本接口获取指定用户当天的考勤数据,包括打卡流水记录、打卡结果和审批列表等;
- 获取用户智能考勤统计信息:该接口用于获取钉钉智能考勤报表的列值数据,其中包含了一定时间段内报表某一列的所有数据,以及相关的列信息,不支持获取离职人员的考勤信息,离职人员的考勤数据可以在OA管理后台查询。
-
需要有一个钉钉注册企业,如果没有可以创建:https://oa.dingtalk.com/register_new.htm?source=1008_OA&lwfrom=2018122711522903000&succJump=oa#/
-
成为钉钉开发者,参考文档:https://developers.dingtalk.com/document/app/become-a-dingtalk-developer
-
登录钉钉开放平台后台创建一个H5应用: https://open-dev.dingtalk.com/#/index
-
配置应用
配置开发管理,参考文档:https://developers.dingtalk.com/document/app/configure-orgapp
配置免登相关权限:https://developers.dingtalk.com/document/app/address-book-permissions
添加查询企业考勤数据权限
#钉钉组织ID
corpId=xxxxx
#H5应用Key
appKey=xxxx
#H5应用秘钥
appSecret=xxxxxx
- 首页获取corpId https://open-dev.dingtalk.com/#/index
- 进入应用-基础信息获取appKey、appSecret
git clone
https://github.com/open-dingtalk/h5app-attendance-reports-demo.git
cd frontend/
npm install
npm run build
- 考勤统计权限申请,文档链接:https://developers.dingtalk.com/document/app/apply-for-permissions
- 启用智能统计,文档链接:https://developers.dingtalk.com/document/app/enable-intelligent-statistics
- 获取报表列定义,文档链接:https://developers.dingtalk.com/document/app/queries-the-enterprise-attendance-report-column
- 获取报表列值,文档链接:https://developers.dingtalk.com/document/app/obtains-the-column-values-of-the-smart-attendance-report
- 获取用户考勤数据,文档链接:https://developers.dingtalk.com/document/app/obtain-the-attendance-update-data