Overview

When creating an application, you can configure Actionflows to respond to different events, such as a mouse click, double click or enter key press. 

Event Types and Event Handlers

An Event Handler is an action that responds to a specific event, such as a mouse click, double click or enter key press. The Event Handler defines how the application behaves when the event is triggered, such as running a 

Multiple event handlers can be set on the same component or field. For example, you may wish for a validation Actionflow to be triggered On Enter and On Blur.

Event Types and Action Settings

Adding an Event Handler

1. From a screen, click on a component or field to open its

   Insert excerpt
   _property_tabs _property_tabs nopanel true

2. Click on the

   Insert excerpt
   _property_tabs _property_tabs name action nopanel true

    and in the Event Handler section, click the 

   Insert excerpt
   _addIcon _addIcon nopanel true

    icon to create a new event handler

3. In the New Event Handler 

   Insert excerpt
   _property_settings _property_settings nopanel true

   , select an Event Type
   

   Tip
   Only events available for this type of component will show - see Event Types table above.

   
   

4. For Action Method, select Actionflow, then click the 

   Insert excerpt
   _add_icon _add_icon nopanel true

    icon to create a new Actionflow or click the 

   Insert excerpt
   _actionflow_icon _actionflow_icon nopanel true

    icon to display a list of available Actionflows

Adding Action Settings

1. From a screen, right-click on a grid and press 

   Insert excerpt
   _view_show_config _view_show_config nopanel true

2. On the View's

   Insert excerpt
   _property_settings _property_settings nopanel true

   , click on the

   Insert excerpt
   _property_tabs _property_tabs name action nopanel true

3. In the Action Settings section, under Double Click Action, select Actionflow
4. Click the 

   Insert excerpt
   _add_icon _add_icon nopanel true

    icon to create a new Actionflow or click the 

   Insert excerpt
   _actionflow_icon _actionflow_icon nopanel true

    icon to display a list of available Actionflows

Worked Examples

Here's a worked example using the Shop Data (available from the Learning Centre).

In this example, we are using:

• A Shop Stock screen containing a grid of the Shop Stock data, a pie chart of the Shop Stock data and a grid of the Shop Departments data  - this screen was created using the Multi-Tile template
• A Shop Statistics screen containing 4 tiles with charts and graphs of the Shop Stock data - this screen was created using the Tile no Buttons template
• A Shop Customer Form screen containing form fields and associated with Shop Customers data by a background filter - this screen was created using the Edit Form template

GIF/SCREENSHOT OF FINISHED RESULT

Example 1: Configuring an On Click Event

Configure an area to open a screen on clicking.

1. On the screen where the Actionflow will be initiated from, Shop Stock, find the area, Split Area Top (use the 

   Insert excerpt
   _layers _layers nopanel true

   ) to open its properties

2. On the 

   Insert excerpt
   _property_tabs _property_tabs name action nopanel true

   , in the Event Handler section, click the 

   Insert excerpt
   _addIcon _addIcon nopanel true

    to create a new event handler:
   1. Event Type: select On Click
   2. Action Method: choose Actionflow
   3. Click 

      Insert excerpt
      _save _save nopanel true

   4. Click the 

      Insert excerpt
      _addIcon _addIcon nopanel true

       icon to create a new Actionflow
   5. On the Actionflow, select Click to Connect and choose an input of On Click
   6. Create an Open Screen Actionflow that opens the Shop Statistics screen
      1. See 1.07 Open Screen Action Configuration
   7. Close the Actionflow and 

      Insert excerpt
      _finish _finish nopanel true

       the new event handler properties
3. On the area properties, click the 

   Insert excerpt
   _property_tabs _property_tabs name style nopanel true

4. Tick Cursor and set this to Pointer (hand pointing)
   1. This indicates to your application users that this area is clickable 

5. Insert excerpt
   _finish _finish nopanel true

    the area properties

6. Insert excerpt
   _lock _lock nopanel true

    the screen and click the area to see the Actionflow in action 

Example 2: Configuring a Double-Click Event

Configure a double-click action on a grid to open a screen where the selected record can be edited.

1. On the screen where the Actionflow will be initiated from, Shop Customers, right-click on the grid and choose

   Insert excerpt
   _view_show_config _view_show_config nopanel true

2. On the View's

   Insert excerpt
   _property_settings _property_settings nopanel true

   , click on the

   Insert excerpt
   _property_tabs _property_tabs name action nopanel true

3. In the Action Settings section, under Double Click Action, select Actionflow
4. Click the 

   Insert excerpt
   _addIcon _addIcon nopanel true

    icon to create a new Actionflow
   1. On the Actionflow, select Click to Connect and choose the Shop Customers data source 
      1. This is because we want the Shop Customers Form to open with the selected customer's details on
   2. Create an Open Screen Actionflow that opens the Shop Customer Form
      1. See 1.07 Open Screen Action Configuration

      2. 
         

         Expand
         title Hint
         Remember to map across the customerID.

         
         

   3. Close the Actionflow and 

      Insert excerpt
      _finish _finish nopanel true

       the view properties

   4. Insert excerpt
      _lock _lock nopanel true

       the screen and double-click a record in the grid to see the Actionflow in action 

Example 3: Configuring an On Change Event

Configure a boolean field to show a message when it changes state (from false to true).

1. On the screen where the Actionflow will be initiated from, Shop Customer Form, find the True/False Field, mailingList (use the 

   Insert excerpt
   _layers _layers nopanel true

   ) to open its properties

2. On the 

   Insert excerpt
   _property_tabs _property_tabs name action nopanel true

   , in the Event Handler section, click the 

   Insert excerpt
   _addIcon _addIcon nopanel true

    to create a new event handler:
   1. Event Type: select On Change
   2. Action Method: choose Actionflow
   3. Click 

      Insert excerpt
      _save _save nopanel true

   4. Click the 

      Insert excerpt
      _addIcon _addIcon nopanel true

       icon to create a new Actionflow
3. On the Actionflow, select Click to Connect and choose an input of On Change

4. Using a Calculate Action, create an Output Attribute containing the following string:

   Code Block
   theme Emacs
   "Inform the customer that they will receive weekly emails with news and offers."

   See 1.11 Calculate Action Configuration

5. Create an Output Connection Point back to the Shop Customer Form screen
6. Map your new Output Attribute onto the dynamic text component, InformEmailText
7. Close the Actionflow and 

   Insert excerpt
   _finish _finish nopanel true

    the new event handler properties

8. Insert excerpt
   _finish _finish nopanel true

    the True/False Field properties
9. Close and reopen the screen, ensuring it is 

   Insert excerpt
   _lock _lock nopanel true

   ed, and click the 'Would the customer like to join the mailing list?' toggle to see the Actionflow in action