Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

What is a Bulk

Delete

Update Action?

Image RemovedImage Added

The 

Insert excerpt
_action_bulkdeletebulkupdate
_action_bulkdeletebulkupdate
nopaneltrue
 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 Configuration1.09
Save Action Configuration
nameTablePeriod
nopaneltrue

Insert excerpt
_action_

delete

save
_action_

delete

save
nopaneltrue
 vs 
Insert excerpt
_action_

bulk_delete

bulkupdate
_action_

bulk_delete

bulkupdate
nopaneltrue
 

The key difference between 

Insert excerpt
_action_
delete
bulkupdate
_action_
delete
bulkupdate
nopaneltrue
 and 
Insert excerpt
_action_
bulk_delete
save
_action_
bulk_delete
save
nopaneltrue
 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 NodeSave Action Configuration.  

Creating Bulk

Delete

Update Actions

  1. Click the 
    Insert excerpt
    _action_
    bulkdelete
    bulkupdate
    _action_
    bulkdelete
    bulkupdate
    nopaneltrue
     icon in the toolbar to display any existing tables in the application
    1. Existing tables can be dragged from the Repository onto the canvas, then choose 
      Insert excerpt
      _action_
      bulkdelete
      bulkupdate
      _action_
      bulkdelete
      bulkupdate
      nopaneltrue
       to create a Bulk Delete Bulk Update node
  2. Alternatively, drag the 
    Insert excerpt
    _action_
    bulkdelete
    bulkupdate
    _action_
    bulkdelete
    bulkupdate
    nopaneltrue
     icon from the toolbar onto the canvas
  3. In the Create Bulk Delete Bulk Update Action window:
    1. Enter a Name
    2. Choose 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_settingsnopaneltrue under Data Retrieval Options - see section below
    3. Delete All: deletes all data from the selected table 
    4. Choose to Allow Audited Table to display tables with Audit Manual Changes enabled in the Table drop down
      1. By default, tables with Audit Manual Changes enabled are not shown in the Table drop down list
    5. Choose the Table from the drop down where the records will be deletedupdated
      1. Or click the table icon to display tables in the Repository
    6. 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_bulkdeletenopaneltrue 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
nopaneltrue
. This filter must be set for the Bulk Delete action to run.

  1. Choose a Data Range from:
    1. Latest: selects data from the latest recordsets
    2. All: selects data from all recordsets (default)
  2. Set the Filter Criteria to specify which records will be selected for deletionupdated. See Filter → Filter Details
    1. 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_bulkdeletenopanel
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 TuningDelete Batch Size, is used as the default. The System Configuration value can be overridden with this batch size. 
HTML Comment
hiddentrue

Insert excerpt
Bulk Delete Update Node
Bulk Delete Update Node
nopaneltrue


Worked Example

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

In this example, we are using:  

  • Company Rejected Companies screen containing three grids of the Companies, Management screen containing a grid of the Companies data and a card container of their associated Employees - this screen was created using the Multi-Tile template
  • Company Merger Pop up screen containing:
    • two manual drop down fields of the company name's of the companies to be merged
    • two string fields showing the company ID's of the companies to be merged
    • a button to initiate the Actionflow - this screen was created using the Tile no Buttons template
  • Company Orders screen containing two grids of the 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 Removed

Bulk Delete Rejected Companies

Actionflow Setup


Excerpt
nameBulkUpdateExample

Bulk Update Employees and Orders for Company Acquisition

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 merged into another company and we need to update the employees and orders to reflect the change.

Image Added

Actionflow Setup

  1. Open the Company Management screen
  2. Click the Merge button to open the Company Merger Pop up screen
  3. Create an Actionflow on the
Bulk Delete
  1. Run Acquisition button
    1. Name:
BulkDeleteRejectedCompaniesCreate 
    1.  RunCompanyAcquisition
  1. On the Actionflow canvas, toggle on
    Insert excerpt
    _toggle_on
    _toggle_on
    nopaneltrue
     Close screen after action completes
    1. This ensure the pop up screen closes after the acquisition has been run
  2. 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?
    1. Image Removed
  • Map in CompanyID
    1. Company Merger form
    2. Map in the two CompanyID fields from the screen, CompanyIDBeingAcquired and CompanyIDDoingAcquiring

    Bulk Update Action Setup

    A Bulk Update action is required to update the data in each table.

    1. Create two 
      Insert excerpt
      _action_
    view
    1. bulkupdate
      _action_
    view
    1. bulkupdate
      nopaneltrue
       actions
    for
    1. : one to update the Employees data and one to update the Orders
    and OrderLines data

    These should contain filters so only the Orders and OrderLines for the companies with a Status of Rejected are mapped

    Expand
    titleCheckpoint

    Image Removed

    Image Removed

    Bulk Delete Action Setup

    1. Create three Bulk Delete Actions for deleting from the three tables: Companies, Orders and OrderLines
    2. Map the associated ID attribute into the relevant Bulk Delete node
    3. Set up filters on each node in the Data Retrieval Options section to ensure only records associated with a rejected company are deleted
    Expand
    titleCheckpoint

    Image Removed

    Image RemovedImage Removed

    Testing

  • Return to the Company Rejected Companies screen
  • Press Bulk Delete button
  • Refresh the data in each grid to see the results
    1. data
    2. Drag the 
      Insert excerpt
      _input
      _input
      nopaneltrue
       onto each action

    Update Employees 
    Insert excerpt
    _action_bulkupdate
    _action_bulkupdate
    nopaneltrue
     Setup

    Map in the required data and set up the action to update the data with the replacement company details.

    1. Map the attribute, CompanyIDDoingAcquiring, onto the CompanyID attribute on the table
    2. Drag across the attribute, CompanyIDBeingAcquired, into the drag and drop space to create an additional mapping
    3. On the 
      Insert excerpt
      _property_settings
      _property_settings
      nopaneltrue
       for the Employees Bulk Update action, set the Data Retrieval Options to:
      1. CompanyID
      2. equals
      3. in.CompanyIDBeingAcquired

    Update Orders 
    Insert excerpt
    _action_bulkupdate
    _action_bulkupdate
    nopaneltrue
     Setup

    Map in the required data and set up the action to update the data with the replacement company details.

    1. Map the attribute, CompanyIDDoingAcquiring, onto the Customer_ID attribute on the table
    2. Drag across the attribute, CompanyIDBeingAcquired, into the drag and drop space to create an additional mapping
    3. On the 
      Insert excerpt
      _property_settings
      _property_settings
      nopaneltrue
       for the Orders Bulk Update action, set the Data Retrieval Options to:
      1. Customer_ID
      2. equals
      3. in.CompanyIDBeingAcquired
    Tip
    titleWhy is a Bulk Update action not needed for Order Lines?

    The OrderLines data has a direct relationship with the Orders data via the OrderID. The OrderLines data has an indirect relationship with the Companies data via the OrderID, therefore, updating the Orders data is sufficient.


    Expand
    titleCheckpoint

    Image Added


    Testing

    1. Close all screens and reopen the Company Management screen
    2. Decide which two companies you will merge
      1. Make a note of their employees on the Company Management screen so you can see if the merge is successful
      2. Open the Company Orders screen and make a note of any Orders and Order Lines for the two companies
    3. On the Company Management screen, click the Merge button to open the Company Merger Pop up screen
    4. Select the two companies using the drop down fields and click the Run Acquisition button
    5. Review the screens to check the merge was successful

    Insert excerpt
    Bulk Delete Action Configuration
    Bulk Delete Action Configuration
    nameReinstatingData
    nopaneltrue

    Image Modified