水晶报表参数赋值

// 声明将参数传递给查看器控件所需的变量。
ParameterFields paramFields = new ParameterFields ();
ParameterField paramField = new ParameterField ();
ParameterDiscreteValue discreteVal = new ParameterDiscreteValue ();//--离散值
ParameterRangeValue rangeVal = new ParameterRangeValue ();//--区域值
// 假设第一个参数是具有多个值的离散参数。
// 设置参数字段的名称，它必须和报表中的参数相符。
paramField.ParameterFieldName = "客户姓名";
// 设置第一个离散值并将其传递给该参数。
discreteVal.Value = "Jeason";
paramField.CurrentValues.Add (discreteVal);
// 设置第二个离散值并将其传递给该参数。
discreteVal = new ParameterDiscreteValue ();
discreteVal.Value = "Hank";
paramField.CurrentValues.Add (discreteVal);

// 将该参数添加到参数字段集合。
paramFields.Add (paramField);

// 假设第二个参数为区域值。
paramField = new ParameterField ();
// 设置参数字段的名称，它必须和报表中的参数相符。
paramField.ParameterFieldName = "客户ID";
// 设置范围的开始值和结束值并将该范围传递给该参数。
rangeVal.StartValue = 10;
rangeVal.EndValue = 50;
paramField.CurrentValues.Add (rangeVal);

// 将第二个参数添加到参数字段集合。
paramFields.Add (paramField);

// 将参数字段集合放入查看器控件。
crystalReportViewer1.ParameterFieldInfo = paramFields;

//整个赋值过程完毕
______________________________________________________________________




一. 把参数完全交过水晶报表

   打开报表文件.rpt，在字段资源管理器里，右击参数－》新建

    在下面的选项属性里可以设置参数的名称，类型，提示文本，是否允许多个值，值范围类型（如果是字符串用离散，日期或数字用范围）

    注意：上面都是比填的，如果参数是用来对应某个字段的，类型必需跟该字段一样。

   在值属性里可以建一个值的列表，点上去，然后点右边的按钮就进入值列表编辑框了；是否提示时仅显示说明；编辑掩码，可以给参数的指定一定的格式；最小长度；最大长度；

   现在你可以给这个报表创建一个查看器jsp，加viewer标签的就行了。

   注意这个jsp的页面编码设置为UTF-8.

二.   参数所需包跟相关对象

     1.  需要的java类和包      

         com.crystaldecisions.sdk.occa.report.data.*

          com.crystaldecisions.reports.sdk.DataDefController

     2.  创建一个存储参数字段的 Fields 对象。 参数对象都是放在这个里面，通过Fields对象可以添加、删除和查找参数对象  

          Fields fields = new Fields();

     3.   ParameterField 参数字段对象。

          ParameterField paramField1 = new ParameterField();

     4. 为想设置的每个参数字段创建一个 Values 对象。Values对象是用来存储ParameterFieldDiscreteValue 对象或 ParameterFieldRangeValue 对象

          Values newVals1 = new Values();

     5. 离散值对象ParameterFieldDiscreteValue 对象

        ParameterFieldDiscreteValue newDiscVal1 = new ParameterFieldDiscreteValue();

        ParameterFieldDiscreteValue[ ] newDiscVals = new ParameterFieldDiscreteValue[ ];

       范围值对象ParameterFieldRangeValue 对象

        ParameterFieldRangeValue newRangeVal1 = new   ParameterFieldRangeValue();

        ParameterFieldRangeValue[ ] newRangeVals = new   ParameterFieldRangeValue[ ];

      他们的大概关系：一个Fields－》多个ParameterField

                                       一个ParameterField－》一个Values

                                      一个Values－》多个ParameterFieldDiscreteValue 或ParameterFieldRangeValue

三.   后台设置参数

      1.  参数的管理都是通过 报表DataDefController 来控制的。

          DataDefController dataDefController ＝ new DataDefController();

          对于主报表 dataDefController = reportClientDoc.getDataDefController();

          对于子报表

          dataDefController = clientDoc.getSubreportController().getSubreport(reportName).getDataDefController();

      2.  参数的设置信息是通过 IDataDefinition 来获取的。

           IDataDefinition dataDefinition = dataDefController.getDataDefinition();   

          如:Fields fields = dataDefController.getDataDefinition().getParameterFields() ;

          而对参数的设置改动是通过 ParameterFieldController 来控制的

           ParameterFieldController   paramfieldcontroller= dataDefController.getParameterFieldController( );

          如: 给主报表参数字段设置单个值

            paramFieldController.setCurrentValue("", "StringParam", new String("Hello"));         //字符串类型
            paramFieldController.setCurrentValue("", "BooleanParam", new Boolean(true));     //布尔类型
            paramFieldController.setCurrentValue("", "CurrencyParam", new Double(123.45));//货币类型
            paramFieldController.setCurrentValue("", "NumberParam", new Integer(123));         //数字类型

           给某个参数字段设置多个离散值

           Object [] multiVals = {"String1", "String2", "String3"};                     //注意要对应参数字段的类型
           paramFieldController.setCurrentValues("", "StringMultiParam", multiVals);

      3.  取得Fields

           Fields fields = dataDefController.getDataDefinition().getParameterFields() ;

       4.  对已经建立的参数字段，通过Fields的在知道名字的情况下通过Find方法取得

       ParameterField paramField = (ParameterField)dataDefController.getDataDefinition().getParameterFields().findField(parameterName, FieldDisplayNameType.fieldName, Locale.getDefault());

         参数字段七个基本类型
        布尔(Boolean) 、货币(Double)、数字(Integer)、字符串(String)、日期、日期时间、时间(Date)

        参数的值必须跟参数的类型符合才行. 

       5.  如果是新建的参数字段，那必需设置参数字段的报表名称设置为与参数关联的报表名称。如果参数字段用于主报表，则使用空白字符串 ("")。使用 setReportName 方法设置报表名称。

          paramField1.setName("Country");             //设置名字

          paramField1.setReportName("");              //如果为 "   "就是用于主报表,如果子报表，要设置字报表名

         如果是已经在rpt中存在的参数，就不用设置名字和报表名称了，也不用添加到Fields中。

          newDiscVal1.setValue("China");               //设置离散值，后面将添加到参数值列表中

          newDiscVal1.setDescription("The country is China.");//这个要不要都没关系

          将参数字段值添加到 Values 集合对象。  

           newVals1.add(newDiscVal1);                //可以添加多个

           为参数字段设置 Values 集合。

           pfield1.setCurrentValues(vals1);

           向 Fields 对象添加每个参数字段。 Fields 对象现在可用于查看器  

           fields.add(pfield1);                   //非新建参数不用

    下面是重点啦。虽然很简单，但是折磨了我三天

     6.  改动查看报表JSP页面的参数字段离散值列表或范围值列表

          先用取得paramField对象，这个前面有说怎么取得，这里不多说了

         要添加的离散值

         ParameterFieldDiscreteValue newDiscValue = new ParameterFieldDiscreteValue();
         newDiscValue.setValue(newValue);

        取得原来的Values集合，在把Values集合克隆到一个新的Values集合。我原来是用paramField.getValues()，不知道是JRC中出错还是什么，这个方法竟然完全没用，paramField.getDefaultValues().才能真正的取得参数对象的Values集合

         Values newVals = (Values)paramField.getDefaultValues().clone(true);

        在原来的离散值中再添加多个离散值

        newVals.add(newDiscValue);

       为参数字段设置新的Values集合。这里原来是用paramField.setCurrentValues(newVals)，也是不行，要用下面的   paramField.setDefaultValues(newVals);

        paramField.setDefaultValues(newVals);

7.   禁用用户提示，自动使用设置的参数字段值。这在以下情况中特别有用：所设置的参数字段值对于用户为未知（例如系统生成的参数）。

     　通过boolean multiValue = paramField.getAllowMultiValue();判断报表是否允许多值。
   
     　不允许多值的情况下：

　　clientDoc.getDataDefController().getParameterFieldController().setCurrentValue(reportName, parameterName , newValue);

　　如果是用于主报表,reportName为" ",否则为子报表名称。

　　允许多值的情况下：

　　①如果不考虑原来的离散值列表

　　 String[] newValues = new String[]{"China","USA",..........};

　　clientDoc.getDataDefController().getParameterFieldController().setCurrentValues(reportName, parameterName ,newValues);

　

　　②在原来离散值列表的基础上添加新的离散值，并设置

       DataDefController dataDefController = null;
       if(reportName.equals(""))
          dataDefController = clientDoc.getDataDefController();
      else
        dataDefController = clientDoc.getSubreportController().getSubreport (reportName).getDataDefController();
 
      ParameterField paramField = (ParameterField)dataDefController.getDataDefinition().getParameterFields().findField(parameterName, FieldDisplayNameType.fieldName, Locale.getDefault());

     ParameterFieldDiscreteValue newDiscValue = new ParameterFieldDiscreteValue();
     newDiscValue.setValue(newValue);

     Values newVals = (Values)paramField.getDefaultValues().clone(true);

     newVals.add(newDiscValue);

     clientDoc.getDataDefController().getParameterFieldController().setCurrentValue(reportName, parameterName ,newVals);

       查看器的设置

        crystalReportPageViewer.setParameterFields(fields);//这个感觉用不用都没关系

        crystalReportPageViewer.setEnableParameterPrompt(false);

       报表的参数设置好后，则调用查看器的刷新方法以应用新的参数。

       if(session.getAttribute("refresh")==null){
            crystalReportPageViewer.refresh();
            session.setAttribute("refresh","true");
      }
     调用 processHttpRequest 方法以在当前的浏览器窗口中启动此查看器。    

     crystalReportPageViewer.processHttpRequest(request, response, getServletConfig().getServletContext(), null);

    注意不要在查看器里面设置刷新按钮，一按就会丢失参数设置。页面编码UTF-8。如果不行就tomcat profect－》reload this context