UAP培訓(xùn)案例課堂案例操作手冊(cè)擴(kuò)展開發(fā)

1、NC-擴(kuò)展開發(fā)培訓(xùn)課程N(yùn)C-UAP61擴(kuò)展開發(fā)操作手冊(cè)開發(fā)前準(zhǔn)備本次培訓(xùn)下面只要做以下幾步，如果是新庫，后面有詳細(xì)步驟。a).用集團(tuán)管理員登錄b).按下面路徑找到用戶節(jié)點(diǎn)c.打開節(jié)點(diǎn)后查詢，找到dev用戶，選中dev點(diǎn)修改。d.修改studio中開發(fā)者信息如果是新的項(xiàng)目需要按以下幾部操作。a).系統(tǒng)管理員登陸，應(yīng)用管理平臺(tái)>應(yīng)用資產(chǎn)管理>開發(fā)者管理。添加開發(fā)者信息，確定開發(fā)層次（領(lǐng)域級(jí)，行業(yè)級(jí)，本地化級(jí)，伙伴級(jí)，客戶級(jí)），此層次是開發(fā)人員所處的曾是，如果做擴(kuò)展開發(fā)一定是紅色部分的一個(gè)。b).建立用戶，身份類型為<開發(fā)者>，身份選擇第一步添加的開發(fā)者，生效日期盡量往前，否

2、則studio中關(guān)聯(lián)時(shí)可能找不到用戶c).Studio中關(guān)聯(lián)添加的研發(fā)者，最下面填寫密碼，與用戶密碼一致，如果不填寫密碼，后面發(fā)布元數(shù)據(jù)會(huì)有問題。d).如果是進(jìn)行行業(yè)擴(kuò)展，需要修改uaphomeierpbin 中配置文件<industry_config.xml>內(nèi)容,，如果不是進(jìn)行行業(yè)擴(kuò)展，跳過該步驟。內(nèi)容如下： <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE properties SYSTEM "<properties><entry key=&qu

3、ot;belongNCIndustryCode">行業(yè)</entry></properties>該配置文件在加載元數(shù)據(jù)時(shí)會(huì)被讀取，系統(tǒng)讀取會(huì)把發(fā)布的領(lǐng)域的及該配置文件的行業(yè)的元數(shù)據(jù)元數(shù)據(jù)信息，該行業(yè)信息可以通過下面sql查詢select bi.pk_industry, from bd_industry bi order by bi.pk_industry 把查詢出來需要擴(kuò)展的行業(yè)信息，例如下面為部分查詢的結(jié)果0綜合控股集團(tuán)1流程制造業(yè)101 裝備制造 把0,1,101替換行業(yè)即可。詳細(xì)擴(kuò)展步驟實(shí)體擴(kuò)展屬性擴(kuò)展及子實(shí)體擴(kuò)展需求描述：1.客戶為

4、了更好的預(yù)測(cè)報(bào)價(jià)單可能產(chǎn)生的費(fèi)用，對(duì)報(bào)價(jià)單界面字段的要求。A).需要在在報(bào)價(jià)單單據(jù)的表頭增加標(biāo)識(shí)【是否含費(fèi)用信息】、【費(fèi)用金額】等字段， B).表體增加一個(gè)新頁簽【費(fèi)用信息】。 具體步驟：1).打開 【uap MDP】設(shè)計(jì)器,打開后的界面如下2).在左邊找到自己定義的組件。點(diǎn)擊右鍵，彈出下面的對(duì)話框，點(diǎn)擊【增量開發(fā)實(shí)體組件】3).點(diǎn)擊后的畫面如下：說明：組件所對(duì)應(yīng)的元數(shù)據(jù)文件，在studio的幫助文檔找到，如果不想找的到幫助文檔中找可以通過下面的語句查詢出來，但還需要自己到home中查找具體的路徑，此sql只是查到對(duì)應(yīng)的元數(shù)據(jù)文件名稱。-查組件的名稱select t.ownmodule 模塊,

5、 t.displayname 實(shí)體名稱, bmf文件名,space 模塊 from md_component t where t.displayname like '%報(bào)價(jià)單%' order by ts desc 還需要到uaphomemodulesXX模塊METADATA 的路徑下查找元數(shù)據(jù)模型在METADATA中的具體的位置，在上圖查找時(shí)使用。4). 找到對(duì)應(yīng)的元數(shù)據(jù),確定后會(huì)在你選擇的組件下生成一個(gè)元數(shù)據(jù)模型。5).點(diǎn)擊確定后會(huì)有如下圖：6).雙擊該模型，則會(huì)在右側(cè)出現(xiàn)7).點(diǎn)擊“報(bào)價(jià)單表頭”，在下面添加屬性，屬性名稱必須以點(diǎn)擊添加時(shí)以默認(rèn)字符為結(jié)

6、尾：增加的屬性見下表：對(duì)應(yīng)編碼字段名稱類型bcludefee是否含費(fèi)用信息布爾ntotalfeemny費(fèi)用總金額數(shù)字nfeenote費(fèi)用說明字符pk_salequotation消費(fèi)信息源屬性Array注意：a).新增屬性的訪問策略為”nc.md.model.access.NCBeanAccessor”。 b).屬性擴(kuò)展時(shí)，增加的屬性必須填寫擴(kuò)展表，此處填寫擴(kuò)展表ext_table_h_301。消費(fèi)信息源屬性pk_salequotation擴(kuò)展表一列不填寫 c).動(dòng)態(tài)屬性表示勾上，如下圖 8).增加費(fèi)用信息子實(shí)體方法同標(biāo)準(zhǔn)單據(jù)子實(shí)體(增加屬性，組合主實(shí)體等)。字段如下：對(duì)應(yīng)編碼字段名稱類型pk_

7、ext_b子表主鍵字符icvexpensepsn報(bào)銷人參照用戶dfeedate費(fèi)用日期日期dexpensedate報(bào)銷日期日期ndetailfeemny費(fèi)用金額數(shù)字vfeeaddress地址字符vnote備注字符vbdef1自定義項(xiàng)1字符vbdef2自定義項(xiàng)2字符注意：A).所有屬性勾上動(dòng)態(tài)屬性 B).新增子實(shí)體數(shù)據(jù)訪問類型：NCVOC).類名為：nc.vo.extend.entity.ExtBVO_301，類名需要以所屬層次及機(jī)構(gòu)編碼或者行業(yè)編碼結(jié)尾，如果不正確會(huì)有提示D).新增子實(shí)體名稱,默認(rèn)表名 此處設(shè)置為：ext_table_b_301 ，后綴命名同上。 顯示名稱：費(fèi)用信息E).子實(shí)體

8、擴(kuò)展時(shí)每個(gè)屬性的名稱不以后綴結(jié)尾，并且每個(gè)屬性的擴(kuò)展表不填寫9). 啟動(dòng)中間件，點(diǎn)右鍵選擇【發(fā)布元數(shù)據(jù)】。10).選中子實(shí)體,點(diǎn)擊右鍵生成JAVA源代碼11).點(diǎn)右鍵選擇【生成建庫腳本并執(zhí)行】。12).重啟客戶段，清除緩存,否則生成單據(jù)模版時(shí)看不到新加的子實(shí)體13).生成單據(jù)模板a).新增單據(jù)模板，新增模板的頁簽編碼需要與標(biāo)準(zhǔn)產(chǎn)品模板編碼一樣，因標(biāo)準(zhǔn)產(chǎn)品的代碼中可能用到頁簽編碼。 此處表頭增加一個(gè)新分組，編碼為headExtTab 名稱為：費(fèi)用信息b).新擴(kuò)展的頁簽編碼使用:bodyExtTab,頁簽名稱：費(fèi)用信息，按下圖設(shè)置 d).新增的模版，需要在增加新的單據(jù)模板后需要到【功能節(jié)點(diǎn)默認(rèn)模板

9、設(shè)置】節(jié)點(diǎn)進(jìn)行分配，這樣在集團(tuán)初始化時(shí)系統(tǒng)會(huì)按照資產(chǎn)層次及國(guó)家地區(qū)的優(yōu)先級(jí)把該模版分配初始化的集團(tuán)。如下圖：前臺(tái)擴(kuò)展說明：基于pubapp提供的擴(kuò)展方式，入口類為：nc.ui.pubapp.uif2app.ToftPanelAdaptorEx的擴(kuò)展按鈕擴(kuò)展替換按鈕擴(kuò)展需求描述：界面修改按鈕要求A).每個(gè)報(bào)價(jià)單能管理對(duì)應(yīng)的文檔，客戶要要把卡片界面的刷新按鈕替換為【文檔管理】按鈕，用與單個(gè)文檔操作（上傳，下載等操作）。具體步驟：1).增加新的文檔管理按鈕 nc.ui.extend.pubapp.action.ExtDocManageAction，繼承平臺(tái)提供的文檔管理按鈕，重寫可用性方法。2).添

10、加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替換 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"&g

11、t;<property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文檔管理 按鈕 -&

12、gt;<bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppModel" /></bean></beans>3).注冊(cè)擴(kuò)展配置文件，在功能注冊(cè)節(jié)點(diǎn)注冊(cè)，非行業(yè)擴(kuò)展的可增加參數(shù)名稱為:PluginBeanConfigFilePath, 也可使用: PluginBeanConfigFilePa

13、th_開始后面加字符行業(yè)擴(kuò)展參數(shù)名稱:PluginBeanConfigFilePath_Industry行業(yè)編碼_CountryZone本地化編碼，實(shí)現(xiàn)不同集團(tuán)不同行業(yè)加載不同的行業(yè)的擴(kuò)展配置文件。 插入按鈕擴(kuò)展需求描述：界面修改按鈕要求B).要求在編輯報(bào)價(jià)單時(shí)能批量選擇附件。具體步驟：1).增加按鈕:nc.ui.extend.pubapp.action.ChooseFileAction2).添加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "

14、-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替換 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><property name="actionContainer" ref="xxxxx" /><property name="ac

15、tionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文檔管理 按鈕 -><bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction&

16、quot;><property name="model" ref="manageAppModel" /></bean><!插入按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name="actionContainer" ref=" xxxx " /><property name="actionType"

17、value=" xxxx " /><property name="target" ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref=" xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.ext

18、end.pubapp.action.ChooseFileAction"><property name="model" ref="ManageAppModel" /></bean></beans>3).注冊(cè)擴(kuò)展配置文件，注冊(cè)規(guī)則同替換按鈕擴(kuò)展 攔截按鈕擴(kuò)展需求描述：界面修改按鈕要求C)點(diǎn)擊【保存】按鈕后，先把數(shù)據(jù)保存，再把選擇的文件上傳到服務(wù)器作為報(bào)價(jià)單的附件。具體步驟：1).增加保存攔截?cái)U(kuò)展類extend.ui.so.m30.action.SaveActionInterceptor2). 添加配置文件&

19、lt;?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替換 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><

20、property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文檔管理 按鈕 -><

21、;bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppModel" /></bean><!插入按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name=&q

22、uot;actionContainer" ref=" xxxx " /><property name="actionType" value=" xxxx " /><property name="target" ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref="

23、; xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.extend.pubapp.action.ChooseFileAction"><property name="model" ref="ManageAppModel" /></bean><!- 攔截 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ActionIn

24、terceptorInfo"><property name="target" ref="xxxx" /><property name="interceptor" ref="xxxxx" /></bean><bean id="interceptorForFile" class="nc.ui.extend.pubapp.action.SaveInterceptorForFile"><property name=

25、"billForm" ref="billFormEditor" /><property name="chooseAction" ref="chooseAction" /></bean></beans>nc.ui.pubapp.uif2app.eventAppUiStateChangeEvent.javaUI狀態(tài)改變OrgChangedEvent.java組織改變PubAppEvent.java事件基類nc.ui.pubapp.uif2app.event.cardCardBo

26、dyAfterEditEvent.java卡片表體編輯后CardBodyAfterRowEditEvent.java卡片表體行編輯后CardBodyAfterSortEvent.java卡片表體排序后CardBodyBeforeBatchEditEvent.java卡片表體批編輯前CardBodyBeforeEditEvent.java卡片表體編輯前CardBodyBeforeSortEvent.java卡片表體排序前CardBodyMenuActionEvent.java卡片表體菜單點(diǎn)擊CardBodyRowChangedEvent.java卡片表體行選擇改變CardBodyRowEditE

27、vent.java卡片表體行編輯后CardBodyTabChangedEvent.java卡片表體頁簽改變CardBodyTotalEvent.java卡片表體匯總計(jì)算CardHeadTailAfterEditEvent.java卡片表頭表尾編輯后CardHeadTailBeforeEditEvent.java卡片表頭表尾編輯前3).注冊(cè)擴(kuò)展配置文件，注冊(cè)規(guī)則同替換按鈕擴(kuò)展UI事件擴(kuò)展需求描述：新增表頭屬性及頁簽后客戶要求的界面邏輯控制：A).【是否含費(fèi)用信息】如果選中則：【費(fèi)用信息】頁簽及表頭的【費(fèi)用說明】能編輯且【費(fèi)用信息】頁簽不能為空；如果取消則清空表頭的【費(fèi)用說明】并且不能編輯，保存時(shí)

28、把【費(fèi)用信息】的填寫信息清空。B).表頭擴(kuò)展的【費(fèi)用總金額】為【費(fèi)用信息】頁簽表體的費(fèi)用金額合計(jì)。 C).【費(fèi)用信息】頁簽的【費(fèi)用日期】不能早于【報(bào)銷日期】。具體步驟：1增加類：a).增加表頭編輯后處理事件：nc.ui.extend.pubapp.editor.head.HeadAfterEditDistributeb).增加表體編輯前處理事件：nc.ui.extend.pubapp.editor.body.BodyBeforeEditDistributec).增加表體編輯后處理事件：nc.ui.extend.pubapp.editor.body.BodyAfterEditDistribute

29、d).增加卡片表體合計(jì)事件：nc.ui.extend.pubapp.editor.body.CalculatorHeadFeeDistribute 這些類都實(shí)現(xiàn)了接口：nc.ui.pubapp.uif2app.event.IAppEventHandler2). 添加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/

30、spring-beans.dtd"><beans><!- 替換 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="

31、target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文檔管理 按鈕 -><bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppMod

32、el" /></bean><!插入按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name="actionContainer" ref=" xxxx " /><property name="actionType" value=" xxxx " /><property name="target"

33、ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref=" xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.extend.pubapp.action.ChooseFileAction"><property name="

34、;model" ref="ManageAppModel" /></bean><!- 攔截 按鈕配置 -><bean class="nc.ui.pubapp.plugin.action.ActionInterceptorInfo"><property name="target" ref="xxxx" /><property name="interceptor" ref="xxxxx" /></be

35、an><bean id="interceptorForFile" class="nc.ui.extend.pubapp.action.SaveInterceptorForFile"><property name="billForm" ref="billFormEditor" /><property name="chooseAction" ref="chooseAction" /></bean><!- UI事件監(jiān)聽 -

36、><bean id="ExEventHandlerMediator" class="nc.ui.pubapp.uif2app.model.AppEventHandlerMediator"><property name="model" ref="manageAppModel" /><property name="handlerGroup"><list><!- 表頭編輯后事件監(jiān)聽 -><bean class="nc.u

37、i.pubapp.uif2app.event.EventHandlerGroup"><property name="event"value="xxxxx" /><property name="handler"> <bean class="xxxxx" /></property></bean><!- 表體編輯前事件監(jiān)聽 -><bean class="nc.ui.pubapp.uif2app.event.EventH

38、andlerGroup"><property name="event"value="xxxxx" /><property name="handler"><bean class="xxxxx" /></property></bean><!- 表體編輯后事件監(jiān)聽 -><bean class="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><prope

39、rty name="event"value="xxxxx" /><property name="handler"><bean class="xxxx" /></property></bean><!卡片合計(jì)事件監(jiān)聽 -><bean class="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><property name="event"value=&q

40、uot;xxxxx" /><property name="handler"><bean class="xxxxx" /></property></bean></list></property></bean></beans>3).注冊(cè)擴(kuò)展配置文件，注冊(cè)規(guī)則同插入按鈕擴(kuò)展。后臺(tái)擴(kuò)展功能描述：報(bào)價(jià)審核要求：A).點(diǎn)擊審核按鈕后需要時(shí)需要校驗(yàn)表頭新擴(kuò)展的【費(fèi)用合計(jì)金額】與表頭原有的【總金額合計(jì)】的大小，如果【費(fèi)用合計(jì)金額】大于【總金額合計(jì)】，則表頭費(fèi)用說明必須填寫。B).報(bào)價(jià)單審核通過后，如果存在報(bào)銷人員怎在系統(tǒng)中給相關(guān)報(bào)銷人“發(fā)送通知消息”。具體步驟：1增加類：1).增加類nc.bs.extend.b