MES開發(fā)與應用 課件 工業(yè)管理軟件開發(fā)基礎-平臺配置-平臺編輯器使用介紹

3.4平臺通用配置深圳市信息職業(yè)技術學院——平臺編輯器使用介紹String類型編輯器數(shù)值類型編輯器時間類型編輯器引用類型編輯器通用編輯器介紹枚舉類型編輯器圖片編輯器Bool類型編輯器快碼編輯器知識回顧實體介紹；實體屬性及實體屬性特性；實體特性；實體配置；視圖介紹；視圖配置；視圖屬性配置；知識擴展；學習目標通過本節(jié)學習可以：掌握框架實現(xiàn)的通用編輯器包括哪些？能夠區(qū)分什么類型的屬性使用什么編輯器？掌握平臺不同編輯器的使用；掌握編輯器屬性的配置使用。01通用編輯器介紹編輯器介紹編輯器介紹框架實現(xiàn)的編輯器包括：文本編輯器、數(shù)值編輯器、下拉編輯器、枚舉編輯器、復選框編輯器、時間類型編輯器、圖片編輯器和快碼編輯器。String類型的屬性框架默認使用的編輯器為文本編輯器：UseTextEditor()；Bool類型的屬性框架默認使用的編輯器為復選框編輯器：UseCheckEditor()；枚舉類型的屬性框架默認使用的是枚舉編輯器：UseEnumEditor();數(shù)值類型的屬性框架默認使用的是數(shù)值編輯器：UseSpinEditor();時間類型的屬性框架默認使用的是日期時間編輯器：UseDateTimeEditor();引用類型的屬性框架默認使用的是下拉列表編輯器：UsePagingLookUpEditor();編輯器注意事項編輯器注意事項框架編輯器的使用依賴于屬性的類型，如框架默認下拉編輯器只能使用在引用屬性，在其他類型中使用下拉列表編輯器會報錯。如果不設置編輯器的具體參數(shù)，框架默認會根據(jù)屬性的類型去讀取對應的編輯器來展示，不需要額外進行指定對應的編輯器。所有的編輯器都有ColumnXType（列的類型）和XType（控件類型），用于對編輯器進行重寫，ColumnXType和XType綁定的值為控件js文件的別名。02String類型編輯器String類型編輯器String類型屬性使用的編輯器即為文本編輯器。文本編輯器包含如下幾種： 1、字符串屬性編輯器UseTextEditor()：框架string類型屬性默認的編輯器常用參數(shù)：AllowBlank（是否允許為空）、MaxLength(最大長度)、MasLengthText(最大長度驗證失敗提示信息)、MinLenght（最小長度）、MinLenghtText(最小長度驗證失敗提示信息) 2、密碼編輯器：UsePasswordEditor()；常用參數(shù)：AllowBlank（是否允許為空）、MaxLength(最大長度)、MasLengthText(最大長度驗證失敗提示信息)、MinLenght（最小長度）、MinLenghtText(最小長度驗證失敗提示信息)。 3、大文本編輯器：UseMemoEditor()；常用參數(shù)：AllowBlank（是否允許為空）String類型編輯器03數(shù)值類型編輯器數(shù)值類型編輯器數(shù)值類型編輯器：UseSpinEditor()常用參數(shù)：AllowBlank（是否允許為空）、MaxValue(最大值)、MinValue(最小值)、AllowDecimals(是否允許為小數(shù))、DecimalPrecision（小數(shù)位數(shù)）、AllowNegative（是否允許為負數(shù)）、Step（增量設置）。說明： 1、整數(shù)類型的屬性使用數(shù)值編輯器，沒有小數(shù)位數(shù)，也不能設置小數(shù)位數(shù)； 2、浮點類型的屬性使用數(shù)值編輯器，默認三位小數(shù)，增量默認為0.001；數(shù)值類型編輯器思考題數(shù)值類型的編輯器要使增量失效，可以怎么做？可以設置數(shù)值編輯器的Step為0，即.UseSpinEditor(p=>p.Step=0)。04時間類型編輯器日期時間編輯器屬性類型為DateTime的屬性使用的編輯器為時間類型編輯器，時間類型的編輯器包括：日期時間編輯器、日期編輯器、時間編輯器和日期范圍編輯器。1、日期時間編輯器：UseDateTimeEditor()，使用該編輯器顯示格式為：年月日時分秒。常用參數(shù)：AllowBlank（是否允許為空）、MaxValue(最大值)、MinValue(最小值)。默認值設置：設置為當前時間使用示例：View.Property(p=>p.EffectiveStartTime).DefaultValue(DateTime.Now.ToString("yyyy/MM/ddHH:mm:ss")).UseDateTimeEditor()日期時間編輯器日期編輯器2、日期編輯器：UseDateEditor()，使用該編輯器顯示格式為：年月日常用參數(shù)：Format(日期格式化)、AllowBlank（是否允許為空）、MaxValue(最大值)、MinValue(最小值)。默認值設置：設置為當前日期為默認值View.Property(p=>p.EffectiveStartTime).DefaultValue(System.DateTime.Today).UseDateEditor()格式化設置：View.Property(p=>p.Property7).UseDateEditor(p=>p.Format="Y/m/d");View.Property(p=>p.Property3).UseDateEditor(p=>p.Format="Y-m-d");日期編輯器時間編輯器3、時間編輯器：UseTimeEditor()，使用該編輯器顯示格式為：時分秒常用參數(shù)：Format(日期格式化)、AllowBlank（是否允許為空）、MaxValue(最大值)、MinValue(最小值)。格式化設置：View.Property(p=>p.Property7).UseTimeEditor(p=>p.Format="H")View.Property(p=>p.Property3).UseTimeEditor(p=>p.Format="H:m:s")時間編輯器日期范圍編輯器4、日期范圍編輯器：UseDateRangeEditor()常用參數(shù)：DateFormat（格式化）、AllowBlank（是否允許為空）、MaxValue(最大值)、MinValue(最小值)、DateRangeType(日期范圍類型)、StartDate（開始日期）、EndDate（結束日期）。使用示例：設置日期范圍默認為當前月View.Property(p=>p.UpdateDate).UseDateRangeEditor(p=>p.DateRangeType=ObjectModel.DateRangeType.Month);格式化設置：View.Property(p=>p.UpdateDate).UseDateRangeEditor(p=>{p.DateFormat="Y-m-d";});注意事項：

1、日期范圍參數(shù)DateRangeType不設置，默認為當天； 2、如果是自定義查詢實體實現(xiàn)日期范圍的查詢，查詢實體對應使用日期范圍控件的數(shù)據(jù)類型要設置為日期范圍DateRange；日期范圍編輯器05引用類型編輯器引用類型編輯器引用類型編輯器使用的是下拉編輯器：UsePagingLookUpEditor()常用參數(shù)：AllowBlank（是否允許為空）、DisplayField(顯示值)、BindDisplayField(顯示綁定的值，通常要與DisplayField一起使用)、DicLinkField(聯(lián)動字段)、Editable（是否可編輯）、XType（控件的類型）。必須要是引用屬性才能使用該編輯器如前面講的讀者管理的類別號關聯(lián)的是讀者分類的信息，讀者管理的類別號用下拉列表實現(xiàn)。我們回顧下實現(xiàn)步驟：引用類型編輯器引用類型編輯器使用步驟 1、讀者管理的實體添加引用屬性，引用屬性關聯(lián)的實體為讀者分類使用步驟引用類型編輯器2、在讀者分類的實體中配置顯示名稱，這步不做，會導致下拉選擇后無法顯示問題使用步驟引用類型編輯器3、在讀者分類的界面中配置選擇視圖，這步不做或者配置的地方不對，會導致下拉選擇的數(shù)據(jù)和列顯示異常。使用步驟引用類型編輯器4、在讀者管理中使用下拉編輯器。注意：使用modelfirst建模生成的界面配置屬性的展示是用的引用屬性管理的實體進行下拉關聯(lián)的，這里要改成用id，這樣改的目前是避免N+1查詢的問題。使用步驟引用類型編輯器5、效果。使用步驟思考題引用類型編輯器需要根據(jù)條件展示數(shù)據(jù)，應該如何實現(xiàn)？引用屬性自定義編輯器的實現(xiàn)說明：引用屬性下拉編輯器，項目使用場景較多的就是根據(jù)不同的條件展示下拉選擇數(shù)據(jù)，這種需求通過重寫數(shù)據(jù)源，處理數(shù)據(jù)加載部分即可滿足需求。使用步驟： 1、在界面端建一個擴展靜態(tài)類，類名以Extention結尾，如下：使用步驟引用屬性自定義編輯器的實現(xiàn)2、在靜態(tài)類中實現(xiàn)自定義編輯器方法：

///

<summary>

///打印模板配置-標簽模板級聯(lián)編輯器

///

</summary>

///

<typeparam

name="T">實體類型</typeparam>

///

<param

name="meta">屬性視圖元數(shù)據(jù)</param>

///

<param

name="action">委托</param>

///

<returns>泛型屬性視圖元數(shù)據(jù)</returns>

public

staticWebEntityPropertyViewMeta<T>UseLabelPrintTemplateEditor<T>(thisWebEntityPropertyViewMeta<T>meta,Action<PagingLookUpBaseConfig>action=null)

{meta.UseDataSource((source,pagingInfo,keyword)=>

{

vartemplate=sourceasLabelPrintTemplate;

vartemplates=newEntityList<PrintTemplate>();

if(template==null||template.NumberRule==null)

returntemplates;

vartemplateList=RT.Service.Resolve<ItemController>().GetRuleInTemplates(template.NumberRuleId.Value,pagingInfo,keyword);

returntemplateList;}).UsePagingLookUpEditor(action);

returnmeta;

}使用步驟Source為數(shù)據(jù)源，即使用編輯器界面對應的實體。符合條件的下拉選擇列表的數(shù)據(jù)，數(shù)據(jù)類型為EntityList。引用屬性自定義編輯器的實現(xiàn)3、后臺查詢數(shù)據(jù)庫方法的實現(xiàn)：

public

virtualEntityList<PrintTemplate>GetRuleInTemplates(doubleruleId,PagingInfopagingInfo,stringkeyword)

{

varquery=Query<PrintTemplate>().LeftJoin<NumberRuleInTemplate>((x,y)=>x.Id==y.TemplateId).Where<NumberRuleInTemplate>((x,y)=>y.RuleId==ruleId);

if(!keyword.IsNullOrEmpty())query.Where(x=>x.EntityName.Contains(keyword)||x.FileName.Contains(keyword));

varresult=query.ToList(pagingInfo,newEagerLoadOptions().LoadWithViewProperty());

returnresult;

}使用步驟返回值要主要分頁和懶加載的問題Keyword的查詢條件要與實體配置條件一致引用屬性自定義編輯器的實現(xiàn)4、ViewConfig使用自定義編輯器使用步驟引用屬性自定義編輯器的實現(xiàn)5、效果使用步驟06枚舉類型編輯器枚舉類型編輯器枚舉編輯器UseEnumEditor()常用參數(shù)：AllowBlank（是否允許為空）。設置默認值及使用：View.Property(p=>p.Type).DefaultValue((int)ItemType.Product).UseEnumEditor()

其中：Type的屬性類型必須是枚舉，ItemType為枚舉，Product為枚舉的屬性；框架枚舉編輯器支持帶條件搜索，使用如下：

View.Property(p=>p.Type).UseEnumEditor("CriteriaEntity")；枚舉類型編輯器07圖片編輯器圖片編輯器圖片編輯器UseImageComponentEditor()說明：框架圖片編輯器只能在表單中使用，列表使用不生效；使用圖片編輯器的屬性類型只能是byte[]；圖片編輯器雖然有參數(shù)Width（寬）、Height（高）等這些，但是一般我們在ShowInDetail中設置相應的參數(shù)效果會好些。圖片編輯器08Bool類型編輯器Bool類型編輯器復選框編輯器UseCheckEditor()：框架bool類型默認的編輯器常用參數(shù)：AllowBlank（是否允許為空）、Editable（是否可編輯）。使用：View.Property(p=>p.Check).UseCheckEditor();布爾下拉編輯器UseCheckDropDownEditor()常用參數(shù)：AllowBlank（是否允許為空）、Editable（是否可編輯）。使用：

View.Property(p=>p.Check).UseCheckDropDownEditor();Bool類型編輯器09快碼編輯器框架快碼功能介紹快碼可以理解為是動態(tài)的枚舉或者是數(shù)據(jù)字典，在SMOM平臺中，做了一個快碼的功能包含主表和從表，用于維護這些基礎數(shù)據(jù)，主表的數(shù)據(jù)不能在界面維護，需要在程序中實現(xiàn)或者是在數(shù)據(jù)庫中處理，從表的數(shù)據(jù)可在界面中維護；而框架做的快碼編輯器就是通過快碼主表的編碼做查詢條件，將滿足條件的明細數(shù)據(jù)篩選出來展示在快碼下拉編輯器中?？蚣芸齑a功能介紹快碼的應用場景控制邏輯標識：使用快碼可以對復雜的邏輯結構進行標識和記錄，方便對其進行維護和修改；生產過程監(jiān)控：使用快碼可以方便標識并追蹤生產流程中的各個環(huán)節(jié)和產出物的信息，從而提高生產效率和質量；需求調研和功能設計階段，對一些類型的分類不明確或者是分類較多的，使用枚舉開發(fā)這類需求會存在反復改代碼的問題；如果所有這類需求都用基礎數(shù)據(jù)界面維護，功能開發(fā)會較多且不利于維護數(shù)據(jù)；基于這種場景考慮，框架引入了快碼這個功能，專門處理這種場景的業(yè)務需求?？齑a的應用場景快碼功能主表數(shù)據(jù)的添加從快碼功能菜單可以看出，快碼主表的數(shù)據(jù)是不能在界面中進行維護的，而快碼編輯器獲取的是對應主表下的所有明細數(shù)據(jù)。所以我們在使用編輯器之前要先將快碼主表的數(shù)據(jù)維護起來。主表數(shù)據(jù)的維護提供兩種方式： 1、通過數(shù)據(jù)庫腳本的方式執(zhí)行：這種方式必須掌握； 2、在程序中通過程序添加數(shù)據(jù)：這種方式要清楚原理，能看懂代碼?？齑a功能主表數(shù)據(jù)的添加快碼功能主表數(shù)據(jù)的添加快碼和快碼明細對應的表

快碼主表名：BD_CATALOG_TYPE；快碼明細表名：BD_CATALOGOracle執(zhí)行腳本：insertintoBD_CATALOG_TYPE(ID,CODE,CREATE_BY,CREATE_DATE,DESCRIPTION,INV_ORG_ID,IS_PHANTOM,NAME,SYNC_ID,UPDATE_BY,UPDATE_DATE)values(100060,

'Lib_Unit',100000,sysdate,N'單位',

1,

'0',

N'單位',

60,

100000,sysdate);

SQLServer執(zhí)行腳本:insert

intoBD_CATALOG_TYPE

(ID,CODE,CREATE_BY,CREATE_DATE,

DESCRIPTION,INV_ORG_ID,IS_PHANTOM,

NAME,SYNC_ID,UPDATE_BY,UPDATE_DATE)values(100060,

'Lib_Unit',100000,

GETDATE(),

N'單位',

1,

'0',

N'單位',

60,

100000,GETDATE());說明：Code值的設置為英文，且唯一，快碼使用時會用這個編碼作為條件；庫存組織INV_ORG_ID設置值為1（其他的庫存組織對應的快碼通過快碼功能的“同步”按鈕實現(xiàn)），是否假刪除IS_PHANTOM為0；ID和SYNC_ID唯一即可；創(chuàng)建人CREATE_BY和修改人UPDATE_BY找員工維護對應存在數(shù)據(jù)的id即可。數(shù)據(jù)庫腳本執(zhí)行思考題快碼主表數(shù)據(jù)通過程序添加是如何進行實現(xiàn)的？快碼功能主表數(shù)據(jù)的添加在服務端工程添加一個初始化數(shù)據(jù)的類，這個類的命名是根據(jù)時間戳進行命名的，即前面部分名稱必須為“_年月日_時分秒”的格式，如下所示：程序代碼添加實現(xiàn)步驟說明：SMOM框架去執(zhí)行這個初始化類時，如果有其他的初始化類的時間戳更大些，該類會執(zhí)行不到，所以定義時間戳時盡量設置大些?？齑a功能主表數(shù)據(jù)的添加初始化類繼承：ManualDbMigration，重寫屬性獲取數(shù)據(jù)庫DbSetting和類型Type；重寫數(shù)據(jù)庫升級的方法Up程序代碼添加實現(xiàn)步驟快碼功能主表數(shù)據(jù)的添加運行項目升級數(shù)據(jù)庫注意事項初始化快碼組的數(shù)據(jù)初始化類時間戳必須為整個解決方案最新；使用了初始化數(shù)據(jù)的服務端工程，必須要有單獨的數(shù)據(jù)提供者；升級數(shù)據(jù)庫的時候必須勾選全部數(shù)據(jù)庫；項目上如何沒有硬性要求，可直接通過SQL方式往數(shù)據(jù)庫快碼組表的插入數(shù)據(jù)，快碼組數(shù)據(jù)的編碼與在實體中建的常量的默認值保持一致；程序代碼添加實現(xiàn)步驟思考題快碼編輯器是如何使用的？快碼編輯器的使用快碼的使用以單