Utiliser des propriétés utilisateur

Vous pouvez générer un fichier externe contenant des propriétés personnalisées. Lorsque la fonctionnalité est activée, les propriétés définies contenues dans le fichier externe (appelées "propriétés utilisateur") sont utilisées à la place des propriétés stockées dans le fichier de structure de la base (appelées "propriétés structure").

Ce principe permet notamment de conserver des paramétrages personnalisés entre deux mises à jour d’une application 4D, ou encore de pouvoir gérer différents paramétrages pour une même application 4D déployée sur plusieurs sites. Il rend également possible de gérer par programmation des fichiers de propriétés via le XML.

4D peut générer et utiliser deux sortes de propriétés utilisateur :

• Propriétés utilisateur (standard)
  Ces Propriétés utilisateur seront utilisées à la place des Propriétés structure pour tous les fichiers de données ouverts avec l'application.

• Propriétés utilisateur pour fichier de données
  Ces propriétés utilisateur peuvent être définies spécifiquement pour chaque fichier de données utilisés par l'application, en configurant par exemple le numéro de port ou le cache du serveur.
  Avec cette option, vous pouvez aisément déployer et mettre à jour plusieurs copies de la même application avec plusieurs fichiers de données, chacun contenant différents paramétrages. Considérons par exemple la configuration suivante, où une application est dupliquée et chaque copie utilise en paramétrage un numéro de port différent. Si ce paramétrage utilisateur est lié au fichier de données, vous pourrez mettre à jour l'application sans avoir besoin de changer manuellement le numéro de port :
  

Pour pouvoir utiliser la fonctionnalité d’externalisation des propriétés utilisateur, vous devez cocher l’option Autoriser les propriétés utilisateur dans un fichier externe, présente dans la Page Sécurité des Propriétés de la base.

Lorsque cette option est cochée, les propriétés de la base sont disponibles via trois boîtes de dialogue : Propriétés structure, Propriétés utilisateur et Propriétés utilisateur pour fichier de données. Ces boîtes de dialogue sont accessibles via le menu Développement/Propriétés de la base> ou le bouton Propriétés de la barre d’outils :

Note : Lorsque le fichier de données est situé au même niveau que le fichier de structure (configuration par défaut lorsque vous créez une base), la commande Propriétés utilisateur pour fichier de données... n'est pas proposée.

Lorsque le mode externe est actif, les propriétés de la base sont accessibles via trois boîtes de dialogue : "Propriétés structure", "Propriétés utilisateur" et "Propriétés utilisateur pour fichier de données".

La boîte de dialogue des "Propriétés structure" est identique à celle des Propriétés de la base en mode standard, elle donne accès à toutes les propriétés. Les boîtes de dialogue des "Propriétés utilisateur" contiennent une sélection de propriétés pertinentes qu’il est possible d’externaliser :

Le tableau ci-dessous liste les pages de propriétés que l'on trouve dans les "Propriétés utilisateur" et décrit les principales différences par rapport aux propriétés structure :

Lorsque vous éditez les Propriétés dans cette boîte de dialogue, elles sont automatiquement stockées dans le fichier settings.4DSettings correspondant (voir ci-dessous).

La plupart des propriétés utilisateur sont aussi disponibles via la commande SET DATABASE PARAMETER. Pour les propriétés utilisateur, l'option "Conservé entre deux sessions" est fixée à "Oui".

Lorsque la fonctionnalité "Propriétés utilisateur" est activée, les propriétés utilisateur éditées avec la commande SET DATABASE PARAMETER sont automatiquement stockées dans le fichier des "Propriétés utilisateur pour fichier de données".

Note : Table sequence number est une exception. Cette option est toujours stockée dans le fichier de données lui-même.

Lorsque vous cochez l'option Autoriser les propriétés utilisateur dans un fichier externe dans les Propriétés de la base, des fichiers de propriétés utilisateur sont automatiquement créés. Leur emplacement dépend du type de propriétés utilisateur défini.

Le fichier de propriétés utilisateur "générique" est automatiquement créé à l’emplacement suivant :

... où <DossierBase> est le nom du dossier contenant le fichier de structure de la base.

Note : Dans les applications fusionnées, le fichier de propriétés utilisateur générique est placé aux endroits suivants :

• en version monoposte : <DossierBase>/Database/Preferences/settings.4DSettings
• en version client-serveur : <DossierBase>/Server Database/Preferences/settings.4DSettings

Le fichier des propriétés utilisateur lié au fichier de données est automatiquement créé dans un dossier [Preferences] à l'emplacement suivant :

... où <DossierDonnées> est le nom du dossier contenant le fichier de données courant (".4dd") de l'application.

Note : Lorsque le fichier de données est situé au même niveau que le fichier de structure (emplacement par défaut à la création d'une base de données), les propriétés utilisateur "génériques" et celles associées au fichier de données partagent le même emplacement et le même fichier .4DSettings. Par conséquent, dans ce contexte la commande de menu Propriétés utilisateur pour fichier de données... n'est pas proposée.

Les fichiers de propriétés utilisateur, au format XML, peuvent être lus et modifiés à l’aide des commandes XML intégrées de 4D ou via un éditeur XML. Ce principe permet de gérer des propriétés par programmation, notamment dans le contexte d’applications compilées et fusionnées avec 4D Volume Desktop. A noter que si vous modifiez ces fichiers par programmation, les modifications ne seront prises en compte qu’à la réouverture de la base.

Les propriétés de la base peuvent être définies et stockées à trois niveaux. Chaque propriété définie à un niveau "écrase" la même propriété définie au niveau précédent, le cas échéant : 

N'oubliez pas que les fichiers settings.4DSettings peuvent contenir uniquement un sous-ensemble de propriétés utilisateur, tandis que le fichier structure contient toutes les propriétés personnalisées, incluant les paramétrages de bas niveau qui ne peuvent pas être déplacés dans des fichiers externes.