Comandos de navegante y búsquedas de Velneo V7
Tutorial avanzado » Uso avanzado de procesos » Comandos de navegante y búsquedas de Velneo V7
Comandos de navegante y búsquedas de Velneo V7
El grupo de comandos Navegante y búsquedas es un conjunto de comandos que nos permiten obtener fichas y listas de registros como origen para otros comandos.
En el ejemplo mostramos diversas formas de obtener fichas y listas de registros, y en partícular el uso del comando Cargar lista para obtener registros de distintas formas.
Comenzamos el proceso obteniendo todos los registros de una tabla ordenados por un índice. Para ello usamos el comando Cargar lista seleccionando el índice por el que queremos ordenados los registros resultantes. No usaremos para ello ninguna de las posiblidades de resolución.
En el subproceso del comando tendremos acceso a la lista obtenida. Usamos el comando Seleccionar ficha de la lista para ver los registros obtenidos.
En el subproceso tenemos información del número de registros que contiene la lista obtenida en la variable de sistema sysLisSize. Usamos el comando Mensaje para presentar el dato en ejecución.
El uso del comando Cargar lista de esta forma nos permite obtener todos los registros de una tabla según un índice. Podemos usar cualquier índice pero lo más logico será usar los de tipo acepta repetidas o clave única. Debemos tener en cuenta que no obtendremos registros no estén indexados. Si, por ejemplo, cargamos una lista de registros por un índice de clave única y hay registros que no tiene valores en los campos que incluye el índice, esos registros no aparecerán.
El siguiente uso de Cargar lista nos permite obtener una lista de registros ordenada por el índice seleccionado y cuyo valor se corresponda con el resuelto. Para ello usamos el comando seleccionando un índice y resolviendo las partes que nos interesen. Un índice compuesto por más de una parte podemos resolverlo parcial o totalmente, y los registros que obtendremos estarán ordenados por ese índice y los valores de los campos coincidirán con aquellos que hayamos resuelto.
El ejemplo carga una lista por el índice DATE y lo resolvemos con el resultado de la función de fórmulas currentDate(). De esta forma se retorna la lista de registros cuya fecha se corresponda con la fecha del día. En este caso únicamente resolvemos una de las partes del índice pero podríamos resolver todas las que nos interesen. El resto de partes del índice condicionan el orden en que se presentan los registros.
En el siguiente ejemplo de Cargar lista resolvemos dos de las partes que componen el índice. El resultado del comando es siempre una lista, aunque se componga de un único elemento.
Si el índice fuera de tipo clave única y resolvemos todas las partes, obtendremos el único registro que puede tener esos valores, pero continuaríamos teniendo un subproceso con una lista de un único elemento. Es lo que hacemos en el siguiente ejemplo de uso del comando Cargar lista en el que seleccionamos el índice TELEPHONE de clave única y resolvemos.
A continuación tenemos un ejemplo de uso del comando Búsqueda. Este comando nos permite lanzar cualquier objeto búsqueda que tengamos definido en nuestra base de datos accediendo en el subproceso del comando a la lista de registros resultante. Podremos usar variables globales para resolver los componentes de búsqueda. En el caso de que queramos hacer uso de variable locales, tendremos que usar los comandos del grupo Comandos de objetos.
La ejecución de búsquedas en procesos suele sustituir al uso del comando Cargar lista cuando queremos encontrar registros de una forma más compleja, usando varios índices o buscando entre límites.
El comando Localizador que usamos a continuación nos permite usar el objeto localizador desde el proceso. En el subproceso del comando tendremos acceso a la ficha seleccionada por el usuario. Este subproceso no se ejecutará si el usuario no ha seleccionado ficha alguna. En el ejemplo usamos el comando Pedir formulario para mostrar la ficha elegida.
El comando Cargar plurales nos permite obtener los registros plurales del maestro, en función del plural que hayamos seleccionado como parámetro. En el ejemplo, tras cargar la lista de maestros con el comando correspondiente, cargamos los pluralespor el plural seleccionado y mostramos la lista resultante con el comando Seleccionar ficha de la lista.
De igual forma, el comando Cargar maestros nos permite acceder a los maestros de una lista de registros que tengamos como entrada, seleccionando el campo enlaza al maestro. En el subproceso accedemos a la lista resultante, donde usamos Seleccionar ficha de la lista para mostrarla en el ejemplo.
