1. 概述编辑
在 FineBI 中，管理员角色分为系统的超级管理员与次级管理员，其角色和对应职责如下所示：
| 管理员类型 | 管理范围 | 描述 |
|---|---|---|
| 超级管理员 | 数据决策系统 | 即 初始化设置 时的用户，通常为企业 IT 人员，负责统筹整个系统的工作，配置系统人员、角色、权限等 |
| 次级管理员 | 子数据/系统项 | 通常为企业下属分公司的管理员，由超级管理员下放一定的权限，管理本分公司/部门范围内的数据、人员、角色、权限等 |
超级管理员可将系统的部分权限根据需求分配给次级管理员，比如分配部门业务包权限给对应部门次级管理员，次级管理员自己对本部门的业务/分析人员进行权限分配，减少总部 IT 人员的工作量，及以 IT 为主导的沟通量。
本文将介绍管理员需要掌握的相关功能知识。
2. 数据准备编辑
2.1数据连接管理
进行数据分析前，由管理员（一般为 IT 人员）准备好数据，即定义数据连接。
2.1.1 创建数据连接
进入管理系统>数据连接>数据连接管理，可以看到新建数据连接和已经创建的数据连接，点击新建数据连接，如下图所示：
2.1.2 输入数据连接信息
详情请参见：配置数据连接
注：数据连接名不能轻易修改，更改后数据库表会因为找不到数据库而报错，因此需要提前规划好数据连接名称。更改数据连接名后，SQL 数据集需要重新选择数据连接，尽量用 SQL 添加基础表而不是数据库表。
2.2 业务包和分组管理
管理员制定搭建业务包及分组的模式，尽量规范命名，有助于用户的使用，比如可以按照基础表，部门等进行划分。
2.2.1 新建业务包和分组
详情请参见：业务包管理
FineBI 的业务包是 BI 分析的数据基础，由管理员创建并将数据库中的表添加进去，以供分析人员使用。为方便对数据进行调理的管理，FineBI 提供了创建不同分组，不同分组下创建对应类型的业务包，并在每个业务包下添加相应的分析表的功能。
进入数据准备界面，点击添加分组可在数据列表下创建新的分组，点击添加业务包即可在对应分组下创建新的业务包，如下图所示：
2.2.2 管理业务包
管理员可以对业务包进行重命名、删除、移动等操作，
1）重命名如下图所示：
2）移动销售DEMO业务包至行业数据分组下，如下图所示：
3）删除业务包如下图所示：
2.3 添加数据表
在这些业务包中添加对应的表。
详情请参见：添加数据表
注：数据库表、SQL数据、EXCEL 数据集是企业原有的数据源。
自助数据集是对以上三种包括自身的表进行数据的处理和合并等操作，帮助不会写 SQL 的业务人员进行表的处理合并。
自助数据集相关操作请参见：自助数据集（数据处理用户）
2.4 表的取数方式
2.4.1 实时数据
实时数据为 FineBI 提供了直连数据库取数的方式，在基础表为实时数据以后，该表将不再需要将数据更新到本地，直接连接数据库通过 SQL 取数，获取的都为实时的数据。
详情参见：实时数据
实时数据注意事项：
实时数据不建议做自助数据集。推荐抽取数据，将数据更新到本地。
实时数据尽量使用 SQL 数据集的方式，减少实时数据使用自助数据集处理数据的场景。
2.4.2 抽取数据
FineBI 的数据更新是指将数据库中的数据抽取到引擎存储，本地模式使用本地磁盘存储。存储路径为：%FineBI\bin\ROOT\db。
| 现象 | 注意结果 |
|---|---|
| 表 A 来自于数据库表，自助数据集来自于 A 。修改数据库的表的字段名 | 更新表 A 会报错，表异常标红，编辑表 A 后更新 A ，A 可以更新成功。 自助数据集更新不会成功，需要手动调整自助数据集的字段 |
| 分析表 B 来自于基础表 A ，基础表 A 更新后，编辑取消某个字段，不更新 | 分析表 B 更新，可以正常更新。因为 A 未更新，配置未变化。编辑 B ，会提示没有勾选的字段没有权限—因为权限是从 A 那实时获取的 |
| 分析表的更新信息 | 显示的是基础表更新的信息，更新进度显示的是当前更新后的情况 |
| 表编辑界面字段类型的获取 | 保存一次之后，就不会再去获取数据库中的字段类型 |
| 上传 Excel | 临时文件是保存到安装路径的：%FineBI\webapps\webroot\WEB-INF\assets\temp_attach文件夹下，该文件不能删除 |
| 表 A 更新后，数据库中新增字段 | 表编辑界面可以看到新增的字段，默认不勾选；不需要单表更新。勾选后，需要单表更新才能获取到对应的数据 |
| 自动转义 | 只能在通过业务包/数据库且第一次添加表的时候自动获取；转义通过获取数据中的表名和字段名的注释来实现 |
| 基础表更新成功，但是关联更新失败 | 不会发送更新失败的消息通知 |
| 基础表更新成功，但是分析表更新失败 | 会发送更新失败的消息提示 |
| 删除表或者关联 | 只有更新后，对应的数据存储文件才会被删除 |
| 定时更新，设置简单重复执行，每隔一天 | 是指每隔24小时执行。如果真的需要隔一天再更新，那需要设置为每隔两天（48小时） |
| 分析表的基础表，全部更新失败 | 则对应的分析表此次不会触发更新。全局更新界面会显示更新失败 |
| 增量更新 | 增量sql不能为空 |
| 系统管理中，周起始日期改变 | 重启之后会触发全局更新 |
| 建议时间相近的表放到一起更新 | 只要一起更新，会自动去重，不会出现重复更新的问题 |
| 尽量采用全局更新，每天晚上更新一次的方式 | |
| 每次更新的时间间隔越远越好 | 更新量比较小( 根据其背后的表 )的话，可以在1小时，如果更新量比较大，就要几个小时才更新一次，或者按天夜间更新 |
2.5 手动建立表间关联
2.5.1 概念介绍
通常数据库的表与表之间存在关联关系，将数据库表添加到业务包的过程中，系统会自动读取表间关联；没有关联关系的，可以手动建立表间关联关系。
详情参见：关联视图
2.5.2 设置规则
1）1 端字段中的数据值不允许有重复值或者空值。
2）尽量减少使用 1:1 关联，可以用 1:N 或者 N:1 代替。
3）「我的自助数据集」分组下所有的表都不支持建立关联。
4）联合关联左右字段一一对应。
5）配置完字段关联后，若选择抽取数据，需要点击更新信息>单表更新进行该表的更新操作，抽取数据保存到本地才能使用。
3. 管理系统编辑
3.1 目录管理
支持对模板的批量增加删除等操作，支持对首页的设置。
详情参见：目录管理
3.1.1 设置界面
点击管理系统>目录管理，设置界面如下图所示：
3.1.2 注意事项
1）系统首页默认所有部门的用户都能看到。
2）置 BI 模板显示为首页，则该模板在首页将自动隐藏仪表板上方的另存为和导出的按钮。
3）形式可以是相对路径或者绝对路径，绝对路径需要添加http:// 。
3.2 用户管理
详情参见：用户管理
3.2.1 添加用户
1）手动添加用户
进入管理系统>用户管理，支持手动添加用户和批量导入用户，手动添加方式为：点击「添加用户」（比如用户 a ），输入用户信息，点击确定，该用户即被添加，如下图所示：
2）同步用户数据集
详情参见：用户同步数据集
进入管理系统>用户管理，点击用户同步，选择用户来源，输入对应用户信息表等，点击确定，如下图所示：
注意事项：
| 内容 | 解释 |
|---|---|
| 同步用户建议一开始就选好 | 两种用户不同的模式，用户做的表和分析的仪表板，不通用，即使是一样的用户名密码职位等 |
| 对于手动添加用户中的导入服务器数据中的用户信息 | 开启了数据集同步后，用户信息将跟随数据集同步，动态改变、实时更新，即若数据库信息改变后，决策系统中的用户信息也会随之改变 |
| FineBI支撑多用户来源 | 在用户同步数据集时并不会清空原先的数据，若同步的用户数据与原先内置的有冲突，将不会显示 |
| 同步用户集同步设置完成后要重新登录 | 原因是切换了登录的方式，原先的登录数据需要清除，如果不重新登录会产生很多无法估计的错误，比如多人登录时由于登录方式切换，各种参数的保存位置会发生混乱等 |
| 用户数据集所有用户及机构部门都是从数据库自动生成的 | 不能进行修改 |
3.2.2 管理用户
手动添加的用户可以编辑、禁用和删除用户，同步进来的用户可禁用。如下图所示：
3.2.3 机构部门、角色添加
1）机构部门
点击管理系统>用户管理>机构部门，添加部门和职务，并对应添加用户，如下图所示：
2）角色
注：部门可以分级，角色不能分级。
3.2.4 平台使用用户
为了限制查看与编辑的并发量及做分析时的数据量，加快计算和展示的速度，需将用户进行类型划分——查看用户和设计用户（包括分析用户和处理用户），处理用户的权限高于分析用户，具备配置关联和添加数据库表的权限。
两者的异同请参见：BI设计用户
1）设置界面
进入管理系统>用户管理>平台使用用户，选择BI使用用户，如下图所示：
2）注意事项
一个用户只能被添加到 BI 查看用户、BI 数据处理用户或者BI数据分析用户中的一个，用户添加到 BI 设计用户中默认会拥有查看的权限。超级管理员默认为数据处理用户。
注册册文件为不限制用户数，则在平台使用用户中需要先开启限制使用用户，否则默认所有的用户均有平台使用、BI查看、BI设计及移动平台权限。
3.3 权限管理
管理员在管理系统>权限管理中对各用户的权限范围进行管理，用户可以且仅能访问被授予权限的内容。
详情参见：权限管理
权限管理界面如下图所示：
打开分级权限管理，详情参见：分级权限分配
3.3.1 管理系统
分配对应节点权限，用户能够看到管理系统中的对应节点。
3.3.2 业务包权限
可以将 IT 准备的基础业务包分配给用户，并建为用户所在部门或者业务线创建业务包分组，为初期的业务分析创建环境。
详情参见：业务包权限管理
1）权限配置页面如下图所示：
2）注意事项
| 权限配置注意事项 |
|---|
| 在配置完目录的查看权限后，需配置目录仪表板对应业务包的使用权限，否则会报错没有数据查看权限 |
打开业务包某个分组的管理权限，用户可对此业务包分组下建业务包，对此业务包分组进行重命名和删除； 打开业务包的管理权限，用户能够对此业务包及业务包内的表进行编辑，重命名，移动，删除，并且能够新建表 |
| 只有超管可以添加业务包分组 |
| 权限设置可进行对表的行列权限进行设置 |
| 部门和角色分配的权限是并集关系 |
3.3.3 数据连接权限
用户拥有对数据连接使用、管理和授权的权限。详情参见：数据连接控制
注：打开数据连接控制权限需要在全局设置下打开分级授权和数据连接控制按钮。
1）配置界面如下图所示：
2）权限说明
使用权限：拥有某数据连接的使用权限，用户登录后可在数据准备>业务包中使用该数据连接添加数据。
管理权限：拥有某数据连接的管理权限，用户登录后可在管理系统>数据连接下，对该数据连接进行编辑、复制、修改、删除等操作。
授权权限：拥有某数据连接的授权权限，用户登录后可在管理系统>权限管理>数据连接中，将该数据连接的相应权限分配给可管理的用户。
3.3.4 仪表板权限控制
提供功能可以对用户是否有分享权限，以及可分享给哪些部门角色进行权限控制。避免用户将模板随便进行分享，或者分享给不合适的用户。
详情参见：仪表板分享权限 。
2020-01-15版本的 BI 提供公共链接的权限控制，可以按照部门角色用户设置哪些人可以设置公共链接。
详情参见：公共链接权限 。
设置界面如下图所示：
3.4 模板管理
管理系统的模板管理下显示的是当前系统中的所有普通用户创建的模板，申请挂出的模板也在其中，管理员可快速挂出。
详情参见：模板管理
3.5 注册管理
注册管理用于查看当前数据决策系统的一些版本信息以及购买的功能列表。
详情参见：注册管理
3.6 智能运维
3.6.1 内存管理
详情参见：内存管理
当点开没有面积图，可能是 Websocket 端口4 8888 没开或者没转发。影响登录时常等，建议开启。详情参见：Websocket 端口被占用/无法使用
3.6.2 备份还原
FineBI 提供了备份还原的功能，支持备份内容如下表所示：
| 文件夹 | 备份内容 |
|---|---|
| config | 平台配置信息 |
| reportlets | 报表模板 |
| dashboards | BI 模板 |
| jar | JAR包 |
| plugins | 插件 |
详情参见：备份还原
进入管理系统>智能运维>备份还原，如下图所示：
| 备份还原注意事项 |
|---|
| 平台数据库为内置数据库时，不支持备份还原功能，若需使用备份还原功能请配置外接数据库 |
| 还原后，还原版本消失，当前版本自动备份 |
| 还原需谨慎，还原会丢失还原前后这段之间所做的数据集或模板 |
| 还原前确定自己想还原的部分，平台配置只能还原配置信息，模板不还原，启动后会报错模板信息丢失 |
| 整体工程的还原步骤一般为：平台配置和 webroot 都进行还原 |
| 请日常定期手动备份工程：webroot |
3.6.3 平台日志
对系统的各项情况进行监控
详情参见：平台日志
4. 日常运维编辑
4.1 BI系统部署情况
详情参见：FineBI安装与启动 、FineBI服务器配置推荐
应知应会：服务器系统(linux/win)/服务器内存/服务器cpu核数/磁盘大小，BI安装路径/BI内存(%/bin/finebi.vmoptions)/数据存储路径/是否外置数据库/用户并数，数据库类型/数据库性能/数据量/并发
4.1.1 Linux 中启动 BI
详情参见：Linux 中启动 FineBI
1）启动
切换到 BI 安装路径下，如安装在 opt 目录下的，命令如下所示：
cd /opt/FineBI/bin
直接执行启动命令，如下所示：
nohup ./finebi &
2）重启
使用命令来查看 JAVA 进程对应的 PID ，命令如下所示：
ps -ef | grep finebi
使用命令将该进程杀掉，FineBI 服务即关闭，如下所示：
kill -9 13807
随后参考上述进入 FineBI 目录中，使用命令 nohup ./finebi &启动即可。
启动成功后，就可以在浏览器中输入地址http://IP:37799/webroot/decision访问了。
注：其中 IP 为对应安装服务器的 IP 。若外网访问不了，可借助第三方工具：例如花生壳、fcn、frp 等实现内网穿透。
4.1.2 平台外接数据库
详情参见：配置外接数据库
外接数据库 FAQ
| 问题 | 回答 |
|---|---|
配置外接数据库的原因 | HSQL 是FineBI内置的数据库，但由于 HSQL 不能多线程访问、数据量大后不稳定等原因，导致碰到集群或者数据量比较大时，必须要迁移才能保证系统的稳定性。通过配置外接数据库，可将内置的系统配置等数据迁移至外接的数据库，保证系统使用的性能 |
内外置数据库存的数据跟企业自己的存业务生产数据库有什么联系？内外置数据库会存储业务生产库的数据么？ | 内外置数据库存的是系统的使用配置，比如在BI系统中添加一张表，内外置数据库中只保存表名，字段名，关联关系及创建者信息等，不存实际的数据值。 企业自己的存业务生产数据库会通过建数据连接来取数 |
| 内置和外接数据库，只能选一种么？ | 是的，选内置，系统的使用配置信息就存在安装路径下的%FineBI%\webroot\WEB-INF\embed\finedb。选择外接数据库，配置好连接信息成功导入后，就存在数据库表中 |
| 如何判断是否外迁？ | 查看管理系统>系统管理>常规>外接数据库是否显示已配置，若已配置可以点进去可以看到外迁的数据库。 |
或者查看%FineBI%\webapps\webroot\WEB-INF\config下的db.properties，如果有就说明已经外迁。以SQL server为例，可以看到数据库 URL 模式、用户名、密码是加密的 |
4.2 FineBI工程目录结构
详情参见：FineBI工程目录结构
| 文件 | 存放内容 |
|---|---|
| backup | 存放工程备份的信息 |
| %FineBI%\webapps\webroot\WEB-INF | BI工程主目录；工程备份的文件夹 |
| Web组件.html | 这是一个 Web 组件，写入的超链接地址即可。比如这是一个自定义的 HTML 文件，内置在工程内部%FineBI%/webroot/这个目录之下 |
| %FineBI%\webapps\webroot\WEB-INF\dashboards | BI 模板保存文件夹 |
| %FineBI%\webapps\webroot\WEB-INF\embed | 内置数据库配置目录；可外迁，可迁回 |
| %FineBI%\webapps\webroot\WEB-INF\config | 系统参数，外迁数据库信息 |
| %FineBI%\webapps\webroot\WEB-INF\lib | BI工程依赖的 JAR 包文件夹 |
4.3 报错日志
详情参见：日志类别
4.3.1 调整日志级别
点击管理系统>智能运维>平台日志，选择全局设置，点击系统日志级别下拉框进行调整，如下图所示：
注：日常将日志级别调到 INFO 。
4.3.2 日志存储位置
日志路径在%FineBI5.1%\logs下按天存储。如下图所示：
4.3.3 更新报错日志关键词
| 功能 | 关键词 | 备注 |
|---|---|---|
表开始执行 | table load start 数据集名: {} | 建议直接搜数据集名+表转义名来搜 |
表执行成功 | table load success 数据集名: {} | |
表执行失败 | table load fail 数据集名: {} | 补充一般表失败，通过搜相同线程名字，往上看一般可以看到抛的异常是什么，用来进一步分析 |
全局更新成功 | global Load finish! |
4.4 系统参数说明
详情参见：常规参数 、BI/Spider参数
| 参数 | 说明 |
|---|---|
| 数据访问量 | 设置预览时访问数据库的数据量 |
| 缓存设置 | 开启关闭缓存 |
| 缓存时间(秒) | 缓存时单位秒，设置成0，表示缓存始终生效，实时数据会一直读取缓存，不会生成新的缓存 |
| 分析用户自助数据集磁盘占用大小（单元格） | 默认值：50,000,000； 参数说明：快速分析生成过程中支持的最大单元格数量，超出则生成失败 |
4.5 系统升级策略
4.5.1 同版本升级
详情参见：5.1升级指南
升级 JAR 包流程如下所示：
外置数据库务必先进入管理系统->智能运维→备份还原，手动做下平台备份。
1）linux下升级 JAR 包的操作方式
| 步骤 | 内容 |
|---|---|
| 1 | 关闭 BI 服务 进入目录%FineBI%/bin/ 查进程号：ps -ef | grep FineBI 杀死进程：kill -9 ****（进程号） |
| 2 | 备份 WEB-INF 文件夹 |
| 3 | 把压缩包解压 |
| 4 | JAR 包替换到%FineBI%\webapps\webroot\WEB-INF\lib文件夹下 |
| 5 | 重启 BI ，执行命令：nohup ./FineBI & |
2）Windows下升级 JAR 包的操作方式
| 步骤 | 内容 |
|---|---|
| 1 | 关闭 BI 服务 |
| 2 | 备份 WEB-INF 文件夹 |
| 3 | 把压缩包解压 |
| 4 | JAR 包替换到%FineBI%\webapps\webroot\WEB-INF\lib文件夹下 |
| 5 | 重启 BI |
4.5.2 不同版本升级
详情参见：5.1.x 升级指南
注：升级务必联系技术支持。
5. 宕机相关编辑
详情参见：BI宕机问题排查步骤