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.Event handlers can be configured to respond to events by , such as running a 

The types of event handler are:

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 the a screen, click on a component or field to open its properties.In

   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 click the 

   Insert excerpt
   _AddaddIcon _AddaddIcon nopanel true

    to create a new event handler.PhixFlow opens  icon to create a new properties tab for the event handler.
3. Select

   In the

   Event Type, Action Method and specific table-action or actionflow you require; see the properties below.

1. New Event Handler 

   Insert excerpt
   _property_settings _property_settings nopanel true

Basic Settings

1. , select an Event Type
   

Select the type of event that will trigger an action:

• OnClick
• OnEnter
• OnBlur
• OnChange.

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

   
   

2. Select an Action Method

Available when Event Type is selected.

1. :
2. Table-Action
3. No action
1. 1. Actionflow
4. Other
Action

Available when Action Method is Table-Action.

5. Either, select a table-action from the drop-down list
Or, to find table-actions belonging to a specific table:Click 
1. 1. : Click the 

      Insert excerpt
      _

table

1. 1. add_

list

1. 1. icon _

table

1. 1. add_

list

1. 1. icon nopanel true

 to show tables in the repository
6. Expand the table.
7. Drag a table-action from the list into this box.
Actionflow

Available when Action Method is Actionflow.

To select an actionflow, do one of the following:

8. Select an actionflow from the drop-down list.
Click 
1. 1.  icon to create a new Actionflow or click the 

      Insert excerpt
      _actionflow_icon _actionflow_icon nopanel true

 to show actionflows in the repositoryClick 
1. 1.  icon to display a list of available Actionflows
   2. Table Action: Choose a table action from the dropdown or select the

      Insert excerpt
      _

add

1. 1. tables _

add

1. 1. tables nopanel true

 to create a new actionflow; see Creating Actionflows. Other

Available when Action Method is Other.

Select
1. 1.  icon to find table-actions belonging to a specific table:
      1. Click the chevron to expand the table in the Repository
      2. Drag a table-action from the list into the Table Action box. ZB remove completely? 
   2. Other: Choose an option from the drop down:
      • None
      • Clear All Fields: clears content from all form fields on the parent form
      • Close Screen: closes the parent screen
      • Maximise/Minimise Screen: toggles the screen
 between
1. 1. •  between minimised and its default size
      • Screenshot: copies an image of the selected component to the clipboard
.
1. 1. • • The required component must be dragged and dropped into the Screenshot Component box from the 

          Insert excerpt
          _layers _layers nopanel true

           or 

          Insert excerpt
          _repository _repository nopanel true

Adding Action Settings

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

   Insert excerpt
   _view_show_config _view_show_config nopanel true

Worked Examples

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

In this example, we are using:

• A Course Management screen containing a grid of the School Courses data - this screen was created using the Tile with Buttons template
• A Course Form screen containing form fields and associated with School Courses data by a background filter - this screen was created using the Edit Form template

Tip
If you are completing this chapter as part of the Actionflow course and using a training instance, the data and screens have already been pre-loaded into the Actionflow Intermediate Application. For this example, we'll be working on configuring buttons on the Course Management screen to open the Course Form screen.

We want to be able to add and edit courses on a Course Management screen. The first step to doing this is by creating two Open Screen Actionflows. Both will open the same screen containing form fields, but when we are adding a new course we want empty form fields, and when we are editing an existing course, we want the form fields to contain course data.

GIF/SCREENSHOT OF FINISHED RESULT

Example 1: Configuring an On Click Event

Create an Open Screen Action that opens an empty input form.

1. On thescreen where the Act

Example 2: Configuring an On Blur Event

Create an Open Screen Action that opens an empty input form.

1. On thescreen where the Act

Example 3: Configuring an Double Click Event

Create an Open Screen Action that opens an empty input form.

1. On thescreen where the Act

1.02 Actionflow Principles