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

1、系統(tǒng)設(shè)計(jì)規(guī)範(fàn)V1.0一般提示示訊息編碼原原則中定義的的信息回饋告告知使用者，如如【儲(chǔ)存成成功！】Confirmm提示訊息規(guī)規(guī)范刪除操作時(shí)，統(tǒng)統(tǒng)一提示確定要?jiǎng)h除嗎嗎？確定取消消。取消操作時(shí)編輯狀態(tài)提示:請(qǐng)確認(rèn)是否取取消編輯？確定取消消。查看狀態(tài)無(wú)提示示，直接關(guān)閉閉頁(yè)面。編輯狀態(tài),點(diǎn)XX提示是否關(guān)關(guān)閉的說(shuō)明,且需調(diào)用固固定的方法(Rebo提提供的)系統(tǒng)訊息UI呈呈現(xiàn)模式系統(tǒng)訊息UI呈呈現(xiàn)模式，不不會(huì)使用屏蔽蔽(maskk)方式。具具體的呈現(xiàn)模模式會(huì)以Allert,CConfirrm呈現(xiàn)。系統(tǒng)訊息使用傳統(tǒng)aleert方式顯顯示訊息。如如新增，刪除除等操作給出出的儲(chǔ)存成功功、失敗等。多語(yǔ)系處理規(guī)范范請(qǐng)

2、參考文檔,主要說(shuō)明Reesourcces使用方方式。Log處理規(guī)范范數(shù)據(jù)庫(kù)中每支TTable對(duì)對(duì)應(yīng)其一支TTableLLog。程序每支功能可可由客戶(hù)設(shè)置置是否開(kāi)啟記記錄DataaLog。DataLogg功用模塊需需傳入異動(dòng)數(shù)數(shù)據(jù)集合與功功能名稱(chēng)，由由功用模塊解解析數(shù)據(jù)拼接接成SQL語(yǔ)句進(jìn)進(jìn)行執(zhí)行。注注：數(shù)據(jù)刪除除操作不記錄錄DataLLog。DataLogg應(yīng)在BusiinessRRule層調(diào)調(diào)用，調(diào)用寫(xiě)寫(xiě)法如下：異常處理異常分為兩種：程序異常，業(yè)業(yè)務(wù)異常。EERPExcceptioonManaager是工工程中所有自自訂異常的父父類(lèi)，程序中中自訂異常需需繼承該父類(lèi)類(lèi)。出現(xiàn)異常，由功功用模塊自

3、動(dòng)動(dòng)把異常信息息存入數(shù)據(jù)庫(kù)庫(kù)中，異常信信息分三種客客戶(hù)角色分別別提示、存儲(chǔ)儲(chǔ)三種不同信信息，分：系系統(tǒng)使用者（User），系統(tǒng)管理員（Administrator），系統(tǒng)維護(hù)者（Programer），提示信息內(nèi)容由SA定義，并由SA定義Resources編碼規(guī)范。注：提示信息Resources編碼規(guī)范未提供。程序預(yù)計(jì)會(huì)出現(xiàn)現(xiàn)異常地方，或或與數(shù)據(jù)庫(kù)交交互部分都應(yīng)應(yīng)由trycatchh包裹，cattch中應(yīng)throow出自訂的的程序異常()，并把抓抓取的Excceptioon作為參數(shù)數(shù)傳入自訂日日常。調(diào)用寫(xiě)寫(xiě)法如下：業(yè)務(wù)異常由SAA定義，每種種業(yè)務(wù)異常是是單獨(dú)存在的的一個(gè)Claass，業(yè)務(wù)務(wù)異常應(yīng)是

4、邏邏輯判斷，非非tryccatch包裹，應(yīng)根根據(jù)SA的說(shuō)明，判判斷后直接tthrow出出規(guī)定的異常常類(lèi)型。調(diào)用用寫(xiě)法如下：異常部分應(yīng)在BBusineessRulle層調(diào)用，拋拋出異常后，在在BasePPage捕捉捉到異常判斷斷，程序異常常跳轉(zhuǎn)Errror頁(yè)面，業(yè)業(yè)務(wù)異常彈出出提示框，用用戶(hù)點(diǎn)選后返返回異常之前前的狀態(tài)。發(fā)發(fā)生異常時(shí)系系統(tǒng)呈現(xiàn)給uuser的錯(cuò)錯(cuò)誤畫(huà)面如下下: 異常處理判斷部部分，由Maaster母母版頁(yè)對(duì)AJJAX請(qǐng)求處處理。如下圖圖：異常處理判斷部部分，由BaasePagge請(qǐng)求處理理。如下圖：多數(shù)據(jù)庫(kù)支持系統(tǒng)只支持LOOG，報(bào)表功功能劃分出去去作為單獨(dú)的的數(shù)據(jù)庫(kù)。每添加一臺(tái)數(shù)

5、據(jù)據(jù)庫(kù)，需添加加一個(gè)NHiibernaate配置文文件。同時(shí)需需在NHibbernatteISesssionFFactorry.cs（如下圖圖一）中添加加一個(gè)靜態(tài)的的二級(jí)緩存（如如下圖二），及及數(shù)據(jù)庫(kù)篩選選（如圖三）。圖一圖二圖三現(xiàn)提供DataaLog、ErrorrLog、報(bào)報(bào)表功能使用用的NHibbernatte配置文文文件，均從WWeb.coonfig中中設(shè)置。如下下圖：共通性規(guī)范英文字母存入數(shù)數(shù)據(jù)庫(kù)時(shí)的處處理方式數(shù)據(jù)庫(kù)內(nèi)英文字字母是區(qū)分大大小寫(xiě)的，目目前本系統(tǒng)的的處理方式為為若代碼、編編號(hào)為英文,一律轉(zhuǎn)大寫(xiě)寫(xiě)；若ID為英文，則則不做轉(zhuǎn)大寫(xiě)寫(xiě)動(dòng)作。Table間的的Join方式式SD Spe

6、cc中若沒(méi)有說(shuō)說(shuō)明Tablle間的Joinn方式，則通通一按照Innner JJoin進(jìn)行行處理。Ajax使用時(shí)時(shí)機(jī)系統(tǒng)在設(shè)計(jì)開(kāi)發(fā)發(fā)時(shí)，應(yīng)注意意非必要刷新新數(shù)據(jù)庫(kù)時(shí)因因需使用Ajjax技術(shù)，以以獲得較好的的用戶(hù)體驗(yàn)效效果刪除方式本系統(tǒng)中的刪除除方式有兩種種：真刪除與與假刪除，請(qǐng)請(qǐng)依SD檔進(jìn)行。若為假刪除，只只需更新固定定狀態(tài)列位DDataStt為D即可。若真刪除，直接接刪除改筆數(shù)數(shù)據(jù)。查詢(xún)方式如未有特殊要求求，查詢(xún)、關(guān)關(guān)聯(lián)條件需加加入查詢(xún)或關(guān)關(guān)聯(lián)表的DaataSt=N。針對(duì)DataSSet=N 使用情況如如下:查詢(xún)時(shí),DattaSet=N，Join 時(shí)，DataaSet 不不用= N因在”jo

7、inn”時(shí)，因被假假刪除的資料料，亦要被jjoin后顯顯示出歷史的的值。故不需需下DataaSet=NN。Sessionn說(shuō)明與使用用系統(tǒng)中的登入者者信息統(tǒng)一放放在UserrInfo這這個(gè)Classs中，其屬屬性說(shuō)明請(qǐng)參參考 文文件關(guān)于異常常處理的說(shuō)明明。系統(tǒng)在新增與修修改時(shí)使用SSessioon規(guī)則說(shuō)明明新增時(shí)，需要增增入下面字段段元:DataSt = NDataOwnner = UserIInfo.DDataOwwnerIddCreateOOu = UUserInnfo.DaataOwnnerOuCreateUUser = UserrInfo.UserIIDCreateDDate = ge

8、tddate()修改時(shí)只需異動(dòng)動(dòng)下面兩個(gè)字字段:ModifyUUser = UserrInfo.UserIIDModifyDDate = getddate()字段類(lèi)型與長(zhǎng)度度程序開(kāi)發(fā)中針對(duì)對(duì)字段元部分分，其長(zhǎng)度與與類(lèi)型皆以DDB Schhema定義義為依據(jù)。此此處的長(zhǎng)度是是字段元的最最大長(zhǎng)度，畫(huà)畫(huà)面的顯示長(zhǎng)長(zhǎng)度以能完整整顯示字段元元內(nèi)容為標(biāo)準(zhǔn)準(zhǔn)，但也需兼兼顧畫(huà)面美觀觀。另外，特殊部分分會(huì)在SD檔中另外外說(shuō)明。Window.open開(kāi)窗窗相關(guān)處理方方式關(guān)閉彈出窗口，父父頁(yè)面是否要要刷新:若彈出窗口的回回傳值是以JJS回傳到父父頁(yè)面，則不不用刷新父頁(yè)頁(yè)面(ex:快選單窗口口)。若彈出窗口的用用途為

9、維護(hù)單單據(jù)內(nèi)容主檔檔，則要刷新新父頁(yè)面。若彈出窗口的用用途為維護(hù)單單據(jù)內(nèi)容子檔檔，則僅要刷刷新父頁(yè)面中中的子檔部分分。父頁(yè)面處于編輯輯狀態(tài)，關(guān)閉閉彈出窗口，是是否要刷新？若彈出窗口的回回傳值是以JJS回傳到父父頁(yè)面，則不不用刷新父頁(yè)頁(yè)面(ex:快選單窗口口)。若彈出窗口的用用途為維護(hù)單單據(jù)內(nèi)容子檔檔，則僅要刷刷新父頁(yè)面中中的子檔部分分。子窗體未關(guān)閉，父父頁(yè)面關(guān)閉了了，怎么處理理？父頁(yè)面關(guān)閉時(shí)不不進(jìn)行連動(dòng)關(guān)關(guān)閉子窗口。父頁(yè)面已關(guān)閉則則子窗口的回回傳值會(huì)有JJS錯(cuò)誤(找不到父頁(yè)頁(yè)面物件)，此時(shí)需在在子窗口的回回傳時(shí)進(jìn)行判判斷(tryy.cattch)，不不可產(chǎn)生JSS錯(cuò)誤。子頁(yè)簽刪除按鈕鈕狀態(tài)控制

10、新增主頁(yè)后，子子頁(yè)若無(wú)數(shù)據(jù)據(jù)時(shí)，刪除請(qǐng)請(qǐng)顯示為diisablee 。子頁(yè)巳巳新增資料后后，在查看時(shí)時(shí)，刪除才顯顯示為 ennable。英文名稱(chēng)欄位檢檢核規(guī)則針對(duì)功能頁(yè)面中中英文名稱(chēng)欄欄位，提交時(shí)時(shí)，檢核方式式為：除中文文外其它都可可輸入。查詢(xún)條件，區(qū)間間欄位檢核規(guī)規(guī)范日期起日日期期迄日: 需檢核迄迄日=起日天數(shù)起日天數(shù)數(shù)迄日：需檢檢核迄日=起日若有其它區(qū)間欄欄位，需做同同樣的邏輯檢檢核。檔案上傳及命名名規(guī)范系統(tǒng)中圖文件與與附件的上傳傳方式使用hhttp，以以網(wǎng)頁(yè)的方式式瀏覽上傳，請(qǐng)請(qǐng)統(tǒng)一以下列列規(guī)范進(jìn)行Web.Connfig設(shè)定定在此文件中需設(shè)設(shè)定文件上傳傳路徑及上傳傳文件大小限限制上傳路徑上

11、傳路徑需要讀讀取Web.Confiig中的設(shè)定定參數(shù)取得SServerr端的對(duì)應(yīng)路路徑資料夾命名依照模塊建立對(duì)對(duì)應(yīng)數(shù)據(jù)夾，上上傳的圖檔及及附近均放置置此資料夾下下。 檔案命名命名規(guī)則以u(píng)sserID+日期時(shí)間(yyyyy-MMM-dd HH:mmm:ss)，例例如GF-1100120010-055-25 110:20:30DB Scheema設(shè)計(jì)規(guī)規(guī)范 規(guī)范原則: 如如附件- 2201003315-ITT臨時(shí)會(huì)議-DDB Schhema及重重要字段討論論.docDB Scheema范本: 如附件-DBB Sechhma規(guī)格定定義.xlss是否啟用字段啟用/不啟用：依功能需求求而定，字段段元設(shè)計(jì)

12、方式式如下字段名稱(chēng)形態(tài)是否為Nulll字段說(shuō)明defaulttXXXEnFgg，例如：CoodeLisstEnFggChar(1)不允許Nulll0：不啟用1：?jiǎn)⒂?DB 字段開(kāi)立立細(xì)則:匯率字段一律開(kāi)開(kāi)成4位小數(shù)格式式所有不允許為NNull的字字段，除主外外鍵之外，其其它字段一律律需設(shè)定默認(rèn)認(rèn)值除建立數(shù)據(jù)日日期最最后修改日期期外，其它它日期字段固固定為允許nnull金額、數(shù)量類(lèi)型型之字段，若若不允許nuull時(shí),需預(yù)設(shè)0調(diào)用共享組件相相關(guān)功能DBB Scheema開(kāi)立規(guī)規(guī)范:所處理功能，若若會(huì)調(diào)用共享享組件，在進(jìn)進(jìn)行DB SSchemaa開(kāi)立時(shí)，需需要在所開(kāi)立立Tablee的主鍵欄位位描述中

13、，加加入其關(guān)聯(lián)共共享組件對(duì)應(yīng)應(yīng)Tablee說(shuō)明。SD檔撰寫(xiě)細(xì)則則對(duì)于畫(huà)面需要使使用Ajaxx方式實(shí)現(xiàn)的的部份，SDD檔應(yīng)特別說(shuō)說(shuō)明畫(huà)面進(jìn)行的刪除除方式，檔需需明確是真刪刪除還是假刪刪除。Iframe頁(yè)頁(yè)面需傳入?yún)?shù)傳入?yún)?shù)值SDD文件中應(yīng)注注明。參數(shù)名稱(chēng)參數(shù)值WorkStN：新增S：提交D：刪除E：編輯V：查看Sq資料主鍵查詢(xún)區(qū)查詢(xún)條件件暫存特殊情況：查詢(xún)?cè)冺?yè)面存在維維護(hù)開(kāi)窗頁(yè)簽簽，且開(kāi)窗方方式是winndows.open方方式，則此頁(yè)頁(yè)面查詢(xún)條件件暫存需用SSessioon頁(yè)面名名稱(chēng)編號(hào)，例如：SeessionnPuo00101。普通情況：?jiǎn)渭兗兊牟樵?xún)頁(yè)面面以ViewwStatee清單控件

14、件ID+WoorkSt暫存。例如如：ViewwStateegvCCurrenncyLisstWorkkSt。查詢(xún)條件處理規(guī)規(guī)范共享選單頁(yè)面，在在共享選單查查詢(xún)部份，查查詢(xún)條件對(duì)幾幾個(gè)模糊查詢(xún)?cè)兊臋谶M(jìn)以”oor”的方式式進(jìn)行查詢(xún)。針對(duì)非共享選單單的功能，若若非SA特殊要求求，統(tǒng)一以“and”的方式進(jìn)行行查詢(xún)。資料擁有者欄位位處理方式說(shuō)說(shuō)明資料擁有者欄位位，只會(huì)出現(xiàn)現(xiàn)在主頁(yè)面中中，對(duì)應(yīng)子頁(yè)頁(yè)簽不會(huì)顯示示此欄位。子頁(yè)簽存檔時(shí)資資料所屬人員員及單位對(duì)應(yīng)應(yīng)的值為主頁(yè)頁(yè)面所選擇的的資料擁有者者欄位的值。上傳程序處理及及調(diào)用規(guī)范規(guī)范適用范圍: 所有調(diào)用用檔案檢視uusercoontroll頁(yè)面(包括多檔與與

15、單檔)頁(yè)面需處理方式式: 增加對(duì)檔檔案檢視UCC的屬性傳入入: 當(dāng)頁(yè)面處于檢視視狀態(tài)時(shí),XXXUCC. WorrkSt = V當(dāng)頁(yè)面處于檢視視新增狀態(tài)時(shí)時(shí),XXXXUC. WWorkStt =NN當(dāng)頁(yè)面處于編輯輯狀態(tài)時(shí),XXXUUC. WoorkSt =E注意事項(xiàng):每次頁(yè)面刷新,需注意要保保證UC有正確傳傳入WorkkSt屬性值值特殊頁(yè)面需求需需注意WorrkSt之傳傳值,.例如:個(gè)人客戶(hù)管理維維護(hù)畫(huà)面,新增時(shí)不允允許編輯檔案案上傳,則此時(shí)不WoorkSt要要傳入V檢視欄位顯示規(guī)規(guī)范對(duì)于Lablee 和 Lablle對(duì)應(yīng)的值值，顯示時(shí)按按Lablee + 空格格 + Laable對(duì)應(yīng)應(yīng)的值(對(duì)應(yīng)的值以以靠左顯示)如：訂單單號(hào)+空格格+ORD10008000001 - 訂單單單號(hào) ORD10008000001由系統(tǒng)自行異動(dòng)動(dòng)或存檔功能能，系統(tǒng)欄位位存值規(guī)范各功能由系統(tǒng)進(jìn)進(jìn)行資料異動(dòng)動(dòng)或存檔的作作業(yè)時(shí)，對(duì)於ModiffyUserr或是 CreeateUsser 等所所要註記的使使用者統(tǒng)一使用如下:ADM_EmpplyeeGUID: 000000000-00000-0000