4D v16.3User settings |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
User settings
User settings
You can generate an external file containing custom settings. When this functionality is enabled, the settings contained in the external file (called "User settings") are used instead of settings stored in the database structure file (called "Structure settings"). This means that you can keep custom settings between updates of your 4D applications, or that you can manage different settings for the same 4D application deployed on several different sites. It also makes it possible to use programming to manage setting files using XML. 4D can generate and use two kinds of user settings:
To be able to externalize user settings, you need to check the Enable User Settings in External File option, found on the Security page of the Database settings: When you check this option, database settings are separated into three dialog boxes: Structure Settings, User Settings, and User Settings for Data file. You can access these dialog boxes using the Design/Database Settings> menu or the Settings button in the toolbar:
Note: When the data file is located at the same level as the structure file (default configuration when creating a database), the User Settings for Data file... command is not displayed. You can also access these dialog boxes using the OPEN SETTINGS WINDOW command with the appropriate settingsType selector. When the external mode is enabled, database settings are available in three dialog boxes: "Structure Settings", "User Settings", and "User Settings for Data File". The "Structure Settings" dialog box is identical to the standard Database Settings one and provides access to all its properties. The "User Settings" dialog boxes contain a selection of relevant properties that can be externalized:
The following table lists the pages of settings found in the "User Settings" dialog boxes and describes their main differences with respect to standard settings:
When you edit settings in this dialog box, they are automatically stored in the corresponding settings.4DSettings file (see below). Most of the user settings are also available through the SET DATABASE PARAMETER command. User settings are parameters with the "Kept between two sessions" property set to "Yes". When the "User settings" feature is enabled, user settings edited by the SET DATABASE PARAMETER command are automatically saved in the user settings for the data file. Note: Table sequence number is an exception; this setting value is always saved in the data file itself. When you check the Enable User Settings in External File option in the Database Settings, user settings files are automatically created. Their location depends on the kind of user settings defined. The standard user settings file is automatically created and placed in a [Preferences] folder at the following location: <DatabaseFolder>/Preferences/settings.4DSettings ... where <DatabaseFolder> is the name of the folder containing the database structure file. Note: In merged applications, the user settings file is placed at the following location:
The user settings file linked to the data file is automatically created and placed in a [Preferences] folder at the following location: <DataFolder>/Preferences/settings.4DSettings ... where <DataFolder> is the name of the folder containing the current data file (".4dd") of the application. Note: When the data file is located at the same level as the structure file (default when creating a database), structure-based and data-based user settings files share the same location and file. The User Settings for Data File... menu command is not proposed. User settings files are XML files; they can be read and modified using integrated 4D XML commands or using an XML editor. This means that you can manage settings by programming, particularly in the context of applications compiled and merged with 4D Volume Desktop. Note that when you modify this file by programming, the changes are only taken into account the next time the database is opened. Database settings can be stored at three levels. Each setting defined at one level overrides the same setting defined at a previous level, if any:
Keep in mind that settings.4DSettings files can only contain a subset of relevant settings, while the structure file contains all custom settings, including core settings that cannot be moved to external files.
|
PROPERTIES
Product: 4D
HISTORY
ARTICLE USAGE
4D Design Reference ( 4D v16) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||