一、引言
报表大家应该都知道是什么,简单来说就是用表格、图表等格式来动态显示数据。现在web系统中很多需要使用到报表统计、打印功能等,将所需用到的数据绑定到指定的位置,然后分类汇总,这样查看起来更清晰,管理人员分析数据也一目了然。今天就我之前所做的项目总结一下使用stimulsoft报表的经验。
二、准备工作
首先,需要安装Stimulsoft,我使用的版本是ultimate旗舰版本,当然这个软件是需要收费的,如果大家只需学习的话,可以去官网下载免费试用版。下载完成后,如果项目所需数据库是oracle,那么stimulsoft是连接不上免安装客户端绿色版的plsql的,需要安装oracle客户端(注:如果同时安装了32位和64位Oracle客户端,必须设置Oracle环境变量PATH只能指向64位客户端安装地址(默认会把32位和64位客户端安装地址都加上))。
2.1 使用oracle中表、视图
其次,因为Stimulsoft报表设计器本身不自带Oracle连接,所以需要以下步骤来添加oracle 的连接支持。
1.打开Stimulsoft报表安装目录/Adapters/Oracle.zip,解压Oracle.zip,并且编译解压文件夹下面的Oralce项目,把编译的Dll拷贝至Stimulsoft报表安装目录/bin目录下面。(项目名称Stimulsoft.Report.OracleClient,Dll名称:Stimulsoft.Report.OracleClient.dll)
2。添加完该dll后打开stimulsoft设计器就能看到oracle连接了
3. 设置连接字符串,测试如果成功,Oracle就连接成功没有问题。如果连接保错请确认是否是64位操作系统安装了64位客户端,PATH地址是否设对
4.根据Oralce连接->新建数据源->New Query ,这时并不像Sql Server数据库会自动加载数据表等信息,需要我们自定义sql查询语句。
5.填写sql查询语句,建议不要点击运行查询构造器,如果要查询结果可以点击运行或者查询结果。
6.点击获取所有列
7.最后绑定数据源,将每个值的表达式赋值,赋值内容为该数据源下所获取到的列。
2.2 使用Oracle存储过程
使用Oracle存储过程的话,上面2.1的步骤就不需要了,如果是使用sqlserver存储过程,那上面的步骤还是必不可需的,sqlserver忽略步骤。
首先新建数据源,不再是选择Oracle连接,而是选择Dataview,然后通过后台程序自定义数据源,将存储过程返回到Dataview中,这种方法比较方便。
然后,与2.1步骤不同的是新增自定义列,因为没有连接到数据库中的表和视图,所以那些字段列只能在数据源中自己新增,然后和2.1中步骤7一样绑定列
最后保存,生成报表mrt文件
2.3 sqlserver文件转为oracle
用vs等设计器打开后实则为xml文件,oracle和sqlserver的xml文件有所不同,如果原先是用sqlserver设计可以后期把它改成oracle设计,修改方法如下。
1.将所有连接类型为Stimulsoft.Report.Dictionary.StiOracleDatabase转换为Stimulsoft.Report.Dictionary.StiSqlDatabase
2.将所有数据源类型为Stimulsoft.Report.Dictionary.StiOracleSource转换为数据源类型为Stimulsoft.Report.Dictionary.StiSqlSource
3.另存为Report_Sql.mrt
4.最好打开设计文件预览并检查是否有SqlServer和Oracle表结构不匹配的情况(字段名称不同等)
三、问题汇总
1. 能不能实现这种类型的报表?
可以先看下知识库里面的Demo,其中也包含了官网Demo。
2. 能不能实现参数传递?
可以的。
1> 字典->添加变量(如myRowGuid)
2> 如果是需要使用stimulsoft自带的变量交互区域,则设置变量的Request From User和Allow User Values属性为true;如果不需要使用stimulsoft自带的变量交互区域,因为可能样式等与系统不匹配,则可以自己定义变量交互区域(查询区域),只需设置Request From User和Allow User Values属性为false。
3> 如何把变量值传给报表变量?
ü 在报表使用时(加大括号)
如 select * from customers where RowGuid = {myRowGuid}
ü 在aspx页面后台代码赋值:
StiReport report = new StiReport();
rreport.Load("Report.mrt");
report.Compile();
//初始化值
report["myvariable"] = 123;//如果是字符串要加上单引号‘123‘或者Sql语
//句写为‘{myRowGuid}‘
report.Render();
StiWebView1.Report = report;
3. 能否改数据库连接?
可以的。
//清理数据库
report.Dictionary.Databases.Clear();
//增加数据库连接(Test为报表中定义的连接名称,MyDataConnectionString为实际的字符串连接)
report.Dictionary.Databases.Add(new StiSqlDatabase("Test",
"MyDataConnectionString"));
4. 是否支持存储过程和函数获取数据源?
支持的。其中存储过程可以传参数、函数也可以传参数(函数查询文本如select * from dbo.func({VarA})
1> Sql Server存储过程设置:
查询文本:execute Pro {VarA}, {VarB} 类型选择:Table
2> Oracle存储过程设置链接地址:
利用微软企业库带参数执行存储过程,最后用动态游标查看输出结果程序集
5. 能够自定义数据源?
可以的。
Report.RegData(DataSet dataSet)、Report.RegData(DataTable dataTable)、Report.RegData(DataView dataView) 等等都可以给report自定义数据源。
但是对应的DataTable必须取个tableName,因为加载的时候以tableName来加载,如没有tableName会报错
例DataTable table = new DataTable("table");可以
但DataTable table = new DataTable();就会报错
6. 为什么有些属性看不到?
在属性区域右击可以选择Basic、Standard、Professional(最全的)
7. 怎么查看代码?
在代码标签下面查看。右击选择Show Auto Generated Code来查看自动生成的代码,可以看到自定义的表达式等。
8. 如何做个性化开发?
1> 将report保存成.cs代码,修改.cs代码做个性化开发。保存.cs文件也可以是进行Debug查找错误。
2> 可以编写组件的事件,做个性化开发。(点击属性->事件标签)
一般遇到出错无法找到错误原因时,可以保存成.cs文件进行Debug。
report的加载和属性设置代码可以参考Stimulsoft_Reports.Net_FAQ.En.pdf文档
四、相关代码
4.1 在aspx页面中
1.首先需要在页头注册一下stimulsoft,因为我用的是2014.3.0.0版本的设计器设计的,所以这里注册也必须是这个版本,否则会报黄页
<%@ Register Assembly="Stimulsoft.Report.Web, Version=2014.3.0.0, Culture=neutral, PublicKeyToken=ebe6666cba19647a" Namespace="Stimulsoft.Report.Web" TagPrefix="cc1" %>
2.其次在body中插入该控件,设置属性
<cc1:StiWebViewer ID="StiWebViewer1" runat="server" Height="700px" Width="100%" BackColor="White" BorderColor="White" ToolBarBackColor="240, 240, 240" ScrollBarsMode="True" RenderMode="AjaxWithCache" />
4.2 在.cs中
//TODO: Oracle需要添加这两段代码加载报表,sql无需添加 StiConfig.Services.Add(new Stimulsoft.Report.Dictionary.StiOracleAdapterService());//数据源类型 StiConfig.Services.Add(new Stimulsoft.Report.Dictionary.StiOracleDatabase());//连接类型 string appDirectory = HttpContext.Current.Server.MapPath("");//获取文件绝对路径 StiReport report = new StiReport(); report.Load(appDirectory + "\\Report.mrt"); DataSet dsGw = b_wm.GetWzInfoCount(DateFromToEx.FromText, DateFromToEx.ToText, ddlYear.SelectedValue, "01");//从存储过程获取岗位培训统计表 DataSet dsYy = b_wm.GetWzInfoCount(DateFromToEx.FromText, DateFromToEx.ToText, ddlYear.SelectedValue, "02");//从存储过程获取业余学校统计表 if (dsGw == null || dsYy == null) return; DataView dvGw = dsGw.Tables[0].DefaultView;//岗位培训所有的数据 DataView dvYy = dsYy.Tables[0].DefaultView;//业余学校所有的数据 report.RegData("GWPXXX", dvGw);//自定义岗位培训数据源 report.RegData("YYXXXX", dvYy);//自定义业余学校数据源 StiWebViewer1.Report = report;
如果不是系统不是用的oracle数据库连接,那么无需添加数据源类型和连接类型,也就是开头两句不需要,反之除了添加stimulsoft的引用,还需添加Stimulsoft.Report.OracleClient的dll,否则会报找不到网络路径,找了很久才发现是这个错误。
存储过程的代码就不贴出来了,大意就是将所需要的参数传入存储过程中,通过一些条件插入临时表中,然后设置动态游标,查看程序结果集。
整个页面效果截图如下,为了方便,我将它暂时缩小了
五、结语
今天大概就写这么多,不知道对于stimulsoft我的理解对不对,如果有人感兴趣可以和我探讨探讨。