FAQ中心
页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 22 下一个 »

在进行多系统集成的时候，是不是经常会被各种集成问题给难道，集成很多细节点没有注意导致集成失败，引发了一系列的疑问：

  1. 为什么openresource集成请求参数传递失败？
  2. 为什么令牌token令牌解析失败？
  3. 为什么令牌token登录之后参数传递失败
  4. ......

下面我们就从基础出发，深入探究基础的秘密。


一、openresource集成问题

注意本节介绍的内容只是单独使用openresource时的注意事项，默认均是已完成单点登录的集成。

1、选择正确的传参字符串json

在资源集成的时候，openresource请求的paramsInfo、paramsInfoBase64两个参数是用来传递参数，传递的参数信息需要一个json格式的字符串，在不同的资源里其传递的字符串格式是不一样的。需要根据不同的资源选择正确的参数json串，选择正确的传参字符串参数传递的问题可以解决70%的问题。

http://localhost:18080/smartbi/vision/openresource.jsp?resid=I402881e5019608c408c4fb7801960e2ec9b42d3d&paramsInfo=

各资源参数选择如下

电子表格、旧即席查询、旧透视分析
单参数： [{"name":"发货区域", "value":"华北","displayValue":"华北"}]

多参数： [{"name":"发货区域", "value":"华北","displayValue":"华北"},{"name":"订单年份", "value":"2020","displayValue":"2020"} ]

多选参数：[{"name":"订单年份", "value":"2020,2021","displayValue":"2020,2021"}]
仪表盘、新即席查询、新透视分析
单参数： {"订单年份":{"values":["2020"]}}

多参数： {"订单年份":{"values":["2020"]}, {"订单月份":{"values":["2020-01"]} }

多选参数：{"订单年份":{"values":"2020,2021" }} 或 {"订单年份":{"values":["2020","2021"]}} 或 [{"name":"订单年份", "value":["2020","2021"],"displayValue":["2020","2021"] }]

注意：仪表盘除去以上格式之外也支持使用电子表格的参数传递方式

多选参数注意事项
  1. 由于电子表格里参数是通过英文逗号进行分割多个参数，所以在多个参数传递的时候只能写成"value":"2020,2021" ，若业务数据中不规范有逗号，则会解析为两个参数，由于电子表格的架构实际目前无法解决该问题。
  2. 仪表盘上的参数逻辑不同于电子表格，不仅可以写成"values":"2020,2021"和电子表格的逻辑一致，还额外提供了数组的写法"values":["2020","2021"]。此时需要注意，如果使用数组的写法，数组中的每一项表示一个参数，如写为"values":["2020,2021"]则表示传递的参数是2020,2021的整体，而不是拆分成两个参数，可解决业务数据中有英文逗号的问题。

2、url转码

在选择正确的参数之后，拼接得到最终访问资源的请求，具体可以参考如下示例。那么如下链接如果直接访问会有哪些问题呢？

http://localhost:18080/smartbi/vision/openresource.jsp?resid=I402881e5019608c408c4fb7801960e2ec9b42d3d&paramsInfo=[{"name":"发货区域", "value":"华北","displayValue":"华北"}]

在参数的链接中我们可以发现其存在中文数据，同时也存在特殊字符，访问时就很可能会出现如下Tomcat报错"HTTP状态 400 - 错误的请求"的报错，在报错的描述信息中可以看到原本paramsInfo后面加的参数变成了一堆编码，其错误描述中大致的意思是请求信息中有无效的字符导致的。

出现这个问题是因为tomcat高版本严格按照RFC 3986规范解析地址。该规范只允许包含a-zA-Z 0-9 - _ . ~ 以及所有保留字符 ! * ’ ( ) ; : @ & = + $ , / ? # [ ]

所以当请求中有除去上述的特殊字符或中文的时候基于Tomcat的限制，会识别不到请求所以抛出400的错误状态码。那实际遇到这种问题的时候又该如何解决呢？

方案一：使用 encodeURIComponent 函数进行url转码

url转码是浏览器请求时面对不合法的请求时进行转化的重要手段，实现的原理是将需要转码的字符，按指定编码方式（默认使用UTF-8编码）转化为字节流，然后每个字节按16进制表示，最后添加%组成一个percent编码，最终就会变成%+16进制+16进制的格式

例如：你好

  • UTF-8字节流打印为：-28 -67 -96 -27 -91 -67
  • 对应的16进制表示为：E4 BD A0 E5 A5 BD
  • URLEncode编译后为：%E4%BD%A0%E5%A5%BD

此时转码之后的字符就可以被浏览器识别，所以只需要将paramsInfo后面的参数内容全部进行url转码之后拼接到请求中就可以被Tomcat识别。如下这里我们直接在浏览器控制台中使用encodeURIComponent，得到的结果拼接成完整的url请求具体如下。此时就可以正常访问并且传参成功，在实际开发场景中只需要将拼接之后参数json进行字符串格式化之后再拼接到请求中即可完成参数传递。

http://localhost:18080/smartbi/vision/openresource.jsp?resid=I402881e5019608c408c4fb7801960e2ec9b42d3d&paramsInfo=%5B%7B%22name%22%3A%22%E5%8F%91%E8%B4%A7%E5%8C%BA%E5%9F%9F%22%2C%22value%22%3A%22%E5%8D%8E%E5%8C%97%22%2C%22displayValue%22%3A%22%E5%8D%8E%E5%8C%97%22%7D%5D


方案二：修改tomcat的server.xml配置文件

在Tomcat/conf/server.xml文件中，可以在请求端口的配置中添加relaxedPathChars="|{}[],%"和relaxedQueryChars="|{}[],%" 两个参数同样也可解决该问题，特殊情况下还需要多添加一个URIEncoding="UTF-8" 的参数，避免因为字符集导致的转码异常。

注意：若为window一键安装部署Tomcat，默认情况下这些参数是已经添加过的。


测试html文件：open.html （测试资源仅提供测试验证以及参考，实际的集成时请以实际场景为准）

下载后双击打开html文件，输入需要集成资源的openresource地址之后，选择不加密，然后在下方添加需要传递的参数以及参数值，最后点击拼接url之后即可得到完整的集成链接，访问拼接的地址可验证参数是否正常传递成功。

3、base64加密

在实际生产的过程中使用openresource.jsp集成资源的时候，除去会遇到Tomcat无法识别字符的问题之外，还可能或有参数过多请求头过长请求被拦截、请求中大量的特殊字符被网络安全策略拦截等各式各样的场景，那是否还有其他办法规避掉这些问题？

base64加密流程

（1）配置好需要加密的参数，这里以发回区域参数为例，如：[{"name":"发货区域", "value":"华北","displayValue":"华北"}]

（2）用加密算法进行加密，加密要点如下：

  1. 使用base64加密是需要以UTF-8的字符集来进行加密
  2. 建议使用sun.misc.BASE64Encoder类来加密处理，也可以使用js代码来处理，但是不作为首要推荐，因为加密不一致时解密可能会异常。
  3. 加密完成后需要对加密后的字符串进行转码

（3）使用encodeURLComponent对加密后的字符串进行转码。

  • 加密之后的base64串是可能包含除字母之后的一些特殊字符的，所以一定需要进行url转码，否则Smartbi在加解密的时候就会报错，前端页面显示500，如下图

base64参考示例

java代码实现参考：

// 对格式化的json字符串sourceString使用UTF-8字符集进行加密
String targetTempString = new sun.misc.BASE64Encoder().encode(sourceString.getBytes(StandardCharsets.UTF_8));
// 对加密后的字符串进行url转码
String targetString = java.net.URLEncoder.encode(targetTempString);

js代码实现参考：

// 1、对参数进行字符串转换，json格式化
let jsonString = JSON.stringify(params);
// 2、对字符串的数据转为二进制
let utf8Bytes = new TextEncoder().encode(jsonString);
// 3、用二进制的数据转为utf-8之后进行base64编码
let base64Encoded = btoa(String.fromCharCode(...utf8Bytes));
// 4、对base64编码进行url转义
return encodeURIComponent(base64Encoded)

测试html文件：open.html （测试资源仅提供测试验证以及参考，实际的集成时请以实际场景为准）

下载后双击打开html文件，输入需要集成资源的openresource地址之后，选择不加密，然后在下方添加需要传递的参数以及参数值，最后点击拼接url之后即可得到完整的集成链接，访问拼接的地址可验证参数是否正常传递成功。

4、post请求提交


  • 无标签