Insert excerpt

	_Banners
	_Banners
name	actionflow
nopanel	true

Confirmation Messages

Confirmation messages can be added to Actionflows, e.g. Save, Delete, etc. by inserting an additional

Insert excerpt

	_action_phase
	_action_phase
nopanel	true

before the Actionflow processing phase, i.e. where the Save, Delete, etc. action is.

A confirmation phase is useful where the user must:

Confirm an action before continuing
Choose an option to determine which phase runs

Excerpt

name	CreateConfirmScreen

Confirmation Screens

Confirmation messages require two screens. See Creating or Opening a Screen.

an

:

An initiator screen where the required action (e.g. delete) is initiated from
a A confirmation screen that contains the confirmation message, plus buttons to confirm/proceed or cancel/go back
- the button for confirm/proceed must be set up with an Action Type of Confirmation
- the button for cancel/go back must be set up with an Action Type of Close Screen

tip

The Serene Grey palette contains a template confirmation screen with preconfigured Confirm and Cancel buttons

.

Image Modified

See Creating or Opening a Screen.

Creating Confirmation Messages

On the confirmation screen, click on the Confirm button to open its
Insert excerpt
_property_settings
_property_settings
nopanel true
, then click on the
Insert excerpt
_property_tabs
_property_tabs
name action
nopanel true
In the Action Settings, set:
1. Action Method: choose Other
2. Action Type: choose Confirmation
  1. this setup allows the Confirm button to trigger the next phase in the Actionflow
On the initiator screen, set up the Actionflow for the required action, e.g. Delete
Open the Actionflow for the required action, and above the Actionflow canvas, click the
Insert excerpt
_add_icon
_add_icon
nopanel true
icon next to the Processing
Insert excerpt
_action_phase
_action_phase
nopanel true
Choose Add Phase Before to set up the confirmation phase
On the confirmation phase, select Click to Connect and choose the Input of On Click
From the Actionflow toolbar, click
Insert excerpt
_action_screen
_action_screen
nopanel true
to open the list of available screens
1. Drag the confirmation screen onto the Actionflow to create an
  Insert excerpt
  _action_screen
  _action_screen
  nopanel true
  action node
Drag the
Insert excerpt
_input
_input
name icon
nopanel true
icon from Connections onto the Open Confirmation Screen action node to connect them
To allow the confirmation screen to trigger the next
Insert excerpt
_action_phase
_action_phase
nopanel true
phase in the Actionflow, drag a
Insert excerpt
_action_phase
_action_phase
nopanel true
action node from the toolbar onto the canvas and in the popup select the Processing
Insert excerpt
_action_phase
_action_phase
nopanel true
Hover over the
Insert excerpt
_action_screen
_action_screen
nopanel true
action node and click , then click the
Insert excerpt
_action_phase
_action_phase
nopanel true
action node to connect them.

HTML Comment

hidden	true

Insert excerpt

Configure a Confirmation Configure a Confirmation

nopanel true

Worked Example

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

Tip
If you are completing this chapter as part of the Actionflow course and using a training instance, this data has already been pre-loaded into the Actionflow Foundation Application. For this example, we'll be creating a new screen and working on buttons on the Course Management screen.

We want to add a confirmation screen that appears when users delete a course on the Course Management screen. In this example we will insert a Confirmation phase into an Actionflow to show a confirmation message before a Delete Action is processed.

Image Modified

Excerpt

Setting up a Confirmation Screen

Click on the icon in the PhixFlow header bar
Select
Insert excerpt
_add_screen
_add_screen
nopanel true
on the left
In the Create Screen window, enter the following details:
1. Name: Confirmation Screen
2. Open Maximised: toggle off
3. All users can View Data: toggle on
4. Description: A generic confirmation screen
5. Please select a Template, choose Confirmation
6. Click Create Screen.
The screen will be created and will automatically open
1. Close the Add Attributes window that opens
Click the Confirm button to open its
Insert excerpt
_property_settings
_property_settings
nopanel true
, then click on the
Insert excerpt
_property_tabs
_property_tabs
name action
nopanel true
You can see here that this button has an Action Method of Other and an Action Type of Confirmation - this is important as it is these settings that allow the Confirm button to trigger the Delete Action phase
No edits are required to this screen
Close the Confirmation Screen

Configuring a Confirmation Actionflow

On the Course Management screen, open the Delete Actionflow by right-clicking on the button and choosing
Insert excerpt
_actionflow_display
_actionflow_display
nopanel true
Above the Actionflow canvas are the phases, click the
Insert excerpt
_add
_add
nopanel true
button next to Processing Phase
Select
Insert excerpt
_addIcon
_addIcon
nopanel true
Add Phase before and set:
1. Name: Confirmation
2. Press Confirm
Select Click to Connect and choose the Input of On Click
Press Connect Input
From the Actionflow toolbar, click
Insert excerpt
_action_screen
_action_screen
nopanel true
to open the list of available screens in your application
Drag the Confirmation Screen you made earlier onto the Actionflow canvas
Drag the
Insert excerpt
_input
_input
name icon
nopanel true
icon from Connections onto the Open Confirmation Screen action node to connect them
From the toolbar, drag a
Insert excerpt
_action_phase
_action_phase
name start
nopanel true
action node onto the canvas and in the popup select the phase, Processing Phase, to run after the confirmation has been completed
Hover your mouse pointer over the
Insert excerpt
_action_screen_icon
_action_screen_icon
nopanel true
Open Confirmation Screen action node, click , then connect the
Insert excerpt
_action_screen
_action_screen
nopanel true
action node to the Processing
Insert excerpt
_action_phase
_action_phase
nopanel true
action node
Expand
title Checkpoint
Close the Actionflow to return to the Course Management screen
Insert excerpt
_lock
_lock
nopanel true
the screen, select a record and press the button
1. We can see that the Actionflow is working because when you press Confirm on the Confirmation Screen, the selected record is deleted