Overview of Customizing Form Handlers

A form handler is a JavaScript function that Siebel CRM Desktop defines in the forms.js file. Each form that displays a top-level object, such as an account or contact, includes a form handler. If the user double-clicks one of these objects, then Siebel CRM Desktop does the following work:

  • Determines if a form handler exists for this object.

  • If a form handler exists, then Siebel CRM Desktop calls the function that the form handler specifies.

The form handler uses the following format:

objectType_form()

For example:

contact_form()

You can specify a form handler between the following tags in the definition of the object in the forms_xx.xml file:

<script>>
</script>

For example, the following code specifies a form handler for contacts:

<script><![CDATA[
  include("forms.js", "forms");
  var ctx = {"application": application,"ui": ui,"application_script": 
  application_script,"form": form};
  var current_form = new forms.contact_form(forms.create_form_ctx(ctx));
  ]]>
</script>