Enables entry of Map data on a form.




Required, specifies one or more key/value pairs separated by the separator character—by default, a comma.


Optional, the character that separates a Map key and its value.

Default: equals sign (=)


Optional, the character that separates multiple key/value settings.

Default: comma (,)

Usage Notes

ATG’s built-in map converter facilitates input of Map property values on forms. You can use it with dsp:input as follows:

<dsp:input bean="FormHandler.map-property" converter="map"
key=value"[,...] />

Note: The map converter is not required by the RepositoryFormHandler, which can handle Map data in its own way (see Managing Map Properties in the RepositoryFormHandler chapter).

The map converter lets you input multiple key/value pairs. For example:

Please verify the following address:<br/><br/>

Street:&nbsp;<c:out value="${emp.street}"/>  <br/>
City::&nbsp;<c:out value="${emp.city}"/>     <br/>
State::&nbsp;<c:out value="${emp.state}"/>   <br/>
Zip code::&nbsp;<c:out value="${emp.zip}"/>  <br/>

<dsp:input type="hidden"
  bean="FormHandler.address" converter="map"

For more information on using the map converter, see Map Properties in the Forms chapter.