Siebel Developer's Reference > User Properties > Business Component User Properties >

On Field Update Invoke n


This user property allows you to invoke the specified business component method when a field is updated.

Value

The value of the On Field Update Invoke user property consists of three quoted parameters (double quotation marks) separated by a comma and a space, as follows:

"[FieldToCheck]", "[BusCompName]", "[MethodName]"

[MethodName] is invoked on the [BusCompName] business component when [FieldToCheck] is updated. If [FieldToCheck] is not defined, the method is invoked when the user saves the record.

You can optionally use a fourth parameter that defines a condition. If you define a condition, the method is only invoked if the condition evaluates to TRUE.

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, they are 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.

See also About Setting Numbered Instances of a User Property.

For example, the Asset Mgmt - Asset (Order Mgmt) business component has four such user properties:

  • On Field Update Invoke   "Product Name", "Asset Mgmt - Asset", "CopyXA"
  • On Field Update Invoke 1   "Product Name", "Asset Mgmt - Asset", "GeneratePartNumber"
  • On Field Update Invoke 2   "Product Name", "Asset Mgmt - Asset", "SaveCxProd"
  • On Field Update Invoke 3   "Quantity", "Asset Mgmt - Asset", "SetExtendedQuantity"

When the Product Name field in the Asset Mgmt - Asset (Order Mgmt) business component is updated, the CopyXA, GeneratePartNumber, and SaveCxProd methods are invoked on the Asset Mgmt - Asset business component.

When the Quantity field in the Asset Mgmt - Asset (Order Mgmt) business component is updated, the SetExtendedQuantity method is invoked on the Asset Mgmt - Asset business component.

In this example, where no [FieldToCheck] is specified, the CopyXA method is invoked on the Asset Mgmt - Asset business component when the user saves the record:

On Field Update Invoke "", "Asset Mgmt - Asset", "CopyXA"

NOTE:  The empty quotes followed by the comma are necessary.

Parent Object Type

Business Component

Functional Area

CSSBCBase

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