簡介面向用友UAP NC65開發(fā)新手的一份主子表單據(jù)創(chuàng)建詳解資源圍繞向?qū)ч_發(fā)流程系統(tǒng)講解主表字段控件配置、子表數(shù)據(jù)網(wǎng)格關(guān)聯(lián)、主鍵與外鍵對應、主子表聯(lián)動刷新及增刪改查實現(xiàn)尤其適合剛接觸企業(yè)級表單開發(fā)、需要快速上手UAP平臺的讀者。壓縮包共126個文件體積約4.56MB以37個Java源文件、37個Class編譯文件、16個SQL腳本為主另有properties配置、xml描述及bmf/bpf表單模型文件可配合源代碼逐項理解數(shù)據(jù)庫設計、UI布局和數(shù)據(jù)綁定邏輯。目前已有1677人學習下載。資源內(nèi)容并非孤立代碼而是將主表查詢條件設置、子表外鍵指向、保存刷新規(guī)則、測試調(diào)試與性能優(yōu)化等環(huán)節(jié)一并整理配合樣例文件可完整跑通“向?qū)芍髯颖怼钡娜鞒桃材茏鳛楹罄m(xù)NC65二次開發(fā)時的參考模板。1. 用友UAP開發(fā)NC65向?qū)е髯颖韱螕?jù)這套機制到底解決什么問題做過用友NC65二次開發(fā)的人應該都有印象UAP平臺里最讓人又愛又恨的功能就是“向?qū)Ы▎巍?。愛的是它確實能把一張主子表單據(jù)的代碼骨架、模板、按鈕、事件一次性生成出來省掉大量重復代碼恨的是如果沒搞懂底層規(guī)則向?qū)c完生成的單據(jù)不是保存報錯就是卡片打不開排查一個晚上不知道問題出在哪。這篇文章就圍繞“用友UAP開發(fā)NC65向?qū)е髯颖韱螕?jù)”完整拆一遍從建表、元數(shù)據(jù)到向?qū)伞⒛０宄跏蓟⒋a補全再把我自己踩過的坑按現(xiàn)象、原因、解決列出來。適合剛接手NC65二開的開發(fā)者也適合被主子表單據(jù)折騰過的熟手拿來對照排查。2. 建表與元數(shù)據(jù)準備主子表建模先于代碼2.1 NC65里的主子表數(shù)據(jù)模型長什么樣用友NC65的業(yè)務單據(jù)基本上都是主子表結(jié)構(gòu)。典型的場景比如采購訂單表頭存供應商、單據(jù)號、日期表體存物料、數(shù)量、價格。UAP向?qū)蓡螕?jù)前底層表必須已經(jīng)建好而且要有明確的關(guān)聯(lián)字段。主子表在數(shù)據(jù)庫層面的關(guān)系是子表通過一個外鍵字段指向主表的主鍵。NC65里主表主鍵一般叫pk_xxx子表外鍵字段一般也叫pk_xxx同名字段類型是VARCHAR2長度20或36。這個字段在生成VO和UI時會被平臺自動識別為“主子關(guān)系”的錨點。我見過最典型的翻車就是把子表外鍵字段建成了別的名字向?qū)珊笃脚_根本認不出主子關(guān)系子表數(shù)據(jù)永遠帶不上。建模前還要注意一件事NC65的表一般建議都帶上這五個標準字段——pk主鍵、ts時間戳、dr刪除標記、creator創(chuàng)建人、creationtime創(chuàng)建時間。向?qū)蒝O時會直接引用這些字段表里沒有會在保存時拋列不存在的異常。2.2 創(chuàng)建數(shù)據(jù)庫表的DDL實踐以最常用的Oracle數(shù)據(jù)庫為例我一般會寫這樣一對主子表-- 主表培訓申請單 CREATE TABLE t_train_apply ( pk_train_apply VARCHAR2(36) NOT NULL, billno VARCHAR2(30), dbilldate DATE, pk_dept VARCHAR2(20), memo VARCHAR2(200), ts TIMESTAMP, dr CHAR(1) DEFAULT 0, creator VARCHAR2(36), creationtime TIMESTAMP, CONSTRAINT pk_train_apply PRIMARY KEY (pk_train_apply) ); -- 子表培訓人員明細 CREATE TABLE t_train_apply_b ( pk_train_apply_b VARCHAR2(36) NOT NULL, pk_train_apply VARCHAR2(36) NOT NULL, rowno NUMBER(6), pk_psndoc VARCHAR2(20), train_hours NUMBER(8,2), train_result VARCHAR2(30), ts TIMESTAMP, dr CHAR(1) DEFAULT 0, creator VARCHAR2(36), creationtime TIMESTAMP, CONSTRAINT pk_train_apply_b PRIMARY KEY (pk_train_apply_b) );主表主鍵用pk_train_apply子表主鍵用pk_train_apply_b子表外鍵字段直接命名pk_train_apply與主表主鍵同名。這是NC65元數(shù)據(jù)識別主子關(guān)系的慣例建議不要改動。主鍵數(shù)據(jù)由誰生成常見做法是平臺統(tǒng)一生成“PK”字符串也可以用Oracle的sys_guid()但要注意如果用了非平臺方式生成主鍵插入前必須顯式設置VO的pk值否則會出現(xiàn)“主鍵為空”的保存異常。ts字段在向?qū)蒝O后會被代碼自動更新dr是邏輯刪除標記查詢條件里平臺會自動追加dr0所以不更新dr值的刪除模型會出問題。2.3 元數(shù)據(jù)建模的完整步驟表建好后要進UAP開發(fā)平臺的“元數(shù)據(jù)建模”功能。路徑一般是在開發(fā)平臺左側(cè)的模塊樹上找到自己的模塊右鍵新建“業(yè)務實體”。注意這里必須把主表、子表都選上然后建立“主子關(guān)聯(lián)”。操作上是這樣先在實體列表里新增主實體對應t_train_apply再新增子實體對應t_train_apply_b然后在主實體的“子實體”頁簽添加子實體并設置關(guān)聯(lián)字段pk_train_apply。保存后平臺會在后臺生成對應的實體元數(shù)據(jù)XML文件。這一步非常關(guān)鍵的點是主實體的“類型”要選“業(yè)務單據(jù)”子實體的“類型”選“業(yè)務單據(jù)子實體”。如果選錯后面向?qū)У摹靶略鰡螕?jù)”功能里根本看不到這個實體。還有一個容易被忽略的設置——子實體的“是否主子表體”屬性必須置為“是”否則即使外鍵匹配子表數(shù)據(jù)也不會被平臺當成表體處理列表界面不會出現(xiàn)表體編輯區(qū)域。2.4 權(quán)限與集團隔離設置元數(shù)據(jù)保存后緊接著要在“權(quán)限模型”里給這個單據(jù)分配功能節(jié)點權(quán)限。NC65的習慣是按集團、公司、部門等維度做數(shù)據(jù)權(quán)限隔離。如果只建了表、建了實體沒掛權(quán)限登錄后節(jié)點能看到但點新建按鈕時會提示“無權(quán)操作”。常規(guī)流程是在模塊樹下找到“功能節(jié)點”右鍵新增節(jié)點指向剛創(chuàng)建的實體然后給節(jié)點分配按鈕權(quán)限。向?qū)傻拇a里默認會有增、刪、改、查四個按鈕權(quán)限模型里對應著add、delete、update、query四個動作。這一步在向?qū)芍白鲞€是之后做沒有硬性要求但強烈建議先生成后立刻去做避免代碼跑通了但用戶點不動。3. 走向?qū)芍髯颖韱螕?jù)從新建模塊到第一版代碼跑起來3.1 在UAP開發(fā)平臺新建業(yè)務模塊打開UAP開發(fā)平臺在“模塊管理”里新建模塊。模塊編碼有講究一般用業(yè)務線縮寫加功能縮寫比如培訓管理可以叫trng_mgr模塊編碼會寫進類包名和插件配置文件里后期改起來極麻煩寧可花十分鐘想好名字。新建模塊時會要求設置“模塊依賴”。NC65平臺依賴的基礎模塊一般是uapbd基礎數(shù)據(jù)、pu采購這類。如果業(yè)務要引用人員檔案還得依賴hrhi。依賴配錯編譯時可能不報錯但運行時加載XML會報找不到類。這個是我踩過最隱蔽的坑之一因為依賴缺失的錯誤經(jīng)常在發(fā)布時才出現(xiàn)而且日志非常繞。模塊建好后開發(fā)平臺會自動生成一個插件工程目錄。打開后能看到src源碼目錄、META-INF配置文件目錄、resources資源目錄等標準布局。gif3.2 使用“新增單據(jù)”向?qū)芍髯颖韱螕?jù)模塊就緒后在模塊樹的“業(yè)務組件”上右鍵選擇“新增單據(jù)”向?qū)謳撞阶叩谝徊捷斁幋a和名稱編碼建議與業(yè)務模塊前綴一致比如trng_apply。第二步選“單據(jù)類型”。這里要選“主子表”而不是“單表”。很多第一次用的人在這里選錯后面表單體區(qū)域出不來。第三步選主實體和子實體。下拉框里列出的就是你在元數(shù)據(jù)建模里創(chuàng)建的實體。如果沒有出現(xiàn)回頭檢查實體的“類型”和“是否主子表體”屬性。第四步選擇要生成的界面類型。NC65的向?qū)J會同時生成“卡片界面”和“列表界面”卡片界面用于新增、編輯時展示單張單據(jù)列表界面用于查詢展示多條單據(jù)。建議全選省得后面手動補。第五步配置按鈕。向?qū)J生成新增、修改、刪除、保存、取消、查詢這些標準按鈕?？梢栽谶@里加“復制”“審批”等業(yè)務按鈕也可以在生成后到按鈕管理里再配。我一般選擇默認后續(xù)再改。所有配置完成后點擊生成。平臺會創(chuàng)建一套完整代碼包括主表VO類、子表VO類、單據(jù)UI類、表格UI類、業(yè)務組件類以及客戶端和服務端的插件XML。3.3 生成的代碼骨架解讀以Java為例向?qū)傻暮诵奈募笾率沁@樣一組src/ nc/vo/trng/apply/TrainApplyVO.java nc/vo/trng/apply/TrainApplyBVO.java nc/ui/trng/apply/FormAction.java nc/ui/trng/apply/ListAction.java nc/bs/trng/apply/TrainApplyBP.java nc/bs/trng/apply/TrainApplyQueryBP.java resources/ META-INF/module.xml META-INF/plugin.xmlTrainApplyVO對應主表TrainApplyBVO對應子表。打開代碼你會發(fā)現(xiàn)每個VO都繼承了平臺的基礎VO類并實現(xiàn)了IClass接口。更重要的是主VO里通常會有一個子VO數(shù)組的成員變量比如private TrainApplyBVO[] children;這個children數(shù)組就是主子表在內(nèi)存中的關(guān)聯(lián)方式。保存時平臺會把主表和所有子表一并進行更新操作前提是子VO數(shù)組正確設置。如果手動new了一個子VO但沒有set到主VO的children上子表數(shù)據(jù)不會入庫。FormAction是卡片界面的動作類它繼承平臺自帶的CardFormAction里面會有一個內(nèi)部類繼承CardEventHandler保存、刪除、取消這些事件的默認實現(xiàn)都在這個內(nèi)部類里。向?qū)傻拇a里通常只寫了空殼具體的保存邏輯要自己補。3.4 界面按鈕與事件注冊生成單據(jù)后平臺會生成一套“單據(jù)模板”XML里面定義了卡片界面顯示哪些字段、字段順序、是否只讀等。模板文件一般存放在resources目錄下文件名類似/trng/apply/FormTemplate.xml。按鈕事件注冊是在FormAction的構(gòu)造方法里完成的。向?qū)珊竽J是空的需要你把按鈕和對應的事件處理器綁定起來public FormAction() throws Exception { super(); // 注冊保存按鈕事件 String saveBtnId getMenuCode(保存); registerListener(saveBtnId, new SaveEventHandler()); // 注冊刪除按鈕事件 String delBtnId getMenuCode(刪除); registerListener(delBtnId, new DeleteEventHandler()); }這里的getMenuCode方法是從界面模板里讀取按鈕編碼按鈕編碼對不上時事件不觸發(fā)現(xiàn)象是點擊保存沒反應。排查時先去看模板XML里按鈕的id。4. 把主子單據(jù)跑通保存、刪除、審批流程的默認行為4.1 保存邏輯的實現(xiàn)方式生成的BP類里saveVO方法是一個空殼子需要往里補真正的保存邏輯。主子表單據(jù)保存時先插主表再插子表或者用平臺封裝的方法整單保存。我一般建議用平臺自帶的AggVO整單保存也就是先構(gòu)造AggregateVO把主VO和子VO數(shù)組聚合起來然后調(diào)BillSaveBPpublic Object saveVO(TrainApplyVO vo) throws Exception { // 1. 構(gòu)造主子聚合VO AggregateVO aggVO new AggregateVO(vo, new Object[]{vo.getChildren()}); // 2. 調(diào)用平臺標準保存BP BillSaveBP saveBP new BillSaveBP(); return saveBP.save(aggVO, BillTypeEnum.BILL, BillActionEnum.SAVE); }這段代碼的關(guān)鍵在AggregateVO的構(gòu)造參數(shù)。第一個參數(shù)是主VO第二個參數(shù)是一個二維結(jié)構(gòu)Object[]每個元素對應一條子表記錄數(shù)組。如果子表只有一張就是new Object[]{vo.getChildren()}。如果有多張子表這個數(shù)組要按子表順序?qū)帽热鐑蓮堊颖砭褪莕ew Object[]{bvo1Arr, bvo2Arr}。如果不走整單保存自己寫插入邏輯就要注意主表先插入然后遍歷子VO把主表主鍵set到子表的pk_train_apply字段上再批量插入。這個方案更直觀但要注意事務控制主子表都必須在同一個事務里平臺里用DbUtil.getConnection()拿連接后開setAutoCommit(false)。4.2 刪除與主子聯(lián)動的默認處理NC65的刪除分為物理刪除和邏輯刪除兩種。平臺的“刪除”按鈕默認執(zhí)行邏輯刪除也就是把主表的dr置為1子表也要跟著置為1。向?qū)傻腄eleteEventHandler里其實已經(jīng)依賴了平臺默認的刪除機制但有個前提——主VO的children必須已經(jīng)加載否則刪除時子表不會被處理。一個典型的坑是在列表界面勾選多條單據(jù)后點刪除平臺會把主表數(shù)據(jù)查出來再逐條調(diào)用刪除事件。如果子表數(shù)據(jù)量大逐條set children再刪除效率極慢。我一般在BP里重寫刪除方法直接用SQL批量更新UPDATE t_train_apply SET dr 1 WHERE pk_train_apply IN (...) UPDATE t_train_apply_b SET dr 1 WHERE pk_train_apply IN (...)這樣做速度快很多但是要自己保證事務不能用平臺的事件。還有一點因為dr置1的話查詢界面默認不會顯示如果之后要“反刪除”需要額外開發(fā)。4.3 卡片與列表模板的差異卡片模板管的是新增、編輯界面的布局列表模板管的是查詢界面的列。向?qū)珊筮@兩個模板是分開的XML文件。模板里字段的“顯示”和“編輯”屬性經(jīng)常造成困擾?？ㄆ０謇镏鞅碜侄文J都可編輯子表字段默認也可編輯但列表模板里主表字段大多只是顯示。如果列表模板里把子表字段也加進去了查詢結(jié)果里同一行會顯示子表數(shù)據(jù)容易出現(xiàn)“記錄重復”——因為主表一條記錄對應子表多條列表查詢是join子表查出的自然會出現(xiàn)多行。解決方法是列表查詢不使用join而是主子表分開查在UI層對主表結(jié)果集執(zhí)行聚合。這個邏輯向?qū)Р粫詣由梢约焊膌ist查詢的VO元數(shù)據(jù)。具體做法是在元數(shù)據(jù)建模時給主表實體加一個“聚合屬性”平臺會識別并自動完成1N查詢。4.4 審批流怎么掛到這個單據(jù)上主子表單據(jù)最常見的場景是審批控制。NC65里一個業(yè)務單據(jù)要掛審批流必須在“業(yè)務流程配置”里新建流程選擇對應的單據(jù)類型然后部署。向?qū)傻膯螕?jù)編碼就是流程配置里的“單據(jù)類型”值比如trng_apply。配置流程時審批節(jié)點、審批人、條件分支都在流程設計器里畫。掛完流程代碼層面要在保存后觸發(fā)流程啟動。常見做法是在保存成功的事件里調(diào)WorkflowStartBPWorkflowStartBP wfBP new WorkflowStartBP(); wfBP.startFlow(aggVO, trng_apply, null);這里第二個參數(shù)是流程編碼必須和流程配置里“流程類型編碼”一致不一致時流程起不來也不會報明顯錯誤日志里只顯示找不到流程類型。審批過程中如果要對單據(jù)做修改還得處理“審批中鎖定”邏輯平臺提供了BillFlowState這個工具類可以在卡片打開時判斷單據(jù)是否在審批中是的話不可編輯。5. 向?qū)ч_發(fā)常見問題排查六個反復出現(xiàn)的翻車點5.1 現(xiàn)象新建單據(jù)點保存子表數(shù)據(jù)全部丟失原因主VO和子VO沒有建立內(nèi)存關(guān)聯(lián)。最常見的是在UI層手動new了一個子VO但沒有set到主VO的children數(shù)組上。解決檢查保存按鈕對應的事件代碼確保子表數(shù)據(jù)是通過平臺的標準表格組件獲取并組裝成數(shù)組后set進主VO的。不要手動new數(shù)據(jù)集再塞參數(shù)直接用表格組件提供的getSelectedData或getData。5.2 現(xiàn)象列表界面點修改卡片能打開但子表不顯示數(shù)據(jù)原因查詢BP只查了主表沒有把子表查出來并聚合成children屬性。解決重寫查詢邏輯先查主表VO再按主表主鍵批量查子表VO然后把子表數(shù)據(jù)按主鍵分組后set到對應主VO的children數(shù)組上。如果用了元數(shù)據(jù)聚合屬性檢查元數(shù)據(jù)里有沒有把子實體掛到主實體的“聚合查詢”下。5.3 現(xiàn)象向?qū)珊缶幾g失敗報“找不到父類”原因模塊依賴沒有配置完整。向?qū)傻念惱^承的平臺基類位于其他模塊的jar包里比如nc.uap.wfm相關(guān)類在審批流模塊里如果不依賴該模塊編譯時類找不到。解決回到模塊管理界面在“依賴模塊”里把用到的功能依賴模塊全部勾上。拿不準時可以參考平臺自帶的示例模塊對比它依賴了哪些基礎模塊。5.4 現(xiàn)象保存時提示“單據(jù)號重復”原因NC65的單據(jù)號一般在保存時通過單據(jù)號規(guī)則生成。向?qū)傻拇a里默認沒有配置單據(jù)號規(guī)則但模板初始化時可能自動套用了某個公共規(guī)則。解決在“單據(jù)號管理”節(jié)點為這個單據(jù)配置獨立的編碼規(guī)則按年、月、流水號組合。還要注意流水號長度不要太小超過流水長度會跳號報錯。5.5 現(xiàn)象列表界面點查詢卡片界面的按鈕全部置灰原因功能節(jié)點的按鈕權(quán)限沒有配置。模板的按鈕和權(quán)限模型的按鈕不是同一套體系界面按鈕要真正可用必須在“權(quán)限管理”里給對應角色分配該節(jié)點的新增、修改、刪除按鈕權(quán)限。解決登錄后再“系統(tǒng)管理-角色管理-功能權(quán)限”里找到這個節(jié)點把按鈕權(quán)限勾上。建議保存一套開發(fā)用角色把所有按鈕權(quán)限打開。5.6 現(xiàn)象發(fā)布到NC65服務端后界面還是舊的原因本地開發(fā)環(huán)境改了模板XML或代碼但沒有發(fā)布到服務器或者發(fā)布時沒有勾選“資源文件”。解決發(fā)布時選擇完整發(fā)布包括class文件、XML模板和權(quán)限元數(shù)據(jù)。熱發(fā)布只更新class失效時先強制清一次客戶端緩存。NC65的客戶端緩存目錄在用戶主目錄下面刪除后重新登錄即可。6. 驗證習慣SQL回查、模板檢查和一條多年驗證的主子表檢查清單主子表單據(jù)跑通后驗證環(huán)節(jié)反而比開發(fā)環(huán)節(jié)更值得下功夫。我給自己定了一套固定的驗證順序每次都按這個走。先做數(shù)據(jù)庫回查。保存一張主子數(shù)據(jù)后用SQL檢查主表和子表是否都存在、子表外鍵是否指向主表主鍵。這條SQL是關(guān)鍵SELECT b.pk_psndoc, b.train_hours, a.billno FROM t_train_apply a LEFT JOIN t_train_apply_b b ON b.pk_train_apply a.pk_train_apply WHERE a.billno TRNG20250001;如果b表查詢?yōu)榭諉栴}多半在children組裝而不是SQL本身。再做模板檢查。打開單據(jù)模板初始化功能把主表字段、子表字段的顯示標簽、只讀屬性、必填屬性逐一過一遍。子表的必填屬性特別容易漏導致保存時主表有值子表空著也提示成功。最后做按鈕權(quán)限驗證。每次用新角色登錄把新增、修改、刪除、審批、棄審這幾個節(jié)點的權(quán)限全部測試一遍。權(quán)限配置錯誤是最慢暴露的問題因為界面能打開、數(shù)據(jù)能正常操作只有換個角色才發(fā)現(xiàn)按鈕灰了。從那以后我每次做完一個主子表單據(jù)都強制走完這個驗證流程沒有一次再被半夜的數(shù)據(jù)問題叫起來。經(jīng)驗就是UAP的向?qū)苁〉魧懘a的時間但省不掉對主子表關(guān)系、模板配置和權(quán)限模型的完整檢查。希望幫到你。本文還有配套的精品資源點擊獲取