Siebel Developer's Reference > User Properties > Applet User Properties >

Named Method n (Applet)


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 four quoted parameters (double quotation marks) 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 (double quotation marks) 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 18.

For invoking a business service method, the value consists of five quoted parameters (double quotation marks) 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 18.

NOTE:  For user property parameter values that include hyphens or parentheses, you must enclose that value within an additional set of single quotation marks or an additional two sets of double quotation marks. For example, if you want to pass the O2 Repair - Create Notification workflow process as a value for a parameter, the correct syntax is either "'O2 Repair - Create Notification'" or """O2 Repair - Create Notification""".

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 applet user property can be used to invoke methods in a certain order.

For example, the Named Method n applet user property can be used to update a legacy system with new Account records after a new record is created in the Siebel application. It first commits the record in the Siebel application, and then invokes a workflow process to update the legacy system.

  • Named Method 2: WriteRecord
  • 'INVOKE', 'WriteRecord', 'INVOKESVC', 'Workflow Process Manager', 'Run Process', '"ProcessName"', '"Account - New Order"', '"RowId"','[Id]'

 

This user property is supported for applets based on the CSSFrameBase and CSSFrameListBase classes.

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 and Named Method n (Business Component).

Parent Object Type

Applet

Functional Area

CSSFrameBase, CSSFrameListBase

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

Table 18. 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

Siebel Developer's Reference Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.