To configure the e-mail address widget, the data must be in a domain that is specific to e-mail addresses. Here, the SAMPLE_EMAIL_ADDR domain is assumed. The DomainsConfig.xml file should be added to the client application component, or the existing file should be modified if it already exists, to associate the view-renderer plug-in class with that domain.
<?xml version="1.0" encoding="ISO-8859-1"?>
<dc:domains
<dc:domain name="SAMPLE_EMAIL_ADDR">
<dc:plug-in name="view-renderer"
class="sample.EMailAddressViewRenderer"/>
</dc:domain>
</dc:domains>
Applying the above configuration, the view-renderer of the custom widget will now be invoked anywhere a UIM FIELD element has a source connection to a server interface property in the SAMPLE_EMAIL_ADDR domain. If the UIM FIELD has a target connection, the edit-renderer will be used instead. As no edit renderer is defined in this configuration, the edit-renderer of the parent or other ancestor domain, will be inherited and used. Typically, this will be the TextEditRenderer associated by default with the SVR_STRING domain.
More information about configuring renderers and other plug-ins is provided in Configuring Renderers.