CND-ERP-SD-系统设计规范

1、系統設計規範V1.0一般提示示讯息编码原原则中定义的的信息回馈告告知使用者，如如【储存成成功！】Confirmm提示讯息规规范删除操作时，统统一提示确定要删除吗吗？确定取消消。取消操作时编辑状态提示:请确认是否取取消编辑？确定取消消。查看状态无提示示，直接关闭闭页面。编辑状态,点XX提示是否关关闭的说明,且需调用固固定的方法(Rebo提提供的)系统讯息UI呈呈现模式系统讯息UI呈呈现模式，不不会使用屏蔽蔽(maskk)方式。具具体的呈现模模式会以Allert,CConfirrm呈现。系统讯息使用传统aleert方式显显示讯息。如如新增，删除除等操作给出出的储存成功功、失败等。多语系处理规范范请

2、参考文檔,主要说明Reesourcces使用方方式。Log处理规范范数据库中每支TTable对对应其一支TTableLLog。程序每支功能可可由客户设置置是否开启记记录DataaLog。DataLogg功用模块需需传入异动数数据集合与功功能名称，由由功用模块解解析数据拼接接成SQL语句进进行执行。注注：数据删除除操作不记录录DataLLog。DataLogg应在BusiinessRRule层调调用，调用写写法如下：异常处理异常分为两种：程序异常，业业务异常。EERPExcceptioonManaager是工工程中所有自自订异常的父父类，程序中中自订异常需需继承该父类类。出现异常，由功功用模块自

3、动动把异常信息息存入数据库库中，异常信信息分三种客客户角色分别别提示、存储储三种不同信信息，分：系系统使用者（User），系统管理员（Administrator），系统维护者（Programer），提示信息内容由SA定义，并由SA定义Resources编码规范。注：提示信息Resources编码规范未提供。程序预计会出现现异常地方，或或与数据库交交互部分都应应由trycatchh包裹，cattch中应throow出自订的的程序异常()，并把抓抓取的Excceptioon作为参数数传入自订日日常。调用写写法如下：业务异常由SAA定义，每种种业务异常是是单独存在的的一个Claass，业务务异常应是

4、逻逻辑判断，非非tryccatch包裹，应根根据SA的说明，判判断后直接tthrow出出规定的异常常类型。调用用写法如下：异常部分应在BBusineessRulle层调用，抛抛出异常后，在在BasePPage捕捉捉到异常判断断，程序异常常跳转Errror页面，业业务异常弹出出提示框，用用户点选后返返回异常之前前的状态。发发生异常时系系统呈现给uuser的错错误画面如下下: 异常处理判断部部分，由Maaster母母版页对AJJAX请求处处理。如下图图：异常处理判断部部分，由BaasePagge请求处理理。如下图：多数据库支持系统只支持LOOG，报表功功能划分出去去作为单独的的数据库。每添加一台数

5、据据库，需添加加一个NHiibernaate配置文文件。同时需需在NHibbernatteISesssionFFactorry.cs（如下图图一）中添加加一个静态的的二级缓存（如如下图二），及及数据库筛选选（如图三）。图一图二图三现提供DataaLog、ErrorrLog、报报表功能使用用的NHibbernatte配置文文文件，均从WWeb.coonfig中中设置。如下下图：共通性规范英文字母存入数数据库时的处处理方式数据库内英文字字母是区分大大小写的，目目前本系统的的处理方式为为若代码、编编号为英文,一律转大写写；若ID为英文，则则不做转大写写动作。Table间的的Join方式式SD Spe

6、cc中若没有说说明Tablle间的Joinn方式，则通通一按照Innner JJoin进行行处理。Ajax使用时时机系统在设计开发发时，应注意意非必要刷新新数据库时因因需使用Ajjax技术，以以获得较好的的用户体验效效果删除方式本系统中的删除除方式有两种种：真删除与与假删除，请请依SD档进行。若为假删除，只只需更新固定定状态列位DDataStt为D即可。若真删除，直接接删除改笔数数据。查询方式如未有特殊要求求，查询、关关联条件需加加入查询或关关联表的DaataSt=N。针对DataSSet=N 使用情况如如下:查询时,DattaSet=N，Join 时，DataaSet 不不用= N因在”jo

7、inn”时，因被假假删除的资料料，亦要被jjoin后显显示出历史的的值。故不需需下DataaSet=NN。Sessionn说明与使用用系统中的登入者者信息统一放放在UserrInfo这这个Classs中，其属属性说明请参参考 文文件关于异常常处理的说明明。系统在新增与修修改时使用SSessioon规则说明明新增时，需要增增入下面字段段元:DataSt = NDataOwnner = UserIInfo.DDataOwwnerIddCreateOOu = UUserInnfo.DaataOwnnerOuCreateUUser = UserrInfo.UserIIDCreateDDate = ge

8、tddate()修改时只需异动动下面两个字字段:ModifyUUser = UserrInfo.UserIIDModifyDDate = getddate()字段类型与长度度程序开发中针对对字段元部分分，其长度与与类型皆以DDB Schhema定义义为依据。此此处的长度是是字段元的最最大长度，画画面的显示长长度以能完整整显示字段元元内容为标准准，但也需兼兼顾画面美观观。另外，特殊部分分会在SD档中另外外说明。Window.open开窗窗相关处理方方式关闭弹出窗口，父父页面是否要要刷新:若弹出窗口的回回传值是以JJS回传到父父页面，则不不用刷新父页页面(ex:快选单窗口口)。若弹出窗口的用用途为

9、维护单单据内容主档档，则要刷新新父页面。若弹出窗口的用用途为维护单单据内容子档档，则仅要刷刷新父页面中中的子档部分分。父页面处于编辑辑状态，关闭闭弹出窗口，是是否要刷新？若弹出窗口的回回传值是以JJS回传到父父页面，则不不用刷新父页页面(ex:快选单窗口口)。若弹出窗口的用用途为维护单单据内容子档档，则仅要刷刷新父页面中中的子档部分分。子窗体未关闭，父父页面关闭了了，怎么处理理？父页面关闭时不不进行连动关关闭子窗口。父页面已关闭则则子窗口的回回传值会有JJS错误(找不到父页页面物件)，此时需在在子窗口的回回传时进行判判断(tryy.cattch)，不不可产生JSS错误。子页签删除按钮钮状态控制

10、新增主页后，子子页若无数据据时，删除请请显示为diisablee 。子页巳巳新增资料后后，在查看时时，删除才显显示为 ennable。英文名称栏位检检核规则针对功能页面中中英文名称栏栏位，提交时时，检核方式式为：除中文文外其它都可可输入。查询条件，区间间栏位检核规规范日期起日日期期迄日: 需检核迄迄日=起日天数起日天数数迄日：需检检核迄日=起日若有其它区间栏栏位，需做同同样的逻辑检检核。档案上传及命名名规范系统中图文件与与附件的上传传方式使用hhttp，以以网页的方式式浏览上传，请请统一以下列列规范进行Web.Connfig设定定在此文件中需设设定文件上传传路径及上传传文件大小限限制上传路径上

11、传路径需要读读取Web.Confiig中的设定定参数取得SServerr端的对应路路径资料夹命名依照模块建立对对应数据夹，上上传的图档及及附近均放置置此资料夹下下。 档案命名命名规则以usserID+日期时间(yyyyy-MMM-dd HH:mmm:ss)，例例如GF-1100120010-055-25 110:20:30DB Scheema设计规规范 规范原则: 如如附件- 2201003315-ITT临时会议-DDB Schhema及重重要字段讨论论.docDB Scheema范本: 如附件-DBB Sechhma规格定定义.xlss是否启用字段启用/不启用：依功能需求求而定，字段段元设计

12、方式式如下字段名称形态是否为Nulll字段说明defaulttXXXEnFgg，例如：CoodeLisstEnFggChar(1)不允许Nulll0：不启用1：启用1DB 字段开立立细则:汇率字段一律开开成4位小数格式式所有不允许为NNull的字字段，除主外外键之外，其其它字段一律律需设定默认认值除建立数据日日期最最后修改日期期外，其它它日期字段固固定为允许nnull金额、数量类型型之字段，若若不允许nuull时,需预设0调用共享组件相相关功能DBB Scheema开立规规范:所处理功能，若若会调用共享享组件，在进进行DB SSchemaa开立时，需需要在所开立立Tablee的主键栏位位描述中

13、，加加入其关联共共享组件对应应Tablee说明。SD档撰写细则则对于画面需要使使用Ajaxx方式实现的的部份，SDD档应特别说说明画面进行的删除除方式，档需需明确是真删删除还是假删删除。Iframe页页面需传入参参数传入参数值SDD文件中应注注明。参数名称参数值WorkStN：新增S：提交D：删除E：编辑V：查看Sq资料主键查询区查询条件件暂存特殊情况：查询询页面存在维维护开窗页签签，且开窗方方式是winndows.open方方式，则此页页面查询条件件暂存需用SSessioon页面名名称编号，例如：SeessionnPuo00101。普通情况：单纯纯的查询页面面以ViewwStatee清单控件

14、件ID+WoorkSt暂存。例如如：ViewwStateegvCCurrenncyLisstWorkkSt。查询条件处理规规范共享选单页面，在在共享选单查查询部份，查查询条件对几几个模糊查询询的栏进以”oor”的方式式进行查询。针对非共享选单单的功能，若若非SA特殊要求求，统一以“and”的方式进行行查询。资料拥有者栏位位处理方式说说明资料拥有者栏位位，只会出现现在主页面中中，对应子页页签不会显示示此栏位。子页签存档时资资料所属人员员及单位对应应的值为主页页面所选择的的资料拥有者者栏位的值。上传程序处理及及调用规范规范适用范围: 所有调用用档案检视uusercoontroll页面(包括多档与与

15、单档)页面需处理方式式: 增加对档档案检视UCC的属性传入入: 当页面处于检视视状态时,XXXUCC. WorrkSt = V当页面处于检视视新增状态时时,XXXXUC. WWorkStt =NN当页面处于编辑辑状态时,XXXUUC. WoorkSt =E注意事项:每次页面刷新,需注意要保保证UC有正确传传入WorkkSt属性值值特殊页面需求需需注意WorrkSt之传传值,.例如:个人客户管理维维护画面,新增时不允允许编辑档案案上传,则此时不WoorkSt要要传入V检视栏位显示规规范对于Lablee 和 Lablle对应的值值，显示时按按Lablee + 空格格 + Laable对应应的值(对应的值以以靠左显示)如：订单单号+空格格+ORD10008000001 - 订单单单号 ORD10008000001由系统自行异动动或存档功能能，系统栏位位存值规范各功能由系統進進行資料異動動或存檔的作作業時，對於ModiffyUserr或是 CreeateUsser 等所所要註記的使使用者統一使用如下:ADM_EmpplyeeGUID: 000000000-00000-0000