Les préférences de sauvegarde de 4D sont disponibles sous forme d’un fichier XML backup.4DSettings. 4D exploite les données de ce fichier pour configurer les options de sauvegarde (options visibles dans la boîte de dialogue des Propriétés de la base) au moment du déclenchement (manuel, automatique ou à l'aide de la commande  SAUVEGARDER) de chaque sauvegarde. Ce fichier permet également de lire ou de fixer des options supplémentaires, telles que le nombre d’informations stockées dans le journal des sauvegardes, via des clés XML spécifiques. Les clés XML sont décrites dans le manuel 4D Clés XML Backup.

Le fichier backup.4DSettings est créé par défaut dans le dossier "Settings" de la base.

Note de compatibilité : Le fichier backup.4DSettings est nommé backup.xml et se situe dans le dossier Preferences des versions 4D antérieures ) 4D v18. Le fichier est automatiquement déplacé lorsque la base est convertie dans une version 4D v18 ou une version plus récente.

Deux types de fichiers de préférences de sauvegarde peuvent être utilisés : 

• un fichier par défaut de préférences de sauvegarde (propriétés de structure), utilisé pour la base courante.
• un fichier utilisateur de préférences de sauvegarde associé au fichier de données. Vous pouvez définir un fichier utilisateur de préférences de sauvegarde pour chaque fichier de données. Cette fonctionnalité est conçue pour les besoins de développement via la personnalisation de fichiers de préférences de sauvegarde  pour chaque site client/production.

Un fichier de paramètres de sauvegarde est défini pour un fichier de données lorsque :

• l'option de sécurité "Autoriser les propriétés utilisateur dans un fichier externe" est cochée (voir Utiliser des propriétés utilisateur)
• le fichier de données ne se situe pas dans le même dossier que le fichier de structure
• un dossier nommé Settings contenant un fichier "backup.4DSettings" existe au même niveau que le fichier de données (voir ci-dessous comment créer ce fichier).

Dans cette configuration, 4D charge et utilise le contenu du fichier "backup.4DSettings" situé dans le dossier Data, au lieu du fichier par défaut "backup.4DSettings" du dossier de la base. Ce fichier est utilisé pour les sauvegardes ainsi que pour les Propriétés Utilisateur dans la boîte de dialogue du fichier de données.
Si l'une des conditions mentionnées ci-dessus n'est pas respectée, 4D utilise le fichier par défaut "backup.4DSettings" du dossier Settings de la base.  

Le ou les fichiers de paramètres de sauvegarde et le fichier de paramètres de sauvegarde par défaut peuvent exister en même temps et sont utilisés en fonction du contexte. Vous pouvez obtenir l'emplacement de chaque fichier à l'aide de la commande Fichier 4D : 

• le chemin du fichier de paramètres de sauvegarde par défaut est retourné par Lire fichier 4D (Fichier paramètres sauvegarde). 
• un chemin de fichier de paramètres de sauvegarde utilisateur retourné par Lire fichier 4D (Fichier paramètres sauvegarde des données).
• le chemin du fichier de paramètres de sauvegarde en cours d'utilisation est retourné par Lire fichier 4D (Fichier paramètres sauvegarde courant).

Il est possible que vous ayez besoin de modifier le fichier de paramètres de sauvegarde par défaut (propriétés de la structure), lorsqu'un fichier de paramètres de sauvegarde des données utilisateur est en cours d'utilisation. Dans ce cas, les paramètres modifiés ne seront pas utilisés pour le fichier de données courant, mais seront enregistrés dans le fichier "backup.4DSettings" de la base de données et seront utilisés par défaut pour tout nouveau fichier de données. Un message d'alerte s'affiche dans la boîte de dialogue Propriétés :

Pour créer un fichier de paramètres de sauvegarde utilisateur pour le fichier de données courant :

1. Assurez-vous que le mode "Propriétés utilisateur" est activé (voir )
2. Sélectionnez l'option Paramètres utilisateur pour le fichier de données ... dans le menu Paramètres de conception / base de données ou appelez [#cmd id = "903" /] avec les User settings for data dans le paramètre settingsType.
3. Définissez les options de sauvegarde appropriées dans la fenêtre de propriétés, puis cliquez sur OK.

4D crée automatiquement le fichier "backup.4DSettings" dans un dossier Settings au même niveau que le fichier de données courant.

Toutes les informations concernant les dernières opérations de sauvegarde et de restitution sont stockées dans le fichier backupHistory.json de la base. Ce dernier enregistre le chemin de chaque fichier sauvegardé (y compris les pièces jointes) ainsi que le numéro, la date, l'heure, la durée et le statut de chaque opération. Afin de limiter la taille du fichier, le nombre d'opérations enregistrées et le nombre de sauvegardes disponibles ("Keep only the last X backup files") définies dans les propriétés de sauvegarde est identique.

Le fichier backupHistory.json se situe dans le dossier de destination de sauvegarde courant. Vous pouvez obtenir le chemin de ce fichier à l'aide de la déclaration suivante :

Attention : La suppression ou le déplacement du fichier backupHistory.json entraînera la réinitialisation du prochain numéro de sauvegarde.

Note : Le fichier backupHistory.json est formaté afin d'être utilisé par l'application 4D. Si vous recherchez un état lisible sur les opérations de sauvegarde, le journal de sauvegarde sera plus précis (voir ci-dessous).

Pour faciliter le suivi et la vérification de la sauvegarde de vos bases, le module de sauvegarde écrit un récapitulatif de chaque opération qu’il effectue dans un fichier particulier, qui est en quelque sorte le journal de son activité. A la façon d’un livre de bord, toutes les opérations concernant une base (sauvegardes, restitutions, intégrations d’historiques) sont consignées dans ce fichier, qu’elles aient eu lieu automatiquement ou manuellement. Ces opérations s’accompagnent de la date et l’heure à laquelle elles ont eu lieu.

Le journal des sauvegardes est nommé “Journal de sauvegardes.txt” et est placé dans le dossier "Logs" de la base. 

Le journal des sauvegardes peut être ouvert par n’importe quel éditeur de texte. Afin de faciliter son analyse, les informations qu’il contient sont séparées par des tabulations et chaque ligne d’informations se termine par un retour chariot.

Dans certaines stratégies de sauvegarde (par exemple en cas de sauvegarde de nombreux fichiers joints), la taille du journal peut atteindre rapidement une taille importante. Deux mécanismes permettent de contrôler cette taille :

• la sauvegarde automatique : avant chaque sauvegarde, l’application examine la taille du fichier journal courant. Si elle dépasse 10 Mo, le fichier courant est archivé et un nouveau fichier est créé. Les fichiers archivés sont renommés “Journal des sauvegardes[xxx].txt”, où xxx est un numéro de 1 à 999. Une fois le fichier n° 999 atteint, la numérotation redémarre à 1 et les fichiers existants sont remplacés.
• la possibilité de réduire le nombre d’informations consignées : pour cela, il suffit de modifier la valeur de la clé VerboseMode dans le fichier Backup.xml de la base. Par défaut, cette clé a pour valeur True. Si vous lui affectez la valeur False, seules les informations principales seront stockées dans le journal des sauvegardes : date et heure de démarrage de l’opération et éventuelles erreurs rencontrées. Les clés XML de configuration des sauvegardes sont décrites dans le manuel Clés XML Backup (PDF).

Ce fichier est généré automatiquement dès qu'une intégration de fichier journal est exécutée par 4D avec le mode réparation automatique. Il contient la liste des erreurs non critiques qui ont été réparées, le cas échéant. Pour plus d'informations, veuillez vous reporter au paragraphe Restitution automatique.

Le fichier est toujours généré après une intégration automatique du fichier journal en mode réparation automatique, que des erreurs non critiques aient été traitées ou non. Il peut également être utilisé pour détecter si une intégration automatique s'est produite, comme par exemple en utilisant le code suivant au démarrage :