UAP61培訓-案例-課堂案例操作手冊-擴展開發(fā)

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