CND-ERP-SD-系統(tǒng)設計規(guī)范

1、.系統(tǒng)設計規(guī)範V1.0PAGE ：.；All Right Reserved Copyright, 2021, LION TECHNOLOGY CO.,LTD. PAGE 26 -This document is the exclusive property of LION TECHNOLOGY CO.,LTD. and shall not be reproduced or copied or transformed to any other format without prior permission of LION TECHNOLOGY CO.,LTD. SUBJECT C&D ERP I

2、mplementationProject TITLE 系統(tǒng)設計規(guī)范_v1.0.8 DOCPROPERTY _Category DOCPROPERTY Categories DOCPROPERTY Assigned To DOCPROPERTY Approval Level DOCPROPERTY _Comments Prepared by： LION TECHOLOGY CO.,LTD.Created Date：2021/02/11系統(tǒng)設計規(guī)范SignatureCompanys NameNameSignatureDate版本修訂記錄版本修訂日期頁數(shù)修訂者修訂闡明1.0.02021/02/11U

3、ni初版。1.0.12021/3/25Janny系統(tǒng)提示訊息規(guī)范補充1.0.22021/3/29Uni根據(jù)SD內(nèi)部會議討論結(jié)果修正,以深紅色字底標注1.0.32021/03/30Uni根據(jù)SD,SA討論結(jié)果修正,以紫色字底標注1.0.42021/04/01Uni根據(jù)SD討論結(jié)果修訂,以分紅色標注1.0.52021/4/20Hellen調(diào)整檔案格式1.0.62021/4/29Janny添加刪除方式闡明及Session運用闡明1.0.72021/4/30Janny系統(tǒng)訊息UI呈現(xiàn)方式1.0.82021/5/6Janny參與Ajax運用時機闡明1.0.92021/5/11JannyDB Schema

4、設計參與能否啟用闡明1.0.102021/5/13Janny與Rebo討論后調(diào)整1.0.112021/5/20Janny系統(tǒng)編碼原那么補充添加程序開發(fā)時需參考的字段類型與長度闡明1.0.122021/5/25Janny添加檔案上傳相關(guān)規(guī)范1.0.132021-5-27Hellen調(diào)整維護區(qū)下拉選單預設選項1.0.142021/6/18Hellen根據(jù)與Joan確實認結(jié)果補充針對幣別字段的處置闡明1.0.152021/6/25TonyData Log 處置機制闡明1.0.162021/8/23Hellen將幣別字段清單中的顯示值有幣別中文改為幣別英文1.0.172021/9/4Lucifer規(guī)范

5、一致調(diào)整1.0.182021-9-25Hellen根據(jù)SA回復，調(diào)整及補充規(guī)范文件，主要更新：Window.open開窗相關(guān)處置， datast欄位的查詢限制，快選單失焦點的處置方式1.0.192021/10/7Hellen添加針對金額字段及對應有幣別換算的金額字段長度闡明.02021/10/8LuciferIframe頁面需傳入?yún)?shù)，查詢?nèi)ゲ樵儣l件暫存1.0.212021-10-15Hellen添加13.5調(diào)用共享組件相關(guān)功能DB Schema開立規(guī)范1.0.222021-10-21Hellen根據(jù)與月瓊確認規(guī)范進展補充：主要補充目錄17,18：查詢條件處置規(guī)范資料擁有者欄位

6、處置方式闡明1.0.232021-11-3Hellen根據(jù)Joan提供的刪除按鈕規(guī)范補充文件,對應目錄42021-11-12Hellen根據(jù)月瓊寄出規(guī)范進展補充英文稱號欄位檢核規(guī)那么，對應目錄52021-12-6Hellen根據(jù)月瓊寄出規(guī)范進展補充針對查詢條件日期及天數(shù)區(qū)間的檢核規(guī)范，對應目錄62021-1-4Hellen根據(jù)月瓊寄出規(guī)范進展補充針對系統(tǒng)自行異動或存檔的功能，系統(tǒng)參數(shù)存值規(guī)范1.0.272021/1/5Hellen變卦系統(tǒng)參數(shù)規(guī)范存值目錄 TOC o 1-3 h z u HYPERLINK l _Toc279417976

7、 1命名原則及規(guī)範 PAGEREF _Toc279417976 h 8 HYPERLINK l _Toc279417977 1.1檔檔案命名原則 PAGEREF _Toc279417977 h 8 HYPERLINK l _Toc279417978 1.2程式檔案命名原則 PAGEREF _Toc279417978 h 8 HYPERLINK l _Toc279417979 1.3方法(Method)名稱命名原則 (動作+描畫) PAGEREF _Toc279417979 h 9 HYPERLINK l _Toc279417980 1.4欄位變數(shù)及常數(shù)命名原則 PAGEREF _Toc2794

8、17980 h 9 HYPERLINK l _Toc279417981 1.5專案自訂控制項命名原則(UserControl) PAGEREF _Toc279417981 h 9 HYPERLINK l _Toc279417982 1.6按鈕類型的控制項命名(Xxx :目標名稱) PAGEREF _Toc279417982 h 9 HYPERLINK l _Toc279417983 2編碼原則 PAGEREF _Toc279417983 h 10 HYPERLINK l _Toc279417984 2.1介面文字編碼原則(UTF-8) PAGEREF _Toc279417984 h 10 HY

9、PERLINK l _Toc279417985 2.2語系檔編碼規(guī)則請參照。 PAGEREF _Toc279417985 h 10 HYPERLINK l _Toc279417986 3資料格式顯示及輸入規(guī)範 PAGEREF _Toc279417986 h 10 HYPERLINK l _Toc279417987 3.1代碼類型的資料假設需將代碼一併顯示: PAGEREF _Toc279417987 h 10 HYPERLINK l _Toc279417988 3.2日期資料 PAGEREF _Toc279417988 h 10 HYPERLINK l _Toc279417989 3.3時間資

10、料 PAGEREF _Toc279417989 h 11 HYPERLINK l _Toc279417990 3.4數(shù)位資料 PAGEREF _Toc279417990 h 11 HYPERLINK l _Toc279417991 3.5金額欄位 PAGEREF _Toc279417991 h 11 HYPERLINK l _Toc279417992 3.6下拉選單 PAGEREF _Toc279417992 h 12 HYPERLINK l _Toc279417993 3.7快選單 PAGEREF _Toc279417993 h 12 HYPERLINK l _Toc279417994 3.

11、7.1在查詢欄位輸入代碼，當onblur時，系統(tǒng)自動查詢代碼後，帶回其對應的名稱在所要顯示的位置。 PAGEREF _Toc279417994 h 12 HYPERLINK l _Toc279417995 3.7.2由運用者自行點選彈跳視窗進行查詢。 PAGEREF _Toc279417995 h 12 HYPERLINK l _Toc279417996 3.7.3查詢欄位不允許輸入，運用者只能點選彈跳視窗進行查詢。 PAGEREF _Toc279417996 h 13 HYPERLINK l _Toc279417997 3.7.4如SA另有特別要求，請參照SA特別方式處理。 PAGEREF

12、_Toc279417997 h 13 HYPERLINK l _Toc279417998 3.7.5可輸入方案，失焦點時處置方式： PAGEREF _Toc279417998 h 13 HYPERLINK l _Toc279417999 離開焦點時，則把欄位內(nèi)的值進行查詢。 PAGEREF _Toc279417999 h 13 HYPERLINK l _Toc279418000 查詢結(jié)果 PAGEREF _Toc279418000 h 13 HYPERLINK l _Toc279418001 .1查詢結(jié)果有一筆時，則帶回查詢結(jié)果的值。 PAGEREF _Toc279418001 h 13 HY

13、PERLINK l _Toc279418002 .2查詢結(jié)果有多筆時，則不彈跳視窗，也不帶回值。 PAGEREF _Toc279418002 h 13 HYPERLINK l _Toc279418003 .3查詢結(jié)果為0筆時，則彈跳視窗。 PAGEREF _Toc279418003 h 13 HYPERLINK l _Toc279418004 3.8默認值問題： PAGEREF _Toc279418004 h 13 HYPERLINK l _Toc279418005 頁面欄位的默認值由SA進行提供，假設有檢核區(qū)間，則默認值取區(qū)間內(nèi)最小值。非輸入型默認值假設SA沒有說明則默認第一個選項。 PAG

14、EREF _Toc279418005 h 13 HYPERLINK l _Toc279418006 4資料檢核驗證規(guī)範 PAGEREF _Toc279418006 h 13 HYPERLINK l _Toc279418007 4.1Client端資料檢核 PAGEREF _Toc279418007 h 13 HYPERLINK l _Toc279418008 5訊息提示規(guī)範 PAGEREF _Toc279418008 h 14 HYPERLINK l _Toc279418009 5.1檢核驗證訊息 PAGEREF _Toc279418009 h 14 HYPERLINK l _Toc27941

15、8010 5.2普通訊息提示規(guī)範 PAGEREF _Toc279418010 h 14 HYPERLINK l _Toc279418011 5.3Confirm提示訊息規(guī)範 PAGEREF _Toc279418011 h 15 HYPERLINK l _Toc279418012 6系統(tǒng)訊息UI呈現(xiàn)方式 PAGEREF _Toc279418012 h 15 HYPERLINK l _Toc279418013 6.1系統(tǒng)訊息 PAGEREF _Toc279418013 h 15 HYPERLINK l _Toc279418014 7多語系處理規(guī)範 PAGEREF _Toc279418014 h 1

16、5 HYPERLINK l _Toc279418015 8Log處理規(guī)範 PAGEREF _Toc279418015 h 15 HYPERLINK l _Toc279418016 9異常處理 PAGEREF _Toc279418016 h 16 HYPERLINK l _Toc279418017 異常部分應在BusinessRule層調(diào)用，拋出異常後，在BasePage捕捉到異常判斷，程式異常跳轉(zhuǎn)Error頁面，業(yè)務異常彈出提示框，用戶點選後前往異常之前的狀態(tài)。發(fā)生異常時系統(tǒng)呈現(xiàn)給user的錯誤畫面如下: PAGEREF _Toc279418017 h 17 HYPERLINK l _Toc2

17、79418018 異常處理判斷部分，由Master母版頁對AJAX請求處理。如下圖： PAGEREF _Toc279418018 h 17 HYPERLINK l _Toc279418019 異常處理判斷部分，由BasePage請求處理。如下圖： PAGEREF _Toc279418019 h 17 HYPERLINK l _Toc279418020 10多資料庫援助 PAGEREF _Toc279418020 h 18 HYPERLINK l _Toc279418021 系統(tǒng)只援助LOG，報表功能劃分出去作為單獨的資料庫。 PAGEREF _Toc279418021 h 18 HYPERLI

18、NK l _Toc279418022 每添加一臺資料庫，需添加一個NHibernate配置檔。同時需在NHibernateISessionFactory.cs如下圖一中添加一個靜態(tài)的二級緩存如下圖二，及資料庫篩選如圖三。 PAGEREF _Toc279418022 h 18 HYPERLINK l _Toc279418023 圖一 PAGEREF _Toc279418023 h 18 HYPERLINK l _Toc279418024 圖二 PAGEREF _Toc279418024 h 19 HYPERLINK l _Toc279418025 圖三 PAGEREF _Toc279418025

19、 h 19 HYPERLINK l _Toc279418026 現(xiàn)提供DataLog、ErrorLog、報表功能運用的NHibernate配置文檔，均從Web.config中設置。如下圖： PAGEREF _Toc279418026 h 19 HYPERLINK l _Toc279418027 11共通性規(guī)範 PAGEREF _Toc279418027 h 20 HYPERLINK l _Toc279418028 11.1英文字母存入資料庫時的處理方式 PAGEREF _Toc279418028 h 20 HYPERLINK l _Toc279418029 11.2Table間的Join方式

20、PAGEREF _Toc279418029 h 20 HYPERLINK l _Toc279418030 11.3Ajax運用時機 PAGEREF _Toc279418030 h 20 HYPERLINK l _Toc279418031 11.4刪除方式 PAGEREF _Toc279418031 h 20 HYPERLINK l _Toc279418032 11.5查詢方式 PAGEREF _Toc279418032 h 20 HYPERLINK l _Toc279418033 11.6Session說明與運用 PAGEREF _Toc279418033 h 20 HYPERLINK l _

21、Toc279418034 11.7欄位類型與長度 PAGEREF _Toc279418034 h 21 HYPERLINK l _Toc279418035 11.8Window.open開窗相關(guān)處置方式 PAGEREF _Toc279418035 h 21 HYPERLINK l _Toc279418036 11.8.1封鎖彈出窗口，父頁面能否要刷新: PAGEREF _Toc279418036 h 21 HYPERLINK l _Toc279418037 11.8.2父頁面處于編輯形狀，封鎖彈出窗口，能否要刷新？ PAGEREF _Toc279418037 h 21 HYPERLINK l

22、_Toc279418038 11.8.3子窗體未封鎖，父頁面封鎖了，怎樣處置？ PAGEREF _Toc279418038 h 21 HYPERLINK l _Toc279418039 11.9子頁簽刪除按鈕形狀控制 PAGEREF _Toc279418039 h 22 HYPERLINK l _Toc279418040 11.10英文稱號欄位檢核規(guī)那么 PAGEREF _Toc279418040 h 22 HYPERLINK l _Toc279418041 11.11查詢條件，區(qū)間欄位檢核規(guī)范 PAGEREF _Toc279418041 h 22 HYPERLINK l _Toc279418

23、042 12檔案上傳及命名規(guī)範 PAGEREF _Toc279418042 h 22 HYPERLINK l _Toc279418043 12.1Web.Config設定 PAGEREF _Toc279418043 h 22 HYPERLINK l _Toc279418044 12.2上傳路徑 PAGEREF _Toc279418044 h 22 HYPERLINK l _Toc279418045 12.3資料夾命名 PAGEREF _Toc279418045 h 22 HYPERLINK l _Toc279418046 12.4檔案命名 PAGEREF _Toc279418046 h 22

24、HYPERLINK l _Toc279418047 13DB Schema設計規(guī)範 PAGEREF _Toc279418047 h 22 HYPERLINK l _Toc279418048 14SD檔撰寫細則 PAGEREF _Toc279418048 h 23 HYPERLINK l _Toc279418049 15Iframe頁面需傳入?yún)?shù) PAGEREF _Toc279418049 h 23 HYPERLINK l _Toc279418050 傳入?yún)?shù)值SD文件中應注明。 PAGEREF _Toc279418050 h 23 HYPERLINK l _Toc279418051 16查詢區(qū)

25、查詢條件暫存 PAGEREF _Toc279418051 h 24 HYPERLINK l _Toc279418052 17查詢條件處置規(guī)范 PAGEREF _Toc279418052 h 24 HYPERLINK l _Toc279418053 18資料擁有者欄位處置方式闡明 PAGEREF _Toc279418053 h 24檔目的本文之目的在闡明系統(tǒng)整體共通性的相關(guān)設計規(guī)范，包含設計上的各種命名、編碼原那么、以及與運用者接口的規(guī)范化、操作接口的一致化等相關(guān)的設計規(guī)范等。為使系統(tǒng)的開發(fā)可以有規(guī)范及設計良好的產(chǎn)出，舉凡與系統(tǒng)整體性相關(guān)的各種主題，皆應制定良好的設計規(guī)范加以約束。命名原那么及規(guī)

26、范本章節(jié)闡明工程中一切與命名相關(guān)的各種原那么及規(guī)范。舉凡于工程中跟命名有關(guān)的主題，將一概收錄于本章節(jié)中進展闡明。檔檔案命名原那么工程中的檔命名原那么：檔案類型_系統(tǒng)模塊+模塊代碼+功能代碼+_+主Table.例如:URS_PUB0101_CodeListManagement.docSRS_PUB0101_CodeListManagement.docSDS_PUB0101_CodeListManagement.doc程序檔案命名原那么WebForm的aspx程序命名原那么為：依系統(tǒng)目錄文件3層定義，為系統(tǒng)模塊代碼 + 模塊代碼+ 功能代碼。系統(tǒng)模塊代碼以英文縮寫命名(共享模塊用COM)模塊代碼以

27、兩碼數(shù)字命名功能代碼Menu上的菜單單，以兩碼數(shù)字命名假設該功能存在子程序，那么后面追加-兩碼數(shù)字例如:Base0101.aspx - BaseCustomerSearchBase0101-01.aspx - BaseCustomerSearchDetail共享程序的程序代碼命名依該只程序的操作功能給予一個有意義的稱號進展命名。方法(Method)稱號命名原那么 (動作+描畫)假設方法執(zhí)行的操作屬于數(shù)據(jù)庫的存取時查詢操作SearchXXX新增操作InsertXXX修正操作ModifyXXX刪除操作DeleteXXX格式操作：FormatXXX (日期 / 金額千分位)數(shù)據(jù)轉(zhuǎn)換操作：Conver

28、tXXX (幣別轉(zhuǎn)換)獲得資料操作：GetXXX設定數(shù)據(jù)操作：SetXXX驗證操作：CheckXXX假設方法執(zhí)行的操作屬于業(yè)務邏輯性的判別、檢核、等其它處置時，請參考程序開發(fā)規(guī)范.NET字段變量及常數(shù)命名原那么于程序撰寫中針對變量或常數(shù)、屬性等進展命名時，請依以下原那么命名：遵照程序開發(fā)規(guī)范(.NET)的商定。依該控件所對應的DB字段稱號進展命名。工程自訂控件命名原那么(UserControl)依SD定義命名,要有含義 按鈕類型的控件命名(Xxx :目的稱號)按鈕稱號命名原那么(前綴前綴)闡明/范例查詢SearchbtnSearchXxx新增InsertbtnInsertXxx修正Modify

29、btnModifyXxx刪除DeletebtnDeleteXxx取消CancelbtnCancelXxx保管SavebtnSaveXxx提交SubmitbtnSubmitXxx清空ClearbtnClearXxx重置ResetbtnResetXxx編碼原那么本章節(jié)闡明工程中一切與編碼相關(guān)的各種原那么，舉凡于工程中跟編碼有關(guān)的主題，將一概收錄于本章節(jié)中進展闡明。接口文字編碼原那么(UTF-8)系統(tǒng)接口中的標題文字及按鈕稱號一概采用中文簡體顯示，并一致定義.NET的資源檔中。普遍性的按鈕編碼原那么為：控件ID,如查詢按鈕，對應的為btnSearch頁面級的編碼原那么為：系統(tǒng)模塊代碼 + 模塊代碼

30、+ 2碼流水編號。語系文件編碼規(guī)那么請參照。數(shù)據(jù)格式顯示及輸入規(guī)范代碼類型的資料假設需將代碼一并顯示:一致顯示格式為：代碼+ /+ 代碼稱號。例如CN/中國。斜線要運用半角日期數(shù)據(jù)系統(tǒng)中一切日期數(shù)據(jù)的輸入需提供月歷盒，且輸入的日期格式一致為：YYYY-MM-DD，例如：2021-02-22。系統(tǒng)中一切日期數(shù)據(jù)的顯示一致以-符號加以區(qū)隔，例如：2021-02-22。年月顯示格式Y(jié)YYY-MM，例如2021-03 。需提供user直接登打日期的功能,分三種情況處置:假設輸入值為四碼: 0401會自動轉(zhuǎn)成2021(當前年度)-04-01 假設輸入值為八碼: 20210401會自動轉(zhuǎn)成2021-04-

31、01假設輸入值為十碼: 2021-04-01,完好格式,不需轉(zhuǎn)換時間數(shù)據(jù)系統(tǒng)中假設有需含時間數(shù)據(jù)的,輸入格式一致為：HH:MM:SS，例如：18:15:33。假設與日期一并顯示，那么去除AM/PM/上午/下午等字眼，一致顯示為：YYYY-MM-DD HH:MM:SS，例如：2021-02-22 18:15:33。系統(tǒng)中一切時間數(shù)據(jù)的顯示一致以:符號加以區(qū)隔，例如：18:15:33。數(shù)字數(shù)據(jù)一切數(shù)字類型的數(shù)據(jù)一概居右顯示。輸入形狀，數(shù)字類型居左，金額類型居右。清單金額類型，需顯示千分位。百分比(%)類型，假設為計算得出，需按照存入DB時需100，由DB讀取時再100。存入DB時，需留意畫面單位與

32、DB中單位能否一致，假設不一致，需求進展一致處置，同樣取數(shù)據(jù)時也需留意。金額字段有關(guān)金額部份，能否顯示小數(shù)點，那么依各SRS 文件規(guī)定。有關(guān)幣別轉(zhuǎn)換部份，以幣別功能所設定的進位位數(shù)及進位方式來處置。有關(guān)幣別會進展匯率換算金額,小數(shù)點會開到小數(shù)下七位.其它非匯率換算金額,以各SRS文件規(guī)定進展設定. 后續(xù)與幣別進展換算時,根據(jù)幣別功能所設定的計算到小數(shù)幾位來控制對應的小數(shù)字數(shù).進位方式,根據(jù)幣別功能設定進展進位.針對金額的顯示方式根據(jù)SA的闡明進展顯示.下拉選單系統(tǒng)中的下拉選單， 如沒有特殊闡明預設選中第一項。下拉選單中第一項以群組區(qū)塊不同而區(qū)分以下兩種方式查詢區(qū)第一筆為全部選項，value值為

33、00。維護區(qū)必輸字段第一筆為請選擇選項，value值為00。非必輸字段元第一筆為選項，value值為空白?？爝x單在查詢字段輸入代碼，當onblur時，系統(tǒng)自動查詢代碼后，帶回其對應的稱號在所要顯示的位置。由運用者自行點選彈跳窗口進展查詢。查詢字段不允許輸入，運用者只能點選彈跳窗口進展查詢。如SA另有特別要求，請參照SA特別方式處置。可輸入方案，失焦點時處置方式：分開焦點時，那么把字段內(nèi)的值進展查詢。查詢結(jié)果查詢結(jié)果有一筆時，那么帶回查詢結(jié)果的值。查詢結(jié)果有多筆時，那么不彈跳窗口，也不帶回值。查詢結(jié)果為0筆時，那么彈跳窗口。默許值問題：頁面字段的默許值由SA進展提供，假設有檢核區(qū)間，那么默許值取

34、區(qū)間內(nèi)最小值。非輸入型默許值假設SA沒有闡明那么默許第一個選項。數(shù)據(jù)檢核驗證規(guī)范本章節(jié)闡明于處置檢核驗證時的相關(guān)規(guī)范，舉凡與檢核驗證的相關(guān)主題，包含Client及Server端的檢核驗證處置，都一概收錄于本章節(jié)進展闡明。Client端資料檢核驗證方式：運用JavaScript方法，套用工程架構(gòu)既有function一致處置，不可單獨在單支程序單獨撰寫。包含分開交點驗證與頁面提交驗證。Server端資料檢核調(diào)用Server端驗證機制的ServerCheck方法，假設未經(jīng)過檢核，那么接受驗證機制回傳的錯誤信息并提示。訊息提示規(guī)范系統(tǒng)提供兩種檢核信息alert方式與confirm方式。訊息為中文時，采

35、用全角字符；為英文時，采用半角字元。檢核驗證訊息JavaScript端的檢核信息規(guī)范請參考4中的闡明定義信息，SD文件中不再對此部分進展闡明，假設有特殊情形會在該字段元對應的來源數(shù)據(jù)表闡明。Server端的特殊檢核信息定義會在按鈕提交時對應的驗證處置部分進展闡明。必輸入字段稱號前加紅色星號“*不可編輯字段，需在字段控件上將底色設置為淡灰色。User輸入數(shù)據(jù)Onblur時，需實時進展前臺驗證，并將異常數(shù)據(jù)之輸入底色變卦為紅色以示提示。點選提交鈕時針對一切與檢核驗證相關(guān)的訊息提示，呈現(xiàn)音訊正文時，請一次將一切的檢核失敗提示訊息以清一方式alert出。點選保管鈕時，僅針對有登打之字段進展數(shù)據(jù)正確性驗

36、證，不需針對整個窗體做數(shù)據(jù)完好性驗證。驗證提示訊息清單被User點選確定鈕后，光標需Focus到第一個檢核失敗控件上，且Error之字段輸入文字顏色需顯示為深藍色。系統(tǒng)中進展查詢操作時，假設User未輸入查詢準那么就點選查詢,那么以SA設置之默許值為條件進展查詢。普通訊息提示規(guī)范針對操作功能后系統(tǒng)依 REF _Ref257015491 w h * MERGEFORMAT 2.2 REF _Ref257015532 h * MERGEFORMAT 普通提示訊息編碼原那么中定義的信息回饋告知運用者，如【儲存勝利！】Confirm提示訊息規(guī)范刪除操作時，一致提示確定要刪除嗎？確定取消。取消操作時編輯

37、形狀提示:請確認能否取消編輯？確定取消。查看形狀無提示，直接封鎖頁面。編輯形狀,點X提示能否封鎖的闡明,且需調(diào)用固定的方法(Rebo提供的)系統(tǒng)訊息UI呈現(xiàn)方式系統(tǒng)訊息UI呈現(xiàn)方式，不會運用屏蔽(mask)方式。詳細的呈現(xiàn)方式會以Alert,Confirm呈現(xiàn)。系統(tǒng)訊息運用傳統(tǒng)alert方式顯示訊息。如新增，刪除等操作給出的儲存勝利、失敗等。多語系處置規(guī)范請參考文檔,主要闡明Resources運用方式。Log處置規(guī)范數(shù)據(jù)庫中每支Table對應其一支TableLog。程序每支功能可由客戶設置能否開啟記錄DataLog。DataLog功用模塊需傳入異動數(shù)據(jù)集合與功能稱號，由功用模塊解析數(shù)據(jù)拼接成S

38、QL語句進展執(zhí)行。注：數(shù)據(jù)刪除操作不記錄DataLog。DataLog應在BusinessRule層調(diào)用，調(diào)用寫法如下：異常處置異常分為兩種：程序異常，業(yè)務異常。ERPExceptionManager是工程中一切自訂異常的父類，程序中自訂異常需承繼該父類。出現(xiàn)異常，由功用模塊自動把異常信息存入數(shù)據(jù)庫中，異常信息分三種客戶角色分別提示、存儲三種不同信息，分：系統(tǒng)運用者User，系統(tǒng)管理員Administrator，系統(tǒng)維護者Programer，提示信息內(nèi)容由SA定義，并由SA定義Resources編碼規(guī)范。注：提示信息Resources編碼規(guī)范未提供。程序估計會出現(xiàn)異常地方，或與數(shù)據(jù)庫交互部分都

39、應由trycatch包裹，catch中應throw出自訂的程序異常()，并把抓取的Exception作為參數(shù)傳入自訂日常。調(diào)用寫法如下：業(yè)務異常由SA定義，每種業(yè)務異常是單獨存在的一個Class，業(yè)務異常應是邏輯判別，非trycatch包裹，應根據(jù)SA的闡明，判別后直接throw出規(guī)定的異常類型。調(diào)用寫法如下：異常部分應在BusinessRule層調(diào)用，拋出異常后，在BasePage捕捉到異常判別，程序異常跳轉(zhuǎn)Error頁面，業(yè)務異常彈出提示框，用戶點選后前往異常之前的形狀。發(fā)生異常時系統(tǒng)呈現(xiàn)給user的錯誤畫面如下: 異常處置判別部分，由Master母版頁對AJAX懇求處置。如以下圖：異常處

40、置判別部分，由BasePage懇求處置。如以下圖：多數(shù)據(jù)庫支持系統(tǒng)只支持LOG，報表功能劃分出去作為單獨的數(shù)據(jù)庫。每添加一臺數(shù)據(jù)庫，需添加一個NHibernate配置文件。同時需在NHibernateISessionFactory.cs如以下圖一中添加一個靜態(tài)的二級緩存如以下圖二，及數(shù)據(jù)庫挑選如圖三。圖一圖二圖三現(xiàn)提供DataLog、ErrorLog、報表功能運用的NHibernate配置文文件，均從Web.config中設置。如以下圖：共通性規(guī)范英文字母存入數(shù)據(jù)庫時的處置方式數(shù)據(jù)庫內(nèi)英文字母是區(qū)分大小寫的，目前本系統(tǒng)的處置方式為假設代碼、編號為英文,一概轉(zhuǎn)大寫；假設ID為英文，那么不做轉(zhuǎn)大寫

41、動作。Table間的Join方式SD Spec中假設沒有闡明Table間的Join方式，那么通一按照Inner Join進展處置。Ajax運用時機系統(tǒng)在設計開發(fā)時，應留意非必要刷新數(shù)據(jù)庫時因需運用Ajax技術(shù)，以獲得較好的用戶體驗效果刪除方式本系統(tǒng)中的刪除方式有兩種：真刪除與假刪除，請依SD檔進展。假設為假刪除，只需更新固定形狀列位DataSt為D即可。假設真刪除，直接刪除改筆數(shù)據(jù)。查詢方式如未有特殊要求，查詢、關(guān)聯(lián)條件需參與查詢或關(guān)聯(lián)表的DataSt=N。針對DataSet=N 運用情況如下:查詢時,DataSet=N，Join 時，DataSet 不用= N因在join時，因被假刪除的資料

42、，亦要被join后顯示出歷史的值。故不需下DataSet=N。Session闡明與運用系統(tǒng)中的登入者信息一致放在UserInfo這個Class中，其屬性闡明請參考 文件關(guān)于異常處置的闡明。系統(tǒng)在新增與修正時運用Session規(guī)那么闡明新增時，需求增入下面字段元:DataSt = NDataOwner = UserInfo.DataOwnerIdCreateOu = UserInfo.DataOwnerOuCreateUser = UserInfo.UserIDCreateDate = getdate()修正時只需異動下面兩個字段:ModifyUser = UserInfo.UserIDModi

43、fyDate = getdate()字段類型與長度程序開發(fā)中針對字段元部分，其長度與類型皆以DB Schema定義為根據(jù)。此處的長度是字段元的最大長度，畫面的顯示長度以能完好顯示字段元內(nèi)容為規(guī)范，但也需兼顧畫面美觀。另外，特殊部分會在SD檔中另外闡明。Window.open開窗相關(guān)處置方式封鎖彈出窗口，父頁面能否要刷新:假設彈出窗口的回傳值是以JS回傳到父頁面，那么不用刷新父頁面(ex:快選單窗口)。假設彈出窗口的用途為維護單據(jù)內(nèi)容主檔，那么要刷新父頁面。假設彈出窗口的用途為維護單據(jù)內(nèi)容子檔，那么僅要刷新父頁面中的子檔部分。父頁面處于編輯形狀，封鎖彈出窗口，能否要刷新？假設彈出窗口的回傳值是以

44、JS回傳到父頁面，那么不用刷新父頁面(ex:快選單窗口)。假設彈出窗口的用途為維護單據(jù)內(nèi)容子檔，那么僅要刷新父頁面中的子檔部分。子窗體未封鎖，父頁面封鎖了，怎樣處置？父頁面封鎖時不進展連動封鎖子窗口。父頁面已封鎖那么子窗口的回傳值會有JS錯誤(找不到父頁面物件)，此時需在子窗口的回傳時進展判別(try.catch)，不可產(chǎn)生JS錯誤。子頁簽刪除按鈕形狀控制新增主頁后，子頁假設無數(shù)據(jù)時，刪除請顯示為disable 。子頁巳新增資料后，在查看時，刪除才顯示為 enable。英文稱號欄位檢核規(guī)那么針對功能頁面中英文稱號欄位，提交時，檢核方式為：除中文外其它都可輸入。查詢條件，區(qū)間欄位檢核規(guī)范日期起日

45、日期迄日: 需檢核迄日=起日天數(shù)起日天數(shù)迄日：需檢核迄日=起日假設有其它區(qū)間欄位，需做同樣的邏輯檢核。檔案上傳及命名規(guī)范系統(tǒng)中圖文件與附件的上傳方式運用http，以網(wǎng)頁的方式閱讀上傳，請一致以以下規(guī)范進展Web.Config設定在此文件中需設定文件上傳途徑及上傳文件大小限制上傳途徑上傳途徑需求讀取Web.Config中的設定參數(shù)獲得Server端的對應途徑資料夾命名按照模塊建立對應數(shù)據(jù)夾，上傳的圖檔及附近均放置此資料夾下。 檔案命名命名規(guī)那么以userID+日期時間(yyyy-MM-dd HH:mm:ss)，例如GF-10012021-05-25 10:20:30DB Schema設計規(guī)范 規(guī)范原那么: 如附件- 20210315-IT暫時會議-DB Schema