第二节 K3 BOS 详解.ppt

1、K/3 BOS开发认证培训 - 基于K/3V11.0,演讲人：K/3BOS开发部 金蝶软件（中国）有限公司,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,基于平台技术的金蝶K/3 ERP,K/3 BOS集成开发原理(典型场景),采购申请,采购订单,质检单,入库单,采购订单B,入库单,询价单,业务配置,修改参数,复制现有模版,创建新单据,业务流程定义,标准系统应用,K/3 BOS应用,业务流程定义,业务定义,1、业务系统 2、业务对象 3、商业逻辑 4、序时簿 5、多级审核流程 6、消息预

2、警 7、权限 8、业务流程 9、报表 10、数据交换 11、插件开发 12、多语言 13、快速部署 。,K/3 BOS集成开发,基础资料设计,单据流程设计,业务单据设计,审核流程设计,业务报表设计,应用部署管理,插件开发模型,插件开发工具,K/3 BOS集成开发工具,K/3 BOS标准完整的开发流程,发布,业务分析,可视化的定义检斤业务流程,灵活的定义检斤业务报表,将已配置信息发布到应用环境中,在K/3主界面上可以按角色配置已开发的功能,基础资料定义,业务单据定义,审核流程定义,单据流程定义,报表定义,插件开发,部署,K/3 BOS,K/3 BOS的三大产品特性,简单快速,K/3 BOS,易于

3、集成,平滑升级,基础数据集成 业务流程集成 消息集成 权限集成 主控台集成 ,可视化、拖拽式的业务配置模式 基础资料、业务单据、多级审核、单据转换、业务报表、应用部署等一体化的设计模式 抽象业务应用中最繁琐的环节 ,元数据描述机制 元数据引擎 接口的一致性 ,可视化、与技术无关的集成开发环境,可视化、技术无关的集成开发环境,通过鼠标点击、拖拉等方式创建新系统，勿须编写程序代码，所见即所得,工具栏和菜单,子系统管理,属性定义,丰富的字段定义,基础资料定义,定义基础资料。,定义基础资料时，只需定义基础资料的项目及相关属性，即能完成与基础资料相关的各种业务对象及应用界面； 将大量的编程工作简化成界面

4、的定义，降低二次开发的难度；,可视化基础资料设计,业务单据定义,新增或修改业务单据,只需定义单据项目及相关属性，即能完成与单据相关业务对象的定义 将大量的编程工作简化成界面的定义，降低二次开发的难度；,可视化界面和业务逻辑设计,扩展业务服务,将标准ERP的部份业务功能抽象成业务服务，以便在新开发的系统中使用这些扩展服务,集成。通过扩展服务便于与原业务系统实现集成； 方便。扩展服务通常完成一组功能，使用扩展服务可以避免重复开发，易于使用，降低开发的复杂性 效率。使用扩展服务可以提高率率,权限管理,通过BOS开发的基础资料或单据具备功能、数据、字段权限的管理功能,无须开发即能实现权限管理，大大提升

5、个性化业务应用的安全性,操作管理,对BOS基础资料或业务单据的操作可以进行个性化定义,BOS基础资料或单据生成时自动生成一系列的操作如新增、修改、删除等，可以重新定义操作的名称或增加新的操作内容，以满足特定的业务需求。,多级审核流程、消息定义,对业务单据可以提供12级的多级审核流程，审核消息可以发送至指定的用户、用户组或默认用户,满足给客户顺序、会签两种多级审批业务需求，便于客户对业务进行分级管理和业务监控。 消息驱动多级审核流程，可以简化审批的工作量并降低操作的复杂性,单据流程定义,可以定义将一种单据通过一定的规则转化生成另外一种单据,除低工作量，新增单据根据源单生成，除低输入工作量； BO

6、S单据和K/3单据间可以灵活定义 便于业务跟踪，生成单据时可以确定单据之间的关联与钩稽关系，可以上查和下查，便于业务跟踪检查,生成记账凭证,对BOS单据可定义凭证模板并生成财务记账凭证,实现业务与财务的集成，实现新增业务系统的信息与财务系统一致 降低重复性工作，便于追溯跟踪,单据套打,设计并配置BOS业务单据的套打格式 单据标准打印，支持单据报表式的打印,分离输入与打印界面，分别满足单据输入与打印方面的特定需求 可以减少打印的工作量的与打印时间，节约打印成本 满足统一打印格式管理的要求； 对打印格式的重新修改和调整时不需要调整单据录入界面,适应多种语言环境,能够定义中文简体、中文繁体、英语等三

7、种语言操作界面,适应国际化企业管理的需要 适应不同人员的语言习惯与操作方式,部署与发布,把业务功能发布至主控台或生成安装包,可以生成主控台菜单，统一访问的方式 生成的安装包可以部署到其他账套，实现开发环境与运行环境的分离,报表定义,万能报表（旧版）交叉分析报表直接SQL报表电子表格报表标准报表（万能报表工具）,BOS万能报表工具包,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,业务单据定义-总体流程,操作消息定义,凭证定义,逻辑控制,格式定义,属性定义,权限定义,字段定义,插件定义,单据

8、测试,单据定义,业务单据定义-字段类别1,业务单据定义-字段类别2,业务单据定义-字段类别3,业务单据定义-字段类别4,业务单据定义-字段类别5,业务单据定义-字段类别6,业务单据定义-属性定义_字段通用属性1,业务单据定义-属性定义_字段通用属性2,业务单据定义-属性定义_外观通用属性,业务单据定义-整体属性,单据/基础资料整体属性 层管理 窗体风格 插件管理单据体属性 关键字段 分录类型 单分录 多分录,业务单据定义-生成凭证,生成凭证 定义凭证字 定义凭证取数来源 定义凭证模板 凭证操作设置 凭证生成,凭证字定义,凭证取数来源设置,凭证模板设置,凭证操作场景设置,凭证生成操作,选择权限分

9、组,业务单据定义-权限管理,定义业务对象的权限分组 以选择的方式制定业务对象所在的权限分组 直接制定业务对象所在的权限分组定义用户对某业务对象的权限 功能权限 字段权限 数据权限,功能权限设置,数据权限设置,字段权限设置,业务单据定义-其他配置,编码规则定义 对单据编号字段自动编码时的编码规则进行配置顺序配置 录入顺序：Enter或Tab顺序 序时簿字段显示顺序网络控制定义 定义某些操作的特殊网络控制要求单据模版检查 检查前面定义的功能是否有逻辑上的错误,业务对象运行时-细节功能（一）,快捷方式 F6 批量填充 F7 基础资料查询 F8 基础资料下拉选择 F9 基础资料名称模糊查询菜单：冻结列

10、套打：支持多套打注册选项 禁止下拉列表自动显示 输入时采用覆盖模式 保存后立即新增 单据保存时检查源单状态,冻结列设置,业务对象运行时-细节功能（二）,选项 *号标识必录项 批量填充只填充本列为空的行 屏蔽数量为零的批次 复制行追加模式 当前行之后 所有行之后 单据载入时不加载图片字段内容 纯用小键盘,运行时选项设置,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,业务单据定义-操作管理和消息定义（一）,场景分析 单据维护 修改 浏览 新增 其他单据序时簿 选单 联查 自定义联查 浏览,选

11、择单据的场景,定义操作的消息发送规则,业务单据定义-操作管理和消息定义（二）,操作定义 操作名称，操作编码 操作适应的场景 操作外观设置消息定义 消息适应的场景 消息内容 消息接收对象,选择单据的场景,定义操作的消息发送规则,业务单据定义-操作事件定义,操作事件定义 单据操作前事件定义 单据操作事件定义 单据操作后置事件定义 序事簿操作前置事件定义 序事簿操作事件定义 序事簿操作后置事件定义,操作事件定义,业务单据定义-操作事件（一）,操作相关事件 显示提示信息 采购价格预警 中止后续动作(*) 采购价格查询 获取采购价格 历史价格查询(*) 库存状态查询,业务单据定义-操作事件（二）,操作相

12、关事件 物料替代查询 刷新界面 获取菜单信息 设置菜单信息 执行有简单返回值的SQL(*) 更新物料价格 单据状态栏显示当前分录即时仓存、安全库存信息 F12库存查询,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,扩展服务-扩展业务服务管理,从扩展业务服务管理中可以查看、维护所有BOS扩展服务，及增加新的扩展服务。,扩展服务 变量定义,环境变量 系统内置 可以应用于扩展服务传入参数及条件设置共享变量 在一组扩展服务序列生命周期内有效，可以在同组的扩展服务中传递。,扩展Action中的 共

13、享变量定义,扩展Action中的 环境变量应用,扩展服务-主要的扩展服务举例,值更新/加载更新事件（一） 携带当前字段相关基础资料属性到指定列(*) 计算定义公式的值并填写到指定列(*) 计量单位变化后自动换算数量或单价 表达式为真/假时显示/隐藏字段(*) 表达式为真/假时锁定/解锁字段 单据被引用后锁定字段(*),携带当前字段相关基础资料属性到指定列,扩展服务-主要的扩展服务举例,值更新/加载更新事件（二） 条件成立时锁定菜单项，否则解锁菜单项 按公式计算表体字段的值并填写到表头目标字段 触发字段值更新事件(*) 当前字段值改变时清空指定字段的值 根据表达式的值设置字段显示信息,触发值字段

14、更新事件,扩展服务-主要的扩展服务举例,值更新/加载更新事件（三） 携带税率 币别转换 获取币别的汇率 单据状态栏显示当前分录即时仓存、安全库存信息(*) 物料为非批号管理时锁定批号对应列,单据状态栏显示当前分录即时仓存、安全库存信息,扩展服务-主要的扩展服务举例,保存规则 单据合法性检验(*) 合法性检查，检查字段唯一性,单据合法校验,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,多级审核定义-总体流程,基本信息配置,定义多级审核级次、业务审核级次及审核模式,审核用户配置,消息配置,流

15、转配置,选项配置,保存并启 用,多级审核流程,多级审核定义（一）,多级审核类型 顺序 会签多级审核前置信息 单据上需要有用户类型的字段作为审核人多级审核基本信息配置 最大审核级次 业务审核级次 业务审核人 审核日期,多级审核定义（二）,多级审核选项配置 显示审核意见录入框 审核/驳回成功后提示 审核时选择消息接收人修改无须反审核到最低一级 业务审核人和制单人不可为同一人 反审核人与审核人必须为同一人 流程结束后仍可审核后续级次 移动商务多级审核信息可回复多级审核跳转规则多级审核消息配置 启动级次、结束级次 缺省消息接收人 消息内容 消息接收人多级审核新增功能 可按用户组添加用户 可以批量审核,

16、移动商务多级审核信息可回复,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,单据流程定义-总体流程,选择单据,添加关系,设置关联关系,保存并启用流程,测试流程,单据转换流程,单据流程定义-关联关系,复制 单纯的数据复制关系，目标单上不会记录源单的类型、内码等信息，不支持上下联查。唯一不需要在目标单上添加选单关系类字段即可应用的关联关系,单据流程定义-关联关系,关联复制 不仅进行数据的复制，而且在目标单记录源单的类型、内码等信息，支持上下联查。 关联内码来源：设置源单的内码取值来源，如是单据

17、体，将记录单据内码与单据体分录内码。 关联内码存储：设置源单信息的保存字段。目标单上可能存在多组选单类型字段，需要指定一组源单信息的存储字段。 不支持从单据体到单据头的关联复制关系。,单据流程定义-关联关系,钩稽 支持扣减 扣减关系设置 控制字段：源单中应该被扣减的字段，此字段必须已参与字段对应关系的设置。如订单到入库单关系中的订单订货数量。 扣减字段：源单中记录每次扣减数量的字段。多次扣减时，扣减数量累加。如订单中的已入库数量。 关闭字段：标记源单是否已经被扣减完毕的字段。如订单中的是否已入库完毕字段 主控：同一个选单关系中可支持多个扣减关系，但其中必须有一个扣减关系为主控关系，以此关系的状

18、态进行选单控制。 严格控制：指明在当前扣减关系中，目标单是否可以超额扣减。如入库数量是否可以超过订货数量。,单据流程定义-关联关系,强制钩稽 特殊的钩稽关系，只允许一次性扣减。,单据流程定义-其它,关联选项配置 修改：源单字段携带到目标单后，是否允许修改字段值。 选单一致：字段值一致的源单才允许在同一次选单中被选择生成目标单。 过滤：是否以字段值过滤源单。匹配的源单才可以被选择生成目标单。 处理值更新事件：源单字段携带到目标单后，是否触发目标单字段的值更新事件。 红字为正：选单时取源单字段绝对值。 红蓝字属性：当目标单为工业单据，且此单据支持红蓝字属性时，指定生成目标单时的红蓝字属性。 仅复制

19、：同一个源单字段被对应到多个目标单字段，且此字段同时作为控制字段。扣减关系外的字段应关系不参与扣减，应指定仅复制。 过滤条件:设置参与选单的源单过滤条件。 选单时关联整单：选单运行时选项，源单整单始终参与选单。不选定此选项时，可选择源单部分分录生成目标单。,单据流程定义-选单填充模式,单据功能控制：设定单据适用的选单模式。 追加：支持多次选单，目标单表体内容累加，表头内容取最后一次选单字段值。覆盖：当前的选单内空直接覆盖上一次的选单内容。（默认模式）叠盖：存在多个选单关系时，在前一选单动作完成的基础上，叠加本次选单的字段内容。,提纲,K/3BOS开发综述 基础资料、单据业务对象开发 操作管理

20、扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发模型 部署,报表设计器,报表管理,主界面 菜单栏 工具栏 子系统与报表类型 报表列表 状态栏,报表设计器,报表设计,主界面 菜单栏 工具栏 工具箱 字段列表 属性窗口 工作区,单据类报表,报表设计,新建 设计 明细区段 明细报表 添加字段 预览,序时簿报表,报表设计,新建 条件 显示列 设计 预览,SQL增强报表,报表设计,新建 条件 设计 预览,报表的使用,报表的使用,单据类报表的启用 单据类报表的打印 报表发布到主控台 主控台查看报表 序时簿报表 SQL增强报表,提纲,K/3BOS开发综述 基础资料、单据业务对象开

21、发 操作管理 扩展服务 多级审核流程开发 单据转换流程开发 报表开发 K/3BOS插件开发 部署,提纲,插件开发概述 案例介绍 插件开发基础 插件开发向导 数据结构 K3ClassEvents业务对象接口 BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口 K3ClassEvents公用对象 K3Lib 常用元数据表结构,提纲,插件开发概述 案例介绍 插件开发基础 插件开发向导 数据结构 K3ClassEvents业务对象接口 BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事

22、簿接口 K3ClassEvents公用对象 K3Lib 常用元数据表结构,为什么要用插件 完成当前版本无法用 K/3 BOS 标准功能实现的需求，插件原理图如下插件的作用 实现单据、序时簿、基础资料序时簿中特殊的业务流程处理 中间层数据改变时的特殊处理规则 个性化的菜单、外观定制；增加自定义的菜单并响应其操作 对审核、消息流程的自定义控制 其它BOS没有提供通用服务的个性化功能,插件开发概述,插件开发环境 金蝶K/3 v10.1以上的版本 必选安装客户端、K/3 BOS，推荐同时安装中间层Microsoft Visual Basic 推荐使用 vb 6.0 版本，并且安装 SP5 Micros

23、oft Windows 2000 Server以上版本 推荐采用 Server 类操作系统作为开发、调试操作系统 注意：如果要使用“金蝶K/3 BOS插件开发向导”工具，需要采用简体中文操作系统 Microsoft SQL Server 2000数据库,插件开发概述-开发环境介绍,提纲,插件开发概述 案例介绍 插件开发基础 插件开发向导 数据结构 K3ClassEvents业务对象接口 BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口 K3ClassEvents公用对象 K3Lib 常用元数据表结构,ABC公司主营业务是生产和销售

24、各种高档卫浴五金、水暖器材等。拥有五个厂区，产品外销欧美、日本等国家和地区,为了统一物流管理，解决重复请购、资金占用严重的问题，ABC公司提出了寄存仓的管理模式，与供应商之间通过统一窗口来管理 供应商将物料寄存到ABC公司指定的物流中心仓库，但所有权属供应商 ABC公司根据生产实际需求从物流中心领料并进行相应的结算处理,案例分析,解决方案,演示案例插件开发需求(一),单据定义 寄存入库单新增时默认为2000行 在寄存入库单单据上增加复制按钮的浮动按钮，隐藏“页面设置”菜单 在寄存入库单序事簿上增加单据变更的菜单及按钮 以插件中附带的图片资源文件增加单据变更的显示 当单据头金额大于10000时，

25、锁定单据头备注字段 当前登录用户只能看到本人制作的寄存入库单 寄存入库单新增时给表体赋一行默认值多级审核 多级审核业务审核完后仍可修改单据头备注字段单据转换流程 寄存入库单下推外购入库单时所选单据部门必须相同,提纲,插件开发概述 案例介绍 插件开发基础 插件开发向导 数据结构 K3ClassEvents业务对象接口 BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口 K3ClassEvents公用对象 K3Lib 常用元数据表结构,插件开发基础 插件开发向导,KFO K/3 BOS 中传递数据，主要使用了 KFO的2个对象 关于 K

26、FO 对象的详细使用，请参考KFO参考手册 Vector 对象 相当于一个一维数组，可以说它是一个不定长且可以是任意数据类型的数组，同样可以通过存取数组元素值进行数据传递，一个元素值可以是RecordSet，也可以是一个任意一个数据或对象 Dictionary 对象 是一个数据字典，字典里可以存放不同的变量，可以给字典里这些变量赋值，或从字典里取出这些变量的值进行数据传递，它可以是任一个变量，也可以是一个对象。在Dictionary对象中主要通过变量名称来进行索引,插件开发基础 数据结构,两个关键的数据包 dctData BillEvent：Property Data ListEvents：

27、Event AfterCopyBillCreateData(srcInterID As Long, dctData As Dictionary) dctTableInfo BillEvent：Property TableInfo ListEvents： Property DataSrv.TableInfo BaseClassEvent： Property DataSrv.TableInfo,插件开发基础 业务数据包和单据字典包,插件开发基础 业务数据包,dctData包含这个单据对象的详细数据 每一个Page对应一个数据对象，如果这个Page是单表或者表头，那么这个数据对象是一个字典，否则这个

28、数据对象就是一个Vector，而Vector的每一个子项均为一个字典 每一个数据对象字典包含了这一个页面上数据总和，他的每一个Item均为一个字典（这个字典是最明细的） 最明细的数据字典包含五个域： FFLD = “FFLD“ 肯定都有 FDSP = “FDSP“ 查找关联类型才有 FFND = “FFND“ 查找关联类型才有 FOLD = “FOLD“ 修改单据时才有 FMODIFY = “FMODIFY“ 修改单据后时才有五个域,插件开发基础 业务数据包,插件开发基础 如何访问dctData包(一）,插件开发基础 如何访问dctData包(二）,读取单据头审核日期的值可用以下两种方式： m

29、_billinterface.data(“page1”)(m_billinterface.tableinfo(“map”)(“FCheckDate”)(“FFLD”) m_billinterface.bosheads(1).bosfields(“FCheckDate”).value 读取单据体第一行应收数量的值可用以下两种方式： m_billinterface.data(“page2”)(1)(m_billinterface.tableinfo(“map”)(“FMustQty”)(“FFLD”) Dim obj as bosfield Dim tmp as double Set obj=m_

30、billinterface.billentrys(1).bosfields(“fmustqty”) Obj.row=1；tmp=obj.value,插件开发基础 数据字典包,dctTableInfo包含三部份内容 所有Item的详细信息，以字典的形式保存，采用Key 去查询这个 Key 是用 FTabIndex+Fkey 格式化而成 所有Page的信息，每一个Page是一个字典包含了这一个Page上组成项的Key 这个单据对象的所有Item的Map映射，这是一个字典,提纲,插件开发概述 案例介绍 插件开发基础 插件开发向导 数据结构 K3ClassEvents业务对象接口 BillEvent

31、单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口 K3ClassEvents公用对象 K3Lib 常用元数据表结构,插件对象模型(BillEvent),K3ClassEvents BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口,BillEvent对象,BillEvent对象 MenuBar 概述 BOSBands和BOSBand对象 BOSTools和BOSTool对象 单据基础对象 BillHeads和BillEntrys BOSFields 单据接口 事件 函数、方法 属性,概述,

32、BOSBands、BOSTools对象 是 PublicNotCreatable对象 在BillEvent、ListEvents、BaseClassEvent对象中包含MenuBar属性使用。例如： Dim oMenuBar As K3ClassEvents.MenuBar Set oMenuBar = BillEventObject.Menubar在BillEvent、ListEvents、BaseClassEvent对象新增事件 Sub MenuBarInitialize(ByVal oMenuBar As K3ClassEvents.MenuBar) Sub MenuBarClick(B

33、yVal BOSTool As K3ClassEvents.BOSTool, Cancel As Boolean),BOSBands和BOSBand对象,基本和ActiveBar的Bands、Band对象属性、方法一致BOSBands不能使用 For Each 方法遍历BOSBand对象可以通过 Add 方法来新建BOSBand对象。,BOSTools和BOSTool对象,基本和ActiveBar的Tools、Tool对象属性、方法一致 BOSTools不能使用 For Each 方法遍历BOSTool对象 可以通过 Add 方法来新建BOSTool对象,BOSTools 方法详解,Funct

34、ion 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) 新增方法，特性与上相同,练习,在寄存入库单单据上增加复制按钮的浮动按钮，隐藏“页面

35、设置”菜单 在寄存入库单序事簿上增加单据变更的菜单及按钮 以插件中附带的图片资源文件增加单据变更的显示,BillEvent对象,BillEvent对象 MenuBar 概述 BOSBands和BOSBand对象 BOSTools和BOSTool对象 单据基础对象 BillHeads和BillEntrys BOSFields 单据接口 事件 函数、方法 属性,概述,是 PublicNotCreatable 对象 在BillEvent对象中包含使用。例如： Dim oHead As K3ClassEvents.BillHead Set oHead = BillEventObject.BillHea

36、ds(1) BillHeads、BillEntrys、BOSFields不能使用 For Each 方法遍历对象,BillEntrys对象,BillEntrys对象 包含了和单据体相关的属性 通过这些属性可以在 运行时操作单据体,BOSFields和BOSField对象,BOSField对象 每个字段对象，对应单据（包括单据头和单据体）上的每一个字段 通过这些属性，可以在运行时操作字段。,属性集,BOSField 属性详解,某些属性值只适用于单据头中的字段 FieldTopFieldLeftFieldHeightFieldWidth LabelWidthLabelColorFrameBorde

37、rColorFrameBorder FontNameFontSizeFontBoldFontItalicTextColor某些两者都支持 TableNameFieldNameCaptionPageLayerFKey VisibleNeedSaveMustInputFieldLockNote某些只适用于特殊的字段 Row 仅支持多分录单据体 Filter 仅支持基础资料字段,BOSField 属性详解,Visible:字段显示/隐藏属性,只有设计时没有设计为“可见”状态的字段，才可以在运行时更改可见性状态 FieldLock:只有设计时没有设计为“锁定”状态的字段，才可以在运行时更改锁定状态 V

38、alue:得到字段内码值。即保存在数据库中的值 Number:得到字段查找类型字段查找值 Text:得到字段显示值。即显示在界面的值，不支持通过该属性直接赋值。 Value:得到/设置字段非查找类型字段赋值使用 Number :得到/设置字段查找类型字段赋值使用,练习,通过插件实现寄存入库单新增时默认表体行数为2000行，主要练习BillEntry对象的Maxrows属性 通过插件实现当单据头金额大于10000时，锁定单据头备注字段，主要练习单据Change事件，BosField对象的FieldLock属性,BillEvent对象,BillEvent对象 MenuBar 概述 BOSBands

39、和BOSBand对象 BOSTools和BOSTool对象 单据基础对象 BillHeads和BillEntrys BOSFields 单据接口 事件 函数、方法 属性,事件 Event MenuBarInitialize(oMenuBar As MenuBar) 说明：该事件在菜单、工具栏初始化时发生。 Event MenuBarClick(BOSTool As BOSTool, Cancel As Boolean) 说明：该事件在点击菜单、工具栏项时发生。 Event AfterNewBill() 说明：新建单据对象后发生。 Event AfterLoadBill() 说明：单据对象加载完

40、成后发生。 Event AfterCopyBill() 说明：复制单据后发生 Event AfterSelBill(lSelBillType As Long) 说明：选单操作完成后发生。 Event BeforeVerify(bCancel As Boolean) 说明：单据对象保存前、系统进行校验操作前发生。 Event Change(dct As Dictionary, dctFld As Dictionary, Col As Long, Row As Long, Cancel As Boolean) 说明：单据对象上的字段值发生改变时发生。,BillEvent对象-事件,方法 Funct

41、ion 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

42、 Boolean说明：在多分录单据体中插入一个新行，并填充数据。 Function GetDataFld(dct As Dictionary, Row As Long) As Dictionary说明：获得单据指定字段的值的对象。 Function GetFieldInfoByKey(sKey As String, sPKey As String, lIndex As Long) As Dictionary说明：通过给定的字段的关键名称获得字段的模版的对象。 Function RefreshBill()说明：刷新当前单据对象。 Function IsChange() As Boolean说明：

43、判断单据对象是否被改变。 Function DeleteEntryData(nPage As Long) As Boolean说明：删除单据对象指定单据体分录内全部数据。,BillEvent对象-函数、方法,BillEvent对象-属性,练习,通过插件实现当寄存入库单业务审核后仍可修改单据头备注字段，主要练习单据Afterload事件,单据方法SetBarStatus、SetBillFormCaption 通过插件实现寄存入库单新增时给表体赋一行值，物料代码为”01.001”，应收数量为100，实收数量为100，单价为1500。主要练习Insertnewrowandfill方法,插件对象模型(

44、ListEvents),K3ClassEvents BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口,ListEvents对象,ListEvents对象 事件 函数、方法 属性,ListEvents对象-事件,Event MenuBarInitialize(oMenuBar As MenuBar) 说明：菜单、工具栏初始化时发生。 Event MenuBarClick(BOSTool As BOSTool, Cancel As Boolean) 说明：点击菜单、工具栏项时发生。 Event AfterCopyBillCreateD

45、ata(srcInterID As Long, dctData As Dictionary) 说明：复制已选择的单据数据到新单据，但新单据尚未保存时发生。 Event AfterDeleteBill(bSuccess As Boolean, lBillInterID As Long, sBillNo As String, sErrorMessage As String, bCancelErrorMessage As Boolean) 说明：删除已选择的单据后发生。 Event ListFillRow(lRow As Long, RowData As Object, HeadDict As Di

46、ctionary, CellData As String, BackColor As Long, ContinueRaise As Boolean) 说明：序时簿的行填充数据时发生。,ListEvents对象-方法,Function GetDataFld(dct As Dictionary, Row As Long = -1) As Dictionary说明：获得单据指定字段的值的对象。 Function GetDataFldbyKey(sFKey As String, Row As Long = -1) As Dictionary说明：通过字段关键名称获取字段的值的对象。 Function

47、GetSelectedBillInfo() As Vector说明：获取当前选中的单据的数据。 Function LoadSelectedBill(BillStatus As Enu_BillStatusExt) As Boolean说明：加载当前选择的单据，并按照指定的状态显示。,ListEvents对象-属性,ListFilterString说明：序事簿运行时设置过滤条件,练习,通过插件实现当寄存入库单业务审核后仍可修改单据头备注字段，主要练习序事簿方法LoadSelectedBill 通过插件实现当前登录用户只能看到本人制作的寄存入库单,主要练习序事簿ListFilterString属性

48、,插件对象模型(BaseClassEvent),K3ClassEvents BillEvent 单据接口 ListEvents 序事簿接口 BaseClassEvent 基础资料序事簿接口,对象- BaseClassEvent,BaseClassEvent对象 事件 函数、方法 属性,BaseClassEvent对象-事件,Event MenuBarInitialize(oMenuBar As MenuBar)说明：菜单、工具栏初始化时发生。Event MenuBarClick(BOSTool As BOSTool, Cancel As Boolean)说明：点击菜单、工具栏项时发生。Even

49、t RefreshList()说明：序时簿刷新时发生。Event ListFillRow(lRow As Long, RowData As Object, HeadDict As Dictionary, CellData As String, BackColor As Long, ContinueRaise As Boolean)说明：序时簿的行填充数据时发生。Event ClassGroupSelected(Button As Long, ClassGroupType As Long, ClassGroupID As Long, ClassGroupFullNumber As String)

50、说明：选择基础资料分组时发生。,BaseClassEvent对象-方法、属性,方法 Function SelectClassGroupByID(lClassGroupID As Long) As Long说明：按照指定的基础资料分组的ID定位显示。 Function PitchItemByID(lItemID As Long) As Boolean说明：按照指定的基础资料明细的ID定位显示。 Sub RefreshClassGroups()说明：刷新所有基础资料分组数据。 Function GetSelectedClassID() As Long说明：返回当前选择的基础资料分组的ID。 Function GetSelectedItemID() As Long说明：返回当前选择的基础资料明细的ID。 属性 EnableListFillRowEvents As Boolean说明：是允许否触发插件的序时簿FillRow 事件。默认为False，即不触发。只有当此值为True且发生序时簿行填充时，才会触发插件的序时簿FillRow 事件。,