国家无线电监测检测中心综合业务报价系统-详细设计说明书定稿.doc

国家无线电监测检测中心综合业务报价及服务系统详细设计说明书 文档编写： 夏 姣 姣 提交日期： 2009-12-10 审 批 人： 北京金悦瞳科技有限公司 2009-07-28 文档维护记录撰写人修改时间原版本号修改内容介绍夏姣姣2009-12-10V1.0编写夏姣姣2009-3-20V1.1编写目录1.引言11.1.编写目的11.2.项目背景11.3.参考资料12.系统总体设计12.1.本系统的屏幕功能区域设计如图12.2.系统用例图12.3.系统层次结构13.程序设计说明23.1.报价单管理23.1.1.数据及接口说明23.1.2.功能设计描述63.2.测试服务单管理93.2.1.数据及接口说明93.2.2.功能设计描述123.3.测试例清单管理173.3.1.接口页面173.3.2.Action接口173.3.3.数据传输对象定义（DTO）173.3.4.Service接口173.4.付款通知单管理173.4.1.数据及接口说明173.4.2.功能设计描述193.5.业务数据管理213.5.1.测试服务管理213.5.2.产品管理263.5.3.客户管理313.6.基础数据管理333.6.1.动作管理333.6.2.功能管理363.6.3.角色管理403.6.4.用户管理443.7.查询统计493.7.1.接口页面493.7.2.Action接口493.7.3.数据传输对象定义（DTO）493.7.4.Service接口50Presale-006 详细设计说明书 站点信息管理模块1. 引言1.1. 编写目的本文档是程序员代码编写的基础，本文档的读者是设计人员和程序员。1.2. 项目背景1) 待开发的软件系统的名称：国家无线电综合报价及服务系统；2) 本项目的任务提出者：国家无线电相关负责人；3) 开发者：北京邮电大学；4) 用户：国家无线电监测检测中心。1.3. 参考资料1) 国家无线电综合报价及服务系统需求说明书2) 国家无线电综合报价及服务系统数据模型设计3) 国家无线电综合报价及服务系统概要设计文档2. 系统总体设计2.1. 本系统的屏幕功能区域设计如图图2-1 系统首页2.2. 系统用例图图3.1 系统用例图2.3. 系统层次结构3. 程序设计说明3.1. 报价单管理功能概述： 对所有的报价单的相关信息进行管理，包括创建报价单、复制报价单以创建新的报价单、追加报价单、删除报价单、修改报价单、撤销服务单、查看报价单详情、导出报价单、提交报价单、保存报价单、查看测试服务单等功能。相关的实现设计及接口描述如下：Action名Service名QuotationManageActionQuotationManageServiceCustomerManageServiceTestServiceManageServiceProductManageService表3-1-1 报价单管理3.1.1. 数据及接口说明3.1.1.1. 接口页面图3-1-1 接口页面3.1.1.2. Action接口Action方法名调用service方法名返回值MappingQuotationList报价单列表追加报价单列表getChildQutationById(quotationid)获得当前报价单追加报价单列表getQuotationList(employeeid) 根据人角色查报价单SuccessQuotationList.jspFailError.jspaddProdQuotationEnter创建产品报价单入口getCustomerList()getAllOption()generateProductQuotationNo(employeeid)SuccessQuotationList.jspFailError.jspaddServiceQuotationEnter创建服务报价单入口getCustomerList()getFunctionContainTestSercice()generateProductQuotationNo(employeeid)SuccessQuotationList.jspFailError.jspsaveProdQuoteItem保存产品报价项createOptionList(quoteitemids, optiondto,quotationid)SuccesscreateProdQuotaion.jspFailError.jspsaveServiceQuoteItem保存服务报价项createFunctionList(quoteitemids, testservicedto,quotationid)服务报价单选件选择并保存SuccesscreateServiceQuotaion.jspFailError.jspsaveProdCustomerInfo将产品报价单中客户信息加入基础数据库saveClientInfroFromQuotation(quotationdto)SuccessCreateProdQuotaion.jspFailError.jspsaveServiceCustomerInfo将将服务报价单客户信息加入基础数据库saveClientInfroFromQuotation(quotationdto)SuccesscreateServiceQuotaion.jspFailError.jspTestExampleChooseEnter测试例选择入口getInstanceList (functionid)SuccessexampleListEnter.jspFailError.jspTestExampleChoose增加测试例saveInstanceList(functionid,testInstanceList)SuccesscreateServiceQuotation.jspFailError.jspdeleteServiceQuoteItem删除服务报价项deleteFunctionListItem(functionid)SuccesscreateServiceQuotation.jspFailError.jspdeleteOptionItem删除产品报价项deleteOptionItem(functionid) SuccesscreateProdQuotation.jspFailError.jspFailError.jspcopyQuotation复制报价单copyQuotation(quotationid,employeeid)SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jspviewQuotation查看报价单getQutationById(quoteid)SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jsptestExampleView查看报价单测试例列表getInstanceList(functionid)SuccessexampleListEnter.jspFailError.jspmodifyQuotationEnter修改报价单入口getCustomerListgetQutationById(quoteid)getFunctionContainTestSercice()getAllOption()SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jspmodifiedQuotation修改报价单saveQuotation(QuotaionDTO,flag)SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jspsaveProdTempQuotation保存产品临时报价单saveProdQuotation(QuotaionDTO,flag)SuccessCreateProdQuotationFail.jspsaveServiceTempQuotation保存服务临时报价单saveServiceQuotation(quotationdto, flag)SuccessCreateServiceQuotation.jspFailError.jspsaveProdQuotation保存产品报价单saveProdQuotation(QuotaionDTO,flag)SuccessCreateProdQuotation.jspFailError.jspsaveServiceQuotation保存服务报价单saveServiceQuotation(quotationdto, flag)SuccessQuotationList.jspFailError.jspsubmitQuotation提交报价单submitQuotation(quotationid, employeeid)SuccessQuotationList.jspFailError.jspexportQuotation导出报价单exportQuotation(quotei，PrintWriter)SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jspadditionalQuotationEnter追加报价单入口getCustomerListgetFunctionContainTestSercice()getAllOption()generateProductQuotationNo(employee.getId(), quotationid)SuccessCreateProdQuotation.jsp/createServiceQuotation.jspFailError.jspadditionalQuotation追加报价单saveQuotation(QuotaionDTO,flag)SuccessQuotationList.jspFailError.jspFailError.jspgeneratePayNoticeEnter生成付款通知单入口getCustomerListgetAccountListcalculateSystemTotalPrice(quotationid)getQutationById(quotationid)SuccessPayServiceNotice.jspFailError.jspgeneratePayNotice生成付款通知单createPaymentAdvice(quotationid, paynoticedto,save, employeeid)SuccessQuotationList.jspFailError.jspmodifyPayNotice修改付款通知单createPaymentAdvice(quotationid, paynoticedto,save, employeeid)SuccessQuotationList.jspFailError.jspviewPayNotice查看付款通知单getPayNoticeListByQuotationId(quotationid)根据报价单id得到付款通知单列表SuccesspayNoticeList.jspFailError.jspcancelQuotation.CancelQuotation(quoteid).SuccessQuotationList.jspFailError.jspdeleteQuotation.deleteQuotation(quoteid).SuccessQuotationList.jspFailError.jsp表3-1-2 action定义3.1.1.3. 数据传输对象定义Dto名属性值QuotationDTOid,quotename,discount,sysquote,refquote,customerDTO,List，ListCustomerDTO见业务数据管理部分customerDTO的定义ProductDTO见业务数据管理部分productDTO的定义TestServiceDTO见业务数据管理部分TestServiceDTO的定义表3-1-3数据传输对象定义3.1.1.4. Service接口Service方法名参数及说明返回值SERVICE名getQuotationList(userid)userid当前登录用户idListQuotationManageServicegetChildQutationById(quoteid)quoteid 父节点IDListQuotationManageServicegenerateProductQuotationNo(employeeid,fatherid)employeeid 创建人fatherid 代表是否是追加的QuotationDTOQuotationManageServicegenerateServiceQuotationNo(employeeid,fatherid)employeeid 创建人fatherid 代表是否是追加的QuotationDTOQuotationManageServicegetQutationById(quoteid)quoteid报价单编号QuotationDTOgetCustomerList()NullListCustomerManageServicesaveProdQuotation(QuotationDTO,flag)QuotationDTOflag:(save,submit,modify,quoteid)success/fail,quoteid：代表被追加的报价单编号QuotationManageServicesaveServiceQuotation(QuotationDTO,flag)QuotationDTOflag:(save,submit,modify,quoteid)success/fail,quoteid：代表被追加的报价单编号QuotationManageServicegetInstanceList(functionId)根据报价单中功能的ID，得到其已选中的测试例的列表functioned报价项的idList测试例列表QuotationManageServicesaveInstanceList(functionId, List)保存更新测试例列表functioned 报价项idList保存的dtosuccess/failQuotationManageServicedeleteFunctionListItem(String functionId)删除服务报价单功能列表中的功能项functionId 报价项idsuccess/failQuotationManageServicedeleteOptionItem(optionListId)删除产品报价单选件列表中的选件optionListId选件项idsuccess/failQuotationManageServicecreateOptionList(optionIds,List, quotationId)树形结构选择时，需要根据在树中选择的选件组织新的列表optionIds选择的树节点idList报价单中产品报价项quotationId报价单idListQuotationManageServicecreateFunctionList(functionIds,List,quotationId)树形结构选择时，需要根据在树中选择的功能组织新的列表functionIds选择的树节点idList报价单中服务报价项quotationId报价单idListQuotationManageServicesaveClientInfroFromQuotation (QuotationDTO)提交时从报价单保存客户信息QuotationDTO报价单dtosuccess/failQuotationManageServicecancelQuotation.CancelQuotation(quoteid).success/failQuotationManageServicedeleteQuotation.deleteQuotation(quoteid).success/failQuotationManageServicegetProductList()NullListProdManageServicegetTestServiceListByType (type)type为null代表获得所有的服务树节点ListTestServiceManageServiceexportQuotation(servicequoteid ，outputstream)Quoteid，outputstreamsuccess/failQuotationManageServicegetTestServiceById(id,type)id：测试服务单id/报价id,type(testserviceid,quoteid) TestServiceDTOTestServiceManageServicecreatePaymentAdvice(quoteids,PayNoticeDTO,flag,userId)合并一个或者多个报价单生成付款通知单Quoteids报价单idPayNoticeDTOuserIdflag(modify/save)success/failpayNoticeService表3-1-4 service接口3.1.2. 功能设计描述3.1.2.1. 创建本功能允许创建报价单。创建时，系统自动生成一个报价单编号，如果重复，则无法创建报价单。点击图中的复制，由Struts控制调用QuotationManageAction中的addQuotationEnter方法，以创建新的报价单。出现页面如图3-1-2所示图3-1-23.1.2.2. 复制本功能的设计主要方便销售人员的操作图3-1-3单选要复制的报价单，点击图中的“复制”按钮，由Struts控制调用QuotationManageAction中的copyProdQuotationEnter方法，复制所选的报价单以创建新的报价单。出现页面如图3-1-2所示3.1.2.3. 查看详情本功能允许查看报价单详情，即报价单的各种数据信息。点击图3-1-1中的“xxx报价单”链接，由Struts控制调用QuotationManageAction中的viewQuotation方法，进入如下图所示的页面图3-1-43.1.2.4. 导出允许销售人员，拓展部主任将报价单的某些信息导出为PDF文档。点击点击图3-1-1中的“导出”按钮，由Struts控制调用QuotationManageAction中的exportQuotation方法，进入如下图所示的页面:图3-1-53.1.2.5. 提交报价单如果报价成功，并且报价单里面有测试服务的信息，那么就证明实验室要对客户提供一系列的测试服务。这一系列的测试服务就对应着一个测试服务单。在提交报价单后，系统自动生成测试服务单。由Struts控制调用QuotationManageAction中的submitQuotation方法，提交报价单，如果提交成功，则返回succes，否则返回fail。3.1.2.6. 查看测试服务单 本功能允许销售人员 拓展部主任查看由本报价单生成的测试服务单。点击图3-1-1中的“查看测试服务单”按钮，由Struts控制调用TestServiceListManage中的viewTestServiceEnter方法，查看报价单对应的测试服务单，如果查看成功，则返回如下界面，否则返回fail。图3-1-63.1.2.7. 查看付款通知单本功能允许提供了查看由本报价单生成的付款通知单。点击图3-1-1中的付款通知单列中的“查看”按钮，由Struts控制调用QuotationManageAction中的viewPayNotice方法，如果查看成功，则返回如下界面，否则返回fail。图3-1-73.1.2.8. 追加报价单针对某一个报价单，若客户的测试需求变化，增加了测试服务或测试设备的数量等，可以追加若干个报价单。追加的报价单编号也由系统按照一定规则生成。点击图3-1-1中的“追加”按钮，由Struts控制调用QuotationManageAction中的additionalQuotationEnter方法对具体报价单进行追加并进入图3-1-2所示页面。编辑完毕后，再通过调用QuotationManageAction的additionalQuotation方法对其具体报价进行追加。3.1.2.9. 编辑本功能允许编辑修改报价单。销售人员只能修改自己生成的报价单，管理员可以修改所有的报价单。点击图3-1-1中的“编辑”链接，由Struts控制调用QuotationManageAction中的modifyQuotationEnter方法对具体报价单进行编辑。并进入图3-1-2所示页面。编辑完毕后，在通过调用QuotationManageAction的modifyQuotation方法对其具体报价进行修改。3.1.2.10. 删除本功能允许删除报价单。但为了保持数据的完整性，不建议使用此功能。删除报价单时，会将该报价单关联的测试服务单一并删除。只有管理员被允许删除报价单。点击图3-1-1中的“删除”按钮，由Struts控制调用QuotationManageAction中的deleteQuotation方法对具体报价单进行删除。3.1.2.11. 撤销报价单对应的测试服务未进行任何测试操作时，可取消报价单。未进行任何测试操作的定义是：测试工程师未对任何一个测试例进行测试后做保存操作。报价单撤销后，报价单、报价单对应的测试服务单、测试服务单对应的测试例清单状态均修改为“已撤销”。点击图3-1-1中的“撤销”按钮，由Struts控制调用QuotationManageAction中的cancelQuotation方法对具体报价单进行撤销。3.2. 测试服务单管理3.2.1. 数据及接口说明功能概述：测试服务单管理包括项目负责人对测试例清单的分配和项目经理对测试服务单的拆分，主要涉及到项目负责人设置项目经理，对测试服务单状态的管理，测试服务单对应的测试例清单的管理（包括测试对测试例清单的增、删、改、查）以及保存和提交测试服务单等动作。Action名Service名TestServiceListManageActionServiceRecordManageServiceEmployeeService表3-2-1 测试服务单管理3.2.1.1. 接口页面图3-2-1 接口页面3.2.1.2. Action接口Action方法名调用service方法名返回值MappingtestServiceList测试服务单列表getTestServiceList(Employee e)获得测试服务单列表successTestServiceList.jspFailError.jspSetProjectManagerEnter设置项目经理入口getEmployeeByRoleName(PROJECT_MANAGER)获得角色名的所有用户successSetProjectManager.jspFailError.jspSetProjectManager设置项目经理saveProjectManager(testserviceid,userid)保存项目经理successTestServiceList.jspFailError.jspviewTestServiceEnter查看测试服务单getTestService(id,type)获得测试服务对象successTestServiceView.jspFailError.jspsubmitAllotServicelist提交分配给项目经理的的服务单assignTestService (serviceid)分配测试服务单successTestServiceList.jspFailError.jspsubmitWaitAllotServicelist项目经理提交已拆分的测试服务单submitTestService (serviceid)提交已拆分的测试服务单successTestServiceList.jspFailError.jsptestExampleList测试例清单列表getTestExampleByTestSeriveListId (testserviceid)根据测试服务单获取其拆分的所有测试例清单列表successFailError.jspaddTestExampleEnter增加测试例清单入口getTestService(serviced,flag)getWaitAllotTestTree (serviceid) 获取测试服务单待分配的测试例树getEmployeeByRoleName(TEST_ENGINEER)根据角色获得用户successTestExampleView.jspFailError.jspmodifyTestExampleEnter修改测试例清单入口getTestTreeWithExampleId (testExampleid)获取某个测试例清单的测试例树getTestExample(exampleid)获得测试例清单dtogetEmployeeByRoleName(TEST_ENGINEER)successTestExampleView.jspFailError.jspaddTestExample生成测试例清单saveTestExampleList(TestExampleDTO)生成测试例清单successTestExampleList.jspFailError.jsptestExampleView查看测试例清单getTestExample(testExampleid)获取测试例清单successTestExampleView.jspFailError.jsptestExampleListView测试例清单列表查看getTestExampleByTestSeriveListId (serviceid)根据测试服务单获取其拆分的所有测试例清单列表successtestExampeList.jspFailError.jspdeleteTestExample删除测试例清单deleteTestExample(testExampleid)删除测试例清单successTestExampleList.jspFailError.jspackTestServiceFinish确认测试服务完成confirmTestService(serviceid)确认测试服务完成successTestServiceList.jspFailError.jsp表3-2-2 action定义3.2.1.3. 数据传输对象定义Dto名属性值TestSeriveListDTO测试服务单对应基础数据中的测试服务单：TestExampleListDTOUserInfoDTO同基础数据管理中的UserInfoDTOTestExampleListDTO测试例清单String testid, name,testserviceid,state, Leader表3-2-3 dto定义3.2.1.4. Service接口Service方法名参数及说明返回值SERVICE名getTestServiceList(Employee user)User:当前登录用户ListTestServiceManageServicegetUserByRole(rolename)rolename:角色名ListUserManageServicesaveProjectManager(testserviceid,userid)testserviceid：测试服务单名，userid：用户名Fail/successTestServiceManageServicegetTestService(id,type)获得测试服务单id：测试服务单id/报价单id,type(testserviceid,quoteid)TestSeriveListDTOTestServiceManageServiceassignTestService(serviceid)分配测试服务单Serviced测试服务单idFail/successTestServiceManageServicesubmitTestService(serviceid)项目经理提交已拆分的测试服务单Serviced测试服务单idFail/successTestServiceManageServicegetWaitAllotTestTree(testserviceid)获取测试服务单待分配的测试例树testserviceid：测试服务单idListTestServiceManageServicegetTestTreeWithExampleId (testserviceid)获取某个测试例清单的测试例树以及测试服务单待分配的测试例testserviceid：测试服务单idListTestServiceManageServicegetTestExampleByTestSeriveListId(serviceid)根据测试服务单获取其拆分的所有测试例清单列表serviceid：测试服务单idListTestServiceManageServicegetTestExample(testExampleid)获取测试例清单testExampleid：测试例清单idTestExampleListDTOTestServiceManageServicesaveTestExampleList(TestExampleListDTO)生成测试例清单TestExampleListDTO测试例清单Fail/successTestServiceManageServicedeleteTestExample(testExampleid)删除测试例清单testExampleid:测试例清单idfail/successTestServiceManageServiceconfirmTestService(testExampleid)确认测试服务单testserviceid：测试服务单fail/successTestServiceManageService表3-2-4 service接口定义3.2.2. 功能设计描述3.2.2.1. 查看测试服务单 本功能允许项目部负责人和项目经理查看测试服务单。 点击图3-2-1中的“xxx测试服务单”链接，由Struts控制调用TestServiceManageAction中的viewTestServiceEnter方法对测试服务单进行查看。同时进入如下页面：图3-2-23.2.2.2. 修改测试服务单本功能允许修改测试服务单。项目部负责人、项目经理只能修改自己负责的测试服务单，管理员可以修改所有的测试服务单。点击上图中的“修改”链接，由Struts控制调用TestServiceManageAction中的modifyTestExampleEnter方法对测试例清单进行编辑。同时进入如下页面：3.2.2.3. 设置项目经理本功能允许设置处理本测试服务单的项目经理。当测试服务单处于新建的状态时，允许项目部负责人设置项目经理任进行下一步操作。图3-2-3当测试服务单处于新建的状态时，允许项目部负责人设置项目经理任进行下一步操作。3.2.2.4. 生成测试例清单本功能允许创建测试服务单对应的测试例清单。（清单也是有编号的）图3-2-4点击图中的“增加”链接，由Struts控制调用TestServiceManageAction中的addTestExample方法来增加测试例清单。同时进入如下页面：图3-2-53.2.2.5. 编辑测试例清单测试例清单创建后，本功能可以对其进行继续编辑修改。图3-2-6点击上图中的“修改”链接，由Struts控制调用TestServiceManageAction中的modifyTestExampleEnter方法对测试例清单进行编辑。同时进入如下页面：图3-2-73.2.2.6. 提交测试服务单若测试例清单均已编辑完成，则测试服务单便可以提交，提交后测试工程师可查看。此时测试服务单的状态由“拆分”变为“提交”。点击上图3-2-1中的“提交”链接，由Struts控制调用TestServiceManageAction中的SubmitTestService方法对测试服务单进行提交。提交成功返回success，否则fail。3.2.2.7. 查看测试例清单测试服务单需拆分为若干个测试例清单，在拆分完成并提交后，项目经理和项目部负责人可以查看由其负责的测试服务单对应的测试例清单。点击上图3-2-4中的“查看”链接，由Struts控制调用TestServiceManageAction中的testExampleView方法查看测试例清单。同时返回页面如图3-2-7所示。3.2.2.8. 删除测试例清单本功能允许删除测试服务单。但为了保持数据的完整性，不建议使用此功能。删除测试服务单时，会将该测试服务单关联的测试例清单一并删除。只有管理员被允许使用删除功能。由Struts调用TestServiceManageAction中的deleteTestExample方法，以删除选中的功能。3.2.2.9. 确定测试服务单完成 当一个测试服务单所对应的所有测试例清单完成后，测试服务单状态改变为“测试完成”，此时项目经理可以对其进行确认，则测试服务单状态修改为“已确认”，确认后销售人员可以查看到报价单的状态“测试完成”，销售人员可生成付款通知单。点击上图3-2-1中的“确认完成”链接，由Struts控制调用TestServiceManageAction中的ackTestServiceFinish方法确认测试服务单完成。确认成功返回success，否则fail。3.3. 测试例清单管理功能概述： 测试例清单管理模块实现对测试例清单的查看，编辑，测试，提交等功能。本模块主要对测试例清单进行管理。相关的实现设计及接口描述如下：Action名Service名TestExampleListManageActiontestExampleManag