Manejo de rejillas

A continuación veremos qué operaciones podemos llevar a cabo desde las rejillas de Velneo.

Comandos de ficha

En cualquier rejilla de Velneo vClient es posible añadir, modificar y/o borrar registros de una tabla. Las opciones de ficha están contenidas en el menú Ficha y son las siguientes:

Alta de ficha

Permite añadir un registro a una tabla. Puede ser llamada a través de esta opción, o a través del comando de la barra de herramientas, o pulsando la tecla Insert o la combinación de las teclas Control + N o seleccionando la opción del mismo nombre en el menú de contexto de la rejilla. Esta acción añadirá una nueva fila al final de la rejilla en la que la celda de la primera columna pasará a estar en modo guardará edición, una vez establecido el contenido de la misma, pulsaremos el tabulador para editar la siguiente celda y así sucesivamente. Si tras editar la celda de la última columna pulsamos de nuevo el tabulador se guardará el registro y se añadirá una nueva línea a la rejilla para que podamos dar de alta un nuevo registro.

Para cancelar un alta pulsar la tecla Esc.

Si pulsamos la tecla Intro finalizará la edición y el registro será guardado.

Modificación de ficha

Permite modificar un registro de una tabla. El cursor debe estar situado sobre la celda que desea modificar. Puede ser llamada a través de esta opción, o a través del comando del mismo nombre de la barra de herramientas estándar de vClient, o pulsando la tecla Intro o con la barra espaciadora (la barra espaciadora solamente es funcional en rejillas pero no en rejillas avanzadas), o seleccionando la opción del mismo nombre en el menú de contexto de la rejilla, o haciendo doble clic con el ratón sobre la celda que se desee modificar, pasando la celda a modo de edición:

Si una vez modificado el contenido de la celda queremos editar el de la siguiente o la anterior pulsaremos el tabulador o la combinación de las teclas Shift + Tabulador, respectivamente. Si tras editar la celda de la última columna pulsamos de nuevo el tabulador se guardará el registro y se editará automáticamente la primera celda de la línea siguiente.

Para cancelar una modificación pulsar la tecla Esc.

Si pulsamos la tecla Intro finalizará la edición y el registro será guardado.

En los dispositivos que lo soporten, podremos obtener el formulario de modificación haciendo tap & hold, es decir, pulsando con el dedo en una línea durante unos milisegundos.

Baja de ficha

Permite eliminar un registro de una tabla. El cursor debe estar situado sobre cualquier celda del registro a borrar. Puede ser llamada a través de esta opción, o a través del comando del mismo nombre de la barra de herramientas, o pulsando la tecla Supr, o seleccionando la opción del mismo nombre en el menú de contexto de la rejilla.

Una vez ejecutada la opción el sistema pedirá una confirmación. Si respondemos Sí la ficha será borrada, si respondemos No la operación será cancelada.

Si la ficha tiene históricos, el sistema no dejará borrarla. Será necesario borrar sus históricos previamente.

Comandos de lista

Se trata de una serie de comandos aplicables sobre listas ya preprogramados en Velneo vClient. Son los siguientes:

Invertir

Invierte el orden de los registros de la lista usando para ello el campo por el que ésta se encontrase ordenada.

Ejemplo: si se dispara una búsqueda por el índice nombre, el resultado será la lista ordenada alfabéticamente en orden ascendente. Si se invierte la lista, ésta será reordenada alfabéticamente en orden descendente.

Filtros

Este submenú incluye una serie de opciones para filtrar una lista, es decir, para quitar de la lista aquellos registros que no cumplan una determinada condición. Haz clic aquí para ampliar información al respecto.

Ordenar

Reordena los elementos de la rejilla por el campo seleccionado. Cuando se ejecuta esta opción se desplegará una ventana con la lista de campos de la tabla asociada a la rejilla.

Podremos seleccionar un campo tanto de la propia taba como de sus maestros.

La ordenación se hará por defecto en orden ascendente. Si queremos hacerla en orden descendente activaremos la opción Invertir lista.

Una vez seleccionado el campo, pulsar el botón aceptar para reordenar la lista o el botón cancelar para cancelar la ordenación.

La ordenación se hará en el servidor, a excepción de si ordenamos por los tipos de campo siguientes:

Fórmula.
Hermano contiguo.
Puntero indirecto real y virtual.
Singular de plural por índice y por posición.
Tabla de extensión.

Partir

Para que esta opción pueda ser ejecutada es necesario haber seleccionado previamente una fila de la rejilla en curso. Al ejecutarla, se corta la rejilla por el registro seleccionado y los datos sucesivos son introducidos en una nueva rejilla que el sistema crea en una nueva vista. El resultado final son dos vistas, una que contiene la rejilla con los datos hasta la selección y otra con el resto.

Este comando puede ser ejecutado pulsando la combinación de las teclas Control + F5.

Multipartir

Esta opción parte la lista en función del contenido de un campo. Al ejecutarla se presenta una ventana donde se selecciona el campo por el que se quiere partir la lista.

Una vez seleccionado el campo, pulsar el botón aceptar para multipartir la lista o el botón cancelar para cancelar la operación.

Por cada valor diferente que tenga el campo se creará una nueva vista que contendrá una rejilla con los registros correspondientes a ese valor.

El sistema ordenará previamente la lista por el campo seleccionado y la ordenación se hará en el servidor, a excepción de si ordenamos por los tipos de campo siguientes:

Fórmula.
Hermano contiguo.
Puntero indirecto real y virtual.
Singular de plural por índice y por posición.
Tabla de extensión.

Campos duplicados…

Esta opción crea un nueva lista con los registros de la rejilla en curso que posean el contenido de un campo duplicado. Este campo ha de ser seleccionado en la ventana que aparece al ejecutar esta opción.

Es útil para la localización de códigos o claves duplicadas en una tabla de datos.

Modificar campo…

Esta opción permite establecer el mismo valor en un campo de todos los registros de la lista. Al ejecutarla aparecerá una ventana para la selección del campo a modificar.

Una vez seleccionado el campo, pulsar el botón aceptar para continuar o el botón cancelar para cancelar.

Si no hemos cancelado, el siguiente paso será establecer el nuevo valor que tendrá el campo.

Una vez escrito el nuevo valor para el campo, pulsar el botón aceptar para continuar o el botón cancelar para cancelar.

Modificar campo si…

Esta opción permite establecer el mismo valor en un campo de todos los registros de la lista que cumplan una determinada condición. Al ejecutarla aparecerá una ventana para la selección del campo a modificar.

Una vez seleccionado el campo, pulsar el botón aceptar para continuar o el botón cancelar para cancelar.

Si no hemos cancelado, el siguiente paso será establecer la condición que se ha de cumplir para que el campo sea modificado; se establecerá por medio de una fórmula por lo que se abrirá el asistente para la edición de fórmulas. En él tendremos acceso a las Funciones estándar de fórmulas, a la lista de campos de la tabla y a las variables del sistema.

Una vez establecida la condición, pulsar el botón aceptar para continuar con la modificación o el botón cancelar para cancelarlo.

Exportar a XML

Genera un fichero XML con todo el contenido de la rejilla.

Copiar

Permite copiar el contenido de la rejilla al portapapeles y pegarlo en hojas de cálculo, editores de texto, etc.

Se incluirán todos los campos alfabéticos, numéricos, fórmulas, etc., excepto campos objeto binario e imágenes, incluyendo además la cabecera en la información que se copia.

En textos que contengan Intro o tabulador, el texto se copiará con el delimitador "". El formato numérico aplicado será el que en ese momento sea visible.

Generar vista con los seleccionados

Esta opción nos permite crear una nueva vista que contenga solamente los registros que se encuentren seleccionados en la rejilla en curso.

Generar vista con otro visor

Esta opción nos permite generar una nueva vista con los registros de la lista en curso usando otro visor de listas distinto al actual (rejilla, informe, etc.). Al ejecutar esta opción el sistema mostrará una ventana con todos los objetos de lista públicos asociados a la tabla en curso:

Haremos doble clic sobre el deseado y se generará una nueva vista con el mismo.

Aconsejamos a los programadores activar la propiedad privada en todos aquellos objetos cuyo origen sea lista que no se quiera estén disponibles al usuario final al usar esta opción.

Además, si en el proyecto existe una cesta asociada a la misma tabla de la rejilla, en el menú de contexto de la rejilla aparecerán las opciones siguientes:

Enviar seleccionados a la cesta.
Enviar todos a la cesta.
Abrir cestas.
Para ampliar información sobre las mismas consulta el capítulo manejo de cestas de la compra.

Selección múltiple de registros (multiselección)

Es posible seleccionar más de un registro en una rejilla para luego realzar alguna acción con ellos. Podremos hacer la selección, bien con el ratón, o bien a través del teclado.

Si la rejilla tiene a la izquierda la columna de multiselección (1), haciendo clic sobre un ítem, éste quedará seleccionado. Si volvemos a hacer clic sobre él, se quitará de la selección.

Si hacemos clic sobre la cabecera de la columna de multiselección (1), se seleccionarán todos los registros. Si volvemos a hacer clic, se quitarán todos de la selección.

Es posible también seleccionar registros haciendo clic sobre cualquier celda de la rejilla. Al hacer un clic quedará seleccionado el registro entero.

Si hacemos clic sobre otra línea, se quitará la selección del ítem o ítems que hubiese seleccionados y quedará seleccionado solamente éste.

Si queremos seleccionar un bloque continuo de registros lo que haremos será poner situar el foco en el primero de ellos y, con la tecla Shift pulsada, con las teclas de cursor arriba y abajo avanzar hasta el último registro que se quiere seleccionar.

Lo anterior también podemos hacerlo si hacemos clic con el ratón sobre el primer ítem a seleccionar, pulsamos la techa Shift y, sin soltarla, hacemos clic con el ratón sobre el último ítem a seleccionar.

Si queremos seleccionar registros alternos, entonces lo haremos manteniendo pulsada la tecla Control y haciendo clic con el ratón sobre cada registro a seleccionar.

Si tenemos seleccionado uno o varios registros y queremos seleccionar otro bloque, pulsar la tecla Control y la techa Shift de forma simultanea y, sin soltarlas, hacer clic sobre el primer ítem a seleccionar y luego sobre el último. De este modo, el bloque seleccionado se añadirá a la selección.

Drag & Drop

Si así lo ha programado el desarrollador de la aplicación, es posible arrastrar ítems de una rejilla y soltarlos en otra.

La operativa es muy sencilla: podemos seleccionar uno o varios registros (ver el punto selección múltiple de registros) hacer clic con el botón izquierdo del ratón sobre cualquiera de ellos y, manteniendo el botón pulsado, arrastrarlos hacia la rejilla de destino y dejar de pulsar el botón para soltarlos en ella.

Si eres programador y quieres saber cómo se programa te recomendamos revisar el tutor de drag & drop.

Edición de campos en rejillas

En este capítulo se explica de qué forma pueden ser editados los distintos tipos de campo en una rejilla editable.

Alfabético

Simplemente habrá que escribir el contenido deseado en la celda.

Numérico

Podemos escribir el número directamente usando el teclado.Si pulsamos las teclas de cursor arriba/abajo o hacemos clic en los microscrollers que contiene el control, el contenido del campo se incrementará/decrementará, respectivamente, en una unidad el contenido del campo. Si queremos introducir números decimales, debemos usar el carácter que el sistema de la máquina tenga definido.

Ejemplo: 128,34

Fecha

Para introducir una fecha escribiremos el día, el mes y el año de forma independiente. Se usan dos dígitos para el día y para el mes y cuatro para el año. El formato de la fecha dependerá del sistema. Para especificar tanto el día como el mes y el año nos situaremos en la posición correspondiente y escribiremos el dato usando el teclado. Para pasar al siguiente pulsaremos el tabulador o la barra espaciadora.Si hacemos clic en los microscrollers que contiene el control, el dato editado (día, mes o año) se incrementará/decrementará, respectivamente, en una unidad.También es posible introducir una fecha seleccionándola en el calendario que se muestra al pulsar el botón del control.

Hora

Para introducir una hora escribiremos las horas, los minutos y los segundos de forma independiente. Se usan dos dígitos para cada uno de ellos. Para especificar tanto la hora como los minutos o los segundos nos situaremos en la posición correspondiente y escribiremos el dato usando el teclado. Para pasar al siguiente pulsaremos la barra espaciadora.

Tiempo

Se trata de un campo que incluye una fecha y una hora; la especificación de ambas se hará a través del teclado, tal y como se ha explicado en las anteriores.

Booelano

La edición de una celda de este tipo hará que aparezca un combo box en el que tendremos que seleccionar uno de los valores siguientes: verdadero o falso. Si seleccionamos “Verdadero”, una vez editada la celda, en la rejilla se mostrará un "Sí", en caso contrario se mostrará un "No".

Imagen

Para introducir la imagen tendremos que pulsar en el botón que aparece a la derecha de la celda al editarla. Esto hará que se abra el editor de imágenes.

Texto

Edición de campos de tipo objeto texto. Este tipo de campos contienen texto plano, sin formato. Para activar el modo de edición de la celda situaremos el foco en la misma y pulsaremos la barra espaciadora; también podremos comenzar a escribir el texto directamente. Para finalizar la edición del texto pulsaremos la combinación de las teclas Control + Fin o Control + Teclas de movimiento del cursor. También podremos escribir el texto en un editor de texto, para abrirlo, pulsaremos el botón que aparece a la derecha de la celda.

Una vez escrito el texto, si pulsamos el botón aceptar el editor será cerrado y el campo modificado. Si pulsamos el botón cancelar se cerrará el editor y se cancelará la edición del campo.

Texto enriquecido

Edición de campos de tipo objeto texto enriquecido. Este tipo de campos contienen texto con formato (fuentes, estilos de fuentes, etc.). Para activar el modo de edición de la celda pulsaremos la barra espaciadora o cualquier tecla numérica o alfabética. Para escribir el contenido debemos utilizar un pequeño editor de textos, que podremos abrir pulsando el botón que aparece a la derecha de la celda.

Si pulsamos el botón cancelar se cerrará el editor y se cancelará la edición del campo.

Navegante

Como su nombre indica, el Navegante permite navegar por la información contenida en las distintas tablas de datos del proyecto de datos ejecutada a través los enlaces declarados y usando los objetos visuales disponibles. Partiendo de una rejilla origen, se puede ir obteniendo información asociada de forma simple y rápida. Los resultados de las operaciones realizadas con el Navegante son visualizados en el objeto de lista público que seleccionemos.

Los navegantes se nutren de forma automática de los objetos disponibles en el proyecto. Cuando usamos alguna de las opciones de navegación, a maestro o plurales, además de presentar las tablas por las que podemos navegar, presenta los objetos correspondientes a las tablas que pueden usarse.

Los objetos que un navegante puede usar han de estar públicos. Si un objeto tiene el estilo Privado activo, el navegante no hará uso de estos objetos. Por tanto, si queremos que el usuario no pueda navegar a una tabla concreta, basta que no tenga objetos de lista disponibles correspondientes a esa tabla, es decir, que no tenga ningún objeto público, y ya no podrá navegar.

El Navegante puede utilizarse múltiples veces sin ninguna limitación. Puede combinar varias listas y utilizar de nuevo el Navegante con los resultados obtenidos, y así sucesivamente.

Las opciones disponibles son:

Maestros…

Esta opción nos permite ver los registros de una tabla maestra que están siendo apuntados por los registros de la lista actual. Al ejecutarla se presentará una ventana donde solamente se mostrarán los campos de la tabla que están enlazados a otras tablas y los objetos de lista públicos que podemos usar para ver dichos registros:

Seleccionar el campo y pulsar el botón aceptar para continuar o pulsar el botón cancelar para cancelar la navegación a maestros. Si aceptamos el sistema abrirá una nueva pestaña en el panel de registros con los registros de la tabla maestra que están siendo apuntados por los registros de la lista de origen.

Ejemplo: desde una lista de libros podremos obtener los autores de dichos los mismos.

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.

Plurales

Esta opción nos permite ver los registros de una tabla plural de un registro de la lista actual. Para ejecutar esta opción, por tanto, es necesario que hayamos seleccionado previamente un registro de la lista. Una vez seleccionado el registro y ejecutada esta opción, si la tabla tiene más de un histórico, se presentará una ventana para seleccionar el que se desea cargar y la selección del objeto de lista público que queramos usar para ver dichos registros:

Seleccionar el campo y pulsar el botón aceptar para continuar o pulsar el botón cancelar para cancelar la navegación a plurales. Si aceptamos el sistema abrirá una nueva pestaña en el panel de registros con los plurales de esa ficha.

En el caso de que la tabla tenga únicamente un plural, no se presentará el formulario para su selección sino que será abierta directamente la rejilla con los plurales de la ficha.

Esta opción puede dispararse mediante la pulsación de la tecle F4

Ejemplo: desde una lista de clientes podremos obtener todas las facturas de uno de ellos.

Este comando está optimizado de modo que se pasa el registro 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.

Plurales de todos…

Esta opción es igual que la anterior; la diferencia radica en que lo que cargará son los plurales de todos los registros de la lista actual.

De esta forma tan sencilla podemos controlar aquellas tablas a las que no queremos que el usuario final tenga acceso mediante la navegación.

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.

Navegación por esquemas

Permite realizar la navegación entre las tablas de forma visual. En el menú Navegante de Velneo vClient se añaden automáticamente todos los esquemas públicos que contengan la tabla en curso.

Si seleccionamos uno de los esquemas, este se abrirá en una ventana, con la tabla inicio marcada.

Si seleccionamos otra tabla con doble-click, se hará la navegación desde la tabla inicio a la tabla seleccionada, creando una nueva vista con el resultado.

Si encuentra varios caminos entre la tabla origen y la tabla destino, se desplegará un control para que podamos elegir uno de ellos. Al hacer doble-click sobre uno de los caminos, se realizará la navegación y se presentará el resultado en una nueva vista.