从V7系列升级到V8系列

当我们需要把乐创者服务从v5/v6/V7系统升级到V8系列时，我们需要按以下步骤逐步升级：
1、v5系列需要先按照“从V5系列升级到V6系列”的相关步骤先进行升级，然后再进行下面的操作；
2、v6系列需要先按照“从V6系列升级到V7系列”的相关步骤先进行升级，然后再进行下面的操作；
3、从V7系列可以直接升级到V8系列，但需要注意以下变更：

一、JDK版本升级到17.0+

需将JDK/JRE的版本升级到openJDK17/JDK17的最新版本，对应的Web容器升级到支持openJDK17/JDK17的版本（如：tomcat升级到10.1最新版本）

二、需要升级知识库

升级前请备份知识库，知识库升级过程请参考 知识库升级指南；

三、身份认证机制变更

v8.0发布版的身份认证机制从传统的长期访问令牌（authId）变更为 JWT（JSON Web Tokens） 认证机制，项目中有使用到authId身份传参的需改制为lczticket方式，具体包括以下：

3.1 HTTP数据模型对象中调用api接口

变更前：
请求体参数：

{
    "header":{
      "authId":"${userAuthId}"
    },
    "requestBody":{
    }
}

变更后：
请求头参数（新增lcztoken传参）：

请求体参数（去除authId传参）：

{
    "header":{
    },
    "requestBody":{
    }
}

检索方式：
方式1、设计中打开搜索窗口（当前应用内），如下图所示：


时间：设置为”不限”
包含内容：分别对”authId”、”userAuthId”进行检索。

方式2、通过检索知识库表
以mysql数据库为例：
数据模型/报表/跨设备表单/透视分析/即席查询/智能报告等相关：

select dn_volume.NAME_ as volume_name, dn_volume.ALIAS_ as volume_alias, dn_knowledge_data.NAME_ as file_name from dn_knowledge_data 
 LEFT JOIN dn_volume on dn_volume.ID_=dn_knowledge_data.VOLUME_ID
WHERE dn_knowledge_data.KD_DATA like '%authId%' or dn_knowledge_data.KD_DATA like '%userAuthId%'

大屏/部件相关：

select dn_volume.NAME_ as volume_name, dn_volume.ALIAS_ as volume_alias, dn_matrix_data.FILE_NAME as file_name from dn_matrix_data 
 LEFT JOIN dn_volume on dn_volume.ID_=dn_matrix_data.VOLUME_ID
WHERE dn_matrix_data.DATA_ like '%authId%' or dn_matrix_data.DATA_ like '%userAuthId%'

3.2 JS事件中调用api接口

如果js事件中通过$.ajax调用乐创者服务中的api接口，需要通过请求头参数传递lcztoken, 以报表JS事件为例：

跨设备表单、大屏中的JS事件也类似。

3.3 自定义拼接网页地址中的authId传参

在乐创者产品内部，通过自定义链接方式拼接的访问本服务的报表/单元格表单/大屏/跨设备表单等页面访问URL，原来拼接了authId参数的可以去除，系统自动会使用浏览器中的lczToken进行访问；如果是访问其他乐创者服务的访问URL，authId改为lczTicket。

3.4 二次开发程序调用oapi/getUserAuthId接口变更

二次开发程序中调用”oapi/getUserAuthId”获取audhId，变更为通过”oapi/getUserAuth”接口获取ticket（一次性访问票据）。
其中，ticket用于组装报表/跨设备表单/大屏等模板访问ulr地址的lczTicket参数。

V8系列之后的升级就按照标准升级即可。