“考勤公式配置”的操作指引
1 简介
1.1 功能介绍
维护用于考勤核算的公式，可自定义公式的计算逻辑，以及存储核算结果的考勤项目。
1.2 应用场景
当遇到通过配置无法满足的个性化计算诉求时，可通过公式撰写计算逻辑。
1.3 系统路径
工时假勤云>工时假勤规则>公式方案>考勤公式配置
1.4 关键字段/按钮说明
1.4.1 关键字段说明
| 字段名称 | 详细解释 |
| 考勤项目 | 公式执行完成后，返回的结果数据，即要保存的考勤项目 |
1.4.2 关键按钮说明
| 按钮名称 | 详细解释 |
| 语法校验 | 检查公式代码中是否存在语法错误 |
| 格式标准化 | 将公式代码进行格式化，使代码的可读性更强，便于阅读 |
| 预览 | 最大化显示公式代码窗口，便于查看 |
2 主要操作
2.1 在“公式配置”，点击“新增”按钮
2.2在“新增公式配置”页面，编写公式
（1）设置基本信息
关键业务字段 | 详细解释 |
考勤项目 | 用于存储核算结果的考勤项目，包括明细项目、汇总项目、明细兼汇总项目等类型。
注： 1、公式是每天核算一遍并生成结果，还是每个人员考勤期间核算一遍并生成结果，是由公式在核算链中运行的位置决定； 2、当考勤项目的类型和核算阶段不匹配时，公式无法输出核算结果，例如：考勤项目类型为期间汇总，但公式却运行在日明细核算。 |
（2）撰写公式
通过将计算元素、函数、关键字、计算符、其他符号等进行组合，可形成一套完整的计算逻辑。
关键业务字段 | 详细解释 |
计算元素 | 1、计算元素是公式的入参； 2、目前提供了员工相关信息和考勤核算相关信息可供选择，每个计算元素的值的格式详见章节3； 3、允许客户通过二开埋点在“考勤核算-AE”下新增二级分类和计算元素（预置的分类和计算元素暂不允许客户修改），并允许用户定义该计算元素在日明细核算和期间汇总核算时的取值逻辑（目前暂时只允许取核算上下文中已有的数据）。 |
计算工具 | 1、目前考勤核算公式用到的计算工具仅“函数”一种，详见章节4； 2、若系统提供的标准函数不满足需求，可在如下路径自定义函数和计算逻辑： HR基础服务云>HR通用服务>函数配置>考勤函数 |
关键字、计算符号、其他符号 | 包括IF、ELSE等，具体的语法详见章节5。 |
2.3保存、提交、审核
3 计算元素说明
3.1 一级分类：业务信息-BI
二级分类 | 三级分类 | 四级分类 | 数据类型 | 示例 |
人员信息 | 姓名 | / | 字符串 | 张三 |
工号 | / | 字符串 | A0001 | |
出生日期 | / | 日期 | 1999-01-01 | |
结婚登记日期 | / | 日期 | 2023-01-01 | |
职业信息 | 用工开始日期 | / | 日期 | 2022-06-01 |
用工结束日期 | / | 日期 | 2023-12-31 | |
最后工作日 | / | 日期 | 2023-12-31 | |
首次用工开始时间 | / | 日期 | 2022-06-01 | |
试用期信息 | 实际转正日期 | / | 日期 | 2023-11-01 |
入职日期 | / | 日期 | 2022-06-01 | |
服务年限 | 参加工作时间 | / | 日期 | 2022-06-01 |
生育信息 | 本次生育胎儿数 | / | 数值 | 2 |
胎儿出生日期 | / | 日期 | 2023-06-01 | |
考勤档案 | 档案编号 | / | 字符串 | A-00000001 |
考勤管理组织编码 | / | 字符串 | ||
挂靠行政组织编码 | / | 字符串 | ||
国家/地区编码 | / | 字符串 | ||
考勤地点编码 | / | 字符串 | ||
考勤人员组编码 | / | 字符串 | ||
代管员工 | / | 字符串 | Y/N | |
属地员工类别编码 | / | 字符串 | ||
考勤标识编码 | / | 字符串 | ||
考勤方式 | 考勤方式_中文 | / | 字符串 | 多次卡/一次卡/不打卡 |
时区 | 时区编码 | / | 字符串 | |
考勤卡号 | 考勤卡号 | / | 字符串 | A0001 |
考勤人 | 最早考勤日期 | / | 日期 | 2023-01-01 |
最晚考勤日期 | / | 日期 | 2023-12-31 |
3.2 一级分类：考勤核算-AE
二级分类 | 三级分类 | 四级分类 | 数据类型 | 示例 |
核算日期 | 当前核算日期 | / | 日期 | 2023-12-20 |
当前人员考勤期间第一天 | / | 日期 | 2023-12-16 | |
当前人员考勤期间最后一天 | / | 日期 | 2023-12-31 | |
当前考勤期间第一天 | / | 日期 | 2023-12-01 | |
当前考勤期间最后一天 | / | 日期 | 2023-12-31 | |
考勤项目 | 预置项目 | 迟到时长 | 数值 | 12 |
…… | …… | |||
| 自定义项目 | 夜班次数 | 数值 | 1 | |
| …… | …… | |||
| 原始项目 | 原始迟到时长 | 数值 | 12 | |
| …… | …… | |||
排班数据 | 当日日期属性名称_中文 | / | 字符串 | 工作日/休息日/节假日 |
当日日期属性编码 | / | 字符串 | DS-0001（工作日） DS-0002（休息日） DS-0003（节假日） | |
当日日期类型名称_中文 | / | 字符串 | 工作日_带薪 | |
当日日期类型编码 | / | 字符串 | ||
当日班次名称_中文 | / | 字符串 | 常白班 | |
当日班次编码 | / | 字符串 | ||
当日班次类型 | / | 字符串 | 固定班次/核心弹性班次 | |
当日班次为OFF班 | / | 字符串 | Y/N | |
当日班次中间分割点 | / | 日期 | YYYY-MM-DD hh:mm:ss | |
当日全天班次时数 | / | 数值 | 8 | |
班次信息 | 上班卡_1_应打卡 | 日期 | YYYY-MM-DD hh:mm:ss | |
下班卡_1_应打卡 | 日期 | |||
上班卡_2_应打卡 | 日期 | |||
下班卡_2_应打卡 | 日期 | |||
上班卡_3_应打卡 | 日期 | |||
下班卡_3_应打卡 | 日期 | |||
上班卡_4_应打卡 | 日期 | |||
下班卡_4_应打卡 | 日期 | |||
最后的上班卡_应打卡 | 日期 | |||
最后的下班卡_应打卡 | 日期 | |||
前1日_最后的下班卡_应打卡 | 日期 | |||
打卡数据 | 多次卡记录 | 上班卡_1_有效卡 | 日期 | YYYY-MM-DD hh:mm:ss |
下班卡_1_有效卡 | 日期 | |||
上班卡_2_有效卡 | 日期 | |||
下班卡_2_有效卡 | 日期 | |||
上班卡_3_有效卡 | 日期 | |||
下班卡_3_有效卡 | 日期 | |||
上班卡_4_有效卡 | 日期 | |||
下班卡_4_有效卡 | 日期 | |||
最后的上班卡_有效卡 | 日期 | |||
最后的下班卡_有效卡 | 日期 | |||
前1日_最后的下班卡_有效卡 | 日期 | |||
| 时间对 | 全部时间对 | / | 数组 | 核算当天的全部时间对数组，通过时间对相关函数进行读取和操作 |
| 单据数据 | 出差单申请信 | / | 数组 | 员工出差申请单的相关信息，通过“获取单据申请信息”函数进行读 |
加班单申请信息 | / | 数组 | 与“出差单申请信息”类同 | |
休假单申请信 | / | 数组 | 与“出差单申请信息”类同 | |
常量参数 | 月加班时长限额 | / | 数值 | 在“常量参数”功能中创建和维护的参数，可在公式中使用。 |
| …… | / | …… |
注：当前核算日期、排班数据、打卡数据仅可在日明细核算时取值，期间汇总核算时取值结果为NULL。
4 考勤函数说明
函数名称 | 返回类型 | 函数说明 | 补充说明 |
取两个时间点之间相差时长 | 数值 |
|
