Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
Confirmation Messages
Confirmation messages can be added to Actionflows, e.g. Save, Delete, etc. by inserting an additional
before the Actionflow processing phase, i.e. where the Save, Delete, etc. action is. Insert excerpt _action_phase _action_phase nopanel true
A confirmation phase is useful where the user must:
- Confirm an action before continuing
- Choose an option to determine which phase runs
Confirmation Screens
Confirmation messages require two screens. See Creating or Opening a Screen.
- an initiator screen where the required action (e.g. delete) is initiated from
- 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
Creating Confirmation Messages
- On the confirmation screen, click on the Confirm button to open its
, then click on theInsert excerpt _property_settings _property_settings nopanel true 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
- Action Method: choose
- On the initiator screen, set up the Actionflow for the required action, e.g. Delete
- Above Open the Actionflow for the required action, and above the Actionflow canvas, click the
button next to the ProcessingInsert excerpt _add _add nopanel true Insert excerpt _action_phase _action_phase nopanel true - Choose Add Phase Before to set up the confirmation phase
- From the Actionflow toolbar, click
to open the list of available screensInsert excerpt _screen _screen nopanel true - Drag the confirmation screen onto the Actionflow to create an
action nodeInsert excerpt _action_screen _action_screen nopanel true
- Drag the confirmation screen onto the Actionflow to create an
- To allow the confirmation screen to trigger the next
phase in the Actionflow, drag aInsert excerpt _action_phase _action_phase nopanel true
action node from the toolbar onto the canvas and in the popup select the ProcessingInsert excerpt _action_phase _action_phase nopanel true Insert excerpt _action_phase _action_phase nopanel true - Hover over the
action node and click , then click theInsert excerpt _action_screen _action_screen nopanel true
action node to connect them.Insert excerpt _action_phase _action_phase nopanel true
HTML Comment | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
Worked Example
Here's a worked example using the School Data (available from the Learning Centre).
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 Application. |
Earlier in this course we created a Delete Action Actionflow to delete courses in the School Courses grid on the Course Management screen. In this example we will insert a Confirmation phase into that Actionflow to trigger a confirmation message before the Delete Action takes place.
Note:
s will be covered in detail later in this course. Insert excerpt _action_phase _action_phase nopanel true
Setting up a Confirmation Screen
- Click on the icon in the PhixFlow header bar
- Select
on the leftInsert excerpt _add_screen _add_screen nopanel true - 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
- Click the Confirm button to open its
, then click on theInsert excerpt _property_settings _property_settings nopanel true 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
button next to Processing PhaseInsert excerpt _add _add nopanel true
- Select Add Phase Before and set:
- Name:
Confirmation
- Press Confirm
- Name:
- Select Click to Connect and choose the Input of On Click
- Press Connect Input
- From the Actionflow toolbar, click
to open the list of available screens in your applicationInsert excerpt _screen _screen nopanel true - Drag the Confirmation Screen you made earlier onto the Actionflow canvas
- Drag the
icon from Connections onto the Open Confirmation Screen action node to connect themInsert excerpt _input _input name icon nopanel true - From the toolbar, drag a
action node onto the canvas and in the popup select the phase, Processing Phase, to run after the confirmation has been completedInsert excerpt _action_phase _action_phase nopanel true - Hover your mouse pointer over the Open Confirmation Screen action node, click
action node to theInsert excerpt _action_screen _action_screen nopanel true
action nodeInsert excerpt _action_phase _action_phase nopanel true , then connect the - Close the Actionflow to return to the Course Management screen
the screen, select a record and press the buttonInsert excerpt _lock _lock nopanel true - We can see that the Actionflow is working because when you press Confirm on the Confirmation Screen, the selected record is deleted