一、功能定位
适用于以下场景:
1、校验入职/采集的子集必填
2、校验入职/采集的子集必填字段是否填写完整
3、‘最高学历有且只有一条’、‘任职和外部工作时间连续' 等更复杂的数据校验规则,扩展性更强
二、功能操作
功能路径:【组织人事】-【数据校验方案】
1、基本信息
标准出厂预制了2套数据校验方案,一套入职校验方案,一套采集入职方案(升级接口:update.employee.check.program)
属性说明:
- 编码:唯一即可;
- 名称:方案名称;
- 类型:该校验是用在入职管理中,还是信息采集中;
- 适用组织:该方案用在哪个组织下,符合条件的上级组织会一起进行校验;
- 维护组织:该方案的维护组织,方案的数据权限根据该字段进行过滤;
- 适用用工类型:该方案给哪些用工类型的人员使用。
适用组织和维护组织?
常见场景:集团管控,集团给下属子公司统一设置了一套校验方案,子公司可以在此基础上进行扩展,且不允许修改集团设置的校验方案
2、校验条目
属性说明:
- 编码:唯一即可;
- 名称:校验条目;
- 校验公式:目前子集必填校验、子集必填字段填写完整校验都统一规划在【数据校验方案】中设置,后面详细给大家介绍公式都如何使用
- 提示信息:若校验不通过,提示什么内容的信息
- 所属子集:若校验不通过,会在子集导航栏中显示叹号,该字段用来表示叹号显示在哪个子集上。比如说会有一些跨子集的校验,如:外部工作经历子集的第一条数据的开始时间需与主集'参加工作日期'相同,该参数是用来控制校验条目是在填写主集时校验还是在填写外部工作经历子集时校验
- 应用场景:入职专员端/入职员工端/采集专员端/采集员工端
若该人员的数据不符合设置的校验方案,比如设置了教育经历子集必填,但该人员教育经历子集没有数据,则会在base中显示叹号来查看被校验住的具体信息。(注意:只有不符合校验条目的子集数据会显示出叹号,代表该子集数据源需要继续完善,该叹号会代替之前的子集必填的红色*号以及填写完成后的√号)
3、匹配条件扩展
4、校验公式
(1)CHILDS_NOT_NULL 子集不能为空
子集不能为空 :param model:比如"Employee" :return:
该公式通常用于校验入职或采集中某一子集是否必填(相当于之前在base模板中配置的子集required属性)。CHILDS_NOT_NULL('模型model名称')
(2)FIELD_NOT_NULL 根据元数据配置判断子集中的必填字段是否为空
根据元数据配置来判断字段是否为空 :param model: :return:
该公式通常用于校验入职或采集中某一子集中的info必填字段是否填写完整。FIELD_NOT_NULL('模型model名称')
(3)SUBSET_UNIQUE 子集某一字段的唯一性校验
唯一性检验 :param model: 模型比如"PreEmployeeEducation" :param field: 模型对应字段"is_first" :param value: 字段对应唯一值 :return: 例如:最高学历有且只有一条SUBSET_UNIQUE("PreEmployeeEducation","is_first","1")
该公式常用于校验“最高学历有且只有一条”、“第一学历有且只有一条”等,但项目上也可配置在其他自定义子集中使用。SUBSET_UNIQUE("模型名称model","校验字段key值","字段对应的值")
(4)MOST_ONE 最多只有一条校验
最多只有一条检验 :param model: 模型比如"PreEmployeeEducation" :param field: 模型对应字段"is_first" :param value: 字段对应唯一值 :return: 例如:MOST_ONE("PreEmployeeEducation","is_first","1")
该公式与公式3.的区别在于公式3校验的是某个属性有且只有一条(即存在且唯一),该公式用于校验某个属性最多只有一条,即可以没有数据,若有数据该属性最多只能有一个
(5)SUBSET_TIME_CONTINUITY 子集时间连续
子集时间连续校验 上一条数据的结束时间(end_date)与下一条数据的开始时间(begin_date)连续 :param model: 模型比如"PreOuterExperience" :param begin_date_field:必填 开始时间字段 :param end_date_field:必填 结束时间字段 :param type: 必填 可选1:后一条的开始日期比前一条结束日期多一天;2:后一条的开始时间与前一条结束时间相等;3:工作经历中的最早时间与工作经历中最晚时间之间没有空档期 :return:
该公式常用于校验“外部工作经历子集时间连续”等与时间连续有关的校验。SUBSET_TIME_CONTINUITY(model, begin_date_field=’begin_date’, end_date_field=’end_date’)参数含义分别为:该模型中的begin_date和end_date时间连续
(6)EMP_GET_DATA 获取人员主集信息字段
获取人员信息字段 :param field:比如"take_work_time" :param default: "数据为空返回的默认值" :return:
该公式常用于获取人员主集字段的数据,一般和其他公式一起结合使用,如校验“外部工作经历子集的开始时间等于主集参加工作时间”。EMP_GET_DATA(self, field, default=None)
(7)SUBSET_GET_DATA 获取子集中符合条件的第一条数据中某个字段
获取子集中符合条件的第一条数据中某个字段 :param model: 模型比如"PreOuterExperience" :param field: 上述模型中的字段如"begin_date" :param sorts:如获取工作经历子集中最早一条的开始时间,则先要将数据整理一下,按照开始时间进行升序排序,然后取第一条的开始时间[{"key": "begin_date", "type": "asc"}] :param filters:跟元数据配置中filter一样,配置过滤条件,如获取教育经历子集中第一学历为是的那条数据的开始时间,如{"is_first":1, ...} :param state: :param default: "数据为空返回的默认值",默认填None即可 :return:
该公式常用于获取子集中符合某条件的某条数据的字段,如获取“工作经历中最早的开始时间”、“教育经历的第一学历的毕业时间”等。
常与公式EMP_GET_DATA结合使用,例如:校验外部工作经历子集中最早一条的开始时间要与主集中的参加工作日期相等
SUBSET_GET_DATA("PreOuterExperience","begin_date",None,None,[{"key": "begin_date", "type":"asc"}])==EMP_GET_DATA("take_work_time")
(8)DATE_MINUS_ONE_DAY 时间日期减一天,用于时间连续操作
时间日期减一天,用于时间连续操作 :param date: :return:
该公式用于对时间格式的日期进行处理,在传入日期的基础上减一天,可以嵌套其他公式使用,如DATE_MINUS_ONE_DAY(EMP_GET_DATA("entry_date")) 代表入职日期2020-10-29 减一天,则公式取出来的数据为2020-10-28
常用于校验“工作经历最后一条结束时间与任职开始时间连续”,这个公式比较复杂,结合使用了3个公式:
SUBSET_GIT_DATA("PreOuterExperience","end_date",None,None,[{"key": "begin_date", "type":"desc"}])==DATE_MINUS_ONE_DAY(SUBSET_GIT_DATA("PreJobInformationCurrent","begin_date",None,None,[{"key": "begin_date", "type":"desc"}]))
5、校验仓库
仓库中是一些标准预制的校验条目,可直接把校验条目从仓库中引入下来使用