软件公司开发项目时,报表功能已成为必不可少的一部分。客户的报表需求千变万化,研发出来的东西客户不满意,二次开发或推翻重写现象屡见不鲜。报表部分功能复杂,再加上复杂的业务逻辑,稍微一点变动的需求,都需要花费更多的时间来调整完善,开发成本高,人员变动时很难维护。无法快速的调整报表功能,使整个研发周期变长,严重时会导致项目交付延后。选择可动态调整,快速形成需求报表的报表工具能最快解决项目报表功能。
盈帆报表工具可快速的制作、生成报表,并可以整体打包,作为整体项目的一个模块,项目内部中使用代码调用进行模块化的项目集成,也可以作为单独的报表系统服务来进行项目集成。
盈帆报表工具作为单独的报表系统服务时,分为设计与展现两部分,设计部分是单独的在线设计器,根据实际需求是否进行设计器的集成。设计器主要负责报表的设计,设计好的模板再通过后台分配进行展示。集成展现部分主要是获取展示的报表内容,再进行集成显示。
盈帆报表作为单独系统服务时,提供以下几种方法进行集成:
一、单点登录
通过http请求直接跳过登陆界面,登陆到相应的用户展示界面中。具体的请求方式如下:http://IP:8099/EFReport/loginWithoutPage?account=demo&password=123
二、获取用户SessionId进行集成
获取用户的SessionID,再使用SessionId来获取分配好的报表展示页面,获取的最终展示界面进行项目集成。
1.获取sessionid,代码部分如下:
public String getAuth() throws Exception {
String sessionid = null;
// 1、创建HttpClient
CloseableHttpClient client = HttpClients.createDefault();
// 2、封装请求参数
List<BasicNameValuePair> list = new ArrayList<BasicNameValuePair>(2);
// “demo”是实际的用户名称
list.add(new BasicNameValuePair("command", "demo"));
//使用对称加密,”123”是账号“demo”的实际密码,"123456789ABCDEFG"是对称加密的KEY值。KEY值"123456789ABCDEFG"必须是16位的,此KEY需要与webapps\ROOT\WEB-INF\classes\ application.properties文件里的AES.KEY一致
list.add(new BasicNameValuePair("certificate", AES.encrypt("123", "123456789ABCDEFG")));
// 3、转化参数
UrlEncodedFormEntity refe = new UrlEncodedFormEntity(list, "UTF-8");
// 4、创建HttpPost
HttpPost post = new HttpPost("http:// IP:8099/EFReport/authentication");
post.setHeader("Accept", "text/plain;charset=UTF-8");
// 5、设置参数
post.setEntity(refe);
// 6、执行请求
CloseableHttpResponse resp = client.execute(post);
// 7、获取实体
HttpEntity entity = resp.getEntity();
// 8、获取返回实体内数据
String result = EntityUtils.toString(entity, "UTF-8");
if ("OK".equals(result)) {
Header[] headers = resp.getHeaders("Set-Cookie");
String str = headers[0].getValue();
sessionid = str.substring(0, str.indexOf(";"));
}
// 9、关闭
resp.close();
return sessionid;
}
2.通过获取的sessionid,获取当前用户的可预览的报表名称。
//获取第一步的sessionid
String global_session_id = getAuth();
请求地址如下:"http:// IP:8099/EFReport/r_menu;<%=global_session_id%>",返回的是JSON格式的数据。
下图显示的是通过上述方式,返回的数据界面,用户报表菜单树的JSON格式。
3.通过获取的sessionid、模板名称、参数,获取当前用户可预览的报表内容。请求地址如下:
"http:// IP:8099/EFReport/r_report;<%=global_session_id%>?file=<%=URLEncoder.encode("日期参数",
"UTF-8")%>¶ms="
带有实际的模板参数请求如下:
"http:// IP:8099/EFReport/r_report;<%=global_session_id%>?file=<%=URLEncoder.encode("日期参数",
"UTF-8")%>¶ms=<%=URLEncoder.encode("param1=2016-1-10;param2=2018-05-01",
"UTF-8")%>"
下图显示的是通过带有参数的请求方式,返回的界面。
三、跳过权限直接集成
获取报表服务的公钥,通过算法获取token,再通过获取的token,模板名称,参数获取当前用户可预览的报表。
1.获取公钥
请求地址如下:“http:// IP:8099/EFReport/thirdSys/getPublic”
2.获取token
获取当前计算机时间与GMT时间,使用RSA算法,获取token。
public String getToken() throws Exception {
//获取当前的毫秒数
String data = String.valueOf(System.currentTimeMillis());
//通过时间与公钥,使用RSA算法获取token,红色部分为获取的公钥
String encryptData = RsaUtils.encrypt(data,RsaUtils.getPublicKey("MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDmVtO9QRTBBVUzDzhtSU9aVjv46dlQUiMGZRt9uz0h/T1Ty6X2nF1on0EG7fUgg3yU+XepD/AQlZFzLtpuI7TPhA67CoecmhRhCdUHN4u6FOGhQjyNl9PPL1gYF4YwW94BX5HPKg1nOdpmkkB/pdJ5cpobjYD0R0xgelmG1nkRWQIDAQAB"));
return encryptData;
}
3.获取报表区域
通过获取的token,模板名称,参数获取当前用户可预览的报表。
实际http请求如下:
http:// IP:8099/EFReport/report/checkSheet?file=<%=URLEncoder.encode("日期参数","UTF-8")%>¶ms=&token=<%=getToken()%>
带有实际的模板参数请求如下:
http:// IP:8099/EFReport/report/checkSheet?file=<%=URLEncoder.encode("日期参数","UTF-8")%>¶ms=<%=URLEncoder.encode("param1=2016-1-10;param2=2018-05-01","UTF-8")%>&token=<%=getToken()%>
下图显示的是通过带有参数的请求方式,返回的界面。
http:// IP:8099/EFReport/report/checkSheet?file=%E6%97%A5%E6%9C%9F%E5%8F%82%E6%95%B0¶ms=param1%3D2016-1-10%3Bparam2%3D2018-05-01&token=JyraKnXWLabFB/5FYL13wJVhWBjcyAPkgtDySdcZ3xJHqKm7lekK0rbDw7WZ3ISUTcvAIaD4PJX9ynaFX8RDThU8gWow12uiBgmiC49iv2dIByd7vHMR/ml2YChEXs5wc5pxL+1iWxcFlybgX8szjfV0lxlDsa3hwJiLReVbkys=
四、公开模板
1.设置模板公开
将需要集成的模板,在后台模板管理中,编辑模板,是否公开属性设置为“是”。
2.获取报表区域
通过模板名称、参数,获取报表。http请求如下:
http://IP:8099/EFReport/report/checkSheet?file=<%=URLEncoder.encode("日期参数","UTF-8")%>¶ms=
带有实际的模板参数请求如下:
http:// IP:8099/EFReport/report/checkSheet?file=<%=URLEncoder.encode("日期参数","UTF-8")%>¶ms=<%=URLEncoder.encode("param1=2016-1-10;param2=2018-05-01","UTF-8")%>
下图显示的是通过带有参数的请求方式,返回的界面。
http:// IP:8099/EFReport/report/checkSheet?file=%E6%97%A5%E6%9C%9F%E5%8F%82%E6%95%B0¶ms=param1%3D2016-1-10%3Bparam2%3D2018-05-01
盈帆报表工具提供了以上几种集成方式,根据实际需求可快速的将报表内容集成到项目中,解决项目的报表需求。