Local Storage/File System Storage

Description

Configure the namespace information, data compression, additional data to persist, and debugging behaviors in working preview for the data persisted to Local Storage (or the file system) for an application.

Discussion

The UX component's Local Storage/File System Storage properties define how data is stored in local storage when persisted in a List. This includes whether or not data saved in Local Storage should be restored to the Lists (and variables) when the component is accessed after the user has closed the app (or web page.) You can optionally specify that variables should be persisted to local storage for the component.

Several debugging options are also available to control where data is stored when debugging using Working Preview.

images/localStorageFileSystemStorage.png
Name
Description
Namespace

The namespace used in Local Storage for persisted data.

Namespace friendly name

A friendly name for the Namespace used in Local Storage for the component.

Namespace description

A description of the Namespace used in Local Storage for the component.

Persist variable values

If enabled, all variables will be saved to Local Storage when the value in any control is changed.

Variables to NOT persist

One or more variables that should not be persisted to Local Storage. This property is only available when Persist variable values is checked.

Version number

A version number for the variable data stored in Local Storage.

Working Preview testing mode

Specify whether data should be stored in Local Storage in the browser used for Working Preview or in a file on the filesystem. This setting is for debugging purposes only.

Working Preview folder for Local Storage testing

The path to the folder where data persisted to Local Storage is saved while running the UX component in Working Preview. This property is only available when Working Preview testing mode is set to 'Filesystem'.

Restore variables from Local Storage

If enabled, variables that were persisted to Local Storage will be restored when the app is opened. This property is only available when Persist variable values is checked.

Restore data in List controls from Local Storage (or File System)

If enabled, List data persisted to Local Storage (or a device's file system) will be automatically restored when the app is opened.

Compress data before storing in Local Storage

Check to compress List data when it is stored in Local Storage. This setting does not apply to List data persisted to the file system.

Minify data

Reduces the amount of space needed for List data persisted to Local Storage by minifying the List data JSON. This property does not apply to List data persisted to the File System.

Videos

Persisting Data to Local Storage

When you build an application for disconnected operation you need to be sure that the data in the application is persisted to Local Storage so that edits that are made to any data are not lost if the application is restarted before the user has had a chance to synchronize the data with the server.

2014-09-07

See Also