报表助手

本文主要介绍报表助手的部署方法及操作使用说明，帮助用户快速掌握功能应用。

有两种部署场景：

1、场景一：项目当前正在使用的业务系统是V11版本：直接在当前V11环境上部署AIChat，基于当前系统上的报表进行问数。

2、场景二：项目当前正在使用的业务系统是V8/V9/V10版本，且不升级到V11版本：

准备两套Smartbi环境，一个是用户当前正在运行的业务系统，Smartbi的版本可以是V8/V9/V10，下文简称为低版本环境，另一个是新部署的带AIChat功能的最新V11版本系统，下文简称为V11环境。
将需要AI问数的报表从低版本环境导入到V11环境，在低版本环境中打开报表，点击报表工具栏的 AI问答 ，此时能自动找到V11环境对应的报表，并打开V11环境的AIChat界面，用户可输入问句进行问数。

下面按不同的部署场景说明报表助手的部署方法及操作使用说明。

1 场景一：只有一个V11环境

1.1 部署及环境配置

1.1.1部署Smartbi环境

直接在当前V11环境上部署AIChat，基于当前系统上的报表直接进行问数。AIChat的部署操作详情可查看：AIChat安装部署与升级。

1.1.2 导入报表助手Agent

1、在 运维设置 > 系统迁移与备份 > 导入资源 中，导入报表助手Agent.xml 资源，如下图所示：

2、导入资源成功后，在 Agent 中，双击打开导入 报表助手 Agent，点击工具栏的发布按钮，确认Agent发布成功，如下图所示：

1.1.3 部署报表助手功能的扩展包

1、获取报表助手功能扩展包并部署：

Smartbi版本	需要部署的扩展包
V11	Smartbi_Special_AICommon.ext Smartbi_Special_AIForAdHocDq.ext

2、在Smartbi服务上部署好对应扩展包后，进入系统在 系统运维 > 系统选项 > 公共设置 > 服务器地址 > 自然语言分析的URL地址 中配置地址：如：http://IP:端口/smartbi/vision/aichat/proxy/#/?hideNav=true&agentId=customagent_I8a8a4ae4019768fb68fb93ea0197694a28510006

1.2 功能使用

1.2.1 创建数据模型

报表助手功能，本质是对报表绑定的数据模型进行问数，所以需要创建数据模型，若报表是直接来源数据模型的，则可跳过此步骤。

本文仅以怎么快速复用当前已有报表数据为例创建数据模型，完整的数据模型构建思路和方法，详情可查看：准备数据。

1、开启 数据模型支持添加系统资源作为私有查询 功能：

在 运维设置 > 系统选项 > 高级设置 中，添加设置项：DATAMODEL_ENABLE_SYSTEM_RESOURCE_VIEW=true 。

配置了设置项后，在数据模型添加私有查询的菜单面板中，将显示 系统资源 菜单项。

2、点击 系统资源 ，选择已有的数据集或报表，作为数据模型的私有查询数据来源，快速复用系统上已有的报表数据。

可选择的系统资源范围：电子表格、Web电子表格、原生SQL数据集、SQL数据集、可视化数据集、JAVA数据集、存储过程数据集、旧透视分析、旧即席查询。
电子表格、Web电子表格报表中包含了多个数据集/查询时，选择添加对应报表后，会自动生成多个私有查询。

对于来源自助数据集的仪表盘、来源数据源表的新即席查询，当前无法直接使用 系统资源 功能，直接添加报表数据，需按通用方法的构建数据模型，详情可查看：准备数据。
对于来源业务主题的仪表盘，可使用 业务主题转数据模型 工具，将业务主题一键转成数据模型，无需再从0开始建模，详情可查看：业务主题转数据模型。

3、添加的系统资源会自动转换成数据模型的 Java查询 ，通过Java查询去获取系统资源的数据，Java查询功能的使用介绍，详情可查看：添加接口查询。

4、生成的Java查询默认不会自动映射参数，且生成的参数默认是输入框类型（即不带参数备选值），

为了保证能问不同的参数值数据、且确保问数结果的准确性，需要把私有查询中的参数映射到数据模型中，并配置参数备选值。参数功能详情可查看：参数设置。

5、如果需问时间计算数据，则需要创建时间层次，详情可查看：创建时间维。

6、保存数据模型，并抽取数据。

更多的数据模型功能介绍，详情可查看：数据模型。

1.2.2 报表绑定数据模型

1、在需要问数的报表中，点击鼠标右键，点击属性，在 报表模型 中填入所需问数的 数据模型ID，支持填入多个数据模型ID，用英文逗号分隔。

报表模型设置，本质是为了确定使用报表助手问数时，是基于什么数据模型进行问数。

2、报表模型 设置中：

对于仪表盘、新透视分析、新即席查询，若报表数据仅是来源数据模型，则 报表模型 属性设置将 不显示，因为可直接基于报表来源的数据模型问数，无需再单独绑定数据模型。
若仪表盘来源的业务数据集中，不仅仅只包含数据模型，则需要把所有需问数的数据模型ID，填到报表模型属性设置中。
其他报表类型场景，都需要在报表模型中填入所需问数的数据模型ID，才能正常问数。

1.2.3 训练数据模型

1、训练需要问数的数据模型：

点击 运维设置 > 自然语言配置 > 图谱管理 > 构建模型图谱 ：

勾选需要问数的数据模型，点击下一步：

勾选需要训练的字段，点击训练：

需勾选有业务意义的中文维度字段，不建议勾选日期、维成员过多等字段训练。

提示操作成功，则表示数据模型训练完成。

1.2.4 进行报表问数

1、打开对应的报表，点击工具栏 AI问答 按钮，在报表右侧自动打开AIChat的窗口，可输入问句进行问数：

2 场景二：低版本环境+V11环境

2.1 部署及环境配置

2.1.1 部署Smartbi环境

1、部署V11版本的Smartbi，部署操作详情可查看：安装部署与升级。

2、原低版本的业务系统环境。

2.1.2 解决跨域问题

使用报表助手功能需在同一个页面中，同时打开低版本和 V11版本。若存在跨域问题，需进行解决（下面以 Windows 版 Nginx 为例介绍配置方法）。若无跨域问题时，可跳过此步骤。

1、在Nginx安装目录中，找到 conf\nginx.conf 文件，双击编辑。

2、按实际系统地址配置，其中V11环境需使用和低版本不同的应用名，配置如下图所示：

3、保存后，启动Nginx。

2.1.3 导入报表助手Agent

1、V11环境，在 运维设置 > 系统迁移与备份 > 导入资源 中，导入报表助手Agent.xml 资源，如下图所示：

2、导入资源成功后，在 Agent 中，双击打开导入 报表助手 Agent，点击工具栏的发布按钮，确认Agent发布成功，如下图所示：

2.1.4 部署报表助手功能的扩展包

1、获取报表助手功能扩展包，并按对应的环境版本部署相应的扩展包：

Smartbi版本	需要部署的扩展包
V8、V9、V10	Smartbi_Special_AICommon.ext
V11	Smartbi_Special_AICommon.ext Smartbi_Special_AIForAdHocDq.ext

2、在Smartbi服务上部署好对应扩展包后，进入系统在 系统运维 > 系统选项 > 公共设置 > 服务器地址 > 自然语言分析的URL地址 中配置地址：

若存在跨域问题的，需要配置V11代理后的访问地址，比如V11代理后的访问地址是：http://IP:端口/smartbiv11，则自然语言分析的URL地址为：http://IP:端口/smartbiv11/vision/aichat/proxy/#/?hideNav=true&agentId=customagent_I8a8a4ae4019768fb68fb93ea0197694a28510006

2.2 功能使用

2.2.1 资源迁移

需将低版本环境的报表资源同步到V11环境上

如果是初次使用，可将低版本环境的知识库恢复到V11环境上，实现一次性迁移所有所需报表的效果。
后续使用时，若低版本环境上的问数报表有新增或变更，则可以通过 资源导入导出 功能，将低版本环境上的报表导到V11环境上。资源导入导出功能详情可查看：系统资源迁移。

报表助手功能，本质是对报表绑定的数据模型进行问数，所以只需保证数据模型能正常查数即可，部分报表本身的升级异常问题不影响报表助手功能的正常使用。

2.2.2 创建数据模型

报表助手功能，本质是对报表绑定的数据模型进行问数，所以需在V11环境上创建数据模型，若报表是直接来源数据模型的，则可跳过此步骤。

在V11环境上如何创建数据模型，和场景一功能一样，这里就不再展开说明，详情可查看：创建数据模型。

2.2.3 报表绑定数据模型

1、在V11环境需要问数的报表中，点击鼠标右键，点击属性，在 报表模型 中填入所需问数的 数据模型ID，支持填入多个数据模型ID，用英文逗号分隔。