25
Velneo vDevelop
Scripts
Lenguajes
JavaScript
VQuery
Hereda de: VObjectInstance.
La clase VQuery representa una búsqueda en ejecución. Nos permite ejecutar búsquedas. Construimos un objeto VQuery pasándole el objeto VRoot en curso y le indicamos la búsqueda a ejecutar con la función setQuery. Una vez inicializado el objeto ya podemos usar el resto de funciones (salvo result): le pasamos contenido a las variables locales de la búsqueda con setVarLocal (si lo requiere) y la ejecutamos con la función exec. Ahora ya podemos recoger los resultados con la función result, que nos devuelve un objeto de la clase VRegisterList con el cual podemos operar.

Funciones

Constructor
Función
VQuery ( VRoot root )
De operaciones
Retorno
Función
Boolean
exec()
Inicialización
Retorno
Función
void
setQuery( String szIdRefQuery )

Documentación de funciones

Constructor

VQuery( VRoot root )

Crea una instancia de objeto de la clase VQuery. Debe ejecutarse la función setQuery() para asignarle la búsqueda.
Parámetros:
  • root: VRoot que indica el objeto VRoot en curso del que se hará uso, normalmente theRoot.

Funciones de operaciones

Boolean exec()

Ejecuta la búsqueda y devuelve true si finaliza correctamente.

VRegisterList result()

Devuelve un objeto VRegisterList con la lista de registros encontrados en la búsqueda.

Inicialización

void setQuery( String szIdRefQuery )

Fija la búsqueda que se asocia al objeto.
Parámetros:
  • szIdRefQuery: string que contiene el identificador referencia (IdRef=Alias_Proyecto/Id_Búsqueda) de la búsqueda.

Ejemplos

1. Ejecutar una búsqueda sin parámetros

1
// --------------------------------------------------------------------------------
2
// Ejemplo de búsqueda sin parámetros
3
// --------------------------------------------------------------------------------
4
5
// Se importa la clase para usar sus funciones
6
importClass("VQuery");
7
8
// Se crea el objeto búsqueda
9
var bus = new VQuery(theRoot);
10
bus.setQuery("vbaseUsuariosApp/USR_GRP_NOM");
11
12
// Se ejecuta la búsqueda y los registros encontrados se añaden a la salida
13
if (bus.exec())
14
{
15
// Le pasamos los resultados a la lista de salida
16
theRegisterListOut.append(bus.result());
17
};
Copied!

2. Ejecutar una busqueda con parámetros

1
// --------------------------------------------------------------------------------
2
// Ejemplo de búsqueda con parámetros
3
// --------------------------------------------------------------------------------
4
5
// Se importa la clase para usar sus funciones
6
importClass("VQuery");
7
8
// Se crea el objeto búsqueda
9
var bus = new VQuery(theRoot);
10
bus.setQuery("VJS_APP/USR_GRP_ENT_NAM");
11
12
// Se alimentan los parametros de búsqueda
13
bus.setVar("NOM_DES", "VJS");
14
bus.setVar("NOM_HAS", "VJSzzzzzzzzzzzzzzz");
15
16
// Se ejecuta la búsqueda y los registros encontrados se añaden a la salida
17
if (bus.exec())
18
{
19
// Le pasamos los resultados a la lista de salida
20
theRegisterListOut.append(bus.result());
21
};
Copied!

3. Lanzar una búsqueda con datos solicitados desde un formulario

1
// -----------------------------------------------------------------
2
// Lanzar una búsqueda con los datos solicitados desde un formulario
3
// -----------------------------------------------------------------
4
5
importClass("VQuery");
6
7
//Creamos el formulario
8
var formulario = new VDataViewDialog(theRoot);
9
formulario.setDataView(VObjectInfo.TypeForm, "49z6dckf.vca/DUMMY_PEDIR_DATOS")
10
11
//Mostramos el formulario
12
if(formulario.exec())
13
{
14
//Leemos el valor de las fechas que introducimos en el formulario
15
fechaDesde = formulario.varToDate("FCH_DES");
16
fechaHasta = formulario.varToDate("FCH_HAS");
17
18
//Si los datos no son vacíos
19
if ((fechaDesde != null) && (fechaHasta != null))
20
{
21
//Creamos el manejador de la búsqueda
22
var busqueda = new VQuery(theRoot);
23
24
//Asignamos la búsqueda a utilizar
25
busqueda.setQuery("49z6dckf.vca/VQUERY");
26
27
//Asignamos los valores adquiridos previamente
28
busqueda.setVar("FCH_DES", fechaDesde);
29
busqueda.setVar("FCH_HAS", fechaHasta);
30
31
//Ejecutamos la búsqueda
32
if(busqueda.exec())
33
{
34
//Retornamos la lista de resultados
35
theRegisterListOut.append(busqueda.result())
36
};
37
};
38
};
Copied!
Última actualización 2yr ago