What is a Bulk
Delete Update Action?
Image RemovedImage Added
The
Insert excerpt |
---|
| _action_bulkdeletebulkupdate |
---|
| _action_bulkdeletebulkupdate |
---|
nopanel | true |
---|
|
action
deletes updates records in bulk
from in a table,
such as deleting all records, or those including saving new records. Only records which satisfy the specified filter criteria set on the node
will be updated.
Note: Bulk Delete Update actions will only delete update records in tables with the Period of Transactional.
Insert excerpt |
---|
| 1.09 Save Action Configuration |
---|
| 1.09 Save Action Configuration |
---|
name | TablePeriod |
---|
nopanel | true |
---|
|
delete
delete vs
bulk_delete
bulk_delete
The key difference between deletedelete and bulk_deletebulk_delete is that the Bulk Delete action purges records from PhixFlow, including Bulk Update action will not update the audit history of records where Audit Manual Changes has been enabled.
To delete To update records and persist the audit history of the record, see Delete Node1.09 Save Action Configuration.
Creating Bulk
Delete Update Actions
- Click the bulkdeletebulkdelete 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 bulkdeletebulkdelete to create a Bulk Delete Bulk Update node
- Alternatively, drag the bulkdeletebulkdelete icon from the toolbar onto the canvas
- In the Create Bulk Delete Bulk Update Action window:
- Enter a NameChoose a Type from: Delete: allows only records satisfying the specified filter criteria to be deletedSet the filter criteria in the Bulk Delete Action
Insert excerpt |
---|
_property_settings | _property_settings | nopanel | true |
under Data Retrieval Options - see section belowDelete All: deletes all data from the selected table - Choose to Allow Audited Table to display tables with Audit Manual Changes enabled in the Table drop down
- By default, tables with Audit Manual Changes enabled are not shown in the Table drop down list
- Choose the Table from the drop down where the records will be deletedupdated
- Or click the table icon to display tables in the Repository
- Select Create Action
When creating delete creating update actions it can be useful to set up confirmation messages that allow users to confirm or cancel the deletionupdate. See 1.13 Confirmation Message Configuration.
Setting
Delete Update Action Filter Criteria
Where the Type is set to Delete on the Insert excerpt |
---|
_action_bulkdelete | _action_bulkdelete | nopanel | true |
action, the A filter must be set for the Bulk Update action to run. Set this in the Data Retrieval Options section
shows in the of the Insert excerpt |
---|
| _property_settings |
---|
| _property_settings |
---|
nopanel | true |
---|
|
.
This filter must be set for the Bulk Delete action to run.- Choose a Data Range from:
- Latest: selects data from the latest recordsets
- All: selects data from all recordsets (default)
- Set the Filter Criteria to specify which records will be selected for deletion. See Filter → Filter Details
- Incoming attributes mapped to the Bulk Delete node Update node can be referenced in the Data Retrieval Options using the syntax, ConnectorName.AttributeName, e.g. in.MyAttribute
Specify Delete Batch Size
Where the Type is set to Delete on the Insert excerpt |
---|
_action_bulkdelete | _action_bulkdelete | nopanel
true | action, in the Advanced section, an optional Delete Batch Size can be set to determine the size of the batches. If left blank the batch size set in System Configuration → System Tuning → Delete Batch Size, is used as the default. The System Configuration value can be overridden with this batch size. HTML Comment |
---|
|
Insert excerpt |
---|
| Bulk Delete Update Node |
---|
| Bulk Delete Update Node |
---|
nopanel | true |
---|
|
|
Worked Example
Here's a worked example using the Company Data (available from the Learning Centre).
In this example, we are using:
- A Company Rejected Companies screen containing three grids of the Companies, Orders and OrderLines data - this screen was created using the Multi-Tile template
Tip |
---|
If you are completing this chapter as part of the Actionflow course and using a training instance, the data and screens have already been pre-loaded into the Actionflow Advanced Application. For this example, we'll be working on the Company Rejected CompaniesManagement screen. |
Image RemovedBulk
Delete Rejected CompaniesActionflow SetupUpdate Company Employees
In this example, we'll set up an Actionflow to delete all companies with a Status of Rejected, along with any associated Orders and Order Lines.
Open the Company Rejected Companies a company is being taken over by another company and we need to update all employees to reflect their new CompanyID.
Actionflow Setup
- Open the Company Management screen
- Create an Actionflow on the Bulk Delete Run Acquisition button
- Name: BulkDeleteRejectedCompanies RunCompanyAcquisition
- Configure the input connection point to the Companies data on the screen
- On the Mappings window, ensure Page is selected for What data is being used?
- Map in CompanyID
- Create
Insert excerpt |
---|
| _action_view |
---|
| _action_view |
---|
nopanel | true |
---|
|
actions for the Orders and OrderLines dataThese should contain filters so only the Orders and OrderLines for the companies with a Status of Rejected are mapped
Expand |
---|
|
|
Bulk Delete Action Setup
- Create three Bulk Delete Actions for deleting from the three tables: Companies, Orders and OrderLines
- Map the associated ID attribute into the relevant Bulk Delete node
- Set up filters on each node in the Data Retrieval Options section to ensure only records associated with a rejected company are deletedupdated
Testing
- Return to the Company Rejected Companies screen
- Press Bulk Delete button
- Refresh the data in each grid to see the results