BEST PRACTICE
We recommend defining a new App Settings entry for each application, as this makes it easier to manage the captured and restored data over time.
You can link a single App Settings entry to multiple packages (for example, different language variants of the same application) to apply identical settings wherever the application is deployed.
To create new app settings:
1. On the App Settings page, click the Create button in the table toolbar.
2. In the Create app settings > Overview, give your new app settings a Name. By default, the app settings are Enabled. Click Next.
3. On the Summary tab, confirm the app settings name, as well as whether they are Enabled or whether you can Modify app settings after creation. Click Finish.
The App Settings details page will open automatically.
Include an Item in App Settings
To include a new item in the app settings captured for end users:
1. On the App settings details page, open the Contents tab and click Create included item in the table toolbar.
2. In the Create included item window that opens, choose the Type of information you want to capture and restore.
App Settings Types:
- Registry Tree - Syncs all the keys in an entire registry tree recursively.
- Registry Key - Syncs all the keys in a registry key, but not those contained in subdirectories.
- Registry Value - Syncs a defined registry value
- Registry Key - Syncs all the keys in a registry key, but not those contained in subdirectories.
- Folder Tree - Syncs the entire directory on the file system recursively
- Folder - Syncs a defined directory but not its subdirectories
- File - Syncs a defined file
- Folder - Syncs a defined directory but not its subdirectories
3. Name the item and enter its Value.
Wildcard Support
This feature supports wildcards in folder/file paths, meaning that you can capture and restore App Settings across varying file structures without needing to define every path exactly.
By default, Application Workspace will Delete existing content before restore to create a clean slate for the app settings.
4. Click Confirm.
Exclude an Item from App Settings
This functionality is useful for leaving out an item such as a backup folder.
To exclude an item from the app settings captured for end users:
1. On the App settings details page's Contents tab and click Create excluded item in the table toolbar.
2. In the Create excluded item window that opens, choose the Type of information you do not want to capture and restore.
App Settings Types:
- Registry Tree - Syncs all the keys in an entire registry tree recursively.
- Registry Key - Syncs all the keys in a registry key, but not those contained in subdirectories.
- Registry Value - Syncs a defined registry value
- Registry Key - Syncs all the keys in a registry key, but not those contained in subdirectories.
- Folder Tree - Syncs the entire directory on the file system recursively
- Folder - Syncs a defined directory but not its subdirectories
- File - Syncs a defined file
- Folder - Syncs a defined directory but not its subdirectories
3. Name the item and enter its Value. Click Confirm.
4. Save your changes.
If the device shuts down or the process is interrupted before capture or restore completes, data may be incomplete or corrupted.
