渣钢厂设备管理系统详细设计说明书.doc

渣钢厂设备管理系统详细设计说明书 最后修改日期 2007-16 最后修改者 李红亮目录1简介62全局常量和变量7Session（“UserID”）7Session(“RoleName”）7Session(“URLList）73底层类详细定义和关系83。1设备台帐管理83。1。1设备基本信息管理83.1.2设备异动223.1。3设备调拨433.1.4设备技术文档673.2点检与检修管理803。2.1设备检查803。2。2审批流程923.2。3检修计划1023.2。4设备检修1273.3工单与系统管理1353.3.1工单管理1353。3.2系统管理1513.4机旁备件管理1923。4。1公共类1923.4.2备件台帐1963.4.3备件出库2103.4。4备件入库2203。4。5备件流转2323.4。6备件计划2393.4.7修理计划2453。4.8质量异议2533.5审批管理2603。5。1审批管理2604WEB自定义控件说明2744。1查询控件2744。1.1概述2744。1.2UI界面2744.1。3属性定义2754.1.4事件定义2764.1。5样例说明2774.2日期控件2774.2.1概述2774。2。2UI界面2784.2.3属性定义2784.2.4事件定义2784.2。5样例说明2784。3菜单导航控件2784。3.1概述2784。3.2UI界面2794.3.3属性定义2794.3。4事件定义2804。3.5样例说明2804.4链接导航控件2804。4。1概述2804.4。2UI界面2804。4.3属性定义2804。4。4事件定义2814。4。5样例说明2814.5导出Excel表格控件2814.5.1概述2814。5。2UI界面2814。5。3属性定义2814。5.4事件定义2824。5。5样例说明2825WEB窗体详细说明2835。1设备台帐管理2835。1。1设备基本信息管理2835。1。2设备异动2865。1.3设备调拨2895.1.4设备技术文档2915.2工单与系统管理2945.2。1工单管理2945。2。2系统管理2975.3点检与检修管理3025.3。1设备检查3025。3。2审批流程3045。3。3检修计划3055.3。4设备检修3065。4机旁备件管理3075。4.1备件清册3075。5机旁备件管理3085.5.1备件台帐3085。5.2备件出库3115。5。3备件入库3135.5.4备件计划3175.5。5备件流转3195.5。6修理计划3215。5。7质量异议3245。6审批管理3265。6.1审批项目管理3265.6.2审批人员管理3276WEB函数、成员变量定义3276。1设备台帐管理3276。1。1设备基本信息管理3276.1。2设备异动3366。1.3设备调拨3466.1。4设备技术文档3566.2工单与系统管理3696.2。1工单管理3696.2.2系统管理3846。3点检与检修管理4106。3。1设备检查4106.3。2设备审批4176.3。3检修计划4196。3。4设备检修4276。4机旁备件管理4356.4.1备件台帐4356。4.2备件出库4466。4.3备件入库4546.4.4需求计划4616.4.5备件流转4676。4.6修理计划4726。4。7质量异议4866.5审批管理4956.5。1审批项目管理4956。5。2审批人员管理5017各层之间交互序列图5037.1设备台帐管理5037.1.1设备基本信息管理5037.1。2设备异动5067。1.3设备调拨5117。1.4设备技术文档5147.2点检与检修管理5167。2。1设备检查5167.2.2审批流程5177。2。3检修计划5187。2。4设备检修5217.3工单与系统管理5227。3。1工单管理5227.3。2系统管理5267.4机旁备件管理5347。4.1备件台帐5347.4.2备件出库5367。4。3备件入库5377。4。4备件流转5407。4.5备件计划5427。4.6修理计划5437.4。7质量异议5457。5审批管理5477。5。1审批管理5471 简介本文档包括对 Web 应用程序中每个模块所涉及的类的具体定义。开发人员可以根据本详细设计说明书来编写代码。Web 应用程序对应着一个 ASP.NET Web 应用程序类型的解决方案 BLL：业务逻辑层,处理应用程序中的业务逻辑DALFactory：根据配置文件实例化数据访问层接口.使系统易于移值到其它数据库平台。 IDAL:数据访问层的接口 Model：数据层实体或视图类 SQLServerDAL:数据访问层接口的SQLServer实现 Utility:公有项目。用于实现数据访问层实体的构造以及一些自定义控件的定义2 全局常量和变量Session（“UserID”）当用户登录成功后，“登录”窗体将用户的员工编号记录在Session 中。其他功能模块都要检索该Session 变量以获得当前用户的员工编号。Session(“PrivilegeList”）当用户登录成功后,“登录”窗体将用户的权限列表记录在ession中。其他功能模块在需要时要检索该ession变量以获得当前用户的所有权限。Session（“URLList”）当用户登录成功后，“登录”窗体将用户可以访问的URL记录在Session中.其他功能模块的页面通过检索该Session变量以判断登录用户是否有访问当前页面的权限.3 底层类详细定义和关系3.1 设备台帐管理3.1.1 设备基本信息管理3.1.1.1 设备台账BLL层类图3.1.1.2 类定义3.1.1.2.1 DeviceInfoBLL类定义数据类型描述IdiIDeviceInfo对数据库中DeviceInfo表进行操作的接口引用.l 成员变量AddDevice该函数将从再DeviceInfo表中创建一条缺省的设备台帐记录返回值bool型变量，表示操作成功与否参数数据类型描述RecordDeviceInfo记录信息DeleteDevice该函数将伪删除一条台帐记录，将record的isdelete属性设置为yes返回值bool型变量，表示操作成功与否参数数据类型描述IdString记录的deviceIDSearchDevice该函数将按条件查询记录返回值IListDeviceInfo 符合条件的记录集合参数数据类型描述ConditionString条件集合UpdateDeviceID该函数将更新一条台帐记录返回值Bool型变量，表示操作成功与否参数数据类型描述RecordDeviceInfo要更新的数passDeviceID修改信息-查找deviceID的行数据返回值DeviceInfo型对象，符合条件的一条记录参数数据类型描述deviceIDstring记录ID3.1.1.2.2 UserViewBLL类用于查询信息定制的业务逻辑处理.l 成员变量定义数据类型描述iUserViewIUserView对数据库中UserView表进行操作的接口引用。DEVICEINFO_TYPEIListString设备台账中的全部属性名称LENGTHint用户可以显示的字段数m_userViewstring用户的视图m_nonUserViewstring不在用户的视图中字段INFOMATIONstring设备表真实的属性名称l 成员函数SetDefaultView该函数将从再UserView表中将一条用户视图记录置为缺省值。调用DAL层的接口来得到当前用户对应的UserView表中的主键值并对UserViewInfo的对象进行填充返回值bool型变量，表示操作成功与否参数数据类型描述sUserIDString用户的ID号ModifyUserView该函数将此用户的查询视图进行修改，并将Userview相应的记录中的istrue字段置为1返回值bool型变量，表示操作成功与否参数数据类型描述sViewstring从页面得到的用户的视图的字段userIDstring用户的IDistruestring是否为缺省值，为缺省值为0否则为1GetUserView该函数将得到当前用户的设备台账信息的属性名称，调用DAL层的接口来得到一个UserViewInfo的对象，并调用GetUserViewValues（）来抽取有用的信息，调用ChangeInfo（)方法来对数据库中存储的信息做变换返回值string型变量，表示用户的查询定制视图的设备表真实的属性名称参数数据类型描述userIDString用户的ID号GetNonUserView该函数将用户的查询信息定制中没有的设备台账属性名返回,根据m_userView来对m_nonUserView进行填充.返回值string型变量，表示用户的查询信息定制中没有的设备台账属性名参数数据类型描述无GetViewsNumber返回用户视图的大小,即得到m_userView的长度，如果m_userView为null的话,则返回1返回值int型变量，表示m_userView的长度参数数据类型描述无GetViewIndex该函数找到用户视图在字段数组中的位置返回值int型变量，如果s在INFORMATION中则返回在INFORMATION中的下标，否则返回1参数数据类型描述sstring一个随意的字符串GetUserViewLength该函数用于找到UserViewInfo的一个对象除去前3个属性后的非空值的属性个数返回值int型变量,表示UserViewInfo的一个对象除去前3个属性后的非空值的属性个数参数数据类型描述uviUserViewInfo将被检测的对象start1int从第start11个属性开始遍历GetUserViewValues抽取UserViewInfo的对象的属性值并用于填充一个字符串数组返回值无参数数据类型描述uviUserViewInfo将被抽取属性值的对象sstring将被填充的字符串数组start1int从第start11个属性开始遍历start2int从第start2的位置开始填充FillUserViewInfo从s的第start2开始为UserViewInfo的uvi的第start1+1属性进行填充返回值无参数数据类型描述uviUserViewInfo将被抽取属性值的对象sstring将被填充的字符串数组start1int从第start11个属性开始填充start2int从第start2的位置开始遍历FindIn用于查找s是否在comp数组中返回值bool型变量，表示s是否在comp数组中，如果在，则返回true,否则返回false参数数据类型描述sstring目标字符串scompstring 用于搜索s的字符数组AddUserView用于查找s是否在comp数组中，调用DAL层中相应的接口来找到当前数据库中的最大UserViewID，并对此值加1赋给当前的UserViewInfo的对象中的UserViewID，istrue属性赋为0,并用DEVICEINFO_TYPE中的前七项对此对象进行填充,然后调用DAL层中的AddUserView(）来添加新的记录返回值bool型变量，表示此操作是否成功。参数数据类型描述sUserIDstring用户的IDChangeInfo将View中的内容替换成相应的changeTo中的内容返回值无参数数据类型描述viewstring要被替换的数组viewInfostring要进行对比的标准数组changeTostring数组中的相应的数据将被用来填充到view中3.1.1.3 设备台账DALFactory层类图3.1.1.4 类定义3.1.1.5 设备台账IDAL层类图3.1.1.6 类定义4.1.1.6.0 IDeviceInfo接口：CreateDevInfo该函数将从再DeviceInfo表中创建一条缺省的设备台帐记录返回值bool型变量，表示操作成功与否参数数据类型描述RecordDeviceInfo记录信息DeleteDevInfo该函数将伪删除一条台帐记录，将record的isdelete属性设置为yes返回值bool型变量，表示操作成功与否参数数据类型描述IdString设备台账的IDSearchDevInfo该函数将按条件查询记录返回值IList（)方法得到用户的视图，如果此视图中的istrue字段既不为1也不为0则返回此视图模型，否则返回null返回值UserViewInfo型变量，表示用户的查询定制的视图参数数据类型描述sUserIDString用户的ID号AddUserView该函数将从再UserView表中创建一条缺省的用户视图记录返回值bool型变量,表示操作成功与否参数参数参数sUserUserViewInfo用户的视图类CurrentIndex该函数将从再UserView表中根据当前的用户的id号得到此记录的主键值UserViewID返回值Int32型变量,表示当前的用户记录的主键值参数参数参数userIDstring用户ID号MaxIndex该函数将从再UserView表中根据现存的记录得到此记录的主键值UserViewID返回值Int32型变量，表示现存记录的最大的主键值参数参数参数无3.1.1.9 设备台账Model层类图3.1.1.9.1 DeviceInfo 字段说明:属性类型编码（ID)备注拥有部门Nvarchar(50)deviceOwner台帐编号Nvarchar（50)deviceID可手工输入，也可自动生成设备类型Nvarchar（50）deviceType指定设备所属的类型设备名称Nvarchar(50）deviceName人工录入设备的名称型号规格Nvarchar（50)deviceSpec用于录入设备在厂家指定的型号规格数据制造单位Nvarchar(50)deviceFrom此设备的原厂单位名称数量intcount指定此设备的数量计量单位Nvarchar（50）countUnit指定设备计量的单位，如米、件、台等。此数据在系统设置中进行设定，在此可以选择录入重量intweight设备的重量数字值重量单位Nvarchar(50)weightUnit重量的单位，录入者录入.在系统设置中初始化。购入日期DateTimedateBuy指定设备的购入日期投产日期DateTimedateShip指定设备投入使用的日期验收日期DateTimedateCheck指定投备验收的日期保修期限intlimit以月为单位指定设备的保修期限使用部门Nvarchar(50)deviceUser指定拥有和管理设备的部门管理人员Nvarchar(50）manageUser指定维护和使用此设备的人员.可以录入多个人设备原值Nvarchar(50)deviceValueOld设备采购时的价格设备净值Nvarchar(50）deviceValueNet设备经折旧或大修之后现在的价值安装地点Nvarchar（50）deviceSetupPoint设备安装所在的地点设备状态Nvarchar（50）deviceState指定设备的状态，其状态数据有：上线、封存、闲置、报废、待修、备用.在设备易动中改变值。是否删除Nvarchar（50)isDelete指名此设备是否已删除录入日期DateTimedateLogin系统默认为当前的日期，此日期不是本地机器的日期，而是从服务器上得到的标准日期录入人员Nvarchar(50)userLogin录入此记录的人员,系统指定是当前登陆操作人最近一次修改人Nvarchar（50）userLastUpdate设备资料最后一次修改的人员最后一次修改日期DateTime(50)dateLastUpdate设备资料最后一次修改的时间3.1.1.9.2 userViewInfo属性说明定义数据类型描述userViewIDInt32视图的IDUseridString用户idIstrueString是否有效FirstString存放deviceInfo的一个属性名SecondString存放deviceInfo的一个属性名ThirdString存放deviceInfo的一个属性名FourthString存放deviceInfo的一个属性名FifthString存放deviceInfo的一个属性名SixthString存放deviceInfo的一个属性名SeventhString存放deviceInfo的一个属性名3.1.2 设备异动3.1.2.1 BLL层3.1.2.1.1 类图：3.1.2.1.2 类定义：StateChangeApplyBLL类：成员变量：定义数据类型描述StatechangeIStateChangeApply用以获取statechangeApply操作实例newCheckICheck用以获取CheckManage操作实例newCheckPersonICheckPerson用以获取CheckPersonManage操作实例deviceInfoIdeviceInfo用以获取DeviceInfoDAL操作实例成员函数:FomatString(）转换成字符串的函数,返回系统当前时间，去除特殊字符和空格返回值String参数数据类型描述无GetSCHApplyRecordS_ALL()返回所有异动申请记录返回值IListStateChangeApplyInfo参数数据类型描述无GetSCHApplyRecordS_End（）返回所有审批结束了的记录返回值IListStateChangeApplyInfo参数数据类型描述无GetSCHApplyRecordS_Success（)返回所有成功通过的申请记录返回值IList参数数据类型描述无GetSCHApplyRecordS_Fail（)返回所有申请失败的申请记录返回值IListStateChangeApplyInfo参数数据类型描述无GetSCHApplyRecordS_Wait（)返回所有等待申请中的申请记录返回值IList参数数据类型描述无GetSCHApplyRecordS_Condition(string condition）返回申请记录集合，通过由自定义控件返回的条件返回值IList，通过设备ID和申请状态，可以提出正在申请中的，可以提出申请成功的提出申请成功的，可以供历史记录用返回值IList参数数据类型描述DeviceIDstring设备idapplyStateInt申请状态，和申请表的applyState字段相对应ShowForApprove（string approveManID）此方法提供审批用把正在等待审批的申请记录提取出来,根据审批者的ID返回值IListStateChangeApplyInfo参数数据类型描述approveManIDstring审批人的idStateChangeApproveBLL类 成员变量：定义数据类型描述IstIStateChangeApprove定义SQLServerDAL层的审批类ist对象Ist1IStateChangeApply定义SQLServerDAL层的申请类ist1对象approveDetailsIViewStateChangeApproveDetails定义Model层的IViewStateChangeApproveDetails对象成员函数:Approve判断审批同意与否返回值Bool参数数据类型描述stateChangeIDstring申请IDmodelStateChangeApproveInfo审批模型GetStateChangeApproveDetails根据设备异动审批记录的stateChangeID从View_StateChangeApproveDetails表中获取审批记录集合,以便获知需要插入的记录是第几次审批返回值IList参数数据类型描述stateChangeIDstring申请IDGetLevel得到审批级数返回值Int参数数据类型描述stateChangeIDstring申请IDfomatString格式化时间字符串返回值String 时间转换后的字符串参数数据类型描述3.1.2.2 Model层3.1.2.2.1 类图：3.1.2.2.2 类定义：ChangeStateApply类成员变量：定义数据类型描述_stateChangeID字符串异动申请记录编号_deviceID字符串异动的设备编号_applyTime时间申请异动的时间_approveType字符串异动申请的审批方式_presentState字符串设备当前状态_applyNewState字符串设备异动申请的新状态_applyState整型申请表所处的状态,-2失败,-1成功，0有0个人审批过,1有1个人审批过，2有2个人审批过_approveTimes整型初始化为需要的审批次数，每审批一次减一_deviceName字符串设备名称_deviceOwner字符串设备主管部门StateChangeApprove类 成员变量：定义数据类型描述_stateChangeID字符串映射数据库StateChangeApprove表中的设备异动ID字段stateChangeID_ackPersonID字符串映射数据库StateChangeApprove表中申请人的ID字段_ackPersonAdvice字符串映射数据库StateChangeApprove表中的申请人意见字段_ackStateChangeLevel整型映射数据库StateChangeApprove表中的审批级别字段_ackStateChangeTime时间映射数据库StateChangeApprove表中的审批时间字段_ackStateChangeResult字符串映射数据库StateChangeApprove表中的这次审批结果字段View_StateChangeApproveDetails类 成员变量定义数据类型描述_ackStateChangeTime字符串映射数据库View_StateChangeApproveDetails表中的审批时间字段_ackStateChangeResult字符串映射数据库StateChangeApproveDetails表中的这次审批结果字段_ackStateChangeLevel字符串映射数据库StateChangeApproveDetails表中的审批级别字段_ackPersonAdvice整型映射数据库StateChangeApproveDetails表中的申请人意见字段_ackPersonID映射数据库StateChangeApproveDetails表中的审批人ID字段_stateChangeID时间映射数据库StateChangeApproveDetails表中的申请ID字段_employeeName字符串映射数据库StateChangeApproveDetails表中的审批人的姓名字段3.1.2.3 IDAL层3.1.2.3.1 类图3.1.2.3.2 类定义StateChangeApplyDAL接口该接口负责定义异动申请记录与SQL数据库的交互。成员函数GetApplyInfoByApplyID(string stateChangeApplyID）返回一条申请纪录，通过申请ID返回值StateChangeApplyInfo参数数据类型描述stateChangeApplyIDstring对应的一条设备异动申请记录idGetSCHApplyRecordS_ALL()返回所有申请记录返回值IList参数数据类型描述无GetSCHApplyRecordS_End()返回审批结束了的记录返回值IListStateChangeApplyInfo