49. Actions/Events: Create & Execute

Actions/Events

[PRO] From the WOW Builder, run Development Tools > Actions. This menu item lets the user define a

“table driven” action or event. Table driven actions and events are normally defined completely as an entry

within the WOW event/action table, without the need for coding or special property group configuration.

Action

An action is a visible option that can be defined for a Row or RowCollection (Table). An action, when clicked

on, can run either a pre-defined operation or a java class. An action can be visible as a button, icon, link, etc.

Creating an Action

To create an action:

• 1. Bring up the Actions and Events (Other > Actions/Events)

  2. Click on Add Action/Event

Entry Information:

• • Entry Type - Leave as Action.

  • Entry Subtype - defines what type of action it is. A Row action is an action that is associated

    • with a Row. For example, it can be an action to the left of each row (Table view), it can be a

    • button from the row detail screen, it can be a right click option when you hover over a row

    • (Table view), etc. A Rowcollection action is associated with a results display (Table view) and can

    • be visible as a button on the top or bottom of the results, in the tool bar (same location as refresh,

    • print, etc.), etc.

  • Action Name - Unique name assigned to action.

  • Active - Provides ability to turn off action without removing it.

  • Description - A detailed description of the action.

Operation Inheritance:

Action/Event Execution Information:

This defines what gets run by the action. You need to specify either an operation or a Java class.

• • Operation - Select an operation to be called. If the operation is an association operation, then the

    • current Row is passed as the associated Row (for parameter substitution).

  • Java Class - Specifies a Java class file that is a subclass of planetj.wow.action.AbstractAction and

    • implements the handleAction method:

Java Classes Provided by WOW:

• • planetj.wow.repository.SaveSnapshotOfObjectAction - Action that saves a snap shot (copy of current Row or RowCollection) into the WOW Object Repository table.

    • NOTE: Class files written as a subclass of AbstractAction are compatible for both Actions and events.

TODO: P3 Review for clarity, add xrefs and examples. PHOLM