钉钉npm脚手架,支持考勤信息获取

时间 2019-11-07

标签钉钉 npm 脚手架支持考勤信息获取繁體版

原文原文链接

钉钉官方并未提供nodejs包,第一次调用接口的时候很是费事,并且尝试去寻找相关的钉钉考勤数据模块的时候只找到了一些消息啊,只能办公啊,免登啊之类的模块,有关考勤数据的彷佛没有关于dd的npm包中一个有较全面,可是这个包彷佛是egg的模块,我没有尝试单独使用javascript

不得不说钉钉小程序的服务端api真的恶心,为了得到考勤数据要拿access_tonken而后再拿员工id列表,而后再拿员工id列表对应的员工姓名和部门,而后才能拿员工考勤数据,这个考勤数据还有限制,不能查询半年之前的,一次获取的结果还有限制,真的让人很无语,并且服务端还不支持websocket,也就是说每次查询还得 ## 使用方法 须要拿考勤信息的人请注意由于拿下来的数据要放到内存当中处理,因此这个脚手架须要一点启动时间(100人大概3秒左右)才能拿到数据,3秒后随便调用考勤信息若是仅仅是须要获取用户/部门信息,发送工做消息,则不须要准备时间(可是这这包会自动准备到用户id/姓名部门的对应表阶段,)java

安装node

npm install ddinitgit

以为好用的话麻烦给个star吧,感激涕零es6

构建并使用,后三位选填,不填的话不会缓存周/月考勤数据,最后一位是每日考勤数据的更新速度,单位是毫秒github

  import DDdata from 'ddinit'
  const dd =  new DDdata('这里换成你的appkey', '这里换成你的appsecret', 4, 2, 500)
复制代码

尽管这个包是用es6,7语法书写的,它仍然支持commonjs调用,这意味着你能够再例如koa2这种较为先进的node服务中使用,也能够在express中使用web

详细使用能够参照这里的示例express

考勤api

我猜你很忙,因此这里先展现核心api,另外,全部的api参数都是选填,不传参数可使用npm

构建时传入周/月数据缓存大小大于1时,会把请求结果暂存在内存中,方便开发和后续调用,使用时,直接**dd.moondata[0]**便可拿到缓存的上月数据,**dd.moondata[1]便可拿到缓存的上2月数据,以此类推,使用dd.weekdata[0]**获取缓存的上周的数据小程序

**dd.daliyData[]**返回缓存的每日数据 **dd.data.userIdList[]**返回在职员工id列表,包含(2，试用期；3，正式；5，待离职；-1，无状态) **dd.data.employee[]**返回在职员工花名册,包含(id,姓名,部门,职位)信息

dd.cooldata.dimissionList 返回离职员工id列表 dd.cooldata.employee 返回离职员工花名册,包含(id,姓名,部门,职位)信息

月考勤数据 dd.getMoonData() 传入参数(

返回上num月的数据,不传数据默认获取上月在职员工的打卡数据(不会解析离职员工信息,返回'已离职')
@param num 获取上num月的数据,默认为1,传或不传为上月数据,传2位上第二月数据,以此类推,最多查询至半年之前
@param ix 暂存下标
@param offsetis 分页值
@param limitis 分页数据大小
@param list 员工id:名字信息表
@param token 秘钥 ) 返回示例

[
  {
    "name": "张三",
    "userId": "234567898765456",
    "branch": "法律部",
    "checkType": "OffDuty",
    "timeResult": "Normal",
    "workDay": "0",
    "sortTime": 1561111490000,
    "baseCheckTime": 1561111200000,
    "locationResult": "Normal",
    "userCheckTime": "6/21/2019, 6:04:50 PM"
  },
  {
    "name": "代成伟",
    "userId": "234567898765456",
    "branch": "法律部",
    "checkType": "OffDuty",
    "timeResult": "Normal",
    "workDay": "0",
    "sortTime": 1560506875000,
    "baseCheckTime": 1560506400000,
    "locationResult": "Normal",
    "userCheckTime": "6/14/2019, 6:07:55 PM"
  },
  ..more
复制代码

sortTime是Unix时间戳,单位为毫秒,能够以此与baseCheckTime计算迟到时间或先到时间,加班时间等,workDay为节假日断定,0表示工做日,1-3法定节假日,67分别表明周六和周日,其他返回值参考钉钉文档

周考勤数据 dd.getWeekData() 传入参数(

返回上num周的数据,不传数据默认获取上周在职员工的打卡数据(不会解析离职员工信息,返回'已离职')
@param num 获取上num周的数据默认为1,传或不传为上周数据,传2位上第二周数据
@param ix 暂存下标
@param offsetis 分页值
@param limitis 分页数据大小
@param list 员工id:名字信息表
@param token 秘钥 )

返回类型同上

每日考勤数据,这里根据构建时传入的更新速度自动更新dd.gettoDayData() 传入参数(

不传参时,默认以3秒一次获取在职员工每日打卡结果
@param offsetis 分页值,不传参默认以0开始
@param limitis 分页大小,也就是每一次查询时的返回数据条数,默认为50
@param list 员工列表,默认使用在职员工信息
@param token 秘钥
@returns array 返回在职员工打卡结果 )

返回类型同上

获取任意两个时间之间的用户考勤信息,最长间隔7天dd.getKaoqingLists() 传入参数(

获取time1和time2之间的用户考勤信息,time1和time2最长间隔7天
@param useridList 用户id列表,查询考勤数据必填选项
@param employeeList 用户id与姓名,部门,职位等信息表,格式为数组对象[{name:name,branch:branch}]
@param time1 查询所需的开始时间
@param time2 查询所需的结束时间
@param offsetis 分页值,默认从0开始
@param limitis 单页数据大小,默认为50
@param apiUrl 请求的url这里彷佛是固定的
@param start 用户id列表的查询起始值,默认从0开始
@param token 秘钥 )

返回类型同上

小程序相关api

这部分参考了dd-sdk模块

获取access_token

dd.AccessToken
复制代码

获取用户ID

dd.getUserId(code: string, token?: string)
复制代码

获取用户信息

dd.getUser(userid: string, token?: string)
复制代码

获取子部门列表

dd.childDepartment(id: number, token?: string)
复制代码

获取部门列表

dd.department(id: number, token?: string)
复制代码

获取部门信息

dd.departmentInfo(id: number, token?: string)
复制代码

查询部门的全部上级父部门路径

dd.getAllDepartment(id: number, token?: string)
复制代码

查询指定用户的全部上级父部门路径

dd.departmentListParentDepts(userId: string, token?: string)
复制代码

获取企业员工人数

dd.getOrgUserCount(onlyActive: number, token?: string)
复制代码

发送工做消息

dd.setWorkerMessage(data: IMessage, token?: string)
复制代码

查询工做通知消息的发送进度

dd.viewWorkerMessage(data: ITask, token?: string)
复制代码

查询工做通知消息的发送结果

dd.resultWorkerMessage(data: ITask, token?: string)
复制代码

建立一个审批实例

dd.createProcessInstance(data: IInstance, token?: string)
复制代码

获取审批实例

dd.getProcessInstance(id: string, token?: string)
复制代码

注册审批回调

dd.registerCallBack(data: IRegisterCallBack, token?: string)
复制代码

注册事件回调时要实例化crypto

dd.instanceCrypto(data: ICrypto)
复制代码

获取事件回调

dd.getCallBack(token?: string)
复制代码

删除回调注册事件

dd.deleteCallBack(token?: string)
复制代码

受权登陆(H5微应用/第三方应用)

import { authEncrypto } from "dd-sdk";

authEncrypto(accessKey: string, appSecret: string, code: string)
复制代码