集算器对报表reportliteCli外部库文件具体操作步骤如下:
1. 配置jar包
将以下jar包从报表的类路径(【安装根目录】\reportlite\lib)中拷贝到集算器目录(【安装根目录】\esProc\ extlib\ReportLiteCli);
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
reportlite.jar
scu-reportlite-cli-2.10.jar
其中,ReportLite外部库核心jar为scu-reportlite-cli-2.10.jar。
注意:使用报表reportliteCli外部库时还需要用到以下第三方jar,下列jar文件已经内置到集算器中,无需用户再手动配置。
batik-all-1.16.jar
commons-codec-1.15.jar
core-3.3.0.jar
poi-5.2.5.jar
poi-ooxml-5.2.5.jar
poi-ooxml-lite-5.2.5.jar
注:以上第三方依赖jar,用户可根据实际应用环境灵活使用。
2. 配置xml文件
从【安装根目录】\reportlite\config下复制raqsoftConfig.xml(复制后文件名可随意命名)这里我们将文件名命名为raqsoftConfigReportLite.xml,在raqsoftConfigReportLite.xml文件中需配置如下节点:
<Report>
<home> </home> //报表主目录配置
<styleConfig> </styleConfig> //报表样式配置
</Report>
说明:
<home>配置报表的默认存储目录,使用相对路径读取报表时会相对这里配置的主目录。
<styleConfig>配置报表样式文件路径,该节点可以为空。
3. 配置数据源
需要读取的报表中如用到数据源,那么在raqsoftConfigReportLite.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>F:\scudata\esProc\extlib</extLibsPath>
<importLibs>
//配置外部库文件夹名称
<lib>ReportLiteCli</lib>
</importLibs>
</Esproc>
5. 集算器中读取报表文件
可以通过reportlite_config()、reportlite_open()、reportlite_run()等函数读取报表文件,函数用法请参考集算器菜单【帮助】->【函数参考】文档。