Configuring the Widget

To configure the email address widget, the data must be in a domain that is specific to email addresses. Here, the SAMPLE_EMAIL_ADDR domain is assumed. The DomainsConfig.xml file is added to the client application component, or the existing file is modified if it exists, to associate the view-renderer plug-in class with that domain.

Figure 1. Configuring the E-Mail Address Widget

<?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 configuration here, the view-renderer of the custom widget is now started 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, is inherited and used . Typically, this is the associated TextEditRenderer by default with the SVR_STRING domain.

More information about configuring renderers and other plug-ins is provided in Configuring Renderers.