El tipo
Record permite manipular (modificar, guardar, etc.) los valores de un registro. Este Record puede ser un Record que se encuentra en un archivo de datos, una consulta o una vista. La variable asociada al tipo
Record se estructurará como un registro de la base de datos.
Ejemplos de uso: Esto le permite almacenar en diferentes variables el contenido de varios registros para compararlos o para comparar algunos artículos..
Versiones 23 y posteriores
Nueva funcionalidad versión 23
CustomerRec is Record of CUSTOMER
HReadFirst(CUSTOMER, CUSTNUM)
IF NOT HOut() THEN
CustomerRec = CUSTOMER
// Display the last and first names of the customer
Info(CustomerRec.LASTNAME, CustomerRec.FIRSTNAME)
END
CustomerRec is Record of CUSTOMER
CustomerRec.LastName = "MOORE"
CustomerRec.FirstName = "Paul"
CustomerRec.City = "PARIS"
// Assigns the content of the CustomerRec variable in the buffer of CUSTOMER file
CUSTOMER = CustomerRec
HAdd(CUSTOMER)
// You have the ability to do: HAdd(CUSTOMER, CustomerRec)
Observaciones
Declarando un Record Variable
La siguiente sintaxis se utiliza para declarar una variable de tipo Record:
<Variable name> is Record [of <Name of analysis file>]
- Si se especifica <Nombre del archivo de análisis>, el Record se asocia con un description de uno de los archivos de datos encontrados en el análisis. En este caso, tienes la capacidad de manipular los diferentes artículos de Record.
- Si no se especifica <Nombre del Archivo de Análisis>, la estructura de la Record se construirá dinámicamente según el buffer del archivo que se le asigne.
Acceso a los artículos
Para acceder a los elementos de un Record Variable, utilice la siguiente sintaxis:
- Para asignar un elemento de la Variable:
<Variable Name>.<Item Name> = <Value to Assign>
- Para recuperar el valor de los elementos:
<Value> = <Variable Name>.<Item Name>
Observación: Cuando se utiliza una variable Record asociada a un archivo de datos del análisis, el editor de código propone automáticamente los diferentes elementos de Record:
Lectura y asignación de un Record Variable
Las variables de tipo Record se pueden leer o asignar. La sintaxis es la siguiente:
- Para almacenar el buffer de un archivo de datos en un Record Variable LE:
<Name of Record Variable> = <Name of Data File>
- Para asignar el buffer de un archivo de datos de un Record Variable LE:
<Name of Data File> = <Name of Record Variable>
Casos especiales
- HRetrieveRecord usado en un Record Variable devuelve una cadena de caracteres que contiene el valor de cada elemento separado por un carácter TAB.
- No se produce ningún error de compilación si un Record Variable con tipo en un archivo de datos se asigna con el búfer de otro archivo de datos. Se realiza un copy homónimo de los buffers: sólo se asignarán los elementos con el mismo nombre de cada búfer. Los demás elementos no se asignarán.
- Sólo la serialización JSON está disponible para este tipo de Variable (Serialize). No es posible la deserialización.
Funciones que manipular el tipo Record
Las siguientes funciones utilizan el tipo
Record:
Observación: Para reiniciar el contenido de un
Record Variable, tienes la posibilidad de usar
VariableReset.
Propiedades específicas de la descripción de las variables Record
Las siguientes propiedades pueden utilizarse para averiguar las características de un Record Variable:
| | |
| Nombre de la propiedad | Tipo utilizado | Efecto |
|---|
| Contenido | Cadena de caracteres | Contenido de la actual Record (idéntico al resultado devuelto por HRetrieveRecord). Tsu Property está disponible en sólo lectura. |
| AssociatedFile | Cadena de caracteres | Nombre del archivo de datos HFSQL en el que se basa el Variable. Tsu Property está disponible en sólo lectura. |
Observación: Estas propiedades se pueden utilizar con una de las siguientes sintaxis:
- <Nombre de variable>..<Nombre de propiedad>
- <Nombre de variable>.<Nombre de propiedad>