By the end of this chapter you will understand what a confirmation message is and how to use themhow confirmation messages can be added to Actionflows, and you will have added a confirmation message to your application.

Confirmation Messages

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

Save actions only save attributes mapped into them. However, if the Save action has Auto Save Attributes enabled, this saves unmapped attributes from the input form or view, matched by identifier. This finds the attribute associated with a field that was created by dropping the attribute onto a form.

Note: Save actions must be attached to a table with a Type of Transactional. Reword? "Save actions will only insert or update records in tables with the Type of Transactional."

Creating Save Actions

 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

Confirmation messages require two screens:

• 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

See Creating or Opening a Screen.

1. 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

2. 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
3. On the initiator screen, set up the Actionflow for the required action, e.g. see 1.12 Delete Action Configuration
4. Above the Actionflow canvas, click the 

   Insert excerpt
   _add _add nopanel true

    button next to the Processing 

   Insert excerpt
   _action_

   save

   phase _action_

   save

   phase nopanel true

    icon in the toolbar to display any existing tables in the applicationExisting tables can be dragged from the Repository onto the canvas, then choose 
5. Choose Add Phase Before to set up the confirmation phase
6. From the Actionflow toolbar, click 

   Insert excerpt
   _screen _screen nopanel true

   to open the list of available screens
   1. Drag the confirmation screen onto the Actionflow to create an 

      Insert excerpt
      _action_

      save

      screen _action_

      save

      screen nopanel true

       action node to create a Save node
7. Alternatively, drag the 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_

   save

   phase _action_

   save

   phase nopanel true

    icon  action node from the toolbar onto the canvas In the Create Save Action window:
8. Enter a name
9. Choose a Type:
   1. Auto Insert/Update - Insert or update records using the following condition:
      1. If the input data passes in the primary key of an existing record, the save action updates the record in the chosen table
      2. If the input data does not pass in the primary key of an existing record, the save action inserts a new record in the chosen table
   2. Insert - Always insert a new record into the chosen table
   3. Update - Always update a record for the chosen table. For a record to update successfully a primary key must be provided.
10. Choose the Table from the drop down where the records will be inserted or updated
Select Create Actionand in the popup select the Processing 

Insert excerpt
_action_phase _action_phase nopanel true

11. Hover over the 

    Insert excerpt
    _action_screen _action_screen nopanel true

     action node and click Image Added, then click the

    Insert excerpt
    _action_phase _action_phase nopanel true

     action node to connect them.

Worked Example

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

Earlier in this course we created two Open Screen Actionflows that open an input form for adding and editing courses to a Delete Action Actionflow to delete courses in the School Courses grid on the Course Management screen. In this example we will configure the Save action.Note: When creating a new input form in PhixFlow, a Form Actions wizard can configure the Save Record and Delete Record actions for you. For the purposes of understanding the mechanics of Actionflows, we will create these manually.insert a Confirmation phase into that Actionflow to trigger a confirmation message before the Delete Action takes place.

Note: 

Setting up a Confirmation Screen

In order to use a screen as a confirmation it must be set up a certain way.

The screen must have a Confirm button on with an action type of confirmation 

1. Click on the  icon in the PhixFlow header bar
2. Select

   Insert excerpt
   _add_screen _add_screen nopanel true

    on the left
3. 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.
4. The screen will be created and will automatically open
5. 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

6. 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 this setup these settings that allows allow the Confirm button to trigger the Delete Action phase we will setup below phase 
   1. 
7. No edits are required to this screen
8. Close the Confirmation Screen

Configuring a Confirmation Actionflow

1. 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

2. Above the Actionflow canvas are the phases
   1. Image Removed
    Click , click the 

   Insert excerpt
   _add _add nopanel true

    button next to Processing Phase

1. 1. Image Added
2. Select Add Phase Before and set:
   1. Name: Confirmation 
   2. Press Confirm   Confirm  
3. Select Click to Connect and choose an the Input of On Click 
   1. Press Connect Input
4. From the Actionflow toolbar, click 

   Insert excerpt
   _screen _screen nopanel true

   to open the list of available screens .in your application
5. Drag the confirmation screen Confirmation Screen you made earlier onto the Actionflow .canvas
6. Drag the input node the 

   Insert excerpt
   _input _input name icon nopanel true

    icon from Connections onto the Open Confirmation Screen action node to connect them 
   1. 
7. From the toolbar, drag an  a  

   Insert excerpt
   _action_phase _action_phase nopanel true

    node  action node onto the canvas and in the popup select the phase, Processing Phase, to run after the confirmation has been completed
8. Hover your mouse pointer over the Open Confirmation Screen Open Screen action node, click  , then connect the open screen node

   Insert excerpt
   _action_screen _action_screen nopanel true

    action node to the

   Insert excerpt
   _action_phase _action_phase nopanel true

    action node.
9. Close the Actionflow to return to the Course Management screen

10. 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 shows and if you press Confirm, the selected record is deleted