Índice de contenido -...

Velneo vClient 7.19

Índice de contenido¿Qué es Velneo vClient?......................................................................................................2Movilidad...............................................................................................................................3

iOS...................................................................................................................................4Recomendaciones programación para móviles................................................................5Problemas conocidos.....................................................................................................18

General...............................................................................................................................19Conexión con Velneo vServer.............................................................................................19Cambiar el estilo de visualización.......................................................................................21Rejillas................................................................................................................................22Comandos de ficha.............................................................................................................22Comandos de lista..............................................................................................................23Edición de campos en rejillas..............................................................................................31Navegante..........................................................................................................................34Ver/Ocultar barras de herramientas....................................................................................37Mensajería interna entre usuarios.......................................................................................38Soporte de alta resolución (HighDpi)..................................................................................39Funcionalidades específicas...............................................................................................39Accesos directos y VRL......................................................................................................40Cambiar el idioma...............................................................................................................42Panel de procesos en 2º plano...........................................................................................43Manejo de cestas de la compra..........................................................................................44Refrescos............................................................................................................................47Caché local.........................................................................................................................47Edición de campos enlazados a maestro............................................................................48

Verificación de la clave del maestro...............................................................................49Autocompletar................................................................................................................49

Asociación de impresoras lógicas a físicas.........................................................................49Actualización automática....................................................................................................53Personalización de la ventana de conexión........................................................................54

Personalización de Login mediante ficheros QML..........................................................56Uso de la rejilla avanzada...................................................................................................80Captura de imágenes desde cámara..................................................................................88

Pol. Ind. A Granxa, Edificio vCenterRúa D, esquina paralela 336400 Porriño (Pontevedra)España

Telf. (+34) 902 36 63 [email protected]

Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, Inscr 1ª

1

mailto:[email protected]

http://www.google.com/url?q=http%3A%2F%2Fvelneo.es&sa=D&sntz=1&usg=AFQjCNHynXn8DXeXcZiZwFTIrLbYsQgLfQ







Velneo vClient 7.19

¿Qué es Velneo vClient?Ejecutor de aplicaciones. Es el módulo cliente que nos permitirá de forma remota acceder como usuario a un proyecto de aplicación, utilizar los objetos visuales declarados en el mismo.

Es importante incidir que Velneo vClient sólo conoce los proyectos de aplicaciones, con lo que no será capaz de gestionar datos (proyectos de datos) directamente. La herramienta se conecta por VATP (Velneo Application Transfer Protocol) a Velneo vServer desde local o remoto y permite ejecutar los proyectos de aplicaciones.

Esta herramienta está enfocada a los usuarios finales de una aplicación.

Carece de interfaz propia ya que ésta está definida en el proyecto de aplicación ejecutado en cada momento. El acceso y manejo las bases de datos se hace a través del uso de los objetos visuales. Así por ejemplo con el uso de Búsquedas se manejan listas de datos y con los formularios se dan altas, editan y eliminan registros.

A partir de la versión 7.19 está soportada la ejecución en dispositivos retina o alta resolución DPI.

Si en una sesión de vClient tenemos varias pestañas abiertas, si cerramos una pestaña recién abierta, se activará la última pestaña del contenedor de pestañas, y no a la última abierta por el usuario.

Parámetros del instalador

/S: Este parámetro permite instalar Velneo vClient en modo silencioso o desatendido. Para ello no habrá más que añadirlo cuando se ejecute el instalador del componente.

/D: Este parámetro permite especificar la senda donde se instalará Velneo vClient, útil si vamos a insatlarlo en modo desatendido y queremos instalarlo en una senda distinta a la senda por defecto.

Ejemplo:

[senda]\velneo-win32-vclient-setup.exe /S /D=/senda/instalacion"

/noacc: Este parámetro indica al instalador que no cree el acceso directo. Si programamos nuestro propio instalador de aplicaciones y realizamos la instalación silenciosa del componente Velneo vClient utilizando el parámetro /S en la ejecución de la instalación, además de instalar el componente crea un acceso directo en el escritorio. Con este otro parámetro tenemos la posibilidad de indicar al instalador que no cree el acceso directo, para que la creación de dicho acceso directo la realices con tu software de creación de instalaciones.

Ejemplo:




2









Velneo vClient 7.19

[senda]\velneo-win32-vclient-setup-7-12-0.exe /noacc /S

En la desinstalación del componente también debemos usar el parámetro /noacc si queremos asegurarnos de que no se borrará el acceso directo existente.

Si ejecutamos la instalación y no especificamos /noacc, el instalador puede sobreescribir el icono existente, con este parámetro garantizamos no sólo que no nos crea un nuevo acceso directo, sino que además respetará cualquier acceso directo que ya exista.

MovilidadVelneo vClient está disponible para su uso tanto en dispositivos con sistema operativo Android como iOS. Están disponibles para su descarga en Apple Store y Play Store.

Instalación

Se trata del componente Velneo vClient V7 de la plataforma que permite la conexión a servidores de Velneo V7 desde dispositivos móviles con sistema operativo Android™.

Esta versión está disponible para dispositivos con procesador ARM y que ejecuten una versión 4.0 o superior del sistema operativo Android.

Para facilitar el uso de Velneo vClient en tu Android, lo podrás obtener a través de Google play de Google, donde podrás descargar e instalar Velneo vClient. Además, disfrutarás del servicio de actualización de Google play que puedes configurar para que te avise de nuevas versiones y te actualice de forma automática.

Se recomienda realizar la instalación conectado a una red Wifi, mejor que una conexión móvil. Esto agilizará el proceso de instalación y optimizará el uso de nuestros recursos de Datos móviles, en caso de disponer de los mismos.

Política de desconexión Wi-Fi para el uso posterior del cliente. En este aspecto debemos tener en cuenta que si durante la ejecución de Velneo vClient se produce un corte permanente en las comunicaciones, esto provocará una expulsión del cliente por parte del servidor al que estemos conectados. En este parámetro podemos configurar tres valores distintos:

• Al apagarse la pantalla: Esta opción apagará la Wi-Fi cada vez que se apague la pantalla, provocando el corte mencionado.

• Nunca si se está cargando la batería: Esta opción apagará la Wi-Fi, sólo en el caso de estar funcionando con la batería.

• Nunca: Esto evitará que el servidor desconecte la sesión de Velneo vClient, por este motivo.




3









Velneo vClient 7.19

Ejecución de instalable

Al comenzar la instalación de Velneo vClient en Android, lo primero que nos solicita el sistema es la asignación de permisos a la aplicación para los distintos recursos de que hará uso. Una vez aceptado el formulario para la asignación de permisos, podemos pulsar la opción Instalar, que realizará el proceso correspondiente.

Al finalizar la instalación, el instalable nos mostrará un mensaje indicando que el proceso ha finalizado correctamente. En el mismo formulario del mensaje de instalación finalizada tenemos la posibilidad de Abrir la aplicación. También podemos ejecutarlo desde los distintos accesos que nos ofrece Android (organizador de aplicaciones, accesos directos en escritorios, ajustes de aplicaciones, etc.)

Configuración de Velneo vClient V7

Para la administración de la aplicación en el sistema Android, debemos acceder al menú de ajustes, opción administrar aplicaciones y seleccionar Velneo vClient. Desde este menú podremos realizar las siguientes acciones:

• Borrar datos: Esta opción realiza el borrado del historial de servidores a los que nos hemos conectado desde el dispositivo móvil y el cacheado local de aplicaciones a las que nos hemos conectado también. Es conveniente hacerlo regularmente, sobretodo en dispositivos con reducido espacio en disco, si nos conectamos a aplicaciones diversas.

• Desinstalar: Con esta opción desinstalamos totalmente Velneo vClient de nuestro dispositivo móvil.

• Forzar detención: Opción solo activa durante la ejecución de Velneo vClient que permite detener el proceso.

Requerimientos mínimos

• Versión de Android: Mínimo 4.0, Recomendado 5.0.

• Procesador: ARMv7, mínimo 1GHz, Recomendado +1GHz.

• Memoria RAM: Mínimo 512 MB, Recomendado +1GB.

• Espacio en memoria de usuario/interna: Mínimo 200MB (Libre +65MB + Tamaño de proyectos), Recomendado +1GB.

• Pantalla para aplicaciones móviles: Mínimo 320x480 (móvil), para aplicaciones de escritorio sin reprogramar recomendado: 1024x768.

iOS




4









Velneo vClient 7.19

Instalación

Se trata del componente Velneo vClient de la plataforma que permite la conexión a servidores de Velneo desde dispositivos móviles con sistema operativo iOS.

Esta versión está disponible para dispositivos que ejecuten una versión 8.0 o superior del sistema operativo iOS.

Para facilitar el uso de Velneo vClient en tu iPhone o iPad, lo podrás obtener a través de Apple Store, donde podrás descargar e instalar Velneo vClient. Además, disfrutarás del servicio de actualización automática de tu dispositivo.

Política de desconexión Wi-Fi para el uso posterior del cliente. En este aspecto debemos tener en cuenta que si durante la ejecución de Velneo vClient se produce un corte permanente en las comunicaciones, esto provocará una expulsión del cliente por parte del servidor al que estemos conectados.

Requerimientos mínimos

• Versión de iOS: Mínimo 8.0

• Espacio en memoria de usuario/interna: Mínimo 200MB (Libre +65MB + Tamaño de proyectos), Recomendado +1GB.

• Pantalla para aplicaciones móviles: Mínimo 960x640 (móvil), para aplicaciones de escritorio sin reprogramar recomendado 1024x768.

Recomendaciones programación para móviles

Dispositivos y High dpi

Aunque es cierto que los móviles de última generación vienen con una resolución de gran tamaño (1920x1080 o incluso más), nuestra recomendación es desarrollar siempre pensando en una resolución de 1024x768. Después, y gracias al sistema gráfico de Velneo y al high dpi, todos los controles son escalados a la resolución en la que estemos ejecutando nuestra aplicación.

Desde un punto de vista técnico, existe lo que se conoce como “Device pixel ratio”. Éste se calcula dividiendo los puntos por pulgada del dispositivo (dpi) entre 72. Por ejemplo, un móvil que tiene dpi de 144, el Device pixel ratio será 2. El sistema gráfico se encarga de escalar todos los controles en función al “Device pixel ratio” (en el caso de Android, en la versión actual, sólo escala las fuentes). De esta manera, ya sea el dispositivo de de 144dpi o 496dpi, la cantidad de controles que se muestran son los mismos, pero con más resolución.

En Velneo todo esto se calcula de forma automática. El desarrollador no tiene que hacer nada especial.




5









Velneo vClient 7.19

Si queremos tener más control en tiempo de ejecución, podemos obtener el “Device pixel ratio” de nuestro dispositivo usando las nuevas instrucciones incluídas en la versión 7.19: el comando de instrucción de proceso get información pantalla y la nueva clase VScreen.

Algunas otras recomendaciones sobre el diseño de la interfaz son:

• Utilizar los controles con ajuste de layout por defecto, sin tamaño fijo. Esto permite al control adaptarse al contenido.

• Utilizar las rejillas con alto 0 en cabeceras y filas, ya que así se adaptarán al tamaño de la fuente que contiene.

• En css, cuando queramos que escale, utilizar el tamaño en pixeles. Si indicamos puntos, el control será específicamente de los puntos indicados.

Cuanto más queramos que nuestra aplicación se parezca a una aplicación nativa para Android o iOS, más aconsejable es tener un proyecto diferente para cada plataforma. Temas como la forma en que se muestra el menú o el ajuste de los controles aconsejan esta vía. De todas maneras siempre hay cosas que se pueden aprovechar para las dos plataformas y para eso podemos hacer uso de la clase vSysInfo, que nos permite saber entre otras cosas si estamos en un dispositivo iOS o Android.

Recomendaciones generales

Cuando adaptes tu aplicación para el uso en dispositivos móviles, ten en cuenta estas recomendaciones:




6









Velneo vClient 7.19

• En dispositivos móviles no se usa el drag&drop. Tendrás que sustituirlo por un control más acorde con esos dispositivos.

• De forma generalizada, los usuarios de dispositivos móviles están acostumbrados a salir de las aplicaciones con el botón Home del dispositivo. En ese momento la aplicación se queda en segundo plano. Esto provoca que si se supera el tiempo máximo de desconexión de enganche ( 5 mins), y el usuario vuelve a la aplicación, ésta está desconectada. Hay dos cosas que podemos hacer al respecto: una, dejar la barra de estado visible en la aplicación ya que es allí donde se informa de que se ha desconectado del vServer, y dos, subir el tiempo de desenganche, tal y como se indica en la documentación de Velneo vAdmin.

• El directorio home en iOS tiene restringida la escritura, es de solo lectura. El programador deberá usar otra ruta alternativa si necesita escribir.

• En iOS, los cuadros de diálogos que se lanzan con la instrucción Mensaje o con alert en vJavascript, siempre aparecen a pantalla completa.

Estructura de menú principal




7









Velneo vClient 7.19

En dispositivos móviles no es habitual el uso de pestañas, como en escritorio, así que es recomendable usar en el objeto marco AUTOEXEC el modo de arranque SDI.

Listas de registros




8









Velneo vClient 7.19

La mejor opción para mostrar listas en un dispositivo móvil, por usabilidad, es QML:

• Permite mostrar imágenes.

• Permite desplazamiento sobre la lista arrastrando un dedo, cuando no caben todos los registros en pantalla.

• Permite juegos visuales más atractivos para el usuario.

• Permite, como es común en móviles, hacer una capa de visualización y otra de edición.




9









Velneo vClient 7.19




10









Velneo vClient 7.19

Si optamos por usar el control rejilla, contamos con la cuentas con la opción Tap&Hold, es decir, si mantenemos presionada una fila, se abrirá el formulario tal y como hace el doble click en las versiones de escritorio.




11









Velneo vClient 7.19

Formularios

Es recomendable usar layouts y fuente de sistema en el diseño de los formularios, de forma que se adapten a las posiciones vertical y horizontal del dispositivo y los controles de edición tengan ancho y alto en layout por defecto para que adquieran el tamaño apropiado en función de la fuente.

Botones

Un ancho y alto de 9 mm es el tamaño recomendado (4,2 mm es el tamaño mínimo de un elemento para que pueda parecer pulsable).

Un espacio de 2 mm (al menos) de separación visual entre botones reduce la percepción de dificultad.

En resumen, los botones deben:

• Tener un tamaño suficiente para ser pulsados cómodamente.

• Alejarse de acciones peligrosas.

• Tener aspecto de botón.

Edición de fechas

La edición de fechas se puede realizar perfectamente con el control fecha en un dispositivo móvil. Ahora, si queremos más versatilidad o incluso algo más de usabilidad a la hora de que el usuario final introduzca una fecha, podemos recurrir a esta alternativa:




12









Velneo vClient 7.19

Al pulsar con el dedo en la fecha (señal Ratón: botón soltado) se muestra un subformulario con los datos de día, mes y año por separado. Los botones + y - ejecutan manejadores de evento en los que se modifica la fecha con las funciones addDays, addMonths y addYears.




13









Velneo vClient 7.19

Edición de horas

La edición de horas se puede realizar perfectamente con el control hora en un dispositivo móvil. Ahora, si queremos más versatilidad o incluso algo más de usabilidad a la hora de que el usuario final introduzca este dato, podemos recurrir a esta alternativa:




14









Velneo vClient 7.19




15









Velneo vClient 7.19

Al pulsar con el dedo en la hora (señal Ratón: botón soltado) se muestra un subformulario con los datos de hora y minutos por separado. Los botones + y - ejecutan manejadores de evento en los que se modifica la hora.

Utilidades genéricas (Email, Teléfono, Mapas, Whatsapp y SMS)

Podemos aprovechar para completar la funcionalidad de nuestra aplicación con utilidades genéricas que son realmente sencillas de desarrollar:

Para enviar un email

Ejemplo:


Para marcar el teléfono

Ejemplo:

tel:902366382

Para abrir mapas

Ejemplo:

geo:0,0?q=Polígono+Industrial+Granxa+Rúa+D+Esquina+Paralela+3+36400+Porriño+(PONTEVEDRA)

Para enviar un WhatsApp

Ejemplo:

whatsapp://send?text=Domi Fernandez%2066755667788%[email protected]




16









Velneo vClient 7.19




17









Velneo vClient 7.19

Para enviar un SMS

Ejemplo:

sms:66655667788?body=Hola, un saludo

CSS

El uso de CSS es igual de recomendable que en las versiones de escritorio para dar un aspecto más adecuado a nuestras aplicaciones móviles.

Formulario popup

Se aconseja que los controles de edición de datos se realicen desde formularios a pantalla completa o cuadro de diálogo. En dispositivos móviles no se deben usar formularios popup para la edición de datos desde controles.

Problemas conocidos

Android

• No dispone de soporte completo de alta resolución (high dpi) en dispositivos, únicamente se adaptan los tamaños de las fuentes de sistema.

iOS

• En la ventana del login, en algunas resoluciones, la fuente se ve con poca definición.

• La funcionalidad SSL no está disponible para el componente Velneo vClient iOS en esta versión.

• No está disponible la impresión de informes ni la presentación preliminar de los mismos.

• No está disponible el control visor html. Por cuestiones de limìtación de licencia no es posible hacer uso del navegador propio de Velneo.

• La calidad de visualización de las imágenes en el control objeto dibujo, SVG y campo objeto dibujo es baja. En dispositivos retina las imágenes se ven pixeladas cuando las visualizamos en un control de edición de campos tipo objeto dibujo. La calidad del contenido del campo en disco no se ve afectada, se trata de un problema de visualización.

• El teclado nos ofrece de forma automática las opciones para copiar, cortar y pegar textos con el portapapeles, pero desde un control de edición estas opciones no son funcionales.




18









Velneo vClient 7.19

• En una rejilla si tenemos visible la multiselección de las filas, es posible que se vean algunos cuadrados negros en lugar de la imagen de selección o el cuadro para seleccionar.

GeneralEn este apartado veremos funcionalidades comunes a los distintos componentes de Velneo.

Conexión con Velneo vServerSea cual sea el producto que usemos de la plataforma, éste requerirá la conexión con un Velneo vServer.

La ventana de conexión a Velneo vServer es idéntica en todos los casos y es la siguiente:

En ella tendremos que especificar:

Servidor: Nombre o IP del servidor donde se encuentra a la escucha el servicio de Velneo vServer. Debe ir precedido del esquema "vatp://".

Ejemplo: vatp://velneo.com

Si el servidor con el que nos vamos a conectar tiene activado el protocolo VATPS, tan sólo tenemos que sustituir VATP por VATPS en nuestra vrl de conexión. Por ejemplo:

vatps://velneo.com

Si se produce un error de TLS/SSL, aparece en la barra de estado de la ventana de conexión una opción para ver las excepciones que se han producido y permite ignorarlas.




19









Velneo vClient 7.19

No es posible conectarnos usando VATPS contra un servidor que no admita conexión segura ni viceversa, conectarnos por VATP contra un servidor que requiera conexión segura.

Usuario: Nombre de un usuario declarado en Velneo vServer.

Contraseña: Contraseña del usuario declarado en el parámetro anterior.

En la instalación de Velneo vServer se crea por defecto un usuario llamado velneo, sin contraseña, para que podamos comenzar su administración.

Si aceptamos, se procederá a la conexión con Velneo vServer, mostrándose en la parte inferior del formulario de conexión el progreso de la conexión. Si no es posible establecer la conexión el sistema devolverá el siguiente mensaje en la parte inferior izquierda del formulario de conexión: "Error conexión con el servidor".

Si el servidor es encontrado pero hemos introducido mal el usuario o la contraseña, el sistema devolverá el mensaje de error siguiente: "Usuario/Contraseña incorrectos".

Si el servidor está disponible y los datos de acceso son correctos, entonces accederemos al interfaz del producto ejecutado. En el caso de Velneo vClient, entonces accederemos a la ventana de selección de aplicación.




20









Velneo vClient 7.19

En la ventana se muestran todos los proyectos de aplicación accesibles para el usuario; en la captura de pantalla anterior se ve una lista. Si no apareciese ninguno quiere decir que el usuario no tiene ningún proyecto de aplicación asignado.

Para ejecutar un proyecto de aplicación tendremos que hacer doble clic sobre él.

Finalmente accederemos al interfaz del proyecto de aplicación.

Si estamos ejecutando una aplicación con Velneo vClient y se produce una interrupción de las comunicaciones, el timeout mínimo para que el servidor de por perdido en enganche y pase a eliminarlo es de 5 minutos. Esto quiere decir que al menos debe estar ese tiempo con la conexión interrumpida, para que el servidor de por extinguido ese enganche.

Si el servidor se encuentra realizando tareas importantes (procesos en 3º plano, regeneraciones, etc.) esta tarea de controlar los clientes no se efectúa, por lo que el tiempo de desconexión se vería aumentado.

En cualquier caso, el tiempo mínimo para que se produzca esa desconexión es de 5 minutos. Este timeout es configurable; para ampliar información sobre cómo cambiarlo consultar el capítulo enganche de Velneo vAdmin V7.

Cambiar el estilo de visualizaciónEs posible personalizar el estilo de visualización del interfaz de todos los ejecutables de Velneo.

Para ello debemos ejecutar la opción Ver/Personalizar/Estilos. El sistema desplegará una ventana con los estilos disponibles.

El estilo fusion permite homogeneizar la visualización de las aplicaciones en distintos sistemas operativos de una forma sencilla y muy adaptable.

Estilos sistema permite adaptarse a la configuración de estilo de la máquina en la que se ejecuta Velneo.

El cambio de estilo será aplicado inmediatamente después de su selección.

También es posible aplicar un estilo concreto mediante línea de comandos al llamar al ejecutable; para ello tendremos que poner en el argumento del ejecutable de Velneo el modificador: -style=Estilo, siendo Estilo el nombre del estilo concreto que queramos usar.

Por ejemplo, si queremos aplicar el estilo Fusion al ejecutar una instancia concreta, podemos crear un acceso directo que ponga:

"C:\Archivos de programa\Velneo\\vClient.exe" -style=Fusion "vatp://usuario:contraseña@dominio:puerto/ID_APP"




21









Velneo vClient 7.19

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

Comandos de fichaEn cualquier rejilla de Velneo vDataclient 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 traves 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 traves del

comando de la barra de herramientas, o pulsando la tecla Intro, 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:




22









Velneo vClient 7.19

Si una vez modificado el contenido de la celda queremos editar el de la siguiente o la anterior pulsaremos el tabulador o la combiació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.

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 traves del

comando 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 ejcutada 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 listaSe 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.

Filtrar:Esta opción sirve para filtrar una lista, es decir, para quitar de la lista aquellos registros que no cumplan una determinada condición. La condición a evaluar se establecerá por medio de




23









Velneo vClient 7.19

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.

Ejemplo:

Una vez establecida la condición, pulsar el botón para ejecutar el filtro o el botón

para cancelarlo.

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

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:




24









Velneo vClient 7.19

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 para reordenar la lista o el botón

para cancelar la ordenació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:




25









Velneo vClient 7.19

Una vez seleccionado el campo, pulsar el botón para multipartir la lista o el botón

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.

Quitar de la lista el seleccionado: Como su propio nombre indica, permite quitar un registro de una rejilla.

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:




26









Velneo vClient 7.19

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:




27









Velneo vClient 7.19

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

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 para continuar o el

botón 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:




28









Velneo vClient 7.19

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

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.

Ejemplo:




29









Velneo vClient 7.19

Una vez establecida la condición, pulsar el botón para continuar con la modificación

o el botón para cancelarlo.

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,casillero,ViewFlow). Al ejecutar esta opción el sistema mostrará una ventana con todos los objetos de lista públicos asociados a la tabla en curso:




30









Velneo vClient 7.19

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.

Edición de campos en rejillasEn este capítulo se explica de qué forma pueden ser editados los distintos tipos de campo en una rejilla editable.

Alfabético:




31









Velneo vClient 7.19

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 botones / , 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áqiuna tenga definido.

Ejemplo: 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 botones / , 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 .

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.




32









Velneo vClient 7.19

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 diractemente. 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:




33









Velneo vClient 7.19

Una vez escrito el texto, si pulsamos el botón el editor será cerrado y el campo

modificado. Si pulsamos el botón 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 se cerrará el editor y se cancelará la edición del campo.

NaveganteComo 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.




34









Velneo vClient 7.19

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 para continuar o pulsar el botón 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.




35









Velneo vClient 7.19

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 para continuar o pulsar el botón 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.

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.

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.




36









Velneo vClient 7.19

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.

Ver/Ocultar barras de herramientasEs posible hacer visibles u ocultar las barras de herramientas de cada uno de los componentes de Velneo.

Para ello accederemos a la opción Herramientas del menú Ver. Esto hará que se despliegue una ventana con todas las barras de herramientas de la aplicación:




37









Velneo vClient 7.19

Indica que la barra de herramientas es visible.

Indica que la barra de herramientas está oculta.

Mensajería interna entre usuariosLa mensajería interna es una funcionalidad disponible en todos los componentes de la plataforma. Permite el envío y recepción de mensajes de texto entre usuarios y también se utiliza para notificaciones automáticas del sistema.

Cuando recibimos un mensaje se muestra un icono o si es una alerta un icono con un mensaje de aviso en la esquina derecha de la barra de estado del marco del componente que tengamos abierto.

Al hacer clic sobre el icono o el texto de la barra de estado se nos mostrará el panel de mensajería interna.

Desde este panel podemos enviar un nuevo mensaje o responder a alguno de los recibidos.

Desde cualquier componente podemos acceder al panel de mensajes y alertas desde la mensajes y alertas del menú verde la barra de menú.

En Velneo vAdmin existe la posibilidad de enviar un mensaje a cualquier usuario desde la toolbar de la opción usuarios, donde se ha añadido un botón que permite enviar un mensaje al usuario seleccionado de la lista.

Añadir que también existen mensajes automáticos que el sistema nos envía por este canal.

Por el momento esta funcionalidad se encuentra en fase beta, ya que todavía no tiene incluídas todas las funcionalidades previstas para versiones futuras. Los mensajes, en esta versión se almacenan en memoria por lo que una vez cerrado el componente desaparecen de las bandejas.




38









Velneo vClient 7.19

Soporte de alta resolución (HighDpi)Velneo dispone de soporte de alta resolución para todos sus componentes, llamado comercialmente Retina Display o soporte HighDpi.

Todos los componentes, y en especial Velneo vClient y las aplicaciones que ejecuta, permiten su ejecución en entornos con alta resolución y se adaptan a la resolución, mostrándose las aplicaciones con el mismo tamaño aparente pero con mayor resolución.

Este soporte está disponible para Windows, Linux, OS X e iOS. En Android, el soporte es parcial todavía en la versión 7.19, permitiendo que los tipos de letra de sistema se adapten a la resolución, alto de cabeceras y filas en rejillas, y algunos otros elementos.

En el soporte de alta resolución tenemos el concepto de Ratio de píxeles del dispositivo (device pixel ratio) que tiene valor 1 cuando el dispositivo tiene un DPI normal, y valor 2 cuando es de alta resolución.

En éste último caso, la resolución física es el doble de la resolución lógica. Esto quiere decir que se escalará la representación, mostrando los elementos con el doble de tamaño físico, pero el tamaño lógico se mantendrá.

Nota: En el caso de Linux, la adaptación requiere configurar el valor de la variable de sistema operativo QT_DEVICE_PIXEL_RATIO según el valor del pixel ratio de la pantalla. En el resto de dispositivos, este valor se aplica de forma automática. En Windows, la variable correspondiente al pixel ratio devolverá siempre el valor 1, ya que en la versión 7.19 no es capaz de detectar que ha cambiado el dpi, pero indicará correctamente el ancho y alto disponibles en píxeles de acuerdo a la configuración dpi establecida.

Funcionalidades específicasVelneo vClient incorpora una serie de funcionalidades generales comunes a cualquier aplicación Velneo. Estas son:

Conexión con Velneo vServer: Explicación de cómo podemos conectarnos con un Velneo vServer para ejecutar una aplicación.

Interfaz:

• Cambiar el estilo de visualización de la aplicación: Explica cómo cambiar el estilo visual de las aplicaciones.

• Cambiar el idioma: Explica como cambiar el idioma de nuestras aplicaciones.

• Ver/Ocultar barras de herramientas.




39









Velneo vClient 7.19

Funcionamiento del editor de imágenes.

Funcionamiento del asistente para edición de fórmulas.

Comandos disponibles en rejillas:

• Comandos de ficha.

• Comandos de lista.

• Edición directa de campos en rejillas.

• Navegante.

Accesos directos y VRLEs posible crear un acceso directo a las instancias de Velneo vServer.

Para ello debemos crear un acceso directo con el siguiente formato:

/senda/ejecutable vatp://usuario:contraseña@dominio:puerto/instancia

Está compuesto en primer lugar por la senda de Velneo vClient (fichero vClient.exe), que necesitaremos para poder lanzar el ejecutable.

La segunda parte se trata de la VRL (Velneo Resource Locator), que está compuesta por el esquema o protocolo (vatp), el usuario y la contraseña separados por dos puntos (:), el dominio o ip del servidor y el puerto, separados por dos puntos (:) y la senda, que es el identificador de la instancia a la que queremos acceder.

Por ejemplo, en el sistema operativo Windows se escribiría de la siguiente forma:

[code]"C:\Archivos de programa\Velneo\\vClient.exe" "vatp://usuario:contraseñ[email protected]:6001/GESTION"[/code]

para conocer el identificador de la instancia usaremos Velneo vAdmin haciendo doble clic sobre la definición de instancia:




40









Velneo vClient 7.19

El contenido de este parámetro solamente podrá contener letras mayúsculas, números y guiones bajos _.

Si queremos que en lugar de acceder directamente al proyecto el sistema pida la contraseña del usuario indicado en el acceso directo escribiremos el carácter * en el parámetro correspondiente a la contraseña:

[code]"C:\Archivos de programa\Velneo\\vClient.exe" "vatp://usuario:*@v7cloud3.velneo.com:6001/GESTION"[/code]

En el caso de que el usuario o la contraseña incluya caracteres especiales tales como @, \, etc. éstos no podrán ser escritos directamente en la cadena sino que tendrán que ir codificados en su equivalente html (%CODIGO_CARACTER). Ejemplo:

Ejemplo: Si la contraseña del usuario es 123@45, la especificaríamos así: 123%4045




41









Velneo vClient 7.19

Si queremos que el proyecto se ejecute con un idioma concreto, usaremos el parámetro /loginLocale o /llo (forma abreviada)

El parámetro del idioma se especificará según la norma ISO-639-1 (http://es.wikipedia.org/wiki/ISO_639-1). Ejemplo, para cargar el idioma español haríamos:

[code]"C:\Program Files (x86)\Velneo\\716RC\vClient.exe" /llo="es"[/code]

o

[code]"C:\Program Files (x86)\Velneo\\716RC\vClient.exe" /loginLocale="es"[/code]

Si queremos que la ventana de la aplicación se abra con un tamaño concreto y en unas coordenadas concretas, usaremos el parámetro -qwindowgeometry. Sintaxis:

-qwindowgeometry anchoPixelsxaltoPixels+ejeX+ejeY

Ejemplo: [code]"C:\Archivos de programa\Velneo\\vClient.exe" "vatp://usuario:contraseñ[email protected]:6001/GESTION" -qwindowgeometry 800x600+ 500+500[/code]

Si queremos ejecutar un vClient sin interfaz, usaremos el parámetro -platform minimal. Ejemplo:

[code] "C:\Archivos de programa\Velneo\\vClient.exe" "vatp://usuario:contraseñ[email protected]:6001/GESTION" -platform minimal[/code]

Debemos tener en cuenta que esta opción es para la ejecución en sistema operativos sin GUI y que para la impresión de informes (tanto en pdf como en impresora) se requiere acceso a interfaz/GUI, con lo que no podremos realizar impresión de informes ejecutando de este modo.

En Linux, para crear un acceso directo a una instancia, lo que haremos será crear un lanzador en el escritorio, y estableceremos el comando siguiendo la estructura siguiente:

/rutadeinstalacion/Velneo-vClient/vClient.sh vatp://usuario:contraseña@dominioservidor:puerto/IDINSTANCIA

Cambiar el idiomaCon los menús en stock Ver, Personalizar e Idiomas, tras conectarnos a la instancia aparecerán el idioma del sistema y los idiomas del proyecto principal.




42









Velneo vClient 7.19

Al elegir un idioma puede ocurrir que no exista en los idiomas internos de. En este caso pondrá los textos internos de Velneo en el idioma del sistema. Si dicho idioma no existe los pondrá en español.

También puedes definir el idioma con que arrancarán las aplicaciones configurando en el registro correspondiente a Velneo vClient, el idioma requerido. Para ello tienes las siguientes claves:

Locale: Podemos indicar en el formato id_PA (dos letras para el idioma en minúscula, ISO 639, dos letras para el país en mayúscula (ISO 3166), el idioma que queremos para la ejecución.

IsTheSystemLocale: Debemos indicar false, si queremos que tome el valor de Locale.

Por ejemplo, en Windows sería:

HKEY_CURRENT_USER\Software\Velneo\vClient\Locale = “ca_ES”

HKEY_CURRENT_USER\Software\Velneo\vClient\IsTheSystemLocale = false

Cuando escogemos idioma de sistema, en Windows y Mac, además se toma de la configuración regional del sistema (número, moneda, fecha, etc.) pero, en el caso de Linux, al escoger el idioma del sistema, la configuración regional del sistema la toma del .estándar ICU

Panel de procesos en 2º planoSe trata de un panel que nos permite monitorizar los procesos, las colas y los servicios Protocolo TCP/IP que están siendo ejecutados en multitarea.




43









Velneo vClient 7.19

En la parte superior se muestra la lista de procesos, en la media la lista de colas y en la parte inferior los servicios de servidor de Protocolos TCP/IP iniciados en la máquina en curso. Si en el momento de la consulta hay en ejecución algún proceso de una cola, éste será mostrado en una subrama de la misma.

De los procesos en ejecución podremos obtener la siguiente información:

• Nombre: Nombre del proceso.

• ID.: Numerador que Velneo vServer usa internamente para identificar la transacción.

• Estado: Del proceso (Ejecutando, Detenida, Deshecha, etc).

• % realizado: Información sobre el porcentaje realizado del proceso.

De los servicios TCP-IP podemos obtener la siguiente información:

• Puerto: Número de puerto en el que el servicio TCP está a la escucha.

• Servicio: Nombre del servicio TCP.

• Conexiones: Número de conexiones realizadas por clientes TCP con ese servicio.

Manejo de cestas de la compra




44









Velneo vClient 7.19

Desde rejillas de Velneo vClient podremos interactuar con cestas de la compra declaradas como públicas en un proyecto.

Si en la aplicación existe alguna cesta de la compra asociada a la misma tabla de datos que la rejilla, en el menú de contexto que se abre al pulsar el botón derecho del ratón sobre una rejilla, aparecerán las siguientes opciones:

Enviar seleccionadas a la cesta: Envía el/los registros seleccionados en la rejilla a la cesta de la compra activa. A una misma cesta se podrán enviar registros desde cualquier rejilla de una misma tabla de datos. Si se añade un registro a una cesta y ésta ya lo contenía, no se incluirá.

Enviar todas a la cesta: Envía todos los registros de la lista a la cesta de la compra activa.

Abrir cestas: Abre una ventana que mostrará todas las cestas de la compra disponibles para esa tabla, cada una en una pestaña diferente, y su contenido:




45









Velneo vClient 7.19

Para ver el contenido de una cesta concreta, pulsaremos sobre la pestaña correspondiente a la misma.

Desde esa ventana podremos realizar las siguientes operaciones con la cesta activa:

Mover los seleccionados: Mueve los registros seleccionados en la cesta de la compra a la rejilla activa. Si alguno de los registros seleccionados ya existe en la rejilla de destino, no lo incluirá.

Copiar los seleccionados: Copia los registros seleccionados en la cesta de la compra a la rejilla activa. Si alguno de los registros seleccionados ya existe en la rejilla de destino, no lo incluirá.

Quita los seleccionados: Quita los registros seleccionados de la cesta de la compra. Los registros serán quitados de la lista, no borrados de la base de datos.

Seleccionar todos: Selecciona todos los registros de la cesta de la compra activa.

Salir: Cierra la ventana.




46









Velneo vClient 7.19

En el caso de existir más de una cesta asociada a la misma tabla de datos, para indicar al sistema sobre qué cesta queremos trabajar, tendremos que ejecutar en previamente la opción Abrir cestas del menú de contexto de la rejilla y acceder a la pestaña correspondiente a la cesta deseada.

Es posible que en la aplicación se haya programado una vista permanente de una cesta de la compra; en ese caso, cada vez que interactuemos durante nuestra sesión de Velneo vClient con la cesta de la compra, su contenido será refrescado automáticamente.

La persistencia de la cestas es en memoria, esto quiere decir dos cosas:

1) Que al cerrar nuestra sesión de Velneo vClient su contenido desaparecerá.

2) Que su contenido no es compartido por otros usuarios u otras sesiones de Velneo vClient que estén ejecutando el mismo proyecto.

RefrescosDurante la edición de fichas o registros de tablas durante la ejecución de una aplicación Velneo vClient efectúa lo que llamamos refrescos primarios y secundarios de datos; a continuación explicaremos en qué consiste cada uno.

Refresco primario: Es el refresco directo, motivado por el contenido inicial o la fórmula de un campo. Por ejemplo, si el campo TOTAL = CANTIDAD * PRECIO, cuando en un formulario modificamos CANTIDAD o PRECIO se recalculará y se refrescará el campo TOTAL.

Refresco secundario: Es el refresco indirecto, por ejemplo, derivado de una actualización o un evento de tabla. Por ejemplo, cuando desde una línea de factura acumulamos, mediante una actualización, el total de la línea en el campo TOTAL de la factura.

Además, una cesta de la compra, cuando es disparada como dock de un marco, el contenido de la misma será refrescado automáticamente por el sistema, a medida que vayamos operando con la misma en una misma sesión de Velneo vClient, o bien a través de procesos, o bien por su manejo por parte del usuario final.

Caché localPara mejorar el rendimiento de Velneo vClient éste genera una caché local de archivos a nivel de usuario.

La caché local es generada por máqiuna y usuario, es decir, que si en una misma máquina se inician sesiones de usuario diferentes, cada usuario tendrá su propia caché local.




47









Velneo vClient 7.19

Esta caché es generada físicamente en el directorio home del sistema del usuario, en una carpeta llamada Velneo.

En Windows:

[code]C:\Users\USUARIO\Velneo\cacherun o C:\Documents and Settings\USUARIO\Velneo\cacherun[/code]

En Linux:

/home/USUARIO/Velneo/cacherun/

En esta caché local se almacena lo siguiente:

Los proyectos que se ejecuten (en una sub-carpeta llamada cacherun).

Los Ficheros adjuntos declarados en los proyectos que se ejecuten (en la misma sub-carpeta que los proyectos).

Los archivos de conexión de impresoras lógicas a físicas (en una sub-carpeta llamada printers).

El hacer uso de la caché de aplicación redundará en una mejora en los tiempos de ejecución de la misma ya que, al pedírsela a Velneo vServer para su ejecución, si ya la tenemos en caché, no tendrá que enviarla de nuevo sino que se hará uso de la de la caché. Por tanto, Velneo vServer solamente tendrá que enviarla al cliente en su primera ejecución y cuando haya nuevas versiones de la misma.

Hay que asegurarse de que el usuario tenga permisos de acceso de escritura en su carperta de la caché local, de lo contrario, en el caso de proyectos que incluyan ficheros adjuntos, dichos proyectos no podrán ser ejecutados.

Edición de campos enlazados a maestroCuando en un control de edición editamos campos de una tabla enlazada a otra tabla maestra, por ejemplo, los campos Código (ID) y Nombre (NAME) del maestro, a la derecha del control se incluyen unos botones que nos permitirán recorrer, hacia arriba o hacia abajo, uno a uno los registros del maestro para localizar uno.

Si por ejemplo, el campo editado es el código numérico del maestro, recorreremos la lista maestra por orden de código, es decir, si estando el edit vacío pulsamos la flecha hacia arriba se capturará el registro con el código más bajo, si volvemos a pusar, cargaremos el siguiente y así sucesivamente. Si pulsamos el botón con la flecha hacia abajo cargaremos el registro anterior.




48









Velneo vClient 7.19

Estas mismas acciones podremos hacerlas a través del teclado, usando las teclas del cursor arriba y abajo, respectivamente.

Estos controles de edición de capmos de maestro, además tienen las funcionalidades siguientes:

Verificación de la clave del maestro

Cuando en un control de edición se está editando el campo código (ID) de un maestro, si escribimos un código, al perder el foco el control el sistema comprobará si existe. Si existe, atrapará el registro y el cursor se posicionará en el siguiente control, si no existe, el sistema borrará el dato introducido y mantendrá devolverá el foco al control para que el usuario vuelva a escribir un valor correcto.

Autocompletar

Cuando en un control de edición se está editando el campo nombre (NAME) de un maestro, si escribimos una cadena y esperamos unas décimas de segundo, el sistema automáticamente atrapará el primer registro que comience por esa cadena, dejando seleccionada la parte añadida para que el usuario pueda sobrescribirla en caso de que sea necesario:

Asociación de impresoras lógicas a físicas




49









Velneo vClient 7.19

Esta opción permitirá conectar impresoras lógicas declaradas en el proyecto ejecutado con impresoras físicas.

Al ejecutarla se presentará el siguiente cuadro de diálogo:

En la primera columna se muestra la lista de impresoras lógicas declaradas en el proyecto.

Por cada impresora lógica seleccionaremos en la segunda columna la impresora física asociada:




50









Velneo vClient 7.19

Si no queremos asociar ninguna impresora física a una impresora lógica, entonces seleccionaremos el valor Sin conectar.

En sistemas operativos Windows aparecerá una tercera columna, en la que podremos seleccionar el origen del papel (bandeja) de la impresora:




51









Velneo vClient 7.19

En Linux y Mac esta opción no está disponible.

La lista de bandejas que aparece es una lista estándar, y es la que debe aparecer para todas las impresoras.

Las equivalencias dependen de cada driver, por lo que, a priori, no es posible indicar cuál es la equivalencia directa.

La forma recomendada para configurar la bandeja es asignar la impresora lógica en el momento de la impresión, configurando en ese preciso momento la bandeja requerida.

A este respecto, aclarar que, cuando no hemos establecido la conexión entre una impresora lógica y una física, la primera vez que imprimamos un informe asociada a la misma, el sistema nos pedirá la impresora; seleccionaremos el driver, configuraremos bandeja, etc. y aceptaremos. Y esa configuración es la que guardará la impresora lógica.

Una vez hecho esto e impreso el informe, si revisamos las propiedades de esa impresora lógica, ya podremos ver cuál es la relación entre la bandeja lógica y la física.

De todos modos, añadir que no todos los drivers son estándar, de hecho, muchos tienen nombres propios para las bandejas, incluso saliendo del rango estándar. De ahi que en ocasiones pueda suceder que veamos un numero en lugar de un nombre en la relación entre bandeja lógica-física.




52









Velneo vClient 7.19

Cuando lo que se muestra es un número, no será posible la asignación de bandejas desde el panel de impresoras lógicas, sino que debemos seguir el método anteriormente comentado, ya que indica que el driver no sigue el estándar de bandejas.

Si el informe tiene asociada una impresora lógica y ésta ha sido asociada a una impresora física, cuando se mande imprimir el informe éste será enviado directamente a la impresora.

La asociación de impresoras lógicas a físicas será almacenada en caché local de Velneo vClient.

La caché local es generada por máquina y usuario, es decir, que si en una misma máquina se inician sesiones de usuario diferentes, cada usuario tendrá su propia caché local.

Dicha configuración es permanente; es decir, se mantiene al finalizar la sesión de Velneo vClient.

Actualización automáticaA partir de la versión 7.9 se contempla la actualización automática de los componentes de nivel 1 de la plataforma (vDevelop, vAdmin, vClient y vWebClient) a través de Velneo vClient.

Esto quiere decir que, cuando nos conectemos con un Velneo vClient v7 a un Velneo vServer de una versión diferente, el sistema preguntará al usuario si desea actualizar los componentes de nivel 1 a la versión adecuada de ese vServer. Ejemplo: Al conectar un Velneo vClient versión 7.9 con un Velneo vServer versión 7.10.

Podrás aprovechar esta actualización automática con las próximas versiones o revisiones.

El funcionamiento es el siguiente:

Cuando arrancamos Velneo vClient el sistema comprobará cuál es el último Velneo vServer con el que se ha conectado y comprueba su versión. Si ésta es diferente a la de Velneo vClient, se procedará a la actualización de los componentes de nivel 1. El módulo que se encarga de realizar este trabajo se llama Velneo vUpdater.

En la versión actual, solamente es funcional en Windows.

Lógicamente, para que este sistema de actualización sea funcional, la máquina tendrá que tener salida a Internet.

IMPORTANTE: Como hemos indicado antes, en la versión actual se actualizarán los componentes de nivel 1 (Velneo vDevelop, Velneo vAdmin, Velneo vWebClient y Velneo vClient ). Para que la actualización sea automática y no requiera desinstalar previamente los componentes de pago, debemos instalar estos últimos en una carpeta distinta.

Una ejemplo de configuración válido para el nuevo actualizador es la siguiente:




53









Velneo vClient 7.19

En el directorio por defecto “” instalar: Velneo vAdmin, Velneo vClient, Velneo vDevelop y Velneo vWebClient.

En el directorio “_79”, por ejemplo, instalar: Veleno vServer, Velneo vDataClient, Velneo vInstallBuilder, Velneo vModApache y Velneo vTranslator.

En el directorio “_79/ODBCDriver”, por ejemplo, instalar: Velneo ODBCdriver.

A partir de la versión 7.14, se ha mejorado la personalización de Velneo, incorporando la personalización de Velneo vUpdater. Este componente asumirá las personalizacionesrealizadas de la ventana de conexión de Velneo vClient, incorporando el icono y las imágenes que se configuren en dicha personalización.

Importante: Se necesitan privilegios de administración para que se pueda llevar a cabo la actualización automática de los componentes.

Personalización de la ventana de conexiónCuando ejecutamos Velneo vClient, se presenta la ventana de conexión con Velneo vServer

Mediante la creación de una serie de valores en el registro del sistema operativo de Velneo vClient, podremos personalizar determinados elementos de la misma:

En primer lugar, debemos crear la siguiente clave:

Windows: HKEY_CURRENT_USER/Software/Velneo/vClient/Login




54









Velneo vClient 7.19

Linux:

$HOME/USUARIO/.config/Velneo/vClient.conf/Login

Mac:

/users/USUARIO/Library/Preferences/com.Velneo.vClient.plist/Login

Y los valores que podemos crear dentro de dicha clave son:

Title: Para personalizar el título de la ventana de conexión.

Image: Para personalizar la imagen de la ventana de conexión. En dicho valor estableceremos una senda en disco o una url de un fichero de imagen.

ImagePosition: Para indicar la posición de la imagen anterior dentro de la ventana de conexión. Los valores posibles son: top, left o right.

WindowIcon: Para personalizar el icono de la ventana de conexión. En dicho valor estableceremos una senda en disco o una url de un fichero de imagen.

Ejemplo:




55









Velneo vClient 7.19

Esta es una configuración centralizada para todos los vClient. Con esta opción de parámetros en el registro, podemos configurar corporativamente todos nuestros accesos desde vClient a todas las aplicaciones.

También es posible personalizar nuestro formulario de login en función de los parámetros de arranque de Velneo vClient. Esta opción permite que cada acceso directo pueda tener una personalización específica.

Los parámetros de acceso tienen un nombre largo y un nombre abreviado, podremos usar cualquiera de los dos indistintamente.

Los parámetros de arranque de Velneo vClient que debemos utilizar son:

loginTitle: título de la ventana de conexión. El nombre abreviado del parámetro es lt.

loginWindowIcon: ruta del fichero o URL de la imagen de icono de la barra de título. El nombre abreviado del parámetro es lwi.

loginImage: ruta del fichero o URL de la imagen de la ventana de conexión. El nombre abreviado del parámetro es li.

loginImagePosition: posición de la imagen de la ventana de conexión. Puede ser: “top”, “left” o “right”. El nombre abreviado del parámetro es lip.

loginLocale: idioma del vClient. El nombre abreviado del parámetro es llo. El idioma tenemos que especificarlo siguiendo la sintaxis siguiente:

idioma[_país]

Idioma: son dos letras minúsculas con el código del idioma según la norma ISO 639-1.

País son dos letras mayúsculas que identifican al país según la norma ISO 3166-1.

Ejemplo: /loginLocale=es_ES

Estos parámetros serán incluidos en el acceso directo después de la especificación de la senda de Velneo vClient.

Si tenemos configurado nuestro Velneo vClient para que el cuadro de diálogo del Login muestre personalizado el título, icono e imagen y su posición, tanto mediante parámetros en el acceso directo como mediante entradas en el registro de configuración del sistema, a partir de la versión 7.12 se mantendrá dicha personalización cuando se deba efectuar la actualización automática de Velneo vClient.

Personalización de Login mediante ficheros QML




56









Velneo vClient 7.19

Funcionalidad disponible a partir de la versión 7.14. Permite diseñar en QML, con ayuda del API de Velneo para QML, las ventanas de conexión y selección de instancia cuando ejecutas Velneo vClient.

La funcionalidad de Login QML nos permite personalizar el aspecto de la ventana de conexión y la ventana de selección de instancia de Velneo vClient, la interacción con el usuario y la forma en que se conecta, por medio de ficheros QML, permitiendo definir la construcción de la VRL (vatp://domino:puerto) para la conexión y gestionando la selección de instancia.

Para definir la ventana de conexión usaremos el fichero Login.qml, y para definir la ventana de selección de instancia usaremos el fichero Instances.qml.

Podemos personalizar el aspecto completo de la ventana de conexión de Velneo vClient por lo que podremos diseñar nuestra propia ventana de conexión partiendo de cero, con el aspecto, logos e información que nos interese presentar al usuario.

De igual forma, la ventana de selección de instancias también es enteramente personalizable por lo que podemos incluir la información e imágenes que nos interese presentar además de la información de instancias.




57









Velneo vClient 7.19

Podemos aprovechar por tanto la potencia del lenguaje QML para adecuar ambas ventanas a la imagen de nuestra marca o producto.

También podremos personalizar la forma en que el usuario interacciona y en que se realiza el acceso, por ejemplo:

Estableciendo una lista de datos de acceso fijos entre las que el usuario elegirá, es decir, datos de acceso predeterminados no modificables por el usuario en la ventana de conexión y que incluyan toda la información de acceso: VRL, usuario y contraseña por defecto, permitiendo al usuario introducir la contraseña.




58









Velneo vClient 7.19

Conectarse de forma directa sin solicitar información al usuario o solicitando únicamente usuario y contraseña.




59









Velneo vClient 7.19

Datos de acceso configurables de forma completa por el usuario, con mantenimiento de VRL, usuario y contraseña correspondientes, guardados en offline.




60









Velneo vClient 7.19

Incluir información personalizada asociada a las conexiones (nombre o alias del servidor y/o aplicación), y mostrar únicamente esta información para la conexión, evitando mostrar la información de conexión usada realmente.

Realizar la configuración de acceso por medio de ficheros xml de definición de datos de acceso independientes del fichero QML, que puede ser común a los usuarios.




61









Velneo vClient 7.19

Obtener los datos de acceso del sistema y acceder a la información de las últimas conexiones.




62









Velneo vClient 7.19

Conectarse de forma directa a una aplicación en el caso de haber una única instancia disponible para el usuario.




63









Velneo vClient 7.19

Configuración de los ficheros QML

Existen dos formas de configurar el uso de los ficheros de configuración QML del login y las instancias en Velneo vClient:

• Los ficheros Login.qml e Instances.qml se encuentran en la misma carpeta que el ejecutable de Velneo vClient. Velneo vClient tomará en primer lugar estos fichero si los encuentra en la misma carpeta en la que se encuentra el ejecutable.

• Hemos definido en la rama de registro /Velneo/vClient/Login/QmlLogin dónde se encuentra el fichero Login.qml y en la rama /Velneo/vClient/Login/QmlInstances dónde se encuentra el fichero Instances.qml. En segundo lugar, si no encuentra los ficheros antes, mirará si existen estas claves de registro para definir la configuración.

Clases, objetos y funciones para Login.qml

En el fichero Login.qml podremos hacer uso de la clase VLogin, que tiene las funciones necesarias para realizar la conexión.

En este fichero dispondremos del objeto theLogin ya creado que nos permitirá ejecutar estas funciones.

VLogin




64









Velneo vClient 7.19

Esta clase representa la conexión de Velneo vClient V7 y dispone de las funciones necesarias para realizar la conexión.

El objeto theLogin

El script QML está conectado al objeto theLogin que representa la ventana de conexión en curso.

Funciones

Funciones de información

String user()

String server()

model servers()

Funciones de conexión

void setServer( String szVRL )

void setUser( String szUser )

void setPassword( String szPasswd )

void accept( void )

void reject( void )

Funciones de error

void errorText( void )

Funciones de marco

void setWindowTitle( String szTitle )

void setWindowIcon( String szPath )

Documentación de funciones

Documentación de funciones de información

String user()

Devuelve el nombre del último usuario usado para conectarse. Esta información es la misma que se muestra en la ventana de conexión estándar y se devuelve por cada usuario del sistema operativo.

String server()




65









Velneo vClient 7.19

Devuelve la última senda VRL usada para conectarse. Esta información es la misma que se muestra en la ventana de conexión estándar y se devuelve por cada usuario del sistema operativo.

model servers()

Devuelve un modelo con el histórico de sendas VRL usadas para conectarse. Esta información es la misma que se muestra en la ventana de conexión estándar y se devuelve por cada usuario del sistema operativo.

Por cada ítem del modelo dispondremos de la propiedad modelData que contiene la VRL correspondiente y que podemos usar para presentar la información al usuario.

Documentación de funciones de conexión

void setServer( String szVRL )

Establece el valor de VRL, es decir, el dominio y puerto del servidor al que nos conectaremos.

void setUser( String szUser )

Establece el usuario del servidor al que nos conectaremos.

void setPassword( String szPasswd )

Establece la contraseña del usuario del servidor al que nos conectaremos.

void accept( void )

Realiza la conexión una vez establecidos los parámetros de conexión VRL, usuario y contraseña.

void reject( void )

Cancela la ventana de conexión y por tanto el proceso de conexión.

Documentación de funciones de error

void errorText( void )

Devuelve el mensaje de error en el caso de que falle la conexión, la contraseña sea errónea, etc.

Documentación de funciones de marco


Establece el título que aparece en el marco. Para que se muestre el marco, hemos de establecer el título o una imagen como icono.





66









Velneo vClient 7.19

Establece la senda en disco de la imagen que aparecerá como icono en el marco. Para que se muestre el marco, hemos de establecer el título o una imagen como icono.

Documentación de funciones de configuración

void setLocale( String szLanguage )

Establece el idioma en el que se inicializará la aplicación. El parámetro del idioma se especificará según la norma ISO-639-1 (http://es.wikipedia.org/wiki/ISO_639-1). Ejemplo, para cargar el idioma español haríamos:

theLogin.setLocale( “es”);

Ejemplo

[code]

///////////////////////////////////////////////////////////////////////////////////////////////////

//

// Login Sin, Login.qml

//

// Ejemplo de Qml para login en V7.

// En este ejemplo se realiza la conexión de forma directa al servidor sin solicitar información al usuario.

// Los datos de acceso están definidos de forma predeterminada y no son modificables

// por el usuario (vatp://localhost, usuario velneo sin contraseña).

// Se accede de forma directa al listado de instancias que presenta el servidor.

//

import QtQuick 1.1




67









Velneo vClient 7.19

Rectangle

{

width: 240;

height: 120;

Component.onCompleted:

{

// Indicamos el título y el icono de la ventana

theLogin.setWindowTitle("Acceso al servidor sin login previo");

theLogin.setWindowIcon("icono.png");

}

Item

{

x: 10;

y: 5;

Image

{

width: 93

height: 25

source: "http://velneo.es/files/2011/02/logo_velneo-cab.gif"

fillMode: Image.PreserveAspectFit;

smooth: true;

asynchronous: true;

}

}

Text

{

id:textMsg




68









Velneo vClient 7.19

anchors.horizontalCenter: parent.horizontalCenter;

anchors.verticalCenter: parent.verticalCenter;

text: "Conectando con el servidor en la nube...";

wrapMode: Text.WordWrap;

}

Timer {

interval: 500; running: true; repeat: false

onTriggered:

{

// Nos conectamos

theLogin.setServer( "vatp://localhost" );

theLogin.setUser( "velneo" );

theLogin.setPassword( "" );

theLogin.accept();

textMsg.text = theLogin.errorText() + " " + theLogin.server();

}

}

}

[/code]

Clases, objetos y funciones para Instances.qml

En el fichero Instances.qml podremos hacer uso de la clase VInstance, que tiene las funciones necesarias para realizar la selección de instancia.

En este fichero dispondremos del objeto theInstances ya creado que nos permitirá ejecutar estas funciones.

VInstances

Esta clase representa la selección de instancias de Velneo vClient V7 y dispone de las funciones necesarias para realizar la selección y ejecución de la aplicación seleccionada.

El objeto theInstances




69









Velneo vClient 7.19

El script QML está conectado al objeto theInstances que representa la ventana de selección de instancia en curso.

Funciones

Funciones de información

model instancesModel( void )

Funciones de selección

void setInstance( Number index )

void accept( void )

Funciones de marco



Documentación de funciones

Documentación de funciones de información

model instancesModel( void )

Devuelve un modelo con la lista de instancias a las que tiene acceso el usuario en el servidor.

Por cada item del modelo dispondremos de las propiedades display y decoration. La propiedad display nos devolverá el nombre de la instancia y la propiedad decoration contendrá el icono que tiene asociado la instancia. Podremos usar ambos para presentar la información necesaria al usuario para que seleccione la instancia.

Documentación de funciones de selección

void setInstance( number index )

Establece la instancia que será ejecutada. Usaremos como parámetro el index o posición en la lista devuelta en el modelo (comienza a contar desde 0).

void accept( void )

Ejecuta la instancia seleccionada.

void reject( void )

Cancela la selección de instancia.

Documentación de funciones de marco





70









Velneo vClient 7.19

Establece el título que aparece en el marco. Para que se muestre el marco, hemos de establecer el título o una imagen como icono.


Establece la senda en disco de la imagen que aparecerá como icono en el marco. Para que se muestre el marco, hemos de establecer el título o una imagen como icono.

Ejemplo

[code]

///////////////////////////////////////////////////////////////////////////////////////////////////

//

// Instances.qml

//

// Ejemplo de Qml para la lista de instancias en V7.

//

// En el ejemplo se carga la lista de instancias y se muestra al usuario para que seleccione. Si únicamente




71









Velneo vClient 7.19

// hay una instancia, se carga ésta de forma automática.

//

import QtQuick 1.1

Rectangle

{

width: 480

height: 320


{

// Indicamos el título y el icono de la ventana

theInstances.setWindowTitle("Selecciona la aplicación");

theInstances.setWindowIcon("icono.png");

}

Item

{

x: 10;

y: 5;

Image

{

width: 93

height: 25

source: "http://velneo.es/files/2011/02/logo_velneo-cab.gif"

fillMode: Image.PreserveAspectFit;

smooth: true;

asynchronous: true;

}

}




72









Velneo vClient 7.19

Item

{

width: parent.width - 20;

height: parent.height - 100;


y: 40

Column

{

// Lista de instancias

id: instancesList

anchors.top: parent.top;

width: parent.width;

height: parent.height;

spacing: 10;

Text

{

text: "Lista de aplicaciones"

font.bold: true

}

Rectangle

{

id: instancesListRec


height: parent.height - 20;

border.color: "lightgrey";

border.width: 2;

radius: 10;




73









Velneo vClient 7.19

ListView

{

id: instanciasListView

anchors.fill: parent;

signal clicked;

clip: true;

focus: true;

Keys.onReturnPressed: aceptarBoton.clicked(Qt.LeftButton);

highlight

{

Rectangle {


height: 40;


color: "#E30B0B";

radius: 10;

y: instanciasListView.currentItem.y

Behavior on y {

SpringAnimation {

spring: 3

damping: 0.2

}

}

}

}

highlightFollowsCurrentItem: false;

model: theInstances.instancesModel()




74









Velneo vClient 7.19

delegate

{

Row

{

id: intanciaRow

width: parent.width -10;

height: 40;


Rectangle

{

id: iconoRec

width: 80;


Image

{

id: icono

source: decoration

smooth: true



fillMode: Image.PreserveAspectFit

}

}

Text

{

anchors {left: iconoRec.right; verticalCenter: parent.verticalCenter }

text: display;




75









Velneo vClient 7.19

color: intanciaRow.ListView.isCurrentItem ? "white" : "#E30B0B";

font.pointSize: 10;

font.bold: true;

}

MouseArea

{

id: instanciasListViewMouseArea

anchors.fill: parent

// En caso de hacer clic, se guarda la información correspondiente al servidor

onClicked:

{

instanciasListView.currentIndex = index;

}

// En caso de doble clic, hacemos lo mismo y además lanzamos la conexión

onDoubleClicked:

{

instanciasListView.currentIndex = index;

aceptarBoton.clicked();

}

}

}

}


{

instanciasListView.currentIndex = 0;

positionViewAtIndex( instanciasListView.currentIndex, ListView.Center);

}




76









Velneo vClient 7.19

Timer

{

interval: 500; running: true; repeat: false

onTriggered:

{

if ( 1 == instanciasListView.count )

aceptarBoton.clicked();

}

}

}

}

}

}

Column

{

id: botones

// Botones Aceptar y Cancelar

width: parent.width - 20;

spacing: 10;


anchors.bottom: parent.bottom;

anchors.margins: 10;

Row

{

id: botonesRow

width: parent.width





77









Velneo vClient 7.19

Rectangle {

id: aceptarBoton

width: 90;

height: conectarAceptarLabel.height + 8;

anchors.left: parent.left;

border.width: 2;


radius: 10;

signal clicked;

Text {

id: conectarAceptarLabel

text: "Aceptar"

color: aceptarRegion.pressed? "grey" : "#E30B0B"

anchors.centerIn: aceptarBoton;

font.bold: true;

}

MouseArea {

id: aceptarRegion;

anchors.fill: aceptarBoton;

onClicked: aceptarBoton.clicked();

}

onClicked:

{

// Nos conectamos

theInstances.setInstance( instanciasListView.currentIndex );

theInstances.accept()

}




78









Velneo vClient 7.19

}

Rectangle {

id: cancelarBoton

width: 90 ;

height: conectarAceptarLabel.height + 8

border.width: 2;


radius: 10;

anchors.right: parent.right;

Text {

id: cancelLabel

text: "Cancelar"

color: cancelRegion.pressed? "grey" : "#E30B0B"

anchors.centerIn: cancelarBoton;

font.bold: true

}

MouseArea {

id: cancelRegion;

anchors.fill: cancelarBoton;

onClicked: theInstances.reject();

}

}

}

}

}

[/code]




79









Velneo vClient 7.19

Uso de la rejilla avanzadaLa rejilla avanzada dispone de las siguientes funcionalidades:

Agrupamientos

Agrupar por una columna consiste en formar grupos con las fichas de la lista que tengan el mismo valor en esa columna. La rejilla se convierte entonces en un árbol con los distintos valores de la columna en los nodos primarios que, al abrirlos, despliegan las fichas de su grupo.

Se podrá agrupar por más de una columna, pasando a tener el árbol más niveles.

Se permite agrupar por una columna tras un cambio en la información que se muestra.

Ordenación

La rejilla permite la ordenación por múltiples columnas, tanto en orden ascendente como descendente.

Desplazamiento vertical (Scroll)




80









Velneo vClient 7.19

La rejilla soporta dos tipos de desplazamiento vertical o scroll vertical. Un modo píxel a pixel, similar al que tienen los navegadores web. El otro modo es por filas, más adecuado a la presentación tabular de registros.

Formatos de vista

Permite mostrar las rejillas en dos formatos distintos:

Vista de tabla: Se muestran los elementos en filas y columnas.

Vista con bandas: Permite definir bandas que agrupen la información no sólo en columnas si no también en filas dentro de las columnas.

Ancho de columnas automático




81









Velneo vClient 7.19

Las rejillas permiten configurar ancho automático de columnas proporcional a la configuración inicial de valores en edición, permitiendo ajustarse dinámicamente al tamaño de la ventana, en cambios de dimensión.

Columnas fijas

Esta funcionalidad permite fijar columnas de modo que no se vean afectadas por el scroll horizontal, permaneciendo fijas a izquierda y/o derecha mientras movemos el resto de columnas a la izquierda o a la derecha.

Cálculos en pies

La rejilla permite en los pies tanto de rejilla y como de grupo la configuración en edición o en ejecución de cálculos:

Suma: Este comando hace en el pie un sumatorio de todos los elementos de la columna. Funcional en pies.

Mínimo: Este comando mostrará en el pie el valor mínimo de todos los elementos de la columna. Funcional en pies.

Máximo: Este comando mostrará en el pie el valor máximo de todos los elementos de la columna. Funcional en pies.

Suma: Este comando hace en el pie la media aritmética de todos los elementos de la columna. Funcional en pies.

Selección de columnas




82









Velneo vClient 7.19

Esta ventana nos permite gestionar las columnas y bandas que queremos mostrar en la rejilla. Por medio de arrastrar y soltar quitaremos de la rejilla las columnas y bandas que no queramos mostrar. Podremos volver a ella para devolver a la rejilla las columnas que hayamos ocultado.

Selección rápida de columnas




83









Velneo vClient 7.19

Esta opción nos permite de forma sencilla y rápida seleccionar qué columnas queremos ver. Podremos mostrar columnas que estén ocultas, u ocultar aquellas que estén visibles.

Guardar configuración de columnas

La opción guardar configuración guarda el estado de configuración de la rejilla. Una vez guardado la rejilla siempre que se abra en ese ordenador será mostrada, por defecto, con la última configuración guardada. La configuración de la rejilla se guarda en la caché local de Velneo vClient, por lo que si en ese equipo entran dos usuarios a la aplicación desde sesiones de usuario diferentes, podrán guardar diferentes configuraciones, si lo hacen desde la misma sesión compartirán la configuración de la rejilla.

Esta configuración de la rejilla se aplicará en todos los lugares donde se use la rejilla, de esta forma el usuario lo cambia una sola vez para toda la aplicación. Si en algún punto de la aplicación queremos que el usuario pueda tener para esa rejilla una configuración diferente lo más recomendable será crear una segunda rejilla con diferente identificador, evitando así que se produzcan conflictos.

Impresión de la rejilla

La opciones imprimir y Exportar a PDF hacen una imagen la rejilla que estamos visualizando en pantalla a papel o en un fichero PDF. Debemos tener en cuenta que la información no se ajustará, por defecto, al ancho de la hoja o cambiará la orientación del papel automáticamente por lo que previamente a la impresión o la generación del fichero PDF deberemos ajustar la visualización de la rejilla. Estas opciones están disponibles tanto en el menú estándar como el avanzado.

Filtros

Filtrar (Ctrl + F): Esta opción sirve para filtrar una lista, es decir, para quitar de la lista aquellos registros que no cumplan una determinada condición. Tendremos que indicar por qué columna queremos filtrar y por qué valor.

Podremos concatenar dos filtros (en modo “o”, “y” o “y no”) y hacer que el filtro se aplique o no sobre el resultado de filtros realizados con anterioridad. Funcional en cabeceras y cuerpo.

A partir de la versión 7.16, para columnas numéricas, de tiempo o fecha se incluyen nuevas opciones de comparación: mayor que y menor que.




84









Velneo vClient 7.19

Filtro rápido por valores

En las cabeceras de columnas disponemos de una opción para el filtrado rápido por valores. Al seleccionarlo nos mostrará las distintas opciones disponibles, vacío, no vacío, seleccionar todo, no seleccionar nada, y podremos además seleccionar qué valores permitimos para el filtro.

Zoom

La rejilla permite configurar el zoom con el que se muestran los elementos, adaptando el contenido al zoom requerido.

Aumentar zoom(Ctrl + +): Pemite aumentar un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.




85









Velneo vClient 7.19

Disminuir zoom(Ctrl + -): Pemite disminuir un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.

Menú de contexto

La rejilla avanzada incorpora una serie de opciones que podremos ejecutar desde el menú de contexto que se obtiene al pusar el botón derecho del ratón sobre un área de la rejilla, dentro de la opción Opciones avanzadas.

Las opciones disponibles variarán en función de si el menú de contexto lo obtenemos desde la cabecera, desde el cuerpo o desde un pie de la rejilla.

• Alta de ficha: Si la rejilla tiene asociada un formulario de altas, esta opción nos permitirá abrirlo.

• Modificación de ficha: Si la rejilla tiene asociada un formulario de modificación, esta opción nos permitirá editar la ficha seleccionada en la rejila.

• Baja de ficha: Si la rejilla tiene asociada un formulario de bajas, esta opción nos permitirá abrirlo para borrar la ficha seleccionada en la rejila.

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

Contiene también los comandos estándar de lista.

• Imprimir: Envía a la imprsora la lista de registros contenidos en la rejilla.

• Exportar a PDF: Genera un fichero pdf con la lista de registros contenidos en la rejilla.

La opciones imprimir y Exportar a PDF hacen una imagen la rejilla que estamos visualizando en pantalla a papel o en un fichero PDF. Debemos tener en cuenta que la información no se ajustará, por defecto, al ancho de la hoja o cambiará la orientación del papel automáticamente, por lo que previamente a la impresión o la generación del fichero PDF deberemos ajustar la visualización de la rejilla.

• Guardar configuración: Guarda el estado de configuración de la rejilla. Una vez guardado la rejilla siempre que se abra en ese ordenador será mostrada, por defecto, con la última configuración guardada. La configuración de la rejilla se guarda en el registro por lo que si en ese equipo entran dos usuarios a la aplicación desde diferentes usuarios, podrán guardar diferentes configuraciones, si lo hacen desde la misma sesión compartirán la configuración de la rejilla.

Esta configuración de la rejilla se aplicará en todos los lugares donde se use la rejilla, de esta forma el usuario lo cambia una sola vez para toda la aplicación. Si en algún punto de la aplicación queremos que el usuario pueda tener para esa rejilla una configuración




86









Velneo vClient 7.19

diferente lo más recomendable será crear una segunda rejilla con diferente identificador, evitando así que se produzcan conflictos.

• Restaurar configuración: Nos permite cargar una configuración de la rejilla que hayamos guardado previamente con el comando anterior.

Opciones avanzadas

La rejilla avanzada incluye una serie de opciones avanzadas, que son:

• Filtrar (Ctrl + F): Esta opción sirve para filtrar una lista, es decir, para quitar de la lista aquellos registros que no cumplan una determinada condición. Tendremos que indicar por qué columna queremos filtrar y por qué valor.

Podremos concatenar dos filtros (en modo "o", "y" o "y no") y hacer que el filtro se aplique o no sobre el resultado de filtros realizados con anterioridad. Funcional en cabeceras y cuerpo.

• Ordenar ascendente: El sistema nos permite ordenar por cualquier columna, por grupos de columnas e incluso por columnas que se encuentren agruapdas. Para ordenar por varias columnas, pulsar y mantener pulsada la tecla Control durante la ordenación. Para cancelar la ordenación por una columna específica manteniendo los otros criterios de ordenación, pulsar y mantener pulsada la tecla Shift durante la ordenación. Los registros serán ordenados en modo ascedente. Funcional en cabeceras.

• Ordenar descendente: El sistema nos permite ordenar por cualquier columna, por grupos de columnas e incluso por columnas que se encuentren agruapdas. Para ordenar por varias columnas, pulsar y mantener pulsada la tecla Control durante la ordenación. Para cancelar la ordenación por una columna específica manteniendo los otros criterios de ordenación, pulsar y mantener pulsada la tecla Shift durante la ordenación. Los registros serán ordenados en modo descendente. Funcional en cabeceras.

• Limpiar opciones de ordenación: Permite limpiar opciones de ordenación que hayamos establecido.Funcional en cabeceras.

• Expandir todo: Si la rejilla contiene agrupamientos, esta opción abrirá todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.

• Replegar todo: Si la rejilla contiene agrupamientos, esta opción repelgará todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.

• Aumentar zoom(Ctrl + +): Pemite aumentar un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.




87









Velneo vClient 7.19

• Disminuir zoom(Ctrl + -): Pemite disminuir un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.

• Agrupar por este campo: Nos permite crear un agrupamiento por el campo de la columna sobre la que hemos lanzado el menú de contexto. Al hacerlo se incluirá el campo en la caja de agrupamientos de la rejilla, que está situada sobre la cabecera. Podremos hacer esto mismo si pinchamos sobre la cabecera de la rejilla y la arrastramos al área de la caja de agrupamientos. Funcional en cabeceras.

• Mostrar ocultar caja para agrupar: Permite mostrar/ocultar la caja de agrupamientos de la rejilla. Funcional en cabeceras y cuerpo.

• Quitar esta columna: Ejecutada sobre la cabecera de una columna, nos permitirá quitar dicha columna de la rejilla. Funcional en cabeceras.

• Selector de campos: Este comando nos permite quitar o añadir columnas, que hayan sido quitadas previamente, a la rejilla de modo visual. Funcional en cabeceras y cuerpo.

• Pie de rejilla: Este comando nos permite mostrar/ocultar el pie de la rejilla. Funcional en cabeceras y cuerpo.

• Pie de grupo: Este comando nos permite mostrar/ocultar pies de agrupamientos. Funcional en cabeceras y cuerpo.

• Alineamiento: Nos permite modificar el alineamiento de la columna: izquierda, derechao centro. Funcional en cabeceras.

• Suma: Este comando hace en el pie un sumatorio de todos los elementos de la columna. Funcional en pies.

• Mínimo: Este comando mostrará en el pie el valor mínimo de todos los elementos de la columna. Funcional en pies.

• Máximo: Este comando mostrará en el pie el valor máximo de todos los elementos de la columna. Funcional en pies.

• Suma: Este comando hace en el pie la media aritmética de todos los elementos de la columna. Funcional en pies.

• Ninguno: Este comando no hará cálculo alguno en el pie.

Captura de imágenes desde cámara




88









Velneo vClient 7.19

A partir de la versión 7.17, en aquellos campos en los que se guarda una imagen, podremos hacer uso de la cámara que tengamos conectada al ordenador para hacer una captura y guardarla en el campo.

Para ello, situaremos el cursor sobre le control de edición de imagen, pulsaremos el botón derecho del ratón y, en el menú de contexto que se presenta, seleccionaremos la opción activar cámara.

Al hacerlo, se mostrará en el control lo que la cámara esté viendo en ese momento.

Para capturar la imagen, pulsaremos el botón

Una vez pulsado, la imagen capturada será incluida en el campo.

Para cancepar la captura de imange, pulsaremos el botón

La cámara es funcional solamente en Windows y en Mac.




89









Índice de contenido -...

Documents

Transcript of Índice de contenido -...