Help
FAQFAQCommunityCommunityUser GuideUser GuideContactContactCustomer InfoCustomer Info

JSON File Install Tab

File Install

Operation

This section allows you to configure the JSON file's installation behavior.

You have the following options:

Create file if it doesn't already exists

If the requested JSON file does not already exist on the target system, it will be generated using the specified configuration.

Remove file on uninstall

If you wish to delete the JSON file from the target system during component uninstalling, use one of the following options:

  • Only if it was created at install - The file will be removed on uninstall only if it was created by the package during the first time installation.
  • If the root node was left empty - If subsequent edit operations leave the root node empty, the file will be removed on uninstall.

NoteIf none of the two checkbox choices is selected, the file will not be deleted during the uninstall process.

Component

This field specifies the component whose install or removal will trigger the JSON update operation.

Error Policy

Select what action should be performed in case an error occurs during the JSON installation:

  • Abort installation - all system changes will rollback.
  • Skip file - the file which caused the error will be skipped. All the changes performed by the installation on this file will be reverted and the installation will continue.

Create backup before updating

Prior to the update procedure, a backup copy of the original JSON file will be generated if this option is selected.

Backup Filename Template - Use # to specify the backup index. This character will be automatically replaced with the backup number when installing the package. The following characters can be part of the filename: . , - , % , ^ , ~ , & and _. Leaving a blank input will automatically default the template to YourFilename.#.back.

ImportantDue to the possibility of JSON file updates occurring during the uninstall process, a backup of the file will be made during the uninstall process as well. If during uninstall an error occurs, a backup of the file will be created (regardless of this option) and the uninstall process will continue.

Warning!It highly recommended that you leave this option enabled, because an unexpected error during the JSON update process may corrupt parts of your existing JSON file.

Common options

Impersonate installing user

Check this box if you wish to execute all JSON updates and actions as the user who is installing the app rather than under the Local System account.