Bookshelf v7.5: Named Method n

This user property allows you to invoke a method from a business component or business service, or set a field value.


Parent Object Type	Business Component
Syntax	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 12. 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 12. 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	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, On Field Update Invoke 1, then On Field Update Invoke 2, and so on). If there is only one such user property, then no number is required.
Functional Area	CSSBCBase

Table 12. Action Values for Named Method
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