Designing processes - EMC Community Network

Creating the User Interface
Adaptor Type
Item Validator
Document
Validator
Data Source
Available Templates
or Controls
Not available on high
fidelity templates
Available on these
controls: Text Field,
RichText, Number Field,
Date Field, DateTime
Field, CheckBox,
CheckBox Group,
Radio Button Group,
ListBox, Dropdown
List, Comment history,
Readonly Table, Slider,
Embedded Form, and
Filter
Not available on high
fidelity templates
Not available on high
fidelity templates
Available on selection
controls only:
CheckBox Group,
ListBox, Dropdown
List, and Readonly
Table
Best Uses/Limitations
Use this adaptor if you want to validate a user’s input values
on individual fields. An item validator applies to one field
and occurs when the user submits the template.
For example, if a data item is an email address, the item
validator could check that it contains exactly one @, at least
one dot after the @, and a recognized domain after the final
dot.
If an error occurs, an error indicator appears next to the
control and the full error message appears at the bottom
of the template. You can create custom error messages
(recommended), or if there is no custom message a default
error message appears. However, if there is a hidden field
on the form that is also marked as required (this should be
avoided), the error message still appears at the bottom. You
can create a custom error message in a validator adaptor by
throwing an exception in the validator adaptor code.
The out-of-the-box validator adaptor validates string inputs
(from user) against the current repository by searching for
them in the list returned by a DQL query.
To perform other validation operations you create a custom
validator adaptor.
Use this adaptor to validate an entire form template.
Validation against a custom document validator and required
fields occurs when the user submits the template.
Error messages display at the bottom of the form. You can
create custom error messages (recommended), or if there are
no custom messages then default error messages appear. You
can create a custom error message in a validator adaptor by
throwing an exception in the validator adaptor code.
Use this adaptor to access information from an external data
source and then populate one or more selection controls on
the template. The data source can be either a properties file,
the repository, or a data source that responds to the Java
database connectivity (JDBC) protocol.
For example, when the user selects from a dropdown list of
manager names, the dropdown list of employees could be
automatically populated with only the employees who report
to the selected manager.
For data source adaptors, you also have the option of creating
a custom, complex output type. An output type communicates
between the adaptor and the form and defines the structure for
the values returned from the adaptor. The output type creates
a schema that corresponds to columns in the returned data.
This schema can then be used to map the returned values to
one or more fields on the form.
76 EMC Documentum xCelerated Composition Platform Version 1.6 Best Practices Guide