4D v15.4
INTEGRATE MIRROR LOG FILE
INTEGRATE MIRROR LOG FILE
| INTEGRATE MIRROR LOG FILE ( cheminAccès {; numOpération} ) | ||||||||
| Paramètre | Type | Description | ||||||
| cheminAccès | Texte |
|
Nom ou chemin d’accès du fichier d’historique à intégrer | |||||
| numOpération | Variable réel |
|
Numéro de la dernière opération intégrée | |||||
|
Nouveau numéro de la dernière opération intégrée | |||||||
Note préliminaire : Cette commande ne fonctionne qu’avec 4D Server. Elle ne peut être exécutée que via la commande Execute on server ou dans une procédure stockée.
La commande INTEGRATE MIRROR LOG FILE permet d’intégrer le fichier d’historique désigné par cheminAccès dans une base 4D Server, à la suite de l’opération numOpération (optionnel). La commande accepte d’intégrer tout fichier d’historique dans la base, même s’il ne correspond pas au fichier de données. Cette commande est particulièrement destinée à une utilisation dans le contexte d’une base miroir.
Note : A compter de 4D v14, il est possible d’utiliser un fichier d’historique dans le contexte d’une base miroir : l’option "Utiliser fichier d’historique" peut désormais être cochée dans les propriétés d’une base 4D Server utilisée comme miroir logique, permettant la mise en place de serveurs miroirs en série (cf. section Mise en place d'un miroir logique dans le manuel de 4D Server).
A la différence de la commande INTEGRATE LOG FILE, la commande INTEGRATE MIRROR LOG FILE ne substitue pas le fichier d’historique intégré à l’historique courant à l’issue de son exécution : le fichier d’historique de la base continue d’être utilisé. Par conséquent, les modifications effectuées lors de l’intégration sont enregistrées dans le fichier d’historique courant.
Passez 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.
Par défaut, si vous omettez le paramètre numOpération, la commande intègre la totalité des opérations du fichier d’historique.
Si vous passez la variable numOpération, l’intégration débute à l'opération dont le numéro suit celui qu'elle contient. A l’issue de l’intégration, la valeur de la variable numOpération est mise à jour avec le numéro de la dernière opération intégrée. Vous devez alors stocker cette variable puis la réutiliser comme paramètre numOpération lors de l'opération d'intégration suivante. Ce principe vous permet d’enchaîner les intégrations d’historiques à l'aide de INTEGRATE MIRROR LOG FILE.
Le diagramme suivant (pseudo code) détaille le processus d’intégration en fonction des cas. Dans le fichier d’historique à intégrer, X est le numéro de la première opération et Y celui de la dernière opération :
Au cas ou
: (numOpération < X-1)
--> Erreur 1260 (fichier d’historique trop récent)
: (numOpération >= X-1) et (numOpération <= Y)
--> Démarrage de l’intégration
Au cas ou
: (Type de l’opération = "Addition")
Si (L’enregistrement existe)
--> Erreur
Sinon
--> Ajout de l’enregistrement
Fin de si
: (Type de l’opération = "Modification")
Si (L’enregistrement existe)
--> Modification de l’enregistrement
Sinon
--> Erreur
Fin de si
: (Type de l’opération = "Suppression")
Si (L’enregistrement existe)
--> Suppression de l’enregistrement
Sinon
--> Erreur
Fin de si
Fin de cas
Sinon // numOpération > Y
--> Erreur 1261 (fichier d’historique trop ancien)
Fin de casA noter que l’intégration stoppera à la première erreur rencontrée. Si vous souhaitez poursuivre l’intégration dans ce cas, il sera nécessaire d’utiliser le CSM.
Si l'intégration s'effectue correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0.
Produit : 4D
Thème : Sauvegarde
Numéro :
1312
Créé : 4D v14
4D - Langage ( 4D v15.4)
4D - Langage ( 4D v15)
4D - Langage ( 4D v15.3)
