Delete Data Object
Description
The delete data object part allows you to remove a variable name and corresponding values from the context, effectively resetting the data model at that point in runtime. You can apply it to a single data object (text, numeric, date), a container of multiple objects (container.object1, container.object2), or a collection.
Use
This part is used extensively in most logic models. It allows you to do the following:
- Clear out a user input field; for example, when a user clicks "new" the system deletes any previously input information.
- Reset an entire form. This applies if you put every field in the form in the same container; for example, new_client_details.company_name, new_client_details.company_address.
- Clear out any prior results from a "get records" statement prior to retrieving fresh records.
- Reset a collection when the system adds items to a collection as the user answers questions.
- Reset a variable used for application navigation; for example, after a user clicks a button, the system resets the button and logic flow by deleting the button data object.
Tips & Tricks
When building an application, you may create a number of "temporary" variables used in processing steps, such as calculating intermediate numbers or setting flags associated with particular logic paths. Placing these in a container called "tmp" allows you to quickly clear them at the end of processing by deleting "tmp" with this part. This is also good practice for processing.
When dealing with a form consisting of user inputs, use a container as a scoping name ("client details", for example), so you can easily clear the form values in one step by deleting the data object called "client details" at the appropriate time.
Editor Fields
| Field Name | Description | Type/Options | Optional/Mandatory |
| Data object | This is the data object, container, or collection name that you want to clear from the runtime context. | Text | Mandatory |
| Save data-object in log (Versions Prior to v8) |
Setting this option to Yes logs the deletion in the changelog_ctx. It defaults to No. Change to Yes when using the LogicNets Assessment Framework. |
No | Yes | Mandatory |
| Update change log (Version 8+) | Setting this option to Yes tells the system to log the deletion in the changelog_ctx. It defaults to No. Change to Yes when using the LogicNets Assessment Framework. |
No | Yes | Mandatory |
| Update data log (Version 8+) |
This tells the system to update the data log when data object is cleared. It defaults to No. Change to Yes when using the LogicNets Assessment Framework. |
No | Yes | Optional |