VRegisterList
Última actualización
Última actualización
Los objetos de esta clase representan una lista de fichas de una tabla. Dispone de funciones de manejo de la lista y sus items pudiéndose obtener objetos de la clase VRegister por index, en modos lectura y lectura con bloqueo si vamos a modificar.
Las funciones del navegante devuelven otro objeto clase VRegisterList con la lista del maestro o histórico.
Constructor
Inicialización
Generales
De Api de tabla
De lista & ítems
De navegante
Varias
Serialización
De JSON
Constructor del objeto VRegisterList.
Parámetros:
root: objeto VRoot, normalmente usaremos theRoot.
Asigna la tabla al objeto VRegisterList creado con el constructor. Devuelve true si ha podido asignar la tabla correctamente. Una vez ejecutada es equivalente a crear una cesta de la tabla.
Parámetros:
szIdRefTable: cadena que contiene el identificador referencia de la tabla.
Establece un título para la lista que podemos usar de forma interna para controlarla.
Devuelve el título de la lista que hayamos establecido.
Devuelve un objeto VTableInfo de la tabla de la lista de registros.
Añade un registro a la lista. Equivale al comando de instrucción "Cesta: añadir ficha a la cesta".
Parámetros:
register: objeto de la clase VRegister.
Añade una lista a la lista. Equivale al comando de instrucción "Cesta: añadir lista a la cesta".
Parámetros:
registerList: objeto de la clase VRegisterList.
Limpia la lista de registros. Equivale al comando de instrucción "Cesta: limpiar".
Cruza la lista de registros con la lista en curso. En la lista en curso sólo quedarán los registros coincidentes. Equivale al comando de instrucción "Cesta: cruzar la lista de la cesta".
Parámetros:
registerList: objeto de la clase VRegisterList.
Invierte el orden de los registros de la lista.
Carga en el VRegisterList los registros encontrados en la búsqueda realizada con el índices y las resoluciones configuradas. Devuelve false si la búsqueda no ha podido ejecutarse por algún error y devuelve true si la búsqueda ha podido realizarse, aunque no haya encontrado ningún registro. Esta función es equivalente al comando de instrucción de Velneo cargar lista.
Parámetros:
szIdIndice: cadena que contiene el identificador del índice.
aKeyPartsResol: array que contiene las resoluciones de cada una de las partes del índice.
Multiparte la lista creando un array de VRegisterLists que contiene cada una de las listas resultantes.
Parámetros:
szIdCompuestoCampo: cadena que contiene el identificador compuesto del campo por el que se multiparte.
Devuelve la posición del registro en curso de la lista.
Devuelve una referencia a un objeto de la clase VRegister que se genera internamente con el registro de la posición seleccionada.
Al ser una referencia a un registro interno, una segunda ejecución de readAt provocará que se destruya la referencia anterior y se cree otra nueva. Para guardar este registro debemos crear un nuevo VRegister y mediante la función copyFrom copiar el registro interno en el nuevo VRegister.
Ver ejemplo: 4. Creación de un nuevo VRegister para guardar el registro interno leído con readAt()
Parámetros:
nIndex: número que contiene la posición del registro en la lista. La primera posición es la 0.
Devuelve una referencia a un objeto de la clase VRegister que se genera internamente con el registro de la posición seleccionada. Este registro está bloqueado y permite realizar operaciones de base de datos contra el registro.
Al ser una referencia a un registro interno, una segunda ejecución de readAt provocará que se destruya la referencia anterior y se cree otra nueva. Para guardar este registro debemos crear un nuevo VRegister y mediante la función copyFrom copiar el registro interno en el nuevo VRegister.
Ver ejemplo: 4. Creación de un nuevo VRegister para guardar el registro interno leído con readAt()
Parámetros:
nIndex: número que contiene la posición del registro en la lista. La primera posición es la 0.
Quita de la lista el registro. Esto no eliminar el registro de la base de datos, sólo de la lista. Equivale al comando de instrucción "Cesta: quitar ficha de la cesta".
Parámetros:
register: objeto de la clase VRegister.
Quita de la lista los registros de la lista que se pasa. En la lista en curso quedarán los registros no coincidentes. Esto no elimina los registros de la base de datos, sólo los quita de la lista.
Parámetros:
registerList: objeto de la clase VRegisterList.
Quita de la cesta el registro de la posición indicada. Esto no eliminar el registro de la base de datos, sólo de la lista.
Parámetros:
nIndex: number que contiene la posición del registro en la lista
Devuelve el número de registros que contiene la lista.
Ordena la lista de registros por los campos indicados en el array de identificadores que se indica como parámetro.
Parámetros:
aszIdCompuestoCampo: array de cadenas que contiene los identificadores del campo de la tabla o de sus enlazadas que se usarán para ordenar.
Ordena la lista de registros por el campo indicado.
Parámetros:
szIdCompuestoCampo: cadena que contiene el identificador del campo de la tabla o de sus enlazadas.
Las funciones de escritura en disco en tablas, cuando se trata de tablas en memoria requiere abrir transacción para que las operaciones se reflejen en la tabla.
Devuelve la lista de registros maestros del campo enlace a maestro. Devuelve los maestros sin repetición, aunque varios registros apunten al mismo maestro sólo lo devuelve una vez. Equivale al comando cargar maestros y a navegar a maestros.
Parámetros:
szIDPrimarioCampo: cadena que contiene el identificador del campo con enlace a tabla maestra.
Este comando está optimizado de modo que se pasa la lista de registros al servidor para que la carga de sus maestros se realice en 3er plano, excepto en el caso de las tablas en memoria, que se hará en primer plano.
Devuelve una referencia a un objeto de la clase VRegisterList que se genera internamente con la lista de registros del enlace plural de la lista de registros actual. Equivale al comando de instrucción de proceso de Velneo cargar plurales y a navegar a plurales del menú de lista de vClient.
Al ser una referencia a una lista de registros interna, una segunda ejecución de la función loadPlurals provocará que se destruya la referencia anterior y se cree otra nueva. Para guardar esta lista debemos crear un nuevo VRegisterList y mediante la función append añadir a esta nueva lista los registros de la lista interna devuelta por loadPlurals().
Este comando está optimizado de modo que se pasa la lista de registros al servidor para que la carga de sus plurales se realice en 3er plano, excepto en el caso de las tablas en memoria, que se hará en primer plano.
Ver ejemplo: 5. Creación de VRegisterList para guardar la lista interna obtenida con loadPlurals()
Parámetros:
szIDHistorico: cadena que contiene el identificador del plural.
Ejecuta un proceso Velneo o JavaScript.
Parámetros:
szIdRefProcess: cadena que contiene el identificador referencia del proceso ("Alias_proyecto/ID_proceso").
Carga en el objeto de la clase VRegisterList una lista de registros previamente serializados en un byte array con la función saveToData().
La función devuelve true si la carga se ha realizado correctamente.
Si el VRegisterList no tiene asignada una tabla esta función se encarga de asignarle automáticamente la tabla y luego le añade los registros a la lista.
Parámetros:
buffer: objeto de la clase VByteArray que contiene los registros serializados.
Carga en el objeto de la clase VRegisterList una lista de registros previamente serializados en un fichero en disco con la función saveToFile().
La función devuelve true si la carga se ha realizado correctamente.
Si el VRegisterList no tiene asignada una tabla esta función se encarga de asignarle automáticamente la tabla y luego le añade los registros a la lista.
Parámetros:
path: senda del fichero en disco que contiene los registros serializados.
Almacena en un objeto de la clase VByteArray la serialización de la lista de registros que contiene el objeto de la clase VRegisterList.
Almacena en un fichero en disco la serialización de la lista de registros que contiene el objeto de la clase VRegisterList.
Parámetros:
path: senda del fichero en disco donde se almacenarán la lista de registros serializados, si el fichero no existe se crea y si existe se limpia.
Convierte una lista de registros de una tabla en un objeto JSON debidamente formateado, permitiendo definir si se incluyen todos o algunos campos.
Equivale al comando de instrucción de proceso generar JSON desde lista.
Parámetros:
aszIDs: array con los identificadores de los campos camos de la tabla con los que queremos generar el JSON. Si queremos incluirlos todos, usaremos un array vacío: []
Devuelve un VariantMap con los siguientes campos:
ok: booleano con el retorno de ok.
json: cadena de texto con formato JSON con el resultado.
errors: cadena de texto con formato array de JSON con los errores.
Podremos obtener estos campos del VariantMap del modo siguiente:
Ejemplo 1:
Ejemplo 2: