中国普天项目信息管理系统之合作方管理模块-详细设计说明书

1、. 中国普天信息产业股份有限公司 通信产业事业本部项目信息管理系统合作方管理模块 详细设计说明书 文档编写： 钟尚勤 提交日期： 2008-12-7 审 批 人： 杨正球 北邮项目组 2008-12-7 文档维护记录撰写人修改时间原版本号修改内容介绍钟尚勤2008-12-7V 1.0编写文档常珂2008-12-9V 1.1修改格式及部分内容;目 录1.引言11.1.编写目的11.2.背景11.3.术语11.4.参考资料12.系统的结构12.1.本系统的屏幕功能区域设计如图12.2.系统用例图32.3.系统层次结构33.合作单位管理设计说明53.1.模块描述53.2.合作单位列表63.2.1.程

2、序描述63.2.2.算法63.3.增加合作单位63.3.1.程序描述63.3.2.算法63.4.修改合作单位63.4.1.程序描述63.4.2算法63.5.删除合作单位63.5.1程序描述73.5.2算法73.6.增加合作单位认证73.6.1.程序描述73.6.2.算法73.7.修改合作单位认证73.7.1.程序描述73.7.2算法73.8.删除合作单位认证73.8.1.程序描述73.8.2.算法73.9.上传合作单位认证附件83.9.1.程序描述83.9.2.算法83.10.下载合作单位认证附件83.10.1.程序描述83.10.2.算法83.11.删除合作单位认证附件83.11.1.程序描

3、述83.11.2.算法83.12.增加合作单位人员83.12.1.程序描述83.12.2.算法93.13.修改合作单位人员93.13.1.程序描述93.13.2.算法93.14.删除合作单位人员93.14.1.程序描述93.14.2.算法93.15.增加合作单位人员认证93.15.1.程序描述93.15.2.算法93.16.修改合作单位人员认证93.16.1.程序描述103.16.2.算法103.17.删除合作单位人员认证103.17.1.程序描述103.17.2.算法103.18.上传合作单位人员认证附件103.18.1.程序描述103.18.2.算法103.19.下载合作单位人员认证附件1

4、03.19.1.程序描述103.19.2.算法113.20.删除合作单位人员认证附件113.20.1.程序描述113.20.2.算法113.21.导出合作单位列表113.21.1.程序描述113.21.2.算法113.22合作单位管理接口定义114.合作个人管理设计说明124.1.模块描述124.2.合作个人列表124.2.1.程序描述124.2.2.算法124.3.增加合作个人134.3.1.程序描述134.3.2.算法134.4.修改合作个人134.5.删除合作个人134.6.增加合作个人认证134.7.修改合作个人认证134.8.删除合作个人认证134.9.上传合作个人认证附件134.1

5、0.下载合作个人认证附件144.11.删除合作个人认证附件144.12.合作个人管理接口定义145.合作人员查询设计说明165.1.模块描述165.2.合作人员查询165.2.1.程序描述175.2.2.算法175.3.导出合作人员列表175.3.1.程序描述175.3.2.算法176.认证种类管理设计说明176.1.模块描述176.2.认证种类列表176.2.1.功能176.2.2.算法186.3.增加认证种类186.3.1.程序描述186.3.2.算法186.4.修改认证种类186.4.1.程序描述186.4.2.算法186.5.删除认证种类186.5.1.程序描述186.5.2.算法19

6、6.6.认证种类管理接口定义197.合作模式管理设计说明207.1.模块描述207.2.合作模式列表207.2.1.程序描述207.2.2.算法207.3.增加合作模式207.3.1.程序描述207.3.2.算法207.4.修改合作模式207.4.1.程序描述207.4.2.算法217.5.删除合作模式217.5.1.程序描述217.5.2.算法217.6.合作模式管理接口定义218.合作绩效考核228.1.模块描述228.2.合作绩效考核列表228.2.1.程序描述228.2.2.算法228.3.增加年度绩效考核228.3.1.程序描述228.3.2.算法228.4.删除年度绩效238.4.

7、1.程序描述238.4.2.算法238.5.增加年度绩效考核238.5.1.程序描述238.5.2.算法238.6.修改季度绩效考核238.6.1.程序描述238.6.2.算法238.7.合作绩效考核接口定义24Presale-006 合作方管理模块 详细设计说明书1. 引言1.1. 编写目的本文档是程序员代码编写的基础，本文档的读者是设计人员和程序员。1.2. 背景1) 待开发的软件系统的名称：普天信息管理系统问题管理模块2) 本项目的任务提出者：普天通信产业事业本部相关负责人3) 开发者：北京邮电大学4) 用户：普天通信产业事业本部1.3. 术语1.4. 参考资料1) 系统功能需求说明书2

8、) 合作方管理需求规格说明书3) 合作方管理数据库设计文档4) 合作方管理概要设计说明书2. 系统的结构2.1. 本系统的屏幕功能区域设计如图图2-1 工程管理模块界面图图2-2 合作方管理模块功能图2.2. 系统用例图图2-3 合作方管理模块系统用例图2.3. 系统层次结构本文档只涉及合作方管理子系统的详细设计说明。合作方管理子系统的作用是帮助用户实现对合作方的管理。本子系统包括合作单位管理，合作个人管理，合作人员查询，认证种类管理，合作模式管理，合作绩效考核六个子模块。表2-1 合作方管理模块层次结构表系统层次结构表子模块名称功能名称对应Action合作单位管理显示所有合作单位列表Unit

9、ManagerAction增加合作单位UnitManagerAction修改合作单位UnitManagerAction删除合作单位UnitManagerAction增加合作单位认证CertificationManagerAction修改合作单位认证CertificationManagerAction删除合作单位认证CertificationManagerAction上传合作单位认证附件AttachFileManagerAction下载合作单位认证附件AttachFileManagerAction删除合作单位认证附件AttachFileManagerAction增加合作单位人员PersonMan

10、agerAction修改合作单位人员PersonManagerAction删除合作单位人员PersonManagerAction增加合作单位人员认证CertificationManagerAction修改合作单位人员认证CertificationManagerAction删除合作单位人员认证CertificationManagerAction上传合作单位人员认证附件AttachFileManagerAction下载合作单位人员认证附件AttachFileManagerAction删除合作单位人员认证附件AttachFileManagerAction导出合作单位列表UnitManagerActi

11、on合作个人管理显示所有合作个人列表PersonManagerAction增加合作个人PersonManagerAction修改合作个人PersonManagerAction删除合作个人PersonManagerAction增加合作个人认证CertificationManagerAction修改合作个人认证CertificationManagerAction删除合作个人认证CertificationManagerAction上传合作个人认证附件AttachFileManagerAction下载合作个人认证附件AttachFileManagerAction删除合作个人认证附件AttachFile

12、ManagerAction合作个人查询显示查询结果列表PersonSearchManagerAction导出查询的人员列表PersonSearchManagerAction认证种类管理显示认证种类列表CertificationTypeAction增加认证种类CertificationTypeAction修改认证种类CertificationTypeAction删除认证种类CertificationTypeAction合作模式管理显示合作模式列表Comode_PostManagerAction增加合作模式Comode_PostManagerAction修改合作模式Comode_PostManag

13、erAction删除合作模式Comode_PostManagerAction合作绩效考核显示合作单位年度绩效列表SeasonKpiManagerAction增加合作单位年度绩效SeasonKpiManagerAction删除合作单位年度绩效SeasonKpiManagerAction增加合作单位季度绩效SeasonKpiManagerAction修改合作单位季度绩效SeasonKpiManagerAction3. 合作单位管理设计说明3.1. 模块描述本模块可以对所有的合作单位进行管理。对合作单位管理包括合作单位列表、增加合作单位、修改合作单位、删除合作单位、合作单位人员列表、增加合作单位认证

14、信息、修改合作单位的认证信息、删除合作单位的认证信息等功能。3.2. 合作单位列表3.2.1. 程序描述显示出所有合作单位的列表，对所有的合作单位进行管理。3.2.2. 算法UnitManagerAction调用UnitService中的查询所有合作单位功能，查询数据库表CO_UNIT表，将查询结果，输出到service层，在service层将model转换为dto，转到action层，将dto转换为data，然后将以data存储的数据传送到视图层显示。3.3. 增加合作单位3.3.1. 程序描述增加一个合作单位。3.3.2. 算法UnitManagerAction调用service层中的Un

15、itService的创建功能，查询数据库表CO_UNIT表是否已经有同名合作单位，若已存在，提示合作单位已存在，若无同名，则将合作单位插入。然后调用显示合作单位列表功能。3.4. 修改合作单位3.4.1. 程序描述修改已存在的合作单位的信息。3.4.2 算法UnitManagerAction调用service层中的UnitService的修改功能，将修改后的合作单位更新数据库。然后调用显示合作单位列表功能。3.5. 删除合作单位3.5.1 程序描述删除某个已存在的合作单位。3.5.2 算法UnitManagerAction调用UnitService中的删除群组功能，删除数据库表CO_UNIT表

16、中对应的一条记录，返回群组列表。3.6. 增加合作单位认证3.6.1. 程序描述对某个合作单位增加认证。3.6.2. 算法CertificationManagerAction调用CertificationService中的增加合作单位认证功能，增加数据表CO_CERTIFICATION中的一条记录，返回合作单位认证列表。3.7. 修改合作单位认证3.7.1. 程序描述对某个合作单位修改认证。3.7.2 算法CertificationManagerAction调用CertificationService中的修改合作单位认证功能，修改数据表CO_CERTIFICATION中的一条记录，返回合作单位

17、认证列表。3.8. 删除合作单位认证3.8.1. 程序描述对某个合作单删除认证。3.8.2. 算法CertificationManagerAction调用CertificationService中的删除合作单位认证功能，删除数据表CO_CERTIFICATION中的一条记录，返回合作单位认证列表。3.9. 上传合作单位认证附件3.9.1. 程序描述对某个合作单位认证上传附件。3.9.2. 算法AttachFileManagerAction调用AttahfileService中的上传合作单位认证附件功能，修改数据表CO_ATTACHFILE中的一条记录，返回合作单位认证列表。3.10. 下载合作

18、单位认证附件3.10.1. 程序描述对某个合作单位认证下载附件。3.10.2. 算法AttachFileManagerAction调用AttahfileService中的下载合作单位认证附件功能。3.11. 删除合作单位认证附件3.11.1. 程序描述对某个合作单位认证删除附件。3.11.2. 算法AttachFileManagerAction调用AttahfileService中的删除合作单位认证附件功能。3.12. 增加合作单位人员3.12.1. 程序描述对某个合作单位增加人员。3.12.2. 算法PersonManagerAction调用PersonService中的增加合作单位认证功能

19、，增加数据表CO_PERSON中的一条记录，返回合作单位认证列表。3.13. 修改合作单位人员3.13.1. 程序描述对某个合作单位修改人员信息。3.13.2. 算法PersonManagerAction调用PersonService中的修改合作单位认证功能，修改数据表CO_PERSON中的一条记录，返回合作单位认证列表。3.14. 删除合作单位人员3.14.1. 程序描述对某个合作单位删除人员信息。3.14.2. 算法PersonManagerAction调用PersonService中的删除合作单位认证功能，删除数据表CO_PERSON中的一条记录，返回合作单位认证列表。3.15. 增加合

20、作单位人员认证3.15.1. 程序描述对某个合作单位人员增加认证。3.15.2. 算法CertificationManagerAction调用CertificationService中的增加合作单位人员认证功能，增加数据表CO_CERTIFICATION中的一条记录，返回合作单位人员认证列表。3.16. 修改合作单位人员认证3.16.1. 程序描述对某个合作单位人员修改认证。3.16.2. 算法CertificationManagerAction调用CertificationService中的修改合作单位人员认证功能，修改数据表CO_CERTIFICATION中的一条记录，返回合作单位人员认证

21、列表。3.17. 删除合作单位人员认证3.17.1. 程序描述对某个合作单位人员删除认证。3.17.2. 算法CertificationManagerAction调用CertificationService中的删除合作单位人员认证功能，删除数据表CO_CERTIFICATION中的一条记录，返回合作单位人员认证列表。3.18. 上传合作单位人员认证附件3.18.1. 程序描述对某个合作单位人员认证上传附件。3.18.2. 算法AttachFileManagerAction调用AttahfileService中的上传合作单位人员认证附件功能，修改数据表CO_ATTACHFILE中的一条记录，返回

22、合作单位人员认证列表。3.19. 下载合作单位人员认证附件3.19.1. 程序描述对某个合作单位人员认证下载附件。3.19.2. 算法AttachFileManagerAction调用AttahfileService中的下载合作单位人员认证附件功能。3.20. 删除合作单位人员认证附件3.20.1. 程序描述对某个合作单位人员认证删除附件。3.20.2. 算法AttachFileManagerAction调用AttahfileService中的删除合作单位人员认证附件功能，删除数据表CO_ATTACHFILE中的一条记录，返回合作单位人员认证列表。3.21. 导出合作单位列表3.21.1. 程

23、序描述 对所有的合作单位列表导出。3.21.2. 算法UnitManagerAction调用UnitService中的导出所有合作单位功能，将数据表CO_UNIT中的全部数据导出，格式为ms-excel 。3.22合作单位管理接口定义表3-1 合作单位管理接口定义序号方法功能说明1List<Unit>findAllUnit()列出所有的合作单位返回值为List<Unit>2int addUnit(Unit unit)增加合作单位参数：unitdto为要增加的合作单位的信息，类型为Unit；返回值为int类型，1表示增加成功，0表示增加失败3int modifyUnit(

24、Unit unit)修改合作单位参数：unitdto为要修改的合作单位的信息，类型为Unit返回值为int类型，1表示增加成功，0表示增加失败4int deleteUnit(String unitid)删除合作单位参数：unitid为要删除的合作单位id，类型为String；返回值为int类型，1表示增加成功，0表示增加失败5List<Person> findPersonByUnit(String unitid)查看合作单位所有的人员参数：unitid为要查找人员所对应的合作单位的id；返回值为List<Person>4. 合作个人管理设计说明4.1. 模块描述本模块可

25、以对所有的合作个人进行管理。对合作个人管理包括合作个人查询、合作个人列表、增加合作个人、修改合作个人、删除合作个人、增加合作个人岗位、修改合作个人岗位、删除合作个人岗位、增加合作个人的认证信息、修改合作个人的认证信息、删除合作个人的认证信息等功能。4.2. 合作个人列表4.2.1. 程序描述 对所有的合作个人进行管理。4.2.2. 算法PersonManagerAction调用PersonService中的查询所有合作个人功能，查询数据库表CO_PERSON表，将查询结果，输出到service层，在service层将model转换为dto，转到action层，将dto转换为data，然后将以d

26、ata存储的数据传送到视图层显示。4.3. 增加合作个人4.3.1. 程序描述增加一个合作个人。4.3.2. 算法PersonManagerAction调用service层中的PersonService的创建功能，查询数据库表CO_PERSON表是否已经有同名合作个人，若已存在，提示合作个人已存在，若无同名，则将合作个人插入。然后调用显示合作个人列表功能。4.4. 修改合作个人与修改合作单位人员类似，参照3.13。4.5. 删除合作个人与删除合作单位人员类似，参照3. 14。4.6. 增加合作个人认证与增加合作单位人员认证类似，参照3. 15。4.7. 修改合作个人认证与修改合作单位人员认证类

27、似，参照3. 16。4.8. 删除合作个人认证与删除合作单位人员认证类似，参照3. 17。4.9. 上传合作个人认证附件与上传合作单位人员认证附件类似，参照3. 18。4.10. 下载合作个人认证附件与下载合作单位人员认证附件类似，参照3. 19。4.11. 删除合作个人认证附件与删除合作单位人员认证附件类似，参照3. 20。4.12. 合作个人管理接口定义表4-1 合作个人管理接口定义序号方法功能说明1List<Person>findByName (String name)；List<Person>findByIdcard（String id_card）；List&l

28、t;Person>findByUnit（String unitid）；List<Person>findByCertificationType（String certificationtypeid）；List<Person>findByState（String state）；List<Person>findAll（）；合作个人查询参数：个人姓名为要查找合作人员所对应的人员姓名；身份证号为要查找合作人员所对应的人员的身份证号；单位id为要查找的人员所对应的单位id；认证种类id为要查找人员所对应的认证类型id；人员状态id为要查找人员所对应的状态id；返回

29、值为List<Person>2int addPerson(PersonDto persondto)增加合作个人参数：persondto为要增加的合作个人的信息，类型为Person；返回值为int类型，1表示增加成功，0表示增加失败3int modifyPerson(PersonDto persondto)修改合作个人参数：persondto为要修改的合作个人的信息，类型为Person；返回值为int类型，1表示增加成功，0表示增加失败4int deletePerson(String personid)删除合作个人参数：personid为要删除的合作个人id，类型为String；返回

30、值为int类型，1表示增加成功，0表示增加失败5int addPersonComode(PersonComodeDto personcomodedto)增加合作个人的岗位(合作模式)参数：personid，为要增加岗位的合作个人id，类型为String；comode为要增加的岗位信息，类型为Comode；返回值为int类型，1表示增加成功，0表示增加失败6int modifyPersonComode(PersonComodeDto personcomodedto)修改合作个人的岗位信息参数：personid，为要修改岗位的合作个人id，类型为String；comode为要修改的岗位信息，类型为

31、Comode；返回值为int类型，1表示增加成功，0表示增加失败7int deletePersonComode(String personcomodeid)删除合作个人参数：personid为要删除岗位的合作个人id，类型为String；comodeid 为要删除的人员的岗位id；返回值为int类型，1表示增加成功，0表示增加失败8int addCertification (Certification certification)增加个人的认证信息参数：personid为要删除认证的合作个人id，类型为String；certification为合作个人要增加的认证的信息，类型为Certific

32、ation返回值为int类型，1表示增加成功，0表示增加失败9int modifyCertification (Certification certification)修改个人的认证信息参数：personid为要删除认证的合作个人id，类型为String；certification为合作个人要修改的认证的信息，类型为Certification返回值为int类型，1表示增加成功，0表示增加失败10int deleteCertification (String certificationid)删除个人的认证信息参数：personid为要删除认证的合作个人id，类型为String；certifica

33、tionid为要删除认证id，类型为String；返回值为int类型，1表示增加成功，0表示增加失败表4-2 合作单位和合作个人认证附件管理部分接口序号方法功能说明1int uploadFile(AttachFile attachfile)增加附件，一次只能上传一个附件参数：attachFile为要增加的附件的信息，类型为AttachFile；返回值为int类型，1表示增加成功，0表示增加失败2int deleteAttach(String AttachFileid)删除附件参数：AttachFileid为要删除的附件的id，类型为String；返回值为int类型，1表示增加成功，0表示增加失

34、败3int downloadAttachFile(String AttachFileid)下载附件参数：AttachFileid为要下载的附件的id，类型为String；返回值为int类型，1表示增加成功，0表示增加失败5. 合作人员查询设计说明5.1. 模块描述本模块可以对合作单位人员的各种情况进行统计汇总等操作。5.2. 合作人员查询5.2.1. 程序描述 对所有的合作人员，包括合作单位人员和合作个人进行查询，显示出所有满足查询条件的合作人员的列表。5.2.2. 算法PersonSearchManagerAction调用PersonService中的查询所有合作个人功能，查询数据库表CO_

35、PERSON表，将查询结果，输出到service层，在service层将model转换为dto，转到action层，将dto转换为data，然后将以data存储的数据传送到视图层显示。5.3. 导出合作人员列表5.3.1. 程序描述 导出所有满足查询条件合作单位的列表5.3.2. 算法PersonSearchManagerAction调用PersonService中的导出所有满足条件的合作人员功能，将数据表CO_PERSON中的全部满足条件数据导出，格式为ms-excel 。6. 认证种类管理设计说明6.1. 模块描述本模块可以对认证种类进行管理。实现增加认证种类、修改认证种类、删除认证种类等

36、功能。6.2. 认证种类列表6.2.1. 功能对所有的认证种类进行管理。6.2.2. 算法CertificationTypeAction调用CertificationTypeService中的查询所有认证种类功能，查询数据库表CO_CERTIFICATION_TYPE表，将查询结果，输出到service层，在service层将model转换为dto，转到action层，将dto转换为data，然后将以data存储的数据传送到视图层显示。6.3. 增加认证种类6.3.1. 程序描述增加一个认证种类。6.3.2. 算法CertificationTypeAction调用service层中的Certi

37、ficationTypeService的创建功能，查询数据库表CO_CERTIFICATION_TYPE表是否已经有相同种类相同名称认证种类，若已存在，提示认证种类已存在，若不存在，则将认证种类插入。然后调用显示认证种类列表功能。6.4. 修改认证种类6.4.1. 程序描述修改一个认证种类。6.4.2. 算法CertificationTypeAction调用service层中的CertificationTypeService的修改功能，修改数据库表CO_CERTIFICATION_TYPE的一条记录。6.5. 删除认证种类6.5.1. 程序描述删除一个认证种类。6.5.2. 算法Certifi

38、cationTypeAction调用service层中的CertificationTypeService的删除功能，删除数据库表CO_CERTIFICATION_TYPE的一条记录。6.6. 认证种类管理接口定义表6-1 认证种类管理接口序号方法功能说明1int addCertificationType(CertificationType certificationtype)增加认证种类参数：certificationtype为要增加的认证种类的信息，类型为CertificationType；返回值为int类型，1表示增加成功，0表示增加失败2int modifyCertificationTy

39、pe(CertificationType certificationtype)修改认证种类参数：certificationtype为要修改的认证种类的信息，类型为CertificationType返回值为int类型，1表示增加成功，0表示增加失败3int deleteCertificationType (String certificationtypeid)删除认证种类参数：certificationtypeid为要删除的认证种类id，类型为String；返回值为int类型，1表示增加成功，0表示增加失败4List<CertificationType> findAll()查找全部的

40、认证种类返回全部的认证种类集合，返回值为：List<CertificationType>5CertificationType findById(String certificatointypeid)根据认证种类的id查找相应的认证种类参数：certificationtypeid为要查找的认证种类id，类型为String；返回值为：CertificationType7. 合作模式管理设计说明7.1. 模块描述本模块可以对合作模式进行管理。实现增加合作模式、修改合作模式、删除合作模式等功能。7.2. 合作模式列表7.2.1. 程序描述 显示出所有合作模式的列表，对所有的合作模式进行管理

41、。7.2.2. 算法Comode_PostManagerAction调用ComodeService中的查询所有合作个人功能，查询数据库表CO_MODE表，将查询结果，输出到service层，在service层将model转换为dto，转到action层，将dto转换为data，然后将以data存储的数据传送到视图层显示。7.3. 增加合作模式7.3.1. 程序描述增加一个合作模式。7.3.2. 算法Comode_PostManagerAction调用service层中的ComodeService的创建功能，查询数据库表CO_MODE表是否已经有同名的合作模式，若已存在，提示合作模式已存在，若不

42、存在，则将合作模式插入。然后调用显示合作模式列表功能。7.4. 修改合作模式7.4.1. 程序描述修改一个合作模式。7.4.2. 算法Comode_PostManagerAction调用service层中的ComodeService的修改功能，修改数据库表CO_MODE的一条记录。7.5. 删除合作模式7.5.1. 程序描述删除一个合作模式。7.5.2. 算法Comode_PostManagerAction调用service层中的ComodeService的删除功能，删除数据库表CO_MODE的一条记录。7.6. 合作模式管理接口定义表7-1 合作模式管理接口序号方法功能说明1int addC

43、omode (ComodeDto comodedto)增加合作模式参数：comode为要增加的合作模式的信息，类型为Comode；返回值为int类型，1表示增加成功，0表示增加失败2int modifyComode(ComodeDto comodedto)修改合作模式参数：comode为要修改的合作模式的信息，类型为Comode；返回值为int类型，1表示增加成功，0表示增加失败3int deleteComode (String comodeid)删除合作模式参数：comodeid为要删除的合作模式id，类型为String；返回值为int类型，1表示增加成功，0表示增加失败4List<Comode> findByUnitId(String unitid)查找某单位全部的合作模式参数：unitid为要查找的单位的id，类型为String:返回值为List<Comode>类型5List<Certification> findAll()查找全部的认合作模式返回全部的合作模式集合,返回值为：List<Ce