Show TOC

Background documentationEvents

 

You can model the user interaction on the dashboard using Event Handling mechanism. Every object on the dashboard supports predefined events. For each event, one or more event handlers can be defined to perform actions based on events such as change of input value, selection of radio button, row selection of a table and so on. You can create additional javascript expressions to call event handlers.

An event configuration can enabled or disabled in Design time. You can edit the code for customized event handlers in Source code.

You can either use standard or create customized event handlers. For standard event handler, you can specify the parameters to be updated before the standard handler is triggered. You can create or edit the source code for customized event handlers in Source Code. An event configuration can be enabled or disabled at design.

Example Example

  • You configure an event handler to refresh an i5Grid when you select a radio button (or plant numbers). The result is the chart is refreshed based on the selected plant number.

  • Update a Pie Chart when you select a row in i5Grid.

  • Refresh a i5Grid table when you click a button on the dashboard.

End of the example.

Activities

  1. From the Self Service Composition Environment screen, choose Preferences.

  2. To create event configurations, choose Events.

  3. Choose Add.

    1. To select an event, do the following:

      1. Choose from Event field.

        The Select Event screen displays all the objects within the cells.

      2. Choose a cell from Select a Cell pane

        The Select Event table displays all the events of the selected object.

      3. Select an event and choose OK.

    2. Enter name in Configuration Name field.

    3. Choose the type Standard.

      You must enter a event handler when you choose type, Custom.

    4. To choose an event handler, do the following:

      1. Choose from the Event Handler field.

        The Select Event Handler screen displays all the objects available on the dashboard.

      2. Select a cell from Select Event Handler pane.

        The Select Event Handler table displays all the handlers for the selected object.

      3. Select an event handler and choose OK.

    5. You can update the target parameter with the source parameter values. You must choose target and source parameters from the Handler Parameters column. To do so:

      1. Choose + to insert a row.

      2. From the Target column, choose .

        The Select Parameters screen displays all the available parameters.

      3. Expand the parameter tree, select any parameter, and choose OK.

      4. From the Source column, choose .

        The Select Parameter Source screen displays the all cells of the dashboard.

      5. Select an cell from the dashboard.

        The Select Parameter Source displays all the properties for the selected object.

      6. Select any property and choose OK.

  4. Choose Active to activate the event.

To trigger an event handler based on a condition, chose With Condition and provide the conditions in the editor.