動(dòng)態(tài)表單的使用手冊(cè)一、動(dòng)態(tài)表單概述動(dòng)態(tài)生成自定義的頁(yè)面布局通過(guò)動(dòng)態(tài)表單，管理員或用戶可以設(shè)置表單在頁(yè)面上的表現(xiàn)形式。系統(tǒng)根據(jù)動(dòng)態(tài)表單來(lái)生成頁(yè)面。設(shè)置表單的視圖權(quán)限。在工作流或其它需要控制表單字段權(quán)限的地方，可以通過(guò)視圖來(lái)實(shí)現(xiàn)表單字段級(jí)的讀、寫(xiě)、不可見(jiàn)控制。、動(dòng)態(tài)表單的原理動(dòng)態(tài)表單采用div+css方式實(shí)現(xiàn)，其基本原理是通過(guò)div的浮動(dòng)來(lái)實(shí)現(xiàn)布局。動(dòng)態(tài)表單的基本單元為組件(Component)，一個(gè)組件由3個(gè)div組成。如下圖LayoutDivVLabelDivFieldDiv布局Div:用于布局標(biāo)簽Div：用于顯示標(biāo)簽字段Div：用于放置輸入字段三、動(dòng)態(tài)表單的基本要素

動(dòng)態(tài)表單定義表單、視圖、視圖字段的信息。表單屬性ID表單IDDocTypeName文檔類型Name表單名稱FormLayoutSkin皮膚（未實(shí)現(xiàn)）DefaultLabelLayoutCls表單的LabelDivClassDefaultFieldLayoutCls表單的FieldDivClassDefaultLabelCls表單的LabelClassDefaultFieldCls表單的FieldClass視圖屬性ViewID116視圖IDName視圖名稱ViewLayoutSkin視圖皮膚（未實(shí)現(xiàn)）DefaultLabelLayoutCls視圖的LabelDivClassDefaultFieldLayoutCls視圖的FieldDivClassBodyCls視圖的LabelClass（未實(shí)現(xiàn)）LayoutCls視圖的FieldClass（未實(shí)現(xiàn)）LayoutStyle視圖的樣式（未實(shí)現(xiàn)）視圖字段:ID字段的IDViewID視圖的IDName字段名稱ContainerID容器的IDContainerName容器的名稱，未使用LayoutSequence字段的排序號(hào)，系統(tǒng)根據(jù)排序號(hào)生成頁(yè)面。FieldType字段類型ViewType字段的視圖控制，指可讀，可寫(xiě)等。FieldName字段名稱LabelName標(biāo)簽名稱HiddenLabel是否隱藏標(biāo)簽Enabled是否啟用。禁用的字段，不會(huì)在頁(yè)面中生成。ComponentType組件類型ComponentPosition組件位置ComponentStyle組件樣式LabelLayoutCls標(biāo)簽布局的cls，指LabelDiv的cls

FieldLayoutCls字段布局的cls，指FieldDiv的clsLabelCls標(biāo)簽本身的clsFieldCls字段的clsDisplayBindToField保留DefaultValue設(shè)置缺省值InputTranslation輸入轉(zhuǎn)換規(guī)則InputValidation輸入校驗(yàn)規(guī)則FormatString格式字符串labelDiv樣式，優(yōu)先級(jí)：field>view>form,如果都沒(méi)設(shè)置，則設(shè)為缺省:fieldLabelDivfieldDiv樣式，優(yōu)先級(jí):field>view>form，如果都沒(méi)設(shè)置，則設(shè)為缺省:fieldBodyDiv以下對(duì)于常用的設(shè)置進(jìn)行介紹：組件類型:ComponentType組件類型說(shuō)明無(wú)只是一個(gè)Div，不使用css單列布局整個(gè)Div是一個(gè)單一的列，并指定了預(yù)設(shè)的高度單列布局-無(wú)高度單列，未指定高度，用在多行的場(chǎng)合，比如編輯器容器2列布局一行由兩個(gè)組件構(gòu)成3列布局一行由3列構(gòu)成，寬度為1/33列布局2/3用于3列布局，寬度為2/34列布局1/4用于4列布局，寬度為1/4，對(duì)于2/4的組件，由2列布局代替。4列布局3/4用于4列布局，寬度為3/4o根組件根組件，指有上邊框和右邊框的div標(biāo)題組件未定義邊框，預(yù)設(shè)了標(biāo)題內(nèi)字體的div布局框未指定高度的1px邊框div組件類型表明，此組件在頁(yè)面的表現(xiàn)方式：組件的類型定義如下，組件類型在頁(yè)面上的表現(xiàn)形式是通過(guò)css來(lái)實(shí)現(xiàn)的。與組件的位置共同構(gòu)成完整的css。組件有不同的類型，代表了不同作用的布局方式。組件的位置:ComponentPosition組件的位置分為無(wú)、左、右三種。組件位置與組件類型共同組成該組件對(duì)應(yīng)Div的CSSClasso組件的左右是通過(guò)CSS浮動(dòng)來(lái)實(shí)現(xiàn)的。比如：組件名稱為ComponentA,則位置為左，構(gòu)成Class為ComponentA-Left。

字段類型:FieldType字段類型指的是在頁(yè)面上展示的控件的類型，可以是一個(gè)簡(jiǎn)單的TextBox,也可能復(fù)雜的用戶控件。不同的字段類型，決定了是否加入Label，F(xiàn)ield。字段類型說(shuō)明None無(wú)。該字段類型不加入Label和Field。一般應(yīng)用在容器字段。FieldDisplay只顯示字段。應(yīng)用于自定義的容器，但容器中可以加入內(nèi)容。此字段時(shí)無(wú)Fieldo顯示的類型由DisplayType定義，內(nèi)容由其它附加屬性定義。TextBox加入文本框。類型由TextMode定義。如果是MultiLine，則由Rows定義行數(shù)。DropDownList加入下拉列表框。目前只實(shí)現(xiàn)從鍵值表中取值。CheckBoxList加入復(fù)選框列表，與DropDownList類似。RadioButtonList單選按鈕列表。HTMLEditorHtml編輯器，系統(tǒng)選用FCKEditorWordEditorWord編輯器，系統(tǒng)選用DSOFramer控件EditorSelectable可選擇的組合編輯器，可以選擇TEXT，F(xiàn)CK，WORD作為文檔的編輯器，在第一次保存后，不能再選擇編輯器CheckBox復(fù)選框Permission權(quán)限控件Attachment附件控件TreeSelect樹(shù)形選擇控件TreeSelectTextBox帶選擇文本框的樹(shù)形選擇控件。TabPanel表時(shí)此組件為一個(gè)TabPanel,系統(tǒng)米用EXT作為呈現(xiàn)工具。Container此字段為一個(gè)容器。FieldDiaplay:顯示型字段DisplayType屬性說(shuō)明None未定義Text加入文本到LabeloImage加入圖片到LabelDiv。不加入FieldUserDefine自定義的HTML，加入到ComponentDiv。在不同的顯示類型時(shí)，由下列附加的屬性指明內(nèi)容:其它屬性說(shuō)明Text指定加入的文本，如果未指定，則顯示LabelName指定的值。ImagePath圖片路徑，注意如果是相對(duì)路徑，指相對(duì)于調(diào)用頁(yè)面的路徑。

HTML自定義的HTMLTextBox:文本框附加屬性FieldTextBox屬性說(shuō)明TextMode指定文本框的類型：SingleLine:單行文本MultiLine：多行文本，行數(shù)由另一個(gè)附加屬性Rows指定。Date:指文本框需輸入日期。由此自動(dòng)生成日歷控件用于選擇日期。DateTime：指示輸入時(shí)間。Rows當(dāng)指定為Multiline時(shí)，指明行數(shù)。DropDownList:下拉列表框?qū)傩哉f(shuō)明DataSourceCategory鍵值表中的分類CategoryDataSource未實(shí)現(xiàn)DataTextField文本對(duì)應(yīng)列，固定為keyDataValueField值對(duì)應(yīng)列，固定為valueBindToIndex指示綁定到幾條，取值時(shí)返回順序號(hào)。未實(shí)現(xiàn)。CheckBoxList:復(fù)選框列表屬性說(shuō)明DataSourceCategory鍵值表中的分類CategoryDataSource未實(shí)現(xiàn)DataTextField文本對(duì)應(yīng)列，固定為keyDataValueField值對(duì)應(yīng)列，固定為valueRepeatColumns顯示的列數(shù)。IsHorizontal是否水平顯示。HTMLEditor:HTML編輯器HTML編輯器，系統(tǒng)采用FckEditorWordEditor:Word編輯器在網(wǎng)頁(yè)中插入Word作為編輯器，采用DsoFramer插件WordHeight:Word的高度，單位為象素WordWidth:Word的寬度。EditorSelectable:可選擇的編輯器可選擇的編輯器，用戶可以選擇TextBox,Html,Word作為編輯器，在第一次保存后，不能再選擇。CheckBox:復(fù)選框復(fù)選框，附加屬性：Text指復(fù)選框顯示的文本，如果未指定，則為labelNamePermission:權(quán)限控件附加屬性：PermissionName:權(quán)限的名稱，指此控件設(shè)置的權(quán)限類型Read/EditorUpdate/InsertornewIsRolePermissionEnabled：是否允許角色權(quán)限，表示是否可以加入角色作為權(quán)限主體。如果允許，則加入角色選擇框。Attachment:附件控件TreeSelect：樹(shù)控件未完全實(shí)現(xiàn)，可以控制選擇的SelectFunction，關(guān)聯(lián)的字段。TreeSelectTxtBox:帶3個(gè)文本框的樹(shù)控件是TreeSelect的一個(gè)具體的實(shí)現(xiàn)，樹(shù)選擇控件需要指定選擇的類型，是否多選，是否在Ext中使用等。樹(shù)選擇控件返回三個(gè)值，Name,Value,NameVdue，需要指定返回值對(duì)應(yīng)的字段名，樹(shù)選擇完成后，可以自動(dòng)調(diào)用回調(diào)方法。NameField：返回Name的字段名VaiueField：返回Value的字段名NameValueField:返回NameValue的字段名CallBack:回調(diào)方法，需開(kāi)發(fā)者完成實(shí)現(xiàn)。OtherParams:樹(shù)控件方法所需要的附加參數(shù)，此參數(shù)只由開(kāi)發(fā)人員在寫(xiě)樹(shù)選擇類型對(duì)應(yīng)的調(diào)用方法時(shí)需要時(shí)使用。比如在CommunitySearchWindow中的實(shí)現(xiàn)TreeSelectType:樹(shù)類型說(shuō)明可多選？可在Ext中使用？None無(wú)Employee職員Department部門Role角色Workgroup工作組Postf-U岡位Menu菜單ResourceOperation資源CommunityCode社區(qū)代碼Compound樓院小區(qū)PartyOrganization黨組織PartyMember黨組織成員PersonBaseInfo人口基本信息CommunitySearchWindow社區(qū)相關(guān)的搜索窗IsMulSelect：是否多選，需要相應(yīng)的選擇方法支持IsUsedInExt:是否在Ext中使用，需要相應(yīng)的選擇方法支持TextBoxDisplayType：顯示返回值的字段，可以復(fù)選3種，當(dāng)選擇時(shí)，顯示對(duì)應(yīng)的TextBox，如果不顯示，但指定了對(duì)應(yīng)的字段名，仍可通過(guò)引用控件返回選擇的值。TabPanel:生成Ext的TabPanel生成一個(gè)TabPanel容器，系統(tǒng)對(duì)些類型的字段，有專門的呈現(xiàn)處理方法，Container:容器表明此組件是一個(gè)容器。容器的作用主要用于布局，在容器字段中，可以加入其它組件。組件樣式：ComponentStyle可以加入CSS代碼，直接作用于ComponentDiv。此處可以由用戶靈活定義。校驗(yàn)規(guī)則:InputVilidation校驗(yàn)規(guī)則：字段輸入數(shù)據(jù)時(shí)，采用統(tǒng)一的校驗(yàn)方法。目錄只實(shí)現(xiàn)了無(wú)參數(shù)的校驗(yàn)，輸入時(shí)，只需輸入名稱，用逗號(hào)分隔比如：IsEmpty,isDate主要的校驗(yàn)方法如下表：公式說(shuō)明IsEmpty是否為空輸入不能為空！IsMatchRegular(stringregular)匹配正則表達(dá)式IsMatchRegular(stringregular,stringmessage)IsInLengthRange(intmin,intmax)輸入長(zhǎng)度，以字節(jié)為單位IsInLengthRange(intmin,intmax,stringmessage)IsSameWithPrev(stringprevId)是否和上一個(gè)輸入一致，例如檢查輸入兩次密碼是否相同IsName()常規(guī)用戶名，以字母開(kāi)頭，字母，數(shù)字和—組成IsPwd()常規(guī)密碼字母，數(shù)字和@,$,&,-,#,_組成IsEmail()Email格式xxx@xxx.xxxIsUrl()URL格式xxx://xxx.xxx.xxxIsIP()IP地址xxx.xxx.xxx.xxxIsDateTime()日期時(shí)間yyyy-MM-ddHH:mm:ssIsDate()日期yyyy-MM-ddIsTime()時(shí)間HH:mm:ssIsTel()固定電話XXXX-XXXXXXXX-XXXIsMobile()移動(dòng)電話11位的移動(dòng)電IsPostCode()郵政編碼IsQQ()QQ號(hào)碼IsIDCard()身份證號(hào)碼IsNumber()數(shù)字IsInt()是否整數(shù)

IsSInt()正整數(shù)IsNInt()負(fù)整數(shù)IsNotNInt()非負(fù)整數(shù)IsNotSInt()非正整數(shù)IsFloat()浮點(diǎn)數(shù)IsSFloat()正浮點(diǎn)數(shù)IsNFloat()負(fù)浮點(diǎn)數(shù)IsNotNFloat()非負(fù)浮點(diǎn)數(shù)IsNotSFloat()非正浮點(diǎn)數(shù)IsEnglish()英文字母IsUpper()大寫(xiě)英文字母IsLower()小寫(xiě)英文字母IsChinese()中文字符IsDoubleByte()雙字節(jié)字符設(shè)置初值:DefaultValue系統(tǒng)提供了為字段設(shè)置初值的方法。有兩種方法可以設(shè)置初值：1）在QueryString中傳入初值比如：http://domain/tes