The Clear Data Control is used to remove data contained within Fields on the specified Pages. When it is triggered, the values of all Fields on the Pages specified in the Advanced Options tab in the Field Properties will be cleared from the database.
This Control is part of the Intermediate Control pack, and will only be available if your System has the appropriate licence.
How To
Add a Clear Data to the Page. The options and style can be configured in the Options tab and Styling tab of the Field Properties.
Clear Data Fields can be styled in a Stylesheet by referencing the control-clear-data class.
Open the Advanced Options tab in the Field Properties:
Clicking the Select button at the bottom will bring up a Page selection modal:
Any Pages to be cleared can then be selected from this list (including using the Ctrl or Shift keys to select multiple Pages). Click the Add button:
Click the Save button in the Field Properties modal when finished.
Notes
Should the Clear Data Field be targeted on a Page that shares Used Fields with the current Page, then if it is not set to run Before Page Load it may cause the values of any targeted Used Fields to be reinserted to the database. This is because the value of the Used Field on the current Page isn't also cleared, and then when the Page is navigated it will cause this data to be reinserted to the database.
As with other button-type Fields, upon activation the button will then be temporarily disabled until the action has completed.
As with other button-type Fields, it is possible to trigger this by JavaScript or Update Links. Please see the .click() article for more information and an example regarding using JavaScript.
