Product Administration Guide > Customizable Product Scripts >

Cfg_ItemChanged Event


After a user request is processed and the eConfigurator engine computes a new solution, this event is called for each component customizable product whose quantity has changed. The script associated with this event must be associated with the component customizable product.

For example, CP1 is a customizable product. One of its component products is customizable product CP2. A script inserted in the Cfg_ItemChanged event in CP2 runs when the quantity of CP2 changes while CP1 is being configured.

To set up a Cfg_ItemChanged script for the component customizable product CP2 you must do the following:

This event provides a simple way to write scripts for a customizable product that run only when that product is a component of another customizable product. This event is called after the Cfg_ChildItemChanged event.

Upgrade users: Use the Cfg_ChildItemChanged event to obtain functionality similar to the Cfg_ItemChanged event in release 6.x.

In the selection pages for a customizable product, this event is called when the user selects the component customizable product. It is also called when the user increases or decreases the quantity of that product.

Syntax

Cfg_ItemChanged (ProdName, OldQty, NewQty)

Argument
Description
ProdName
String. The name of the component customizable product. Use product name syntax
OldQty
Integer. The component customizable quantity prior to the request.
NewQty
Integer. The new baseline quantity for the component customizable product.

Items

Use this event only to write scripts in customizable products that will be components of other customizable products.

Returns

Returns the component customizable product name, the quantity of it in the solution prior to the user request, and the quantity after the user request. This event does not return changes in the quantity of the products comprising a component customizable product.


 Product Administration Guide, Version 7.5 
 Published: 18 April 2003