报表参数的获取与配置详解

报表是有参数的，通过报表参数可以使用程序进行获取和配置。参数是报表生成之前想报表设计文件输入的报表元素。报表的应用程序可以访问报表的参数的属性，最常用的属性是name和value，你可以使用参数名或通用编码来获取参数。

蒙山ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景，ssl证书未来市场广阔！成为创新互联公司的ssl证书销售渠道，可以享受市场价格4-6折优惠！如果有意向欢迎电话联系或者加微信：18982081108（备注：SSL证书合作）期待与您的合作！

为报表设计创建一个参数定义任务

一个IGetParameterDefinitionTask对象提供链接到报表设计所有参数的接口。通过调用 ReportEngine.createGetParameterDefinitionTask( )创建一个参数定义对象，使用结束后调用他的close方法关闭。

测试报表设计是否有参数

IGetParameterDefinitionTask.getParameterDefns( )可以测试报表设计是否有参数，它返回一个参数集合，调用集合的isEmpty( )方法可以测试集合中是否有元素。

获取报表设计的参数

通过IGetParameterDefinitionTask.getParameterDefn( )方法获取一个已老牌字的参数，它返回一个IParameterDefnBase类型对象，也可以调用getParameterDefns( )方法返回一个参数集合。

getParameterDefns( )需要一个boolean参数，如果为false返回一个未分组的参数集合，如果为true返回报表设计中定义的参数组。

调用IParameterDefnBase.getParameterType( )可以检验参数是否是一个组。如果是一个组则返回IParameterDefnBase.PARAMETER_GROUP，如果是一个级联参数组则返回 IParameterDefnBase.CASCADING_PARAMETER_GROUP。为获取一组报表参数，使用方法 IParameterGroupDefn.getContents( )，它返回一个数据类型是IScalarParameterDefn的ArrayList对象。

获取报表参数的默认值

这个任务是可选的。调用IGetParameterDefinitionTask.getDefaultValue( )获取一个已知参数的默认值，它返回的是一个Object。可以通过调用IScalarParameterDefn.getDataType( )来获取Object的有效类型，它返回一个IScalarParameterDefn定义的int类型的静态变量。调用 IGetParameterDefinitionTask.getDefaultValues( )来获取报表设计的所有参数的默认值，它返回一个HashMap对象存储了从参数名到默认值的映射。

使用常量列表提供的效值

许多报表参数只接受常量列表的值，这些值可能是静态常量，也可能是数据库里查出来的数据list。使用 IGetParameterDefinitionTask.getSelectionList( )可以返回参数所能接受的参数（IParameterSelectionChoice）的集合，如果集合为null，则可以接受任何值。 IParameterSelectionChoice的getLabel( )方法返回现实的文本，getValue( )返回值。

获取每个报表参数的属性

这个任务是可选的。使用IScalarParameterDefn的方法可以获取表参数的属性。应用程序使用属性生成用户自定义接口。例如，获取参数的数据类型使用getDataType( )方法。

为参数设置值

调用IGetParameterDefinitionTask.setParameterValue( )为参数设置值。如果你是通过应用程为日期数值等参数返回一个字符串，要把他们转化成和本地无关的格式。调用方法 ReportParameterConverter.parse( )方法可以完成这项工作。getParameterValues( )方法返回一个HashMap包含了已经设置的所有参数。

报表参数设置实例

下面的代码展示了如何设置一个已知参数名的参数值：

 
 
 
    
  
  
  
  1. // Create a parameter definition task.   
    2. 
  
  
  
  2. IGetParameterDefinitionTask task = engine.createGetParameterDefinitionTask( runnable );   
    3. 
  
  
  
  3. // Instantiate a scalar parameter.   
    4. 
  
  
  
  4. IScalarParameterDefn param = (IScalarParameterDefn)    
    5. 
  
  
  
  5. task.getParameterDefn( "customerID" );   
    6. 
  
  
  
  6. // Get the default value of the parameter. In this case,    
    7. 
  
  
  
  7. // the data type of the parameter, customerID, is Double.   
    8. 
  
  
  
  8. int customerID = ((Double) task.getDefaultValue( param )).intValue( );   
    9. 
  
  
  
  9. // Get a value for the parameter. This example assumes that    
    10. 
  
  
  
  10. // this step creates a correctly typed object, inputValue.   
    11. 
  
  
  
  11. // Set the value of the parameter.   
    12. 
  
  
  
  12. task.setParameterValue( "customerID", inputValue );   
    13. 
  
  
  
  13. // Get the values set by the application for all parameters.   
    14. 
  
  
  
  14. HashMap parameterValues = task.getParameterValues( );   
    15. 
  
  
  
  15. // Close the parameter definition task.   
    16. 
  
  
  
  16. task.close( );   
    17. 
  
  
  
  17. // Create a parameter definition task. 
    18. 
  
  
  
  18. IGetParameterDefinitionTask task = engine.createGetParameterDefinitionTask( runnable ); 
    19. 
  
  
  
  19. // Instantiate a scalar parameter. 
    20. 
  
  
  
  20. IScalarParameterDefn param = (IScalarParameterDefn)  
    21. 
  
  
  
  21. task.getParameterDefn( "customerID" ); 
    22. 
  
  
  
  22. // Get the default value of the parameter. In this case,  
    23. 
  
  
  
  23. // the data type of the parameter, customerID, is Double. 
    24. 
  
  
  
  24. int customerID = ((Double) task.getDefaultValue( param )).intValue( ); 
    25. 
  
  
  
  25. // Get a value for the parameter. This example assumes that  
    26. 
  
  
  
  26. // this step creates a correctly typed object, inputValue. 
    27. 
  
  
  
  27. // Set the value of the parameter. 
    28. 
  
  
  
  28. task.setParameterValue( "customerID", inputValue ); 
    29. 
  
  
  
  29. // Get the values set by the application for all parameters. 
    30. 
  
  
  
  30. HashMap parameterValues = task.getParameterValues( ); 
    31. 
  
  
  
  31. // Close the parameter definition task. 
    32. 
  
  
  
  32. task.close( ); 
    33.

下面的代码展示了如何使用报表参数集合，例子中使用ReportParameterConverter将字符串转化成用户接口接受的参数格式。

 
 
 
    
  
  
  
  1. // Create a parameter definition task.   
    2. 
  
  
  
  2. IGetParameterDefinitionTask task = engine.createGetParameterDefinitionTask( runnable );   
    3. 
  
  
  
  3. // Create a collection of the parameters in the report design.   
    4. 
  
  
  
  4. Collection params = task.getParameterDefns( false );   
    5. 
  
  
  
  5. // Get the default values of the parameters.   
    6. 
  
  
  
  6. HashMap parameterValues = task.getDefaultValues( );   
    7. 
  
  
  
  7. // Get values for the parameters. Later code in this example   
    8. 
  
  
  
  8. // assumes that this step creates a HashMap object,   
    9. 
  
  
  
  9. // inputValues. The keys in the HashMap are the parameter   
    10. 
  
  
  
  10. // names and the values are those that the user provided.   
    11. 
  
  
  
  11. // Iterate through the report parameters, setting the values    
    12. 
  
  
  
  12. // in standard locale-independent format.   
    13. 
  
  
  
  13. Iterator iterOuter = params.iterator( );   
    14. 
  
  
  
  14. ReportParameterConverter cfgConverter =   
    15. 
  
  
  
  15.         new ReportParameterConverter( "", Locale.getDefault() );   
    16. 
  
  
  
  16. while ( iterOuter.hasNext( ) ) {   
    17. 
  
  
  
  17. IParameterDefnBase param = (IParameterDefnBase) iterOuter.next( );   
    18. 
  
  
  
  18. String value = (String) inputValues.get( param.getName( ));   
    19. 
  
  
  
  19. if ( value != null ) {   
    20. 
  
  
  
  20. parameterValues.put( param.getName( ),    
    21. 
  
  
  
  21. cfgConverter.parse( value, param.getDataType( ) ) );   
    22. 
  
  
  
  22. }   
    23. 
  
  
  
  23. }   
    24. 
  
  
  
  24. // Close the parameter definition task.   
    25. 
  
  
  
  25. task.close( );   
    26. 
  
  
  
  26. // Create a parameter definition task. 
    27. 
  
  
  
  27. IGetParameterDefinitionTask task = engine.createGetParameterDefinitionTask( runnable ); 
    28. 
  
  
  
  28. // Create a collection of the parameters in the report design. 
    29. 
  
  
  
  29. Collection params = task.getParameterDefns( false ); 
    30. 
  
  
  
  30. // Get the default values of the parameters. 
    31. 
  
  
  
  31. HashMap parameterValues = task.getDefaultValues( ); 
    32. 
  
  
  
  32. // Get values for the parameters. Later code in this example 
    33. 
  
  
  
  33. // assumes that this step creates a HashMap object, 
    34. 
  
  
  
  34. // inputValues. The keys in the HashMap are the parameter 
    35. 
  
  
  
  35. // names and the values are those that the user provided. 
    36. 
  
  
  
  36. // Iterate through the report parameters, setting the values  
    37. 
  
  
  
  37. // in standard locale-independent format. 
    38. 
  
  
  
  38. Iterator iterOuter = params.iterator( ); 
    39. 
  
  
  
  39. ReportParameterConverter cfgConverter = 
    40. 
  
  
  
  40.         new ReportParameterConverter( "", Locale.getDefault() ); 
    41. 
  
  
  
  41. while ( iterOuter.hasNext( ) ) { 
    42. 
  
  
  
  42. IParameterDefnBase param = (IParameterDefnBase) iterOuter.next( ); 
    43. 
  
  
  
  43. String value = (String) inputValues.get( param.getName( )); 
    44. 
  
  
  
  44. if ( value != null ) { 
    45. 
  
  
  
  45. parameterValues.put( param.getName( ),  
    46. 
  
  
  
  46. cfgConverter.parse( value, param.getDataType( ) ) ); 
    47. 
  
  
  
  47. } 
    48. 
  
  
  
  48. } 
    49. 
  
  
  
  49. // Close the parameter definition task. 
    50. 
  
  
  
  50. task.close( ); 
    51.

使用级联参数

级联参数参数是一组可供用户选择的参数值的集合。第一个参数的选择会影响到第二个参数中的值。参数使用一个或多个查询来从数据集把数据展示给用户。参数定义任务根据前面的选择以行为单位过滤参数组中的数据。

使用报表引擎实现级联参数，要进行如下工作：

■使用IGetParameterDefinitionTask.evaluateQuery( )方法为级联参数准备数据，它需要参数group的名字作为参数。

■调用IGetParameterDefinitionTask.getSelectionListForCascadingGroup( )获取参数组的第一个参数的值，它需要两个参数，参数名和对象数组，对第一个参数来说这个数组是空的。该方法返回一个 IParameterSelectionChoice集合。

■ 再次调用getSelectionListForCascadingGroup( )方法获取后面的参数，这次Object[ ]中放的是前面获取的参数值。

下面的代码展示了如何通过查询实现级联参数：

 
 
 
    
  
  
  
  1. // Create a grouped collection of the design’s parameters.   
    2. 
  
  
  
  2. Collection params = task.getParameterDefns( true );   
    3. 
  
  
  
  3. // Iterate through the parameters to find the cascading group.   
    4. 
  
  
  
  4. Iterator iter = params.iterator( );   
    5. 
  
  
  
  5. while ( iter.hasNext( ) ) {   
    6. 
  
  
  
  6. IParameterDefnBase param = (IParameterDefnBase) iter.next();   
    7. 
  
  
  
  7. if ( param.getParameterType() ==    
    8. 
  
  
  
  8. IParameterDefnBase.CASCADING_PARAMETER_GROUP ) {   
    9. 
  
  
  
  9. ICascadingParameterGroup group = (ICascadingParameterGroup) param;   
    10. 
  
  
  
  10. Iterator i2 = group.getContents( ).iterator( );   
    11. 
  
  
  
  11. // Run the query for the cascading parameters.   
    12. 
  
  
  
  12. task.evaluateQuery( group.getName() );   
    13. 
  
  
  
  13. Object[ ] userValues = new Object[group.getContents( ).size( )];   
    14. 
  
  
  
  14. // Get the report parameters in the cascading group.   
    15. 
  
  
  
  15. int i = 0;   
    16. 
  
  
  
  16. while ( i2.hasNext( ) ) {   
    17. 
  
  
  
  17. IScalarParameterDefn member = (IScalarParameterDefn) i2.next( );   
    18. 
  
  
  
  18. // Get the values for the parameter.   
    19. 
  
  
  
  19. Object[ ] setValues = new Object[i];   
    20. 
  
  
  
  20. if ( i > 0 )  System.arraycopy( userValues, 0, setValues, 0, i );   
    21. 
  
  
  
  21. Collection c = task.getSelectionListForCascadingGroup(   
    22. 
  
  
  
  22.    group.getName(),setValues );   
    23. 
  
  
  
  23. // Iterate through the values for the parameter.   
    24. 
  
  
  
  24. Iterator i3 = c.iterator();   
    25. 
  
  
  
  25. while ( i3.hasNext( ) ) {   
    26. 
  
  
  
  26. IParameterSelectionChoice s =    
    27. 
  
  
  
  27. ( IParameterSelectionChoice ) i3.next( );   
    28. 
  
  
  
  28. String choiceValue = s.getValue( );   
    29. 
  
  
  
  29. String choiceLabel = s.getLabel( );   
    30. 
  
  
  
  30. }   
    31. 
  
  
  
  31. // Get the value for the parameter from the list of   
    32. 
  
  
  
  32. // choices. This example does not provide the code for   
    33. 
  
  
  
  33. // this task.   
    34. 
  
  
  
  34. userValues[i] = inputChoiceValue;   
    35. 
  
  
  
  35. i++;   
    36. 
  
  
  
  36. }   
    37. 
  
  
  
  37. }   
    38. 
  
  
  
  38. }   
    39.

以上就是用程序处理报表参数的配置方法。

当前文章：报表参数的获取与配置详解
本文URL：http://www.mswzjz.cn/qtweb/news24/74674.html

攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能，是专注品牌与效果的网络营销公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 贝锐智能

贝锐智能技术为您推荐以下文章

解决方案知识

同城分类信息

网站建设策划方案　　 　成都定制网页设计　　 　成都棕树机房　　 　关键词排名　　 　网站seo　　 　网站设计公司　　 　鳄鱼养殖　　 　成都茶叶销售　　 　食品包装设计　　 　关键词优化　　 　电商网站建设方案　　 　阿坝网站建设　　 　吉安网站建设　　 　广西弘博建站　　 　眉山服务器托管　　 　响应式网站设计方案　　 　平城网站运维　　 　微信小程序开发　　 　主动防护网　　 　众诚伟业