A view mapping can contain a reference to the Nucleus form handler component used to handle the input of data for the asset. The form handler item in the View Mapping repository also provides attributes used to modify the behavior of the form handler that the item represents.
The formHandler item descriptor is defined as follows in ViewMapping.xml:
<item-descriptor name="formHandler" display-property="name" id-space-names="viewmapping" query-cache-size="20"> <table name="vmap_fh" type="primary" id-column-name="id"> <property name="id" data-type="string"/> <property name="name"/> <property name="description"/> <property name="path" column-name="component_path"/> </table> <!-- attributes property --> <table name="vmap_attrval_rel" type="multi" id-column-name="mapper_id" multi-column-name="name"> <property name="attributes" column-name="attribute_id" data-type="map" component-item-type="attributeValue" cascade="update,delete"/> </table> </item-descriptor>
Form handler items have the following key properties:
Property | Use |
|---|---|
attributes | Optional key/value pairs. This property sets the |
description | Human-readable description of the form handler |
name | The name for this form handler in the ACC |
path | The path of the Nucleus form handler component |
Form handlers are provided for all the default asset types in ATG Content Administration. The following table shows the form handler items in the view mapping repository and the form handler component to which they point.
ACC form handler item | Form handler component in |
|---|---|
| |
| |
|
|
| |
|
|
|
|
| |
|
Any custom form handlers that you create for use with the View Mapping system must implement the atg.epub.servlet.AssetFormHandler interface. In general, they should subclass RepositoryAssetFormHandler or one of the file asset form handler classes in atg.epub.servlet:
BaseFileAssetFormHandlerFolderAssetFormHandlerGenericFileAssetFormHandlerBinaryFileAssetFormHandlerTextFileAssetFormHandler
For more information on atg.epub.servlet.AssetFormHandler, see the ATG API Reference. For more information on the form handlers used within the View Mapping system, see Appendix C, Form Handlers.
