CREATE RECORD
CREATE RECORD {( tabla )}
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| tabla | Table | → | Tabla para la cual crear un nuevo registro, o Tabla por defecto, si se omite |
Descripción
CREATE RECORD crea un nuevo registro vacío para tabla, pero no muestra el nuevo registro. Utilice el comando ADD RECORD para crear un nuevo registro y mostrarlo en un formulario de entrada.
CREATE RECORD se utiliza en lugar de ADD RECORD cuando los valores de los registros se introducen por programación. El nuevo registro se convierte en el registro actual para la selección actual pero la selección actual no se modifica.
El registro existe en memoria únicamente hasta que un comando SAVE RECORD se ejecute para la tabla. Si cambia el registro actual (por ejemplo, por una búsqueda) antes de guardar el registro, el nuevo registro se pierde.
Nota: este comando no requiere tabla para estar en modo lectura/escritura. Se puede utilizar incluso cuando la tabla está en modo de sólo lectura (ver Record Locking).
Ejemplo
El siguiente ejemplo archiva los registros que tienen más de 30 días. Esta operación se realiza para la creación de registros en una tabla de archivo. Una vez termina la operación, los registros archivados son eliminados de la tabla [Cuentas]:
// Búsqueda de registros de más de 30 días
QUERY([Cuentas];[Cuentas]Introducido<(Current date 30))
For($vlRegistro;1;Records in selection([Cuentas])) // Bucle una vez por registro
CREATE RECORD([Archivo]) // Creación de un nuevo registro de archivo
[Archive]Number:=[Cuentas]Numero // Copia de los campos en el archivo
[Archive]Entered:=[Cuentas]Introducido
[Archive]Amount:=[Cuentas]Cantidad
SAVE RECORD([Cuentas]) // Guardar el registro del archivo
NEXT RECORD([Cuentas]) // Mover el registro de cuenta siguiente
End for
DELETE SELECTION([Cuentas]) // Borrar los registros de cuenta