BOS进阶培训-套打二次开发

版权所有 1993蝶软件 (中国 )有限公司 套打二次开发 金蝶软件（中国）有限公司 商业分析系统部 李馥龙 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 相关概念 套打 什么是套打？套打能做什么？ 行业：在印刷好的表格中打印内容 (凭证、帐簿、支票 ） 打”：自定义格式的 票据 、 单据 、 报表 的打印 广义 的概念， 理除序时簿打印之外所有打印需求。 名称由来？ 沿袭 版权所有 1993蝶软件 (中国 )有限公司 套打模式 主要特征：每页格式一样，不在于是否用套打纸 相关概念 套打 报表模式 版权所有 1993蝶软件 (中国 )有限公司 相关概念 基本原理 “平台”？“控件”？ 模板 + 数据 = 结果 版权所有 1993蝶软件 (中国 )有限公司 相关概念 基本原理 模板统一管理 使用 (调用 )分散在各业务界面 “平台”？“控件”。 不是子系统树 目录名称不能乱改 版权所有 1993蝶软件 (中国 )有限公司 相关概念 文件类型 套打元数据 提供一种集成方式、字段的描述信息、 只影响模板设计 (* 板 （废） (* 板 (*版权所有 1993蝶软件 (中国 )有限公司 相关概念 003 2006 2007 2008 1 2 3 表平台 套打 控件 ) ) 4 1 扩展报表 展报表 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 数据源设置 组件及规则 基本模式 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 参考资料 参考 用户手册 参考 套打模板制作 （主要讲模板规则） 研发内网 商业分析知识库 设计器 示例模板生成向导 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 数据源设置 添加、删除、重命名、参数设置、查看引用信息 重命名 (可能有代码依赖 ) 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 组件及规则：页 一个模板，自动对应了一个 页 对象。 页是模板的可设计区域。通常，页的大小为纸张大小减去四边距后的尺寸，此时页与纸张一一对应，套打模式和大部分报表模式就是这种情形。 当多数据源的报表模式，设计时内容就很多，此设计区域容纳不下的时候，允许修改页的高度。 运行时，页自动与主数据源绑定。如果不存在“能引起分页的对象（如数据表）”绑定主数据源，则主数据源自动移至其下一条记录使页重复输出。 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 组件及规则：单元对象 单元对象包括： 文字 对象、 金额 对象、 图片 对象，它提供了一块固定的区域，用于展现对应的内容。此内容可以是绑定字段，或自定义的固定内容。 执行时，单元对象本身不引起分页，也不会引起数据源行集移动至下一条记录。 注意区别，“单元对象”是离散的矩形区域，不等同于表格的“单元格”。 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 组件及规则：数据表 数据表 是一种表格，它由规整的行、列组成，行列的交汇处为单元格。 行、列、单元格 是组成表格的基本元素。（注意区别“单元格”不等同于“单元对象”） 数据表具有分组展现、统计功能，其数据行能根据数据源行集的每一行重复输出，它是一种可能引起分页的对象。数据表必须绑定唯一的一个数据源。 行： 普通行、分组行、数据行 “ 套打型 ”和“ 报表型 ” 单元格，类型 (文字、字段、统计、容器等 )， 融合 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 组件及规则：网格 网格也是一种表格，同样由行、列、单元格是组成。 网格本身不绑定数据，它的行没有类型；单元格可以输入文字、绑定字段或者作为容器放置其它对象。 二个主要作用： 布局 (展示 )、 组合多个数据表 版权所有 1993蝶软件 (中国 )有限公司 为了满足不确定内容的横向、折行排列需求 。 设计期定义的一块可供重复内容的区域，以及区域中的一个容器（可以直接绑定字段或放置内容组合）。区域绑定数据源。执行时，数据源的行集，每一行对应输出一个容器，并按预先设置好的方向排列：横向折行或纵向换列。 模板设计概述 组件及规则：动态列表 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 基本模式 票据模式 单据套打模式 多数据源单据套打模式 报表模式 多数据源报表模式 版权所有 1993蝶软件 (中国 )有限公司 票据模式 单据套打模式 多数据源单据套打模式 报表模式 多数据源报表模式 模板设计概述 基本模式 1 主要特征： * 单数据源 * 数据源的每一行记录对应一张票据 * 不带分录 直接在页面上放置单元对象、可导入背景图片 执行时，页自动与数据源绑定，对应行集的每一条记录重复输出多张票据。 版权所有 1993蝶软件 (中国 )有限公司 票据模式 单据套打模式 多数据源单据套打模式 报表模式 多数据源报表模式 模板设计概述 基本模式 2 如： 单据 据其它字段 分录 录其它字段 第 1行 单据 A 分录 第 2行 单据 A 分录 第 3行 单据 B 分录 第 4行 单据 B 分录 第 5行 单据 B 分录 第 6行 单据 C 分录 单数据源，数据表按单据 据行设置套打型，分组行设置每页出现。 21 版权所有 1993蝶软件 (中国 )有限公司 模板设计概述 基本模式 3 票据模式 单据套打模式 多数据源单据套打模式 (如带审批的单据 ) 报表模式 多数据源报表模式 并列放二个数据表，套打型 在前例的数据源 (分组 )的基础上，只能做成套打型。若希望做成报表型，必须修改数据源结构 (变成 多数据源报表模式 )。 2 2 合起来，做分组 版权所有 1993蝶软件 (中国 )有限公司 票据模式 单据套打模式 多数据源单据套打模式 报表模式 多数据源报表模式 模板设计概述 基本模式 4 “报表型”区别于“套打型”的特点是：不限定每页显示数据行数，行高可随内容自动调整（行高自适应），通常为第一页开头是表头，表体内容跨若干页，最后一页是表尾的形式。 和单据套打类似，用一个数据表就可以解决问题。对数据表做必要的分组；数据行设置为“报表型”；普通行、分组行的“每页出现”属性按需要设置。分组统计如果做在分组行，就是这一层分组的小计；做在普通行则是总计。 版权所有 1993蝶软件 (中国 )有限公司 票据模式 单据套打模式 多数据源单据套打模式 报表模式 多数据源报表模式（简历模式） 模板设计概述 基本模式 5 2 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 套打调用基本 提供了统一的套打调用 数据提供者 套打控件只识别取数接口（现在也提供查询 推荐使用），具体的取数实现都是各业务集成时各自实现。对于实现取数接口的、给套打执行时提供数据的类，称之为 数据提供者。 业务开发中，通常界面上会有 打印 / 打印预览 按钮，在框架的 有类似 打的调用代码写在这样的方法中。 版权所有 1993蝶软件 (中国 )有限公司 套打调用基本 印 参数说明： 务对应的路径，即套打管理中模板所在文件夹。 （注：在框架中，由 方法指定。） 据提供者对象，参考 数据提供。 （注：在框架中，可能做了查 允许由)方法指定一个 窗口或其上的一个控件，用以实现弹出窗口的模态。 可省略。打印前是否弹出选择打印机的对话框。标准业务通常省略（缺省为 可做“直接打印”。 这不是套打控件规定的用法 了解，但不要被束缚。 版权所有 1993蝶软件 (中国 )有限公司 套打调用基本 印预览 参数说明： 务对应的路径，即套打管理中模板所在文件夹。 （注：在框架中，由 方法指定。） 据提供者对象，参考 数据提供。 （注：在框架中，可能做了查 允许由)方法指定一个 窗口或其上的一个控件，用以实现弹出窗口的模态。 版权所有 1993蝶软件 (中国 )有限公司 套打调用基本 1 模板 取数接口 板 取数接口 适 配 器 控件的内部实现，业务开发不用关心。 了解，不会有疑惑。 代码只能有一份（要么旧的，要么新的）；模板可能是任意的。 怎么办？ 版权所有 1993蝶软件 (中国 )有限公司 套打调用基本 什么套打管理的目录名称不能乱改？ (大小写敏感 ) 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 取数接口说明 自定义实现 查 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 取数接口说明 * * 1 套打模板中一个“数据源”，在执行过程中，执行引擎会通过此取数接口找集成环境要数据。 版权所有 1993蝶软件 (中国 )有限公司 客户端 数据提供者 取数接口说明 业务场景 套打控件 I 执行引擎 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 取数接口说明 实现示例（ 注意，不是套打控件规定的用法 ） et 1 ; ; ; ; . e) ; ., ); , ; 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 取数接口说明 1 1 /* 数据源名称 */ /* 取得表示数据源依赖于其它数据源的参数 */ 1 /* 取得指定名称的参数 */ 1* 引用 () /* 取得所有排序字段 (目前只是分组字段 ) */ 1 /* 创建 * 它包括了动态查询、模板中指定的排序等信息。 * 注意它不包含参数信息 (如 */ 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 取数接口说明 如果模板中存在多个数据源，执行时也都是通过这个唯一的接口取数。实现代码中通过 识别不同数据源。换句话说，数据源名称是集成环境预先定义好的，模板中必须按此命名。当然，如果模板中直接引用 取数实现又对查 如使用了则名称无关紧要。 通常多数据源存在“主 构，即 有依赖的情况，主数据源被依赖的字段值发生变化，从数据源会被要求重新取数 。所以，即使是模板设计时逻辑上的“一个”数据源，也可能是多次由 时，从数据源的取数是必须通过取得所依赖的值作过滤的。 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 自定义实现 1 主数据源名称 ) /可能会以选中数据的 ; 从数据源名称 ) ; (= ; /以参数值为过滤条件取数据，构造 /其它分支 版权所有 1993蝶软件 (中国 )有限公司 数据提供者 自定义实现 自行构造 );/3列 , , , i = 1; i 0) (); ; /返回参数值为 /其它分支 数据提供者 1 主数据源名称 ) /可能会以选中数据的 ; 从数据源名称 ) ; (= ; /以参数值为过滤条件取数据，构造 /其它分支 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 二次开发 何谓“二次开发” ? （此处省去一万字） “二次开发”是很空泛的说法，看具体做什么事情。 写代码新做的业务模块 标准业务数据不满足要求 版权所有 1993蝶软件 (中国 )有限公司 二次开发 写代码新做的业务模块 在按钮的事件代码中调用套打控件 定模板所在路径及数据提供者。 成模板存储路径、套打元数据、模板。 可以在 方法改变模板所在路径； 可以在 方法改变缺省的给套打提供数据的 由于自动生成的代码使用了 以在模板中直接引用任意 行时就是用该 标准业务数据不满足要求 财务，大部分是代码构造 供应链、协同，大多是指定固定的 以改这个 供应链， 协同 (?)，在 （ if，代理） 版权所有 1993蝶软件 (中国 )有限公司 二次开发 标准业务数据不满足要求（续） 怎么确定标准模块写死的是哪个 猜！ 问！（业务模块是否有帮助文档？） 反编译！ 能不能知道当前场景用的是哪个数据提供者？ 在预览界面按 版权所有 1993蝶软件 (中国 )有限公司 二次开发 结果集再加工 /* * 允许二次开发对套打数据源结果集再加工 */ /* * 对结果集再加工 * 统得到的结果集 * 板的数据源信息 * * ( 版权所有 1993蝶软件 (中国 )有限公司 二次开发 “连续套打” 业务上需求，控件没有连续不连续的概念。 张单据） = 张单据） 模板可能需要稍微修改（假如做分组）。 版权所有 1993蝶软件 (中国 )有限公司 二次开发 数据汇总 （月度订单汇总、部门工资汇总、 ） 数据提供的方式 定制 板引用它 （必须 或者有办法扩展过不同名称识别不同数据源。 本质： 模板的方式 版权所有 1993蝶软件 (中国 )有限公司 二次开发 单据加审批意见 数据提供的方式 使 模板的方式 单据号 55 版权所有 1993蝶软件 (中国 )有限公司 二次开发 按计量单位合计 A 1件 B 2个 C 3件 D 4个 共 4件 ,6个 模板目前不支持做这样的统计，只能由数据源提供。 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 直接打印 “直接打印”？ 直接打印 1 第四个参数 第一次用选模板时记缺省模板。 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 直接打印 直接打印 2 第一个参数是指向模板，不是指向模板所在目录。 “ / = “ / 第三个参数， 览 = 可以单独弹出选模板对话框：（要挂另一个按钮，还要保存结果） 一次模板全路径； 标文件夹。 返回：模板全路径和别名 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 打印次数控制 打印次数控制（或记录打印日志） 在 打印 按钮事件中做？ 选打印机时取消、预览后点打印、预览后不打印 在 意， 以认为就是真实的打印发生了。 打印时是与外部设备（打印机）通讯，由于技术上的原因，目前不存在“打印后”或“打印顺利完成”事件。 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 打印次数控制 /* 在套打管理中，可以对一个业务单元 (文件夹 )设置数据的最多打印次数。此方法用于获取该设置值。 */ * 如果在一个业务路径上设置了打印次数控制，该方法将返回 */ * 取得打印设置中，一次打印的份数。 */ /* 设置一次打印的份数。 */ * 取消打印 */ 通常的实现逻辑：数据的实际打印次数由业务开发自行管理。每次打印前，判断已打份数是否达到 最多打印次数 （ 达到了不能继续， 取消打印 （ 再判断已打份数加上 将打份数（ 否超过最多打印次数，超过则 调整当前打印份数（ 记录已打印次数。 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 导出 导出 前三个参数与 样，将内容写到第四个参数输出流。 客户端的使用 不建议使用 此接口，而是安装 普通打印一样进行。 版权所有 1993蝶软件 (中国 )有限公司 高级应用及 万佛朝宗 /* * 预览的初始状态，默认为整页。也可以设置为 100%。 * * * */ 一个用套打做 版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 常见问题分析处理 新添加的字段出不来 只是改了套打元数据， 字段名称是否对应？ 修改的不是代码中写死的那个 所有字段出不来 模板原因（ 整个页面空白。 数据源名称依赖代码？ 取数出异常？ 部分单据出不来， 联接 /外联接。 版权所有 1993蝶软件 (中国 )有限公司 常见问题分析处理 怎样检查数据源有没有数据或某些字段有没有值？ 模板，用数据表做最简单的列表。 开发阶段，在数据提供者 检查 要加上单据 版权所有 1993蝶软件 (中国 )有限公司 常见问题分析处理 看日志 回调的取数代码发生在这二句日志之间（向外抛时没有 ）： s s 果是 应地是： s s 67 版权所有 1993蝶软件 (中国 )有限公司 常见问题分析处理 打印问题 预览正常，输出到打印机有问题 金蝶 (009产品知识 金蝶 金蝶 (黄勇 2009版权所有 1993蝶软件 (中国 )有限公司 目录 1、相关概念 2、模板设计概述 3、套打调用基本 、数据提供者 5、二次开发 6、高级应用及 、常见问题分析处理 8、附：模板中的脚本 版权所有 1993蝶软件 (中国 )有限公司 模板中的脚本 简介 一、脚本语法 1、该脚本系统采用类 2、面向对象的设计：调用一个对象 (假设其名称为 某个方法 (假设为 书写为： ；如果是当前对象，则 接写为： 。后续说明中，以“ 对象 ”描述，方括号表示可省略。对象相关的方法在第一栏中列出。 3、对象无关的方法，称为静态方法。在第二栏中列出。 4、大小写敏感。 5、变量定义，示例： a = b + 1; 请注意，所定义变量的作用域最大只在当前脚本块，全局变量请使用 、 函数。 二、什么是“前处理” /“后处理”？ 执行引擎在解析模板过程中，处理