1.3插件使用场景

       通常会用扩展包实现客户现场要求的特定需求，譬如：

       1、新增独立的功能，譬如新增个jsp、servlet之类，除了可能调用smartbi接口外，其他都独立存在的功能，这类一般不受smartbi影响，只要按开发java web项目思路开发即可。

       2、在产品内置功能模块界面增加、删除或修改某个功能点，譬如在报表上增加导出到ftp功能之类，这类会依据smartbi有没有提供修改入口，具体问题具体分析，请见扩展包原理。

       3、用户单点登陆（比如客户现场已经有统一登陆平台，这时候就需要这个功能）之类产品提供了服务端扩展点功能。

       4、具体示例请见 插件开发示例库。

1.4插件原理

       要理解扩展包为什么能做使用场景中提到的事情之前，建议先快速看下 第一课：插件项目介绍。扩展包其实是一个类war包的东西，只是 Smartbi 通过插件机制将其作为smartbi.war包的补充， 插件扩展方式是：

1、覆盖产品同名文件，达到改造产品功能目的：如图片、js、html、css、jsp等，扩展包中的文件会覆盖与smartbi.war中同路径下的同名文件，譬如扩展包名.ext\vision\a.js是会替换smartbi.war\vision\a.js文件的，具体示例请见替换Smartbi文件。

2、插件类似于war包，war包中有的jsp，servlet，filter在插件中都可以创建，可以达到新增jsp、servlet、filter等个性需求。

3、smartbi 中 同名.js.patch 文件会修改产品内置同名 js 脚本功能（非覆盖）。在加载 js 脚本时，会遍历所有扩展包，然后将扩展包中同路径及同名的 .js.patch 文件内容附加到产品内置 js 文件的后面，最后返回的是合并后的 js文件，具体请见 如何修改Smartbi JS文件，这是最常用的扩展方式，通常如果需要服务端实现部分逻辑的话，就要结合自定义module实现特定功能。

4、ConfigurationPatch.js 加载原理如下。使用系统提供的各种前端插入点修改产品特定功能点，也就是在扩展包中的 ConfigurationPatch.js 文件中配置插入点，达到修改功能的目的。

（1）客户端请求 smartbi；

（2）系统初始化时会加载 Configuration.js 配置文件；

（3）加载 Configuration.js 时，系统会遍历所有扩展包中的 ConfigurationPatch.js，将其合并到 Configuration.js 中并返回到前端，这里的合并是按 json 合并方式合并，也就是两个文件中的 json 对象按 smartbi 指定的合并规则，最后合并为一个 json 对象返回，前端在对应的插入点会读取这些配置项实现相应的功能。

5、自定义验证类等服务端扩展点，这都是接口性质。

1.5开发及调试

       请见 开发框架，具体涉及项目需求如何开发调试建议一定看下 Smartbi前端框架介绍及调试定位入门。

       开发教程2.0 以常见的可能碰到的知识点去组织，日常工作中可能遇到的各种问题，看了一遍也加深对扩展包的理解。

2.术语及定义

3.常见问题

3.1为什么要使用插件

• 从项目角度上看： 把项目定制化的需求做成插件，这样能够最大限度地控制项目化的需求对产品的影响，控制不同项目之间相互影响，项目需求响应的及时性也能得到保证。
• 从产品开发角度上看： 把产品新功能模块的开发做成插件，这样可以有效避免新功能开发对产品的影响，从而最大限度的保证产品的质量。

3.2如何在Smartbi中加载插件

• 项目定制化需求开发的插件： 启动Smartbi服务器，访问http://server_ip:host/smartbi/config。在config界面上，指定插件的存放路径，比如“C: /SmartbiExtension/“目录，然后保存配置。
• 研发内部开发的新功能插件： 修改 smartbi.war/WEB-INF/extensions/extensions.list 文件，每一行为一个插件路径的声明。除了指定 .ext 插件包文件，也可以声明加载指定目录下的插件，比如“..\ExtensionManager.SandBox\src\web\“，这时要指定到src\web目录。

3.3Smartbi是否可以同时加载多个插件

• Smartbi 里面允许同时加载多个插件：把多个插件包放到同一个目录中，然后通过config配置界面把插件路径指向该目录，或者在extensions.list文件中添加多个插件包路径。具体配置方法，请参见上一小节。

3.4插件的加载策略是什么

3.4.1加载策略

       Smartbi 服务器启动时，会自动加载所有插件，并调用相关的激活方法。若插件中存在与smartbi.war中同名的文件时，会优先读取插件中的文件，当多个插件中存在同名文件时会以第一个插件优先，当然我们也可以设置各个插件包包的加载优先级，但ConfigurationPatch.js 会自动合并，不存在覆盖问题。

3.4.2插件的加载顺序

1、首先加载“smartbi.war/WEB-INF/extensions/extensions.list”文件中声明的插件包，再加载Smartbi配置界面中指定的目录。

2、在extensions.list文件中，每一行都是一个插件路径的声明，系统按顺序加载各个插件。 例如下面声明了三个插件，系统加载顺序依次是sample3、sample1.ext、sample2.ext。 

3、通过Smartbi配置界面声明插件的存放路径时，该路径中可以保存多个以.ext结尾的插件或者包含多个插件的目录。其对插件的加载顺序是按插件的名字顺序来进行加载，假如该目录中存放了三个插件，则系统依次加载sample1.ext、sample2.ext、sample3。

3.5在WebSphere部署插件的问题

       当使用 WebSphere 作为服务器时，可能会出现无法加载插件内的图片、Servlet的情况，在出现此情况下，请按以下步骤进行修改：

1、展开服务器 → 应用程序服务器。

2、点击 server1。

3、点击 Web容器设置 → Web容器。

4、点击 定制属性。

5、点击 新建。

6、输入名称：com.ibm.ws.webcontainer.invokefilterscompatibility，其值为 true。

7、保存并重新启动应用服务器。