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

-.z.NC-UAP61擴(kuò)展開發(fā)操作手冊(cè)開發(fā)前準(zhǔn)備本次培訓(xùn)下面只要做以下幾步，如果是新庫(kù)，后面有詳細(xì)步驟。a).用集團(tuán)管理員登錄b).按下面路徑找到用戶節(jié)點(diǎn)c.翻開節(jié)點(diǎn)后查詢，找到dev用戶，選中dev點(diǎn)修改。d.修改studio中開發(fā)者信息如果是新的工程需要按以下幾部操作。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ā)者，生效日期盡量往前，否則studio中關(guān)聯(lián)時(shí)可能找不到用戶c). Studio中關(guān)聯(lián)添加的研發(fā)者，最下面填寫密碼，與用戶密碼一致，如果不填寫密碼，后面發(fā)布元數(shù)據(jù)會(huì)有問(wèn)題。d). 如果是進(jìn)展行業(yè)擴(kuò)展，需要修改uaphome\ierp\bin中配置文件<industry_config.*ml>內(nèi)容,，如果不是進(jìn)展行業(yè)擴(kuò)展，跳過(guò)該步驟。內(nèi)容如下：<"*mlversion="1.0"encoding="UTF-8""><!DOCTYPEpropertiesSYSTEM"java.sun./dtd/properties.dtd"><properties><entrykey="belongNCIndustryCode">行業(yè)</entry></properties>該配置文件在加載元數(shù)據(jù)時(shí)會(huì)被讀取，系統(tǒng)讀取會(huì)把發(fā)布的領(lǐng)域的及該配置文件的行業(yè)的元數(shù)據(jù)元數(shù)據(jù)信息，該行業(yè)信息可以通過(guò)下面sql查詢selectbi.pk_industry,frombd_industrybiorderbybi.pk_industry把查詢出來(lái)需要擴(kuò)展的行業(yè)信息，例如下面為局部查詢的結(jié)果0 綜合控股集團(tuán) 1 流程制造業(yè) 101 裝備制造把’0’,’1’,’101’替換行業(yè)即可。詳細(xì)擴(kuò)展步驟實(shí)體擴(kuò)展屬性擴(kuò)展及子實(shí)體擴(kuò)展需求描述：1.客戶為了更好的預(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è)新頁(yè)簽【費(fèi)用信息】。具體步驟：1).翻開【uapMDP】設(shè)計(jì)器,翻開后的界面如下2).在左邊找到自己定義的組件。點(diǎn)擊右鍵，彈出下面的對(duì)話框，點(diǎn)擊【增量開發(fā)實(shí)體組件】3).點(diǎn)擊后的畫面如下：說(shuō)明：組件所對(duì)應(yīng)的元數(shù)據(jù)文件，在studio的幫助文檔找到，如果不想找的到幫助文檔中找可以通過(guò)下面的語(yǔ)句查詢出來(lái)，但還需要自己到home中查找具體的路徑，此sql只是查到對(duì)應(yīng)的元數(shù)據(jù)文件名稱。--查組件的名稱selectt.ownmodule模塊,t.displayname實(shí)體名稱,bmf文件名,space模塊frommd_ponenttwheret.displaynamelike'%報(bào)價(jià)單%'orderbytsdesc還需要到uaphome\modules\**模塊\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é)尾：增加的屬性見下表：對(duì)應(yīng)編碼字段名稱類型bcludefee是否含費(fèi)用信息布爾ntotalfeemny費(fèi)用總金額數(shù)字nfeenote費(fèi)用說(shuō)明字符pk_salequotation消費(fèi)信息源屬性Array注意：a).新增屬性的訪問(wèn)策略為〞nc.md.model.access.NCBeanAccessor〞。b).屬性擴(kuò)展時(shí)，增加的屬性必須填寫擴(kuò)展表，此處填寫擴(kuò)展表e*t_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_e*t_b子表主鍵字符icve*pensepsn報(bào)銷人參照用戶dfeedate費(fèi)用日期日期de*pensedate報(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ù)訪問(wèn)類型：NCVOC).類名為：，類名需要以所屬層次及機(jī)構(gòu)編碼或者行業(yè)編碼結(jié)尾，如果不正確會(huì)有提示D).新增子實(shí)體名稱,默認(rèn)表名此處設(shè)置為：e*t_table_b_301，后綴命名同上。顯示名稱：費(fèi)用信息E).子實(shí)體擴(kuò)展時(shí)每個(gè)屬性的名稱不以后綴結(jié)尾，并且每個(gè)屬性的擴(kuò)展表不填寫9).啟動(dòng)中間件，點(diǎn)右鍵選擇【發(fā)布元數(shù)據(jù)】。10).選中子實(shí)體,點(diǎn)擊右鍵生成JAVA源代碼11).點(diǎn)右鍵選擇【生成建庫(kù)腳本并執(zhí)行】。12).重啟客戶段，去除緩存,否則生成單據(jù)模版時(shí)看不到新加的子實(shí)體13).生成單據(jù)模板a).新增單據(jù)模板，新增模板的頁(yè)簽編碼需要與標(biāo)準(zhǔn)產(chǎn)品模板編碼一樣，因標(biāo)準(zhǔn)產(chǎn)品的代碼中可能用到頁(yè)簽編碼。此處表頭增加一個(gè)新分組，編碼為headE*tTab名稱為：費(fèi)用信息b).新擴(kuò)展的頁(yè)簽編碼使用:bodyE*tTab,頁(yè)簽名稱：費(fèi)用信息，按下列圖設(shè)置d).新增的模版，需要在增加新的單據(jù)模板后需要到【功能節(jié)點(diǎn)默認(rèn)模板設(shè)置】節(jié)點(diǎn)進(jìn)展分配，這樣在集團(tuán)初始化時(shí)系統(tǒng)會(huì)按照資產(chǎn)層次及國(guó)家地區(qū)的優(yōu)先級(jí)把該模版分配初始化的集團(tuán)。如下列圖：前臺(tái)擴(kuò)展說(shuō)明：基于pubapp提供的擴(kuò)展方式，入口類為：nc.ui.pubapp.uif2app.ToftPanelAdaptorE*的擴(kuò)展按鈕擴(kuò)展替換按鈕擴(kuò)展需求描述：界面修改按鈕要求A).每個(gè)報(bào)價(jià)單能管理對(duì)應(yīng)的文檔，客戶要要把卡片界面的刷新按鈕替換為【文檔管理】按鈕，用與單個(gè)文檔操作〔上傳，下載等操作〕。具體步驟：1).增加新的文檔管理按鈕，繼承平臺(tái)提供的文檔管理按鈕，重寫可用性方法。2).添加配置文件<"*mlversion="1.0"encoding="UTF-8""><!DOCTYPEbeansPUBLIC"-//SPRING//DTDBEAN//EN""./dtd/spring-beans.dtd"><beans><!--替換按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ReplaceActionInfo"> <propertyname="actionContainer"ref="*****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="action"ref="****"/> </bean> <!—文檔管理按鈕--> <beanid="docManageAction"class=""> <propertyname="model"ref="manageAppModel"/> </bean></beans>3).注冊(cè)擴(kuò)展配置文件，在功能注冊(cè)節(jié)點(diǎn)注冊(cè)，非行業(yè)擴(kuò)展的可增加參數(shù)名稱為:PluginBeanConfigFilePath,也可使用:PluginBeanConfigFilePath_開場(chǎng)后面加字符行業(yè)擴(kuò)展參數(shù)名稱:PluginBeanConfigFilePath_Industry行業(yè)編碼_CountryZone本地化編碼，實(shí)現(xiàn)不同集團(tuán)不同行業(yè)加載不同的行業(yè)的擴(kuò)展配置文件。插入按鈕擴(kuò)展需求描述：界面修改按鈕要求B).要求在編輯報(bào)價(jià)單時(shí)能批量選擇附件。具體步驟：1).增加按鈕:2).添加配置文件<"*mlversion="1.0"encoding="UTF-8""><!DOCTYPEbeansPUBLIC"-//SPRING//DTDBEAN//EN""./dtd/spring-beans.dtd"><beans><!--替換按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ReplaceActionInfo"> <propertyname="actionContainer"ref="*****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="action"ref="****"/> </bean> <!—文檔管理按鈕--> <beanid="docManageAction"class=""> <propertyname="model"ref="manageAppModel"/> </bean><!—插入按鈕配置--><beanclass="nc.ui.pubapp.plugin.action.InsertActionInfo"> <propertyname="actionContainer"ref="****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="pos"value="****"/> <propertyname="action"ref="****"/> </bean> <beanid="chooseFileAction"class=""> <propertyname="model"ref="ManageAppModel"/> </bean></beans>3).注冊(cè)擴(kuò)展配置文件，注冊(cè)規(guī)則同替換按鈕擴(kuò)展攔截按鈕擴(kuò)展需求描述：界面修改按鈕要求C)點(diǎn)擊【保存】按鈕后，先把數(shù)據(jù)保存，再把選擇的文件上傳到效勞器作為報(bào)價(jià)單的附件。具體步驟：2).添加配置文件<"*mlversion="1.0"encoding="UTF-8""><!DOCTYPEbeansPUBLIC"-//SPRING//DTDBEAN//EN""./dtd/spring-beans.dtd"><beans><!--替換按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ReplaceActionInfo"> <propertyname="actionContainer"ref="*****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="action"ref="****"/> </bean> <!—文檔管理按鈕--> <beanid="docManageAction"class=""> <propertyname="model"ref="manageAppModel"/> </bean><!—插入按鈕配置--><beanclass="nc.ui.pubapp.plugin.action.InsertActionInfo"> <propertyname="actionContainer"ref="****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="pos"value="****"/> <propertyname="action"ref="****"/> </bean> <beanid="chooseFileAction"class=""> <propertyname="model"ref="ManageAppModel"/> </bean><!--攔截按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ActionInterceptorInfo"><propertyname="target"ref="****"/> <propertyname="interceptor"ref="*****"/> </bean> <beanid="interceptorForFile" class=""> <propertyname="billForm"ref="billFormEditor"/> <propertyname="chooseAction"ref="chooseAction"/> </bean></beans>AppUiStateChangeEvent.javaUI狀態(tài)改變OrgChangedEvent.java組織改變PubAppEvent.java事件基類CardBodyAfterEditEvent.java卡片表體編輯后CardBodyAfterRowEditEvent.java卡片表體行編輯后CardBodyAfterSortEvent.java卡片表體排序后CardBodyBeforeBatchEditEvent.java卡片表體批編輯前CardBodyBeforeEditEvent.java卡片表體編輯前CardBodyBeforeSortEvent.java卡片表體排序前CardBodyMenuActionEvent.java卡片表體菜單點(diǎn)擊CardBodyRowChangedEvent.java卡片表體行選擇改變CardBodyRowEditEvent.java卡片表體行編輯后CardBodyTabChangedEvent.java卡片表體頁(yè)簽改變CardBodyTotalEvent.java卡片表體匯總計(jì)算CardHeadTailAfterEditEvent.java卡片表頭表尾編輯后CardHeadTailBeforeEditEvent.java卡片表頭表尾編輯前3).注冊(cè)擴(kuò)展配置文件，注冊(cè)規(guī)則同替換按鈕擴(kuò)展UI事件擴(kuò)展需求描述：新增表頭屬性及頁(yè)簽后客戶要求的界面邏輯控制：A).【是否含費(fèi)用信息】如果選中則：【費(fèi)用信息】頁(yè)簽及表頭的【費(fèi)用說(shuō)明】能編輯且【費(fèi)用信息】頁(yè)簽不能為空；如果取消則清空表頭的【費(fèi)用說(shuō)明】并且不能編輯，保存時(shí)把【費(fèi)用信息】的填寫信息清空。B).表頭擴(kuò)展的【費(fèi)用總金額】為【費(fèi)用信息】頁(yè)簽表體的費(fèi)用金額合計(jì)。C).【費(fèi)用信息】頁(yè)簽的【費(fèi)用日期】不能早于【報(bào)銷日期】。具體步驟：1．增加類：a).增加表頭編輯后處理事件：b).增加表體編輯前處理事件：c).增加表體編輯后處理事件：d).增加卡片表體合計(jì)事件：這些類都實(shí)現(xiàn)了接口：2).添加配置文件<"*mlversion="1.0"encoding="UTF-8""><!DOCTYPEbeansPUBLIC"-//SPRING//DTDBEAN//EN""./dtd/spring-beans.dtd"><beans><!--替換按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ReplaceActionInfo"> <propertyname="actionContainer"ref="*****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="action"ref="****"/> </bean> <!—文檔管理按鈕--> <beanid="docManageAction"class=""> <propertyname="model"ref="manageAppModel"/> </bean><!—插入按鈕配置--><beanclass="nc.ui.pubapp.plugin.action.InsertActionInfo"> <propertyname="actionContainer"ref="****"/> <propertyname="actionType"value="****"/> <propertyname="target"ref="****"/> <propertyname="pos"value="****"/> <propertyname="action"ref="****"/> </bean> <beanid="chooseFileAction"class=""> <propertyname="model"ref="ManageAppModel"/> </bean><!--攔截按鈕配置--> <beanclass="nc.ui.pubapp.plugin.action.ActionInterceptorInfo"><propertyname="target"ref="****"/> <propertyname="interceptor"ref="*****"/> </bean> <beanid="interceptorForFile" class=""> <propertyname="billForm"ref="billFormEditor"/> <propertyname="chooseAction"ref="chooseAction"/> </bean><!--UI事件監(jiān)聽--> <beanid="E*EventHandlerMediator" class="nc.ui.pubapp.uif2app.model.AppEventHandlerMediator"> <propertyname="model"ref="manageAppModel"/> <propertyname="handlerGroup"> <list> <!--表頭編輯后事件監(jiān)聽--><beanclass="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><propertyname="event"value="*****"/><propertyname="handler"><beanclass="*****"/></property></bean> <!--表體編輯前事件監(jiān)聽--><beanclass="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><propertyname="event"value="*****"/><propertyname="handler"><beanclass="*****"/></property></bean> <!--表體編輯后事件監(jiān)聽--><beanclass="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><propertyname="event"value="*****"/><propertyname="handler"><beanclass="****"/></property></bean> <!—卡片合計(jì)事件監(jiān)聽--><beanclass="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><propertyname="event"value="*****"/><propertyname="handler"><beanclass="*****"/></prope