VRoot
La clase VRoot representa a un objeto de Velneo en ejecución. Dispone de funciones para ver o modificar las variables locales y de sistema del objeto, obtener información del objeto (api), transacciones…
Velneo nos genera un objeto de la clase VRoot con el nombre theRoot para el objeto principal en ejecución. Veamos algunos ejemplos:
- Tenemos un formulario con un manejador de evento en lenguaje JavaScript: el objeto theRoot del manejador de evento representa al ejecutor del formulario.
- Ejecutamos un proceso JavaScript con una acción: el objeto theRoot del proceso representa al ejecutor del proceso en Velneo.
- Si el objeto es una vista de datos (rejilla, formulario…) estarán disponibles en theRoot las funciones de manejo de interfaz como obtener su vista de datos con la función dataView(), pudiéndose usar las funciones del objeto widget que devuelve.
De variables locales tipo array
Retorno | Función |
void | |
void | |
void | |
void | |
void | |
void | |
Date | |
DateTime | |
Number | |
Number | |
String | |
Time |
Del Api del objeto
Retorno | Función |
Number | |
Number | |
Number |
De variables locales
Retorno | Función |
void | |
void | |
void | |
void | |
void | |
void | |
void | |
Boolean | |
Date | |
DateTime | |
Number | |
Number | |
String | |
Time |
De variables de sistema
Retorno | Función |
String | |
Number | |
Boolean | |
Number | |
Number | |
Number | |
String |
De transacciones
Retorno | Función |
Boolean | |
void | |
Boolean | |
void | |
Boolean | |
void | |
Boolean | |
Boolean | |
void | |
void |
De datos
Retorno | Función |
Variant | |
Object |
De vista de datos
Retorno | Función |
De formulario y lista QML
Retorno | Función |
void |
De lista QML
Retorno | Función |
VModel |
Asigna el contenido a una variable local array de tipo alfabética.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- szValor: cadena alfabética.
Asigna el contenido a una variable local array de tipo numérica.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- nValor: número.
Asigna el contenido a una variable local array de tipo booleana.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- bValor: booleano, 0 ó 1, true o false.
Asigna el contenido a una variable local array de tipo tiempo, fecha y hora.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- dt: tiempo, fecha y hora.
Asigna el contenido a una variable local array de tipo fecha.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- date: fecha.
Asigna el contenido a una variable local array de tipo hora.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
- time: hora.
Devuelve el valor de una variable local array de tipo fecha.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el valor de una variable local array de tipo tiempo, fecha y hora.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el valor de una variable local array de tipo numérica, double.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el valor de una variable local array de tipo numérica, integer.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el valor de una variable local array de tipo alfabética.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el valor de una variable local array de tipo hora.
Parámetros:
- szId: identificador de la variable local.
- index: número de la posición del elemento en el array, el primero elemento es el 0.
Devuelve el tipo de entrada (ninguno, ficha o lista) del objeto manipulado con la clase VRoot. Ver enum de tipos de entrada/salida en la clase VObjectInfo
Devuelve el tipo del objeto manipulado con la clase VRoot. Ver enum de tipos de objeto en la clase VObjectInfo.
Devuelve el tipo de salida (ninguno, ficha o lista) del objeto manipulado con la clase VRoot. Ver enum de tipos de entrada/salida en la clase VObjectInfo.
Asigna el contenido a una variable local de tipo booleana.
Parámetros:
- szId: identificador de la variable local.
- bValor: booleano, 0 ó 1, true o false.
Asigna el contenido a una variable local de tipo fecha.
Parámetros:
- szId: identificador de la variable local.
- date: fecha.
Asigna el contenido a una variable local de tipo tiempo, fecha y hora.
Parámetros:
- szId: identificador de la variable local.
- dt: tiempo, fecha y hora.
Asigna el contenido a una variable local de tipo numérica, double.
Parámetros:
- szId: identificador de la variable local.
- dValor: número con decimales.
Asigna el contenido a una variable local de tipo numérica, integer.
Parámetros:
- szId: identificador de la variable local.
- nValor: número entero.
Asigna el contenido a una variable local de tipo alfabética.
Parámetros:
- szId: identificador de la variable local.
- szValor: cadena alfabética.
Asigna el contenido a una variable local de tipo hora.
Parámetros:
- szId: identificador de la variable local.
- time: hora.
Devuelve el valor de una variable local de tipo booleana.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo fecha.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo tiempo, fecha y hora.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo numérica, double.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo numérica, integer.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo alfabética.
Parámetros:
- szId: identificador de la variable local.
Devuelve el valor de una variable local de tipo hora.
Parámetros:
- szId: identificador de la variable local.
Devuelve el path del directorio de caché del cliente.
Devuelve la página en curso en un informe.
Devuelve true si el usuario en vAdmin está configurado como supervisor.
Devuelve el número total de páginas de un informe.
Devuelve la posición del registro actual en la lista de registros del objeto.
Devuelve el número de registros de la lista del objeto.
Devuelve el nombre del usuario.
Inicia una transacción. Devuelve true si la transacción se ha iniciado satisfactoriamente.
Parámetros:
- szTitulo: título de la transacción que se visualiza en el visor de transacción de vAdmin.
Con esta función el servidor realiza una notificación al cliente informándole de que el proceso sigue activo y de esta forma se evita que el cliente asuma la finalización del mismo por alcanzar el timeout.
Si desde un cliente ejecutamos un proceso en tercer plano, es decir en el servidor, si la duración del proceso es superior al timeout (actualmente 10 minutos) aunque el proceso continue ejecutándose en el servidor el cliente asume que el proceso ha finalizado de forma anómala al no recibir ninguna información del servidor. Con esta función el programador puede notificar desde el proceso que se está ejecutando en el servidor al cliente evitando que se produzca la desconexión del cliente por llegar al timeout.
Esta función es conveniente usarla en procesos cuya duración sea larga y pueda superar el timeout, de todas formas no debe ejecutarse esta función de forma constante ya que podría afectar al rendimiento del proceso. Una buena práctica sería ejecutar esta función cada determinado número de operaciones cuya duración sea superior a 1 minuto, por ejemplo, e inferior al tiempo de timeout.
Finaliza una transacción. Devuelve true si la transacción ha finalizado satisfactoriamente. Al finalizar la transacción se dan por válidas todas las operaciones realizadas en la base de datos. Al finalizar un proceso si hay una transacción abierta se cierra automáticamente como si se hubiese ejecutado esta función de forma explícita.
Se oculta la barra de progreso de la barra de estado de la ventana.
Devuelve true si hay una transacción en curso.
Se visualiza la barra de progreso en la barra de estado de la ventana.
Aborta una transacción y deshace todas sus operaciones. Devuelve true si todas las operaciones de la transacción se han deshecho satisfactoriamente.
Ejecuta un proceso Velneo o JavaScript. Permite los siguientes casos:
- Si se pasa un proceso sin origen los ejecuta.
- Si el Root corresponde a un objeto de ficha y el proceso es de ficha lo alimenta con la ficha.
- Si el Root corresponde a un objeto de lista y el proceso de ficha lo alimenta con la ficha seleccionada de la lista.
- Si el Root corresponde a un objeto de lista y el proceso es de lista lo alimenta con la lista.
Parámetros:
- szIdRefProcess: cadena que contiene el identificador referencia del proceso ("Alias_proyecto/ID_proceso").
Se actualiza la barra de progreso que se está visualizando en la barra de estado de la ventana al valor indicado en el porcentaje. Al igual que el porcentaje también es posible cambiar el texto o leyenda que se muestra junto a la barra de progreso con la función setTitle().
Antes de fijar el valor porcentual es necesario mostrar la barra de progreso con la función initProgressBar() y una vez finalizado el proceso se ocultará la barra de progreso con el comando endProgressBar().
Parámetros:
- percent: número entre 0 y 100 que representa el porcentaje a mostrar en la barra de progreso.
Cambia el título o leyenda que se muestra al lado de la barra de progreso en la barra de estado de la ventana.
Antes de fijar título o el valor porcentual es necesario mostrar la barra de progreso con la función initProgressBar() y una vez finalizado el proceso se ocultará la barra de progreso con el comando endProgressBar().
Parámetros:
- szTitle: texto a visualizar junto a la barra de progreso.
Retorna el valor obtenido de calcular la fórmula de Velneo que indicamos como parámetro.
Parámetro:
- szFormula: fórmula de Velneo. Se recomienda dar valor entre comillas simples (') para evitar colisiones con entrecomillados (") correspondientes a cadenas en Velneo.
Nota:
Tendrá como origen, el mismo que theRoot.
Devuelve un objeto VRegister, VRegisterList o Nulo en función del origen del objeto representado por VRoot.
Carga un modelo auxiliar del modelo principal del QML.
Parámetros:
- szNameModel: mombre del modelo. Este valor se corresponde con la propiedad "Nombre en QML" del modelo auxiliar.
Devuelve un modelo auxiliar de los existentes en el array de modelos auxiliares. Esta función se utiliza cuando en el modelo auxiliar se configura la propiedad "Modo de sincronización" con el valor "LISTA: un modelo por cada ítem del modelo principal".
Parámetros:
- szNameModel: nombre del modelo. Este valor se corresponde con la propiedad "Nombre en QML" del modelo auxiliar.
- nIndex: número de orden del modelo en el array de modelos. El primero elemento del array es el 0.
if (theRoot.beginTrans("Titulo"))
{
var bOK = true;
var szErrMsg = "";
for( var x=0; bOK && ( x < theRegisterListIn.sizeList() ); x++)
{
var registro = theRegisterListIn.readLockingAt(x);
bOK = registro.isOK();
if ( bOK )
{
registro.setField( "IDCAMPO1", dato );
registro.setField( "IDCAMPO2", hoy );
.....
registro.modify();
bOK = registro.isOK();
}
if ( !bOK )
szMsg = registro.errorMessage();
}
if ( !bOK )
{
theRoot.rollbackTrans();
.... // Mensaje de error
}
}
else
{
.... //Mensaje de error
}
// Se crea un registro vacío en memoria y se le asigna la tabla
var reg = new VRegister( theRoot );
reg.setTable( "vbaseUsuariosDat/USR" );
// Se ejecuta un bucle para dar 10 altas en 10 transacciones diferentes
for ( var i=0; i < 10; ++i )
{
// Se crea una transacción
if ( theRoot.beginTrans( "Alta de usuario. Transacción " + i ) )
{
// Se modifican los datos
reg.setField( "NAME", "Usuario_" + i );
// Se crea el registro
reg.addRegister();
// Se añaden el registro a la lista de salida
theRegisterListOut.append( reg );
// Se cierra la transacción
theRoot.commitTrans();
}
}
Última actualización 3yr ago