Configuring Siebel Business Applications > Configuring Menus, Toolbars, and Icons > About Menus and Toolbars >

About the Method, Business Service, and Target Properties of the Command Object


You can use the Method, Business Service, and Target properties of the Command object for application menus, applet menus, and toolbars. The target property specifies the object or service that processes the method that the command calls.

How Siebel CRM Automatically Redirects a Method

In some situations, if the defined target cannot handle a method, then Siebel CRM automatically redirects the method to an underlying object or service. This object or service can be one of the following:

  • A mirror instance of the object. This instance exists on the Siebel Server.
  • An inherited class.

In these situations, Siebel CRM redirects the method.

Options for the Business Service Property

If a business service is defined in the Business Service property, then the business service handles the method. This targeting depends on the following:

  • Call received from application menu or application toolbar. The method handler is the defined object manager service. It does not retarget.
  • Call received from applet menu. The method handler performs a SetBC call to set to the business component of the applet, and then calls the defined object manager service. It does not retarget.

Options for the Target Property

This topic describes the options that are available for the Target property. The Target property for the Command object displays six values in the list. If you use the Command Wizard to create a new Command object, then Browser and Server are the only values available of the six values.

Target Property Set to Browser

If the Target Property is set to Browser, then the following situation applies:

  • Siebel CRM will not execute the server PreInvokeMethod.
  • The method handler for this target exists on the browser as the JavaScript application, a JavaScript applet, or a JavaScript service.
  • You must define a method name in the Method property.
  • If a business service is defined in the Business Service property, then Siebel CRM targets a business service.
  • If a business service is not defined in the Business Service property, then Siebel CRM handles the method differently. This targeting depends on the following:
    • Call received from application menu or application toolbar. Targets to the method defined in the JavaScript application. Does not retarget. For example, if you use the ActiveBusObject and RaiseErrorText application methods in a server script, then these methods must include a Browser target.
    • Call received from applet menu. Targets to the method defined in the JavaScript applet. If not handled, then retargets to the method defined in the corresponding JavaScript business component. No inheritance and no more retargeting occurs.
Target Property Set to Server

If the Target Property is set to Server, then Siebel CRM does not execute the browser PreInvokeMethod, and the Siebel application calls a method in a C++ class on the Siebel Server on a service or on the infrastructure. If the Service property is not defined, then Siebel CRM targets the method to the infrastructure. This targeting depends on the following:

  • Call received from application menu or toolbar. Siebel CRM handles the method in the following order of priority:
    • Uses the Siebel Web Engine UDF loader on the Siebel Server
    • Uses the model
  • Call received from applet menu. Siebel CRM handles the method in the following order of priority:
    • Uses the applet class to which the applet belongs
    • Retargets, if necessary, successively up through the applet class hierarchy to CSSSWEFrame
    • If still not handled, retargets to the business component class of the business component that the applet references, and successively up through the business component class hierarchy to CSSBusComp

Summary of the Target and Business Service Properties

Table 61 summarizes the Target and Business Service properties.

Table 61. Summary of Target and Business Service Properties
Menu or Toolbar
Target Property
Business Service Property
Result

Application menu or toolbar

Server

Contains a value

The business service that is defined in the Business Service property determines the method handler that calls the service on the Siebel Server. It does not retarget.

Does not contain a value

The method handler is the base functionality associated with an application object.

Browser

Contains a value

The business service that is defined in the Business Service property determines the targets of the method. It does not retarget.

Does not contain a value

Targets to the method defined in the JavaScript application. It does not retarget.

Applet menu

Server

Contains a value

The business service that is defined in the Business Service property identifies the business service that the method handler calls on the Siebel Server. It does not retarget.

Does not contain a value

The method handler is initially the applet class to which the applet belongs. Siebel CRM retargets it successively up through the applet class hierarchy to CSSSWEFrame. If still not handled, then Siebel CRM retargets to the business component class of the business component that the applet references, and successively upwards through the business component class hierarchy to CSSBusComp.

Browser

Contains a value

The business service that is defined in the Business Service Property determines the service that the method handler calls on the browser. It does not retarget.

Does not contain a value

Targets to the method that is defined in the JavaScript applet. If not handled, then retargets to the method defined in the corresponding JavaScript business component. There is no inheritance or more retargeting.

Configuring Siebel Business Applications Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.