dsp:param

dsp:param (input parameter) holds a parameter name and value that are made available to the parent servlet bean.

Note: The parameters created and set by this tag can be accessed by any DSP tags on this page using standard ATG syntax. These parameters should not be confused with parameters saved to a scoped object such as pageScope that are available via EL syntax.

Attributes

ParameterName:name(Required)

The name attribute identifies a specific input parameter that is defined for the parent servlet bean. Each servlet bean accepts a distinct set of input parameters; for more information on servlet bean input parameters, see Appendix B, ATG Servlet Beans.

ParameterValue:bean,param,orvalue(Required)

These attributes provide the value to the input parameter identified in the name attribute. You must set the value equal to a component property (bean), page parameter (param), or constant (value).

Attribute

Description

Example

bean

Property that the parameter in the name attribute is set to. This attribute should include the Nucleus path, component name, and property name.

<dsp:param name= "repository"
bean="/atg/dynamo/droplet/
PossibleValues.repository/>

param

Page parameter that the parameter in the name attribute is set to. You can use a value that was previously set to the page parameter.

<dsp:param name="propertyName"
param="element.repositoryId"/>

value

Value that the parameter in the name attribute is set to.

<dsp:param name="sortProperties"
value="date"/>

TagConverters

The tag converter tools let you convert a parameter value into the format of your choice:

  • number

  • currency (including currencyConversion, euro, reverse, and symbol)

  • date

  • maxdate and mindate

  • nullable

  • creditCard (including groupingsize, maskcharacter, and numcharsunmasked)

  • valueishtml

For more information, see Tag Converters.

Example

<dsp:droplet bean="StudentInfo>
   <dsp:param name="color" bean="/myeans/Color.favoriteColor"/>
   <dsp:param name="moneyRaised" param="raised" value="0"
   currency="true"/>
   <dsp:param name="age" value="24"/>
</dsp:droplet>

In this example, a custom servlet bean called StudentInfo is defined to process input parameters color, moneyRaised, and age. The StudentInfo component evaluates each input parameter and put them into parameter/value pairs:

These pairs are handled by the dsp:droplet code and made available to any open or output parameters specified in the JSP (of which there are none in this example).

 
loading table of contents...