Búsquedas

Conjunto de comandos de proceso que permiten navegar por la información contenida en las distintas tablas de datos de los proyectos de datos ejecutados a través los enlaces declarados. Permite también hacer uso a través de comandos de proceso de los objetos visuales búsqueda y localizador.

Búsqueda

Comando de instrucción que permite ejecutar un objeto búsqueda contenido en un proyecto de aplicación, incluyendo los heredados.

Origen de la instrucción: cualquiera.

Destino del subproceso: lista de la tabla origen de la Búsqueda.

Parámetros

Identificador de Búsqueda

Identificador de la Búsqueda que queremos ejecutar. Para facilitar su especificación, este parámetro desplegará la lista de Búsquedas incluyendo los proyectos de aplicación heredados.

Funcionalidad

Este comando permite ejecutar cualquiera de las búsquedas que tenga declaradas en el proyecto de aplicación, incluyendo los heredados.

Crea un subproceso de lista, cuyo origen será la lista resultante de la ejecución de la búsqueda. El subproceso será ejecutado, se hayan encontrado o no registros.

Comentarios

La búsqueda siempre será realizada sobre todos los registros de la tabla de datos.

Ejemplo

Imprimir un informe con el diccionario de abreviaturas en orden alfabético.

Búsqueda ( ABR_M@ejemplo_app )
   Imprimir informe ( ABR_Mejemplo_app,  )

Cargar lista

Comando de instrucción que permite carga una lista de registros de una tabla de datos.

Origen de la instrucción: cualquiera.

Destino del subproceso: lista.

Parámetros

Identificador de tabla

Identificador de la tabla que queremos ejecutar. Para facilitar su especificación, este parámetro desplegará la lista de tablas incluyendo los proyectos de datos heredados.

Identificador de índice

Identificador del índice que queremos utilizar para cargar la lista. Para facilitar su especificación, este parámetro desplegará la lista de índices de la tabla seleccionada en el parámetro anterior.

Formula de resolución

Fórmula para resolver la primera parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte.

Formula de resolución

Fórmula para resolver la segunda parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte. Solamente aparecerá si el índice tiene al menos dos componentes.

Formula de resolución

Fórmula para resolver la tercera parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte. Solamente aparecerá si el índice tiene al menos tres componentes.

Formula de resolución

Fórmula para resolver la cuarta parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte. Solamente aparecerá si el índice tiene al menos cuatro componentes.

Funcionalidad

Carga una lista de registros de la tabla de datos dada. Esta función crea un subproceso de lista con los registros encontrados. El subproceso será ejecutado, se hayan encontrado o no registros.

Comentarios

Si no se resuelve ninguna de las partes del índice, es cargada la tabla de datos completa. Si no se resuelven todas las partes del índice, son leídas todas las fichas que tengan las partes resueltas en su clave, despreciando el resto.

En Velneo, para cargar una ficha debemos usar también este comando. El resultado será una lista con un único registro.

Ejemplo

Buscar clientes que contengan la palabra 'delga' en su nombre y convertirlos posteriormente a mayúsculas.

Cargar lista ( CLT_M@ejemplo_dat, TRO, "delga", , , )
    Recorrer lista lectura/escritura
        Modificar campo ( NAME, toUpper(#NAME) )

Cargar lista de índice complejo

Comando de instrucción que permite carga una lista de registros de una tabla de datos haciendo uso de un índice complejo.

Origen de la instrucción: cualquiera.

Destino del subproceso: lista.

Parámetros

Identificador de índice complejo

Identificador del índice complejo que queremos utilizar para cargar la lista. Para facilitar su especificación, este parámetro desplegará la lista de índice complejo disponibles.

Formula de resolución

Fórmula para resolver la primera parte de la clave del índice complejo.

Formula de resolución

Fórmula para resolver la segunda parte de la clave del índice complejo.

Formula de resolución

Fórmula para resolver la tercera parte de la clave del índice complejo.

Formula de resolución

Fórmula para resolver la cuarta parte de la clave del índice complejo.

Funcionalidad

Carga una lista de registros de la tabla de datos dada. Esta función crea un subproceso de lista con los registros encontrados. El subproceso será ejecutado, se hayan encontrado o no registros.

Comentarios

Si no se resuelve ninguna de las partes del índice complejo, es cargada la tabla de datos completa. Si no se resuelven todas las partes del índice, son leídas todas las fichas que tengan las partes resueltas en su clave, despreciando el resto.

Ejemplo

Buscar entre las líneas de pedidos los artículos cuya descripción contengan la palabra 'ferrari' e imprimir los pedidos en los que aparecen por la impresora lógica especificada 'LST_VER'.

Cargar lista de índice complejo ( PED_G_TRO_NOM_ART@ejemplo_dat, "ferrari", , , ,  )
    Imprimir informe ( INF_PED@ejemplo_app, LST_VER@ejemplo_app )

Cargar maestros

Comando de instrucción que permite obtener una lista con las fichas maestras.

Origen de la instrucción: lista.

Destino del subproceso: lista de la tabla apuntada por el campo cargado.

Parámetros

Identificador de campo

Identificador del campo enlazado. Para facilitar su especificación, este parámetro desplegará la lista de campos enlazados de la tabla.

Funcionalidad

Esta función carga cada una de las fichas del archivo maestro que están siendo apuntadas por las fichas de la lista en curso a través del campo enlazado. De esta forma, se obtiene una lista, sin repeticiones, con las fichas maestras apuntadas.

Esta función está optimizada ya que pasa la ficha o lista de registros al servidor y la carga de maestros se hace en tercer plano, excepto en el caso de las tablas en memoria, que se hará en primer plano.

Comentarios

Esta función genera un subproceso, cuyo origen será la lista obtenida. Dicho subproceso será ejecutado se hayan encontrado o no registros maestros.

Ejemplo

Cargamos los pedidos de la fecha en curso mostrando el número de clientes que intervienen en los pedidos.

Cargar lista ( PEDIDOS@ejemplo, FECHA, currentDate(), , ,  )
    Cargar maestros ( CLIENTES )
        Mensaje ( "Clientes obtenidos: " + sysListSize, Información, ,  )

Cargar plurales

Comando de instrucción que permite obtener una lista con las fichas históricas.

Origen de la instrucción: lista y ficha.

Destino del subproceso: lista de la tabla histórica.

Parámetros

Identificador de plural

Identificador del plural enlazado. Para facilitar su especificación, este parámetro desplegará la lista de plurales enlazados de la tabla.

Funcionalidad

Si el origen es ficha, lee los plurales del registro actual de la tabla de datos en curso. Si es lista, lee los plurales de todos los registros la lista.

Comentarios

Esta función crea un subproceso de lista con todos los registros históricos cargados. Dicho subproceso se ejecutará se hayan encontrado o no plurales.

Esta función está optimizada ya que pasa la ficha o lista de maestros al servidor y la carga de plurales se hace en tercer plano, excepto en el caso de las tablas en memoria, que se hará en primer plano.

Ejemplo

Modificar el campo fecha de los clientes que pertenezcan al sector de actividad 'Agricultura' y pone como fecha la fecha actual del sistema.

Cargar lista ( SEC_ACT_M@ejemplo_dat, NAME, "Agricultura", , ,  )
    Recorrer lista sólo lectura
        Cargar plurales ( CLT_M_SEC_ACT )
            Recorrer lista lectura/escritura
                Modificar campo ( FCH, currentDate() )

Leer registro

Comando de instrucción que permite leer un registro de una tabla.

Origen de la instrucción: cualquiera.

Destino del subproceso: ficha.

Parámetros

Identificador de tabla

Identificador de la tabla en la que queremos buscar el registro. Para facilitar su especificación, este parámetro desplegará la lista de tablas incluyendo los proyectos de datos heredados.

Identificador de índice

Identificador del índice que queremos utilizar para buscar el registro. Debe ser un índice de clave única. Para facilitar su especificación, este parámetro desplegará la lista de índices de la tabla seleccionada en el parámetro anterior.

Tipo de resolución

Nos permite configurar el modo de búsqueda del registro por el índice seleccionado. Los modos disponibles son:

• Igual (resuelvo todas las partes): se busca por el índice con la resolución de todas sus partes (No tiene sentido buscar por igual sin resolución completa de todas las partes).

• Siguiente: se usa la resolución para posicionarnos en un registro, si la resolución es completa podría llegar a encontrar un registro por igual, pero en este caso no nos interesa el registro "igual" a la clave resuelta, nos interesa el siguiente del índice.

• Anterior: se usa la resolución para posicionarnos en un registro, si la resolución es completa podría llegar a encontrar un registro por igual, pero en este caso no nos interesa el registro "igual" a la clave resuelta, nos interesa el anterior del índice.

• Igual o siguiente: se usa la resolución para posicionarnos en un registro, si la resolución es completa podría llegar a encontrar un registro por igual, la ventaja es que si no encuentra por igual podemos obtener a través del índice el registro siguiente.

• Igual o anterior: se usa la resolución para posicionarnos en un registro, si la resolución es completa podría llegar a encontrar un registro por igual, la ventaja es que si no encuentra por igual podemos obtener a través del índice el registro anterior.

• Primero: una vez obtenida la lista tras la carga, con o sin resolución, devuelve el primer registro de la lista.

• Último: una vez obtenida la lista tras la carga, con o sin resolución, devuelve el último registro de la lista.

Formula de resolución (opcional)

Fórmula para resolver la primera parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte.

Formula de resolución (opcional)

Fórmula para resolver la segunda parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte. Solamente aparecerá si el índice tiene al menos dos componentes.

Formula de resolución (opcional)

Fórmula para resolver la tecera parte de la clave del índice. En este parámetro se mostrará tanto el identificador como el nombre del campo indexado en esa parte. Solamente aparecerá si el índice tiene al menos tres componentes.

Funcionalidad

Comando de instrucción que permite leer un registro de una lista buscando por un índice de clave única y un modo de búsqueda concreto.

Comentarios

Este comando de instrucción de proceso genera un subproceso cuyo origen será la ficha leída. Si no se encuentra ninguna ficha, el subproceso no será ejecutado.

Ejemplos

Leemos el cliente con el ID 25 y guardamos la ficha en la cesta global de clientes CLT_CESTA para su posterior uso.

Leer registro ( CLIENTES@miapp_dat, ID, Igual (resuelvo todas las partes), 23, ,  )
	Cesta: agregar ficha a la cesta ( CLT_CESTA@miapp_app )

Obtener la última factura del cliente con el ID = 25, para ello hacemos uso de un índice de clave única compuesto por el campo CLIENTE y el ID de la factura.

Leer registro ( FACTURAS@miapp_dat, CLT, Último, 25, ,  )
	Libre

Obtener el primer registro buscando por un índice, sin resolver nada.

Leer registro ( FACTURAS@miapp_dat, ID, Primero, , ,  )
	Libre