03k3实施技术专题-02k3bos插件开发产品培训

提纲插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEventListEvents单据接口序事簿接口K3ClassEvents公用对象K3Lib为什么要用插件完成当前版本无法用K/3

BOS

标准功能实现的需求，插件原理图如下插件开发概述插件开发概述插件的作用实现单据、序时簿、基础资料序时簿中特殊的业务流程处理中间层数据改变时的特殊处理规则个性化的菜单、外观定制；增加自定义的菜单并响应其操作对审核、消息流程的自定义控制插件开发环境金蝶K/3

v10.1以上的版本必选安装客户端、K/3

BOS， 同时安装中间层

Visual

Basic使用vb

6.0

版本，并且安装SP5Windows

2000

Server以上版本采用Server

类操作系统作为开发、调试操作系统注意：如果要使用“金蝶K/3

BOS插件开发向导”工具，需要采用简体中文操作系统SQL

Server

2000数据库插件开发概述-开发环境介绍提纲插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEventListEvents单据接口序事簿接口K3ClassEvents公用对象K3LibABC公司主营业务是生产和销售各种高档卫浴五金、水暖器材等。拥有五个厂区，产品外销欧美、 等国家和地区占用严重的问题，ABC公司提出了寄存仓的管理模为了 物流管理，解决重复请购、式，与供应商之间通过

窗口来管理供应商将物料寄存到ABC公司指定的物流中心仓库，但所

属供应商ABC公司根据生产实际需求从物流中心领料并进行相应的结算处理案例分析解决方案演示案例—插件开发需求在寄存入库单单据上增加 按钮的浮动按钮，隐藏“页面设置”菜单当前登录用户只能看到本人制作的寄存入库单寄存入库单新增时给表体赋一行默认值寄存入库单下推外购入库单时，所选记录必须部门相同提纲插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEventListEvents单据接口序事簿接口K3ClassEvents公用对象K3Lib插件开发基础

—

插件开发向导体验K/3

BOS插件开发向导提纲插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEventListEvents单据接口序事簿接口K3ClassEvents公用对象K3Lib插件对象模型(BillEvent)单据接口序事簿接口基础资料序事簿接口K3ClassEventsBillEventListEventsBaseClassEventBillEventK3LibNetUserAccountBarBillHeadsBillEntrysBillHeadBillEntryBOSBandsBOSToolsBOSFieldsBOSBandBOSToolBOSFieldsBOSFieldBOSFieldBillEvent对象BillEvent对象Bar概述BOSBands和BOSBand对象

BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口常用事件常用函数、方法常用属性概述BOSBands、BOSTools对象在BillEvent、ListEventsBar属性使用。对象中包含例如：Dim

oBar

As

K3ClassEvents.BarbarSet

oBar

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

o Bar

As

K3ClassEvents.

Bar)BarClick(ByVal

BOSTool

As

K3ClassEvents.BOSTool,

Cancel

AsBOSBands和BOSBand对象基本和ActiveBar的Bands、Band对象属性、方法一致BOSBands不能使用

For

Each

方法遍历BOSBand对象可以通过

Add

方法来新建BOSBand对象。BOSTools常用方法Function

Add(ToolName

As

String)

As

BOSTool与ActiveBar的Tools的Add相比可以在任何的BOSTools对象中调用不需要考虑ToolID重复的问题Sub

InsertBefore(Index,

oTool

As

BOSTool)Index

可以是数字，以表示当前BOSBand上的BOSTool的顺序（与ActiveBar中的方法一致）也可以是一个BOSTool的Name（字符串）Sub

InsertAfter(Index,

oTool

As

BOSTool)新增方法，特性与上相同练习在寄存入库单单据上增加面设置”菜单按钮的浮动按钮，隐藏“页BillEvent对象BillEvent对象Bar概述BOSBands和BOSBand对象BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口事件函数、方法属性概述在BillEvent对象中包含使用。例如：Dim

oHead As

K3ClassEvents.BillHeadSet

oHead

=

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

Each方法遍历对象BillEventBillHeadsBillEntrysBillHeadBillEntryBOSFieldsBOSFieldBOSFieldsBOSFieldBillEntrys对象BillEntrys对象包含了和单据体相关的属性通过这些属性可以在运行时操作单据体分录相关信息CountLong分录的个数EntryIndexLong序号BOSFields(BOSFields）包含的字段TableNameString分录对应在数据库中的表名EntryLeftLong分录的左EntryTopLong分录的上EntryWidthLong分录的宽度EntryHeightLong分录的高度LayerLong分录所在的层EntryTypeLong分录的类型（单分录、多分录）VisibleBoolean分录的可见性KeyFieldString分录的关键字段MaxRowsLong可以在运行时调整单据体行数（大于1且小于2000）BOSFields和BOSField对象字段相关信息CountLong字段的个数CaptionString字段的标题FieldNameString字段名TableNameString字段对应在数据库中的表名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字段的内码BOSField对象每个字段对象，对应单据（包括单据头和单据体）上的每一个字段通过这些属性，可以在运行时操作字段。属性集BOSField属性某些属性值只适用于单据头中的字段FieldTop\FieldLeft\FieldHeight\FieldWidthLabelWidth\LabelColor\FrameBorderColor\FrameBorderFontName\FontSize\FontBold\FontItalic\TextColor某些两者都支持TableName\FieldName\Caption\Page\Layer\FKeyVisible\NeedSave\MustInput\FieldLock\Note某些只适用于特殊的字段Row仅支持多分录单据体仅支持基础资料字段FilterBOSField属性详解Visible:字段显示/隐藏属性,只有设计时没有设计为“可见”状态的字段，才可以在运行时更改可见性状态FieldLock:只有设计时没有设计为“锁定”状态的字段，才可以在运行时更改锁定状态Value:得到字段内码值。即保存在数据库中的值

Number:得到字段查找类型字段查找值Text:得到字段显示值。即显示在界面的值，不支持通过该属性直接赋值。Value:得到/设置字段非查找类型字段赋值使用Number :得到/设置字段查找类型字段赋值使用BillEvent对象BillEvent对象Bar概述BOSBands和BOSBand对象BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口常用事件常用函数、方法常用属性BillEvent对象-常用事件事件Event

BarInitialize(oBar

AsBar)说明：该事件在菜单、

初始化时发生。Event

BarClick(BOSTool

As

BOSTool,

Cancel

As

Boolean)项时发生。说明：该事件在点击菜单、Event

AfterNewBill()说明：新建单据对象后发生。Event

AfterLoadBill()说明：单据对象加载完成后发生。Event

AfterSelBill(lSelBillType

As

Long)说明：选单操作完成后发生。Event

Change(d Dictionary,

dctFld

As

Dictionary,

Col

AsLong,

Row

As

Long,

Cancel

As

Boolean)说明：单据对象上的字段值发生改变时发生。BillEvent对象-常用函数、方法方法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说明：用于设置字段的值。Function

InsertNewRowAndFill(nPage

As

Long,

nRow

As

Long,ParamArray

vFieldsData()

As

Variant)

As

Boolean说明：在多分录单据体中

一个新行，并填充数据。BillEvent对象-属性练习通过插件实现寄存入库单新增时给表体赋一行值，物料代码为”01.001”，应收数量为100，实收数量为100，单价为1500。主要练习Insertnewrowandfill方法插件对象模型(ListEvents)单据接口序事簿接口基础资料序事簿接口K3ClassEventsBillEventListEventsBaseClassEventListEventsK3LibNetUserAccountBarBOSBandsBOSToolsBOSBandBOSToolListEvents对象ListEvents对象常用事件常用函数、方法常用属性ListEvents对象-常用事件Event

BarInitialize(o Bar

As说明：菜单、

初始化时发生。Bar)Event

BarClick(BOSTool

AsBOSTool,

Cancel

As

Boolean)说明：点击菜单、 项时发生。Event

ListFillRow(lRow

As

Long,

RowData

As

Object,

HeadDiDictionary,

CellData

As

String,

BackColor

As

Long,

ContinueRaise

AsBoolean)说明：序时簿的行填充数据时发生。ListEvents对象-常用方法Function

GetSelectedBillInfo()

As

Vector说明：获取当前选中的单据的数据。ListEvents对象-属性ListFilterString说明：序事簿运行时设置过滤条件练习通过插件实现当前登录用户只能看到本人制作的寄存入库单,主要练习序事簿ListFilterString属性提纲插件开发概述案例介绍插件开发基础插件开发向导数据结构K3ClassEvents业务对象接口BillEventListEvents单据接口序事簿接口K3ClassEvents公用对象

K3Lib常用元数据表结构概述在BillEvent、ListEvents、BaseClassEvent对象中包含K3Lib对象使用。例如：Dim

oK3

As

K3ClassEvents.K3LibSet

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

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

GetData(SQLCode

As

String)

As

Object数据库，返回数据。返回值是通过SQL语句从中间层ADODB.Recordset

类型Sub

UpdateData(SQLCode)通过SQL语句从中间层数据库，更新数据参数SQLCode可以是String（单条SQL语句），也可以是String()（多条SQL语句）Function

CreateK3Object(ClassString

As

String)

As

Object通过这个函数在插件中创建K/3的对象，使得插件可以单独调试练习通过插件实现寄存入库单下推外购入库单时所选单据部门必须相同，主要练习K3lib方法GetData以及序事簿方法GetSelectedBillInfo资料关于K/3

BOS完整案例的介绍，请参考《K3BOS应用开发培训》关于K/3BOS完整开发流程的介绍，请参考《K3

BOS开发指导手册》关于插件中接口的函数、方法、事件、属性的详细信息，请参考《K3BOS插件开发参考手册》关于BOS万能报表工具包介绍，请参考《K3

BOS万能报表工具包用户手册》常见问题请参考《K/3

BOS百问百答》关于工业单据插件开发，函数、方法、属性的详细信息，《K3客户化开发工具包》谢 谢!特别或为任何目的

或 本文档的任何部没有金蝶 （中国） 的特别 ，任何人不能以分。本文档中包含的信息

更改，恕不另行通知。由金蝶 （中国） 和其分销商所销售的某些产品包含有其它 供应商的 组件。®、WINDOWS®、NT®、EXCEL®、Word®、

®

和SQL

Server®是微软公司的 商标