背景

标准产品提供的单据打印模板不符合客户现有打印格式或内容，但标准模板又不能直接修改（有覆盖风险）或者再客开一个打印功能，重新设计模板，自已写打印逻辑实现，时间成本不允许，那如何快速实现用户需求呢？本文档将做详细说明。

目的

通过本文档指引大家快速实现标准打印模板二次开发。

适用对象

适用于U9实施顾问和客开顾问。

开发要求

会使用打印报表开发平台基本功能（UBFStudio开发工具）★

对U9的业务表单结构有基本了解★

有基本SQL使用经验☆

详细流程

第一步 登录打印报表开发平台

打开UBFStudio开发工具（如果没有此工具请从U9安装金盘中获取UBF金盘），切换到打印报表个性化模式

点击登录按钮，弹出登录窗口，录入服务器地址，“刷新”后加载可用企业及组织信息，选择后，录入用户及密码点击登录（如果根据服务器获取不到任何信息，请查看管理控制台中是否配置了企业信息）

登录成功后，在右侧报表资源管理窗口中选择打印元数据库

第二步、复制模板

找到具体功能节点需要修改的标准打印模板

方式1：使用右上角快速查找功能节点名称，支持模糊查询

方式2：根据文件夹目录查找，文件夹名称一般情况下对应模块应用简称（有部分文件夹是按功能节点定义）

选中需要调整的标准模板右键另存为新的打印模板，录入模板名称，是否默认，标识符（非必要不修改）

第三步、修改自定义模板

如果是模板格式不满足，直接在模板上修改保存。

如果是模板内容字段需要额外增加，需要在左侧工具箱字段面板空白区域右键“添加用户自定义字段”方式增加字段并进行oql配置操作

录入字段显示名称后，点击“fx”按钮会弹出以下对话框，用于确定字段的来源，以及取值条件，找到需要显示的字段，拖拽到显示字段文本框区域内

条件表达式中条件项为根实体页签中字段，条件值为字段页签中的栏位，条件关联原则：

能确定唯一记录即可。

举例：

收货单打印模板增加了料品规格字段，料品是收货单行上的一个属性，那么它的OQL的条件就是：收货单行ID=字段中的收货单行ID值

select UFIDA::U9::PM::Rcv::Receivement.RcvLines.ItemInfo.ItemID.SPECS as 料品_规格

from UFIDA::U9::PM::Rcv::Receivement where 

UFIDA::U9::PM::Rcv::Receivement.RcvLines.ID=Fields!Receivement_RcvLines_ID.Value

如果ID不存在的话那就使用表头的单据号+表体的行号作为唯一条件，即：

收货单行号=字段中的行号字段值 AND 收货单号=字段中的单号字段值

select UFIDA::U9::PM::Rcv::Receivement.RcvLines.ItemInfo.ItemID.SPECS as 料品_规格 from UFIDA::U9::PM::Rcv::Receivement where UFIDA::U9::PM::Rcv::Receivement.RcvLines.DocLineNo=Fields!Receivement_RcvLines_DocLineNo.Value and UFIDA::U9::PM::Rcv::Receivement.DocNo=Fields!Receivement_DocNo.Value

添加完成后在左侧字段列表中图标中为红白相间颜色，将字段拖拽到布局页签中相应位置即可。

PS：这里说明下为什么复制标准模板后只能通过添加自定义字段而不能直接通过数据面板中添加实体字段的方式操作

结论：通过数据面板中添加的字段运行态不会显示值

原因：打印模板中的数据字段需要在后台编写代码去查询实现的，也就是说出厂的时候代码中已经固化了模板中提前预置的字段名，新添加的字段不会改变后台查询逻辑。

解决方案：打印服务会解析打印模板生成的RDL语言，提供了针对自定义字段的OQL解析引擎，转换成数据显示到栏位中。

第四步、发布自定义模板

PS：此操作非必要步骤，如果需要在本地测试验证情况下可执行，如果已经执行过了，再有修改模板内容的动作保存即可生效，不需重复发布（除修改报表属性情况外）

选中模板，右键点击“发布应用“ ，会弹出登录界面，用于确认发布到哪个服务器，哪个企业账套中。

登录后进入报表类型界面，直接点击“下一步”

点击“下一步”，“创建用户打印参照”是为了在打印弹窗的时候能够看到发布的模板，“设定默认参照”是将当前参照设置为用户默认使用参照，按需选择。

点击“执行”按钮完成打印参照预置，同时重置用户针对此参照的自定义设置。

执行完，点击“下一步”按钮，跳转到完成页面，点击完成即可。

第五步、导出模板，导入U9C

选中需要导出的模板，右键选择“导出”，弹出“导出报表元数据”界面，录入保存地址，以及文件标识（可选），包含自定义报表菜单信息（打印不需要）

导出后会得到5个文件

将模板提供给相关人员，导入环境进行测试，登录U9C环境，点击用户右侧显示信息管理工具，找到导入打印模板在线功能。

将导出的模板文件（5个）拖拽到此区域内，完成上传动作。

打开具体功能节点，验证打印模板是否存在，选择后进行打印测试。