A confirmation phase is useful where the user must:
- Confirm an action before continuing.
- Choose an option to determine which phase runs.
A confirmation is added as a phase within an actionflow and typically opens a popup window that asks the user to confirm their action. The following steps assume all screens already exist.
The example illustrated below opens a confirmation screen before the deletion of a record is carried out.
- Open the actionflow that requires a confirmation. Above the actionflow canvas are the phases.
- On the Processing Phase click Add New.
- Select Add Phase Before and set the Name to
Confirmation
. - In the Inputs panel, configure the input into the actionflow:
- If you want to map data into the confirmation phase, add the form or data sources as the input.
- If you do not need any data, add the On Click action event as the input.
- From the actionflow toolbar click Screen to open the list of available screens.
- Drag the confirmation screen you require onto the actionflow.
- If you need to create a confirmation screen do so now, there is a confirmation screen template available in Serene Grey that can be selected from the screen creation wizard.
- Connect the On Click input connection point to the Confirmation Screen.
- Drag an Phase node onto the canvas and select the phase to run after the confirmation has been completed. For example, Processing Phase.
- Hover your mouse pointer over the screen node that opens the Confirmation Screen, click Confirm. and connect this to the
Phase
node.
Additional Options
- If a custom confirmation message is required, a Calculate node can be added before the Open Screen node. The Calculate node can be configured to produce a custom message and this can be mapped into the dynamic text fields on the Serene Grey confirmation screen. To find out more, see Calculate Node and Open Screen Node.
A confirmation is a special type of action that allows an actionflow to wait for a user's input before continuing.
- For a screen to be considered a confirmation screen one button must have an Action Type of Confirmation.
- A confirmation screen must have a button on it whose Action Type is set to
Confirmation
. - To do this click on a button to open its Properties.
- Click the Actionflow tab
- Set Action Type to
Confirmation
- Apply your changes.