Configuring Siebel Open UI > Post-Upgrade Configuration Tasks > Updating Physical Renderer Customizations for Controls >

Control State Manipulation

Beginning in Siebel Innovation Pack 2014, the manipulation of the DOM state of a control occurs in a single call in the control's wrapper element using the SetState API. Previously this type of manipulation could have been done in many different ways, therefore any custom renderer code must be located and modified.

To find and modify the control state manipulations in your custom renderer code

1. Determine if you have code similar to the following:

   $('[name="' + control.GetInputName() + '"]').hide();

2. Replace all instances of calls similar to code discovered in Step 1 by a call to the control's plug-in wrapper that internally affects the state of the element and hides it. Use the following code as guidance:

   this.GetUIWrapper(control).SetState(consts.get("SHOW"), false);

3. Determine if you have code similar to the following:

   $('[name="' + control.GetInputName() + '"]').attr("readOnly", "readOnly");

   The code above, is a case where a particular control is being made non-editable on the DOM.

4. Replace all instances of calls similar to code discovered in Step 3 using following convention:

   this.GetUIWrapper(control).SetState(consts.get("EDITABLE"), false);

5. Determine if you have code similar to the following:

   $('[name="' + control.GetInputName() + '"]').focus();

   The code above, is a case where there is an attempt to set focus on a particular control.

6. Replace all instances of calls similar to code discovered in Step 5 using following convention:

   this.GetUIWrapper(control).SetState(consts.get("FOCUS"), true);

The SetState API exists in the prototype space of the plug-in wrapper and can also be overridden in a custom plug-in wrapper to be used to affect the functionality of setting states on the control.

For more information about state modification, including parameters accepted by SetState, and the modifications made to the control element, see Architecture of Siebel Open UI and Siebel Open UI Application Programming Interface.