集算器连接外部库

集算器对报表Report5Cli外部库文件具体操作步骤如下：

1. 配置jar包

将以下jar包从报表的类路径（【安装根目录】\report\lib或【安装根目录】\report\web\webapps\demo\WEB-INF\lib）中拷贝到集算器目录（【安装根目录】\esProc\ extlib\Report5Cli）；

jboss-servlet-api_3.1-1.0.0.jar

esproc-ext-********.jar

htmlparser-1.6.jar

pdfbox-2.0.27.jar

fontbox-2.0.27.jar

graphics-box2.0.27.jar

mail-1.4.4.jar

raqsoftReport.jar

scu-report5-cli-2.10.jar

其中，报表外部库核心jar为scu-report5-cli-2.10.jar。

注意：使用报表Report5Cli外部库时还需要用到以下第三方jar，下列jar文件已经内置到集算器中，无需用户再手动配置。

batik-all-1.16.jar

commons-codec-1.15.jar

poi-5.0.0.jar

poi-ooxml-5.0.0.jar

poi-ooxml-full-5.0.0.jar

poi-ooxml-lite-5.0.0.jar

注：以上第三方依赖jar，用户可根据实际应用环境灵活使用。

 

2. 配置xml文件

从【安装根目录】\report\config下复制raqsoftConfig.xml（复制后文件名可随意命名）这里我们将文件名命名为raqsoftConfigReport.xml，在raqsoftConfigReport.xml文件中需配置如下节点：

<Report>

<home> </home>  //报表主目录配置

<styleConfig> </styleConfig>  //报表样式配置

</Report>

说明：

<home>配置报表的默认存储目录，使用相对路径读取报表时会相对这里配置的主目录。该节点可以为空。

<styleConfig>配置报表样式文件路径，该节点可以为空。

3. 配置数据源

需要读取的报表中如用到数据源，那么在raqsoftConfigReport.xml文件中则需要配置与之名称相同的数据源，并且数据结构要一致。如果报表中没有使用数据源，则本步可省略。

<DB name="demo">

<property name="url" value="jdbc:hsqldb:hsql://127.0.0.1/demo" />

<property name="driver" value="org.hsqldb.jdbcDriver" />

<property name="type" value="13" />

<property name="user" value="sa" />

<property name="password" />

<property name="batchSize" value="1000" />

<property name="autoConnect" value="true" />

… …

</DB>

如果通过命令行方式执行spl文件，那么需要配置xml中数据源节点的autoConnect属性值为true，否则会找不到数据源。

4. 集算器设计器配置外部库目录

在菜单栏中选择【工具】-【选项】-【环境】，进入如下界面：

 

点击【外部库目录】后的【选择】按钮进入选择外部库界面，如下图所示：

 

此时点击选择按钮选择外部库所在的目录，点击【确定】，重启IDE后生效。

注：

1)外部库文件夹名称及路径用户可自定义，但要尽量避免选择子目录太多的目录作为外部库目录，以免影响目录加载效率；也不要将不同外部库的jar放置在同一个目录下，以防jar包冲突出现其他不必要的问题。

2)非图形界面通过命令行方式执行spl文件时，可手动修改【安装根目录】/esProc/config/raqsoftConfig.xml配置文件，添加外部库目录：

<Esproc>

… …

//配置外部库文件夹路径

<extLibsPath>D:\raqsoft\esProc\extlib</extLibsPath>

<importLibs>

//配置外部库文件夹名称

<lib>Report5Cli</lib>

</importLibs>

</Esproc>

5. 集算器中读取报表文件

可以通过report_config()、report_open()、report_run()等函数读取报表文件，函数用法请参考集算器菜单【帮助】->【函数参考】文档。

注：

该功能暂不支持填报表、参数表单。

当spl读取的报表文件中用到了自定义函数时，函数的实现类要放到raqsoftReport.jar的相应路径才可以被加载到。