Stimulsoft报表操作笔记（一）：统计

一、引言

　　报表大家应该都知道是什么，简单来说就是用表格、图表等格式来动态显示数据。现在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我的理解对不对，如果有人感兴趣可以和我探讨探讨。