e表集成开发手册

如何集成e表 ................................................................................................................................... 2

e表 for .NET版的集成 .......................................................................................................... 2

1复制系统文件 ................................................................................................................ 2 2数据库连接 .................................................................................................................... 2 3 集成到vs.net2003和 2005之间的不同 .................................................................... 2 e表 for .J2EE版的集成 .......................................................................................................... 3

1复制系统文件 ................................................................................................................ 3 2数据库连接 .................................................................................................................... 3 运行报表 ................................................................................................................................... 3

在运行报表时动态指定数据源 ....................................................................................... 4 在运行报表时控制权限 ................................................................................................... 5 配置运行报表的工具栏 ................................................................................................... 5 在iframe中运行报表 ...................................................................................................... 6 修改报表 ................................................................................................................................... 7 接口开发........................................................................................................................................... 7

将报表格式文件保存到数据库中 ........................................................................................... 7 自定义数据集 ........................................................................................................................... 8 定期运行报表的实现 ............................................................................................................... 9 装入已存好的报表结果页面 ................................................................................................. 11 含参数的报表的运算结果保存 ............................................................................................. 13 从运行报表工具栏上保存报表的运算结果 ......................................................................... 14 如何实现在运行报表时调整统计图功能 ............................................................................. 15 实现自定义函数功能 ............................................................................................................. 16 报表运行时改变参数或宏的事件 ......................................................................................... 18 报表运行时改变数据集配置的事件 ..................................................................................... 19

如何集成e表

e表 for .NET版的集成

1复制系统文件

将ebiao/bin 目录下的所有dll文件复制到自己系统的bin目录下。 将ebiao/ebsys 目录复制到自己的虚拟目录下。

将ebiao/log4net.config 文件复制到自己的虚拟目录下。

2数据库连接

系统可以配置一个默认的数据库连接，当数据集中没有指定连接串时用它。默认的数据库连接串在web.config文件中的此处配置：

在自己系统的web.config文件中加上此配置。

数据库连接串的写法格式常用有以下几种：

Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=ebtest;User ID=sa;pwd=;

表示用oledb方式来连接sql server库 表示用sqlclient方式来连接sql server库 表示用oledb方式来连接oracle库 表示用oracleclient方式来连接oracle库

Data Source=localhost;Initial Catalog=ebtest;User Id=sa;Password=;

Provider=OraOLEDB.Oracle;Data Source=sys;User ID=eboracle;Password=eboracle; Data Source=sys; Integrated Security=no; User Id=eboracle;Password=eboracle;

3 集成到vs.net2003和 2005之间的不同

集成到vs2003时应将bin目录下的 WebBill.dll 文件删除，因为它是当前工程生成出来的dll，同时应将bin目录中的所有dll文件添加引用到当前项目中。同时应将当前目录的设置为可写，即象安装时做的这一步一样： 3、从资源管理器中选中C:\\Inetpub\\wwwroot\\ebiao目录(假如你的IIS装在C:\\下),按右键,点属性菜单,点安全页签,在名称列表中选中Everyone,然后将下面的权限列表中的允许这一列都勾上,按确定即可. (注：此步不做的话，则无法保存报表文件) 。

e表 for .J2EE版的集成

1复制系统文件

将ebiao 目录下的所有文件复制到自己系统的webapps目录下。

2数据库连接

系统可以配置一个默认的数据库连接，当数据集中没有指定连接串时用它。默认的数据库连接串在fc.properties文件中配置：

driver=oracle.jdbc.driver.OracleDriver ccerp.url=jdbc:oracle:thin:@localhost:1521:sys ccerp.user=fcdemo ccerp.password=fcdemo ccerp.maxconn=100 ccerp.normalconn=2 conntimeout=3000 debug=false mailhome=d:/ pagesize=15 addresssize=10

注意:如果是连oracle数据库,则应将

D:\\fcsoft\\tomcat\\webapps\\ebiao\\ebsys\\fceform\\js\\fcpub.js 文件,将第6行的 databaseTypeName : \ 改成 databaseTypeName : \ 然后保存即可.

运行报表

在报表设计器中设计好了报表文件后，可以通过在IE地址栏上直接输入：

http://localhost/ebiao/ebsys/fceform/ereport/ebrun.htm?file=/ebiao/ebsys/ebfile/test.htm

(注意：这个路径一般是对于e表 for .NET版而言的，对于e表 for J2EE版而言，往往需要加上端口号，如：http://localhost:8080/ebiao/ebsys/fceform/ereport/ebrun.htm?file=/ebiao/ebsys/ebfile/test.htm ,下同)

来运行，其中 test 为报表文件名。 /ebiao/ebsys/ebfile/为报表所在的路径。

如是含报表参数的报表，要在运行时自动带上报表参数，即不出一个界面来输入报表参数。

这种情况下运行报表的格式如下：

http://localhost/ebiao/ebsys/fceform/ereport/ebrun.htm?file=/ebiao/ebsys/ebfile/samples/s_参数表单.htm&startdate=2005-02-01&urlpara=yes

在运行报表的URL中含有urlpara=yes 表示不会出现报表参数的输入界面。 startdate=2005-02-01 表示报表参数startdate的值为2005-02-01 ，在URL中未给值的报表参数将为报表中定义的默认值。 也可以

http://localhost/ebiao/ebsys/fceform/ereport/ebrun.htm?file=/ebiao/ebsys/ebfile/samples/s_参数表单.htm&startdate=2005-02-01

表示运行报表时先给好了startdate的参数值，但同时出报表参数输入界面，供操作员输入其它报表参数值。

在运行报表的URL后加上 &e_runsavefile=a1 则表示运行报表时会在服务器端将当前报表的运行结果保存为文件，主文件名为a1，具体是当报表结果分多页时，文件名为 a1_1.htm，a1_2.htm，a1_3.htm 等等，还同时保存 a1.xls a1.xlt和a1.pdf，对应为excel和pdf的报表内容。这些文件保存在默认的路径下，即 ebsys/fceform/ereport/js/loadreport.js 中配置的 fcpub.tempFilePath 。

通过运行报表的URL中也可以用 &宏变量名=宏值 的方式预置放宏变量的值。 在运行报表的URL后面加上 &e_pageno=2 表示直接显示报表结果中的第二页的内容，这个值为从1开始的整数，但当 &e_pageno=-1 表示将分页前的整个报表运算结果显示出来。而且以固定行列的方式显示，即非数据区固定不动，数据区超过窗口的宽度或高度时可以来回滚动查看。

用 &e_pageno=-1 来运行报表，一般用只需要显示报表运行结果的场合，此时不考虑分页和打印，因为是不分页输出，所以当数据量大时可能会很慢。

在运行报表时动态指定数据源

在同一个报表文件上要实现动态指定数据库连接串，这个可通过在运行报表的URL后面加上 &urldatasource=值 的方式来实现。这个值的格式是：

default //如有default表示要打开默认的数据库连接

dbencoding=\\\ dbtype=\\\

drivername=\\\ encodesql=\\\ name=\\\ password=\\\

url=\\\ userid=\\\/>

… //可能有多个象上述ds格式的数据库连接串

上述格式的值因为直接写在URL上会不合法，所以需要用javascript函数escape后才行。例

如：在URL后加上:

urldatasource=default

在运行报表时控制权限

在运行报表时常常需要控制权限，比如张三能运行A报表，李四则不能运行A报表。在e表中实现此功能是通过在 ebsys/fceformext/js/userfunc.js 中的

/**

* 控制能不能运行某个报表 **/

function EbiaoEnterStatus(callback)

函数中写代码来实现的。如运行报表的URL中是用name=报表名称的方式，则在此函数中就要用

parent.Request.QueryString(\

来取得当前运行报表的名称，如是用file=报表文件的方式，则在此函数中就要用 parent.Request.QueryString(\来取得当前运行报表的文件，它是包含全路径的。

在此函数中先取session变量来取得当前用户信息。再判断能不能正常运行报表，如最后运行：

callback(true); //执行此命令表示能正常运行报表. 表示可以正常运行此报表，如最后运行： callback(false); //通知关闭窗口 表示不可以正常运行此报表。 示例代码如下：

GetSession(\ var sessionValue = arrRet[\ if(sessionValue == \

parent.Request.QueryString(\销售汇总报表\ alert(\你无权运行此报表!\ callback(false); //通知关闭窗口 return; }

callback(true); })

配置运行报表的工具栏

运行报表的工具栏可以通过ebsys/fceform/ereport/js/loadreport.js 中的 fcpub.toolbar 变量的值来配置。也可加上自定义的功能按钮。

运行报表的工具栏的样式可以通过ebsys/fceform/ereport/js/loadreport.js 中的

本文来源：https://www.bwwdw.com/article/bqc2.html