The GetFieldName method returns a string that includes the name of the field where a control is configured. It uses the following syntax:

GetFieldName()

It includes no arguments.

For examples that use GetFieldName, see Customizing Methods in the Presentation Model to Store Field Values and CanNavigate Method.

The GetHeight method returns a string that includes the height of a control, in pixels. It uses the following syntax:

GetHeight()

It includes no arguments.

The GetIndex method returns the index of a control. This index identifies the control position in the applet. It uses the following syntax:

GetIndex()

It includes no arguments.

The GetInputName method returns a string that includes the HTML Name attribute of a control. It uses the following syntax:

GetInputName()

It includes no arguments.

For examples that use the GetInputName method, see the following topics:

• Text Copy of Code That Does a Partial Refresh for the Physical Renderer
• GetPopupType Method
• GetPrompt Method

The GetJustification method returns a string that indicates the text justification. It uses the following syntax:

GetJustification()

It includes no arguments.

For an example that uses the GetJustification method, see LookupStringCache Method.

The GetMaxSize method returns the maximum number of characters that the user can enter into a control. It uses the following syntax:

GetMaxSize()

It includes no arguments.

The GetMethodName method returns a string that includes the name of a method that is configured on a control. It uses the following syntax:

GetMethodName()

It includes no arguments.

For an example that uses the GetMethodName method, see CanInvokeMethod Method for Presentation Models.

The GetName method that Siebel Open UI uses for applet controls returns the name of an applet control. It returns this name in a string. It uses the following syntax:

GetName()

It includes no arguments.

The following example uses the GetName method:

if (control.GetName() === "Account"){

// This is the account control.

alert ("You are leaving Account. This will trigger an immediate post change");

...

For other examples that use the GetName method, see the following topics:

• Customizing the Presentation Model to Identify the Records to Delete
• Overriding Predefined Methods in Presentation Models
• Text Copy of Code That Does a Partial Refresh for the Presentation Model
• CanNavigate Method
• ExecuteMethod Method
• IsPrivateField Method
• CellChange Method

For information about the GetName method that Siebel Open UI uses for other classes, see GetName Method for Applets see GetName Method for Application Models.

The GetPMPropSet method gets the property set for a control. It uses the following syntax:

control.GetPMPropSet(consts.get("SWE_CTRL_PM_PS")

To view an example that uses this method, see Customizing Control User Properties for Presentation Models.

The GetPopupHeight method returns a string that includes one of the following values:

• The height of the popup that is associated with a control, in pixels.
• Nothing if Siebel Open UI does not associate a popup dialog box with the control.

It uses the following syntax:

GetPopupHeight()

It includes no arguments.

For an example that uses the GetPopupHeight method, see GetPopupType Method.

The GetPopupType method identifies the type of popup object that Siebel Open UI associates with a control. It returns a string that includes one of the following values:

• Pick. Identifies a bounded pick list.
• Mvg. Identifies a multivalue group.
• Nothing if Siebel Open UI does not associate a popup dialog box with the control.

It uses the following syntax:

GetPopupType()

It includes no arguments.

The following example uses the GetPopupType method to make sure sufficient space exists to display the popup:

if (control.GetPoupType !== "Pick"){

// There's a Pick defined on this control.

var pHeight = control.GetPopupHeight();

var pWidth= control.GetPopupWidth();

if (pHeight > "60" || pWidth > "200"){

// The pop does not fit in the mobile screen, so we will disable this popup.)

var htmlName = control.GetInputName();

// Set the control into readonly mode.

$("[name=" + htmlName + "]").attr('readonly', true);

}

}

The GetPopupWidth method returns a string that includes one of the following values:

• The width of the popup that is associated with a control, in pixels.
• Nothing if Siebel Open UI does not associate a popup dialog box with the control.

It uses the following syntax:

GetPopupWidth()

It includes no arguments.

For an example that uses the GetPopupWidth method, see GetPopupType Method.

The GetPrompt method returns a string that includes the prompt text that Siebel Open UI displays with a control. It uses the following syntax:

GetPrompt()

It includes no arguments.

The following example includes the GetPrompt method:

// Alert the user when he lands in the control

if (document.getActiveElement === control.GetInputName(){

alert (SiebelApp.S_App.LookupStringCache(control.GetPrompt()));

}

The GetUIType method returns a string that identifies the type of control. For example, multivalue group, picklist, calculator, and so on. It uses the following syntax:

GetUIType()

It includes no arguments.

The GetWidth method returns a string that includes the width of a control, in pixels. It uses the following syntax:

GetWidth()

It includes no arguments.

The HandleDeleteNotification method deletes the reference to record data that Siebel Open UI stored in the client for a control. For an example that uses the HandleDeleteNotification method, see Creating and Managing Client-Side Controls.

The IsBoundedPick method returns one of the following values:

• true. The field is a bounded picklist.
• false. The field is not a bounded picklist.

It uses the following syntax:

IsBoundedPick()

It includes no arguments.

The IsCalc method returns one of the following values:

• true. The field is a calculated field.
• false. The field is not a calculated field.

It uses the following syntax:

IsCalc()

It includes no arguments.

The IsDynamic method returns one of the following values:

• true. The control is a dynamic control.
• false. The control is not a dynamic control.

It uses the following syntax:

IsDynamic()

It includes no arguments.

The IsEditEnabled method returns one of the following values:

• true. The control is editable.
• false. The control is not editable.

It uses the following syntax:

IsEditEnabled()

It includes no arguments.

The IsSortable method returns one of the following values:

• true. The control is sortable.
• false. The control is not sortable.

It uses the following syntax:

IsSortable()

It includes no arguments.

The NewRecord method initializes a new record that Siebel Open UI adds to the database that resides on the Siebel Server. It uses the following syntax:

BusComp.prototype.NewRecord = function (bInsertBefore, bInternal, pIdValue) {}

where:

• bInsertBefore can contain one of the following values:
  • true. Specifies to insert the record before the current record.
  • false. Specifies to insert the record after the current record.
• bInternal can contain one of the following values:
  • true. Configures the object manager to not call the CanInsert method to determine whether or not the insert is valid. Configures Siebel Open UI to not send a postevent notification. You can use true only if specialized business component code calls the NewRecord method.
  • false. Configures the object manager to call the CanInsert method to determine whether or not the insert is valid. Configures Siebel Open UI to send a postevent notification.
• pIdValue contains the value that Siebel Open UI uses as the Id for the new record. You can specify a value for pIdValue to create a new record with a row Id that you specify. If you do not specify pIdValue, or if it contains no value, then Siebel Open UI automatically creates a new value for the Id.

For examples that use the NewRecord method, see the following topics:

• Attaching an Event Handler to a Presentation Model
• Calling Methods
• Allowing Users to Return Parts
• SetMultipleFieldValues Method
• UndoRecord Method
• AttachPostProxyExecuteBinding Method

Note the following usage:

• NewRecord can initialize a new record, and it can also initialize a new record that includes an association with a parent record.
• You can configure Siebel Open UI to override the NewRecord method.
• The NewRecord method returns an object that includes an error code and a return value. For more information, see Configuring Error Messages for Disconnected Clients and SetErrorMsg Method.
• If you use NewRecord in a Siebel Mobile disconnected environment, then NewRecord adds the record to the local database instead of the database that resides on the Siebel Server.

The NotifyNewData method sends an event notification to the client when Siebel Open UI modifies the value of a field. It returns nothing. It uses the following syntax:

BusComp.prototype.NotifyNewData = function (field_name) {}

where:

• field_name identifies the name of the field that Siebel Open UI modified.

You can use the NotifyNewData method to make sure Siebel Open UI synchronizes the modified field values between different applets that reside in the same client or that reside in different clients. NotifyNewData also notifies other fields that reference this field.

You can configure Siebel Open UI to override the NotifyNewData method.

The PreGetFormattedFieldValue method gets the format that a field uses to store the value of a control. For an example that uses the PreGetFormattedFieldValue method, see Creating and Managing Client-Side Controls.

The PostLeaveField method temporarily stores a value that the user enters in a control. It stores this value in memory. You use the AddMethod to call the PostLeaveField method. Siebel Open UI then implicitly calls the PostLeaveField method from the LeaveField method that the listapplet.js file specifies. For an example that uses the PostLeaveField method, see Creating and Managing Client-Side Controls.

The SetIndex method sets the index of a control. This index identifies the control position in the applet. The SetIndex method returns nothing. It uses the following syntax:

SetIndex(value)

where:

• value specifies the number to set for the index.

The following example uses the SetIndex method:

//listOfControls that contains an object of all the controls in the applet

var listOfControls = <AppletPM>.Get("GetControls");

var accountControl = listOfControls["Account"];

var accountIndex= listOfControls["Account"].GetIndex();

var revenueControl = listOfControls["Revenue"];

var revenueIndex= listOfControls["Revenue"].GetIndex();

// Now we can swap the indeces and effectively the tabbing order too.

accountControl.SetIndex (revenueIndex);

revenueControl.SetIndex (accountIndex);

This topic describes the methods that Siebel Open UI uses with the JQGridRenderer class. It includes the following information:

• OnControlBlur Method
• OnControlMvg Method
• OnControlPick Method
• OnPagination Method
• OnRowSelect Method

Siebel Open UIuses this class to render an applet as a form.

The OnControlBlur method handles an onblur event for a control that resides in a form applet. It uses the following syntax:

OnControlBlur(arguments)

where:

• arguments can include the following:
  • rowid
  • cellname
  • value
  • iRow
  • iCol

For information about the OnCtrlBlur method that Siebel Open UI uses with the presentation model for list applets, see OnCtrlBlur Method.

The OnControlMvg method handles a multivalue group for a control that resides in a form applet. It uses the following syntax:

OnControlMvg(column_name)

where:

• column_name identifies the column that includes the multivalue group.

The OnControlPick method handles a picklist for a control that resides in a form applet. It uses the following syntax:

OnControlPick(column_name)

where:

• column_name identifies the column that includes the picklist.

The OnPagination method handles a pagination that occurs in a form applet. It uses the following syntax:

OnPagination(title)

where:

• title identifies the title of the page.

The OnRowSelect method handles a row click. It runs if the user clicks a row. It starts the PositionOnRow

that updates the proxy business component. It uses the following syntax:

OnRowSelect(rowId)

where:

• rowId identifies the row that the user clicked.