03k3實(shí)施技術(shù)專題-02k3bos插件開發(fā)產(chǎn)品培訓(xùn)

提綱插件開發(fā)概述案例介紹插件開發(fā)基礎(chǔ)插件開發(fā)向?qū)3ClassEvents業(yè)務(wù)對(duì)象接口BillEventListEvents單據(jù)接口序事簿接口K3ClassEvents公用對(duì)象K3Lib為什么要用插件完成當(dāng)前版本無(wú)法用K/3

BOS

標(biāo)準(zhǔn)功能實(shí)現(xiàn)的需求，插件原理圖如下插件開發(fā)概述插件開發(fā)概述插件的作用實(shí)現(xiàn)單據(jù)、序時(shí)簿、基礎(chǔ)資料序時(shí)簿中特殊的業(yè)務(wù)流程處理中間層數(shù)據(jù)改變時(shí)的特殊處理規(guī)則個(gè)性化的菜單、外觀定制；增加自定義的菜單并響應(yīng)其操作對(duì)審核、消息流程的自定義控制插件開發(fā)環(huán)境金蝶K/3

v10.1以上的版本必選安裝客戶端、K/3

BOS， 同時(shí)安裝中間層

Visual

Basic使用vb

6.0

版本，并且安裝SP5Windows

2000

Server以上版本采用Server

類操作系統(tǒng)作為開發(fā)、調(diào)試操作系統(tǒng)注意：如果要使用“金蝶K/3

BOS插件開發(fā)向?qū)А惫ぞ?，需要采用?jiǎn)體中文操作系統(tǒng)SQL

Server

2000數(shù)據(jù)庫(kù)插件開發(fā)概述-開發(fā)環(huán)境介紹提綱插件開發(fā)概述案例介紹插件開發(fā)基礎(chǔ)插件開發(fā)向?qū)3ClassEvents業(yè)務(wù)對(duì)象接口BillEventListEvents單據(jù)接口序事簿接口K3ClassEvents公用對(duì)象K3LibABC公司主營(yíng)業(yè)務(wù)是生產(chǎn)和銷售各種高檔衛(wèi)浴五金、水暖器材等。擁有五個(gè)廠區(qū)，產(chǎn)品外銷歐美、 等國(guó)家和地區(qū)占用嚴(yán)重的問題，ABC公司提出了寄存?zhèn)}的管理模為了 物流管理，解決重復(fù)請(qǐng)購(gòu)、式，與供應(yīng)商之間通過

窗口來管理供應(yīng)商將物料寄存到ABC公司指定的物流中心倉(cāng)庫(kù)，但所

屬供應(yīng)商ABC公司根據(jù)生產(chǎn)實(shí)際需求從物流中心領(lǐng)料并進(jìn)行相應(yīng)的結(jié)算處理案例分析解決方案演示案例—插件開發(fā)需求在寄存入庫(kù)單單據(jù)上增加 按鈕的浮動(dòng)按鈕，隱藏“頁(yè)面設(shè)置”菜單當(dāng)前登錄用戶只能看到本人制作的寄存入庫(kù)單寄存入庫(kù)單新增時(shí)給表體賦一行默認(rèn)值寄存入庫(kù)單下推外購(gòu)入庫(kù)單時(shí)，所選記錄必須部門相同提綱插件開發(fā)概述案例介紹插件開發(fā)基礎(chǔ)插件開發(fā)向?qū)3ClassEvents業(yè)務(wù)對(duì)象接口BillEventListEvents單據(jù)接口序事簿接口K3ClassEvents公用對(duì)象K3Lib插件開發(fā)基礎(chǔ)

—

插件開發(fā)向?qū)w驗(yàn)K/3

BOS插件開發(fā)向?qū)峋V插件開發(fā)概述案例介紹插件開發(fā)基礎(chǔ)插件開發(fā)向?qū)3ClassEvents業(yè)務(wù)對(duì)象接口BillEventListEvents單據(jù)接口序事簿接口K3ClassEvents公用對(duì)象K3Lib插件對(duì)象模型(BillEvent)單據(jù)接口序事簿接口基礎(chǔ)資料序事簿接口K3ClassEventsBillEventListEventsBaseClassEventBillEventK3LibNetUserAccountBarBillHeadsBillEntrysBillHeadBillEntryBOSBandsBOSToolsBOSFieldsBOSBandBOSToolBOSFieldsBOSFieldBOSFieldBillEvent對(duì)象BillEvent對(duì)象Bar概述BOSBands和BOSBand對(duì)象

BOSTools和BOSTool對(duì)象單據(jù)基礎(chǔ)對(duì)象BillHeads和BillEntrysBOSFields單據(jù)接口常用事件常用函數(shù)、方法常用屬性概述BOSBands、BOSTools對(duì)象在BillEvent、ListEventsBar屬性使用。對(duì)象中包含例如：Dim

oBar

As

K3ClassEvents.BarbarSet

oBar

=BillEventObject.在BillEvent、ListEvents、BaseClassEvent對(duì)象新增事件SubSubBoolean)BarInitialize(ByVal

o Bar

As

K3ClassEvents.

Bar)BarClick(ByVal

BOSTool

As

K3ClassEvents.BOSTool,

Cancel

AsBOSBands和BOSBand對(duì)象基本和ActiveBar的Bands、Band對(duì)象屬性、方法一致BOSBands不能使用

For

Each

方法遍歷BOSBand對(duì)象可以通過

Add

方法來新建BOSBand對(duì)象。BOSTools常用方法Function

Add(ToolName

As

String)

As

BOSTool與ActiveBar的Tools的Add相比可以在任何的BOSTools對(duì)象中調(diào)用不需要考慮ToolID重復(fù)的問題Sub

InsertBefore(Index,

oTool

As

BOSTool)Index

可以是數(shù)字，以表示當(dāng)前BOSBand上的BOSTool的順序（與ActiveBar中的方法一致）也可以是一個(gè)BOSTool的Name（字符串）Sub

InsertAfter(Index,

oTool

As

BOSTool)新增方法，特性與上相同練習(xí)在寄存入庫(kù)單單據(jù)上增加面設(shè)置”菜單按鈕的浮動(dòng)按鈕，隱藏“頁(yè)BillEvent對(duì)象BillEvent對(duì)象Bar概述BOSBands和BOSBand對(duì)象BOSTools和BOSTool對(duì)象單據(jù)基礎(chǔ)對(duì)象BillHeads和BillEntrysBOSFields單據(jù)接口事件函數(shù)、方法屬性概述在BillEvent對(duì)象中包含使用。例如：Dim

oHead As

K3ClassEvents.BillHeadSet

oHead

=

BillEventObject.BillHeads(1)BillHeads、BillEntrys、BOSFields不能使用For

Each方法遍歷對(duì)象BillEventBillHeadsBillEntrysBillHeadBillEntryBOSFieldsBOSFieldBOSFieldsBOSFieldBillEntrys對(duì)象BillEntrys對(duì)象包含了和單據(jù)體相關(guān)的屬性通過這些屬性可以在運(yùn)行時(shí)操作單據(jù)體分錄相關(guān)信息CountLong分錄的個(gè)數(shù)EntryIndexLong序號(hào)BOSFields(BOSFields）包含的字段TableNameString分錄對(duì)應(yīng)在數(shù)據(jù)庫(kù)中的表名EntryLeftLong分錄的左EntryTopLong分錄的上EntryWidthLong分錄的寬度EntryHeightLong分錄的高度LayerLong分錄所在的層EntryTypeLong分錄的類型（單分錄、多分錄）VisibleBoolean分錄的可見性KeyFieldString分錄的關(guān)鍵字段MaxRowsLong可以在運(yùn)行時(shí)調(diào)整單據(jù)體行數(shù)（大于1且小于2000）BOSFields和BOSField對(duì)象字段相關(guān)信息CountLong字段的個(gè)數(shù)CaptionString字段的標(biāo)題FieldNameString字段名TableNameString字段對(duì)應(yīng)在數(shù)據(jù)庫(kù)中的表名FieldLeftLong字段的左FieldTopLong字段的上FieldWidthLong字段的寬度FieldHeightLong字段的高度LayerLong字段所在的層FieldLockBoolean字段是否鎖定VisibleBoolean字段是否可見FilterString字段的過濾FontBoldBoolean字段字體屬性FontItalicBoolean字段字體屬性FontNameString字段字體屬性FontSizeCurrency字段字體屬性FrameBorderBoolean是否顯示邊框FrameBorderColorLong邊框顏色LabelColorLong顏色LabelWidthInteger寬度MustInputBoolean是否必錄NeedSaveBoolean是否需要保存NoteString備注NumberVariant字段的值（用于查找類型字段）PageInteger字段所在的PageTextVariant字段的顯示值TextColorLong字段的顏色ValueVariant字段的保存值FKeyString字段的內(nèi)碼BOSField對(duì)象每個(gè)字段對(duì)象，對(duì)應(yīng)單據(jù)（包括單據(jù)頭和單據(jù)體）上的每一個(gè)字段通過這些屬性，可以在運(yùn)行時(shí)操作字段。屬性集BOSField屬性某些屬性值只適用于單據(jù)頭中的字段FieldTop\FieldLeft\FieldHeight\FieldWidthLabelWidth\LabelColor\FrameBorderColor\FrameBorderFontName\FontSize\FontBold\FontItalic\TextColor某些兩者都支持TableName\FieldName\Caption\Page\Layer\FKeyVisible\NeedSave\MustInput\FieldLock\Note某些只適用于特殊的字段Row僅支持多分錄單據(jù)體僅支持基礎(chǔ)資料字段FilterBOSField屬性詳解Visible:字段顯示/隱藏屬性,只有設(shè)計(jì)時(shí)沒有設(shè)計(jì)為“可見”狀態(tài)的字段，才可以在運(yùn)行時(shí)更改可見性狀態(tài)FieldLock:只有設(shè)計(jì)時(shí)沒有設(shè)計(jì)為“鎖定”狀態(tài)的字段，才可以在運(yùn)行時(shí)更改鎖定狀態(tài)Value:得到字段內(nèi)碼值。即保存在數(shù)據(jù)庫(kù)中的值

Number:得到字段查找類型字段查找值Text:得到字段顯示值。即顯示在界面的值，不支持通過該屬性直接賦值。Value:得到/設(shè)置字段非查找類型字段賦值使用Number :得到/設(shè)置字段查找類型字段賦值使用BillEvent對(duì)象BillEvent對(duì)象Bar概述BOSBands和BOSBand對(duì)象BOSTools和BOSTool對(duì)象單據(jù)基礎(chǔ)對(duì)象BillHeads和BillEntrysBOSFields單據(jù)接口常用事件常用函數(shù)、方法常用屬性BillEvent對(duì)象-常用事件事件Event

BarInitialize(oBar

AsBar)說明：該事件在菜單、

初始化時(shí)發(fā)生。Event

BarClick(BOSTool

As

BOSTool,

Cancel

As

Boolean)項(xiàng)時(shí)發(fā)生。說明：該事件在點(diǎn)擊菜單、Event

AfterNewBill()說明：新建單據(jù)對(duì)象后發(fā)生。Event

AfterLoadBill()說明：?jiǎn)螕?jù)對(duì)象加載完成后發(fā)生。Event

AfterSelBill(lSelBillType

As

Long)說明：選單操作完成后發(fā)生。Event

Change(d Dictionary,

dctFld

As

Dictionary,

Col

AsLong,

Row

As

Long,

Cancel

As

Boolean)說明：?jiǎn)螕?jù)對(duì)象上的字段值發(fā)生改變時(shí)發(fā)生。BillEvent對(duì)象-常用函數(shù)、方法方法Function

GetFieldValue(sKey

As

String,

[nRow

As

Long

=

-1],[ValueType

As

Enu_ValueType

=

Enu_ValueType_FFLD])說明：用于返回字段的值。Function

SetFieldValue(sKey

As

String,

vValue,

[nRow

As

Long=

-1])

As

Boolean說明：用于設(shè)置字段的值。Function

InsertNewRowAndFill(nPage

As

Long,

nRow

As

Long,ParamArray

vFieldsData()

As

Variant)

As

Boolean說明：在多分錄單據(jù)體中

一個(gè)新行，并填充數(shù)據(jù)。BillEvent對(duì)象-屬性練習(xí)通過插件實(shí)現(xiàn)寄存入庫(kù)單新增時(shí)給表體賦一行值，物料代碼為”01.001”，應(yīng)收數(shù)量為100，實(shí)收數(shù)量為100，單價(jià)為1500。主要練習(xí)Insertnewrowandfill方法插件對(duì)象模型(ListEvents)單據(jù)接口序事簿接口基礎(chǔ)資料序事簿接口K3ClassEventsBillEventListEventsBaseClassEventListEventsK3LibNetUserAccountBarBOSBandsBOSToolsBOSBandBOSToolListEvents對(duì)象ListEvents對(duì)象常用事件常用函數(shù)、方法常用屬性ListEvents對(duì)象-常用事件Event

BarInitialize(o Bar

As說明：菜單、

初始化時(shí)發(fā)生。Bar)Event

BarClick(BOSTool

AsBOSTool,

Cancel

As

Boolean)說明：點(diǎn)擊菜單、 項(xiàng)時(shí)發(fā)生。Event

ListFillRow(lRow

As

Long,

RowData

As

Object,

HeadDiDictionary,

CellData

As

String,

BackColor

As

Long,

ContinueRaise

AsBoolean)說明：序時(shí)簿的行填充數(shù)據(jù)時(shí)發(fā)生。ListEvents對(duì)象-常用方法Function

GetSelectedBillInfo()

As

Vector說明：獲取當(dāng)前選中的單據(jù)的數(shù)據(jù)。ListEvents對(duì)象-屬性ListFilterString說明：序事簿運(yùn)行時(shí)設(shè)置過濾條件練習(xí)通過插件實(shí)現(xiàn)當(dāng)前登錄用戶只能看到本人制作的寄存入庫(kù)單,主要練習(xí)序事簿ListFilterString屬性提綱插件開發(fā)概述案例介紹插件開發(fā)基礎(chǔ)插件開發(fā)向?qū)?shù)據(jù)結(jié)構(gòu)K3ClassEvents業(yè)務(wù)對(duì)象接口BillEventListEvents單據(jù)接口序事簿接口K3ClassEvents公用對(duì)象

K3Lib常用元數(shù)據(jù)表結(jié)構(gòu)概述在BillEvent、ListEvents、BaseClassEvent對(duì)象中包含K3Lib對(duì)象使用。例如：Dim

oK3

As

K3ClassEvents.K3LibSet

oK3=BillEventObject.K3Lib也可直接使用：lUserID

=BillEventObject.K3Lib.User.UserIDK3LibAccountIDCommitMutexBeginMutexAccountNameSetupTypeQueryFuncUserNameCreateK3ObjectLoadKDStringGetK3LanguageUpdateDataGetDataNetUserAccountUserIDQuerySubSys方法集Function

GetData(SQLCode

As

String)

As

Object數(shù)據(jù)庫(kù)，返回?cái)?shù)據(jù)。返回值是通過SQL語(yǔ)句從中間層ADODB.Recordset

類型Sub

UpdateData(SQLCode)通過SQL語(yǔ)句從中間層數(shù)據(jù)庫(kù)，更新數(shù)據(jù)參數(shù)SQLCode可以是String（單條SQL語(yǔ)句），也可以是String()（多條SQL語(yǔ)句）Function

CreateK3Object(ClassString

As

String)

As

Object通過這個(gè)函數(shù)在插件中創(chuàng)建K/3的對(duì)象，使得插件可以單獨(dú)調(diào)試練習(xí)通過插件實(shí)現(xiàn)寄存入庫(kù)單下推外購(gòu)入庫(kù)單時(shí)所選單據(jù)部門必須相同，主要練習(xí)K3lib方法GetData以及序事簿方法GetSelectedBillInfo資料關(guān)于K/3

BOS完整案例的介紹，請(qǐng)參考《K3BOS應(yīng)用開發(fā)培訓(xùn)》關(guān)于K/3BOS完整開發(fā)流程的介紹，請(qǐng)參考《K3

BOS開發(fā)指導(dǎo)手冊(cè)》關(guān)于插件中接口的函數(shù)、方法、事件、屬性的詳細(xì)信息，請(qǐng)參考《K3BOS插件開發(fā)參考手冊(cè)》關(guān)于BOS萬(wàn)能報(bào)表工具包介紹，請(qǐng)參考《K3

BOS萬(wàn)能報(bào)表工具包用戶手冊(cè)》常見問題請(qǐng)參考《K/3

BOS百問百答》關(guān)于工業(yè)單據(jù)插件開發(fā)，函數(shù)、方法、屬性的詳細(xì)信息，《K3客戶化開發(fā)工具包》謝 謝!特別或?yàn)槿魏文康?/p>

或 本文檔的任何部沒有金蝶 （中國(guó)） 的特別 ，任何人不能以分。本文檔中包含的信息

更改，恕不另行通知。由金蝶 （中國(guó)） 和其分銷商所銷售的某些產(chǎn)品包含有其它 供應(yīng)商的 組件。?、WINDOWS?、NT?、EXCEL?、Word?、

?

和SQL

Server?是微軟公司的 商標(biāo)