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 Business Service Class

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

• Invoke Method for Business Services
• ServiceRegistry Method

Invoke Method for Business Services

The Invoke method that you can use with a business service calls the CanInvokeMethod business service and the InvokeMethod business service. It returns a property set. It uses following syntax:

service.Invoke(method_name, psPropertySet);

where:

• method_name is a string that identifies the business service method that the Invoke method calls. The Invoke method also calls the following methods:
  • CanInvokeMethod. Determines whether or not Siebel Open UI can call the business service method that method_name identifies. Any custom business service file you create must include the CanInvokeMethod business service method.
  • InvokeMethod. Calls the business service method that method_name identifies. Any custom business service file you create must include the InvokeMethod business service method.

    For more information about using these methods, see Using Siebel Business Services or JavaScript Services to Customize Siebel CRM Objects.

• psPropertySet is a property set that the Invoke method sends to the method that method_name identifies.

The following example calls the CanAddSample method of the LS Pharma Validation Service business service:

var service = SiebelApp.S_App.GetService("LS Pharma Validation Service");
var outputSet = service.Invoke("CanAddSample", psPropertySet);

For an example that uses the Invoke method with a business service, see Using Custom Siebel Business Services.

ServiceRegistry Method

The ServiceRegistry method registers a custom business service method that you define. You must use it any time that you configure Siebel Open UI to call a custom business service method. It returns one of the following values:

• true. Siebel Open UI successfully registered the method.
• false. Siebel Open UI did not successfully register the method.

It uses following syntax:

SiebelApp.S_App.GetModel().ServiceRegistry(inputObj);

where:

• inputObj is an object that specifies a set of properties, where each property specifies a name and a value. The number of properties varies according to object type. For a list of properties that you can use, see Properties You Must Include to Register Custom Business Services. The inputObj argument uses the following syntax:

  inputObj [oconsts.get("name")] = "value";

  where:

  • name specifies the property name
  • value specifies the property value

    For example, the following code specifies the DOUIREG_OBJ_NAME property with a value of Pharma Call Entry Mobile:

  inputObj [oconsts.get("DOUIREG_OBJ_NAME")] = "Pharma Call Entry Mobile";

  The following code specifies the property name:

  oconsts.get("DOUIREG_OBJ_NAME")

Siebel Open UI registers a method for a custom service when it loads the script files that it uses for this custom service. This configuration makes sure that Siebel Open UI calls the ServiceRegistry method from the correct location in the code. To view this code in the context of a complete example, see Using Custom JavaScript Methods.

Properties You Must Include to Register Custom Business Services

Table 15 describes the properties that you must include in the inputObj argument of the ServiceRegistry method when Siebel Open UI registers a custom business service. The local constants.js file defines each of these properties as a constant.

Table 16 describes the properties you must include in the inputObj argument of the ServiceRegistery method when Siebel Open UI registers a custom business service that references a predefined applet or a predefined business component.