1. 概述
用户在每个项目上都可能会开发自己的扩展包,或者从思迈特获取某通用功能的扩展包进行使用,本文主要介绍如何在Smartbi上部署使用扩展包。
在思迈特麦粉社区的插件商城中,就有大量通用扩展包,可以直接下载使用:插件商城。
2. 操作步骤
扩展包的部署方法有以下两种:
- 通过扩展包热加载功能直接上传扩展包。
- 在 config 配置页面 上传扩展包。
注意:V10以下(不包含V10)版本不支持热加载功能上传扩展包,详细部署扩展包方式可见:V10以下版本扩展包部署方式
2.1 部署方法1
通过扩展包热加载功能直接上传扩展包,操作步骤如下。
(1)打开“系统监控”界面。
(2)选择“扩展包”页签。
(3)扩展包页面点击上传扩展包按钮,选择所需扩展包进行上传。
更多扩展包热加载详情可参考文档 系统监控-扩展包。
2.2 部署方法2
在 config 配置页面 上传扩展包,操作步骤如下。
(1)查看扩展包配置路径。首先登录到 Smartbi 的配置管理页面,地址为:http://Smartbi-server:port/smartbi/vision/config.jsp
(2)导航到“扩展包 -> 扩展包存放路径”段,查看当前设置的扩展包路径。
(3)如果这里已经设置了路径,请直接跳转到下一步骤。
- 否则,请在服务器上手动创建一个新目录,比如 D:\Smartbi\Extensions ,然后将“扩展包 -> 扩展包存放路径”设置为刚刚创建的新目录,接着点击右下角的“保存”按钮。
- Smartbi 安装后默认的扩展包存放路径是 ./ext,它是对启动目录的相对路径,默认应该是 tomcat/bin/ext
(4)将扩展包(.ext 文件)上传到第3步中找到的、或者新创建的路径下。
- 如果可以直接登录服务器,手动将扩展包拷贝到上面配置的路径下。支持任意多个扩展包,比如下图就是把 sample1.ext、sample2.ext 和 sample3.ext 等三个扩展包放在 D:\Smartbi\Extensions 路径下。
说明
一般情况下建议将扩展打包为 *.ext 文件,但也支持直接将开发的扩展包 src\web 目录直接拷贝到扩展包路径下,这样该扩展包也能被加载。如上图所示,sample1 和 sample2 分别打包为 ext 文件了,而 sample3 则直接拷贝其 src\web 目录,这三个扩展包都会被正确加载。
(5)重启 Smartbi 应用服务器。
(6)清除浏览器缓存,重新访问 Smartbi。
(7)至此,一般可以正常看到扩展包中新增的功能了。
- 如果还是不行,请确认对应的扩展包是否已经正确加载了。访问“系统监控 → 扩展包”界面,确认在扩展包列表中是否包含我们在第4步中所上传的扩展包。
- 或者,还可能是因为第6步中清除浏览器缓存没有生效,可以在浏览器中”打开新的无痕窗口“,然后再访问Smartbi。