金蝶BOS6.1平台开发笔记-入门实战篇

文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 1 16 金蝶金蝶 BOS 平台开发笔记平台开发笔记 一 一 入门篇 新建 修改一个主从表入门篇 新建 修改一个主从表 1 建主表建主表 第一步 在业务建模视图下 新建业务单元 我们新建一个名为 MainChild Demo 的单元 别名起为 主从表演示 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 2 16 点击下一步 创建方式选择 直接新建 完成 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 3 16 生成的主表如下图 系统自动创建了 4 个编辑字段 另有一些字段未在本界面显示 在此不做详 述 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 4 16 2 新增单据体 新增单据体 仍然在业务视图下 在生成的 主从表演示 界面上右键 选择 单据信息 点击 新增单据 体 新增的单据体即是从表 3 字段管理字段管理 在界面上右键选择 字段管理 弹出字段管理界面 新增主表字段 新增主表字段 在左侧选择 主从表演示 然后点击 新增字段 即可增加主表字段 我们新增一个 mainfield1 字段描述 主表字段 1 如下图 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 5 16 新增从表字段 新增从表字段 在左侧选择 第一个表体 然后点击 新增字段 即可增加从表字段 我们新增一个 childField1 字段描述为 从表字段 1 如下图 4 点击保存点击保存 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 6 16 5 查看新建单元所产生的对象 查看新建单元所产生的对象 打开业务设计视图 在目录下找到本次新建单元产生的所有对象 见下图中选中部分 各扩展名结尾文件的含义如下 Entity 实体对象 Table 数据表 Query 查询表 Relation 实体关系表 即实体间对应关系 Ruleset Ui 界面 Bizunit 业务对象 6 修改实体对象修改实体对象 1 主表实体对象的基本信息 主表实体对象的基本信息 双击打开 MainChild Demo entity 首先展示的是实体对象的基本信息 见下图 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 7 16 父实体对象 父实体对象 是 MainChild Demo 实体对象的父类 可以看到 它继承自 com kingdee eas framework app Database 对象 从这个对象继承过来的对象 拥有数据库编辑方面的 功能 对应表对象 对应表对象 这个是实体对应的物理数据表 可以看到 它对应的是 com kingdee eas xuehongtao demo app CT DEM MainChild Demo 蓝色部分是数据表路径 根据每 个人新建单元时选择的文件夹不同而不同 2 从表实体对象的基本信息从表实体对象的基本信息 双击打开 MainChild DemoE1 entity 如下图 父实体对象 父实体对象 MainChild DemoE1 实体对象的父类为com kingdee eas framework app BillEntryBase 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 8 16 对应表对象 对应表对象 从表对应的物理数据表为 com kingdee eas xuehongtao demo app CT DEM MainChild DemoE1 3 主表实体对象的属性主表实体对象的属性 点击下方的页签 属性 可以打开实体对象的属性页 如下图 展开左侧属性树 可以看到实体的继承层次 及各层次下继承来的属性 黄色钥匙符号的字段为自有属性 蓝色圆球符号的为连接属性 其中 E1 为我们所建立的连接从表的连接属性 mainfield1 是我们建立的主表的自有属性 4 从表实体对象的属性从表实体对象的属性 其中 parent 属性为从表关联主表的属性 该属性是连接属性 可以看到 在编辑关联属性所对应的 字段处 该字段关联主表字段的值为 FParentID Childfield1 为从表的自有属性 主从表实体对象的关联 就是通过主表的主从表实体对象的关联 就是通过主表的 E1 字段 和从表的字段 和从表的 parent 字段进行关联的 字段进行关联的 5 修改主表实体对象属性修改主表实体对象属性 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 9 16 字段 E1 该字段用于与从表的关联 从 主表实体对象的属性 图可以看出该字段还未指定在主表 中的对应字段 这里我们选择 FID 字段作为关联从表的字段 7 查看主从表实体对象关系查看主从表实体对象关系 双击打开 R MainChild Demo MainChild DemoE1 relation 该实体关系的类型为 Composition ClientEntity 主表实体对象 SupplierEntity 从表实体对象 多重性 表明了主从表之间是 一对一 多对多 还是 一对多 的关系 这里默认为一对多的关系 8 测试主从表测试主从表 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 10 16 1 在客户端创建自己的菜单 在客户端创建自己的菜单 在业务视图模式下 在业务单元管理里随便选中一个文件夹 然后点击菜单 方案 主菜单管 理 如下图 在弹出的主菜单管理管理界面 可以在根菜单下建立自己的子菜单目录 也可以直接在根菜单下直 接建立菜单项 如下图 我们创建了 薛宏涛 目录 并在 薛宏涛 目录下创建了子菜单项 测 试 通过点击浏览按钮 找到刚刚创建的 主从表演示 业务 确定 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 11 16 2 运行客户端运行客户端 点击菜单 运行 启动客户端 或者从工具栏直接点击 启动客户端 按钮 运行客户端 3 测试主从表测试主从表 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 12 16 启动客户端 输入用户名密码 登录成功后 可以看到我们刚刚创建的菜单项 双击 测试 即弹出主从表的 List 界面 点击菜单 文件 新增 或者从工具栏点击最左侧的新增按钮 弹出编辑界面 直接在里面就 可以输入数据和分录 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 13 16 输入数据保存后 就可以在 List 界面看到数据记录了 9 后记后记 通过以上几步操作 我们就实现了最简单的主从表 不用写一行代码 可以进行简单地数据录入及 列表展示 最后 想要补充说明的一点是 金蝶的 SDK 都是教你如何在设计视图模式下 从新建实体 entity 生成物理表 table 新建实体关系 relation 新建查询 query 新建编辑和列表界面 ui 一步步实现 以上操作的 作为一名求甚解的合格的程序员 嘿嘿 理论上这么做可以让我们快速地了解整个二 次开发平台的原理 可惜的是 金蝶的 SDK 写得实在太浅显了 而且没能完整地教你如何实现一个 业务 本人在学习的时候 也曾试图走一遍设计视图下实现的模式 最终因为对整个平台不够熟悉 再加上金蝶自身的 BUG 较多 约束较多而流产 所以 如果你是初学 还是先走一遍上面这个例子 吧 二 二 为按钮控件为按钮控件 KDButton 添加事件添加事件 假设在 ClientInfoListUI 界面添加一个按钮 kDButton1 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 14 16 1 方法方法 1 1 双击该按钮会生成如下代码 注 不要直接在该处写 Java 代码 此功能金蝶尚未开发 仅 留一个接口 2 保存 发布 ClientInfoListUI ui 3 切换到 Java 视图 找到对应的 Java 类 选中该类所在的父节点 本例为 Client 节点 刷 新 则在抽象类 AbstractClientInfoListUI java 中已经生成了按钮的单击事件 4 在实现类 ClientInfoListUI java 中重写该方法即可 2 方法方法 2 1 在设计视图下 打开 ClientInfoListUI 然后打开大纲视图 文档名称 金蝶 BOS 平台开发笔记部门 文编制 版本号 文档审核 日期 15 16 2 在 Actions 节点上右键 选择 输入类和实例名 完成 3 在 UI 目录下 向下找到 kdButton1 选中 4 打开属性页 在行为的 action 项选择