BOS架構(gòu)插件業(yè)務(wù)開發(fā)

1、 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司金蝶軟件（中國）有限公司K/3BOS開發(fā)部(高玉宏)11/5/20211P2 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n本課程關(guān)注的問題nBOS概念及元數(shù)據(jù)模型結(jié)構(gòu)nBOS業(yè)務(wù)應(yīng)用開發(fā)n插件原理在BOS中的應(yīng)用n本課程適宜對象n本課程主要對象K3內(nèi)部開發(fā)人員n基于BOS應(yīng)用開發(fā)的二次開發(fā)人員n對BOS核心原理有非常高的興趣n經(jīng)過了BOS設(shè)計，插件編碼培訓(xùn)P3 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 簡介nK/3 BOS 架構(gòu)nK/3 BOS 業(yè)務(wù)應(yīng)用開發(fā)nK/3 BOS 插件原理nQAP4 版

2、權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS是什么？nK/3 Business Operation System, K/3 業(yè)務(wù)操作系統(tǒng)n使用先進、開放、可伸縮的技術(shù)體系n面向企業(yè)快速成長的業(yè)務(wù)需求n協(xié)同合作伙伴拓展管理業(yè)務(wù)n通過科學(xué)的工具和流程對企業(yè)建模進行全程監(jiān)控n是金蝶BOS產(chǎn)品家族中的一員n專門針對金蝶K/3系列產(chǎn)品n自主研發(fā)的新一代技術(shù)平臺n用以解決K/3系統(tǒng)日益增加的應(yīng)用復(fù)雜度和快速開發(fā)與實施之間的矛盾n集成了K/3產(chǎn)品底層的相關(guān)服務(wù)n讓客戶在不需要任何編程知識的前提下，快速的定制新系統(tǒng),功能P5 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/

3、3 BOS用以解決什么問題?n快速開發(fā)與實施n快速開發(fā)、快速實施、快速應(yīng)用n為客戶提供與K/3集成性、可升級性、高效性、簡單易用性的開發(fā)工具n客戶化開發(fā)平滑升級nK/3 BOS的業(yè)務(wù)模型都存儲與數(shù)據(jù)庫中nK/3 升級新版本后, 客戶開發(fā)也一起平滑升級n業(yè)務(wù)模型可以直接引出為SQL文件n客戶化開發(fā)成果發(fā)布變的容易和可行P6 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nTo SeeP7 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nBOS簡介nK/3 BOS 架構(gòu)nK/3 BOS 業(yè)務(wù)應(yīng)用開發(fā)nK/3 BOS 插件nQAP8 版權(quán)所有 1993-2009 金蝶軟件(中國)有限

4、公司nK/3 BOS 技術(shù)架構(gòu)P9 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 技術(shù)框架示意圖P10 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 業(yè)務(wù)對象P11 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 業(yè)務(wù)對象屬性結(jié)構(gòu)P12 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 業(yè)務(wù)對象的屬性存儲P13 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 相關(guān)數(shù)據(jù)表結(jié)構(gòu)描述n其他表結(jié)構(gòu)庫表名稱描述ICClassType；ICClassTypeEntry業(yè)務(wù)對象模板信息；

5、業(yè)務(wù)對象分錄模板信息業(yè)務(wù)對象模板信息；業(yè)務(wù)對象分錄模板信息ICClassTableInfo業(yè)務(wù)對像字段模板描述表業(yè)務(wù)對像字段模板描述表ICClassAction；ICClassActionList; ICClassActionParamsAction 的描述表；業(yè)務(wù)對象配置的的描述表；業(yè)務(wù)對象配置的Action信息；擴展信息；擴展Action參數(shù)參數(shù)ICClassLink; ICClassLinkEntry單據(jù)轉(zhuǎn)換流程主表；單據(jù)轉(zhuǎn)換流程分錄表單據(jù)轉(zhuǎn)換流程主表；單據(jù)轉(zhuǎn)換流程分錄表ICClassLinkCommit單據(jù)轉(zhuǎn)換流程鉤稽表單據(jù)轉(zhuǎn)換流程鉤稽表ICClassCondition過濾條件過濾條件

6、ICClassProfile用戶設(shè)置信息的保存用戶設(shè)置信息的保存ICClassProfileEntry用戶設(shè)置信息保存的分錄表用戶設(shè)置信息保存的分錄表ICClassMutexT_SysFunction 系統(tǒng)功能表;ICClassMutex 網(wǎng)路控制對象表;T_Mutex 功能互斥表ICClassBillAction業(yè)務(wù)對象操作表ICClassConstsBOS常量表ICClassCtlBOS單據(jù)通用控件字段模板表P14 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nBOS簡介nK/3 BOS 架構(gòu)nK/3 BOS 業(yè)務(wù)應(yīng)用開發(fā)nK/3 BOS 插件nQAP15 版權(quán)所有 1993-2

7、009 金蝶軟件(中國)有限公司nK/3 BOS 業(yè)務(wù)開發(fā)流程P16 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n典型業(yè)務(wù)應(yīng)用開發(fā)n單據(jù)轉(zhuǎn)換流程n關(guān)聯(lián)關(guān)系n復(fù)制n鉤稽 n關(guān)聯(lián)內(nèi)碼存儲n強制鉤稽n關(guān)聯(lián)內(nèi)碼存儲n關(guān)聯(lián)復(fù)制n關(guān)聯(lián)內(nèi)碼來源n關(guān)聯(lián)內(nèi)碼存儲P17 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n單據(jù)轉(zhuǎn)換流程n元數(shù)據(jù)模型n注：n目標單據(jù)為工業(yè)單據(jù)， 采用老單選單模板n目標單據(jù)為BOS單據(jù)，采用BOS選單模板n選單條件：ICClassLink. FCodition字段？選單模板選單模板數(shù)據(jù)表數(shù)據(jù)表描述描述工業(yè)單據(jù)工業(yè)單據(jù)ICClassLinkICClassLink記錄選單關(guān)

8、聯(lián)關(guān)系ICSelBillsICSelBills記錄選單關(guān)聯(lián)明細ICTableRelationICTableRelation記錄選單表關(guān)系ICWriteBackTemplateICWriteBackTemplate記錄選單反寫字段信息BOSBOS單據(jù)單據(jù)ICClassLinkICClassLink記錄選單關(guān)聯(lián)關(guān)系ICCLassLinkEntryICCLassLinkEntry記錄選單關(guān)聯(lián)明細ICClassLinkCommitICClassLinkCommit記錄選單反寫字段信息P18 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n單據(jù)轉(zhuǎn)換流程n流程設(shè)計P19 版權(quán)所有 1993-200

9、9 金蝶軟件(中國)有限公司n單據(jù)轉(zhuǎn)換流程n跨級反寫n流程不要啟用n源單內(nèi)碼類字段要傳遞至目標單據(jù)n跨級攜帶n選單值更新Action定義n源單內(nèi)碼類字段要傳遞至目標單據(jù)n支持源單計算列攜帶nICClassLinkEntry. FAfterFormulan注意：n跨級反寫、跨級攜帶至少需要2套以上的源單內(nèi)碼類字段n關(guān)于計算列： FAfterFormula = “CalculateFQty3+FQty4”，可手工修改，但必須滿足字段來源于選單RecordSetP20 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n單據(jù)轉(zhuǎn)換流程n一些重要字段說明nFConnectFlg vs FChildr

10、ennFUsePage vs FDefaultPagenFRemark 選單標識nFDefineType（ICClassActionList）選單值更新事件n選單插件事件nAfterSelBill 事件nAfterSelBillBeforeFillData 事件nBeforeSelBills 事件nBeforeSelBillShowFilter 事件nAfterSelBillBeforeDoAction事件nAfterSelBillAfterDoAction事件P21 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n單據(jù)轉(zhuǎn)換流程n溫馨提示：n當(dāng)BOS單據(jù)與工業(yè)單據(jù)關(guān)聯(lián)目標單單據(jù)體上的物

11、料、計量單位、n 數(shù)量、基本計量單位數(shù)量必須有對應(yīng)的源單字段，否則關(guān)聯(lián)時可能會出現(xiàn)錯誤。n控制字段、扣減字段、關(guān)閉字段必須位于同一單據(jù)體、頭上。n關(guān)聯(lián)內(nèi)碼來源：關(guān)聯(lián)復(fù)制關(guān)系時有效，指源單內(nèi)碼的來源。n單據(jù)頭？n單據(jù)體？n關(guān)聯(lián)內(nèi)碼存儲：關(guān)聯(lián)關(guān)系非復(fù)制時有效，BOS中同一分錄支持多種關(guān)聯(lián)關(guān)系，在選單流程中需指定其中一組關(guān)聯(lián)內(nèi)碼存儲。n鉤稽、強制鉤稽關(guān)系中，主控只有一個。P22 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n多級審核流程n審核人：用戶字段n審核日期：日期/長日期字段【鎖定】n憑證業(yè)務(wù)n憑證字號n憑證取數(shù)來源n憑證模板設(shè)置n憑證操作設(shè)置n生成憑證（按單、匯總）P23 版權(quán)所有

12、 1993-2009 金蝶軟件(中國)有限公司nBOS核心組件介紹組件名工程路徑說明客戶端組件K3CLASSTPL.DLL$CodeK3BosK3DesignerClientK3CLassTpl客戶端核心組件。所有的單據(jù)模版均來源于此組件。Action的具體執(zhí)行也在此組件。K3SingleClassBill.dll$CodeK3BosK3DesignerClientK3SingleClassBill單據(jù)、序時簿具體展現(xiàn)的組件。負責(zé)加載單據(jù)、序時簿控件并顯示。K3ClassDEFINENew.exe$CodeK3BosK3DesignerClientK3ClassDEFINEBOS IDEK3C

13、lassEvents.dll$CodeK3BosK3DesignerClientK3ClassEventsBOS 插件代理組件。如果要修改、增加插件函數(shù)，需要修改此組件。K3ClassBillCtl.ocx$CodeK3BosK3DesignerClientK3ClassBillCtl單據(jù)控件。BOS 單據(jù)運行時展現(xiàn)。K3ClassList.ocx$CodeK3BosK3DesignerClientK3Classlist序時簿控件。BOS 序時簿運行時展現(xiàn)。K3BaseClassLst.ocx$CodeK3BosK3DesignerClientK3BaseClassLst基礎(chǔ)資料序時簿控件。B

14、OS 基礎(chǔ)資料序時簿運行時展現(xiàn)。K3FILTER.OCX$CodeK3BosK3DesignerClientK3Filter過濾界面控件。BOS 過濾界面運行時展現(xiàn)。K3ClassAction.dll$CodeK3BosK3DesignerClientK3ClassActionAction定義組件。提供單據(jù)Action可視化定義界面。如果要增加BOS內(nèi)置Action，需要修改此組件K3BOSActive.dll$CodeK3BosK3DesignerClientK3BOSACTIVEBOS 和主控臺交互調(diào)用組件。中間層組件K3MClass.dll$CodeK3BosK3DesignerServ

15、erK3MClass核心組件。BOS中間層業(yè)務(wù)處理。P24 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nBOS應(yīng)用開發(fā)調(diào)試工程組（限研發(fā)內(nèi)部）目的所必須工程調(diào)試單據(jù)、序時簿、基礎(chǔ)資料序時簿（控件）調(diào)試單據(jù)、序時簿、基礎(chǔ)資料序時簿（控件）中的具體執(zhí)行中的具體執(zhí)行K3ClassDEFINE、K3CLassTpl、K3SingleClassBill、K3ClassLookUp、K3ClassBillCtl（K3Classlist、K3BaseClassLst）由由BOS IDE進入調(diào)試單據(jù)插件進入調(diào)試單據(jù)插件K3ClassDEFINE、K3CLassTpl、K3SingleClassBi

16、ll、K3ClassBillCtl、插件、插件由主控臺進入調(diào)試單據(jù)插件由主控臺進入調(diào)試單據(jù)插件KDMain、K3CLassTpl、K3SingleClassBill、插件、插件P25 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 簡介nK/3 BOS 架構(gòu)nK/3 BOS 業(yè)務(wù)應(yīng)用開發(fā)nK/3 BOS 插件nQAP26 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n為什么要使用插件？n隨需應(yīng)變的個性化需求n保持K/3BOS架構(gòu)的開放性，擴展性n完成K/3BOS標準功能無法實現(xiàn)的需求n插件的分類nCOMn.NETn插件的實現(xiàn)n通過K3ClassEvents對象

17、代理實現(xiàn)P27 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n插件原理P28 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n重點掌握n一套模型n二個關(guān)鍵數(shù)據(jù)包n三個接口對象n四個輔助對象n五項注意事項P29 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n一套模型(BOS插件對象模型)n接口對象接口對象nBillEventBillEvent單據(jù)插件代理單據(jù)插件代理nListEventsListEvents序時簿插件代理序時簿插件代理nBaseClassEvent BaseClassEvent 基礎(chǔ)資料序基礎(chǔ)資料序時簿插件代理時簿插件代理n輔助對象輔助對象nK3Lib

18、NetUserAccountK3LibNetUserAccount與與金蝶金蝶K/3 K/3 交互交互 nMenuBarBOSBandsBOSBandBOMenuBarBOSBandsBOSBandBOSToolsBOSToolSToolsBOSTool新增、修改新增、修改菜單和工具欄菜單和工具欄 nBillHeadsBillHeadBillEntrBillHeadsBillHeadBillEntrysBillEntryBOSFieldsBOSFysBillEntryBOSFieldsBOSFieldield單據(jù)、單據(jù)頭、單據(jù)體、單據(jù)、單據(jù)頭、單據(jù)體、單據(jù)字段操作單據(jù)字段操作BOSK3LibB

19、illEventListEventsNetUserAccountMenuBarBillHeadsBillEntrysBillHeadBillEntryBOSBandsBOSToolsBOSFieldsBOSFieldBaseClassEventBOSBandBOSToolP30 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n兩個關(guān)鍵的數(shù)據(jù)包ndctTableInfoP31 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司ndctDatadctData“Page1”“Page2”“Page”“Pagei”dctFld1dctFlddctFldnEnu_EntryType_Sing

20、leRow“Row1”dctFld1dctFlddctFldn“Row”“Rown”Enu_EntryType_MutiRowFDSPFFNDFOLDFMODIFYFFLDsKeysKeyP32 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n三個接口對象nBillEvent單據(jù)插件代理nListEvents序時簿插件代理nBaseClassEvent 基礎(chǔ)資料序時簿插件代理P33 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n四個輔助對象nK3Lib對象nACountnNetnUsernMenuBar對象nBOSBandsnBOSToolsnBillHeads對象nBOSF

21、ieldsnBillEntrys對象nBOSFieldsP34 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n典型應(yīng)用n獲取賬套IDn m_BillInterface.K3Lib.Account.AccountIDn獲取系統(tǒng)多語言信息n strLanguage = m_BillInterface.K3Lib.GetK3Languagen設(shè)置單據(jù)體最大行數(shù)n m_BillInterface.BillEntrys(1).MaxRows = 1000n讀取字段值可以采用兩種方式n m_billinterface.data(“page1”)(m_billinterface.tableinfo

22、(“map”)(“FCheckDate”)(“FFLD”)n m_billinterface.bosheads(1).bosfields(“FCheckDate”).valuen動態(tài)改變字段名稱n m_BillInterface.BillHeads(1).BOSFields(FInteger4).Caption = aP35 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n五項注意事項n1、獲取設(shè)置字段屬性n 除了獲取、設(shè)置字段的值外，還需要設(shè)置這個字段的其他屬性，建議采用 BOSField 對象的Value、Caption、Text等屬性。n2、Fire開頭的函數(shù)n K/3 BOS

23、插件代理組件中包含有多個Fire開始的函數(shù)，如FireChange、FireSaveBillSuccess等。這些函數(shù)都是提供代理組件和K/3 BOS交互使用的，對于插件并沒有任何作用，請注意不要使用。n3、數(shù)據(jù)訪問規(guī)則n 在插件中訪問數(shù)據(jù)庫、更新數(shù)據(jù)庫，請使用插件對象的K3Lib屬性的GetData方法和UpdateData方法。使用這2個方法，可以避免直接由客戶端訪問賬套，充分利用3層構(gòu)架。 P36 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n4、訪問其他組件規(guī)則n 在插件中如果需要創(chuàng)建其他的K/3組件對象，請使用插件對象的K3Lib屬性的CreateK3Object方法。使用

24、這個方法，可以避免調(diào)試時出現(xiàn)的不在統(tǒng)一進程出錯問題。 n5、多語言處理規(guī)則n 在插件中進行多語言處理，請使用插件對象的K3Lib屬性的LoadKDString方法。不過需要注意的是，這個函數(shù)默認使用的是金蝶K/3-BOS的語言資源，如果需要使用其他資源包，需要通過ResourceFile參數(shù)指定。 P37 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司n主要事件順序P38 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司nK/3 BOS 相關(guān)技術(shù)資料nBOS開發(fā)者網(wǎng)絡(luò)nhttp:/ 培訓(xùn)資料n$/開發(fā)部/05BOS開發(fā)部/02BOS開發(fā)組/2知識共享/2知識共享(K3SerK3WorkShop)nBOS不加密版n 59k3 BOS IDEP40 版權(quán)所有 1993-2009 金蝶軟件(中國)有限公司沒有金蝶軟件（中國）有限公司的特別許可，任何人不能以任何形式或為任何目的復(fù)制或傳播本文檔的任何部分。本文檔中包含的信息如有更改，恕不另行通知。 由金蝶軟件（中國）有限公司和其分銷商所銷售的某些軟件產(chǎn)品包含有其它軟件供應(yīng)商版權(quán)所有的軟件組件。Microsoft、WINDOWS、NT、EXCEL、Wo