By the end of this chapter you will understand what a Delete action is and how to use them, and you will have created a Delete Actionflow in your application.
What is a Delete Action?
The Insert excerpt |
---|
| _delete |
---|
| _delete |
---|
nopanel | true |
---|
|
action delete records for a selected table.
Note: Delete actions Delete actions will only insert or update delete records in tables with the Type of Transactional. Correct?
Creating Delete Actions
- Click the
Insert excerpt |
---|
| _delete |
---|
| _delete |
---|
nopanel | true |
---|
|
icon in the toolbar to display any existing tables in the application- Existing tables can be dragged from the Repository onto the canvas, then choose
Insert excerpt |
---|
| _delete |
---|
| _delete |
---|
nopanel | true |
---|
|
to create a Delete node
- Alternatively, drag the
Insert excerpt |
---|
| _delete |
---|
| _delete |
---|
nopanel | true |
---|
|
icon from the toolbar onto the canvas - In the Create Delete Action window:
- Enter a name
- Choose the Table from the drop down where the records will be inserted or updateddeleted
- Select Create Action
HTML Comment |
---|
|
Need to create a page on the Delete node properties. |
When creating delete actions it can be useful to set up confirmation messages that allows users to confirm or cancel the deletion. If you are completing the Actionflow course, confirmation messages will be covered in a later chapter. See LINK
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 In this course we created two Open Screen Actionflows that open an input form for adding and editing courses to example, we want to be able to delete courses in the School Courses grid . In this example we will configure the Save action.on the Course Management screen. We will also configure the Delete Actions on the input form
Note: When creating a new screens and input form forms in PhixFlow, a Grid Actions and Form Actions wizard can wizards are available to configure the Save Record and Delete Record actions for Delete actions for you. For the purposes of understanding the mechanics of Actionflows, we will create these manually.
Save Delete Action to
Add and Edit Delete Grid Data
- On the Course Management screen, press either the Image Removed or Image Removed button to open the Course Form Rightright-click on theImage Removedthe Image Added button and choose
Insert excerpt |
---|
| _actionflow_add |
---|
| _actionflow_add |
---|
nopanel | true |
---|
|
- Enter a name for the Actionflow,
- Name:
Save Delete Course Grid
- Select Confirm
- Select Click to Connect and for the input, choose the Course School Courses
Insert excerpt |
---|
| _formgrid |
---|
| _formgrid |
---|
nopanel | true |
---|
|
datasource, then select Connect Input - In the Mappings window that opens, drag the CourseID attribute from the left (Course FormSchool Courses Grid) to the right (Input Connection Point)
- Select Save
- Click and drag the
Insert excerpt |
---|
| _action_savedelete |
---|
| _action_savedelete |
---|
nopanel | true |
---|
|
icon from the toolbar onto the canvas - In the Create Save Delete Action window enter:
- Name:
SaveCourse
- Type: choose Auto Insert/Update
-
DeleteCourse
- Table: choose School_Courses
- Select Create Action
- Click and drag the
Insert excerpt |
---|
| _driving_interface_connection_point |
---|
| _driving_interface_connection_point |
---|
name | icon |
---|
nopanel | true |
---|
|
icon onto the Insert excerpt |
---|
| _action_savedelete |
---|
| _action_savedelete |
---|
nopanel | true |
---|
|
action node - Right-click on the in connector and choose Open Mappings
Insert excerpt |
---|
| _open_mappings |
---|
| _open_mappings |
---|
nopanel | true |
---|
|
- Drag the CourseID attribute on the left onto the CourseID attribute on the right
- Select Save
Click on the Save action node and in the - Close the Actionflow to return to the Course Management screen
- the screen and select a record in the grid, then press the Image Added button
- On the Course Management screen, select the Image Added or Image Added button to open the Course Form
- Right-click on the Image Added button on the Course Form and choose
Insert excerpt |
---|
| _propertyactionflow_settingsadd |
---|
| _propertyactionflow_settingsadd |
---|
nopanel | true |
---|
|
, toggle on - Enter a name for the Actionflow,
- Name:
Delete Course Form
- Repeat the above steps to configure the Actionflow but make the following changes:
- the input is the Course
toggle_on
toggle_on
Auto Save Attributes
Finally, - in the Settings
above the canvas- , toggle on
Insert excerpt |
---|
| _toggle_on |
---|
| _toggle_on |
---|
nopanel | true |
---|
|
Close screen after action completes
Close - - this will close the Course Form when Image Added is pressed
- Once you have configured the Actionflow to , return to the Course Management screen
- the screen, select a record in the grid and press the Image Added button
- On the Course Form, press the Image Removedor Image Removed button
- Either enter new course details or edit the existing course details and press Image Removed to see the Actionflow in action
- We can see that the Actionflow is working because the grid is updated with the data we have just created/edited
--
Link to confirmation help page here.- Image Added button
- If the Actionflow has been set up correctly, the Course Form will close and the selected record will be deleted from the School Courses Grid
Tip |
---|
title | Why do we not reuse the Delete Course Actionflow? |
---|
|
An Actionflow can be reused where the same Actionflow setup is required but with a different input. The Actionflow setup for Delete Course and Delete Form are nearly identical except for one key difference - the Delete Form Actionflow has Close screen after action completes enabled. If we were to reuse this Actionflow with two different inputs (grid and form), the Close screen after action completes option would need to be consistent across both instances of the Actionflow. |