You can associate user-defined actions with an attribute group in the context of an item catalog category. A user-defined action describes a function that, at run-time, can be invoked by the user. Attributes of the attribute group can be mapped to function parameters, so that their values are dynamically passed during function invocation.

   To add an action to an attribute group associated with an item catalog category:

1. From the Home page, select the Setup Workbench link.

2. On the Search: Item Catalog Categories page, locate the appropriate item catalog category and click its name link.

3. On the Basic Information page, click the Attribute Groups link.

4. On the Attribute Groups page, click the Update Actions icon.

5. On the View Actions page, click Create Actions.

6. On the Create Action page, provide the following information:

   Sequence

   If there are multiple actions associated with an attribute group, the sequence number determines the order in which they are displayed to the user.

   Action Name

   The name of the action.

   Description

   The description of the action.

   Function

   Associates an existing function with the action. The function has a name, type, and specified parameters.

   Security Privilege

   The privilege required by a user in order for that user to execute this action.

   Execution Method

   The manner in which the action is executed.

   Display Style

   Defines the user interface element that executes the action.

   Prompt Application

   The application of the prompt for the action if the prompt is defined in the database.

   Prompt Message Name

   The message name of the prompt if the prompt is defined in the database. Otherwise, the actual prompt.

   Dynamic Prompt Function

   Selects an existing function whose return value will define the prompt of the action. Must have parameter of type Return, with data type String.

   Dynamic Visibility Function

   Selects an existing function whose value will determine whether or not the action is rendered.

7. Click Apply.

   To create parameter mappings for an action:

After creating an action, specify the values to pass to its associated functions when that action is executed. You can have up to three associated functions: the main function, the dynamic prompt function and the dynamic visibility function.

1. On the View Actions page, click the name of the action you just created.

2. On the Action Details page, within the appropriate function heading, click Edit.

3. On the Create Mappings page, for each function parameter select the following:

   Mapping Group Type

   The type of attribute that will be mapped to this parameter.

   Mapped Attribute

   The actual attribute that is mapped. Only attributes with the data type that matches the parameter data type are available.

4. Click Apply.