INTEGRATE MIRROR LOG FILE

4D v15.4


INTEGRATE MIRROR LOG FILE ( rutaAcceso {; numOperacion} )

Parámetro	Tipo	Descripción
rutaAcceso	Texto	Nombre o ruta de acceso del archivo de historial a integrar
numOperacion	Real variable	Número de la última operación integrada
		Nuevo número de la última operación integrada

Descripción

Nota preliminar: este comando sólo funciona con 4D Server. Únicamente puede ejecutarse vía el comando Execute on server o en un procedimiento almacenado.

El INTEGRATE MIRROR LOG FILE integra el archivo de historial designado por rutaAcceso en una base 4D Server, a partir de la operación numOperacion (opcional).

El comando acepta integrar todo archivo de historial en la base, incluso si no corresponde al archivo de datos. Este comando está destinado específicamente para su uso en el contexto de una base espejo.

Nota: a partir de 4D v14, es posible utilizar un archivo de historial en el contexto de una base "espejo": la opción "Utilizar archivo de historial" ahora se puede seleccionar en las propiedades de la base 4D Server utilizada como espejo lógico, por tanto, permitiendo la implementación de una serie de servidores espejo en serie (ver la sección Configurar un espejo lógico en el manual 4D Server).

A diferencia del comando INTEGRATE LOG FILE, al final de su ejecución INTEGRATE MIRROR LOG FILE no sustituye el archivo de historial actual integrado al historial actual de la base: el archivo de historial de la base continua siendo utilizado. En consecuencia, cualquier cambio realizado durante la integración se guarda en el archivo de historial actual.

En rutaAcceso, pase una ruta absoluta o relativa a la carpeta de la base. Si pasa una cadena vacía en este parámetro, aparecerá una caja de diálogo estándar de apertura del archivo para que pueda designar el archivo a integrar. Si se cancela esta caja de diálogo, ningún archivo se integra y la variable sistema OK toma el valor 0.

Por defecto, cuando se omite el parámetro numOperacion, el comando integra todas las operaciones del archivo de historial.
Si pasa la variable numOperacion, la integración comienza en la operación cuyo número siga a la que la contiene. Después de la integración, el valor de la variable numOperacion, se actualiza con el número de la última operación integrada. Esto le permite seguir adelante con posteriores integraciones del archivo de historial, utilizando [#current_title].

El diagrama siguiente (pseudo código) detalla el proceso de integración dependiendo del caso. En el archivo de historial a integrar, X es el número de la primera operación y Y es el número de la última:

Case of
    : (operationNum < X-1)
                        --> Error 1260 (Selected log file is too recent)
    : (operationNum >= X-1) and (operationNum <= Y) 
                        --> Start integration
        Case of
            : (Type of operation = "Addition")
                If (Record exists)
                        --> Error
                Else
                        --> Add record
                End if
            : (Type of operation = "Modification")
                If (Record exists)
                        --> Edit record
                Else
                        --> Error
                End if
            : (Type of operation = "Deletion")
                If (Record exists)
                        --> Delete record
                Else
                        --> Error
                End if
            End case
        Else// operationNum > Y
                        --> Error 1261 (Selected log file is too old for database) 
End case

Tenga en cuenta que la integración se detendrá al primer error encontrado. En este caso, si desea continuar con la integración, tendrá que utilizar el CSM.

Variables y conjuntos del sistema

Si la integración se efectúa correctamente, la variable sistema OK toma el valor 1; de lo contrario, toma el valor 0.

Ver también

INTEGRATE LOG FILE