An itemMapping
can specify a Nucleus form handler component to handle input of asset data. 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.
Item Descriptor Definition
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>
formHandler Item Properties
formHandler
item properties include the following:
Property | Description |
---|---|
| The form handler’s name in the ACC |
| Optional description of this |
| The Nucleus path of this |
| Optional key/value pairs. This property sets the |
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 items | Form handler component in /atg/epub/servlet |
---|---|
| |
| |
|
|
| |
|
|
|
|
| |
|
View Mapping system form handlers must implement this interface:
atg.epub.servlet.AssetFormHandler
In general, form handlers should subclass RepositoryAssetFormHandler
or one of the file asset form handler classes in atg.epub.servlet
:
BaseFileAssetFormHandler
FolderAssetFormHandler
GenericFileAssetFormHandler
BinaryFileAssetFormHandler
TextFileAssetFormHandler
The ATG Platform API Reference describes atg.epub.servlet.AssetFormHandler
. For more about View Mapping form handlers, see Appendix B: Form Handlers.