Saltar al contenido principal
Versión: v19

DataStore

Un Datastore es el objeto de interfaz suministrado por ORDA para referenciar y acceder a una base de datos. Los objetos Datastore son devueltos por los siguientes comandos:

  • ds: un acceso directo al almacén de datos principal
  • Open datastore: para abrir todo almacén de datos remoto

Resumen

.cancelTransaction()    cancela la transacción
.dataclassName : 4D.DataClass    contiene una descripción de la dataclass
.encryptionStatus(): Object    devuelve un objeto que indica el estado de encriptación del archivo de datos actual
.getInfo(): Object    The .getInfo() function
.getRequestLog() : Collection    devuelve las peticiones ORDA registradas en memoria del lado del cliente
.makeSelectionsAlterable()    define todas las selecciones de entidades como alterables por defecto en los almacenes de datos de la aplicación actual
.provideDataKey( curPassPhrase : Text ) : Object
.provideDataKey( curDataKey : Object ) : Object
    permite proveer una llave de encriptación de datos para el archivo de datos actual del datastore y detecta si la llave coincide con los datos encriptados
.setAdminProtection( status : Boolean )    permite desactivar todo acceso a los datos en el puerto de administración web, incluso para el Explorador de datos en las sesiones WebAdmin
.startRequestLog()
.startRequestLog( file : 4D.File )
.startRequestLog( reqNum : Integer )
    inicia el registro de peticiones ORDA del lado del cliente
.startTransaction()    inicia una transacción en el proceso actual en la base de datos que coincide con el almacén de datos al que se aplica
.stopRequestLog()     detine el registro de peticiones ORDA del lado del cliente
.validateTransaction()     acepta la transacción

ds

Histórico
VersiónModificaciones
v18Soporte del parámetro localID
v17Añadidos

ds { ( localID : Text ) } : cs.DataStore

ParámetrosTipoDescripción
localIDText->ID local del almacén de datos remoto a devolver
Resultcs.DataStore<-Referencia al almacén de datos

|

Descripción

El comando ds devuelve una referencia al almacén de datos que coincide con la base de datos 4D actual o con la base de datos designada por localID.

Si se omite el parámetro localID (o se pasa una cadena vacía ""), el comando devuelve una referencia al almacén de datos que coincide con la base de datos local de 4D (o la base de datos de 4D Server en caso de abrir una base de datos remota en 4D Server). El almacén de datos se abre automáticamente y está disponible directamente a través de ds.

También puede obtener una referencia en un datastore remoto abierto pasando su id local en el parámetro localID. El almacén de datos debe haber sido abierto previamente con el comando Open datastore por la base de datos actual (local o componente). La identificación local se define cuando se utiliza este comando.

El alcance del id local es la base de datos en la que se ha abierto el almacén de datos.

Si no se encuentra ningún almacén de datos localID, el comando devuelve Null.

El uso de ds requiere que la base de datos de destino sea compatible con ORDA, como se especifica en la sección Requisitos previos de ORDA. Se aplican las siguientes reglas:

  • Un datastore sólo hace referencia a las tablas con una sola llave primaria. A datastore only references tables with a single primary key.
  • Los atributos de tipo BLOB no se gestionan en el almacén de datos.

Ejemplo 1

Utilizando el almacén de datos principal de la base 4D:

 $result:=ds.Employee.query("firstName = :1";"S@")

Ejemplo 2

 var $connectTo; $firstFrench; $firstForeign : Object

var $frenchStudents; $foreignStudents : cs.DataStore

$connectTo:=New object("type";"4D Server";"hostname";"192.168.18.11:8044")
$frenchStudents:=Open datastore($connectTo;"french")

$connectTo.hostname:="192.168.18.11:8050"
$foreignStudents:=Open datastore($connectTo;"foreign")
//...
//...
$firstFrench:=getFirst("french";"Students")
$firstForeign:=getFirst("foreign";"Students")
  //getFirst method
//getFirst(localID;dataclass) -> entity
#DECLARE( $localId : Text; $dataClassName : Text ) -> $entity : 4D.Entity

$0:=ds($localId)[$dataClassName].all().first()

Open datastore

Histórico
VersiónModificaciones
v18Añadidos

Open datastore( connectionInfo : Object ; localID : Text ) : cs.DataStore

ParámetrosTipoDescripción
connectionInfoObject->Propiedades de conexión utilizadas para alcanzar el almacén de datos remoto
localIDText->Id para asignar al almacén de datos abierto en la aplicación local (obligatorio)
Resultcs.DataStore<-Objeto del almacén de datos

|

Descripción

El comando Open datastore conecta la aplicación a la base de datos 4D identificada por el parámetro connectionInfo y devuelve un objeto cs.DataStore coincidente asociado al alias local localID.

La base de datos connectionInfo 4D debe estar disponible como almacén de datos remoto, es decir:

  • su servidor web debe ser lanzado con http y/o https activado,
  • su opción Exponer como servidor REST debe estar marcada,
  • se dispone de al menos una licencia cliente.

Si no se encuentra ninguna base de datos coincidente, Open datastore devuelve Null.

localID es un alias local para la sesión abierta en el almacén de datos remoto. Si localID ya existe en la aplicación, se utiliza. En caso contrario, se crea una nueva sesión localID cuando se utiliza el objeto datastore.

Una vez abierta la sesión, las siguientes sentencias son equivalentes y devuelven una referencia sobre el mismo objeto datastore:

 $myds:=Open datastore(connectionInfo;"myLocalId")
$myds2:=ds("myLocalId")
//$myds y $myds2 son equivalentes

Pase en connectionInfo un objeto que describa el almacén de datos remoto al que desea conectarse. Puede contener las siguientes propiedades (todas las propiedades son opcionales excepto hostname):

PropiedadTipoDescripción
hostnameTextNombre o dirección IP de la base de datos remota + ":" + número de puerto (el número de puerto es obligatorio)
userTextNombre de usuario
contraseñaTextContraseña del usuario
idleTimeoutLongintTiempo de espera de la sesión de inactividad (en minutos), después del cual la sesión es cerrada automáticamente por 4D. Si se omite, el valor por defecto es 60 (1h). El valor no puede ser < 60 (si se pasa un valor inferior, el tiempo de espera se establece en 60). Para más información, consulte Cierre de sesiones.
tlsBooleanUtilice una conexión segura(*). Si se omite, es false por defecto. Se recomienda utilizar una conexión segura siempre que sea posible.
typeTextDebe ser "4D Server"

(*) Si tls es true, se utiliza el protocolo HTTPS si:

  • HTTPS está activado en el almacén de datos remoto
  • el número de puerto especificado coincide con el puerto HTTPS configurado en los ajustes de la base de datos
  • un certificado válido y una llave privada de encriptación están instalados en la base de datos. En caso contrario, se produce el error "1610 - Una solicitud remota al host xxx ha fallado"

Ejemplo 1

Conexión a un almacén de datos remoto sin usuario/contraseña:

 var $connectTo : Object
var $remoteDS : cs.DataStore
$connectTo:=New object("type";"4D Server";"hostname";"192.168.18.11:8044")
$remoteDS:=Open datastore($connectTo;"students")
ALERT("This remote datastore contains "+String($remoteDS.Students.all().length)+" students")

Ejemplo 2

Conexión a un almacén de datos remoto con usuario/contraseña/ timeout / tls:

 var $connectTo : Object
var $remoteDS : cs.DataStore
$connectTo:=New object("type";"4D Server";"hostname";\"192.168.18.11:4443";\
"user";"marie";"password";$pwd;"idleTimeout";70;"tls";True)
$remoteDS:=Open datastore($connectTo;"students")
ALERT("This remote datastore contains "+String($remoteDS.Students.all().length)+" students")

Ejemplo 3

Trabajar con varios almacenes de datos remotos:

 var $connectTo : Object
var $frenchStudents; $foreignStudents : cs.DataStore
$connectTo:=New object("hostname";"192.168.18.11:8044")
$frenchStudents:=Open datastore($connectTo;"french")
$connectTo.hostname:="192.168.18.11:8050"
$foreignStudents:=Open datastore($connectTo;"foreign")
ALERT("They are "+String($frenchStudents.Students.all().length)+" French students")
ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign students")

Gestión de errores

En caso de error, el comando devuelve Null. Si no se puede acceder al almacén de datos remoto (dirección incorrecta, servidor web no iniciado, http y https no habilitados...), se produce el error 1610 "Ha fallado una petición remota al host XXX". Puede interceptar este error con un método instalado por ON ERR CALL.

.dataclassName

Histórico
VersiónModificaciones
v17Añadidos

.dataclassName : 4D.DataClass

Descripción

Cada clase de datos de un almacén de datos está disponible como una propiedad del objeto DataStoredata. El objeto devuelto contiene una descripción de la dataclass.

Ejemplo

 var $emp : cs.Employee
var $sel : cs.EmployeeSelection
$emp:=ds.Employee //$emp contiene la dataclass Employee
$sel:=$emp.all() //obtiene una selección de entidades de todos los empleados

//también puede escribir directamente:
$sel:=ds.Employee.all()

.cancelTransaction()

Histórico
VersiónModificaciones
v18Añadidos

.cancelTransaction()

ParámetrosTipoDescripción
No requiere ningún parámetro

|

Descripción

La función .cancelTransaction() cancela la transacción abierto por la función .startTransaction() en el nivel correspondiente del proceso actual para el almacén de datos especificado.

La función .cancelTransaction() cancela cualquier cambio realizado en los datos durante la transacción.

Puede anidar varias transacciones (subtransacciones). Si se cancela la transacción principal, también se cancelan todas sus subtransacciones, aunque se hayan validado individualmente mediante la función .validateTransaction().

Ejemplo

Ver el ejemplo de la función .startTransaction().

.encryptionStatus()

Histórico
VersiónModificaciones
v17 R5Añadidos

.encryptionStatus(): Object

ParámetrosTipoDescripción
ResultObject<-Información sobre el cifrado del almacén de datos actual y de cada tabla

|

Descripción

La función .encryptionStatus() devuelve un objeto que indica el estado de encriptación del archivo de datos actual (es decir, el archivo de datos del almacén de datos ds). También se proporciona el estado de cada tabla.

Utilice el comando Data file encryption status para determinar el estado de encriptación de cualquier otro archivo de datos.

Valor devuelto

El objeto devuelto contiene las siguientes propiedades:

PropiedadTipoDescripción
isEncryptedBooleanTrue si el archivo de datos está encriptado
keyProvidedBooleanTrue si se proporciona la llave de encriptación que coincide con el archivo de datos encriptados(*).
tablasObjectObjeto que contiene tantas propiedades como tablas encriptadas o codificadas.
tableNameObjectTabla encriptada o cifrada
nameTextNombre de la tabla
numNumberNúmero de tabla
isEncryptableBooleanVerdadero si la tabla está declarada como encriptada en el archivo de estructura
isEncryptedBooleanTrue si los registros de la tabla están encriptados en el archivo de datos

(*) Se puede suministrar la llave de encriptación:

  • con el comando .provideDataKey(),
  • en la raíz de un dispositivo conectado antes de abrir el almacén de datos,
  • con el comando Discover data key.

Ejemplo

Quiere saber el número de tablas encriptadas en el archivo de datos actual:

 var $status : Object

$status:=dataStore.encryptionStatus()

If($status.isEncrypted) //the database is encrypted
C_LONGINT($vcount)
C_TEXT($tabName)
For each($tabName;$status.tables)
If($status.tables[$tabName].isEncrypted)
$vcount:=$vcount+1
End if
End for each
ALERT(String($vcount)+" encrypted table(s) in this datastore.")
Else
ALERT("This database is not encrypted.")
End if
Else
ALERT("This database is not encrypted.")
End if

.getInfo()

Histórico
VersiónModificaciones
v17Añadidos

.getInfo(): Object

ParámetrosTipoDescripción
ResultObject<-Propiedades del almacén de datos

|

Descripción

La función .getInfo() The .getInfo() function. Esta función es útil para configurar el código genérico.

Objeto devuelto

PropiedadTipoDescripción
typestring
  • "4D": almacén de datos principal, disponible a través de ds
  • "4D Server": almacén de datos remoto, abierto con Open datastore
  • networkedboolean
  • True: el almacén de datos se alcanza a través de una conexión de red.
  • False: no se llega al almacén de datos a través de una conexión de red (base de datos local)
  • localIDtextID del almacén de datos en la máquina. Corresponde a la cadena localId dada con el comando Open datastore. Cadena vacía ("") para el almacén de datos principal.
    connectionobjectObjeto que describe la conexión del almacén de datos remoto (no se devuelve para el almacén de datos principal). Propiedades disponibles:
    PropiedadTipoDescripción
    hostnametextDirección IP o nombre del datastore remoto + ":" + número de puerto
    tlsbooleanTrue si se utiliza una conexión segura con el almacén de datos remoto
    idleTimeoutnumberTiempo de inactividad de la sesión (en minutos)
    usertextUsuario autentificado en el almacén de datos remoto
    • Si la función .getInfo() se ejecuta en un 4D Server o 4D monopuesto, networked es False.
    • Si la función .getInfo() se ejecuta en un 4D remoto, networked es True

    Ejemplo 1

     var $info : Object

    $info:=ds.getInfo() //Ejecutado en 4D Server o 4D
    //{"type":"4D","networked":false,"localID":""}

    $info:=ds.getInfo() // Ejecutado en 4D remoto
    //{"type":"4D","networked":true,"localID":""}

    Ejemplo 2

    En un almacén de datos remoto:

      var $remoteDS : cs.DataStore
    var $info; $connectTo : Object

    $connectTo:=New object("hostname";"111.222.33.44:8044";"user";"marie";"password";"aaaa")
    $remoteDS:=Open datastore($connectTo;"students")
    $info:=$remoteDS.getInfo()

    //{"type":"4D Server",
    //"localID":"students",
    //"networked":true,
    //"connection":{hostname:"111.222.33.44:8044","tls":false,"idleTimeout":2880,"user":"marie"}}

    .getRequestLog()

    Histórico
    VersiónModificaciones
    v17 R6Añadidos

    .getRequestLog() : Collection

    ParámetrosTipoDescripción
    ResultCollection<-Colección de objetos, donde cada objeto describe una petición

    |

    Descripción

    La función .getRequestLog() devuelve las peticiones ORDA registradas en memoria del lado del cliente. .

    Esta función debe ser llamada en un 4D remoto, de lo contrario devuelve una colección vacía. Está diseñado para fines de depuración en configuraciones cliente/servidor.

    Valor devuelto

    Colección de objetos de petición apilados. La solicitud más reciente tiene el índice 0.

    Para una descripción del formato del registro de peticiones de ORDA, consulte la sección Preguntas cliente ORDA.

    Ejemplo

    Ver el ejemplo 2 de .startRequestLog().

    .isAdminProtected()

    Histórico
    VersiónModificaciones
    v18 R6Añadidos

    .isAdminProtected() : Boolean

    ParámetrosTipoDescripción
    ResultBoolean<-True si el acceso al Explorador de Datos está desactivado, False si está activado (por defecto)

    |

    Descripción

    La función .isAdminProtected() devuelve True si el acceso al Explorador de Datos se ha deshabilitado para la sesión de trabajo.

    Por defecto, el acceso al Explorador de Datos se concede para las sesiones webAdmin, pero se puede desactivar para evitar cualquier acceso a los datos por parte de los administradores (ver la función .setAdminProtection()).

    Ver también

    .setAdminProtection()

    .makeSelectionsAlterable()

    Histórico
    VersiónModificaciones
    v18 R5Añadidos

    .makeSelectionsAlterable()

    ParámetrosTipoDescripción
    No requiere ningún parámetro

    |

    Descripción

    La función .makeSelectionsAlterable() define todas las selecciones de entidades como alterables por defecto en los almacenes de datos de la aplicación actual (incluyendo datastores remotas). Está pensado para ser utilizado una vez, por ejemplo en el método base On Startup.

    Cuando no se llama a esta función, las nuevas selecciones de entidades pueden ser compartibles, dependiendo de la naturaleza de su "padre", o de cómo se crean.

    Esta función no modifica las selecciones de entidades creadas por .copy() o OB Copy cuando se utiliza la opción explícita ck shared.

    Compatibilidad: esta función sólo debe utilizarse en proyectos convertidos desde versiones de 4D anteriores a 4D v18 R5 y que contengan llamadas .add(). En este contexto, el uso de .makeSelectionsAlterable() puede ahorrar tiempo al restaurar instantáneamente el comportamiento anterior de 4D en los proyectos existentes. Por otro lado, utilizar este método en proyectos nuevos creados en 4D v18 R5 y superiores no es recomendable, ya que impide compartir las selecciones de entidades, lo que ofrece mayor rendimiento y escalabilidad.

    .provideDataKey()

    Histórico
    VersiónModificaciones
    v17 R5Añadidos

    .provideDataKey( curPassPhrase : Text ) : Object
    .provideDataKey( curDataKey : Object ) : Object

    ParámetrosTipoDescripción
    curPassPhraseText->Frase de cifrado actual
    curDataKeyObject->Llave de encriptación de datos actual
    ResultObject<-Resultado de la coincidencia de la llave de encriptación

    |

    Descripción

    La función .provideDataKey() permite proveer una llave de encriptación de datos para el archivo de datos actual del datastore y detecta si la llave coincide con los datos encriptados. Esta función se puede utilizar al abrir una base encriptada, o al ejecutar cualquier operación de encriptación que requiera la llave de encriptación, como por ejemplo volver a encriptar el archivo de datos.

    • La función .provideDataKey() debe ser llamada en una base de datos encriptada. Si se llama en una base no cifrada, se devuelve el error 2003 (la llave de cifrado no coincide con los datos.). Utilice el comando Estado de cifrado del archivo de datos para determinar si la base de datos está cifrada.
    • La función .provideDataKey() no puede ser llamada desde un 4D remoto o un datastore remoto encriptado.

    Si utiliza el parámetro curPassPhrase, pase la cadena utilizada para generar la llave de cifrado de datos. Cuando se utiliza este parámetro, se genera una llave de encriptación.

    Si utiliza el parámetro curDataKey, pase un objeto (con la propiedad encodedKey) que contenga la llave de cifrado de los datos. Esta llave puede haber sido generada con el comando New data key.

    Si se aporta una llave de cifrado de datos válida, se añade a la keyChain de la memoria y se activa el modo de cifrado:

    • todas las modificaciones de datos en las tablas encriptadas se cifran en el disco (.4DD, .journal. 4Dindx)
    • todos los datos cargados desde tablas encriptadas se descifran en memoria

    Result

    El resultado de la orden se describe en el objeto devuelto:

    PropiedadTipoDescripción
    successBooleanTrue si la llave de encriptación proporcionada coincide con los datos encriptados, False en caso contrario
    Las siguientes propiedades se devuelven sólo si success es FALSE
    statusNumberCódigo de error (4 si la llave de encriptación suministrada es errónea)
    statusTextTextMensaje de error
    errorsCollectionPila de errores. El primer error tiene el índice más alto
    [ ].componentSignatureTextNombre del componente interno
    [ ].errCodeNumberNúmero de error
    [ ].messageTextMensaje de error

    Si no se da curPassphrase o curDataKey, .provideDataKey() devuelve null (no se genera ningún error).

    Ejemplo

     var $keyStatus : Object
    var $passphrase : Text

    $passphrase:=Request("Enter the passphrase")
    If(OK=1)
    $keyStatus:=ds.provideDataKey($passphrase)
    If($keyStatus.success)
    ALERT("You have provided a valid encryption key")
    Else
    ALERT("You have provided an invalid encryption key, you will not be able to work with encrypted data")
    End if
    End if

    .setAdminProtection()

    Histórico
    VersiónModificaciones
    v18 R6Añadidos

    .setAdminProtection( status : Boolean )

    ParámetrosTipoDescripción
    statusBoolean->True para desactivar el acceso Data Explorer a los datos del puerto webAdmin, False (por defecto) para otorgar el acceso

    |

    Descripción

    La función .setAdminProtection() permite desactivar todo acceso a los datos en el puerto de administración web, incluso para el Explorador de datos en las sesiones WebAdmin.

    Por defecto, cuando no se llama a la función, el acceso a los datos se concede siempre en el puerto de administración web para una sesión con privilegio WebAdmin utilizando el Explorador de Datos. En algunas configuraciones, por ejemplo, cuando el servidor de aplicaciones está alojado en una máquina de terceros, es posible que no desee que el administrador pueda ver sus datos, aunque puede editar la configuración del servidor, incluyendo la configuración de la access key.

    En este caso, puede llamar a esta función para deshabilitar el acceso a los datos del Explorador de Datos en el puerto de administración web de la máquina, incluso si la sesión de usuario tiene el privilegio WebAdmin. Cuando se ejecuta esta función, el archivo de datos se protege inmediatamente y el estado se almacena en el disco: el archivo de datos estará protegido incluso si se reinicia la aplicación.

    Ejemplo

    Se crea un método proyecto protectDataFile para llamar antes de los despliegues, por ejemplo:

     ds.setAdminProtection(True) //Desactiva el acceso a los datos del Explorador de datos

    Ver también

    .isAdminProtected()

    .startRequestLog()

    Histórico
    VersiónModificaciones
    v17 R6Añadidos

    .startRequestLog()
    .startRequestLog( file : 4D.File )
    .startRequestLog( reqNum : Integer )

    ParámetrosTipoDescripción
    file4D.File->Objeto File
    reqNumInteger->Número de peticiones a mantener en memoria

    |

    Descripción

    La función .startRequestLog() inicia el registro de peticiones ORDA del lado del cliente.

    Esta función debe ser llamada en un 4D remoto, de lo contrario no hace nada. Está diseñado para fines de depuración en configuraciones cliente/servidor.

    El registro de peticiones ORDA puede ser enviado a un archivo o a la memoria, dependiendo del tipo de parámetro:

    • Si se pasa un objeto file creado con el comando File, los datos de registro se escriben en este archivo como una colección de objetos (formato JSON). Cada objeto representa una petición.
      Si el archivo no existe ya, se crea. En caso contrario, si el archivo ya existe, los nuevos datos de registro se añaden a él. Si se llama a .startRequestLog( ) con un archivo mientras se inició previamente un registro en memoria, el registro en memoria se detiene y se vacía.

      Debe añadirse manualmente un carácter \N al final del archivo para realizar una validación JSON

    • Si se pasa un entero reqNum, se vacía el registro en memoria (si lo hay) y se inicializa un nuevo registro. Mantendrá reqNum peticiones en memoria hasta que se alcance el número, en cuyo caso se vacían las entradas más antiguas (pila FIFO).
      Si se llama a .startRequestLog() con un reqNum mientras se ha iniciado previamente un registro en un archivo, se detiene el registro del archivo.

    • Si no ha pasado ningún parámetro, el registro se inicia en la memoria. Si se llamó previamente a .startRequestLog() con un reqNum (antes de un .stopRequestLog()), los datos del registro se apilan en memoria hasta la próxima vez que se vacíe el registro o se llame a .stopRequestLog().

    Para una descripción del formato del registro de peticiones de ORDA, consulte la sección Preguntas cliente ORDA.

    Ejemplo 1

    Desea registrar las solicitudes de los clientes ORDA en un archivo y utilizar el número de secuencia del registro:

     var $file : 4D.File
    var $e : cs.PersonsEntity

    $file:=File("/LOGS/ORDARequests.txt") //logs folder

    SET DATABASE PARAMETER(Client Log Recording;1) //to trigger the global log sequence number
    ds.startRequestLog($file)
    $e:=ds.Persons.get(30001) //send a request
    ds.stopRequestLog()
    SET DATABASE PARAMETER(Client Log Recording;0)

    Ejemplo 2

    Quiere registrar las peticiones de los clientes ORDA en la memoria:

     var $es : cs.PersonsSelection
    var $log : Collection

    ds.startRequestLog(3) //keep 3 requests in memory

    $es:=ds.Persons.query("name=:1";"Marie")
    $es:=ds.Persons.query("name IN :1";New collection("Marie"))
    $es:=ds.Persons.query("name=:1";"So@")

    $log:=ds.getRequestLog()
    ALERT("The longest request lasted: "+String($log.max("duration"))+" ms")

    .startTransaction()

    Histórico
    VersiónModificaciones
    v18Añadidos

    .startTransaction()

    | Parámetros | Tipo | | Descripción | | ---------- | ---- | | ------------------------------------------------------- | | | | | No requiere ningún parámetro|

    |

    Descripción

    La función .startTransaction() inicia una transacción en el proceso actual en la base de datos que coincide con el almacén de datos al que se aplica. Todos los cambios realizados en las entidades del almacén de datos en el proceso de la transacción se almacenan temporalmente hasta que la transacción se valida o se cancela.

    Si se llama a este método en el almacén de datos principal (es decir, el almacén de datos devuelto por el comando ds), la transacción se aplica a todas las operaciones realizadas en el almacén de datos principal y en la base de datos subyacente, incluyendo por tanto ORDA y los lenguajes clásicos.

    Puede anidar varias transacciones (subtransacciones). Cada transacción o sub-transacción debe ser eventualmente cancelada o validada. Note que si se cancela la transacción principal, también se cancelan todas sus subtransacciones, aunque se hayan validado individualmente mediante la función .validateTransaction().

    Ejemplo

     var $connect; $status : Object
    var $person : cs.PersonsEntity
    var $ds : cs.DataStore
    var $choice : Text
    var $error : Boolean

    Case of
    :($choice="local")
    $ds:=ds
    :($choice="remote")
    $connect:=New object("hostname";"111.222.3.4:8044")
    $ds:=Open datastore($connect;"myRemoteDS")
    End case

    $ds.startTransaction()
    $person:=$ds.Persons.query("lastname=:1";"Peters").first()

    If($person#Null)
    $person.lastname:="Smith"
    $status:=$person.save()
    End if
    ...
    ...
    If($error)
    $ds.cancelTransaction()
    Else
    $ds.validateTransaction()
    End if

    .stopRequestLog()

    Histórico
    VersiónModificaciones
    v17 R6Añadidos

    .stopRequestLog()

    | Parámetros | Tipo | | Descripción | | ---------- | ---- | | ------------------------------------------------------- | | | | | No requiere ningún parámetro|

    |

    Descripción

    La función .stopRequestLog() detine el registro de peticiones ORDA del lado del cliente (en archivo o en memoria). Es particularmente útil cuando se registra un archivo, ya que realmente cierra el documento abierto en el disco.

    Esta función debe ser llamada en un 4D remoto, de lo contrario no hace nada. Está diseñado para fines de depuración en configuraciones cliente/servidor.

    Ejemplo

    Ver ejemplos de .startRequestLog().

    .validateTransaction()

    Histórico
    VersiónModificaciones
    v18Añadidos

    .validateTransaction()

    | Parámetros | Tipo | | Descripción | | ---------- | ---- | | ------------------------------------------------------- | | | | | No requiere ningún parámetro|

    |

    Descripción

    La función .validateTransaction() acepta la transacción que se inició con .startTransaction() en el nivel correspondiente en el almacén de datos especificado.

    La función guarda los cambios en los datos del almacén de datos que se produjeron durante la transacción.

    Puede anidar varias transacciones (subtransacciones). Si se cancela la transacción principal, también se cancelan todas sus subtransacciones, aunque se hayan validado individualmente utilizando esta función.

    Ejemplo

    Ver el ejemplo de .startTransaction().