4D Doc Center : INTEGRER FICHIER HISTORIQUE

4D v14.3

INTEGRER FICHIER HISTORIQUE


INTEGRER FICHIER HISTORIQUE ( cheminAccès )

Paramètre	Type	Description
cheminAccès	Texte	Nom ou chemin d’accès du fichier d’historique à intégrer

Description

Note préliminaire : Cette commande ne fonctionne qu’avec 4D Server. Elle ne peut être exécutée que via la commande Executer sur serveur ou dans une procédure stockée.

La commande INTEGRER FICHIER HISTORIQUE provoque l’intégration dans la base courante du fichier d’historique dont le nom ou le chemin d’accès complet a été passé dans le paramètre cheminAccès. Cette commande est destinée à la mise en place d’un système de sauvegarde par miroir logique (cf. section Mise en place d'un miroir logique dans le Manuel de référence de 4D Server).

Seuls les fichiers d’historique non archivés (extension .journal) peuvent être intégrés par cette commande. Aucune boîte de dialogue n’apparaît, toutefois une barre de progression est affichée à l’écran.

Vous pouvez passer dans cheminAccès un chemin d’accès absolu ou relatif au dossier de la base. Si vous passez une chaîne vide dans ce paramètre, une boîte de dialogue standard d’ouverture de fichier s’affiche, permettant de désigner le fichier à intégrer. Si la boîte de dialogue est annulée, aucun fichier n’est intégré et la variable système OK prend la valeur 0.

Lors de l’utilisation de cette commande, il est du ressort du développeur :

d’installer la base miroir sur le poste miroir et de s’assurer que le fichier de données ne sera pas modifié autrement que par l’intégration d’un fichier d’historique via la commande INTEGRER FICHIER HISTORIQUE. Pour détecter qu’il s’agit de la version miroir de la base, il est possible de placer un fichier dans le dossier de la base et de tester sa présence par exemple au cours de la Méthode base Sur ouverture. Si le fichier est présent, le mode miroir est activé.
de mettre en place un système de communication entre la base en exploitation et la base miroir afin d’organiser l’envoi et la réception des segments de fichier d’historique. Il est possible d’utiliser pour cela un Web service ou 4D Internet Commands.
de gérer les éventuelles erreurs de transmission entre les deux bases.

Variables et ensembles système

Si l'intégration s'effectue correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0.

Gestion des erreurs

En cas d'anomalie, la commande génère une erreur que vous pouvez intercepter à l’aide de la commande APPELER SUR ERREUR. Si au moins un enregistrement est verrouillé dans la base, la commande ne fait rien et l’erreur 1420 est générée.