Primeros pasos con Velneo V7dl.velneo.com/.../v7/openapps/documentos/primeros_pasos.pdf · 2014-07-17 · Primeros pasos con Velneo V7 A lo largo de este tutor iremos explicando los

Configuración .................................................................................................................... 2 Creación de la solución y los proyectos ................................................................................. 6 Creación de la estructura de datos ...................................................................................... 13

Creación de tablas ......................................................................................................... 14 Creación de los campos .................................................................................................. 20 Creación de índices ........................................................................................................ 22

Ejecutar el proyecto de datos ............................................................................................. 24 Instanciar el proyecto de datos ........................................................................................ 24 Asignar permisos de ejecución a la instancia de datos creada .............................................. 29 Ejecutar con Velneo vDataClient V7 ................................................................................. 31

Creación de los objetos de aplicación .................................................................................. 36 Creación de objetos básicos ............................................................................................ 37

Creación de formularios ............................................................................................... 37 Creación de rejillas ..................................................................................................... 42 Creación de búsquedas ................................................................................................ 47 Creación de localizadores ............................................................................................. 51 Creación de procesos .................................................................................................. 52 Este proceso lo usaremos más adelante en este tutor. .................................................... 54 Acciones .................................................................................................................... 55

Objetos de interfaz ........................................................................................................ 57 Menú ........................................................................................................................ 59 Toolbar ..................................................................................................................... 60

Creación de los objetos avanzados ................................................................................... 61 Creación de bloc de formularios .................................................................................... 61 Creación de un multivista ............................................................................................. 62 Creación de un casillero ............................................................................................... 67 Creación de eventos y conexiones ................................................................................. 68

Ejecutar el proyecto .......................................................................................................... 71 Instancia el proyecto de aplicación ................................................................................... 71 Permisos ...................................................................................................................... 74 Ejecutar la aplicación con Velneo vClient V7 ...................................................................... 75 Ejecución directa desde Velneo vDevelop V7 ..................................................................... 78

Pol. Ind. A Granxa | Rúa D Esquina paralela 3Edif. vCenter, 36400 Porriño | Pontevedra | EspañaTelf. (+34) 902 366 382 | Fax (+34) 902 932 [email protected] | www.velneo.com

Primeros pasos con Velneo V7Fecha de creación 12/04/2010 17:47:00

1

mailto:[email protected]

Primeros pasos con Velneo V7A lo largo de este tutor iremos explicando los pasos que hay que seguir para poder desarrollar y ejecutar un proyecto de Velneo V7. Estos son:

Configuración: Declaración de usuarios y permisos en Velneo vServer V7.

Programación: Creación de la solución, el proyecto de datos y proyecto de aplicación con Velneo vDevelop V7.

Instanciación: Declaración de aplicaciones y permisos en Velneo vServer V7.Ejecución: Conexión a la aplicación con Velneo vClient V7.

La aplicación que vamos a desarrollar es muy sencilla. Se trata de una base de datos de música, en la que se contemplarán únicamente tres tablas: Artistas (ARTISTS), álbumes de los artistas (ALBUMS) y pistas de los álbumes (TRACKS). A esta aplicación la llamaremos vMusicBox.

ConfiguraciónUna vez instalados Velneo vServer V7 y Velneo V7, lo primero que tendremos que hacer es crear permisos en Velneo vServer V7 a los usuarios, para ello hemos de usar Velneo vAdmin V7. Al ejecutarlo se nos presentará una ventana solicitando los datos de conexión a Velneo vServer V7:

En ella tendremos que especificar:

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

Usuario: Nombre de un usuario declarado en Velneo vServer V7.

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

Ejemplo:

Servidor: vatp://v7cloud1.velneo.com:XXXXUsuario: [email protected]ña: [email protected]



2


Si estamos trabajando en un servidor de la nube usaremos los datos que nos aparecen en el panel de control de la zona info.

Si estamos trabajando con un servidor local, el sistema crea por defecto un usuario llamado velneo, sin contraseña, para que podamos comenzar a administrar el servidor.

Si aceptamos, se procederá a la conexión con Velneo vServer V7, 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 de la ventana 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 de Velneo vAdmin V7.

Vemos que se nos presenta la lista de usuarios declarados, uno llamado velneo (que el sistema crea por defecto cuando se instala Velneo vServer V7) y otro correspondiente al nombre de nuestro usuario –en el caso de la nube- (userXXXXX, en la captura de pantalla), si hacemos doble clic sobre el último obtendremos su ventana de propiedades:



3


Veremos que tiene activada la propiedad Supervisor. El Supervisor puede, por ejemplo, reconstruir el sistema cuando sea preceptivo, acceder a Velneo vAdmin V7 para administrar Velneo vServer V7, tener acceso a determinadas áreas de aplicaciones si así se ha programado, etc.

Pero los permisos no se establecen a nivel de usuario sino que se establecen a nivel de grupos de usuario.

Cerremos la ventana de propiedades del usuario y pulsemos en el menú izquierdo de Velneo vAdmin V7 la opción Grupos de usuarios. Si se trata de un servidor en la nube veremos que ha sido creado automáticamente un grupo llamado admin, si hacemos un clic sobre él veremos que el sistema ha incluido en él nuestro usuario:



4


En el caso de tratarse de un servidor local si no existe este grupo lo crearemos.

Editaremos las propiedades de este grupo de usuarios (haciendo doble clic sobre el mismo), veremos que tiene activados los estilos Puede crear soluciones y Puede borrar soluciones. Estos son fundamentales tenerlos activados pues en las soluciones es donde se han de almacenar los proyectos de datos y los proyectos de aplicación, es decir, el código fuente de Velneo V7, que desarrollaremos con Velneo vDevelop V7. Además, debemos activar también la propiedad Puede ejecutar proyectos de datos con vDataClient: Ya que más adelante explicaremos cómo se usa dicho producto.

A partir de este momento ya podremos comenzar el desarrollo de nuestra aplicación con Velneo vDevelop V7.



5


Creación de la solución y los proyectosVamos a comenzar el desarrollo de nuestra aplicación con Velneo vDevelop V7, para ello tendremos que conectarnos con nuestro Velneo vServer V7, crear la solución y crear tanto la estructura de datos de nuestro proyecto (proyecto de datos) como los objetos visuales del mismo (proyecto de aplicación).

Para crear una nueva solución ejecutaremos la opción Nueva solución del menú Soluciones. Una vez hecho esto se presentará el asistente para la creación de soluciones:

En él tendremos que cumplimentar las propiedades siguientes:

» Nombre: vMusicBox.» Servidor: Será el servidor al que nos hayamos conectado (vatp://….).

Pulsaremos el botón para pasar al siguiente paso del asistente:



6


En este paso seleccionaremos la plantilla a aplicar. En este caso seleccionaremos la opción Un proyecto de datos y otro de aplicación: Ésta creará la solución en el servidor indicado en el primer paso del asistente y conteniendo un proyecto de datos y otro de aplicación dentro de ella.

El siguiente paso del asistente será la especificación del nombre del proyecto o proyectos a crear:



7


Estableceremos las propiedades siguientes:

» Nombre del proyecto: Aplicación: vMusicBox.» Nombre del proyecto: Database: vMusicBox.

Pulsaremos el botón para ir al siguiente paso del asistente. Si en la sesión actual ya nos habíamos conectado previamente a un , En el siguiente paso se mostrará la lista de proyectos alojados en el Velneo vServer V7 susceptibles de ser heredados por los proyectos a crear:



8


En este caso no seleccionaremos ningún proyecto. Este paso será obviado si no nos hemos conectado previamente a ningún Velneo vServer V7.

El siguiente paso del asistente será la definición de los idiomas del proyecto o proyectos a crear:



9


Estos idiomas que se podrán seleccionar en ejecución para mostrar la información de los objetos. Por defecto se toma el idioma del sistema. Si queremos añadir otro debemos seleccionar el Idioma y el País al que se aplica el idioma. Usando las opciones Subir y Bajar podremos ordenar los idiomas del proyecto. El primero de la lista será el idioma por defecto del proyecto. Los países se presentan en función del idioma seleccionado.

Una vez definidos los idiomas pulsaremos el botón para pasar a la ventana de finalización del asistente:



10


NOTA IMPORTANTE: Si al finalizar el asistente el sistema advierte que no ha podido crear la solución será porque el usuario con el que nos hemos conectado a Velneo vServer V7 no tiene privilegios para ello.

Para saber cómo asignárselos consultar el capítulo anterior, titulado Configuración.

La solución que acabamos de crear será cargada directamente en el panel del explorador de proyectos Y los proyectos serán cargados automáticamente:



11


A continuación abriremos cada uno de ellos para guardarlo en disco. Para ello, en el explorador de

proyectos haremos doble clic sobre el proyecto de datos y pulsaremos el botón para

salvarlo. A continuación haremos doble clic sobre el proyecto de aplicación y lo guardaremos también.



12


Creación de la estructura de datosEn este punto ya hemos creado a través de Velneo vDevelop V7 la solución vMusicBox y dentro de ésta un proyecto de datos y otro de aplicación. En este caso lo que haremos será editar el proyecto de datos.

Si no tenemos cargada la solución creada en el capítulo anterior tendremos que cargarla, para ello pulsaremos el botón . Si no estamos conectados con ningún Velneo vServer V7 el sistema nos pedirá los datos de conexión al mismo; una vez establecida la conexión con Velneo vServer V7, se presentará una ventana con la lista de soluciones de ese Velneo vServer V7:

Hacer doble clic sobre la solución vMusicBox.

Tamibén podremos cargar una solución pulsando el botón , que aparece junto al botón de abrir solución. Al pulsarlo se abrirá lista de las últimas soluciones abiertas, haríamos clic sobre la solución vMusicBox.

Si apareciese vacío querrá decir que, o bien no se han declarado soluciones en Velneo vServer V7, o bien no se nos ha dado permiso a ninguno.

Una vez seleccionada la solución, sus proyectos serán mostrados en el explorador de proyectos:



13


Si tenemos cargada la solución pero no el proyecto de datos, tendremos que hacer doble clic sobre él en el explorador de proyectos para cargarlo:

Una vez cargado, ya podremos comenzar al crear los objetos de datos.

Creación de tablasA continuación veremos los pasos para crear las tablas de la aplicación. Las tablas que crearemos son: ARTISTS (artistas), ALBUMS (álbumes), y TRACKS (Pistas).

Una vez conectados con Velneo vDevelop V7 al servidor y creado el proyecto, lo que tendremos que hacer es crear una a una las tablas de la aplicación. Para ello utilizaremos el asistente para la creación de tablas.

Para crear una tabla haremos doble clic sobre el icono de la galería de objetos (Control + Ins) de Velneo vDevelop V7. Se nos presentará el primer formulario del asistente:



14


En el formulario tendremos que especificar:

» Nombre plural: Este dato aparecerá en los mensajes de la base de datos referidos a listas de la tabla.

» Nombre singular: Este dato aparecerá en los mensajes de la base de datos referidos a fichas de la tabla.

» Tipo de tabla: Selección de tipos de tabla. En nuestro ejemplo todas serán maestro normal con clave numérica. Esto creará la tabla con un campo ID (código) de tipo numérico y autoincrementable, que permitirá identificar a cada registro de forma única y exclusiva) y un campo NAME, alfabético, donde podremos escribir el nombre de cada registro (el del artista en la tabla de ARTISTS, por ejemplo).

A continuación pulsamos el botón Siguiente, lo que nos mostrará el formulario:



15


En este formulario definiremos el nombre y la longitud del campo código así como la propiedad Numeración automática. A continuación pulsaremos el botón Siguiente, lo que nos mostrará el formulario:



16


Seleccionaremos los tipos de índices que queremos crear a partir del campo nombre de la tabla, que serán, Índice alfabético, Índice de palabras e Índice de trozos de palabras; para finalmente pulsar el botón Siguiente, lo que nos mostrará el formulario:



17


En este formulario seleccionaremos los campos adicionales que tendrá nuestra tabla, que en este caso será Observaciones, y pulsaremos Siguiente, lo que nos mostrará el formulario:



18


En este último formulario debemos pulsar Finalizar. En este momento la tabla será creada en el proyecto.

A continuación crearemos el resto de tablas y para ello seguiremos los mismos pasos que hemos seguido para crear la tabla anterior.

Siempre que al crear una nueva tabla, si previamente ya existen otras tablas en el proyecto, el asistente nos mostrará un formulario previo al último, para la selección de campos enlazados a maestros:



19


El asistente nos crea de forma automática los campos enlazados a las tablas que se marquen en este formulario.

Cuando creemos la tabla de ALBUMS en el asistente seleccionaremos como tabla maestra la tabla de ARTISTS y cuando creemos la de TRACKS, seleccionaremos ALBUMS como tabla maestra.

Creación de los camposA continuación veremos los pasos para crear campos e índices en las tablas de nuestra aplicación.

Una vez creadas las tablas, para añadir, modificar o eliminar objetos de una tabla, podremos hacerlo o bien desde la barra de herramientas del editor de tablas que se abre en el panel central cuando hacemos doble clic sobre una, o bien desde el panel de subobjetos de Velneo vDevelop V7.

En este tutor lo haremos desde el propio editor de tablas.

Pulsando el botón crearemos un nuevo campo en la tabla en la que estemos posicionarnos. A continuación podremos definir las propiedades del campo en el panel de propiedades.



20


En un campo podremos definir las siguientes propiedades:

» Identificador: Dato de referencia del campo en su manejo en la programación.

» Nombre: Dato de referencia del campo en su manejo en la ejecución.

» Estilos: Nos permite declarar el campo como privado.

» Comentarios: Para añadir comentarios internos a la programación.

» Tipo de enlace: Permite definir si el campo será enlazado o no y el tipo de enlace.

» Tabla enlazada: Permite definir la tabla a la que apuntará el campo en caso de que el sea enlazado.

» Campo padre: Permite definir el campo padre cuando la tabla enlazada sea de tipo submaestro.

» Tipo: Permite definir el tipo de información que contendrá. En los casos de campos enlazados esta propiedad estará inactiva debido a que el contenido vendrá definido por el tipo de contenido del campo Código de la tabla apuntada.

» Contenido inicial: Editor de formulas que nos permite definir una formula para el contenido del campo cuando se crea.

» Longitud: Permite definir el tamaño del campo en bytes.

» Información: Dato informativo de la capacidad final del contenido del campo.



21


A la tabla ARTISTS, que ya tendrá los campos ID y NAME, le añadiremos los campos siguientes:

Identificador Nombre Tipo Longitud UsoCOMMENTS Comments Objeto/Texto No hay que indicarla Para introducir comentarios

sobre el artista.PIC Picture Objeto/Dibujo No hay que indicarla La foto del artista.

A la tabla ALBUMS, que ya tendrá los campos ID, NAME y ARTISTS (campo enlazado a la tabla del mismo nombre) le añadiremos los campos siguientes:

Identificador Nombre Tipo Longitud UsoCOVER Cover Objeto/Dibujo No hay que indicarla Portada del disco.YEAR Year Numérico 2 bytes Año de publicación.

A la tabla TRACKS, que ya tendrá los campos ID, NAME y ALBUMS (campo enlazado a la tabla del mismo nombre) le añadiremos los campos siguientes:

Identificador Nombre Tipo Longitud UsoLYRICS Lyrics Objeto/Texto No hay que indicarla Letra de la canción.

Creación de índicesSi bien en este tutor no vamos a necesitar crear ningún índice, ya que nos basta con los que se han creado de forma automática a generar las tablas con el asistente, explicaremos igualmente cómo han de ser creados.

Pulsando el botón crearemos un nuevo objeto índice en la tabla en la que estemos posicionarnos. A continuación podremos definir las propiedades del índice en el panel de propiedades.

En un índice podremos definir las siguientes propiedades:

» Identificador: Dato de referencia del campo en su manejo en la programación.

» Nombre: Dato de referencia del índice en su manejo en la ejecución.

» Estilos: Nos permite declarar el índice como privado o no.



22


» Comentarios: Para añadir comentarios internos a la programación.

» Tipo de índice: Permite definir si el tipo de índice.

» Condición par indexar: Editor de formulas que nos permite definir una formula condición par que un registro se indexe.

» Número de partes: Dato informativo del número de campos que componen el índice.

» Longitud de la clave: Dato informativo del tamaño del índice por cada registro indexado.



23


Ejecutar el proyecto de datosEste capítulo muestra el uso de Velneo vDataclient V7, producto para usuarios de niveles 3 y 4. Pro tanto, este punto no es indispensable para la realización de los primeros pasos, sino un ejemplo de uso de dicho producto para los usuarios del mismo.

Instanciar el proyecto de datosA continuación vamos a ver los pasos que hay que seguir para instanciar un proyecto de datos.La instanciación consiste en la declaración de aplicaciones y permisos en Velneo vServer V7. En primer lugar nos vamos a conectar con Velneo vAdmin V7 al Velneo vServer V7 donde estemos desarrollando esta solución.

El siguiente paso será declarar la carpeta en la que se generarán los datos del proyecto de datos. Este paso no es necesario si estás trabajando con un Velneo vServer V7 en la nube. Para ello iremos al menú Disco del panel izquierdo de Velneo vAdmin V7 y pulsaremos el botón de la barra de herramientas.

Esto abrirá la ventana para la creación de una nueva carpeta compartida. En ella tendremos que indicar:



24


Nombre: Identificador del recurso compartido.

» Senda: Senda física de la carpeta compartida. Para facilitar la selección de la misma si pulsamos el botón obtendremos un explorador de archivos.

En la pestaña Estilos definiremos los privilegios de acceso que tendrán los usuarios sobre la carpeta compartida; estos permisos son:

» Ver directorios: Para permitir el acceso al directorio y los sub-directorios contenidos en la carpeta compartida.

» Leer ficheros: Para permitir leer los archivos incluidos en la carpeta compartida.

» Escribir ficheros: Para permitir leer y modificar los archivos incluidos en la carpeta compartida.

» Crear instancias: Para permitir la creación de instancias dentro de la carpeta compartida.

» Borrar ficheros: Para permitir el borrado de los ficheros contenidos en la carpeta compartida.

» Crear directorios: Para permitir crear nuevos directorios dentro de la carpeta compartida.

» Borrar directorios: Para permitir borrar directorios dentro de la carpeta compartida.

La carpeta compartida con los permisos que establezcamos será asignada automáticamente al grupo al que pertenezca el usuario que la ha creado:



25


Una vez declarada la carpeta compartida, ya podremos proceder a instanciar el proyecto de datos. Para ello accederemos a la opción Instancias.



26


En el panel superior tenemos un listado de las instancias de datos de Velneo vServer V7 al que nos hayamos conectado. Para añadir una nueva instancia debemos seleccionar el botón situado sobre el panel Instancias de datos. Esto nos mostrará el formulario del asistente para la creación de instancias:



27


En el asistente debemos indicar un Nombre de la instancia, seleccionar el proyecto de datos a instanciar y tenemos la posibilidad de asignar un Icono de la instancia.

En el siguiente paso debemos seleccionar una Ruta para datos de la nueva instancia.

Por último debemos pulsar el botón Finalizar.



28


Un proyecto de datos es el código fuente en el que se define la estructura de la base de datos y una instancia es su representación en disco. Un proyecto de datos de un Velneo vServer V7 puede ser instanciado tantas veces como deseemos, pero siempre en carpetas diferentes. No debemos usar una misma carpeta en disco para instancias distintas.

Asignar permisos de ejecución a la instancia de datos creadaUna vez creada la instancia, debemos establecer con Velneo vAdmin V7 los permisos de ejecución a la misma. Éstos se establecen a nivel de grupo de usuarios, por lo que seleccionaremos la opción Grupos de usuarios y haremos doble clic sobre el grupo al que pertenezca el usuario con el que queramos ejecutar la instancia de datos:

En la pestaña Estilos activaremos la opción Puede ejecutar proyectos de datos con vDataClient.



29




30


Ejecutar con Velneo vDataClient V7En este punto a ver los pasos que debemos seguir para conectarnos a una base de datos con Velneo vDataClient V7.

Al ejecutar la aplicación Velneo vDataClient V7 nos muestra un primer formulario solicitando los datos de conexión:



31


En él tendremos que especificar:

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

» Usuario: Nombre de un usuario declarado en Velneo vServer V7.

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

Si aceptamos, se procederá a la conexión con Velneo vServer V7, 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 está disponible y los datos de acceso son correctos, entonces accederemos al interfaz de Velneo vDataClient V7.



32


Vemos que se nos presenta una lista de instancias de datos a las que el usuario tiene acceso. Haciendo doble clic sobre una instancia nos conectamos a ella:



33


En el panel izquierdo tenemos un arbolado de todas las tablas de la base de datos. Moviéndonos en este arbolado podemos desplegar y hacer consultas de los índices de la tabla, relaciones de plural y casilleros visores específicos para los campos de tipo objeto. Haciendo doble clic sobre la tabla, índices, etc., se nos mostrará en la parte derecha el resultado de la consulta que realicemos:



34


En la barra de menú superior accedemos la barra de menú que nos permite operar con la tabla y registros que tengamos en el panel derecho, disponemos de las siguientes opciones:

Ficha: Alta, modificación y baja.

Lista: Invertir, filtrar, ordenar, partir, multipartir, quitar de la lista el seleccionado, campos duplicados, modificar campo…, modificar campo si… y generar vista con los seleccionados.

Navegante: Maestros, históricos e históricos de todos.

Procesos: Sin origen, lista y ficha.

Utilidades: Ver caché de fichas, regenerar datos y regenerar índices.

Para mayor información del funcionamiento de estas opciones consultar la ayuda de Velneo vDataClient V7.



35


Creación de los objetos de aplicaciónEn esta parte del tutor vamos a comenzar el desarrollo de los objetos visuales de nuestra aplicación con Velneo vDevelop V7.

Si no tenemos cargada la solución creada en el capítulo anterior tendremos que cargarla, para ello pulsaremos el botón . Si no estamos conectados con ningún Velneo vServer V7 el sistema nos pedirá los datos de conexión al mismo; una vez establecida la conexión con Velneo vServer V7, se presentará una ventana con la lista de soluciones de ese Velneo vServer V7:

Hacer doble clic sobre la solución vMusicBox.

También podremos cargar una solución pulsando el botón , que aparece junto al botón de abrir solución. Al pulsarlo se abrirá lista de las últimas soluciones abiertas, haríamos clic sobre la solución vMusicBox.

Si apareciese vacío querrá decir que, o bien no se han declarado soluciones en Velneo vServer V7, o bien no se nos ha dado permiso a ninguno.

Una vez seleccionada la solución, sus proyectos serán mostrados en el explorador de proyectos:



36


Si tenemos cargada la solución pero no el proyecto de aplicación, tendremos que hacer doble clic sobre él en el explorador de proyectos para cargarlo:

Como puede observarse, el asistente para la creación de soluciones ha creado automáticamente tres objetos: Un marco, un menú y una toolbar.

Creación de objetos básicos

En los siguientes puntos veremos cómo se crean los objetos básicos para operar o interaccionar con una tabla: formulario, rejilla, búsqueda, localizador y proceso.

Creación de formularios

Un Formulario es un objeto que nos permite visualizar y modificar los registros de la tabla a la que está asociado de nuestra base de datos. Además, se puede usar en búsquedas y localizadores para definir los términos de la búsqueda. En procesos o rejillas nos permite acceder al registro con el que estamos operando. Tiene origen y destino ficha.

Para crear un formulario haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7, esto provocará la apertura de un asistente que nos facilitará su creación. En el primer paso del asistente estableceremos las propiedades siguientes:



37


En la parte central de este formulario se ha de seleccionar una plantilla para distribuir los distintos controles que contendrá nuestro formulario. Si no queremos aplicar ningún tipo de plantilla seleccionaremos la llamada Vacía (esto desactivará las propiedades siguientes); en caso contrario, seleccionaremos con un clic la deseada. En este caso seleccionaremos la plantilla 2 horiz. + 1:

El resto de las propiedades relevantes de este primer paso del asistente son:

» Generar layouts: Activaremos esta opción si queremos que el formulario a crear contemple layouts.



38


» Bloque de botones: Activaremos esta opción si queremos que el formulario a crear contenga un bloque para situar botones “Acepar”, “Cancelar”, etc.

» Posición: Si la opción anterior está activada, en esta indicaremos en qué posición será situado el bloque de botones.

Pulsaremos el botón Siguiente para ir al siguiente paso del asistente; donde tendremos que seleccionar los campos que irán en cada bloque que va a generarse en el formulario. Por cada bloque existirá una pestaña y en ella se indicarán los campos a incluir en el mismo.

En la pestaña Bloque 1 incluiremos los campos NAME, ARTISTS y YEAR. Para ello, dentro de la pestaña Bloque 1 pulsaremos el botón y, en la ventana que se despliega, seleccionaremos los capos y pulsaremos el botón Aceptar. para añadir todos los campos. Una vez hecho esto , los campos serán mostrados en el asistente:



39


El orden en que se muestran los campos seleccionados será el orden en el que serán creados en el formulario. Podemos cambiar la posición de un campo usando los botones de la toolbar incluida en la pestaña.

Podremos borrar un campo pulsando el botón .

En el Bloque 2 incluiremos el campo COVER.

El resto de las propiedades de esta pestaña no las modificaremos; dejaremos los valores por defecto.

Distribución: En esta propiedad seleccionaremos cuál va a ser la posición de las etiquetas con respecto a los controles de edición correspondientes.

Estirar controles: Si esta propiedad está activa, todos los controles de un bloque serán creados con la misma longitud; si está inactiva serán creados según el tipo y longitud del campo que editen.

El Bloque 3, lo dejaremos vacío pues en él incluiremos a posteriori una rejilla con las pistas (tracks) del álbum.

Una vez establecido el contenido de loss bloque accederemos a la pestaña Botones para configurar su apariencia. El sistema por defecto asume la creación de dos botones, “Aceptar” y “Cancelar”, ambos ya programados con las funciones de grabación y cancelación de ficha, respectivamente. Lo que haremos será añadir un nuevo botón “Eliminar”, para ello pulsaremos el botón de la barra de herramientas incluida dentro de esta pestaña y seleccionar la opción Eliminar. Esto hará que se añada un botón ya programado con la función que elimina la ficha editada:



40


A continuación lo que haremos será seleccionar el modo en que el los botones serán alineados con respecto al formulario en la propiedad Alineamiento horizontal, que será: Derecha (Los botones sean alineados a la derecha del bloque).

Una vez hecho esto pulsaremos el botón Siguiente y a continuación el botón Finalizar. Una vez hecho esto el formulario será añadido a nuestro proyecto y editado:



41


Y ya está listo para ser usado.

Tendremos que crear también, mediante el asistente, los formularios correspondientes a las tablas de ARTISTS y TRACKS.

Creación de rejillas

Se trata de un objeto que muestra los elementos de una lista de registros, permitiendo seleccionar qué columnas, es decir, qué campos, se muestran de cada registro. Podemos usarla para visualizar el resultado de una búsqueda o la salida de un proceso. Por tanto tiene origen lista y también destino lista, ambos de la tabla a la que está asociada.

Haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7 para abrir el asistente de creación de rejilla:



42


En el asistente debemos seleccionar la tabla a la queremos asociar la rejilla, y el nombre lo asigna automáticamente en función del nombre de la tabla seleccionada. Podemos asignar también los formularios que hemos creado para la tabla y que vamos a usar para el alta, baja y modificación de registros.

El siguiente paso del asistente nos permite configurar qué campos aparecerán en la rejilla.



43


Podremos incluirlos todos , o eliminar toda la selección de campos , o bien ir uno por uno incluyéndolos o quitándolos de la selección. También podemos incluir no sólo el campo enlazado si no que también podemos incluir campos del registro enlazado.

Por último, podemos ordenar los campos de tal forma que el orden de las columnas quedará determinado por el orden que aquí definamos, llevando hacia arriba aquellos que queramos que aparezcan más a la izquierda y hacia abajo los que queramos que se encuentren más a la derecha en la rejilla.

El siguiente paso del asistente nos lleva a una previsualización, en la que además podemos seleccionar una paleta si la hemos definido.



44


En la previsualización ya podemos ver el orden que tendrán las columnas y el tamaño por defecto.

Si queremos realizar alguna modificación antes de crear la rejilla, éste es el momento, ya que el siguiente paso nos pide que confirmemos la creación de la rejilla, aunque podemos volver hacia atrás para hacer las modificaciones correspondientes o cancelar.



45


Haciendo doble clic sobre el objeto creado, podemos ver el editor de rejillas con la previsualización de la rejilla, en el que podemos realizar las modificaciones que consideremos oportunas.

Si queremos cambiar la altura de las filas de la rejilla, cambiaremos el valor de la propiedad Alto cuerpo.

Velneo vDevelop V7 nos ofrece la posibilidad de establecer distintos tipos de Ancho dinámicos para las columnas de las rejillas, lo que nos permite adaptar la anchura de las mismas al tamaño de la ventana que las contenga y/o a diferentes resoluciones de pantalla y así poder mantener en todo momento el equilibrio visual en nuestras aplicaciones.

Los tipos posibles son:

Interactivo: En ejecución el ancho de la columna será el que hayamos declarado en edición, pero podrá ser modificado por el usuario final.

Fijo: En ejecución el ancho de la columna será el que hayamos declarado en edición y no podrá ser modificado por el usuario final.

Máximo disponible: La columna se ensanchará o reducirá para adaptar la rejilla a la anchura de la vista que la contenga.

En la captura de pantalla siguiente se muestra una rejilla cuya anchura es inferior al ancho del control que la contiene, lo que provoca que aparezca un área en blanco a su derecha:



46


n la captura de pantalla siguiente se puede comprobar cómo se visualizaría esa misma rejilla pero seleccionando como ancho de la primera columna Máximo disponible:

Siguiendo estos mismos pasos crearemos las rejillas para las tablas de ARTISTS y TRACKS.

Creación de búsquedas

Se trata de un un objeto que nos permite obtener un listado de registros como resultado de buscar por uno o más índices. La lista resultante la podemos ver a través de una rejilla o bien usar como entrada de un proceso. Por tanto no tiene origen pero tiene destino lista de la tabla en que hemos buscado.

Para crear una búsqueda haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7.

Una vez que hemos creado el objeto búsqueda hemos de darle un nombre y asociarle una tabla.



47


El siguiente paso es crear los componentes de la búsqueda. Para ello pulsamos el botón de crear subobjeto y configuramos el componente.

Debemos configurar en primer lugar el Índice por el que queremos realizar la búsqueda. También debemos configurar el Modo: Todo el fichero, la Parte izquierda o Entre límites. En este caso seleccionaremos el valor Todo el fichero.



48


Si la búsqueda es de toda el fichero, no es necesario hacer nada más.

Siguiendo este mismo ejemplo crearemos las búsquedas para las tablas de ARTISTS y TRACKS.

A modo informativo, si la búsqueda fuese por la parte izquierda o entre límites, debería tener un formulario en el que le indiquemos los campos que vamos a resolver. Este formulario ha de tener un control de edición del campo que vamos a resolver y los botones Aceptar (éste lo podremos llamar Buscar) y Cancelar.

En el objeto Búsqueda asociaremos el formulario de búsqueda en la propiedad Formulario. Cuando seleccionemos la opción parte izquierda o entre límites aparecerán las propiedades que nos permiten resolver la búsqueda.

Seleccionaremos entonces los campos que editamos en el formulario de búsqueda para resolver cada una de las partes del índice. De esta manera, cuando en ejecución introduzcamos una cadena a buscar en el formulario, esta cadena será usada por el componente de la búsqueda para resolverla.



49


Si añadimos más componentes, tenemos entonces la opción de cruzar, añadir o quitar a la búsqueda cada una de las listas de registros obtenidos por cada componente de búsqueda configurando la propiedad Mezcla.



50


Creación de localizadores

El localizador es un objeto que nos permite buscar de forma dinámica un registro de entre los existentes en una tabla por uno de los índices que hemos seleccionado. De forma dinámica porque la búsqueda del registro se realiza a medida que introducimos la cadena a buscar. Podremos usar la ficha obtenida para presentarla en un formulario o usarla en un proceso con origen ficha. Por tanto, no tiene origen pero tiene destino ficha de la tabla que hemos seleccionado en el localizador.

Creamos un objeto Localizador haciendo doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7 y configuramos la tabla asociada al localizador y la rejilla en que queremos mostrar los resultados.

Para que el localizador de forma automática gestione los índices disponibles correspondientes a la tabla, basta activar la propiedad Todos los índices.

De esta manera, en ejecución, cuando usemos el localizador éste se encargará de permitir seleccionar de entre todos los índices cuál es el que queremos usar, generando el formulario



51


correspondiente para la búsqueda, con un editor en el que podamos escribir la cadena de búsqueda.

Si queremos configurar nuestro propio localizador, debemos crear un componente de localizador, igual que sucedía con las búsquedas, asociándole un formulario en el que editaremos el campo por cuyo índice queremos resolver.

Crearemos también los localizadores para las tablas de ARTISTS y TRACKS.

Creación de procesos

Un Proceso es un objeto que contiene un conjunto de instrucciones que nos permite interaccionar con la base de datos y con el usuario para realizar tareas complejas que no hemos resuelto con la estructura del proyecto de datos. Estas instrucciones son código asistido que permiten el uso de otros objetos del proyecto.

Tanto su origen como su destino son configurables, por lo que permite tener origen ninguno, ficha -pudiendo partir del registro que le demos como entrada- o lista -partiendo entonces del listado de registros que le demos como entrada-. Y también podemos configurar que tenga destino ninguno, ficha -retornando como salida una ficha con la que estemos operando en el proceso- o lista -devolviendo en ese caso como salida una lista con la que estemos trabajando en el proceso.

Cuando el proceso tenga origen ficha, la entrada puede provenir de formulario, localizador u otro proceso con destino ficha, todos de la misma tabla asociada, y la salida del destino ficha podemos usarla en un formulario o un proceso, de la misma tabla igualmente.



52


Para el origen lista podemos usar una búsqueda como entrada, una rejilla u otro proceso con destino lista, todos de la misma tabla asociada. Y de igual manera, como salida podemos usar una rejilla u otro proceso con origen lista, igualmente todos de la misma tabla.

Crearemos un Proceso haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7. Además de crear el objeto nos permite abrir el editor de instrucciones al que podemos acceder en cualquier momento haciendo doble clic sobre un objeto proceso.

En este caso vamos a crear un proceso que nos permita obtener los álbumes de un artista:

En primer lugar hemos de darle nombre y configurar el origen y el destino, tanto la tabla de origen como de destino y el tipo, si es ninguno, ficha o lista.



53


Las instrucciones del proceso serán subobjetos de éste y obtendrán su origen de éste, pero, más importante aún, las variables locales del proceso también son subobjetos del proceso. Se crearán automáticamente cuando las usemos en las instrucciones, pero podremos acudir al proceso, haciendo doble clic, para poder cambiar su configuración.

En la barra de herramientas tenemos las opciones para añadir una línea de instrucción , insertar una línea o borrar la seleccionada . También podremos comentar una línea para que no se ejecute . Por otro lado, podremos manejar las ramas del árbol de instrucciones

, además de seleccionar todas las instrucciones para copiar y pegar.

Iremos creando instrucciones seleccionando para ello el comando de entre los grupos de comandos disponibles -y los parámetros correspondientes- en función del origen de cada línea, que en primer lugar viene determinado por el origen del proceso y que podemos ir variando dependiendo de los comandos que empleemos. Algunos comandos generarán subramas cuyo origen vendrá determinado por el comando y se ejecutarán las instrucciones que cuelguen de la subrama en función de éste.

Qué registros componen la salida del proceso vienen determinados por las instrucciones Añadir ficha a la salida y Añadir lista a la salida. La primera podemos usarla para generar la salida ficha de un proceso, y ambas son válidas para generar la salida de un proceso.

En ambos casos, los comandos generan la salida a partir de la ficha o lista en cuyo origen esté situado el comando, que tiene que corresponder con el seleccionado en el proceso. En el caso de la lista, además de permitir generar la lista a partir de una ficha, permite hacerlo a partir de varias fichas y listas.

En este caso lo que hace el proceso es cargar los álbumes de un artista (Cargar plurales) y enviar la lista obtenida a la salida.

Este proceso lo usaremos más adelante en este tutor.



54


AccionesA continuación vamos a ver cómo se crean las acciones y cómo se usan y manejan los objetos que son disparables y aparcables.

El objeto Acción permite lanzar comandos en función de la entrada que hayamos seleccionado. Por un lado están los comandos en stock preprogramados, que nos permiten dar de alta un registro, modificar, eliminar, etc.; filtrar, ordenar, modificar campo, etc., en una lista; navegar a maestro por listas, a histórico, etc.; además de otros comandos de interfaz: copiar, pegar, etc.; cambiar de ventana, cerrar ventana, etc.

Pero además existe otro comando que nos permite disparar objetos en función de una entrada que definimos en el objeto y generando una salida en forma de objeto aparcable. La entrada del objeto será por tanto definible, pudiendo escoger entre ninguno, ficha y lista, y la tabla asociada, lo que determinará desde dónde podemos lanzar una acción. El destino, tanto si resultará ninguno, ficha o lista, dependerá de los objetos que usemos en la acción.

Para crear una acción haremos doble clic sobre el icono de la galería de objetos (Control + Ins) de Velneo vDevelop V7.



55


Los comandos en stock únicamente requieren el origen para ser ejecutados. El foco en el momento de pulsar la acción determina si se puede ejecutar o no en función del origen y el comando actúa sobre el elemento en el foco.

Además, la acción puede ser lanzada desde un objeto que tenga el mismo origen. Las acciones podemos usarlas como opciones de menús o barras de herramientas con o sin origen, dependiendo el origen del elemento que tenga el foco. También podemos usar la acción en formularios, tanto con origen como sin origen.

Los objetos que podemos disparar en una acción se dividen entre los que son únicamente disparables y los que además son aparcables. Estos últimos se denominan así porque tienen interfaz. Disparables son aquellos objetos que permiten generar o procesar entradas y aparcables son aquellos además tienen interfaz que permite presentar el resultado. Así, en esta división, los que únicamente son disparables son: Localizador, Búsqueda, Proceso, Lupa, Tubo de lista, Tubo de ficha, Informe y Cesta. Los objetos que además son aparcables son: Rejilla, Árbol visor de tablas, Casillero, Formulario, Multivista Informe, Blog de formularios.

Una vez que tenemos determinado el origen, el primer objeto disparable que podemos seleccionar tendrá como entrada el origen seleccionado -ninguno, ficha o lista- y deberá estar asociado a la misma tabla que la acción, y como destino valdrá cualquiera. El siguiente elemento disparable o aparcable deberá tener la misma entrada que la salida del anterior objeto y por salida valdrá cualquiera, y así podremos encadenar tantos objetos como queramos. Así sucede cuando vamos seleccionando los objetos que vamos a disparar en la acción, nos va proponiendo únicamente aquellos que tengan como origen el destino del anterior o en su defecto, el origen de la acción.

Si queremos mostrar algún resultado al usuario deberemos usar objetos aparcables que permitirán mostrar ese resultado en el objeto seleccionado.

En la captura de pantalla anterior se muestran las propiedades de una acción que dispara una búsqueda como primer objeto y una rejilla como salida de la misma. En nuestro proyecto crearemos una para cada una de las búsquedas creadas. Para acelerar el proceso selecciona el



56


objeto búsqueda en el panel central de Velneo vDevelop V7 y acto seguido pulsa el comando de crear acción y ésta será creada con el objeto 1 ya asociado.

Crearemos también una acción para disparar cada uno de los localizadores creados. En el caso de un localizador solamente será necesario seleccionar el localizador en el parámetro objeto 1 ya que para editar la ficha que el usuario seleccione se usará el formulario asociada la rejilla del localizador.

Objetos de interfaz

El siguiente paso será la creación de los objetos de interfaz. Los objetos que veremos serán Marco, Toolbar y Menú.

Estos tres objetos junto con el objeto Formulario nos permiten configurar todo nuestro interfaz.

El objeto Marco es el que nos permite definir cómo será el interfaz del usuario cuando ejecuta el proyecto de aplicación con Velneo vClient V7. Nos permite definir cuál es el formulario de fondo de nuestra aplicación, el menú principal del marco y los docks que compondrán el interfaz, que podrán contener barras de herramientas u otros formularios.

Usaremos el marco que ha sido creado por el asistente de soluciones cuyo identificador AUTOEXEC, este identificador indica al sistema que será el marco por defecto que usará Velneo vClient V7 en la ejecución del proyecto de aplicación.

Debemos asignarle además un nombre y un título, que será lo que presente como título de la ventana en ejecución. Además, debemos asignarle un formulario (sin origen, el que podemos incluir, por ejemplo, el logo de nuestra aplicación o un texto de bienvenida), que será el formulario de fondo de la aplicación, un modo de arranque, por defecto modo tab y un menú, que será el menú principal de la aplicación, que ha sido creado automáticamente por el asistente de creación de soluciones.



57


Por último, podemos crear el subobjeto Docks pulsando el botón . El Dock es una ventana aparcable que puede incluir un formulario sin origen, o bien una barra de herramientas. Este objeto nos permite añadir nuevas barras de herramientas a nuestro interfaz, y además podemos crear nuevas áreas de intefaz que presenten otros objetos como pueden ser rejillas, formularios, etc.

En el subobjeto Dock debemos definir un nombre, que será el nombre de la ventana, qué objeto es el que queremos mostrar en el dock, si va a ser una barra de herramientas o un formulario y la posición que ocupará. Además, podemos definir si será incluido, por lo que se creará una nueva



58


área para mostrar el objeto o si se añadirá a otro dock ya existente, de manera que formen un separador de pestañas.

En nuestra aplicación comprobaremos que al haber creado la solución desde el asistente, el sistema ha creado automáticamente con dock del marco principal la toolbar PRINCIPAL.El objeto Menú es un agrupador de lanzadores de acciones. Los lanzadores de acciones pueden contener un comando en stock, es decir, comandos preprogramados que tenemos disponibles para usar, o bien programar nuestras propias acciones, objeto que también podemos usar. Usaremos el menú que nos ha creado automáticamente el asistente de soluciones. Dado que este objeto dispone de un editor, para abrirlo haremos doble clic sobre el mismo:

MenúEl objeto Menú es un agrupador de lanzadores de acciones. Los lanzadores de acciones pueden contener un comando en stock, es decir, comandos preprogramados que tenemos disponibles para usar, o bien programar nuestras propias acciones, objeto que también podemos usar.

Usaremos el menú que nos ha creado automáticamente el asistente de soluciones. Dado que este objeto dispone de un editor, para abrirlo haremos doble clic sobre el mismo:

En el menú configuraremos el nombre, que será el título de la barra de herramientas. También configuraremos el estilo, ya que puede mostrar texto, texto e imágenes y únicamente imágenes (en este caso seleccionaremos el valor Texto), y un icono que será el icono de la barra de menú.

El menú, aunque se muestre vertical como un desplegable, cuando lo usamos en un marco como menú principal se mostrará horizontal, tal cual se presentan los menús principales. En ese caso no



59


presentará iconos, únicamente texto. Pero como desde un menú podemos llamar a otro, en ese caso sí que se desplegará de forma horizontal y presentará los iconos que hayamos definido.

En el menú podemos añadir o quitar los comandos en stock existentes o hacer lo mismo con las acciones que tengamos programadas. También podemos ordenarlas, subiendo o bajando el orden físico de los lanzadores de acción.

En el menú que nos ha creado el asistente añadiremos todas las acciones que hemos creado.

ToolbarEl objeto Toolbar es un agrupador de lanzadores de acciones. Los lanzadores de acciones pueden contener un comando en stock, es decir, comandos preprogramados que tenemos disponibles para usar, o bien programar nuestras propias acciones, objeto que también podemos usar. Es un objeto análogo al menú, pero en este caso nos permite construir barras de herramientas, siendo botones en vez de opciones lo que nos presenta.

Usaremos la toolbar que nos ha creado automáticamente el asistente de soluciones. Dado que este objeto dispone de un editor, para abrirlo haremos doble clic sobre el mismo:



60


En la toolbar podemos añadir o quitar los comandos en stock existentes o hacer lo mismo con las acciones que tengamos programadas. También podemos ordenarlas, subiendo o bajando el orden físico de los lanzadores de acción.

En esta toolbar lo que haremos será incluir las tres acciones correspondientes a los localizadores de Artists, Albums y Tracks.

Creación de los objetos avanzadosEn esta parte del tutor veremos cómo se crean otros objetos visuales disponibles en Velneo vDevelop V7.

Creación de bloc de formularios

Se trata de un objeto que nos permite recorrer, uno a uno, una lista de registros de una misma tabla desde un formulario:

Tal y como puede verse en la imagen anterior, el objeto bloc de formularios usa un formulario y añade una serie de controles que nos permitirán movernos al registro anterior/siguiente, al primero o al último, o a un registro concreto de la lista.



61


En este caso vamos a crear un bloc que nos permita recorrer una lista de ALBUMS dentro del formulario de ARTISTS. Para ello necesitaremos crear dos objetos: Un bloc de formularios y un proceso que devuelva los álbumes de un artista.

Para crear un bloc de formularios haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7.

Para alimentar este bloc de formulario usaremos el proceso que habíamos creado anteriormente en el capítulo dedicado a la creación de procesos (LOAD_ALBUMS_FROM_AN_ARTIST).

El siguiente paso será incrustar el bloc en el formulario del artista. Para ello editaremos el formulario correspondiente y, en la barra de controles, seleccionaremos el botón (control vista de datos), lo pegaremos en el formulario y le asignaremos las propiedades siguientes:

» Objeto 1: LOAD_ALBUMS_FROM_AN_ARTIST (Proceso).

» Objeto 2: BLOC_ALBUMS (Bloc de formularios).

Y ya tenemos totalmente operativo el bloc de álbumes en la ficha del artista.

Si en lugar de usar el bloc de formularios para ver los álbumes de un artista en su ficha queremos usar una rejilla, por ejemplo, dado que es otro objeto de lista, lo único que tendríamos que hacer sería especificar en la propiedad Objeto 2 la rejilla en lugar del bloc.

Creación de un multivista

Se trata de un objeto que nos permite sincronizar de forma sencilla de 1 a n objetos en una misma vista. Mediante el uso de procesos, podremos sincronizar rejillas, árboles, casilleros, formularios, otros objetos multi-vista, etc.



62


En un objeto multivista se sincronizarán los distintos objetos visuales que formarán parte del mismo mediante procesos.

Podremos, mediante un multivista, partiendo de una lista de artistas (ARTISTS), cargar los álbumes (ALBUMS) de un artista, cargar las pistas (TRACKS) de un álbum y editar la letra (LYRIC) de una pista, y todo ello visualizarlo:

Como multi-objeto: Una vista con una rejilla de cada tabla.Como árbol: A modo de árbol con ramas y subramas.Como wizard: A modo de asistente.

El origen del multivista será una lista de artistas (ARTISTS). En la aplicación ya se ha programado previamente una búsqueda de esa tabla y la rejilla correspondiente.

Lo siguiente que necesitamos es un proceso que cargue los álbumes de un artista, proceso que, recordemos ya habíamos creado anteriormente (LOAD_ALBUMS_FROM_AN_ARTIST).

Ahora nos queda hacer lo propio para obtener las pistas de un álbum. Para ello crearemos otro proceso. El proceso tendrá su origen en una ficha de la tabla de álbumes (ALBUMS) y destino en una lista de pistas (TRACKS):

El proceso cargará las pistas del álbum y añadirá la lista resultante a la salida:

Para ver la letra (LYRIC) de una canción (TRACK) se ha creado un formulario en la aplicación llamado TRACK_LIRYCS_READ_ONLY que muestra la letra dentro de una caja de texto.

Al igual que hemos hecho anteriormente, para sincronizar la rejilla de pistas con el formulario necesitaremos un proceso, cuyo origen y destino será una ficha de la tabla de pistas (TRACKS):



63


El proceso lo único que hará será añadir la ficha que el usuario seleccione en la rejilla de pistas a la salida:

Una vez creados estos procesos, vamos a crear el multivista; para ello haremos doble clic sobre el

icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7. Y le daremos las propiedades siguientes:



64


Recordemos que su origen es una lista de artistas. Como primer objeto de la vista usaremos, por tanto, una rejilla de artistas. Como proceso sincronizador usaremos el que carga los álbumes de un artista (LOAD_ALBUMS_FROM_AN_ARTIST_ALBUMS), que presentaremos en una rejilla de la tabla de Albums; a su vez, para obtener las pistas de un álbum usaremos el proceso LOAD_TRACKS_FROM_AN_ALBUM y mostraremos el resultado en una rejilla de dicha tabla. Por último, usaremos el proceso TRACK_EDIT para sincronizar la rejilla de pistas con el formulario de edición de la letra de la pista.

El siguiente paso será crear la acción que dispare este objeto multivista; para ello haremos doble

clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7 y le daremos las propiedades siguientes:



65


La acción partirá de una búsqueda de artistas (ARTISTS) y tendrá como salida el objeto multivista creado anteriormente. Esta acción podrá ser disparada desde un menú, desde una toolbar o desde un botón de formulario. La incluiremos en el menú principal (MAIN) del proyecto.

Como habíamos comentado al principio, un objeto multi-vista puede ser visualizado de tres formas: Como multi-objeto, como ábol y como wizard (asistente). Como multi-objeto sería:



66


Como árbol:

El árbol solamente permite incluir listas y sublistas a modo de rama, no permite incluir formularios. Pero sí que permite usar como formulario de edición de la pista el que hayamos asociado en la rejilla usada en el objeto multi-visa. En definitiva, podremos editar cualquier ficha de cualquier tabla cuya rejilla tenga asociado el formulario correspondiente.

Y como wizard (asistente):

Creación de un casillero

El casillero es un objeto que sirve para presentar listas de registros de las tablas.

Este objeto permite ver listas de registros de las tablas de datos. Esta compuesto por una serie de celdas (casillas) distribuidas en forma de filas y columnas. Una celda se corresponde con un registro de una tabla. Cada casilla se visualiza en un formulario de la tabla origen del casillero. Cada celda es a su vez un botón que permite ejecutar tres comandos:

» Ninguno: No hará nada.



67


» Editar formulario: Se editará el formulario asignado al casillero para la modificación de la ficha correspondiente a la celda pulsada. La edición del formulario se hará en la propia celda.

» Ejecutar proceso: Se ejecutará un objeto proceso contenido en el proyecto. Los procesos disponibles serán los que tienen origen ficha de la tabla origen del casillero.

Para crear un casillero haremos doble clic sobre el icono de la galería de objetos (Tecla Insert) de Velneo vDevelop V7.

Las propiedades a configurar en el casillero son:

Tras indicar las propiedades generales de identificador, nombre, estilos, comentarios y tabla asociada, debemos seleccionar el formulario que se mostrara en cada celda del casillero. También debemos definir el número de columnas que compondrán cada fila y las opciones de menú y toolbar.

Dado el casillero es un objeto de lista, para usarlo podemos crear una acción que dispare una búsqueda de Albums como Objeto 1 el casillero como Objeto 2. Esta acción podremos añadirla al menú principal (MAIN) del proyecto.

Creación de eventos y conexiones

El evento es un subobjeto contenedor de intrucciones, similar a un proceso, que podemos ejecutar asociado a una señal configurada en una conexión de evento, o desde un botón.



68


Las conexiones de evento permiten configurar una señal asociada al formulario o a un control. Cuando la señal se dispare forzará la ejecución del evento. Ejemplos de señales son un timer, que se ejecuta cada cierto tiempo, una ganancia de foco, un doble clic en una rejilla o casillero, una pulsación de botón, etc.

Los eventos disponen de un grupo de comandos específico que puede acceder al objeto desde donde se dispara denominado Comandos de interfaz. Estos comandos de interfaz nos permiten acceder a la gestión del foco, recalcular controles, acceder a la lista de registros que tiene un control o modificar las propiedades de color o fuente del control.

Realizaremos un ejemplo sencillo: al perder el foco el control de edición alfabética del campo NAME del formulario de la tabla de Artist comprobaremos si el usuario ha introducido una valor en el campo nombre y, si no es así, mostraremos un mensaje. A continuación cancelaremos la pérdida de foco para que el cursor vuelva al control.

El primer paso ha de ser crear el evento que dispararemos. Para ello, editamos el formulario y, desde la barra de opciones del panel de subobjetos añadiremos un nuevo subobjeto de tipo Evento. Haciendo doble clic sobre el subobjeto creado abriremos el editor de instrucciones que nos permite programar el evento al igual que los procesos.

Comenzaremos comprobando si el campo NAME tiene valor usando la función isEmpty(). Si no es así mostraremos un mensaje de error indicando al usuario cuál es la tarea que ha de realizar devolveremos el cursor al control con el comando Set retorno proceso=NO.

Por último, hemos de crear la conexión de evento que definirá el disparo de la señal. Para ello, de nuevo dentro del formulario, desde la barra de opciones del panel de subobjetos añadiremos un

nuevo subobjeto de tipo Conexión de evento.

El siguiente paso será completar las propiedades de este subobjeto: definiremos qué control será el que dispare la señal, en este caso el control de edición alfabética del campo NAME, cuál será la señal que dispare, en este caso la pérdida de foco del control y, por último, qué evento se disparará, que será el que acabamos de crear:



69




70


Ejecutar el proyectoUna vez que hemos definido el interfaz de nuestra aplicación, instanciaremos el proyecto de aplicación y asignar los permisos de acceso a los usuarios para que pueda ser ejectuado.

Instancia el proyecto de aplicaciónEl primer paso será instanciar el proyecto de aplicación desde Velneo vAdmin V7. Como el proyecto de aplicación hereda del proyecto de datos, éste último también debemos instanciarlo y asignar permisos al grupo de usuarios para que acceda, al igual que el proyecto de aplicación, pero se hará durante el proceso de instanciación del proyecto de aplicación.

Debemos indicar el nombre que tendrá la instancia, su identificador (obligatorio indicarlo si queremos ejecutar el proyecto directamente desde Velneo vDevelop V7 una vez instanciado), seleccionar la instancia del proyecto de aplicación que queremos instanciar y qué icono será el que se presentará en el listado de instancias disponibles cuando nos conectemos con Velneo vClient V7.

Entonces vamos a la pestaña de Instancias de aplicaciones y realizamos el mismo proceso para dar permisos al proyecto de aplicación que hemos creado. De forma automática se da permiso para ejecutar las instancias correspondientes al proyecto de datos.



71


Una vez que hemos seleccionado el proyecto de aplicación y hemos configurado todo, pasamos al siguiente paso del asistente y Velneo vAdmin V7, que será la resolución de la herencia del proyecto de datos heredado:

Si hemos realizado previamente la instanciación del proyecto de datos en este paso del asistente en lugar de decirle que cree una nueva instancia, pulsaríamos sobre el texto “Crear instancia” y seleccionaríamos la instancia de datos generada anteriormente.

En caso contrario, dejaremos la opción que propone el sistema por defecto y es la de crear una nueva instancia para el proyecto de datos heredado.



72


El siguiente paso será indicar en qué carpeta compartida vamos a crear los ficheros de datos (este paso se omitirá si en el paso anterior hemos utilizado una instanacia de datos ya existente).

Una vez que hemos indicado la carpeta compartida, podremos finalizar el asistente.



73


El último paso que nos queda por dar es asignar permisos al grupo de usuarios para que acceda a ambas instancias.

PermisosPor último, debemos asignar permisos al grupo de usuarios para acceder a ambas instancias. Para ello vamos a la pestaña de Grupos de usuarios y hacemos doble clic sobre el grupo para editarlo.

Sin embargo, también podemos hacer este paso de forma manual:

Abrimos la pestaña correspondiente a las Instancias de proyectos de datos y seguimos los mismos pasos para seleccionar el proyecto de datos a ejecutar.



74


Cuando damos permiso de acceso de este modo a un proyecto de datos estaremos permitiendo que sea atacado con Velneo vDataClient V7.

Ejecutar la aplicación con Velneo vClient V7

Al ejecutar Velneo vClient V7 se nos presentará una ventana solicitando los datos de conexión a Velneo vServer V7:



75


En ella tendremos que especificar:

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

» Usuario: Nombre de un usuario declarado en Velneo vServer V7.

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

Si tu servidor está en la nube, estos tres datos los tiene disponibles en panel de control de Velneo vServer V7, dentro del área de descargas de este sitio.

Si aceptamos, se procederá a la conexión con Velneo vServer V7. Si no es posible establecer la conexión el sistema devolverá el siguiente mensaje en la parte inferior izquieda de la ventana de conexión: “Error conexión con el servidor”.


Si el servidor está disponible y los datos de acceso son correctos, entonces se nos presentará una ventana con la lista de aplicaciones (instancias de aplicaciones) a las que tenemos acceso:



76


Haremos doble clic sobre la instancia deseada y accederemos al marco principal de la misma:



77


Los componentes del marco son:

1. Menú principal del marco: Que incluye una serie de comandos propios programados en el proyecto y comandos estándar de visualización y personalización del entorno.

2. Toolbar definida como dock dentro del marco principal: Cuyas acciones disparan, de izquierda a derecha, una búsqueda de todos los álbumes ordenados alfabéticamente, un localizador que permite buscar álbumes por todos los índices de la tabla y un localizador de álbumes por el índice de trozos de palabras.

3. Formulario principal del marco.

Ejecución directa desde Velneo vDevelop V7Es posible ejecutar desde Velneo vDevelop V7 un proyecto de la solución que tengamos cargada pulsando F5. Para que ésta pueda ser ejecutada se deben cumplir los siguientes requisitos:

La solución debe contener un proyecto de aplicación con un marco AUTOEXEC.

El proyecto de aplicación debe estar instanciado.

La instancia debe tener asignado un identificador:



78


El usuario con el que estamos editando la solución debe tener definidos permisos de ejecución al proyecto de aplicación.



79


Documents

Primeros pasos con Velneo V7dl.velneo.com/.../v7/openapps/documentos/primeros_pasos.pdf · 2014-07-17 · Primeros pasos con Velneo V7 A lo largo de este tutor iremos explicando los