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

name

The form handler’s name in the ACC

description

Optional description of this formHandler

path

The Nucleus path of this formHandler component

attributes

Optional key/value pairs. This property sets the attributes property of the form handler class atg.epub.servlet.AssetFormHandler.

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

DefaultFile

BinaryFileAssetFormHandler

DefaultRepository

RepositoryAssetFormHandler

DefaultRepositoryConflict

ProjectDiffFormHandler

DefaultRepositoryDiff

AssetDiffFormHandler

File Folder Form Handler

FolderAssetFormHandler

File Form Handler

FileRepositoryAssetFormHandler

ViewMapping:formHandler:100062

TextFileAssetFormHandler

ViewMapping:formHandler:100080

SegmentAssetFormHandler

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:

The ATG Platform API Reference describes atg.epub.servlet.AssetFormHandler. For more about View Mapping form handlers, see Appendix C, Form Handlers.