|
|
|
|
|
|
|
|
|
version 6.0
bk_OUVRIR PROJET (nomProjet)
| Paramètre | Type | Description | |
| nomProjet | Alpha |  | Nom du projet à ouvrir |
Description
La commande bk_OUVRIR PROJET ouvre le document dont le nom est spécifié par nomProjet. Ce document doit être un projet généré par 4D Backup, soit directement depuis l'interface de 4D Backup, soit par la commande bk_SAUVER PROJET.
Vous pouvez donner soit directement le nom du document (par exemple "Sauvquot.4BP" sous Windows ou "Sauvegarde quotidienne" sous MacOS) si le projet se trouve dans le dossier de la base, soit le nom précédé du chemin d'accès complet ("C:\Dossier\Sauvquot.4BP"sous Windows ou "Disque Dur:Dossier:Sauvegarde quotidienne" sous MacOS).
La fonction bk_Lire erreur vous permettra de gérer les éventuelles erreurs liées au projet à ouvrir.
Si vous appelez la fonction bk_Lire erreur après avoir appelé la commande bk_OUVRIR PROJET, vous récupérerez les valeurs suivantes :
• 0 (pas d'erreur) : l'ouverture du document s'est bien passée.
• 1101 : Mauvais projet. Le projet ne correspond pas à la base ouverte (il a été construit avec une autre base, et ne peut s'appliquer à celle actuellement ouverte).
• 1102 : Pas un projet. le document ouvert n'est pas un projet (il s'agit d'un autre type de document, qui n'a donc pu être ouvert en tant que projet).
• Numéro d'erreur négatif : l'erreur provient du système d'exploitation.
Note : La liste complète des codes d'erreurs est fournie à l'Annexe A, Codes d'erreurs de 4D Backup.
Une autre fonction de 4D Backup, bk_Lire etat, vous permet quant à elle de gérer plus précisément les erreurs liées aux volumes décrits dans le fichier projet. Après l'appel à bk_OUVRIR PROJET, voici les différents "états" possibles retournés par la fonction bk_Lire etat :
• Si le volume sélectionné dans le projet n'est plus présent, l'état vaudra 1 ("Pas de disque sélectionné").
• Si le volume ne contient par exemple pas la place nécessaire à la copie, l'état vaudra 2 ("Impossible d'utiliser ce disque").
• Si la sauvegarde est prête à démarrer, bk_Lire etat retournera 3 ("Prêt à copier").
Dans les deux premiers cas, il vous faudra soit gérer la recherche d'un volume disponible d'une taille suffisante, soit avertir l'utilisateur de l'incident et abandonner la sauvegarde (par la commande bk_FIN SAUVEGARDE) puis lui proposer par exemple la fenêtre standard de sauvegarde intégrale.
Note 4D Server : Le projet sera lu sur le poste serveur (et non depuis un poste client). Le nom et le chemin d'accès s'appliqueront donc à un projet placé sur un disque du poste serveur ou sur un volume partagé accessible depuis le poste serveur.
Exemple
Imaginez que vous ayez 7 projets de sauvegarde différents correspondant aux 7 jours de la semaine, pour répartir les sauvegardes chaque jour sur des disques différents, et profiter du week-end pour sauvegarder un grand nombre de fichiers joints.
Les projets s'appellent "Jour1" sous MacOS ("Jour1.4BP" sous Windows), "Jour2"... "Jour7", et se trouvent dans le même répertoire que les données de la base. Ils ont été réalisés depuis la fenêtre standard de sauvegarde de 4D Backup (rappelons que pour 4e Dimension, dimanche=1, lundi=2... samedi=7).
C_ENTIER($Erreur)
Si(bk_Debut sauvegarde integrale#0)
ALERTE("Impossible de démarrer la sauvegarde")
Sinon
bk_OUVRIR PROJET("Jour"+Chaine(Numero du jour(Date du jour)))
$Erreur:=bk_Lire erreur
Si($Erreur#0) `Si une erreur survient
ALERTE("Erreur lors de l'ouverture du projet : "+bk_Erreur texte($Erreur))
Sinon
Si(bk_Lire etat#3) `Si l'état est différent de "Prêt à copier"
ALERTE("Le projet n'est plus valide. La base n'a pu être sauvegardée.")
Sinon
Si(bk_Lancer copie=0) `Si le démarrage de la copie s'est bien passé
Repeter
Jusque (bk_Lire etat#4) `Attente de la fin de la copie
Fin de si
Fin de si
Fin de si
bk_FIN SAUVEGARDE
Fin de si
Référence
bk_Erreur texte, bk_Lire erreur, bk_Lire etat, bk_SAUVER PROJET.
|
|
|
|
|
|
|
|
|