Action modes

The action mode describes the event that triggers the action (for example, right-click or drag).

Hyperlink
This table describes the hyperlink action mode:
Usage Behavior
Can be defined on Cell
Triggered by Left-click
Required input None
Supported action types All
Special behavior None. Executes action
Hyperlink and shortcut menu on right-click
This table describes the hyperlink and shortcut menu on right-click action mode:
Usage Behavior
Can be defined on Cell.
Triggered by Left-click and right-click.
Required input Command text to appear in shortcut menu. For example, report name or a multilingual string.
Supported action types All.
Special behavior Left click executes the action. Right-click displays shortcut menu from which the user selects an action to execute. Can be used to display a menu of reports from which a user can select.
Shortcut menu on left-click
This table describes the hyperlink and shortcut menu on left-click action mode:
Usage Behavior
Can be defined on Cell.
Triggered by Left-click
Required input Command text to appear in shortcut menu. For example, a report name or multilingual string.
Supported action types All.
Special behavior Displays shortcut menu from which the user selects an action to execute. Can be used to display a menu of reports from which a user can select.
Shortcut menu on right-click
This table describes the shortcut menu on right-click action mode:
Usage Behavior
Can be defined on Cell.
Triggered by Right-click.
Required input Command text to appear in shortcut menu. For example, a report name or multilingual string.
Supported action types All.
Special behavior Displays shortcut menu from which the user selects an action to execute. Can be used to display a menu of reports from which a user can select.
Edited cell
This table describes the edited cell action mode:
Usage Behavior
Can be defined on Cell.
Triggered by User entering a value in an unprotected cell.
Required input None.
Supported action types Set parameters.
Special behavior The value entered into the cell is only used for the action - it does not execute any formulas. Edited Cell is NOT the same as Write back. For example, if there is a RWC formula in the cell, the writeback is not executed by the Edited Cell action.

There is a method of achieving writeback in conjunction with the Edited Cell action.

Button click
This table describes the button click action mode:
Usage Behavior
Can be defined on Button.
Triggered by Button click.
Required input None.
Supported action types All.
Special behavior None. Action executes when button is clicked.
Selection changed
This table describes the selection changed action mode:
Usage Behavior
Can be defined on List view (for example, a combo box).
Triggered by Selecting a new element from the list view.
Required input None.
Supported action types All.
Special behavior When used with a Set Parameter action the Execution input becomes available.

The input can have one of two values: Manual Selection Changes or All Selection Changes. If Manual Selection Changes is selected, the action is executed only when a user selects a value from the list view. If the report is used in a dashboard, the action can be executed by a change of a parameter in another report on the dashboard.

When report is loading
This table describes the when report is loading action mode:
Usage Behavior
Can be defined on Report.
Triggered by Opening the report.
Required input None.
Supported action types Set parameters.

Application Engine process.

Special behavior The action is executed after the report has loaded and before applying jump parameters.

Its execution can be forced by using a jump action in which the target of the jump is the report in which the jump is defined.

Parameter [x] changes
This table describes the parameter changes action mode:
Usage Behavior
Can be defined on Report.

The report must reference one or more report parameters.

Triggered by A change to a report parameter in a dashboard.
Required input None.
Supported action types Set parameters.

Jump.

Jump to Dashboard.

Application Engine Process.

Special behavior Parameter changes in Dashboards are processed in this way:
  1. On receipt of a new parameter value from a dashboard, automatic report calculation is suppressed and variable values are updated in a bundle.
  2. The parameter change action is evaluated for each parameter, in the order in which the parameters were defined.

For Jump or Jump to Dashboard actions, further action processing is suppressed to prevent execution of two jump actions simultaneously.

Drag
This table describes the drag action mode:
Usage Behavior
Can be defined on Cell.
Triggered by Dragging a cell with the drag action defined and dropping it on a cell which has a Drop action defined.
Required input None.
Supported action types Set parameters.
Special behavior The action is not triggered unless the dragged cell is dropped onto a cell on which a Drop action has been defined.
Drop
This table describes the drop action mode:
Usage Behavior
Can be defined on Cell.
Triggered by A cell on which a drag action has been defined being dropped on a cell on which a drop action is defined.
Required input None.
Supported action types Set parameters.
Special behavior The action is not triggered unless a cell on which the drag action has been defined has been dropped onto the cell.
Chart click
This table describes the chart click action mode:
Usage Behavior
Can be defined on Cell containing data on which chart is based.
Triggered by A click on a data series for which an action has been defined.
Required input None.
Supported action types All.
Supported chart types Columns.

Bars.

2D pie charts.

Area.

Doughnut.

Portfolio.

Pyramid.

Multi-color bars.

Special behavior For Portfolio, and Area charts.
Dialog OK
This table describes the dialog OK action mode:
Usage Behavior
Can be defined on Cell, button, list object in a report in which an Open dialog action is defined (a source report).The Dialog OK mode must be specified in the source report on the same object as that on which the Open dialog action is defined.
Triggered by A click on an object in a report on which a Close dialog action is defined.
Required input None.
Supported action types All.
Special behavior Only triggered if OK is specified as the value of the Dialog Result input in the target report.
Dialog cancel
This table describes the dialog cancel action mode:
Usage Behavior
Can be defined on Cell, button, list object.
Triggered by A click on an object in a report on which a Open dialog action is defined.
Required input None.
Supported action types All.
Special behavior Triggered only if Cancel is specified as the value of the Dialog Result input in the target report.
Web Extension
This table describes the web extension action mode:
Usage Behavior
Can be defined on Cell.
Triggered by Interaction with a web extension in a report viewed on the Web.
Required input None.
Supported action types All.
Special behavior Web extensions are viewable only in the Web.

Modes of global actions

The On log-in mode supports only the Set Parameters action type. For this reason, the Define Action dialog box for On log-in actions does not display the Type column. Instead, there is a Name column in which you specify the name of the action. Only these optional parameters can be used:

  • Global variable
  • Global list
  • No target

The Formula function mode supports only the Set Parameters action type.