NC-人力资源二次输入输出接口 开发接口红皮书.doc

NC人力资源二次开发接口红皮书NC-HR 5.5用友NC-HR2020-02-052第 页目 录第一章前言3第二章 时间管理二次开发接口4第三章 绩效管理二次开发接口5基本方案结果生成预处理接口IBasicDocCalculationProcessor5汇总方案结果生成预处理接口IGatherDocCalculationProcessor5从接口类计算指标考评分IIndiCalculator5第四章 二次开发接口实现类注册节点介绍7节点位置7节点功能说明7第 7 页第一章 前言随着HR产品用户的增加，个性化的需求越来越多。将如此多的个性化需求都实现在标准产品中是不现实的：这将使产品成为多家用户的个性需求的简单糅合品，而不是一个通用产品；而采用简单的二次开发方式修改标准产品源代码的方式，又存在开发周期长、版本难于维护、难升级的问题。为了最大可能地缓解上述问题，HR产品在5.5版本中引入了二次开发接口的机制：产品向外提供可供二次开发的接口，二次开发人员可以实现这些接口，并将接口的实现注册到产品中，从而满足用户的个性化需求。第二章 二次开发接口实现类注册节点介绍为了方便二次开发人员将二次开发接口的实现类注册到系统中，HR产品提供了一个专门的注册节点，在此节点中，二次开发人员能够将系统级、模块级、节点级接口的实现类注册到系统中，并能指定系统级、模块级接口的实现类（节点级接口的实现类需要到各自的业务节点中注册）。节点位置客户化HR工具箱二次开发接口定义节点功能说明点击“修改”按钮，进行对选中接口的修改操作。点击“行操作”中的“增行”、“删行”按钮，可以添加或删除当先选中的自定义接口所对应的子表数据，即自定义接口的实现类，其中“名称”与“实现类”为必输项。如果当前选中的自定义接口需要设置默认实现类，则点击主表最后一列的参照，从中选出要设置为默认实现类的项。设置完成后，点击“保存”按钮保存数据，放弃修改则点击“取消”按钮。如果要将某些自定义接口恢复系统默认设置，则通过复选框选择相应接口，然后点击“恢复默认值”按钮，“确认”则执行恢复操作，“取消”则返回。第三章 时间管理二次开发接口上下班时间点生成接口ITimePointProcessor【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的模块级二次开发接口，并提供了此接口的默认实现。通过调用此接口实现类的方法，能计算得出员工的上下班时间点。如果用户对上下班时间点的算法有个性化需求，可以实现此接口，注册到系统中，并将此实现设置为接口的实现。【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息字段名中文名数据类型注释pk_hr_impl开发接口实现表主键char(20)pk_hr_itf接口定义表主键char(20)itf_code接口编码varchar(40)impl_name实现名称varchar(200)impl_class_name实现类的全类名varchar(100)modulename模块名称varchar(20)default_flag是否是接口的默认实现char(1)此接口只有一个默认实现Y 是，N 否user_def_flag是否是用户自定义char(1)Y 是，N 否impl_desc说明varchar(500)上下班时间点后处理接口ITimePointPostProcessor【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的模块级二次开发接口，默认情况下此接口没有实现。通过调用此接口实现类的方法，能够将ITimePointProcessor接口实现类计算得到的上下班时间点进行再处理。如果用户需要对上下班时间点进行再处理，可以实现此接口，注册到系统中，并将此实现设置为接口的实现。【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息略考勤数据生成接口ITimeDataCreator【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的模块级二次开发接口，并提供默认实现。通过调用此接口实现类的方法，能够生成tbm_timedata表的数据。如果用户对tbm_timedata表的数据生成有个性化需求，可以实现此接口，注册到系统中，并将此实现设置为接口的实现。【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息略考勤数据生成后处理接口ITimeDataPostProcessor【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的模块级二次开发接口，默认情况下此接口没有实现。通过调用此接口实现类的方法，能够将ITimeDataCreator接口实现类计算得到的tbm_timedata表的数据进行再处理。如果用户需要对tbm_timedata表的数据进行再处理，可以实现此接口，注册到系统中，并将此实现设置为接口的实现。【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息略考勤日报项目计算接口IDayDataCreator【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的节点级二次开发接口，没有提供默认实现。通过调用此接口实现类的方法，能够计算一个日报项目的值。如果用户日报项目的计算有个性化需求，可以实现此接口，注册到系统中，并在考勤项目设置节点将此实现设置为日报项目的计算类。【注册方式】：在表hr_impl和hr_impl_set 中注册【注册表信息】表名hr_impl，主要字段信息略表名hr_impl_set字段名中文名数据类型注释pk_impl_set开发接口实现设置表主键char(20)pk_hr_itf接口定义表主键char(20)itf_code接口编码varchar(40)pk_hr_impl实现表主键char(20)use_obj使用对象主键char(20)impl_class_name实现类的全类名varchar(100)考勤月报项目计算接口IMonthDataCreator【包名】： nc.itf.hr.ta.customization【说明】： 系统预制的节点级二次开发接口，没有提供默认实现。通过调用此接口实现类的方法，能够计算一个月报项目的值。如果用户月报项目的计算有个性化需求，可以实现此接口，注册到系统中，并在考勤项目设置节点将此实现设置为月报项目的计算类。【注册方式】：在表hr_impl和hr_impl_set 中注册【注册表信息】表名hr_impl，主要字段信息略表名hr_impl_set，主要字段信息略第四章 绩效管理二次开发接口基本方案结果生成预处理接口IBasicDocCalculationProcessor【包名】： nc.itf.pe.customization【说明】： 系统预制的模块级二次开发接口：基本方案结果生成预处理接口.产品不预制接口的默认实现;用户可以根据自身业务的需要，实现此接口，以在结果生成前和结果生成后插入自身业务逻辑。传入的参数不满足业务逻辑或计算发生异常时，抛出BusinessException异常，由调用者处理【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息略汇总方案结果生成预处理接口IGatherDocCalculationProcessor【包名】： nc.itf.pe.customization【说明】： 系统预制的模块级二次开发接口：汇总方案结果生成预处理接口.产品不预制接口的默认实现;用户可以根据自身业务的需要，实现此接口，以在结果生成前和结果生成后插入自身业务逻辑。传入的参数不满足业务逻辑或计算发生异常时，抛出BusinessException异常，由调用者处理【注册方式】：在表hr_impl 中注册【注册表信息】表名hr_impl，主要字段信息略从接口类计算指标考评分IIndiCalculator【包名】： nc.itf.pe.customization【说明】： 二次开发服务接口：从接口类计算考评分.当指标的打分方式为从接口类计算时,JAVA类必须实现该接口,并实现方法 calculate(Cal