Configuring Siebel Open UI > Customizing Siebel Open UI > Guidelines for Customizing Siebel Open UI >

Guidelines for Customizing Presentation Models

It is recommended that you apply the following guidelines if you configure a presentation model:

• Make sure you customize Siebel Open UI so that the user-interface state is separate from the rendering of this state. The guidelines in this topic describe how to do this.
• Add a new presentation model only after you consider all other customization options, such as modifying code in a Object Definition Html or using Siebel Tools to modify an object. To examine some examples that do not modify the presentation model, see Customizing Siebel Open UI.

  A presentation model implements the entire abstraction of the user interface content, so the predefined implementation of a presentation model implements the predefined abstraction. There are only a few types of basic user interface abstractions, such as single record, list, tree, and so on. It is recommended that you use a predefined presentation model for each of these basic abstractions that Oracle provides you.

• Make sure Siebel Open UI models all the state variables that it requires to achieve a rich client behavior, and that it models these state variables as presentation model properties. These properties can reside in the presentation model on the client, or the Siebel Server can provide them from an applet. You can add methods that modify these properties and that manage the state changes after you configure Siebel Open UI to add them. Siebel Open UI typically calls these methods due to a user action, or if the server sends a notification. If a method modifies the logical state of the user interface, then Siebel Open UI uses the AttachPMBinding method to add a binding trigger to the physical renderer. This trigger binds the modified state to the physical user interface. For more information, see AttachPMBinding Method.

Siebel Open UI strictly defines each life cycle method. To help make sure your implementation is clean and readable, it is recommended that you use the following guidelines:

• Make sure Siebel Open UI uses all presentation model state variables as properties. You must use the AddProperty method to create these properties. You must not use ordinary JavaScript variables to create these properties.
• Use methods to implement all state changes of the presentation model. Use the AddMethod method to create these methods.
• Make sure Siebel Open UI uses the AttachEventHandler method to bind each method that the presentation model contains to an event that the physical renderer contains. Each event occurs as the result of some physical user action. This configuration makes sure Siebel Open UI binds each user action to the required logic and modifies the user interface state. For more information, see AttachEventHandler Method.
• When Siebel Open UI sends a reply, it includes all modifications that occur in the business component layer. It includes these modifications in the reply that it sends in a Notification property set. You must use the AttachNotificationHandler method to add this notification. For more information, see Notifications That Siebel Open UI Supports:
  • Siebel Open UI packages a reply from the server for any predefined type of request. It includes this package in a predefined reply property set. You must use the AttachPSHandler method to add the handler for any property set type that the server sends.
  • You must use the AttachPostProcessingHandle method to add any post-processing handler that does follow up logic on a server request, such as a NewRecord request. You can add this logic after Siebel Open UI finishes processing the reply for this request. Setting the focus for a control is an example of this kind of configuration.
• Siebel Open UI does the initial setup of the presentation model when it initializes the Siebel view or application, depending on whether the user interface object resides inside or outside of the view. The server sends a property set that includes all the initialization attributes. The proxy uses most of these attributes, but you must use the AddProperty method to get the values that the presentation model requires to set and store the state.
• You must use the following methods in the physical renderer the first time Siebel Open UI renders the user interface:
  • BindEvents. Binds the presentation model methods to the appropriate events on a control. For more information, see BindEvents Method.
  • BindData. Accesses the presentation model properties, and then sends them to the control through the methods that this control exposes. For more information, see BindData Method.
• You must configure Siebel Open UI to bind any state changes to the presentation model that occur after the physical renderer finishes the initial rendering. To do this, you configure Siebel Open UI to call the AttachPMBinding method on the physical renderer. This configuration specifies the method that the physical renderer must call or the properties that it must access so that it can send data back to the control. This configuration allows Siebel Open UI to render the user interface after it modifies the presentation model state.