1 开发工具
1.1 软件名称
名称：TIBCO Jaspersoft Studio
版本：6.0或以上，建议6.2.1
1.2 软件安装
免安装软件包，拷贝即可使用，建议放在D：盘或其它自己好找的目录。
拷贝好软件后，可为主程序创建一个快捷方式：
1.3 TIBCO Jaspersoft Studio界面说明
安装好后打开主界面，关掉欢迎页面，即可出现开发主界面，如下：
打开或设计报表时，为如下界面：
2 报表设计
2.1 工作空间设置
打开主菜单“File —> Switch WorkSpace”，选择你打算存放报表工程及报表设计文件的目录。
点击OK后，程序将自动关闭并重新启动。如果没有重启，请手工重新打开。
2.2 报表工程目录结构说明
重新打开界面后，系统会自动创建一个默认的报表工程：
此时，在你工作空间所在目录会生成如下文件夹：
在MyReports目录里创建3个目录：
l JSON：用于后期存放在设计报表格式时用到的样例数据文件
l DataAdapter：用于存放设计报表需要定义的数据源
l Print：报表设计文件（*.jrxml）及编译好的报表格式文件（*.jasper）
2.3 生成JSON数据文件
l 用浏览器打开猿猿企业管理系统（这里以谷歌浏览器为例进行说明），登录后打开需要设计打印格式的功能界面（如采购订单），打开（或新建）一张有多行商品数据的单据。
l 按下F12，打开调试界面，在单号位置输入单号回车，如下图。
按图中的步骤，找到JSON数据，并将其全部复制出来(也许是第一个action，也可能是最后一个，更有可能是几个合起来（,"SER_FWDFASP":[{"YH）。
l 可在浏览器中打开JSON解析工具对JSON字符串进行格式化。解析工具地址：http://www.bejson.com/jsonview2
l 将刚才格式化好的JSON字符串复制粘贴到新建的文件中，并进行编辑：
n 将前5(7)行替换为【{"PUR_CGDD":】
n 后4行替换为 【}】
n 替换完毕后，能在试图中看到以下结构则表示格式正确，可以继续后续操作：
n
l 切换到报表设计工具，在报表工程的JSON目录创建一个JSON文件：
在JSON目录点鼠标右键àNew/Fileà输入文件名PUR_CGDD1.json-->Finish
l 将刚才编辑好的JSON字符串全选，拷贝到新文件中。
l 样例数据到此准备就绪。
2.4 创建数据源（Data Adapter）
在工程的DataAdapter目录点右键àNewàData Adapter，打开如下界面：
点Next：
选择JSON File，点Next：
输入数据源名称；
File/Url位置选中刚才建好的json文件名；
选择Use the report JSON expression when filling the report。
点击Finish。
测试一下，成功则进入下一步。
2.5 创建主报表
在Print目录（或其子目录）点右键àNew/Jasper Report，打开如下界面：
Next：
输入打印报表名称PUR_CGDD1.jrxml，Next：
选择刚才建好的数据源，在下面的列表里选中主节点“PUR_CGDD”，Next
可用字段全选，Finish。（主报表不需要设置分组字段Group by）
界面上出现了一个待设计的空打印模版。
上面有若干个栏位，删除其他栏位，保留Page Header、Detail 1、Page footer，并适当拉宽3者的高度，以方便放置内容。
2.6 设置打印纸张
在下图方框区域点右键àPage Format…，调出纸张设置对话框：
按纸张实际大小进行设置，注意将所有单位设置成mm（毫米）。
2.7 放置打印内容
2.7.1 静态文本
在右上方组件区域找到【Static Text】，鼠标选中后，在页面空白处点击一下或者拖放到页面，即可增加一个静态文本组件。
双击该组件可对需要显示的文本内容进行编辑。通过工具栏的相关按钮可对字体、文本对齐方式、组件对齐方式进行调整。
2.7.2 单据字段
在屏幕左下方的组件列表中找到Fields列表，将需要的字段拖放到报表上。当拖放到Detail 1区域时，系统会生成一个静态标签和一个字段值标签，拖放到其他位置时只有字段值标签。
将组件进行相应编辑，并拖放到PageHeader的相应区域。
继续添加完其它字段内容，预览如下：
2.7.3 条码
条码在拖放到报表上时，会要求选择条码格式，请按公司扫码设备要求进行选定。选定后，在右下方的组件属性栏选择“AdvancedàCode Expression”，弹框选择对应的字段即可。
2.7.4 合计字段配置 ?
在界面右下方的报表元素列表Variables栏增加一个Variable；
在右边的属性中做如下设置：
报表元素
取值必须修改为Double类型，不然无法相加数据，Double才正常
①
②
最后把这个Variable拖拽到ColumnFooter区域。
2.7.5 数量金额格式设置
选中相应的数量、金额字段后，在属性页面找到属性”TextField Properties/Pattern”，点后面的按钮调出格式设置对话框进行设置即可。
2.8 创建子报表(多个query.action时，子表需关联新的json)
在右上方将Subreport拖入Detail 1，弹出如下界面：
选择Create anew report，Next，默认纸张，输入子报表的文件名：
然后选择数据源：
Next，与主报表一样选择所有字段，再Next，选择Group by 字段（CKKQID）：（只有需要按某字段分组时才选此项，否则直接Next）
Next，选择子报表获取数据表达式：
按下列表达式填入文本框，其中最后的双引号中是子表对应的JSON节点名称。(填入软件)-改expression为主目录"PUR_CGDDMX.J"
|
((net.sf.jasperreports.engine.data.JsonDataSource)$P{REPORT_DATA_SOURCE}).subDataSource("PUR_CGDDMX") |
点击Finish，生成子报表，子报表只保留“Column Header、Detail 1、Column Fooder”三个区域。
然后将商品明细需要展示的字段拖到Detail 1区域，并排版。
((net.sf.jasperreports.engine.data.JsonDataSource)$P{REPORT_DATA_SOURCE}).subDataSource("CRM_VIPCLXX")
CRM_VIPCLXX取值另外一个aciton的CRM_VIPCLXX
跨表取值必须建立子报表
subDataSource取值
2.9 分组设置
首先，在子报表创建时，在Group by页面选择要分组的字段（采购订单上为：CKKQID）；
在子报表设计页面左下方的CKKQID Group Header，点右键Add Header Band；
将CKKQID、CKKQMC等字段配置到新增加的Group Header Band区域。
所有设置完毕后，预览效果，如下：
分组增加代码：1、 <sortFieldname="FABHMC" order="Descending"/>
（order=“Descending”表示倒序排列）
2、分组重新开页
2、<groupname="FABHMC"isStartNewPage="true">
<groupExpression><![CDATA[$F{FABHMC}]]></groupExpression>
</group>
3、合计按分组打印
3 报表文件的配置与发布
l 报表文件设计好后，经过编译(BuildALL)，可在报表目录生成*.jsper文件。
l 将两个*.jsper文件拷贝出来，放在Tomcat/bin/resources/print目录下与该功能界面jsp相同的子目录中。
l 并在界面配置表中按钮定义表里打印按钮的AURL字段设置为对应的主报表文件名称。
l 报表格式即发布成功。
编辑窗口：
1、 显示不了中文：
Ⅰ编码转换
Source添加如下内容：
<propertyname="com.jaspersoft.studio.data.defaultdataadapter"value="OneEmpty Record"/>
<propertyname="com.jaspersoft.studio.unit."value="mm"/>
<propertyname="com.jaspersoft.studio.unit.pageHeight"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.pageWidth"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.topMargin"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.bottomMargin"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.leftMargin"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.rightMargin"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.columnWidth"value="mm"/>
<propertyname="com.jaspersoft.studio.unit.columnSpacing"value="mm"/>
<stylename="myStyle"isDefault="true"pdfFontName="STSong-Light"pdfEncoding="UniGB-UCS2-H"isPdfEmbedded="true"/>
II时间格式转换：newSimpleDateFormat("yyyy-MM-dd HH : mm : ss").format(newjava.util.Date(Long.parseLong($F{SHRQ_SJ})))
III空值改成不显示
IX打印分组：
1、 对BXBJ进行分组
2、 将BXBJ字段复制到新增分组
X.将数字进行文字判断转换（待研究）：
IF ($F{BXBJ}=="0","选修","必修")
XI．将分页改为按分组计算：
4 问题总结
4.1 日期显示问题
描述1：jaspersoft 上显示的是日期时间，在网页上为秒数
解决：网页json转jaspersoft时会成为日期时间的，所以要加上日期函数
描述2：有日期函数的可以为空。
解决：运用三元运算符做判断，jaspersoft不能用if…else；有日期函数时，为空会报错。
$F{YQJCSJ}.equals("0")?"无":newSimpleDateFormat("yyyy-MM-dd").format(new java.util.Date(Long.parseLong($F{YQJCSJ})))
描述3：在网页json上加上了相应的字段，但是在网页上还是显示不出来。
解决：单单在网页json上添加是不能显示的，还需在数据库相应的表上添加相应的字段；
4.2 其它
用double和INT刚好取值0有问题
用java.math.BigDecimal这个方法避免
4.3 模板三目运算判断
连续的三目判断：
表达式：
|
($F{ZCZT}.equals("1")) ? "在库" : (($F{ZCZT}.equals("2"))? "在用" : (($F{ZCZT}.equals("3"))? "闲置" : (($F{ZCZT}.equals("4"))? "维修" : (($F{ZCZT}.equals("5"))? "借出" : (($F{ZCZT}.equals("6"))? "报废" : (($F{ZCZT}.equals("7"))? "调拨售出" : (($F{ZCZT}.equals("8"))? "盘亏待处理" : ($F{ZCZT}.equals("9"))? "盘亏" : "Cancelled"))))))) |
如：
