报表打印控件使用方法

一、简要说明

近期随着公司业务的发展，应用程序对报表的要求日益增多，为了满足用户对报表操作需求，适应公司各应用程序报表的统一处理，特编写了报表统一的处理控件和调取的应用程序。目前本程序已经使用于医院信息管理系统（HIS)。
应用技术：

• Microsoft Framework 4.0框架平台
• Microsoft SQL Server 数据库技术
• Microsort SQL Server Report Server 技术

二、服务器端配置

1. 在用户数据库服务器上启用SQL Server Reporting Services服务；
2. 通过用户的Reporting Services配置管理器，建立用户的报表服务器服务器（略）。
3. 按公司报表服务器规范，配置报表服务器的IIS地址、端口号、共享数据源、报表文件夹等内容。
4. 制作统一的rdl报表文件，上传到报表服务器端。

三、客户端配置

在应用程序客户端要求安装：

1. Microsoft Framework 4.0安装包
2. Microsoft.ReportViewer 12.0 控件安装包

四、HIS调用方法

（一） 命名空间：XHSOFT.HIS
（二） 函数类名：ReportFunction
（三） 相关函数：

1、打印窗口显示（ShowCommonReport --- 常规打印）

函数原型：

        #region 公共方法
        /// 

        /// 显示打印窗口
        /// 
        /// 报表名称
        /// 报表标题
        /// 操作人员姓名
        /// 参数输入语句（多参数时用竖线进行分隔）
        public void ShowCommonReport(string rName, string rTitle, string oName, string pStr)

参数说明：

报表名称：要求与报表服务器中的报表名称相同
报表标题：是打印显示窗口上方的标题，与报表实际内容中的标题无关
操作人员姓名：为程序调用报表制作打印时的实际操作人员姓名
参数输入语句：为报表调用时使用的实际参数内容，多参数时使用竖线进行分隔。例如：“9800145|2017-01-01|2017-12-31|1”。参数中不需要包含 操作人员姓名 参数，程序会自动将此参数做为最后一个参数附加到参数组中。即上述参数内容在调用报表时会自动变更为：“9800145|2017-01-01|2017-12-31|1|张三”，其中 张三 是参数操作人员姓名中的值。

示例：ShowCommonReport("Rep_YDyb_hz","测试报表","系统管理","9800145|2017-01-01|2017-12-31|1")

界面显示

常规打印窗口显示

2、打印窗口显示（ShowPeriodReport---时间段）

函数原型：

        /// 

        /// 显示打印窗口，允许设置时段
        /// 
        /// 报表名称
        /// 报表标题
        /// 操作人员姓名
        /// 参数前缀
        /// 参数后缀
        public void ShowPeriodReport(string rName, string rTitle, string oName, string preParams, string sufParams)

        /// 

        /// 显示打印窗口，允许设置时段
        /// 
        /// 报表名称
        /// 报表标题
        /// 操作人员姓名
        public void ShowPeriodReport(string rName, string rTitle, string oName)

参数说明：

1. 本函数的使用方法基本与 ShowCommonReport 相同，只是参数由应用程序自动生成（例如：“2018-01-01|2018-06-30”）。为了方便函数调用过程中其他参数的添加，增了 参数前缀 和 参数后缀 两个参数。如果需要在时间前面增加多个参数，则需要在参数前缀中使用竖线分隔；如果在时间段之后增加参数按参数前缀相同处理。
2. 如果调用函数中没有既参数前缀也参数后缀，则可以忽略不写这两个参数。

示例：下面界面显示的调用语句：ShowPeriodReport("Rep_YDyb_hz","测试报表","系统管理","9800145","1")

界面显示

可选择时间段打印窗口显示

三、打印报表窗口（ ShowPeriodAndDepartmentReport --- 时间段/科室选择）

函数原型：

        /// 

        /// 显示打印窗口，允许设置时段
        /// 
        /// 医疗模式编码
        /// 默认科室编码
        /// 打印报表名称
        /// 打印报表标题
        /// 操作人员姓名
        /// 报表参数前缀
        /// 报表参数后缀
        public void ShowPeriodAndDepartmentReport(string mCode,string dCode, string rName, string rTitle, string oName, string preParams, string sufParams)

        /// 

        /// 显示打印窗口，允许设置时段
        /// 
        /// 医疗模式编码
        /// 默认科室编码
        /// 打印报表名称
        /// 打印报表标题
        /// 操作人员姓名
        public void ShowPeriodAndDepartmentReport(string mCode, string dCode, string rName, string rTitle, string oName)

参数说明：

1. 医疗模式编码：1门诊，2住院
2. 默认科室编码：医院实际使用的科室编码。如果没有指定科室由用户进行选择，此参数设置为“00000”或空。为了方便公司后续数据的升级，本次科室编码采用5位数字，其中门诊科室在原来编码前面加“1”，住院科室在原来编码前面 加“2”。

示例：下面界面显示的调用语句：ShowPeriodAndDepartmentReport(“1”,“00000”, “Rep_YDyb_hz”, “测试报表”, “张三”, “9800145|21”, “22”)

界面显示

可选择时间段及科室的打印窗口