Smartbi V9 帮助中心
页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 3 下一个 »

1.部署插件开发环境

       部署插件开发环境有两种方式，一种是使用插件开发IDE，其中包含了插件开发所需要的开发工具Eclipse，JDK，Tomcat，Smartbi的war包，适合于新手；另一种是手动配置插件开发环境，适合于已有WEB开发环境用户。

1.1插件开发IDE

       具体操作步骤如下：

       1、安装与启动IDE

       请到以下地址下载IDE：链接：https://pan.baidu.com/s/1CbX-g_471o3oIocpRdsbEw 密码：9vjz

       请根据具体版本下载对应的IDE开发工具，如是V8请下载V8版本，如是V7请下载V7版本。

       将下载回来的"SmartbiPluginIDE.zip"解压缩，进入解压后的目录执行"Startup.bat"即可启动IDE。启动后效果如下：

1.2手动配置插件开发环境

       下载并加载SmartbiPluginApp：在这里假设您已经下载并配置好了 Eclipse 开发工具。然后从这里下载 SmartbiPluginApp.zip 项目，将其解压到自己的代码开发工作目录下。启动 Eclipse 工具，然后在“Package Explorer”窗格上点击右键“Import...”，导入刚刚解压的 SmartbiPluginApp 项目。如下图所示：

2.启动应用服务器

       开发调试环境的原理是这样的：上一步我们在 Eclipse 中加载的 SmartbiPluginApp 项目包含了 apache-tomcat-7.0.42，在其下部署了 smartbi 应用。该 smartbi 应用在运行时，会加载其它扩展包项目，从而让开发人员对其它扩展包项目的代码进行调试。接下来我们需要进行配置，让该 smartbi 正常运行起来。

2.1取得开发用的Smartbi-License文件

       首先需要从思迈特处申请一个开发用的 Smartbi-License 文件。将取得的 Smartbi-License.xml 文件直接覆盖 /SmartbiPluginApp/apache-tomcat-7.0.42/bin/smartbi/ 目录下的同名文件。

2.2配置开发环境的知识库

       该开发环境下的 smartbi 需要有个知识库，修改 /SmartbiPluginApp/apache-tomcat-7.0.42/bin/smartbi/smartbi-config.xml 文件，设置知识库连接信息，主要修改<dao/>这一段。

<dao>
    <database-type>MYSQL</database-type>
    <server-name>localhost:6688</server-name>
    <database-name>smartbi-dev-ide</database-name>
    <username>admin</username>
    <pass>admin</pass>
    <encrypt-type>0</encrypt-type>
    <max-count>100</max-count>
    <init-count>2</init-count>
</dao>

2.3启动 apache-tomcat-7.0.42

       SmartbiPluginApp 项目下已经添加了一个 Run_SmartbiPluginApp 启动配置文件，可以直接在“Debug”、“Run”模式下启动它。

2.4更新开发环境下smartbi版本

       下载回来的 SmartbiPluginApp 项目虽然自带了一个 smartbi，但是其版本比较早。在开发调试时，要求开发所基于的smartbi版本，应该与未来生产环境部署的smartbi版本一致。因此我们还需要升级 /SmartbiPluginApp/apache-tomcat-7.0.42/webapps 路径下的 smartbi，具体升级过程可以参考：Smartbi版本更新。

3.创建扩展包

3.1说明

       因为 Smartbi 扩展包里面的目录结构还是有一定规范的，虽然可以手动使用Eclipse 开发工具，通过“File -> New -> project …”创建一个扩展插件项目工程，但还是得手动按照 Smartbi 的插件目录规范创建目录及文件，稍显麻烦，而且可能也不会记得要创建些什么文件以及文件的配置结构是什么。

       所以Smartbi 提供了一个工具用来创建扩展包项目，自动将需要的文件及目录创建好，创建好后手动使用Eclipse中的“File ->Import -> Existing Projects Info Workspace ...”导入到开发环境中即可。

3.2操作步骤

       该框架小工具是 Smartbi 扩展包的模版项目，用来生成Smartbi扩展包的框架代码。

       1、首先下载 extscaffold-Smartbi 或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 该项目到开发环境中即可。

4.开发调试新功能

4.1开发新功能

       直接在 SmartbiPluginApp 项目中添加自己的功能，如果是后台代码添加到 /SmartbiPluginApp/src/java 目录下；如果是前端代码、图片、文件全部添加到 /SmartbiPluginApp/src/web/vision 路径下。

4.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

       2、若需要则在扩展包代码中设置断点，若是js文件可在需要的地方写debugger语句调试
        3、在 Eclipse 中启动 Run_SmartbiPluginApp，然后打开浏览器访问自己新开发的功能。如下所示：

5.打包插件

       开发调试全部完成后，如何将所开发的成果部署到生产环境上。利用 Ant Build 配置文件 /SmartbiPluginApp/build.xml，将整个项目的代码打包成一个 ext 扩展包。然后参考“扩展包部署”文档，将打包后的扩展包部署到生产环境中。

6.如何支持多扩展包开发

       如果项目现场还想多创建一个扩展包，如何加入到这个调试环境中呢？具体操作方法如下：

       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。

..\..\..\..\..\src\web
D:/ext/SecondPlugin/src/web

       4、参照上面启动应用服务器，这样这个新扩展包也加入到smartbi 中了，并且可以调试它。

7.如何解决扩展包修改后需要重启生效

       1、修改SmartbiPluginApp/apache-tomcat-7.0.42/webapps/smartbi/WEB-INF下的web.xml文件，在文件中加入 DevEnv 对应的四行代码。在文件中找到 ProductName 这个 <context-param>，在其下面添加 DevEnv 对应的四行<context-param>，其值为 true。

<context-param>
            <param-name>ProductName</param-name>
            <param-value>Smartbi</param-value>
</context-param>
<context-param>
            <param-name>DevEnv</param-name>
            <param-value>true</param-value>
</context-param>

       2、修改同样是web.xml中如图所示的位置

       3、删除SmartbiPluginApp/apache-tomcat-7.0.42/webapps/smartbi/vision/version.txt 文件

 

 

 

 

 

 

 

 


  • 无标签