4D Doc Center : INTEGRER FICHIER HISTORIQUE MIROIR

4D v14.3

INTEGRER FICHIER HISTORIQUE MIROIR


INTEGRER FICHIER HISTORIQUE MIROIR ( 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 d’opération auquel commencer l’intégration
		Numéro de la dernière opération intégrée

Description

La commande INTEGRER FICHIER HISTORIQUE MIROIR permet d’intégrer le fichier d’historique désigné par cheminAccès dans une base 4D Server, à compter 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.

A la différence de la commande INTEGRER FICHIER HISTORIQUE, la commande INTEGRER FICHIER HISTORIQUE MIROIR 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 le paramètre numOpération, l’intégration débute à la valeur définie. A l’issue de l’intégration, si vous avez utilisé une variable pour numOpération, le paramètre contient le numéro de la dernière opération intégrée. Ce principe vous permet d’enchaîner les intégrations d’historiques en passant directement la valeur retournée dans numOpération lors de l’appel suivant à INTEGRER FICHIER HISTORIQUE MIROIR.

Le diagramme suivant (pseudo code) détaille le processus d’intégation 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)
                        --> Ne rien faire
                Sinon
                        --> Ajout de l’enregistrement
                Fin de si
            : (Type de l’opération = "Modification")
                Si (L’enregistrement existe)
                        --> Modification de l’enregistrement
                Sinon
                        --> Ne rien faire
                Fin de si
            : (Type de l’opération = "Suppression")
                Si (L’enregistrement existe)
                        --> Suppression de l’enregistrement
                Sinon
                        --> Ne rien faire
                Fin de si
            Fin de cas
        Sinon // numOpération > Y
                        --> Erreur 1261 (fichier d’historique trop ancien)
Fin de cas

A 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.

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.