按天获取员工考勤报表信息

本文档介绍实现按天获取员工考勤报表信息。

说明

本文档以企业内部应用实现为例，第三方企业应用实现流程与本文档流程一致。

预期效果

考勤统计的能力是为了通过接口获取每一天的某些项指标的值。再经过开发者自行汇总每一天的值，可以实最终结果与钉钉管理后台-考勤打卡中的报表信息保持一致。

接入流程简介

本文介绍了按天获取员工考勤报表信息实现获取员工考勤统计中每天的值。按天获取员工考勤报表信息的流程。

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取应用AppKey和AppSecret。

步骤三：添加接口调用权限。单击“考勤”，申请考勤接口对应的权限。

步骤四：获取应用访问凭证获取企业内部应用的access_token。调用接口时，通过accessToken鉴权调用者身份。

步骤五：调用考勤相关API：

通过启用智能统计文档内容，实现开启智能统计。

调用服务端API-获取考勤报表列定义接口，获取考勤报表列**ID**。

根据考勤报表列**ID**，调用服务端API-获取考勤报表列值接口，实现获取列定义对应的值的信息。

重要

本流程并不是直接获取考勤月度汇总表的信息，当前开放接口实现的效果是获取每一天的某些项指标的值，最终统计结果需要开发者进行汇总。

比如需求是获取小明在12月份的应出勤天数统计信息，本流程获取的结果是小明在12月份每一天的应出勤天数值获取的结果如下

{
"column_vals":[{
   "column_vals":[
      {"date":"2021-12-01 00:00:00","value":"1.0"},
      {"date":"2021-12-02 00:00:00","value":"1.0"},
      {"date":"2021-12-03 00:00:00","value":"0.0"},
      ...
      {"date":"2021-12-31 00:00:00","value":"1.0"},
      ...
      ],"column_vo":{"id":7331XXX}}]}

步骤一：创建企业内部应用

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

登录开发者后台，创建企业内部应用。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取应用AppKey和AppSecret信息。

步骤三：添加接口权限

添加接口调用权限。单击“考勤”，申请考勤接口权限。

步骤四：获取应用访问凭证accessToken

重要

服务端API差异详情参见新旧版规范服务端API区别。

服务端API接口SDK下载，详情参见服务端SDK下载。

新版服务端API接口SDK下载，详情参见新版服务端SDK下载。

以下接口均使用服务端API接口，SDK下载详情参见服务端SDK下载。

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的access_token。

public void getAccessToken() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
        OapiGettokenRequest req = new OapiGettokenRequest();
        req.setAppkey("dingxxxxxxxxxhgn");
        req.setAppsecret("9G_xxxxxxxxxxxxxxx1JDf0Qq3nexxxxxxxxGIO");
        req.setHttpMethod("GET");
        OapiGettokenResponse rsp = client.execute(req);
        System.out.println(rsp.getBody());
    }

步骤五：调用考勤相关API

通过启用智能统计文档内容，实现开启智能统计。

调用服务端API-获取考勤报表列定义接口，获取考勤报表列**ID**。

 public void attendanceColumns() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getattcolumns");
        OapiAttendanceGetattcolumnsRequest req = new OapiAttendanceGetattcolumnsRequest();
        OapiAttendanceGetattcolumnsResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

说明

获取列定义不包含请假信息，如需获取报表内的请假统计信息，调用获取报表假期数据接口即可。

根据考勤报表列**ID**，调用服务端API-获取考勤报表列值接口，实现获取列定义对应的值的信息。

 public void attendanceColumnsValue() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getcolumnval");
        OapiAttendanceGetcolumnvalRequest req = new OapiAttendanceGetcolumnvalRequest();
        req.setUserid("01472825524039877041");
        req.setColumnIdList("184678999,184727001");
        req.setFromDate(StringUtils.parseDateTime("2022-10-24 00:00:00"));
        req.setToDate(StringUtils.parseDateTime("2022-10-25 00:00:00"));
        OapiAttendanceGetcolumnvalResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

按天获取员工考勤报表信息

预期效果#

接入流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

步骤四：获取应用访问凭证accessToken#