【文章內(nèi)容簡(jiǎn)介】 // param name=businessObject/param /// param name=voucherObject/param void RowDoubleClick(RowDoubleClickEventArgs para, BusinessProxy businessObject, VoucherProxy voucherObject)。 /// summary /// 鼠標(biāo)左鍵雙擊數(shù)據(jù)單元格的接口 /// /summary /// param name=para鼠標(biāo)雙擊信息/param /// param name=businessObject所屬業(yè)務(wù)對(duì)象/param /// param name=voucherObject所屬表單對(duì)象/param void CellDoubleClick(CellDoubleClickEventArgs para, BusinessProxy businessObject, VoucherProxy voucherObject)。 /// summary /// 鼠標(biāo)左鍵雙擊表格的標(biāo)題的接口 /// /summary /// param name=para鼠標(biāo)雙擊信息/param /// param name=businessObject所屬業(yè)務(wù)對(duì)象/param /// param name=voucherObject所屬表單對(duì)象/param void HeaderDoubleClick(HeaderDoubleClickEventArgs para, BusinessProxy businessObject, VoucherProxy voucherObject)。 /// summary /// 設(shè)置當(dāng)前列之后的接口 /// /summary /// param name=para列信息/param /// param name=businessObject所屬業(yè)務(wù)對(duì)象/param /// param name=voucherObject所屬表單對(duì)象/paramvoid CellSelected(CellSelectEventArgs para, BusinessProxy businessObject, VoucherProxy voucherObject)。 表單功能開(kāi)發(fā)(門戶工具欄按鈕功能開(kāi)發(fā))說(shuō)明IRecepit接口中的方法/// summary/// 門戶工具欄按鈕被點(diǎn)擊時(shí)觸發(fā)該方法，可以根據(jù)參數(shù)判斷是哪個(gè)按鈕被觸發(fā)/// param name=ButtonArgs被點(diǎn)擊門戶工具欄按鈕參數(shù)/param /// /summaryIButtonEventHandler GetButtonEventHandler(VoucherButtonArgs ButtonArgs)。 這個(gè)方法是表單功能按鈕執(zhí)行的入口，根據(jù)在UAP表單功能的功能管理(見(jiàn)圖2)里添加的不同功能按鈕的ButtonKey來(lái)區(qū)別不同的功能。，該返回值對(duì)象會(huì)被UAP運(yùn)行時(shí)調(diào)用來(lái)執(zhí)行該對(duì)象中的方法。IButtonEventHandler接口定義了三個(gè)方法，按照運(yùn)行時(shí)被調(diào)用執(zhí)行的先后順序分別為：string Excuting (VoucherProxy ReceiptObject)、string Excute (VoucherProxy ReceiptObject, string PreExcuteResult)、string Excuted(VoucherProxy ReceiptObject, string PreExcuteResult)。注：（1）三個(gè)方法的返回值為xml字符串，其格式為resultsystem result=\true\ errinfo=\ + errinfo + \//result，該返回值用來(lái)標(biāo)示當(dāng)前方法是否成功執(zhí)行，記錄在result屬性里，errinfo屬性用來(lái)記錄任何可能的信息。Excuting方法的返回值可以作為Excute方法的第二個(gè)參數(shù)PreExcuteResult傳入Excute，你可以在Excute方法體重分析傳入的信息決定程序是否繼續(xù)執(zhí)行，或作出其他處理等，同樣，Excute方法的返回值也可作為Excuted方法的參數(shù)傳入，并作必要檢查。另外，你可以在保證上面規(guī)定的xml結(jié)構(gòu)的前提下，在result節(jié)點(diǎn)內(nèi)擴(kuò)展該xml結(jié)構(gòu)，以適應(yīng)你的應(yīng)用邏輯的需要。（2）三個(gè)方法共有的參數(shù)就是當(dāng)前表單功能按鈕可以操作的表單模型?？梢詮脑搶?duì)象中取到當(dāng)前可以操作的任何數(shù)據(jù)。示例[IsImplementAttribute(true)]public IButtonEventHandler GetButtonEventHandler(VoucherButtonArgs ButtonArgs) { //保存按鈕UAP已有功能的部分修改開(kāi)發(fā) if ( == btnSaveVoucher) { return new AcceptOrderButton()。 } //審核按鈕UAP已有功能替代修改開(kāi)發(fā) if ( == btnAudit) { return new AuditButton()。 } //鎖定按鈕新增功能開(kāi)發(fā) if ( == SenDevLock) { return new LockVoucherButton()。 }}這個(gè)方法是表單功能按鈕執(zhí)行的入口，IsImplementAttribute屬性需要手工添加到方法上面。根據(jù)在UAP表單的功能管理里不同功能按鈕的ButtonKey來(lái)區(qū)別不同的功能。上述代碼的返回值類型AcceptOrderButton、AuditButton、。注意項(xiàng)1) 新增功能開(kāi)發(fā)說(shuō)明在使用UAP進(jìn)行表單開(kāi)發(fā)時(shí)，UAP已經(jīng)提供的功能都是一些公共功能，而一些表單可能需要很多特別的功能，此時(shí)就需要進(jìn)行新增功能的開(kāi)發(fā)。新增功能開(kāi)發(fā)需要開(kāi)發(fā)者要完全理解當(dāng)前功能的實(shí)際業(yè)務(wù)，并在實(shí)現(xiàn)業(yè)務(wù)的基礎(chǔ)上將對(duì)表單相關(guān)數(shù)據(jù)的修改持久化到數(shù)據(jù)庫(kù)中，持久化的操作及可能的事務(wù)控制等完全由開(kāi)發(fā)人員自己來(lái)做。示例//鎖定按鈕新增功能開(kāi)發(fā) 雙擊查看代碼 注意項(xiàng)2) UAP已有功能的修改開(kāi)發(fā)說(shuō)明UAP已經(jīng)實(shí)現(xiàn)了新增表單的保存方法，但是我們可能在使用UAP保存邏輯的基礎(chǔ)之上，在保存之前或保存之后對(duì)表單的某些數(shù)據(jù)做一定的修改。具體就是對(duì)表單模型中的某些實(shí)體屬性的值根據(jù)業(yè)務(wù)邏輯的需要做必要的修改再執(zhí)行已有的表單保存。示例雙擊查看代碼注意項(xiàng)3) UAP已有功能的替代開(kāi)發(fā)說(shuō)明UAP系統(tǒng)中已經(jīng)實(shí)現(xiàn)了一些公共功能，但這些功能并不一定適用于每種不同表單的具體情況，所以有些時(shí)候我們可能需要對(duì)UAP的已經(jīng)實(shí)現(xiàn)的功能進(jìn)行替代開(kāi)發(fā)。替代開(kāi)發(fā)分為兩種：在實(shí)現(xiàn)業(yè)務(wù)基礎(chǔ)上直接操作數(shù)據(jù)庫(kù)、調(diào)用U8已經(jīng)實(shí)現(xiàn)的該表單審核功能的API方法。直接操作數(shù)據(jù)庫(kù)：直接操作數(shù)據(jù)庫(kù)的開(kāi)發(fā)方法與下面的“新增功能開(kāi)發(fā)”的開(kāi)發(fā)方法大體一致，此處不再細(xì)述。 調(diào)用業(yè)務(wù)API：調(diào)用業(yè)務(wù)API方法避免了開(kāi)發(fā)人員必須去了解當(dāng)前功能的具體業(yè)務(wù)，降低了開(kāi)發(fā)的復(fù)雜程度，有利于快速而準(zhǔn)確的開(kāi)發(fā)。但是在使用業(yè)務(wù)API之前，其次需要知道有那些API可以使用，各個(gè)API方法的參數(shù)和返回值代表的意義，以及根據(jù)API的參數(shù)和返回值確定你的表單開(kāi)發(fā)過(guò)程的業(yè)務(wù)流程等。Net中如何調(diào)用U8中的API參照U8API資源管理器中為每個(gè)已有的API生成的調(diào)用代碼示例示例Business b = [SaleVouche_0001_E001] as Business。 if ([iswfcontrolled].Value == 1) return null。 DataSet ds = [0].。 dom = (ds, )。 U8EnvContext envContext = new U8EnvContext()。 = 。 (VoucherType, 12)。 U8ApiAddress myApiAddress = new U8ApiAddress(U8API/SaleOrder/Audit)。 U8ApiBroker broker = new U8ApiBroker(myApiAddress, envContext)。 (domHead, dom)。 if ( == ) { //審核處理 (bVerify, true)。 } else if ( == ) { //棄審處理 (bVerify, false)。 } if (!()) { //錯(cuò)誤處理 Exception apiEx = ()。 if (apiEx != null) { if (apiEx is MomSysException) { MomSysException sysEx = apiEx as MomSysException。 (系統(tǒng)異常： + )。 ()。 } else if (apiEx is MomBizException) { MomBizException bizEx = apiEx as MomBizException。 (API異常： + )。 ()。 } result = false。 } //結(jié)束本次調(diào)用，釋放API資源 ()。 }注意項(xiàng) 表單實(shí)體功能開(kāi)發(fā)(表單實(shí)體工具欄按鈕功能開(kāi)發(fā))說(shuō)明表單實(shí)體的功能開(kāi)發(fā)主要是針對(duì)表單中的某個(gè)實(shí)體的數(shù)據(jù)相應(yīng)的功能操作。IRecepit接口中的方法/// summary/// 觀察者視圖工具條按鈕單擊事件的接口/// param name=para被單擊的按鈕參數(shù)/param/// param name=businessObject所屬業(yè)務(wù)對(duì)象/param/// param name=voucherObject所屬表單對(duì)象/param/// /summaryvoid ClickToolBarButton(ToolBarActionEventArgs para, BusinessProxy businessObject, VoucherProxy voucherObject)。 這個(gè)方法是表單實(shí)體功能按鈕執(zhí)行的入口，方法的參數(shù)para代表觸發(fā)當(dāng)前方法的工具欄上的一個(gè)按鈕，businessObject代表當(dāng)前表單實(shí)體的模型對(duì)象，voucherObject代表當(dāng)前表單的模型對(duì)象。根據(jù)UAP中實(shí)體功能設(shè)計(jì)里不同的ButtonKey來(lái)區(qū)別不同的功能按鈕。從UAP給出的接口的參數(shù)中可以看出，對(duì)當(dāng)前表單實(shí)體的功能操作，不僅能訪問(wèn)當(dāng)前的表單實(shí)體模型對(duì)象，還能訪問(wèn)當(dāng)前的表單模型對(duì)象。在表單開(kāi)發(fā)過(guò)程中可以訪問(wèn)兩個(gè)模型對(duì)象中的數(shù)據(jù)。示例[IsImplementAttribute(true)]public void ClickToolBarButton(ToolBarActionEventArgs para, BusinessProxy businessObject