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 a command for application menus, applet menus, or toolbars. The target property specifies the object or service that processes the method that the command calls.

How Siebel CRM Redirects a Method

In some situations, if the target cannot handle a method, then Siebel CRM 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 the Business Service property identifies a business service, then this business service handles the method depending on the following situations:

  • Siebel CRM receives the call from an application menu or application toolbar. Siebel CRM uses the object manager service to handle the method. It does not retarget the call.
  • Siebel CRM receives the call from an applet menu. The method handler does a SetBC call to set to the business component that the applet reference, and then calls the object manager service. It does not retarget the call.

Options for the Target Property

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

Target Property Set to Browser

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

  • Siebel CRM does not run 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 the Business Service property specifies a business service, then Siebel CRM targets this business service.
  • If the Business Service property does not specify a business service, then Siebel CRM does one on the following:
    • Siebel CRM receives the call from an application menu or application toolbar. Siebel CRM targets to the method that the JavaScript application defines. For example, if you configure Siebel CRM to use the ActiveBusObject and RaiseErrorText application methods in a server script, then these methods must include a Browser target.
    • Siebel CRM receives the call from an applet menu. Siebel CRM targets to the method that the JavaScript applet defines. If Siebel CRM cannot use this configuration to handle the call, then it retargets the call to the method that it defines in the corresponding JavaScript business component. It does no inheritance or retargeting.
Target Property Set to Server

If you set the Target Property to Server, then Siebel CRM does not run the browser PreInvokeMethod, and Siebel CRM calls a method in a C++ class that resides 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:

  • Siebel CRM receives the call from an 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
  • Siebel CRM receives the call from applet menu. Siebel CRM handles the method in the following order of priority:
    • Uses the applet class that the applet references
    • 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 64 summarizes the Target and Business Service properties.

Table 64. 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 the Business Service property defines determines the method handler that calls the service on the Siebel Server. It does not retarget.

Does not contain a value

Siebel CRM uses the method handler as the base functionality that it associates with an application object.

Browser

Contains a value

The business service that the Business Service property defines determines the targets that Siebel CRM uses for the method. It does not retarget.

Does not contain a value

Siebel CRM targets to the method that the JavaScript application defines. It does not retarget.

Applet menu

Server

Contains a value

The business service that the Business Service Property defines determines the 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 that the applet references. Siebel CRM retargets it successively up through the applet class hierarchy to the CSSSWEFrame class. If still not handled, then it retargets to the business component class of the business component that the applet references, and successively upwards through the business component class hierarchy to the CSSBusComp class.

Browser

Contains a value

The business service that the Business Service Property defines 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 the JavaScript applet defines. If not handled, then retargets to the method that the corresponding JavaScript business component defines. No inheritance or more retargeting occurs.

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