适用场景
当客户日常考勤管理的考勤月报中存在个性化考勤指标，而产品预制的出勤、休假、出差、加班等项目无法满足，且需要根据员工每天的出勤情况得到当天的个性化考勤指标，此时您就需要为客户的个性化考勤指标添加相应的自定义考勤项目。
自定义考勤项目创建之后，会在考勤月报中显示，通过考勤计算得到自定义考勤项目的结果。
| 信息 | ||
|---|---|---|
| ||
1、由于自定义考勤项目需要指定组织创建，所以考勤计算时，自定义考勤项目的计算结果优先以下级组织的规则为准； 2、由于考勤计算的特殊性（非常高频次的每人每天计算多次），自定义考勤项目非常影响月报计算速度及服务器性能，非必要考勤项目不要使用该功能！！！ 3、自定义考勤项目内公式计算结果为一个人员一天的结果，所以公式内可选项目和数据只有和当天有关的，如果考勤月报中的个性化考勤指标不需要每天都得到一个结果，只需要根据已有考勤项目进行汇总或通过一定的规则计算得到，那么此时不需要创建自定义考勤项目，可以通过定义月汇总项目，在考勤月报的月汇总中查看即可，另外，如果只是想在月报显示，而不用在其他地方，要使用模型的list插件计算，不需要创建自定义考勤项目； 4、自定义考勤项目不能删除，否则会影响历史的考勤月报数据，所以禁用考勤项目即可； 5、尽量不要在公式编辑器里面调用云函数，尽量不要在公式编辑器和云函数里面调用api，因为这样做会导致考勤计算性能急速下降！！！ |
基本操作
1、新增自定义项目
- 名称：考勤项目的名称
- 编码：不可以重复，按规范来
- 排序码：在自定义考勤项目中的排序
- 是否启用：是否开启使用
- 最小时间单位：自定义考勤项目的最小单位
- 舍位方式：四舍五入，向上取整，向下取整，无（该选项于2024年3月17日产品发版后增加，如果舍位方式选“无”，隐藏最小单位，月报计算对应的自定义考勤项目不进行舍位处理。考勤月报计算时，根据公式里配置的舍位对结果进行舍位）
- 自定义计算公式：详见自定义计算公式及使用举例
2、结果验证
考勤月报 030307 新版考勤月报 查看新版月报，需点计算验证
3、自定义考勤项目的组织个性化
- 在根组织创建的考勤项目所有下级可用
- 选中下级部门修改了上级部门的自定义考勤项目，就会成为该部门个性化的规则，不会改变上级部门的设置。
- 下级可以新增自定义考勤项目，组织个性化为：是。该项目在其它的组织默认不启用。
- 所有的自定义考勤项目在新版月报所有组织中都可以看到，如果该组织未启用这个考勤项目，则月报中显示为空。
4、自定义考勤项目在月报汇总数据中的隐藏、排序
- 隐藏自定义考勤项目的
新建自定义考勤项目之后，在新版考勤月报界面的元数据配置中，并不会自动生成元数据，此时该自定义考勤项目的隐藏由考勤设置--自定义考勤项目–是否启用控制。
若配置元数据之后，考勤项目的显示优先由元数据控制。
- 自定义考勤项目排序
在元数据中添加以下内容：
| 代码块 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"key": "statistic_data_User_Define_scq",
"label": "实出勤",
"width": 80,
"sequence": 570,
"hide": false
}, |
其中label为自定义考勤项目名称，sequence控制在月报中的排序，hide控制在月报中的显示。
下面具体说一下如何查找考勤项目对应的key值：
在新版考勤月报右键检查（注意当前页面不要有太多人，不然数据过多无法查看），选择network，选择hcm.model.list，选择preview，选择一个人展开，向下滑动寻找对应的key值：statistic_data_User_Define_******，（***指在自定义考勤项目时自定义的编码）
附录
系统预置考勤项目对应key值
statistic_data_work_actual --- 实际出勤
statistic_data_work_onjob --- 出勤
statistic_data_work_rest --- 休息
statistic_data_work_outjob --- 缺勤
statistic_data_work_late --- 迟到
statistic_data_work_early --- 早退
statistic_data_work_absence --- 旷工
statistic_data_leave_normal --- 事假
statistic_data_leave_annual --- 年假
statistic_data_leave_sick --- 病假
statistic_data_leave_maternity --- 产假
statistic_data_leave_antenatal --- 孕检假
statistic_data_leave_care --- 护理假
statistic_data_leave_funeral --- 丧假
statistic_data_leave_home --- 探亲假
statistic_data_leave_injury --- 工伤假
statistic_data_leave_feeding --- 哺乳假
statistic_data_leave_marital --- 婚假
statistic_data_leave_shift --- 调休假
statistic_data_overtime_normal --- 平加
statistic_data_overtime_rest --- 休加
statistic_data_overtime_holiday --- 假加
statistic_data_trip_normal --- 外出
statistic_data_trip_business --- 出差
statistic_data_leave_gestation --- 孕期假
statistic_data_leave_familyplan --- 计划生育假
statistic_data_leave_abortion --- 流产假
statistic_data_leave_pregnancy --- 妊娠假
statistic_data_leave_paternity --- 陪产假
statistic_data_leave_nursing --- 看护假
statistic_data_leave_statutory --- 公假
statistic_data_overtime_oncall --- 值班
statistic_data_leave_childcare --- 育儿假
statistic_data_leave_pre_maternity --- 产前假
statistic_data_trip_abroad --- 国外出差
statistic_data_trip_user_defined1 --- 自定义出差1
statistic_data_trip_user_defined2 --- 自定义出差2
statistic_data_leave_user_defined --- 自定义休假
statistic_data_leave_user_defined1 --- 自定义休假1
statistic_data_leave_user_defined2 --- 自定义休假2
statistic_data_trip_user_defined3 --- 自定义出差3
statistic_data_trip_user_defined4 --- 自定义出差4
statistic_data_trip_user_defined5 --- 自定义出差5
statistic_data_trip_user_defined6 --- 自定义出差6
statistic_data_trip_user_defined7 --- 自定义出差7
| 信息 | ||
|---|---|---|
| ||
大家如果有好的想法，请在评论区留言，欢迎大家的分享，也希望大家分享给其他人，我们一起学习！ |
1、由于还未正式发布，原型客户需配置出自定义考勤项目功能
2、新增自定义项目，示例如图
3、结果验证 考勤月报 新版月报【202012】 查看新版月报，需点计算验证
【二开插入点】
对于无法用标准公式对应的场景，我们提供二开云函数公式处理类似需求，对应公式如图
1，维护云函数time_dynamic_calc_define_item(因为可以计算所有考勤月报数据的值，暂时云函数名字固定), 类型要选择考勤计算公式，不然自定义项目时选不到云函数
2. 【考勤设置】-【自定义考勤项目】公式选择云函数并且选到已经维护的云函数
云函数示例：