vTools
¿Qué es? ¿Cómo empezar? Instalación Herencia ¿Cómo usarlo? Funcionalidades Regeneración de datos e índices Rebuscar Combinar Exportar a CSV Exportar a Excel Exportar a Html Filtrar Guardar y recuperar listas virtuales Gestión de usuarios del servidor Multiidioma
1 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
¿Qué es? vTools es una solución desarrollada en Velneo V7 que incorpora una serie de funcionalidades útiles para el programador y que puede incorporar de forma sencilla dentro de sus propias aplicaciones.
¿Cómo empezar? Instalación Lo primero que debemos hacer es realizar la instalación de la solución vTools dentro de nuestro Velneo vServer de desarrollo.
Si necesitas más información de cómo realizar la instalación de una solución puedes consultar este artículo
Herencia El desarrollador tiene que incluir la solución vTools como parte de la herencia de la solución donde quiera usar las funcionalidades.
Realiza la herencia en la aplicación más profunda desde que vayas a utilizar las funcionalidades.
Si necesitas más información de cómo realizar la herencia de una solución puedes consultar este artículo
¿Cómo usarlo? La forma más sencilla de utilizar las funcionalidades incluídas en vTools es usar las acciones o menús que incorpora vTools. Por ejemplo, si queremos incluir una opción de menú para 2 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
regenerar los índices y datos de todas las tablas, tan sólo tenemos que añadir a nuestro menú la acción REGEN_TABLAS, tal y como se muestra en la siguiente imagen:
Incluida la acción dentro de nuestro menú
Incluido el menú exportar dentro de nuestro menú
Funcionalidades Regeneración de datos e índices Esta acción, nos permite regenerar índices y datos de todas nuestras tablas para garantizar la integridad de los datos. Cuando lanzamos la acción, nos pregunta si queremos continuar con la regeneración. En caso afirmativo nos aparecerá una barra de progreso por cada tabla de toda nuestra solución (incluidas las soluciones heredadas). La regeneración se produce siempre en tercer plano (lado del servidor). 3 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Incluimos la acción RGN_TBL que viene en vTools. Puede ser en un menú, un botón, una toolbar, etc.
Rebuscar Esta acción (RBS) nos permite a partir de una lista, realizar operaciones (cruzar, añadir o quitar) de sus elementos contra el resultado de otra búsqueda de la misma tabla. En la siguiente imagen vemos como cuando lanzamos la acción rebuscar desde una lista de la tabla contactos, nos muestra todas las búsquedas públicas de la tabla contactos y nos da la opción de cruzar, añadir o quitar el resultado de la búsqueda seleccionada a la lista de origen. Además podemos hacer que el resultado aparezca en la misma vista de origen o en una nueva vista.
Combinar Esta acción (CMB) nos permite combinar la lista actual con otra de las listas abiertas. Por ejemplo, si tenemos una lista de contactos con 9 elementos y otra con 21, podemos añadir, cruzar o quitar los elementos entre sí.
4 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Sólo podremos usar una lista contenida en una vista de datos dentro de un formulario, si usamos ésta cuando lancemos la acción.
En una toolbar asociado a una lista de registros o en un menú, utilizar la acción CMB que hay en vTools.
Exportar a CSV Esta funcionalidad nos permite exportar todos los datos que tengamos en una rejilla (excepto las imágenes) a un documento de tipo csv.
Podemos, o bien incluir el menú Exportar que está en vTools, el cual incluye todas las opciones de Exportar disponibles, o añadir a nuestro menú o cualquier otro disparador la acción EXP_CSV.
5 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Exportar a Excel Esta acción nos permite llevar todos los datos (excepto las imágenes) de una rejilla a una hoja excel. Esta funcionalidad sólo está operativa para sistemas operativos Windows que tengan Microsoft Excel instalado.
Podemos, o bien incluir el menú Exportar que está en vTools, el cual incluye todas las opciones de Exportar disponibles, o añadir a nuestro menú o cualquier otro disparador la acción EXP_XLS.
Exportar a Html Esta acción nos permite exportar todas las columnas (excepto las imágenes) de la rejilla mostrada a una tabla html sencilla, sin formato. Como vemos en la siguiente imagen, la lista de contactos que aparece detrás se ha exportado al html que aparece delante.
Podemos, o bien incluir el menú Exportar que está en vTools, el cual incluye todas las opciones de Exportar disponibles, o añadir a nuestro menú o cualquier otro disparador la acción EXP_HTML. 6 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Filtrar Esta acción (FLT) nos permite mostrar un cuadro de diálogo de filtrado tal y como aparece en la siguiente imagen:
Los campos que aparecen en el primer combobox son todos los de la tabla asociada a la lista de la vista desde que se lanza la acción que no sean privados y que sean de los siguientes tipos: ● Alfabético ● Numérico ● Fecha ● Hora ● Tiempo ● Booleano ● Fórmula numérica ● Fórmula alfabética ● Fórmula fecha ● Fórmula tiempo En función al tipo del campo seleccionado en el primer combobox, aparecen unas determinadas condiciones en el segundo combobox y el control de introducción del valor es de un tipo u otro.
7 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Por ejemplo, si el campo elegido es de tipo fecha, tendremos las condiciones igual, distinto, menor y mayor y el control para la introducción del valor será de tipo fecha. En el caso de que seleccionemos un tipo de campo alfabético, podremos indicar si queremos comparar con el campo completo o por partes. Por ejemplo, si tenemos desmarcado “Campo completo” y buscamos ana, nos encontrará tanto analfabeto como montana. Además, en el caso de campos alfabéticos, podemos indicar si queremos distinguir entre mayúsculas y minúsculas. En caso de buscar Ana, nos encontrará Ana y ana. Si marcamos la opción “Abrir en otra vista”, el resultado del filtrado aparecerá en una vista nueva. En caso contrario el resultado se mostrará usando la misma vista de origen. Si marcamos “Comparar con la ficha seleccionada”, podremos comparar el campo elegido con el registro que tengamos seleccionado en la vista desde la que se lanza la acción.
Guardar y recuperar listas virtuales Disponemos de acciones para guardar una lista virtual en disco y recuperarla en cualquier otro momento. Una lista virtual es una lista de registros que queremos almacenar en disco para posteriormente volver a usar. Por ejemplo, obtengo una lista de clientes después de haber hecho varias operaciones de filtrado, cruces, etc., y quiero guardar esa lista o compartirla con un compañero. Para guardar una lista, tan sólo tendremos que utilizar la acción LST_VRT_GRB, asociada a una toolbar de lista o a un menú derecho de listas. Por ejemplo, aquí lo tenemos asociado al menú derecho de las rejillas:
Para incluir la opción de recuperar lista virtual, incluimos la acción LST_VRT_CRG.
8 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
Gestión de usuarios del servidor Con esta acción (USRS), lanzamos un formulario con la lista de usuarios del vServer que tiene el siguiente aspecto:
Con el fin de garantizar la seguridad en entornos multiinstancia, sólo se muestran los usuarios de los grupos a los que pertenece el usuario que lanza la acción.
Sólo los usuarios marcados como Supervisor en el vServer pueden hacer cambios en los usuarios.
Si añadimos o modificamos un usuario, nos muestra un formulario como el siguiente donde podemos indicar las propiedades de dicho usuario.
9 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
En la lista de grupos disponibles sólo se muestran los grupos a los que pertenece el usuario que lanza la acción.
Una configuración típica para un cliente final sería de este tipo: Usuario
Administradores
Usuarios avanzados
Usuarios
administrador
x
[email protected]
x
x
[email protected]
x
[email protected]
x
10 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª
vTools
En este caso, nos tenemos que encargar en nuestra aplicación usando algún tipo de seguridad que sólo el usuario dentro del grupo “Usuarios avanzados” pueda lanzar la acción USRS. De esta manera los grupos disponibles donde luis podrá incluir a un usuario serán “Usuarios avanzados” y “Usuarios”.
Multiidioma La solución vTools está preparada para poder ser traducida usando Velneo vTranslator, de tal forma que los literales usados en la aplicación aparezcan en el idioma del cliente.
11 de 11
Pol. Ind. A Granxa, Edificio vCenter Telf. (+34) 902 36 63 82 Rúa D, esquina paralela 3
[email protected] 36400 Porriño (Pontevedra) velneo.es España
Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO37578, Inscr 1ª