中国普天绩效考核系统KPI 系统业务流程控制部分分离方案.doc

KPI 系统业务流程控制部分分离方案提交人：张健，张剑鸣时间：2008-8-20版本：1.018目录目录11业务功能描述12接口描述22.1 Kpi指标操作22.2控制Kpi流程的流转业务32.3 Kpi流程中操作Kpi业务与Kpi数据查询42.4 Kpi导出业务92.5 Kpi周期管理102.6 kpi创建122.7 kpi流转日志122.8辅助对象133流程控制部分相关实现修改143.1 对KpiStateCtrlItem类进行拆分143.2 对KpiStateCtrl类进行改动143.3 将KpiOutputAction中的download函数提出14KPI系统流程控制部分分离方案1业务功能描述通过对kpi流程的分析，从其中抽取出以下功能。Kpi指标操作（3个功能点）：对kpi指标的增加、删除、修改。控制kpi流程的流转业务（5个功能点）：Kpi状态转移到下一状态、kpi状态转移到前一状态、列出kpi所有状态、列出特定操作者对Kpi能够进行的操作、列出特定角色对kpi能够进行的操作。kpi流程中每一步的具体操作业务（17个功能点）： 保存kpi信息、提交kpi信息、删除kpi、锁定kpi、签字确认、给锁定的kpi解锁、 启动评审、员工自评、直接领导评分、保存kpi自评信息、间接领导评分、部门领导评分、kpi驳回，对评分结果确认、驳回到人力部、保存面谈内容、进行面谈。对kpi数据的查询（3个功能点）：查询员工的kpidata列表、查询历史kpi、列出所有顶层部门的kpidata列表kpi导出业务（3个功能点）：个人kpi导出、部门kpi导出、批量导出KpiKpi周期管理业务（8个功能点）：启动年度填写、终止年度填写、启动季度填写、终止季度填写、启动年度考核、终止年度考核、启动季度考核、终止季度考核Kpi创建（4个功能点）：创建年度kpi，创建季度kpi，批量创建kpi，创建一个kpi。kpi流转日志（1个功能点）返回kpi流转日志列表将这些业务单独提取出来后，分别作成独立的模块，提供相应的接口，然后再将其通过Spring方式注入它们服务的action中。2接口描述2.1 Kpi指标操作KpiPointService功能是用于控制kpi指标的增删改。其具体接口的描述由下表所示：表2.1.1 KpiPointService接口描述表序号接口功能说明1int addKpiPoint(Employee e,KpiInfo ki,KpiPointInfo kpif)增加kpi指标参数： ki用来传递需要的kpi数据信息。kpif为用来传递指标数据的对象。返回值：为0表示指标增加成功，为非零表示增加失败：1、2、3、分别为指标名称、指标解释、规则为空，4是分值不在0到100之间，5是分值和大于100，6是与其它指标名重复。2int modifyKpiPoint(Employee e, KpiInfo ki, int no，KpiPointInfo kpif)修改kpi指标参数：ki用来传递需要的kpi数据信息。No表示要修改的指标编号，kpif为用来传递指标数据的对象。返回值：为0表示指标增加成功，为非零表示增加失败：1、2、3、4分别为指标名称、分值、指标解释、规则为空，5是分值不在0到100之间，6是分值和大于100，7是与其它指标名重复。3int deleteKpiPoint(KpiInfo kii,int no)删除kpi指标参数：ki用来传递需要的kpi数据信息，no表示要删除的kpi指标的编号。返回值：为1删除成功，0删除失败。2.2控制Kpi流程的流转业务KpiStateService功能是控制KPI业务流程的流转，其接口定义如下表所示：表2.2.1 KpiStateService接口序号接口功能说明1Kpi changToNextState(Kpi kpi)将Kpi的状态转移到下一状态参数：参数kpi是需要进行状态转移的对象；返回值：状态改变后的kpi对象；2Kpi changeToLastState(Kpi kpi)将Kpi的状态转移到上一状态参数：参数kpi是需要进行状态转移的对象；返回值：状态改变后的kpi对象；3String getKpiState(Kpi kpi)列出Kpi的所有状态参数：参数kpi为需要列出所有状态的对象；返回值：返回值为二维数组，数组每一行的两个元素分别代表State1和State2；4String getFitActions(Kpi kpi, Employee employee)列出操作者对Kpi能够进行的操作参数：kpi表示操作者操作的Kpi对象，employee表示操作者；返回值：返回值数组为操作者所能进行的操作；5String getFitActions (String adminstate, String state12, String role, String kpitype);列出指定角色role对指定管理状态、指定状态、指定kpi类型的kpi能够进行的操作。参数：adminstate表示kpi的管理状态、state12表示kpi的状态、role表示kpi操作者的角色、kpitype为指定的kpi类型。返回值：返回值数组为操作者所能进行的操作；KpiRoleService用于辅助KpiStateService, 其主要功能是判断操作者在KPI当前状态下的角色。其接口具体如下表所示：表2.2.2KpiRoleService接口定义序号接口功能说明1String getKpiRole(Kpi kpi, Employee employee)判断操作者在KPI当前状态下的角色参数：kpi表示当前的kpi对象，employee表示当前操作者对象；返回值：返回操作者的角色KpiStateCtrlInterface真正保存了动作的内容，用户辅助KpiStateService，返回要求的动作。其接口描述如下：表2.2.3 KpiStateCtrlInterface接口描述序号接口功能说明1String getActions(String kpitype, String adminstate, String state1, String state2, String role)列出指定角色role对指定管理状态、指定状态、指定kpi类型的kpi能够进行的操作。参数：adminstate表示kpi的管理状态、state1、state2表示kpi的状态、role表示kpi操作者的角色、kpitype为指定的kpi类型。返回值：返回值数组为操作者所能进行的操作；2.3 Kpi流程中操作Kpi业务与Kpi数据查询KpiService是整个kpi流程中每一步具体的业务逻辑，以及对kpi数据的查询。具体的接口定义如下表所示：表2.3.1 KpiService接口描述序号接口功能说明1int saveKpiInfo（KpiInfo ki）保存kpi信息参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id ，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id, leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态。返回值：为1保存成功，0保存失败。2int saveKpiEvaluate(KpiInfo ki);保存kpi自评信息参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，text_strings为针对各指标的自评结果。 uploadFiles表示自评时添加的附件。返回值：为1保存成功，0保存失败。3int submitKpi(KpiInfo ki )提交kpi信息参数：ki用来传递需要的参数，在此包含：operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id, leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态。返回值：为1提交成功，0提交失败。4int deleteKpi（String kpid）删除kpi参数：kpid表示要删除的kpi的id返回值：为1删除成功，0删除失败5int lockKpi(String kpiid)锁定kpi参数：kpiid表示要锁定的kpi的id返回值：为1锁定成功，0锁定失败6int unlockKpi(String kpiid)给锁定的kpi解锁参数：kpiid表示要解锁的kpi的id返回值：为1解锁成功，0解锁失败。7int signkpi(KpiInfo ki)员工签字确认参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态。返回值：为1启动评审成功，0启动评审失败。8int startApprove(KpiInfo ki )启动评审参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态。返回值：为1启动评审成功，0启动评审失败。9int selfApprove(KpiInfo ki)员工自评参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态，text_strings为针对各指标的自评结果。 uploadFiles表示自评时添加的附件。返回值：为1自评成功，0自评失败。10int Approve1（KpiInfo ki）直接领导评分参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态，text_strings为针对各指标的评分结果。advice1为直接领导意见。返回值：为1直接领导评分成功，0直接领导评分失败。11int Approve2（KpiInfo ki）间接领导评分参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态，text_strings为针对各指标的评分结果。Advice2为间接领导意见。返回值：为1间接领导评分成功，0间接领导评分失败12int Approve3（KpiInfo ki）部门领导评分参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态，text_strings为针对各指标的评分结果。Advice3为部门领导意见。返回值：为1部门领导评分成功，0部门领导评分失败13int ack(KpiInfo ki);员工对评分结果确认参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态，text_strings为针对各指标的评分结果。Advice3为部门领导意见。返回值：为1确认成功，0确认失败14int refuseKpi(KpiInfo ki)驳回kpi参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作，eid表示此kpi的员工id，leader1id,leader2id, lerder3id分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态， refuse_cause为驳回原因。返回值：为2评分、面谈或确认状态驳回成功， 为1其它状态驳回成功， 0驳回失败15int refusekpiToRL(KpiInfo ki)驳回kpi到人力部门参数：ki用来传递需要的参数，在此包含：kpid表示要保存的kpi的id，operator表示当前的操作者，method表示要对kpi进行的操作， eid表示此kpi的员工id，leader1id, leader2id, lerder3id 分别指1、2、3级领导。states12表示当前kpi应处的状态，type是kpi状态， refuse_cause为驳回原因。返回值：为1驳回成功，0驳回失败16int saveFace(KpiFaceInfo kfi, String isAdmin)保存面谈信息参数：Kfi用来传递需要的面谈信息，包含面谈日期、面谈者等；isAdmin表示是否由管理员保存面谈信息。返回值：为1保存成功，0保存失败17int face(KpiFaceInfo kfi,KpiInfo ki);进行面谈参数：Kfi用来传递需要的面谈信息，包含面谈日期、面谈者等；Ki用来传递kpi的信息。返回值：为1面谈成功，0面谈失败。18List lookup(Employee ee, String type,KpiDataTitle title,String departmentid, String KpiState ，String dest)查询kpi数据参数：ee表示当前登录人员，type表示kpi类型，title对象包含kpi列表类型及其对应的时间，departmentid表示员工所在部门的id ，KpiState为kpi状态，dest表示查询目的:为lookup表示依据ee, type, title, departmentid普通查询，为listpq、listpy等表示依据ee,title,type进行与部门无关的查询，为lookuppq表示依据ee, departmentid, KpiState, title查询规定状态的个人季度kpi。返回值：返回值为查到的kpi数据。19KpiHistoryInfo historyKpi (Employee e, String period, String kpitype)查询历史kpi参数：e表示查出该员工的kpi，period是kpi周期，kpitype是kpi类型。返回值：返回值为kpi历史信息。其中属性：periodInfo是指定周期的kpi进程，stateInfo该员工该周期所有的kpi状态，kpitypes是所查到的kpi类型（汉语版）。20List list_toplevel(String type)列出所有顶层部门的kpi数据参数：type为kpi类型返回值：返回值为查到的kpi数据。2.4 Kpi导出业务KpiOutputService是用来处理Kpi导出的业务逻辑。其具体接口入下表所示：表2.4.1 KpiOutputService接口描述序号接口功能说明1OutputInfo pkpiout(String eid, Employee ee, String kpitype, String period)个人kpi导出参数：eid表示导出该员工的kpi，ee为当前登录人员，kpitype为kpi类型，period表示kpi的周期。返回值：导出的文件产生的blob。2OutputInfo dkpiout(String did, Employee ee, String kpitype,String period)部门kpi导出参数：did为部门id，表示导出该部门的kpi，ee为当前登录人员，kpitype为kpi类型，period表示kpi的周期。返回值：导出的文件产生的blob。3OutputInfo kpiout(String did, Employee ee, String kpitype,String period)批量导出Kpi参数：did为部门id，ee为当前登录人员，kpitype为kpi类型，period表示kpi的时期。返回值：导出的文件信息，包括产生的blob，文件名，出错信息（如果出错的话）。4OutputInfo personKpiOut(String eid, String kpitype,String period)为指定用户导出kpi参数：eid表示导出该员工的kpi，kpitype为kpi类型，period表示kpi的周期。返回值：导出的文件信息，包括产生的blob，文件名，出错信息（如果出错的话）。2.5 Kpi周期管理KpiAdminService负责Kpi周期管理的业务逻辑，具体的接口定义如下表所示：表2.5.1 KpiAdminService接口描述序号接口功能说明1int editYearStart(KpiAdmin ka, String period)启动年度填写参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示启动成功，0表示启动失败。2int editYearStop(KpiAdmin ka, String period)终止年度填写参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示终止成功，0表示终止失败。3int editQuarterStart(KpiAdmin ka, String period)启动季度填写参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示启动成功，0表示启动失败。4int editQuarterStop(KpiAdmin ka, String period)终止季度填写参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示终止成功，0表示终止失败。5int evalYearStart(KpiAdmin ka, String period)启动年度考核参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示启动成功，0表示启动失败。6int evalYearStop(KpiAdmin ka, String period)终止年度考核参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示终止成功，0表示终止失败。7int evalQuarterStart(KpiAdmin ka, String period)启动季度考核参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示启动成功，0表示启动失败。8int evalQuarterStop(KpiAdmin ka, String period)终止季度考核参数：ka表示进行周期管理的kpi管理对象， period是kpi周期。返回值：1表示终止成功，0表示终止失败。2.6 kpi创建KpiCreateService负责kpi创建的业务逻辑，它根据指定的条件创建Kpi。具体接口如下：表2.6.1 KpiCreateService接口描述序号接口功能说明1int yearKpiCreate(String parameters) 创建年度kpi参数：parameters表示创建年度kpi所需的参数，包括员工姓名，kpi类型，和kpi周期。返回值：0表示创建成功，1表示Kpi已经存在，2表示此员工不需要填写该年度Kpi，3表示所选年度不是当前Kpi考核或评审的年度2int quarterKpiCreate(String parameters, String quarter)创建季度kpi参数：parameters表示创建年度kpi所需的参数，包括员工姓名，kpi类型，和kpi周期。quarter表示创建该季度的kpi返回值：0表示创建成功，1表示Kpi已经存在，2表示此员工不需要填写该年度Kpi，3表示所选季度不是当前Kpi考核或评审的季度3int create_all_drafting_kpi (List elist,String type, String period);批量创建kpi参数：elist表示为这些员工创建kpi，type是kpi类型，period为kpi周期；返回值：1创建成功，0创建失败。4 Kpi create_drafting_kpi(String type, String period, Employee e)创建一个kpi参数：type是kpi类型，period为kpi周期，e表示为此员工创建kpi。返回值：创建的kpi对象。2.7 kpi流转日志KpiProcedureService负责处理Kpi的流转日志。其接口如下：表2.7.1 KpiProcedureService的接口描述序号接口功能说明1List getKpiProcedure（String kpiid）取得kpi流转日志的内容参数：kpiid为要得到日志的kpi的id。返回值：kpi流转日志。2.8辅助对象以上描述中新加入了个KpiInfo、KpiHistoryInfo以及KpiFaceInfo类对象，它们用来作为参数传递kpi相关数据，具体定义为：Class KpiInfo private String kpid;private Employee operator;private String method;private String eid;private String leader1id; private String leader2id;private String leader3id;private String states12;private String type; private String text_strings; private List uploadFiles; private String advice;private String refuse_cause;Public void setKpid(String kpid) this.kpi