Creating and initializing parameter fields

Before a parameter field can be set in a report, the fields to be set must first be created, then initialized. Individual parameter fields are all stored in a Fields object. The Fields object is simply a collection of different fields that can be passed to the viewer.

To create parameter fields

1. Create a Fields object to store the parameter fields in.

   Fields fields = new Fields();

2. Create a ParameterField object for each field that you wish to set.

   ParameterField pfield1 = new ParameterField();
   

   ParameterField pfield2 = new ParameterField();
   

3. Create a Values object and a ParameterFieldDiscreteValue object for each parameter field you wish to set.

   If a ranged value is being set, a ParameterFieldRangeValue object should be used instead of the discrete value object.

   Values vals1 = new Values();
   

   Values vals2 = new Values();
   

   ParameterFieldDiscreteValue pfieldDV1 = new ParameterFieldDiscreteValue();
   

   ParameterFieldDiscreteValue pfieldDV2 = new ParameterFieldDiscreteValue();
   

Once all the required objects have been created, the values for the fields can be initialized.

To initialize parameter fields

1. Set the name and value for each parameter field that is added.

   Values for parameter fields are represented by a ParameterFieldDiscreteValue or ParameterFieldRangeValue object.

   pfield1.setName("Region");
   

   pfieldDV1.setValue("Japan");
   

   pfieldDV1.setDescription("The region is Japan");
   

   
   

   Integer CountryCode = new Integer("81");
   

   pfield2.setName("Country Code");
   

   pfieldDV2.setValue(CountryCode);
   

   pfieldDV2.setDescription("The country code is 81");
   

2. Add the parameter field values to the Values collection object.

   vals1.add(pfieldDV1);
   

   vals2.add(pfieldDV2);
   

3. Set the current Values collection for each parameter field.

   pfield1.setCurrentValues(vals1);
   

   pfield2.setCurrentValues(vals2);
   

4. Add each parameter field to the Fields collection.

   The Fields object is now ready to be used with the viewer.

   fields.add(pfield1);
   

   fields.add(pfield2);