Wednesday, May 5, 2010

NamedMethod

Named Method n (Business Component)


This user property allows you to invoke a business component or business service method, or set a field value. It can be used in place of scripting.


Value

The value you provide for the Named Method user property depends on the action you want to perform.

For setting a field value, the value consists of three quoted parameters separated by a comma and a space, as follows:

"Name", "SET", "Field", "Expression"

When Name is called, the value of Field is set using Expression.

For invoking a business component method, the value consists of four quoted parameters separated by a comma and a space, as follows:

"Name", "Action", "BusComp", "Method"

When Name is called, Method is invoked on the BusComp business component based on the defined Action. For a list of actions, see Table 21.

For invoking a business service method, the value consists of five quoted parameters separated by a comma and a space, as follows:

"Name", "Action", "BusComp", "Service", "Method"

When Name is called, Method from the Service business service is invoked on the BusComp business component based on the defined Action. For a list of actions, see Table 21.

You can optionally append an additional parameter that defines an expression. If you use a business service action, the expression is passed as a property set, so you must use name-value pairs rather than an array of strings ("NameExpr", "ValueExpr").

Usage

Sometimes it is necessary to trigger actions in response to data changes, for example when records are created, deleted, or updated. The response can be required to be triggered before or after the date change has been applied.

Within the Siebel Application there is standard functionality, including user properties, to allow you to implement automated responses to data changes without the need to use custom scripts.

The Named Method n user property can be used to invoke methods in a certain order.

For an example of its use, see Named Method n (Applet).

This user property is supported for business components based on the CSSBCBase class.

You can create additional instances of this user property as needed. If you have more than one instance of this user property for a business component, each instance is executed sequentially by number (for example, Named Method 1, then Named Method 2, and so on). If there is only one such user property, then no number is required.

See also About Setting Numbered Instances of a User Property.

Parent Object Type

Business Component

Functional Area

CSSBCBase

Table 21 lists the actions available for the Named Method n user property.

Table 21. Action Values for Named Method n
Action
Method Type
Functional Implication

INVOKE

Business component

Invokes the method

INVOKESEL

Business component

Saves the state and invokes the method once for each selected record

INVOKEALL

Business component

Saves the state, requeries, and invokes the method once for each record

INVOKESAVE

Business component

Saves the state, requeries, and invokes the method

INVOKESVC

Business service

Invokes the method

INVOKESVCSEL

Business service

Saves the state and invokes the method once for each selected record

INVOKESVCALL

Business service

Saves the state, requeries, and invokes the method once for each record

INVOKESVCSAVE

Business service

Saves the state, requeries, and invokes the method

No comments: