Bookshelf v7.5.2: Invoke Method Targeting

Siebel Tools Reference > Logical User Interface Objects Layer > Toolbars and Menus >

Invoke Method Targeting

The Method, Business Service, and Target properties appear in the Command object type for use in toolbars, application-level menus, and applet menus. The target property specifies the object or service that will process the method invoked by the command. Under some circumstances, if a method cannot be handled by the specified target it is automatically directed to an underlying object or service for handling. This could be a mirror instance of the object that exists on the server rather than the browser, or it could be an inherited class. In these cases we say that the method invocation has been retargeted.

Two settings are available for the Target property, with the following behavior:

Browser target. The method handler for this target is the JavaScript application, a JavaScript applet, or a JavaScript service, on the browser side. In all cases, a method name must be specified in the Method property. A service is targeted if a service name is specified in the Service property. If a service is not specified, method handling differs based on whether the calling entity is application-level or applet-level, as follows:

Application-level. Targets to the specified method in the JavaScript application. Does not retarget.

Applet-level. Targets to the specified method in the JavaScript applet. If not handled, retargets to the specified method in the corresponding JavaScript business component. No inheritance or additional retargeting.

Server target. This target is for invoking a method in a C++ class on the server, either on a service or on the infrastructure. If a Service property value is not specified, the invoke method is targeted to the infrastructure. It will target the infrastructure differently depending on whether the menu or toolbar icon invoking the method is applet-level (menu only) or application-level (menu or toolbar).

Application-level. The method handler is initially the SWE UDF loader on the server side, and secondarily the model.

Applet-level. The method handler is initially the applet class to which the applet belongs, and is retargeted successively up through the applet class hierarchy to CSSSWEFrame. If still unhandled, handling is retargeted to the business component class of the applet's business component, and successively upwards through the business component class hierarchy to CSSBusComp.

If a service is specified in the Service property, the method handler is the specified service. This targeting is also dependent on whether the calling menu item or toolbar icon is applet-level or application-level, as follows:

Application-level. The method handler is the specified OM service. It does not retarget.

Applet-level. The method handler performs a SetBC call to set to the business component of the applet, and then calls the specified OM service. It does not retarget.

The results of the possible settings of the Target and Business Service properties at the applet and application levels are summarized in Table 44.

Table 44. Target and Business Service Properties Matrix
Menu/Toolbar Level	Target	Service	Result
Application level	Server	Specified	The method handler is the specified business service on the server. It does not retarget.
	Server	Unspecified	The method handler is the base functionality associated with an application object.
	Browser	Specified	Targets to the method in the specified browser-side service. It does not retarget.
	Browser	Unspecified	Targets to the specified method in the JavaScript application. It does not retarget.
Applet level	Server	Specified	The method handler calls the specified service on the server. It does not retarget.
	Server	Unspecified	The method handler is initially the applet class to which the applet belongs, and is retargeted successively up through the applet class hierarchy to CSSSWEFrame. If still unhandled, handling is retargeted to the business component class of the applet's business component, and successively upwards through the business component class hierarchy to CSSBusComp.
	Browser	Specified	Targets to the method in the specified browser-side service. It does not retarget.
	Browser	Unspecified	Targets to the specified method in the JavaScript applet. If not handled, retargets to the specified method in the corresponding JavaScript business component. There is no inheritance or additional retargeting.