# 企业微信考勤查询-连接器介绍与配置说明
# 连接器介绍
# 连接器简介
【企业微信考勤查询 】连接器，连通了七巧与【企业微信】内置的考勤功能。
通过该连接器可以直接获取指定人员在固定时间范围内的考勤日报和月报数据，包括考勤天数统计，异常考勤统计，每日打卡时间，假勤情况等等内容
# 业务场景
【企业微信考勤查询 】可以实现七巧与企业微信考勤数据的连通，存储与复用。围绕这些考勤数据，用户可以在七巧上实现丰富的功能。
例如：在人事每月结算工资时，就能直接查询到本月员工在企业微信考勤系统上的考勤数据，直接在七巧内存档，最后再根据这些数据进行工资的核对与修正。
# 配置说明
# 配置入口
表单添加按钮/自定义按钮-执行后-连接器配置
流程-系统任务-执行事件-连接器配置
# 配置操作
# 1.配置请求事件
筛选条件属于必填项，可配置 id = id的方式实现选择数据的一一对应。
# 2.配置接口请求
使用连接器之前，需要先获取对应的鉴权id，本连接器需要的id获取地址如下：
企业id获取路径如下：
企业微信后台获取
应用secret获取路径如下：
企业微信后台获取
账号id：
管理员可在企业微信管理后台【通讯录->成员信息】查看成员帐号或在【手机端->通讯录->右上角编辑->选择成员->编辑成员】可查看成员帐号。
若道一云通讯录和企业微信同步，也可以直接从道一云通讯录内获取账号id，实现数据联动
# 3.配置返回事件
# ①配置事件类型：选择在【目标表】插入数据或在【当前表】更新数据
# ②配置插入信息，与【目标表】或【当前表】的表单字段联动
# 返回事件配置案例
获取月报数据-有关参数与说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
| datas | obj[] | 月报数据列表 |
| datas.base_info | obj | 基础信息 |
| datas.base_info.record_type | uint32 | 记录类型：1-固定上下班；2-外出（此报表中不会出现外出打卡数据）；3-按班次上下班；4-自由签到；5-加班；7-无规则 |
| datas.base_info.name | string | 打卡人员姓名 |
| datas.base_info.name_ex | string | 打卡人员别名 |
| datas.base_info.departs_name | string | 打卡人员所在部门，会显示所有所在部门 |
| datas.base_info.acctid | string | 打卡人员帐号，即userid |
| datas.base_info.rule_info | obj | 打卡人员所属规则信息 |
| datas.base_info.rule_info.groupid | int32 | 所属规则的id |
| datas.base_info.rule_info.groupname | string | 打卡规则名 |
| datas.summary_info | obj | 汇总信息 |
| datas.summary_info.work_days | int32 | 应打卡天数 |
| datas.summary_info.regular_days | int32 | 正常天数 |
| datas.summary_info.except_days | int32 | 异常天数 |
| datas.summary_info.regular_work_sec | int32 | 实际工作时长，为统计周期每日实际工作时长之和 |
| datas.summary_info.standard_work_sec | int32 | 标准工作时长，为统计周期每日标准工作时长之和 |
| datas.exception_infos | obj[] | 异常状态统计信息 |
| datas.exception_infos.exception | uint32 | 异常类型：1-迟到；2-早退；3-缺卡；4-旷工；5-地点异常；6-设备异常 |
| datas.exception_infos.count | int32 | 异常次数，为统计周期内每日此异常次数之和 |
| datas.exception_infos.duration | int32 | 异常时长（迟到/早退/旷工才有值），为统计周期内每日此异常时长之和 |
| datas.sp_items | obj[] | 假勤统计信息 |
| datas.sp_items.type | uint32 | 假勤类型：1-请假；2-补卡；3-出差；4-外出；100-外勤 |
| datas.sp_items.vacation_id | uint32 | 具体请假类型，当type为1请假时，具体的请假类型id，可通过审批相关接口获取假期详情 |
| datas.sp_items.count | uint32 | 假勤次数，为统计周期内每日此假勤发生次数之和 |
| datas.sp_items.duration | uint32 | 假勤时长，为统计周期内每日此假勤发生时长之和，时长单位为天直接除以86400即为天数，单位为小时直接除以3600即为小时数 |
| datas.sp_items.time_type | uint32 | 时长单位：0-按天 1-按小时 |
| datas.sp_items.name | string | 统计项名称 |
| datas.overwork_info | obj | 加班情况 |
| datas.overwork_info.workday_over_sec | int32 | 工作日加班时长 |
| datas.overwork_info.holidays_over_sec | int32 | 节假日加班时长 |
| datas.overwork_info.restdays_over_sec | int32 | 休息日加班时长 |
获取日报数据-有关参数与说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
| datas | obj[] | 日报数据列表 |
| datas.base_info | obj | 基础信息 |
| datas.base_info.date | uint32 | 日报日期 |
| datas.base_info.record_type | uint32 | 记录类型：1-固定上下班；2-外出（此报表中不会出现外出打卡数据）；3-按班次上下班；4-自由签到；5-加班；7-无规则 |
| datas.base_info.name | string | 打卡人员姓名 |
| datas.base_info.name_ex | string | 打卡人员别名 |
| datas.base_info.departs_name | string | 打卡人员所在部门，会显示所有所在部门 |
| datas.base_info.acctid | string | 打卡人员帐号，即userid |
| datas.base_info.rule_info | obj | 打卡人员所属规则信息 |
| datas.base_info.rule_info.groupid | int32 | 所属规则的id |
| datas.base_info.rule_info.groupname | string | 打卡规则名 |
| datas.base_info.rule_info.scheduleid | int32 | 当日所属班次id，仅按班次上下班才有值，显示在打卡日报-班次列 |
| datas.base_info.rule_info.schedulename | string | 当日所属班次名称，仅按班次上下班才有值，显示在打卡日报-班次列 |
| datas.base_info.rule_info.checkintime | obj[] | 当日打卡时间，仅固定上下班规则有值，显示在打卡日报-班次列 |
| datas.base_info.rule_info.checkintime.work_sec | uint32 | 上班时间，为距离0点的时间差 |
| datas.base_info.rule_info.checkintime.off_work_sec | uint32 | 下班时间，为距离0点的时间差 |
| datas.base_info.day_type | uint32 | 日报类型：0-工作日日报；1-休息日日报 |
| datas.summary_info | obj | 汇总信息 |
| datas.summary_info.checkin_count | int32 | 当日打卡次数 |
| datas.summary_info.regular_work_sec | int32 | 当日实际工作时长，单位：秒 |
| datas.summary_info.standard_work_sec | int32 | 当日标准工作时长，单位：秒 |
| datas.summary_info.earliest_time | int32 | 当日最早打卡时间 |
| datas.summary_info.lastest_time | int32 | 当日最晚打卡时间 |
| datas.holiday_infos | obj[] | 假勤相关信息 |
| datas.holiday_infos.sp_number | string | 假勤申请id，即当日关联的假勤审批单id |
| datas.holiday_infos.sp_title | obj | 假勤信息摘要-标题信息 |
| datas.holiday_infos.sp_title.data | obj[] | 多种语言描述，目前只有中文一种 |
| datas.holiday_infos.sp_title.data.text | string | 假勤信息摘要-标题文本 |
| datas.holiday_infos.sp_title.data.lang | string | 语言类型："zh_CN" |
| datas.holiday_infos.sp_description | obj | 假勤信息摘要-描述信息 |
| datas.holiday_infos.sp_description.data | obj[] | 多种语言描述，目前只有中文一种 |
| datas.holiday_infos.sp_description.data.text | string | 假勤信息摘要-描述文本 |
| datas.holiday_infos.sp_description.data.lang | string | 语言类型："zh_CN" |
| datas.exception_infos | obj[] | 校准状态信息 |
| datas.exception_infos.exception | uint32 | 校准状态类型：1-迟到；2-早退；3-缺卡；4-旷工；5-地点异常；6-设备异常 |
| datas.exception_infos.count | int32 | 当日此异常的次数 |
| datas.exception_infos.duration | int32 | 当日此异常的时长（迟到/早退/旷工才有值） |
| datas.ot_info | obj | 加班信息 |
| datas.ot_info.ot_status | uint32 | 状态：0-无加班；1-正常；2-缺时长 |
| datas.ot_info.ot_duration | uint32 | 加班时长 |
| datas.ot_info.exception_duration | uint32[] | ot_status为2下，加班不足的时长 |
| datas.sp_items | obj[] | 假勤统计信息 |
| datas.sp_items.type | uint32 | 类型：1-请假；2-补卡；3-出差；4-外出；100-外勤 |
| datas.sp_items.vacation_id | uint32 | 具体请假类型，当type为1请假时，具体的请假类型id，可通过审批相关接口获取假期详情 |
| datas.sp_items.count | uint32 | 当日假勤次数 |
| datas.sp_items.duration | uint32 | 当日假勤时长秒数，时长单位为天直接除以86400即为天数，单位为小时直接除以3600即为小时数 |
| datas.sp_items.time_type | uint32 | 时长单位：0-按天 1-按小时 |
| datas.sp_items.name | string | 统计项名称 |
1 / 0