Advanced Properties

JSON is an open-standard file format similar to XML that is human-readable and easy to edit. The JSON file contains name/value pairs or objects surrounded by " (double quotation marks). An object begins with { (left curly brace) and ends with } (right curly brace). Each name is followed by : (colon) and the value. (See an example in the procedure below.) Refer to https://tools.ietf.org/html/rfc8259#section-3  for more information about JSON files.

  • Before you start editing this file (if it is not blank, meaning you have non-default settings defined), please make a backup copy with a different name in case you need to roll it back.

  • A JSON value MUST be an object, array, number, string, or one of the following three literal names: false, null, or true. (The literal names must be lowercase. No other literal names are allowed.)

  • JSON file entries are case sensitive. You must enter the format as expected, otherwise the EFT service will fail to start.

  • EFT doesn't validate the JSON file itself for acceptable or unacceptable names and values. It only reads names and validates their values.

    • If the "value" is wrong or malformed, the EFT server service will not start, and an error is written to the log.

    • If the Advanced Property name is misspelled, it is ignored, but the service will start. That is, if EFT was expecting for "EncryptPersonalData" but you spelled it "EncryptPersonelData" EFT will ignore it.

To edit or view the Advanced Properties file

  1. Navigate to the EFT installation folder, then open AdvancedProperties.json in a text editor (such as Notepad). In a new installation of EFT, or in an upgrade with only default EFT-related registry settings defined, the file will be blank, except for two curly brackets: {}

  2. If you are upgrading from a prior version with non-default registry settings, EFT will import them and you can view them in the JSON file.

  3. As shown above, to add a new name/value pair:

    1. Add a new line after the opening bracket.

    2. Type the name of the object, with the name surrounded by double quotation marks, followed by a colon (:), then a space, then the value. Strings must be enclosed in quotation marks; numbers and literal names (false, null, or true) do not need quotation marks. (See screenshot above.)

    3. For multiple objects, add a comma before the next object.

    4. Add a new line after the name/value pair, before the closing bracket.

  4. Save the file.

  5. Stop and restart the EFT server service, and then refresh the user database (View > Refresh User Database).

FAQ

  1. If a I have (for example) 100 EFT-related registry settings in EFT v7.4.13, then decide to upgrade to v8.x do my EFT registry settings become ineffective?
    No. The existing registry settings that are non-default values are migrated to the JSON file and then deleted from the registry. EFT will still read the registry, but it's recommend that you only add new items to the JSON file instead of the registry.

  2. Do I have to recreate/reenable each of my EFT registry settings in the JSON file?
    Upon upgrade to EFT v8.x, any EFT registry entry that is configured as a non-default value will be migrated to the JSON file. Anything that is configured with a default value (the equivalent of it not being enabled) will be ignored and not added to the JSON file.

  3. Do I have to remove the old registry settings?
    Upon upgrade from 7.4.x to EFT v8.x, any registry entry that is migrated to the JSON file will be removed from the registry.

  4. Are the advanced properties logged in EFT.log?
    Only non-default advanced properties are logged.

  5. Is JSON file backup/restore supported?
    Yes.

Refer to the Advanced Properties PDF for al list of advanced properties.

Topics That Reference Advanced Properties