Structure des instructions

version 6.0

Nous attirons votre attention sur la structure particulière des commandes de 4D Backup, qui pilotent en fait une tâche de fond, un process, interne à 4D. Cette tâche de fond doit être explicitement activée pour exécuter les instructions de 4D Backup. En d'autres termes, la plupart des routines de 4D Backup ne fonctionnent que si le process de 4D Backup a été lancé puis refermé.

Pour lancer le process de sauvegarde, vous disposez de deux routines :

• bk_Debut sauvegarde integrale pour la sauvegarde intégrale,

• bk_Debut mise a jour miroir pour la mise à jour d'un miroir logique.

Ces fonctions ne déclenchent pas la sauvegarde de la base ni la mise à jour du poste miroir, elles ouvrent le process de 4D Backup permettant de réaliser ces opérations, ainsi que les autres fonctionnalités offertes par le langage de 4D Backup.

Note : La sauvegarde étant donc elle-même un process interne à 4e Dimension, l'envoi des données s'effectuant également dans un process, nous vous conseillons de lire les chapitres de la documentation de 4e Dimension consacrés au multiprocess avant d'entreprendre la lecture de ce manuel.

Une fois le process de sauvegarde ouvert par l'une des deux fonctions décrites ci-dessus, toute opération de sauvegarde (sauvegarde intégrale ou mise à jour d'un miroir par envoi du fichier d'historique) sera déclenchée par la fonction bk_Lancer copie. Cette fonction se trouve dans le chapitre "BK Exécution".

Après avoir lancé la copie, cette fonction vous rendra immédiatement la main, et il vous appartiendra d'attendre que la copie soit terminée dans son process, en l'interrogeant périodiquement à l'aide de la fonction bk_Lire etat. Cette fonction renvoie en effet la valeur 4 lorsque la copie est en cours. Typiquement, vos méthodes de sauvegarde et de mise à jour d'un miroir comporteront donc les instructions suivantes :

   ... 
   $vBackup:=bk_Lancer copie
   Repeter
   Jusque (bk_Lire etat#4)
   ...

Le process de sauvegarde exerce un certain nombre de contrôles sur la base, comme par exemple le verrouillage en écriture lors d'une sauvegarde intégrale. Il doit donc être fermé lorsque les opérations sont terminées afin, en particulier, de libérer la base en écriture.

Pour cela, utilisez la commande bk_FIN SAUVEGARDE, qui valide puis ferme le process de sauvegarde.

Note aux utilisateurs de 4e Dimension monoposte : Si vous omettez la commande bk_FIN SAUVEGARDE à la fin d'une méthode de sauvegarde, la base restera bloquée. Dans ce cas, maintenez pendant quelques secondes la combinaison de touches Alt+Majuscule+Clic bouton droit (sous Windows) ou Contrôle+Option+Majuscule+Clic (sous MacOS) qui vous permet, en cas de nécessité, de "tuer" manuellement le process de sauvegarde.

Note aux utilisateurs de 4D Server : Les commandes du langage de 4D Backup ne fonctionnent PAS dans le cadre des procédures stockées sur le serveur.

Quatre routines de 4D Backup ne nécessitent ni ouverture ni fermeture explicites du process de sauvegarde (elles gèrent elles-mêmes l'ouverture et la fermeture de ce process) :

• bk_FENETRE MISE A JOUR MIROIR et bk_FENETRE SAUVEGARDE INTEGRALE (chapitre "BK Dialogues standard"). Ces commandes font apparaître les boîtes de dialogue de paramétrage de sauvegarde intégrale et de mise à jour du miroir, de la même manière que les commandes du menu Plug-Ins.

• bk_Mise a jour miroir (chapitre "BK Miroir logique") et bk_Sauvegarde integrale (chapitre "BK Exécution"). Ces fonctions déclenchent immédiatement les opérations correspondantes, à partir d'un projet par défaut se trouvant dans le répertoire de la base.