Module de sauvegarde intégré en 4D 2004

Les configurations de sauvegarde sont placées dans la page de sauvegarde sous le thème de Sauvegarde des Préférences de l'application. Les valeurs par défaut de la sauvegarde, comme montrées ci-dessous, sont mises en place pour une utilisation standard de la sauvegarde. La modification de ces valeurs est facultative. Les configurations de sauvegarde sont définies dans deux sections : Paramètres généraux et Archive.

Dans la section Paramètres généraux, vous pouvez définir le nombre de sauvegardes à garder et demander à n'exécuter une sauvegarde que s'il y a eu une modification dans le fichier de données. Ces options vous permettent de ménager de l'espace sur votre disque dur.

L'option « Conserver uniquement les x derniers fichiers de sauvegarde » par exemple, vous permet de garder seulement un certain nombre de sauvegardes. C'est-à-dire, quand une nouvelle sauvegarde (x+1) est créée, le fichier de sauvegarde le plus ancien est effacé.

Vous pouvez choisir quand effacer la sauvegarde la plus ancienne, après ou avant la création de la sauvegarde en commutant l'option de backup « Effacer la sauvegarde la plus ancienne avant/après la sauvegarde ».

Si vous lancez le backup automatiquement en utilisant l'option Périodicité, vous pouvez aussi choisir « Sauvegarde seulement si le fichier de données a été modifié », de sorte que la sauvegarde programmée sera annulée si aucune modification n'a été faite. Dans ce cas le backup sera effectué à la prochaine échéance.

De plus, vous pouvez indiquez ce que vous souhaitez faire en cas de transaction ou si la sauvegarde a échoué. Vous pouvez soit attendre la fin d'une transaction avant de commencer la sauvegarde ou attendre un certain temps pour annuler la sauvegarde. Quand la sauvegarde est annulée, le statut du backup est considéré comme « échoué ». Ainsi, vous pouvez implémenter certains mécanismes lorsque le backup échoue. Ces options sont soit de retenter à la prochaine échéance ou de réessayer après un certain délai. Vous pouvez choisir d'annuler l'exécution après un certain nombre de tentatives.

Dans la section Archives, vous pouvez définir des options telles que segmenter les archives, le taux de compression, et utiliser des méthodes d'optimisation. Les archives peuvent être segmentées et ainsi découpées en morceaux de taille fixe pour pouvoir être stockées sur plusieurs volumes (plusieurs CD par exemple). Vous utilisez une taille de segment prédéfinie ou saisissez une valeur entre 1 et 2 048 Mo (0 est équivalent à Aucune). En outre, vous pouvez compresser les archives pour sauvegarder l'espace disque bien que ceci puisse ralentir le processus de sauvegarde. Parmi les options d'optimisation, vous pouvez indiquer le taux d'entrelacement et de redondance.

Dans cette section vous spécifiez ce que vous voulez inclure dans le backup. Les fichiers de structure et de données sont sélectionnés par défaut. Vous pouvez ajouter des fichiers ou des dossiers. Dans l'exemple ci-dessous, le dossier DocJoints est rajouté.

Vous pouvez choisir un dossier différent avec le bouton de navigation (…).

Vous pouvez récupérer les informations sur la dernière sauvegarde dans cette zone : la date de la dernière sauvegarde, la date de la prochaine sauvegarde, le nom de la dernière archive, le nom du fichier d'historique archivé et le statut du dernier backup.

Dans cette section, vous pouvez choisir d'utiliser un fichier d'historique. Ce fichier contient les changements faits aux données après une sauvegarde. Des actions telles que l'ajout, la modification, et la suppression des enregistrements sont enregistrées. Les transactions sont aussi enregistrées dans ce fichier.

La sauvegarde peut être démarrée manuellement, automatiquement, ou par programmation.

Manuellement▲

Vous pouvez créer une sauvegarde manuellement n'importe quand en cliquant sur l'élément de sauvegarde du menu Fichier du serveur 4D ou du menu Fichier dans l'environnement Utilisateur de 4e dimension comme montré ci-dessous :

Ceci affichera la fenêtre de sauvegarde :

Cliquez sur le bouton Sauvegarde qui lancera une sauvegarde avec les configurations courantes des Préférences. Le bouton Préférences… ouvre les préférences de la base de données qui peuvent être changées avant de commencer la sauvegarde.

Automatiquement▲

Vous pouvez automatiquement exécuter la sauvegarde sans intervention de l'utilisateur en indiquant fréquence de la sauvegarde dans la page des Préférences de sauvegarde comme montré ci-dessous.

Vous pouvez mettre en place une fréquence de sauvegarde toutes les heures, tous les jours, chaque semaine, certains jours, ou chaque mois. Pour désactiver ces options, vous devez sélectionner « Pas de sauvegarde automatique ». La sauvegarde sera lancée à l'heure et au jour indiqués. Comme montré dans le dialogue ci-dessus, la sauvegarde aura lieu à 2 heures du matin tous les Lundis, Mercredis et Samedis chaque semaine. Dans la section Paramètres généraux, comme vu précédemment, vous pouvez choisir de ne pas lancer de sauvegarde si aucune modification n'a été faite dans les données et ne lancer le backup qu'à la prochaine échéance.

Quand la base est créée pour la première fois, la sauvegarde automatique est choisie par défaut comme montré ci-dessous. Elle utilise les paramétrages par défaut. L'option doit être décochée avant de créer la base pour désactiver cette option :

Par programmation▲

Pour lancer la base exemple :
- L'Administrateur et les utilisateurs T1 et T2 n'ont pas de mot de passe
- Le mot de passe pour le Super_utilisateur est « x ».
- Sélectionnez « Lancez la sauvegarde » du menu « Sauvegarde ».

Les conditions pour que la sauvegarde se fasse sont les suivantes :
1. L'utilisateur courant doit être l'Administrateur ;
2. La précédente sauvegarde ne doit pas avoir été faite le même jour ;
3. Si le volume de destination de la sauvegarde est le même que celui de la structure, un message de confirmation est affiché, que l'utilisateur doit valider.

Si toutes ces conditions ne sont pas réunies, la sauvegarde ne se fera pas et une erreur sera affichée. Ci-dessous, voici un exemple sur la façon dont on peut contrôler la sauvegarde en utilisant par programmation les nouvelles commandes de sauvegarde. Des conditions comme montrées ci-dessous dans le code peuvent être vérifiées dans la méthode base Sur démarrage sauvegarde, quand la sauvegarde est exécutée avec la commande SAUVEGARDER. Vous pouvez passer une valeur autre que 0 au paramètre $0 pour renseigner chaque condition. Ces valeurs peuvent être vérifiées dans la méthode base Sur arrêt sauvegarde.

`Méthode base : Sur démarrage sauvegarde

`Conditions pour exécuter la sauvegarde :
```seul l'administrateur peut lancer la sauvegarde
```La sauvegarde ne sera pas exécutée si un backup a déjà été fait le même jour
```La destination de la sauvegarde est vérifiée. Si elle se fait sur le même volume que celui de la base,
````l'utilisateur est averti.
```Il peut alors choisir d'effectuer ou d'annuler la sauvegarde.

C_ENTIER(selector;$0)
C_TEXTE(Vol_Structure;Vol_BackupDestination;dest_path)

selector:=0
$0:=0

Si (Utilisateur courant="Administrateur") `la sauvegarde n'est autorisée que faite par l'Administrateur
   LIRE INFORMATION SAUVEGARDE(0;last_backupDate;last_backupTime)
   Si (last_BackupDate=Date du jour) `on ne lance la sauvegarde qu'un jour différent de la précédente
      $0:=3 `la sauvegarde a déjà été faite le même jour
   Sinon
      Vol_Structure:=ExtractVolume (Fichier structure) `on récupère le volume de la structure
      Vol_BackupDestination:=ExtractVolume (CheckDestination ) `on récupère le volume de la sauvegarde.
      Si (Vol_Structure=Vol_BackupDestination) ` si le volume de la sauvegarde est le même que
            `celui de la sauvegarde
         CONFIRMER("Êtes-vous sûr de vouloir lancer la sauvegarde sur le même volume ?";"Oui";"Non")
            ` on demande confirmation à l'utilisateur pour lancer ou pas la sauvegarde
         Si (OK#1) `si l'utilisateur ne veut pas lancer la sauvegarde
            $0:=2
         Fin de si
      Fin de si
   Fin de si
Sinon
   $0:=1 ` l'utilisateur n'est pas Administrateur
Fin de si

La valeur de la variable $0 de la méthode base Sur démarrage sauvegarde détermine si l'on autorise ou pas la sauvegarde. La sauvegarde est autorisée si $0 est égal à 0, sinon la sauvegarde est refusée. Dans la méthode ci-dessus, on vérifie d'abord l'utilisateur courant. Si l'utilisateur courant est administrateur, la date du jour est alors contrôlée avec la date de la dernière sauvegarde. Si la sauvegarde n'est pas été exécutée le même jour, le volume de sauvegarde est ensuite contrôlé avec l'emplacement actuel du fichier de structure. Si l'emplacement est sur un volume différent, la sauvegarde est exécutée. Autrement, un message est affiché alertant l'utilisateur et l'incitant à confirmer. La valeur assignée à $0 dépend des conditions rencontrées.

La valeur retournée dans le $0 de la méthode base Sur démarrage sauvegarde peut être donc vérifiée dans le $1 par la méthode base Sur arrêt sauvegarde. La variable $1 contiendra la valeur retournée par la méthode base Sur démarrage sauvegarde. Vous pouvez personnaliser le message de l'erreur renvoyée par ce paramètre. Vous pouvez utiliser la commande LIRE INFORMATION SAUVEGARDE pour vérifier l'erreur intervenue sur la sauvegarde. Comme le montre le code ci-dessous, si une des conditions à la sauvegarde est fausse, la sauvegarde ne se fait pas et le message d'erreur est affiché. Si l'erreur n'est pas relative aux conditions premières, un numéro d'erreur est renvoyé, avec sa description.

`Méthode base : Sur arrêt sauvegarde

C_ENTIER(error_num;$1)
C_TEXTE(error_desc)

Au cas ou
   : ($1=1)
      ALERTE("La sauvegarde n'a pas été effectuée, car l'Utilisateur courant n'est pas"+
                              " Administrateur.")
   : ($1=2)
      ALERTE("La sauvegarde n'a pas été effectuée, car vous avez choisi de ne pas la faire sur"+
                              " le même volume que votre base de données.")
   : ($1=3)
      ALERTE("La sauvegarde n'a pas été effectuée, car une précédente sauvegarde a été faite"+
                              " aujourd'hui.")
   : ($1=0)
      ALERTE("La sauvegarde s'est déroulée avec succès !")

   Sinon
      LIRE INFORMATION SAUVEGARDE(2;error_num;error_desc)
      ALERTE("Erreur : "+Chaine(error_num)+" - "+error_desc)

Fin de cas

Les configurations de la sauvegarde sont archivées dans un fichier XML (backup.xml). Les informations affichées dans les préférences sont, pour la plupart, prises dans ce fichier XML. Vous pouvez alors par programmation indiquer ou récupérer les configurations de sauvegarde en utilisant des commandes XML de 4D.

Dans la méthode base Sur démarrage sauvegarde, une méthode projet appelée CheckDestination récupère le chemin d'accès du dossier de destination à partir du fichier « Backup.xml ». Le code de cette méthode est donné ci-dessous. Dans la méthode, le fichier Backup.xml est d'abord analysé. Puis, l'élément <DestinationFolder> est localisé et sa valeur est retournée par la méthode :

   `Methode projet : CheckDestination

   `Description: renvoie le nom du dossier de destination de la sauvegarde (stocké dans le fichier Backup.xml).

C_TEXTE(Path_Structure;$0)
C_TEXTE(Path_Prefs;Path_Structure;Path_BackupXML)
C_TEXTE($elementRef1;$elementRef2)
C_ENTIER($separator;$StrPtr)
C_ENTIER($myPlatform;$mySystem;$myMachine)

PROPRIETES PLATE FORME($myPlatform;$mySystem;$myMachine)

Si ($myPlatform=Windows ) ` on vérifie la plateforme
   $separator:=Code ascii("\\")
Sinon
   $separator:=Code ascii(":")
Fin de si

Path_Structure:=Fichier structure ` chemin d'accès de la structure.
$StrPtr:=Longueur(Path_Structure) ` longueur du chemin d'accès

Tant que (Path_Structure[[$StrPtr]]#Caractere($separator))
      ` on part de la fin de la chaîne jusqu'à trouver le séparateur
   $StrPtr:=$StrPtr-1
Fin tant que

   ` on contruit le chemin d'accès au dossier "Preferences" qui contient le fichier "Backup.xml"
$var1:=Sous chaine(Path_Structure;1;$StrPtr) 
Path_Prefs:=$var1+"Preferences"
Path_BackupXML:=Path_Prefs+Caractere($separator)+"Backup"+Caractere($separator)+"Backup.xml"

   `Dans ce fichier, nous récupérons le volume de destination de la sauvegarde
$ref1:=DOM Analyser source XML(Path_BackupXML) 
$elementRef1:=DOM Chercher element XML($ref1;"/Preferences4D/Backup/Settings/General")

   ` on cherche l'élément Destination folder
$elementRef2:=DOM Chercher element XML($elementRef1;"/General/DestinationFolder")

DOM LIRE VALEUR ELEMENT XML($elementRef2;value) ` on récupère la valeur

DOM FERMER XML($ref1)

$0:=value ` on renvoie dans $0 le nom du dossier de destination.

Vous pouvez restaurer une sauvegarde manuellement en utilisant la section « Restituer une base » du dialogue d'ouverture de 4D ou 4D Server. Vous pouvez aussi le faire par programmation avec la commande RESTITUER.

Vous pouvez y sélectionner une archive « BaseDeDonnées[xxx].4BK » ou un fichier d'historique « BaseDeDonnées[xxx].4BL ». Le chemin d'accès au fichier de sauvegarde et son contenu sont affichés dans la partie droite de la page de restitution. Pour sélectionner un fichier d'historique ou une archive de ce fichier, vous devez les localiser en utilisant le bouton « Ouvrir… ». Lorsque vous cliquez sur le bouton « Restituer… », le dialogue de restauration, comme ci-dessous, est affiché. Vous pouvez modifier le dossier de destination des fichiers restitués et commencer la restitution en cliquant sur le bouton Restituer.

Après restitution de la base, un fichier d'historique peut être manuellement intégrée pour récupérer les modifications faites aux données depuis la dernière sauvegarde. Le fichier d'historique doit correspondre à l'archive de sauvegarde pour être lié à elle. Quand la sauvegarde est faite, le fichier courant d'historique est aussi archivé et il est vidé. Chaque changement fait aux données sera stocké dans le nouveau fichier d'historique courant. L'archive du précédent fichier d'historique peut être utilisée pour relier une sauvegarde faite précédemment, avec la dernière sauvegarde. Ci-dessous voici quelques scénarios pour illustrer cela :

Scénario 1▲

La sauvegarde est exécutée chaque jour. Mercredi, la base « crashe » et pour restaurer une sauvegarde faite le mardi et la mettre à jour, les différentes étapes sont les suivantes :

1 - La sauvegarde du mardi est restaurée ;

2 - Lorsque la base restaurée est lancée, un dialogue est affiché :

3 - Quand le bouton OK est cliqué, il propose un dialogue d'ouverture permettant de choisir le fichier d'historique courant et de l'intégrer. Ceci permettra de récupérer tous les changements fait entre la dernière sauvegarde et avant que la base « plante ».

Scénario 2▲

Vous pouvez restaurer automatiquement une sauvegarde quand un incident se produit sur la base, en choisissant les options de restauration dans la section correspondante :

« Intégrer le dernier historique si la base est incomplète » et « Lancer la base après la restitution automatique » sont des options sélectionnées par défaut. Vous pouvez choisir de repartir de la dernière sauvegarde si la base est endommagée.

Si l'option « Restituer la dernière sauvegarde si la base est endommagée » est sélectionnée, une restitution de la dernière sauvegarde est lancée automatiquement si un problème survient au lancement de la base. Et quand l'option « Lancer la base après la restitution automatique » est cochée, la base restaurée est automatiquement relancée. Ceci ne nécessite aucune intervention de l'utilisateur.

De plus, avec l'option « Intégrer le dernier historique si la base est incomplète » est sélectionnée, le fichier d'historique courant est automatiquement intégré quand la base est restaurée. Les opérations de sauvegarde sont stockées dans le « Journal des sauvegardes.txt » qui est habituellement au même niveau que la Structure.