1.2操作步骤
该框架小工具是 Smartbi 插件包的模版项目,用来生成Smartbi插件包的框架代码。
1、首先下载extscaffold-Smartbi.zip和extscaffold-Smartbi.cmd工具,用来生成插件包项目的框架代码。
2、在IE 10或以上的机器中,extscaffold-Smartbi.html 有可能无法正常工作,则可以使用上面的 extscaffold-Smartbi.cmd,双击即可运行。
3、解压后用 IE 浏览器打开 extscaffold-Smartbi.html 文件,浏览器会在页面顶部的信息栏提示“已限制此网页运行可以访问计算机的脚本和ActiveX控件”,点击信息栏,在出现的快捷菜单上点击“允许阻止的内容”。最新版本的 IE 会在页面底部提示,直接点击“允许阻止的内容”。
注意:这个工具生成的applicationContext.xml,extension.xml等xml文件,需要另存为UTF-8的格式,否则可能报错。
4、在页面上设置“工作目录”和“工程名称”,然后点击“执行”按钮,它会在你指定的“D:\Smartbi_ext\”目录下生成 HelloWorld 项目的全部框架代码。
5、然后在 Eclipse 中 Import 该项目到开发环境中即可。
2.开发调试新功能
2.1开发新功能
直接在 SmartbiPluginApp 项目中添加自己的功能,如果是后台代码添加到 /SmartbiPluginApp/src/java 目录下;如果是前端代码、图片、文件全部添加到 /SmartbiPluginApp/src/web/vision 路径下。
2.2调试新功能
1、配置插件包, 在 Eclipse 中启动 Run_SmartbiPluginApp,打开浏览器访问 config.jsp 页面,配置 smartbi 插件包加载路径指向 /HelloWorld/src/web。或者通过下面方式添加插件包路径到smartbi项目。
- 环境修改:/SmartbiPluginApp/apache-tomcat-7.0.42/webapps/smartbi/WEB-INF/extensions/extensions.list 文件,以便让 smartbi 加载正在开发的代码。请确认该文件中是否存在下面这一行,如果没有则添加。
- 将插件包路径:(d:\test)\src\web添加到extensions.list
2、若需要则在插件包代码中设置断点,若是js文件可在需要的地方写debugger语句调试。
3、在 Eclipse 中启动 Run_SmartbiPluginApp,然后打开浏览器访问自己新开发的功能。如下所示:
注意:如果项目现场还想多创建一个插件包,并加入到这个调试环境中,具体操作方法如下:
1、使用上文中提供的工具创建插件包。比如,创建的插件包名为SecondPlugin, 存放在:D:/ext/ 目录下。
2、在上面的 Eclipse 开发环境中,点击“File -> Import -> Existing Projects into Workspace”(或者右击Package Explorer -> Import),将上面插件包项目加入到Eclipse 环境中。
3、加载插件包,修改/SmartbiPluginApp/apache-tomcat-7.0.42/webapps/smartbi/WEB-INF/extensions/extensions.list 文件,在其中加入一行 D:/ext/SecondPlugin/src/web。
4、重新启动服务器,这样这个新插件包也加入到smartbi 中了,并且可以调试它。
3.打包插件
开发调试全部完成后,如何将所开发的成果部署到生产环境上。利用 Ant Build 配置文件 /SmartbiPluginApp/build.xml,将整个项目的代码打包成一个 ext 插件包。然后参考“插件部署”文档,将打包后的插件包部署到生产环境中。