Configuring Siebel Open UI > Customizing Siebel Open UI for Siebel Mobile Disconnected > Methods You Can Use to Customize Siebel Mobile Disconnected >

Methods You Can Use in the Application Class

This topic describes methods that you can use that reside in the Application class. It includes the following information:

• ActiveBusObject Method
• ActiveViewName Method
• CurrencyCode Method
• FindApplet Method
• GetBusObject Method
• GetLastErrCode Method for Applications
• GetLastErrText Method for Applications
• GetService Method
• LoginId Method
• LoginName Method
• Name Method for Applications
• NewPropertySet Method
• PositionId Method
• PositionName Method

The ActiveBusObject method returns the business object that the active view references. It uses the following syntax:

Application. ActiveBusObject()

It includes no arguments.

For example:

SiebelApp.S_App.ActiveBusObject();

The ActiveViewName method returns the name of the active view. It uses the following syntax:

Application. ActiveViewName()

It includes no arguments.

For example:

SiebelApp.S_App. ActiveViewName();

The CurrencyCode method returns the currency code that Siebel CRM associates with the division of the user position. For example, USD for U.S. dollars, EUR for the euro, or JPY for the Japanese yen. It uses the following syntax:

Application. CurrencyCode()

It includes no arguments.

For example:

SiebelApp.S_App. CurrencyCode();

The FindApplet method returns the active applet. It uses the following syntax:

Application. FindApplet(appletName)

where:

• appletName is a string that contains the name of the active applet.

For example, if the Contact List Applet is the current applet, then the appletName variable in the following code returns the name of this applet as a string:

SiebelApp.S_App.FindApplet(appletName);

The GetBusObject method creates a new instance of a business object. It returns this new business object instance. It is not synchronous. It uses the following syntax:

Application. GetBusObject(business_object_name)

where:

• business_object_name is a string that identifies the name of a business object

For example, the following code creates a new instance of the Opportunity business object:

SiebelApp.S_App. GetBusObject(Opportunity);

The GetLastErrCode method returns the error code for the most recent error that the disconnected client logged. It uses the following syntax:

Application.GetLastErrCode()

For example:

TheApplication().GetLastErrCode();

This method includes no arguments.

The error code that this method returns is a short integer. An error code of 0 (zero) indicates no error occurred.

The GetLastErrText method returns a string that contains the text message for the most recent error that the disconnected client logged. It uses the following syntax:

Application.GetLastErrText()

For example:

TheApplication().GetLastErrText();

This method includes no arguments.

The GetService method creates an instance of a business service object. It allows you to use the Invoke method to call this business service object. It uses the following syntax:

SiebelApp.S_App.GetService("business_service_name");

where:

• business_service_name is a string that identifies the name of the business service that GetService uses to create the business service object. You must use the same name that you use when you register this business service. For more information about registering a business service, and for an example that uses the GetService method, see Using Custom Siebel Business Services.

The following example creates a business service instance of the LS Pharma Validation Service business service:

var service = SiebelApp.S_App.GetService("LS Pharma Validation Service");

The LoginId method returns the login ID of the user who started the Siebel application. It uses the following syntax:

Application. LoginId()

It includes no arguments.

For example:

SiebelApp.S_App. LoginId();

The LoginName method returns the login name of the user who started the Siebel application. This login name is the name that the user enters in the login dialog box. It uses the following syntax:

Application. LoginName()

It includes no arguments.

For example:

SiebelApp.S_App. LoginName();

The Name method returns the name of the Siebel application. It uses the following syntax:

Application. Name()

It includes no arguments.

For example:

SiebelApp.S_App. Name();

The NewPropertySet method creates a new property set, and then returns this property set to the code that called this method. It uses the following syntax:

Application. NewPropertySet()

It includes no arguments.

For example:

SiebelApp.S_App. NewPropertySet();

The PositionId method returns the position ID of the user position. This position ID is the ROW_ID from the S_POSTN table. Siebel CRM sets this value when the Siebel application starts, by default. It uses the following syntax:

Application. PositionId()

It includes no arguments.

For example:

SiebelApp.S_App. PositionId();

The PositionName method returns the name of the current user position. Siebel CRM sets this value when it starts the Siebel application, by default. It uses the following syntax:

Application. PositionName()

It includes no arguments.

For example:

SiebelApp.S_App. PositionName();