By the end of this chapter you will understand how confirmation messages can be added to Actionflows, and you will have added a confirmation message to your application.
Confirmation Messages
Image Modified
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
Creating Confirmation Messages" Excerpt |
---|
|
Confirmation ScreensConfirmation messages require two screens: |
an " screen "- screen where the required action (e.g. delete) is initiated from
|
a " screen - 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
Image Added
- The Serene Grey palette contains a template confirmation screen with preconfigured Confirm and Cancel buttons
Image AddedSee Creating or Opening a Screen. |
Why?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:
- Action Method: choose
Other - Action Type: choose
Confirmation - 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.
|
see 1.12 Delete Action ConfigurationAbove - Delete
- Open the Actionflow for the required action, and above the Actionflow canvas, click the
Insert excerpt |
---|
| _add_icon |
---|
| _add_icon |
---|
nopanel | true |
---|
|
|
button next - 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- 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 Image Modified, 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. |
Earlier in this course we created a Delete Action Actionflow to delete courses in the School Courses grid on the Course Management 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 that an Actionflow to trigger show a confirmation message before the a Delete Action takes place is processed.
Note: Insert excerpt |
---|
_action_phase | _action_phase | nopanel | true |
s will be covered in detail later in this course.Image Added
Excerpt |
---|
Setting up a Confirmation Screen- Click on the Image Modified 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:
- Name: Confirmation Screen
- Open Maximised: toggle off
- All users can View Data: toggle on
- Description:
A generic confirmation screen - Please select a Template, choose
Confirmation - Click Create Screen.
- The screen will be created and will automatically open
- 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
- Image Modified
- 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 Image Modified button and choosing
Insert excerpt |
---|
| _actionflow_display |
---|
| _actionflow_display |
---|
nopanel | true |
---|
|
- Above the Actionflow canvas are the phases, click the button next to Processing Phase
- Image Modified
- Select
Insert excerpt |
---|
| _addIcon |
---|
| _addIcon |
---|
nopanel | true |
---|
| Add Phase
|
Before- before and set:
- Name:
Confirmation - 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 - Image Modified
- 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 Image Modified , 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 |
---|
| Image Added |
- Close the Actionflow to return to the Course Management screen
- the screen, select a record and press the Image Modified button
- We can see that the Actionflow is working because when you press Confirm on the Confirmation Screen, the selected record is deleted
|
Image Modified