Pentaho Report Designer生火指南 // 雲之彼岸

一、认识Pentaho Report Designer

二、设计第一个报表

1、添加数据源

1、点击右侧Data选项卡添加数据源：

2、在打开的界面中创建一个新的连接：

3、然后新建查询

点击Preview可预览数据

2、设计报表格式

2.1 逐行数据显示

将数据项拖动到Detail Body区块即可

2.2 增加一个图表

1、从左侧工具栏将图表拖动到Report Header区域

2、双击图表进去设置属性

2.3 分组

右侧Structure选项卡右键点击Master Report，选择Add Group即可。

3、预览报表

点击预览设计区左上角预览图标进行预览：

三、为报表添加参数

右侧Data选项卡下方Parameters - Add Parameter

打开的界面定义参数：

数据源中引用参数

使用${param}格式嵌入Query中即可，如定义参数名称为category，则类似Query如下

select * from product where catagory = ${category}

四、函数与表达式

右侧Data选项卡Functions - Add Function

选择内置的函数，同行选择Running函数做一些聚合计算。

然后点击新建的函数，在下方属性中定义名称及表达式：

五、发布报表

菜单选择File - Publish

然后输入Pentaho BI地址和用户名、密码：

然后填写发布名称、路径等：

点击”OK“等待发布完成。

发布完成后即可在BI Server上浏览报表：

六、项目中引用报表

使用Java API调用Pentaho Report Engine直接渲染输出

如：

try {
	URL urlToReport = new URL("file:" + request.getServletContext().getRealPath("WEB-INF/report/" + reportFile));

	ResourceManager manager = new ResourceManager();
	manager.registerDefaults();
	Resource res = manager.createDirectly(urlToReport, MasterReport.class);
	MasterReport report = (MasterReport) res.getResource();
	if (MapUtils.isNotEmpty(params)) {
		for (String key : params.keySet()) {
			report.getParameterValues().put(key, params.get(key));
		}
	}

	if ("pdf".equalsIgnoreCase(rendererType)) {
		response.setHeader("Content-disposition", "filename=" + System.currentTimeMillis() + ".pdf");
		response.setContentType("application/pdf");
		PdfReportUtil.createPDF(report, response.getOutputStream());
	} else {
		response.getWriter().write("不支持的报表格式！");
	}
} catch (Exception e) {
	try {
		e.printStackTrace();
		response.getWriter().write("报表生成失败！");
	} catch (IOException e1) {
		e1.printStackTrace();
	}
}

通过BI Server的URL进行嵌入

URL格式如下：

http://10.142.80.231:8080/pentaho/api/repos/%3Ademo%3Abtopic2.prpt/report

七、TroubleShooting

PDF格式中文乱码问题

对中文元素使用设置为中文字体，如宋体等。

引用Report地址，Pentaho BI Server弹出框要求输入用户名，密码

修改pentaho-solutions/system/applicationContext-spring-security.xml，在filterChainProxy中api, plugin对应增加requestParameterProcessingFilter。修改后如下：

<bean id="filterChainProxy" class="org.springframework.security.util.FilterChainProxy">
  <property name="filterInvocationDefinitionSource">
    <value>
      <![CDATA[CONVERT_URL_TO_LOWERCASE_BEFORE_COMPARISON
      PATTERN_TYPE_APACHE_ANT
      /webservices/**=securityContextHolderAwareRequestFilterForWS,httpSessionPentahoSessionContextIntegrationFilter,httpSessionContextIntegrationFilter,basicProcessingFilter,anonymousProcessingFilter,exceptionTranslationFilterForWS,filterInvocationInterceptorForWS
      /api/**=securityContextHolderAwareRequestFilterForWS,httpSessionPentahoSessionContextIntegrationFilter,httpSessionContextIntegrationFilter,requestParameterProcessingFilter,basicProcessingFilter,anonymousProcessingFilter,exceptionTranslationFilterForWS,filterInvocationInterceptorForWS
      /plugin/**=securityContextHolderAwareRequestFilterForWS,httpSessionPentahoSessionContextIntegrationFilter,httpSessionContextIntegrationFilter,requestParameterProcessingFilter,basicProcessingFilter,anonymousProcessingFilter,exceptionTranslationFilterForWS,filterInvocationInterceptorForWS
      /**=securityContextHolderAwareRequestFilter,httpSessionPentahoSessionContextIntegrationFilter,httpSessionContextIntegrationFilter,httpSessionReuseDetectionFilter,logoutFilter,authenticationProcessingFilter,basicProcessingFilter,requestParameterProcessingFilter,anonymousProcessingFilter,exceptionTranslationFilter,filterInvocationInterceptor]]>
    </value>
  </property>
</bean>