MES開發(fā)與應(yīng)用 課件 3.7 工業(yè)管理軟件開發(fā)基礎(chǔ)-配置項(xiàng)的開發(fā)與配置

3.7配置項(xiàng)的開發(fā)與配置深圳市信息職業(yè)技術(shù)學(xué)院目

錄配置項(xiàng)介紹01配置項(xiàng)功能的開發(fā)示例02列表獲取配置項(xiàng)配置值的開發(fā)示例03表單獲取配置項(xiàng)配置值的開發(fā)示例04知識(shí)回顧附件開發(fā)示例；附件開發(fā)注意事項(xiàng)；上傳按鈕框架實(shí)現(xiàn)介紹；下載按鈕框架實(shí)現(xiàn)介紹。學(xué)習(xí)目標(biāo)通過本節(jié)學(xué)習(xí)可以：掌握配置項(xiàng)功能的開發(fā)實(shí)現(xiàn)；掌握列表編輯模式添加命令獲取配置項(xiàng)配置值的開發(fā)實(shí)現(xiàn)；掌握表單編輯模式添加命令獲取配置項(xiàng)配置值的開發(fā)實(shí)現(xiàn)；了解配置項(xiàng)的實(shí)現(xiàn)方式與界面配置。01配置項(xiàng)介紹配置項(xiàng)介紹配置項(xiàng)介紹配置項(xiàng)的定義：配置項(xiàng)是指可被修改的設(shè)置或參數(shù)，用于配置系統(tǒng)的行為和特性。它們?cè)试S用戶根據(jù)其特定需求進(jìn)行定制，以便系統(tǒng)能夠適應(yīng)不同的環(huán)境和使用情況。SMOM的配置項(xiàng)是在具體的功能菜單中，開發(fā)一個(gè)配置項(xiàng)按鈕，配置項(xiàng)按鈕的界面是框架實(shí)現(xiàn)的，界面的數(shù)據(jù)配置部分需要開發(fā)實(shí)現(xiàn)；配置項(xiàng)介紹配置項(xiàng)介紹平臺(tái)的配置項(xiàng)包含普通屬性的配置和引用屬性的配置，普通屬性的配置是在界面中配置固定值，引用屬性是根據(jù)編碼規(guī)則配置的規(guī)則來生成（用于單號(hào)的生成）。引用屬性的配置項(xiàng)配置的值依賴于“編碼規(guī)則”功能的數(shù)據(jù)維護(hù)。配置項(xiàng)實(shí)現(xiàn)介紹配置項(xiàng)實(shí)現(xiàn)介紹一、普通屬性配置項(xiàng)的實(shí)現(xiàn)步驟1、在服務(wù)端工程定義一個(gè)配置實(shí)體類，命名以ConfigValue結(jié)尾，繼承ConfigValue，標(biāo)記特性[RootEntity,Serializable]，使用代碼段添加普通屬性，重寫Display方法，將值顯示出來；2、在客戶端工程添加配置界面類，繼承WebViewConfig<配置實(shí)體類>，重寫配置明細(xì)視圖方法ConfigDetailsView，配置視圖屬性；3、在服務(wù)端工程定義一個(gè)規(guī)則生成說明類，命名取配置實(shí)體類Value之前部分，

繼承ModuleConfig<配置實(shí)體類>，重寫獲取默認(rèn)值屬性DefaultValue，標(biāo)記特性顯示名稱DisplayName和描述Description；4、在實(shí)體中標(biāo)記特性[EntityWithConfig(typeof(規(guī)則生成說明類))]；5、運(yùn)行項(xiàng)目，在具體功能中可以看到一個(gè)配置項(xiàng)按鈕，點(diǎn)擊配置項(xiàng)可以進(jìn)行值的配置；6、獲取配置項(xiàng)配置值的實(shí)現(xiàn)：varconfig=ConfigService.GetConfig(new規(guī)則生成說明類(),typeof(使用配置項(xiàng)的實(shí)體類));通用config.屬性名可以獲取到界面配置的值，要注意判空。配置項(xiàng)實(shí)現(xiàn)介紹配置項(xiàng)實(shí)現(xiàn)介紹二、自定義引用屬性配置項(xiàng)的實(shí)現(xiàn)步驟1、在服務(wù)端工程定義一個(gè)配置實(shí)體類，命名以ConfigValue結(jié)尾，繼承ConfigValue，標(biāo)記特性[RootEntity,Serializable]，使用代碼段添加一般外鍵引用屬性，引用屬性關(guān)聯(lián)的實(shí)體類為編碼規(guī)則的實(shí)體類NumberRule，重寫Display方法，將值顯示出來；2、在客戶端工程添加配置界面類，繼承WebViewConfig<配置實(shí)體類>，重寫配置明細(xì)視圖方法ConfigDetailsView，配置視圖屬性；3、在服務(wù)端工程定義一個(gè)規(guī)則生成說明類，命名取配置實(shí)體類Value之前部分，

繼承ModuleConfig<配置實(shí)體類>，重寫獲取默認(rèn)值屬性DefaultValue，標(biāo)記特性顯示名稱DisplayName和描述Description；4、在實(shí)體中標(biāo)記特性[EntityWithConfig(typeof(規(guī)則生成說明類))]；5、運(yùn)行項(xiàng)目，在具體功能中可以看到一個(gè)配置項(xiàng)按鈕，在進(jìn)行配置項(xiàng)值的配置前，要先維護(hù)編碼規(guī)則基礎(chǔ)數(shù)據(jù)；配置項(xiàng)實(shí)現(xiàn)介紹配置項(xiàng)實(shí)現(xiàn)介紹二、自定義引用屬性配置項(xiàng)的實(shí)現(xiàn)步驟6、獲取配置項(xiàng)配置值的實(shí)現(xiàn)方法：varconfig=ConfigService.GetConfig(new

規(guī)則生成說明類(),typeof(實(shí)體類));if(config==null||config.引用實(shí)體屬性==null) throw

newValidationException("未找到編碼生成規(guī)則,請(qǐng)檢查規(guī)則配置".L10N());return

RT.Service.Resolve<NumberRuleController>().GenerateSegment(config.引用屬性Id值,1).FirstOrDefault();配置項(xiàng)實(shí)現(xiàn)介紹配置項(xiàng)實(shí)現(xiàn)介紹三、平臺(tái)通用引用屬性配置項(xiàng)的使用步驟1、在實(shí)體中標(biāo)記特性[EntityWithConfig(typeof(NoConfig),“名稱”,“描述")]2、運(yùn)行項(xiàng)目，在具體功能中可以看到一個(gè)配置項(xiàng)按鈕，在進(jìn)行配置項(xiàng)值的配置前，要先維護(hù)編碼規(guī)則基礎(chǔ)數(shù)據(jù)；3、獲取配置項(xiàng)配置值的實(shí)現(xiàn)方法：public

virtual

stringGetCatNo()

{

varconfig=ConfigService.GetConfig(new

NoConfig(),typeof(實(shí)體類));

if(config==null||config.BacodeRule==null)

throw

newValidationException("未找到編碼生成規(guī)則,請(qǐng)檢查規(guī)則配置".L10N());

returnRT.Service.Resolve<NumberRuleController>().GenerateSegment(config.NumberRuleId.Value,1).FirstOrDefault();

}02配置項(xiàng)功能的開發(fā)示例思考題以讀者分類功能添加配置項(xiàng)按鈕為例，配置可借書天數(shù)的值，可借書天數(shù)只能維護(hù)正整數(shù)，如何實(shí)現(xiàn)？完成配置項(xiàng)的開發(fā)，我們需要開發(fā)三個(gè)類，分別為：配置實(shí)體類，配置界面類和配置規(guī)則生成說明類。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在服務(wù)端工程的讀者分類中建一個(gè)配置項(xiàng)的Configs文件夾，在文件夾中添加配置項(xiàng)的實(shí)體類，繼承ConfigValue，標(biāo)記為根實(shí)體和序列化特性。（命令規(guī)范：此類名稱必須以XXXXXValue命名，最后必須帶“Value”）。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在配置實(shí)體類中通過代碼段添加可借書數(shù)量的屬性（這里使用的是一般屬性），類型為int類型；重寫顯示值的方法Display，返回可借書數(shù)量值。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在界面端工程添加界面配置類，繼承WebViewConfig，關(guān)聯(lián)上面步驟建的配置項(xiàng)實(shí)體類，重寫詳細(xì)視圖配置方法。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在服務(wù)端工程添加配置規(guī)則生成說明類，繼承ModuleConfig，關(guān)聯(lián)配置實(shí)體類，重寫獲取默認(rèn)值的屬性DefaultValue，添加顯示名稱和描述。命名規(guī)范：規(guī)則生成說明類的命名，必須是配置項(xiàng)的類名“Value”之前的部分，如配置項(xiàng)的類名為“XXXXXValue”時(shí)規(guī)則生成說明類必須命名為“XXXXX”。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在讀者分類實(shí)體中配置特性EntityWithConfig，關(guān)聯(lián)配置規(guī)則類。普通屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟運(yùn)行項(xiàng)目，查看效果，在讀者分類功能中多了一個(gè)配置項(xiàng)的按鈕，如下。思考題讀者分類中配置類別號(hào)的編碼規(guī)則，關(guān)聯(lián)編碼規(guī)則的數(shù)據(jù)，如何實(shí)現(xiàn)？與上面的示例差異為配置實(shí)體類的屬性不一致，這里使用的是關(guān)聯(lián)編碼規(guī)則實(shí)體的引用屬性，其他實(shí)現(xiàn)與上面示例一致。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在服務(wù)端工程的讀者分類中添加配置項(xiàng)的實(shí)體類CatNoConfigValue，繼承ConfigValue，標(biāo)記為根實(shí)體RootEntity和序列化Serializable特性。（命令規(guī)范：此類名稱必須以XXXXXValue命名，最后必須帶“Value”）。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在配置實(shí)體類中通過代碼段添加類別號(hào)的屬性（這里使用的是引用屬性），引用屬性關(guān)聯(lián)的實(shí)體類為NumberRule，重寫顯示值的方法Display，返回類別號(hào)屬性值。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在界面端工程添加界面配置類，繼承WebViewConfig，關(guān)聯(lián)配置項(xiàng)實(shí)體類CatNoConfigValue，重寫詳細(xì)視圖配置方法。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在服務(wù)端工程添加配置規(guī)則生成說明類，繼承ModuleConfig，關(guān)聯(lián)配置實(shí)體類，重寫獲取默認(rèn)值的屬性DefaultValue，添加顯示名稱和描述。命名規(guī)范：規(guī)則生成說明類的命名，必須是配置項(xiàng)的類名“Value”之前的部分，如配置項(xiàng)的類名為“XXXXXValue”時(shí)規(guī)則生成說明類必須命名為“XXXXX”。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在讀者分類實(shí)體中配置特性EntityWithConfig，關(guān)聯(lián)配置規(guī)則類。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟運(yùn)行項(xiàng)目，查看效果，在讀者分類功能中多了一個(gè)配置項(xiàng)的按鈕，如下。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟類別號(hào)生成規(guī)則的下拉選項(xiàng)的數(shù)據(jù)，依賴于平臺(tái)功能“編碼規(guī)則”，需要在編碼規(guī)則中維護(hù)數(shù)據(jù)。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟在“編碼規(guī)則”功能中，點(diǎn)擊“編碼段”命令，進(jìn)入到編碼段功能，第一次打開該功能會(huì)沒有數(shù)據(jù)，點(diǎn)擊“初始化”按鈕進(jìn)行初始化。引用屬性配置項(xiàng)功能開發(fā)示例開發(fā)步驟如下“類別號(hào)生成規(guī)則”選擇數(shù)據(jù)為“通用編碼規(guī)則”，使用這個(gè)編碼規(guī)則時(shí)，框架有一個(gè)根據(jù)規(guī)則明細(xì)配置的數(shù)據(jù)生成規(guī)則的算法（生成的規(guī)則：從上往下生成，生成的位數(shù)依賴于“編碼長(zhǎng)度”列，值依賴于“配置”列）。引用屬性配置項(xiàng)知識(shí)擴(kuò)展知識(shí)擴(kuò)展引用屬性配置項(xiàng)的開發(fā)框架實(shí)現(xiàn)了一個(gè)通用的，可以直接調(diào)用。使用：[EntityWithConfig(typeof(NoConfig),“類別號(hào)規(guī)則配置信息”,“類別號(hào)規(guī)則配置”)]；其中NoConfig為配置規(guī)則類，“類別號(hào)規(guī)則配置信息”為對(duì)應(yīng)描述信息，“類別號(hào)規(guī)則配置”為名稱信息。引用屬性配置項(xiàng)知識(shí)擴(kuò)展知識(shí)擴(kuò)展效果。03列表獲取配置項(xiàng)配置值的開發(fā)示例思考題讀者分類添加時(shí)，類別號(hào)根據(jù)配置項(xiàng)配置的規(guī)則自動(dòng)生成，可借書數(shù)量的默認(rèn)值取配置項(xiàng)配置的可借書數(shù)量值，如何實(shí)現(xiàn)？解析：1、從業(yè)務(wù)描述中可以看出來，要實(shí)現(xiàn)該業(yè)務(wù)，需要重寫讀者分類的添加命令；2、因?yàn)橐@取配置項(xiàng)配置的值進(jìn)行設(shè)置，則這個(gè)添加命令需要向后臺(tái)請(qǐng)求數(shù)據(jù)，所以該添加命令，還需要對(duì)應(yīng)的cs命令文件；列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟新建js命令，繼承SIE.cmd.Add,并將js命令文件嵌入到資源，重寫onItemCreated方法。SIE.defineCommand('SIE.Web.LibMan.ReaderCats.Commands.AddReaderCatCommand',{extend:'SIE.cmd.Add',meta:{text:"添加",group:"edit",iconCls:"icon-AddEntityicon-green"},onItemCreated:function(entity){

}});列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟在onItemCreated方法中，通過this.view.execute向后端請(qǐng)求數(shù)據(jù)。this.view.execute({data:傳到后端的參數(shù)，需要保證前端和后臺(tái)接收的方法一致，否則執(zhí)行不到后端方法,success:function(res){//請(qǐng)求后端數(shù)據(jù)成功的業(yè)務(wù)處理}},this.view);說明：1）data的參數(shù)，一般情況下會(huì)傳當(dāng)前操作實(shí)體的數(shù)據(jù)到后端，當(dāng)前操作實(shí)體的數(shù)據(jù)可以通過onItemCreated的參數(shù)entity進(jìn)行獲取，即entity.data;2）this的作用域會(huì)變，在使用時(shí)，最好用個(gè)變量賦值存起來，方面后面使用；列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟添加cs命令文件（命名空間與js命令文件命名空間一致），繼承ViewCommand，實(shí)現(xiàn)抽象方法Excute。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟在執(zhí)行方法中做參數(shù)類型的轉(zhuǎn)換，通過args.Data.ToJsonObject<ReaderCat>()，其中ReaderCat與前端傳遞過來的參數(shù)類型一致，因?yàn)榍岸耸莻鞯漠?dāng)前實(shí)體的數(shù)據(jù)，后端直接轉(zhuǎn)成對(duì)應(yīng)的實(shí)體即可。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟獲取配置項(xiàng)配置的可借書天數(shù)和類別號(hào)。說明：1）因?yàn)橐@取配置項(xiàng)配置的值，需要訪問后端數(shù)據(jù)庫(kù)，數(shù)據(jù)庫(kù)訪問相關(guān)操作不能在客戶端進(jìn)行操作，而是在服務(wù)端工程中的控制器類中進(jìn)行對(duì)應(yīng)的業(yè)務(wù)邏輯處理；2）控制器類：命名規(guī)范：以Controller結(jié)尾，一般是以“類名+Controller”命名；繼承：DomainController；控制器方法：非私有方法必須是虛方法；業(yè)務(wù)方法說明：對(duì)應(yīng)實(shí)體的業(yè)務(wù)邏輯方法盡量在對(duì)應(yīng)實(shí)體的控制器中處理；控制器方法的調(diào)用：RT.Service.Resolve<控制器類名>().方法名(參數(shù))。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟獲取配置項(xiàng)配置的可借書天數(shù)的方法。

public

virtual

intGetConfigQty()

{varconfig=ConfigService.GetConfig(newQtyConfig(),typeof(ReaderCat));if(config==null||config.Qty==0){ return0;}returnconfig.Qty;}說明：1、ConfigService.GetConfig(newQtyConfig(),typeof(ReaderCat))為獲取配置項(xiàng)的值，QtyConfig()為配置規(guī)則生成說明類，ReaderCat為實(shí)體類；2、配置規(guī)則生成說明類和實(shí)體類要與實(shí)體中配置的規(guī)則生成類和實(shí)體要一致，否則獲取的配置值和設(shè)置的會(huì)不一樣；列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟獲取配置項(xiàng)配置的類別號(hào)的方法。

public

virtual

stringGetCustomCatNo()

{

varconfig=ConfigService.GetConfig(newCatNoConfig(),typeof(ReaderCat));

if(config==null||config.CatNo==null)

throw

newValidationException("未找到類別號(hào)編碼生成規(guī)則,請(qǐng)檢查規(guī)則配置".L10N());

returnRT.Service.Resolve<NumberRuleController>().GenerateSegment(config.CatNoId,1).FirstOrDefault();

}說明：1、ConfigService.GetConfig(newCatNoConfig(),typeof(ReaderCat))為獲取配置項(xiàng)的值，CatNoConfig()為配置規(guī)則生成說明類，ReaderCat為實(shí)體類；2、配置規(guī)則生成說明類和實(shí)體類要與實(shí)體中配置的規(guī)則生成類和實(shí)體要一致，否則獲取的配置值和設(shè)置的會(huì)不一樣；3、RT.Service.Resolve<NumberRuleController>().GenerateSegment(config.CatNoId,1)，為框架生成編碼的方法，config.CatNoId為屬性id，1為要生成多少個(gè)編碼；列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟設(shè)置讀者分類的類別號(hào)和可借書天數(shù)的值，返回到前端。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟前端在回調(diào)函數(shù)success中設(shè)置值。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟使用命令。列表獲取配置項(xiàng)配置值的開發(fā)示例開發(fā)步驟運(yùn)行項(xiàng)目，查看效果，操作添加按鈕之前要先設(shè)置配置項(xiàng)的值。04表單獲取配置項(xiàng)配置值的開發(fā)示例思考題圖書分類添加時(shí)，分類編碼根據(jù)配置項(xiàng)配置的規(guī)則自動(dòng)生成，如何實(shí)現(xiàn)？表單獲取配置項(xiàng)配置值的開發(fā)示例在圖書大類實(shí)體中配置實(shí)體配置項(xiàng)(配置項(xiàng)的開發(fā)步驟這里就不重復(fù)了具體參考“02配置項(xiàng)功能的開發(fā)示例”)，這里使用框架通用的配置項(xiàng)配置，如下。開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例運(yùn)行項(xiàng)目，配置編碼規(guī)則。開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例重寫讀者大類的添加命令，重寫showView方法。開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例SIE.defineCommand('SIE.Web.LibMan.BookCats.Commands.AddBigBookCommand',{extend:'SIE.cmd.Add',meta:{text:"添加",group:"edit",iconCls:"icon-AddEntityicon-green"},showView:function(entity){

varmodel=entity.data;

varme=this;

this.view.execute({data:model,success:function(res){

varcode=res.Result;CRT.Workbench.addPage({entityType:me.view.model,recordId:entity.getId(),viewGroup:'AddDetailView',title:me.getEditViewTitle(entity),params:{Code:code

},isDetail:true

});

}},me.view);

},});開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例添加cs命令文件（命名空間與js命令文件命名空間一致），繼承ViewCommand，實(shí)現(xiàn)抽象方法Excute。開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例獲取配置項(xiàng)配置的分類編碼的方法。

public

virtual

stringGetCode()

{

varconfig=ConfigService.GetConfig(newNoConfig(),typeof(BigBookCat));

if(config==null||config.BacodeRule==null)

throw

newValidationException("未找到分類編碼生成規(guī)則,請(qǐng)檢查規(guī)則配置".L10N());

returnRT.Service.Resolve<NumberRuleController>().GenerateSegment(config.NumberRuleId.Value,1).FirstOrDefault();

}開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例在后端命令的執(zhí)行方法中做參數(shù)類型的轉(zhuǎn)換，通過args.Data.ToJsonObject<參數(shù)類型，與前端參數(shù)一致>()；調(diào)用分類編碼自動(dòng)生成的方法，賦值給分類編碼，并返回給前端，如下。開發(fā)示例表單獲取配置項(xiàng)配置值的開發(fā)示例添加