Primeros Pasos

Configuracin.................................................................................................................... 2 Creacin de la solucin y los proyectos................................................................................. 6 Creacin de la estructura de datos...................................................................................... 13 Creacin de tablas......................................................................................................... 14 Creacin de los campos.................................................................................................. 20 Creacin de ndices........................................................................................................
22 Ejecutar el proyecto de datos............................................................................................. 24 Instanciar el proyecto de datos........................................................................................ 24 Asignar permisos de ejecucin a la instancia de datos creada.............................................. 29 Ejecutar con Velneo vDataClient V7................................................................................. 31 Creacin de los objetos de aplicacin.................................................................................. 36 Creacin de objetos bsicos............................................................................................ 37 Creacin de formularios............................................................................................... 37 Creacin de rejillas..................................................................................................... 42 Creacin de bsquedas................................................................................................ 47 Creacin de localizadores............................................................................................. 51 Creacin de procesos.................................................................................................. 52 Este proceso lo usaremos ms adelante en este tutor. .................................................... 54 Acciones.................................................................................................................... 55 Objetos de interfaz........................................................................................................ 57 Men........................................................................................................................ 59 Toolbar..................................................................................................................... 60 Creacin de los objetos avanzados................................................................................... 61 Creacin de bloc de formularios.................................................................................... 61 Creacin de un multivista............................................................................................. 62 Creacin de un casillero............................................................................................... 67 Creacin de eventos y conexiones................................................................................. 68 Ejecutar el proyecto.......................................................................................................... 71 Instancia el proyecto de aplicacin................................................................................... 71 Permisos...................................................................................................................... 74 Ejecutar la aplicacin con Velneo vClient V7...................................................................... 75 Ejecucin directa desde Velneo vDevelop V7..................................................................... 78
Pol. Ind. A Granxa | Ra D Esquina paralela 3 Edif. vCenter, 36400 Porrio | Pontevedra | Espaa Telf. (+34) 902 366 382 | Fax (+34) 902 932 324 velneo@velneo.com | www.velneo.com
Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 1
Primeros pasos con Velneo V7 A 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: Configuracin: Declaracin de usuarios y permisos en Velneo vServer V7. Programacin: Creacin de la solucin, el proyecto de datos y proyecto de aplicacin con Velneo vDevelop V7. Instanciacin: Declaracin de aplicaciones y permisos en Velneo vServer V7. Ejecucin: Conexin a la aplicacin con Velneo vClient V7. La aplicacin que vamos a desarrollar es muy sencilla. Se trata de una base de datos de msica, en la que se contemplarn nicamente tres tablas: Artistas (ARTISTS), lbumes de los artistas (ALBUMS) y pistas de los lbumes (TRACKS). A esta aplicacin la llamaremos vMusicBox.
Configuracin
Una 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 conexin 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. Contrasea: Contrasea del usuario declarado en el parmetro anterior. Ejemplo: Servidor: vatp://v7cloud1.velneo.com:XXXX Usuario: user@domain.com Contrasea: user@domain.com
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 contrasea, para que podamos comenzar a administrar el servidor. Si aceptamos, se proceder a la conexin con Velneo vServer V7, mostrndose en la parte inferior del formulario de conexin el progreso de la conexin. Si no es posible establecer la conexin el sistema devolver el siguiente mensaje en la parte inferior izquierda de la ventana de conexin: Error conexin con el servidor. Si el servidor es encontrado pero hemos introducido mal el usuario o la contrasea, el sistema devolver el mensaje de error siguiente: Usuario/Contrasea 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:
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 opcin Grupos de usuarios. Si se trata de un servidor en la nube veremos que ha sido creado automticamente un grupo llamado admin, si hacemos un clic sobre l veremos que el sistema ha incluido en l nuestro usuario:
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 aplicacin, es decir, el cdigo fuente de Velneo V7, que desarrollaremos con Velneo vDevelop V7. Adems, debemos activar tambin la propiedad Puede ejecutar proyectos de datos con vDataClient: Ya que ms adelante explicaremos cmo se usa dicho producto. A partir de este momento ya podremos comenzar el desarrollo de nuestra aplicacin con Velneo vDevelop V7.
Creacin de la solucin y los proyectos

Vamos a comenzar el desarrollo de nuestra aplicacin con Velneo vDevelop V7, para ello tendremos que conectarnos con nuestro Velneo vServer V7, crear la solucin y crear tanto la estructura de datos de nuestro proyecto (proyecto de datos) como los objetos visuales del mismo (proyecto de aplicacin). Para crear una nueva solucin ejecutaremos la opcin Nueva solucin del men Soluciones. Una vez hecho esto se presentar el asistente para la creacin de soluciones:
En l tendremos que cumplimentar las propiedades siguientes: Nombre: vMusicBox. Servidor: Ser el servidor al que nos hayamos conectado (vatp://.). para pasar al siguiente paso del asistente:
Pulsaremos el botn
En este paso seleccionaremos la plantilla a aplicar. En este caso seleccionaremos la opcin Un proyecto de datos y otro de aplicacin: sta crear la solucin en el servidor indicado en el primer paso del asistente y conteniendo un proyecto de datos y otro de aplicacin dentro de ella. El siguiente paso del asistente ser la especificacin del nombre del proyecto o proyectos a crear:
Estableceremos las propiedades siguientes: Nombre del proyecto: Aplicacin: vMusicBox. Nombre del proyecto: Database: vMusicBox.
Pulsaremos el botn para ir al siguiente paso del asistente. Si en la sesin actual ya nos habamos 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:
En este caso no seleccionaremos ningn proyecto. Este paso ser obviado si no nos hemos conectado previamente a ningn Velneo vServer V7. El siguiente paso del asistente ser la definicin de los idiomas del proyecto o proyectos a crear:
Estos idiomas que se podrn seleccionar en ejecucin para mostrar la informacin de los objetos. Por defecto se toma el idioma del sistema. Si queremos aadir otro debemos seleccionar el Idioma y el Pas 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 pases se presentan en funcin del idioma seleccionado. Una vez definidos los idiomas pulsaremos el botn finalizacin del asistente: para pasar a la ventana de
NOTA IMPORTANTE: Si al finalizar el asistente el sistema advierte que no ha podido crear la solucin ser porque el usuario con el que nos hemos conectado a Velneo vServer V7 no tiene privilegios para ello. Para saber cmo asignrselos consultar el captulo anterior, titulado Configuracin. La solucin que acabamos de crear ser cargada directamente en el panel del explorador de proyectos Y los proyectos sern cargados automticamente:
A continuacin 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 botn para y lo
salvarlo. A continuacin haremos doble clic sobre el proyecto de aplicacin guardaremos tambin.
Creacin de la estructura de datos

En este punto ya hemos creado a travs de Velneo vDevelop V7 la solucin vMusicBox y dentro de sta un proyecto de datos y otro de aplicacin. En este caso lo que haremos ser editar el proyecto de datos. Si no tenemos cargada la solucin creada en el captulo anterior tendremos que cargarla, para ello pulsaremos el botn . Si no estamos conectados con ningn Velneo vServer V7 el sistema nos pedir los datos de conexin al mismo; una vez establecida la conexin con Velneo vServer V7, se presentar una ventana con la lista de soluciones de ese Velneo vServer V7:
Hacer doble clic sobre la solucin vMusicBox. Tamibn podremos cargar una solucin pulsando el botn , que aparece junto al botn de abrir solucin. Al pulsarlo se abrir lista de las ltimas soluciones abiertas, haramos clic sobre la solucin vMusicBox. Si apareciese vaco 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 solucin, sus proyectos sern mostrados en el explorador de proyectos:
Si tenemos cargada la solucin 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.
Creacin de tablas
A continuacin veremos los pasos para crear las tablas de la aplicacin. 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 aplicacin. Para ello utilizaremos el asistente para la creacin de tablas.
Para crear una tabla haremos doble clic sobre el icono de la galera de objetos (Control + Ins) de Velneo vDevelop V7. Se nos presentar el primer formulario del asistente:
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: Seleccin de tipos de tabla. En nuestro ejemplo todas sern maestro normal con clave numrica. Esto crear la tabla con un campo ID (cdigo) de tipo numrico y autoincrementable, que permitir identificar a cada registro de forma nica y exclusiva) y un campo NAME, alfabtico, donde podremos escribir el nombre de cada registro (el del artista en la tabla de ARTISTS, por ejemplo).
A continuacin pulsamos el botn Siguiente, lo que nos mostrar el formulario:
En este formulario definiremos el nombre y la longitud del campo cdigo as como la propiedad Numeracin automtica. A continuacin pulsaremos el botn Siguiente, lo que nos mostrar el formulario:
Seleccionaremos los tipos de ndices que queremos crear a partir del campo nombre de la tabla, que sern, ndice alfabtico, ndice de palabras e ndice de trozos de palabras; para finalmente pulsar el botn Siguiente, lo que nos mostrar el formulario:
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:
En este ltimo formulario debemos pulsar Finalizar. En este momento la tabla ser creada en el proyecto. A continuacin 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 seleccin de campos enlazados a maestros:
El asistente nos crea de forma automtica 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.
Creacin de los campos

A continuacin veremos los pasos para crear campos e ndices en las tablas de nuestra aplicacin. Una vez creadas las tablas, para aadir, 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 botn crearemos un nuevo campo en la tabla en la que estemos posicionarnos. A continuacin podremos definir las propiedades del campo en el panel de propiedades.
En un campo podremos definir las siguientes propiedades: Identificador: Dato de referencia del campo en su manejo en la programacin. Nombre: Dato de referencia del campo en su manejo en la ejecucin. Estilos: Nos permite declarar el campo como privado. Comentarios: Para aadir comentarios internos a la programacin. 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 informacin 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 Cdigo 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 tamao del campo en bytes. Informacin: Dato informativo de la capacidad final del contenido del campo.
A la tabla ARTISTS, que ya tendr los campos ID y NAME, le aadiremos los campos siguientes: Identificador COMMENTS PIC Nombre Comments Picture Tipo Objeto/Texto Objeto/Dibujo Longitud No hay que indicarla No hay que indicarla Uso Para introducir comentarios sobre el artista. 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 aadiremos los campos siguientes: Identificador COVER YEAR Nombre Cover Year Tipo Objeto/Dibujo Numrico Longitud No hay que indicarla 2 bytes Uso Portada del disco. Ao de publicacin.
A la tabla TRACKS, que ya tendr los campos ID, NAME y ALBUMS (campo enlazado a la tabla del mismo nombre) le aadiremos los campos siguientes: Identificador LYRICS Nombre Lyrics Tipo Objeto/Texto Longitud No hay que indicarla Uso Letra de la cancin.
Creacin de ndices
Si bien en este tutor no vamos a necesitar crear ningn ndice, ya que nos basta con los que se han creado de forma automtica a generar las tablas con el asistente, explicaremos igualmente cmo han de ser creados. Pulsando el botn crearemos un nuevo objeto ndice en la tabla en la que estemos posicionarnos. A continuacin 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 programacin. Nombre: Dato de referencia del ndice en su manejo en la ejecucin. Estilos: Nos permite declarar el ndice como privado o no.
Comentarios: Para aadir comentarios internos a la programacin. Tipo de ndice: Permite definir si el tipo de ndice. Condicin par indexar: Editor de formulas que nos permite definir una formula condicin par que un registro se indexe. Nmero de partes: Dato informativo del nmero de campos que componen el ndice. Longitud de la clave: Dato informativo del tamao del ndice por cada registro indexado.
Ejecutar el proyecto de datos

Este captulo muestra el uso de Velneo vDataclient V7, producto para usuarios de niveles 3 y 4. Pro tanto, este punto no es indispensable para la realizacin de los primeros pasos, sino un ejemplo de uso de dicho producto para los usuarios del mismo.
Instanciar el proyecto de datos

A continuacin vamos a ver los pasos que hay que seguir para instanciar un proyecto de datos. La instanciacin consiste en la declaracin 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 solucin. El siguiente paso ser declarar la carpeta en la que se generarn los datos del proyecto de datos. Este paso no es necesario si ests 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 botn barra de herramientas. de la
Esto abrir la ventana para la creacin de una nueva carpeta compartida. En ella tendremos que indicar:
Nombre: Identificador del recurso compartido. Senda: Senda fsica de la carpeta compartida. Para facilitar la seleccin de la misma si pulsamos el botn obtendremos un explorador de archivos.
En la pestaa Estilos definiremos los privilegios de acceso que tendrn 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 creacin 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 automticamente al grupo al que pertenezca el usuario que la ha creado:
Una vez declarada la carpeta compartida, ya podremos proceder a instanciar el proyecto de datos. Para ello accederemos a la opcin Instancias.
En el panel superior tenemos un listado de las instancias de datos de Velneo vServer V7 al que nos hayamos conectado. Para aadir una nueva instancia debemos seleccionar el botn situado sobre el panel Instancias de datos. Esto nos mostrar el formulario del asistente para la creacin de instancias:
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 botn Finalizar.
Un proyecto de datos es el cdigo fuente en el que se define la estructura de la base de datos y una instancia es su representacin 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 ejecucin a la instancia de datos creada

Una vez creada la instancia, debemos establecer con Velneo vAdmin V7 los permisos de ejecucin a la misma. stos se establecen a nivel de grupo de usuarios, por lo que seleccionaremos la opcin 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 pestaa Estilos activaremos la opcin Puede ejecutar proyectos de datos con vDataClient.
Ejecutar con Velneo vDataClient V7

En este punto a ver los pasos que debemos seguir para conectarnos a una base de datos con Velneo vDataClient V7. Al ejecutar la aplicacin Velneo vDataClient V7 nos muestra un primer formulario solicitando los datos de conexin:
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. Contrasea: Contrasea del usuario declarado en el parmetro anterior.
Si aceptamos, se proceder a la conexin con Velneo vServer V7, mostrndose en la parte inferior del formulario de conexin el progreso de la conexin. Si no es posible establecer la conexin el sistema devolver el siguiente mensaje en la parte inferior izquierda del formulario de conexin: Error conexin con el servidor. Si el servidor es encontrado pero hemos introducido mal el usuario o la contrasea, el sistema devolver el mensaje de error siguiente: Usuario/Contrasea incorrectos. Si el servidor est disponible y los datos de acceso son correctos, entonces accederemos al interfaz de Velneo vDataClient V7.
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:
En el panel izquierdo tenemos un arbolado de todas las tablas de la base de datos. Movindonos en este arbolado podemos desplegar y hacer consultas de los ndices de la tabla, relaciones de plural y casilleros visores especficos 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:
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, modificacin 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, histricos e histricos de todos. Procesos: Sin origen, lista y ficha. Utilidades: Ver cach de fichas, regenerar datos y regenerar ndices. Para mayor informacin del funcionamiento de estas opciones consultar la ayuda de Velneo vDataClient V7.
Creacin de los objetos de aplicacin

En esta parte del tutor vamos a comenzar el desarrollo de los objetos visuales de nuestra aplicacin con Velneo vDevelop V7. Si no tenemos cargada la solucin creada en el captulo anterior tendremos que cargarla, para ello pulsaremos el botn . Si no estamos conectados con ningn Velneo vServer V7 el sistema nos pedir los datos de conexin al mismo; una vez establecida la conexin con Velneo vServer V7, se presentar una ventana con la lista de soluciones de ese Velneo vServer V7:
Hacer doble clic sobre la solucin vMusicBox. Tambin podremos cargar una solucin pulsando el botn , que aparece junto al botn de abrir solucin. Al pulsarlo se abrir lista de las ltimas soluciones abiertas, haramos clic sobre la solucin vMusicBox. Si apareciese vaco 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 solucin, sus proyectos sern mostrados en el explorador de proyectos:
Si tenemos cargada la solucin pero no el proyecto de aplicacin, tendremos que hacer doble clic sobre l en el explorador de proyectos para cargarlo:
Como puede observarse, el asistente para la creacin de soluciones ha creado automticamente tres objetos: Un marco, un men y una toolbar.
Creacin de objetos bsicos

En los siguientes puntos veremos cmo se crean los objetos bsicos para operar o interaccionar con una tabla: formulario, rejilla, bsqueda, localizador y proceso. Creacin 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. Adems, se puede usar en bsquedas y localizadores para definir los trminos de la bsqueda. 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 galera de objetos (Tecla Insert) de Velneo vDevelop V7, esto provocar la apertura de un asistente que nos facilitar su creacin. En el primer paso del asistente estableceremos las propiedades siguientes:
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 ningn tipo de plantilla seleccionaremos la llamada Vaca (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 opcin si queremos que el formulario a crear contemple layouts.
Bloque de botones: Activaremos esta opcin si queremos que el formulario a crear contenga un bloque para situar botones Acepar, Cancelar, etc. Posicin: Si la opcin anterior est activada, en esta indicaremos en qu posicin ser situado el bloque de botones.
Pulsaremos el botn Siguiente para ir al siguiente paso del asistente; donde tendremos que seleccionar los campos que irn en cada bloque que va a generarse en el formulario. Por cada bloque existir una pestaa y en ella se indicarn los campos a incluir en el mismo. En la pestaa Bloque 1 incluiremos los campos NAME, ARTISTS y YEAR. Para ello, dentro de la pestaa Bloque 1 pulsaremos el botn y, en la ventana que se despliega, seleccionaremos los capos y pulsaremos el botn Aceptar. para aadir todos los campos. Una vez hecho esto , los campos sern mostrados en el asistente:
El orden en que se muestran los campos seleccionados ser el orden en el que sern creados en el formulario. Podemos cambiar la posicin de un campo usando los botones incluida en la pestaa. Podremos borrar un campo pulsando el botn En el Bloque 2 incluiremos el campo COVER. El resto de las propiedades de esta pestaa no las modificaremos; dejaremos los valores por defecto. Distribucin: En esta propiedad seleccionaremos cul va a ser la posicin de las etiquetas con respecto a los controles de edicin correspondientes. Estirar controles: Si esta propiedad est activa, todos los controles de un bloque sern creados con la misma longitud; si est inactiva sern creados segn el tipo y longitud del campo que editen. El Bloque 3, lo dejaremos vaco 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 pestaa Botones para configurar su apariencia. El sistema por defecto asume la creacin de dos botones, Aceptar y Cancelar, ambos ya programados con las funciones de grabacin y cancelacin de ficha, respectivamente. Lo que haremos ser aadir un nuevo botn Eliminar, para ello pulsaremos el botn de la barra de herramientas incluida dentro de esta pestaa y seleccionar la opcin Eliminar. Esto har que se aada un botn ya programado con la funcin que elimina la ficha editada: . de la toolbar
A continuacin lo que haremos ser seleccionar el modo en que el los botones sern 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 botn Siguiente y a continuacin el botn Finalizar. Una vez hecho esto el formulario ser aadido a nuestro proyecto y editado:
Y ya est listo para ser usado. Tendremos que crear tambin, mediante el asistente, los formularios correspondientes a las tablas de ARTISTS y TRACKS. Creacin 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 bsqueda o la salida de un proceso. Por tanto tiene origen lista y tambin destino lista, ambos de la tabla a la que est asociada.
Haremos doble clic sobre el icono de la galera de objetos (Tecla Insert) de Velneo vDevelop V7 para abrir el asistente de creacin de rejilla:
En el asistente debemos seleccionar la tabla a la queremos asociar la rejilla, y el nombre lo asigna automticamente en funcin del nombre de la tabla seleccionada. Podemos asignar tambin los formularios que hemos creado para la tabla y que vamos a usar para el alta, baja y modificacin de registros. El siguiente paso del asistente nos permite configurar qu campos aparecern en la rejilla.
Podremos incluirlos todos , o eliminar toda la seleccin de campos , o bien ir uno por uno incluyndolos o quitndolos de la seleccin. Tambin podemos incluir no slo el campo enlazado si no que tambin 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 que aparezcan ms a la izquierda y hacia abajo derecha en la rejilla. aquellos que queramos los que queramos que se encuentren ms a la
El siguiente paso del asistente nos lleva a una previsualizacin, en la que adems podemos seleccionar una paleta si la hemos definido.
En la previsualizacin ya podemos ver el orden que tendrn las columnas y el tamao por defecto. Si queremos realizar alguna modificacin antes de crear la rejilla, ste es el momento, ya que el siguiente paso nos pide que confirmemos la creacin de la rejilla, aunque podemos volver hacia atrs para hacer las modificaciones correspondientes o cancelar.
Haciendo doble clic sobre el objeto creado, podemos ver el editor de rejillas con la previsualizacin 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 dinmicos para las columnas de las rejillas, lo que nos permite adaptar la anchura de las mismas al tamao 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 ejecucin el ancho de la columna ser el que hayamos declarado en edicin, pero podr ser modificado por el usuario final. Fijo: En ejecucin el ancho de la columna ser el que hayamos declarado en edicin y no podr ser modificado por el usuario final. Mximo 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:
n la captura de pantalla siguiente se puede comprobar cmo se visualizara esa misma rejilla pero seleccionando como ancho de la primera columna Mximo disponible:
Siguiendo estos mismos pasos crearemos las rejillas para las tablas de ARTISTS y TRACKS. Creacin de bsquedas Se trata de un un objeto que nos permite obtener un listado de registros como resultado de buscar por uno o ms ndices. La lista resultante la podemos ver a travs 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 bsqueda haremos doble clic sobre el icono Insert) de Velneo vDevelop V7. de la galera de objetos (Tecla
Una vez que hemos creado el objeto bsqueda hemos de darle un nombre y asociarle una tabla.
El siguiente paso es crear los componentes de la bsqueda. Para ello pulsamos el botn de crear subobjeto y configuramos el componente.
Debemos configurar en primer lugar el ndice por el que queremos realizar la bsqueda. Tambin debemos configurar el Modo: Todo el fichero, la Parte izquierda o Entre lmites. En este caso seleccionaremos el valor Todo el fichero.
Si la bsqueda es de toda el fichero, no es necesario hacer nada ms. Siguiendo este mismo ejemplo crearemos las bsquedas para las tablas de ARTISTS y TRACKS. A modo informativo, si la bsqueda fuese por la parte izquierda o entre lmites, debera tener un formulario en el que le indiquemos los campos que vamos a resolver. Este formulario ha de tener un control de edicin del campo que vamos a resolver y los botones Aceptar (ste lo podremos llamar Buscar) y Cancelar.
En el objeto Bsqueda asociaremos el formulario de bsqueda en la propiedad Formulario. Cuando seleccionemos la opcin parte izquierda o entre lmites aparecern las propiedades que nos permiten resolver la bsqueda. Seleccionaremos entonces los campos que editamos en el formulario de bsqueda para resolver cada una de las partes del ndice. De esta manera, cuando en ejecucin introduzcamos una cadena a buscar en el formulario, esta cadena ser usada por el componente de la bsqueda para resolverla.
Si aadimos ms componentes, tenemos entonces la opcin de cruzar, aadir o quitar a la bsqueda cada una de las listas de registros obtenidos por cada componente de bsqueda configurando la propiedad Mezcla.
Creacin de localizadores El localizador es un objeto que nos permite buscar de forma dinmica un registro de entre los existentes en una tabla por uno de los ndices que hemos seleccionado. De forma dinmica porque la bsqueda 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 galera 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 automtica gestione los ndices disponibles correspondientes a la tabla, basta activar la propiedad Todos los ndices.
De esta manera, en ejecucin, cuando usemos el localizador ste se encargar de permitir seleccionar de entre todos los ndices cul es el que queremos usar, generando el formulario
correspondiente para la bsqueda, con un editor en el que podamos escribir la cadena de bsqueda. Si queremos configurar nuestro propio localizador, debemos crear un componente de localizador, igual que suceda con las bsquedas, asocindole un formulario en el que editaremos el campo por cuyo ndice queremos resolver.
Crearemos tambin los localizadores para las tablas de ARTISTS y TRACKS. Creacin 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 cdigo 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 tambin 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.
Para el origen lista podemos usar una bsqueda 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 galera de objetos (Tecla Insert) de Velneo vDevelop V7. Adems 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.
Las instrucciones del proceso sern subobjetos de ste y obtendrn su origen de ste, pero, ms importante an, las variables locales del proceso tambin son subobjetos del proceso. Se crearn automticamente cuando las usemos en las instrucciones, pero podremos acudir al proceso, haciendo doble clic, para poder cambiar su configuracin. En la barra de herramientas tenemos las opciones para aadir una lnea de instruccin insertar una lnea que no se ejecute o borrar la seleccionada ,
. Tambin podremos comentar una lnea para para copiar y pegar.
. Por otro lado, podremos manejar las ramas del rbol de instrucciones , adems de seleccionar todas las instrucciones
Iremos creando instrucciones seleccionando para ello el comando de entre los grupos de comandos disponibles -y los parmetros correspondientes- en funcin del origen de cada lnea, que en primer lugar viene determinado por el origen del proceso y que podemos ir variando dependiendo de los comandos que empleemos. Algunos comandos generarn subramas cuyo origen vendr determinado por el comando y se ejecutarn las instrucciones que cuelguen de la subrama en funcin de ste. Qu registros componen la salida del proceso vienen determinados por las instrucciones Aadir ficha a la salida y Aadir lista a la salida. La primera podemos usarla para generar la salida ficha de un proceso, y ambas son vlidas 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, adems 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 ms adelante en este tutor.
Acciones A continuacin vamos a ver cmo se crean las acciones y cmo se usan y manejan los objetos que son disparables y aparcables. El objeto Accin permite lanzar comandos en funcin de la entrada que hayamos seleccionado. Por un lado estn 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 histrico, etc.; adems de otros comandos de interfaz: copiar, pegar, etc.; cambiar de ventana, cerrar ventana, etc.
Pero adems existe otro comando que nos permite disparar objetos en funcin 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 dnde podemos lanzar una accin. El destino, tanto si resultar ninguno, ficha o lista, depender de los objetos que usemos en la accin.
Para crear una accin haremos doble clic sobre el icono Ins) de Velneo vDevelop V7.
de la galera de objetos (Control +
Los comandos en stock nicamente requieren el origen para ser ejecutados. El foco en el momento de pulsar la accin determina si se puede ejecutar o no en funcin del origen y el comando acta sobre el elemento en el foco. Adems, la accin puede ser lanzada desde un objeto que tenga el mismo origen. Las acciones podemos usarlas como opciones de mens o barras de herramientas con o sin origen, dependiendo el origen del elemento que tenga el foco. Tambin podemos usar la accin en formularios, tanto con origen como sin origen. Los objetos que podemos disparar en una accin se dividen entre los que son nicamente disparables y los que adems son aparcables. Estos ltimos se denominan as porque tienen interfaz. Disparables son aquellos objetos que permiten generar o procesar entradas y aparcables son aquellos adems tienen interfaz que permite presentar el resultado. As, en esta divisin, los que nicamente son disparables son: Localizador, Bsqueda, Proceso, Lupa, Tubo de lista, Tubo de ficha, Informe y Cesta. Los objetos que adems 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 accin, 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 accin, nos va proponiendo nicamente aquellos que tengan como origen el destino del anterior o en su defecto, el origen de la accin. Si queremos mostrar algn resultado al usuario deberemos usar objetos aparcables que permitirn mostrar ese resultado en el objeto seleccionado. En la captura de pantalla anterior se muestran las propiedades de una accin que dispara una bsqueda como primer objeto y una rejilla como salida de la misma. En nuestro proyecto crearemos una para cada una de las bsquedas creadas. Para acelerar el proceso selecciona el
objeto bsqueda en el panel central de Velneo vDevelop V7 y acto seguido pulsa el comando de crear accin y sta ser creada con el objeto 1 ya asociado. Crearemos tambin una accin para disparar cada uno de los localizadores creados. En el caso de un localizador solamente ser necesario seleccionar el localizador en el parmetro 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 creacin de los objetos de interfaz. Los objetos que veremos sern 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 cmo ser el interfaz del usuario cuando ejecuta el proyecto de aplicacin con Velneo vClient V7. Nos permite definir cul es el formulario de fondo de nuestra aplicacin, el men principal del marco y los docks que compondrn el interfaz, que podrn 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 ejecucin del proyecto de aplicacin. Debemos asignarle adems un nombre y un ttulo, que ser lo que presente como ttulo de la ventana en ejecucin. Adems, debemos asignarle un formulario (sin origen, el que podemos incluir, por ejemplo, el logo de nuestra aplicacin o un texto de bienvenida), que ser el formulario de fondo de la aplicacin, un modo de arranque, por defecto modo tab y un men, que ser el men principal de la aplicacin, que ha sido creado automticamente por el asistente de creacin de soluciones.
Por ltimo, podemos crear el subobjeto Docks pulsando el botn . El Dock es una ventana aparcable que puede incluir un formulario sin origen, o bien una barra de herramientas. Este objeto nos permite aadir nuevas barras de herramientas a nuestro interfaz, y adems 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 posicin que ocupar. Adems, podemos definir si ser incluido, por lo que se crear una nueva
rea para mostrar el objeto o si se aadir a otro dock ya existente, de manera que formen un separador de pestaas. En nuestra aplicacin comprobaremos que al haber creado la solucin desde el asistente, el sistema ha creado automticamente 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 tambin podemos usar. Usaremos el men que nos ha creado automticamente 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 tambin podemos usar. Usaremos el men que nos ha creado automticamente 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 ttulo de la barra de herramientas. Tambin configuraremos el estilo, ya que puede mostrar texto, texto e imgenes y nicamente imgenes (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 mens principales. En ese caso no
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 aadir bajando o quitar los comandos en stock existentes o hacer lo mismo o
con las acciones que tengamos programadas. Tambin podemos ordenarlas, subiendo el orden fsico de los lanzadores de accin.
En el men que nos ha creado el asistente aadiremos todas las acciones que hemos creado. Toolbar El 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 tambin podemos usar. Es un objeto anlogo 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 automticamente el asistente de soluciones. Dado que este objeto dispone de un editor, para abrirlo haremos doble clic sobre el mismo:
En la toolbar podemos aadir bajando
o quitar
los comandos en stock existentes o hacer lo mismo o
con las acciones que tengamos programadas. Tambin podemos ordenarlas, subiendo el orden fsico de los lanzadores de accin.
En esta toolbar lo que haremos ser incluir las tres acciones correspondientes a los localizadores de Artists, Albums y Tracks.
Creacin de los objetos avanzados

En esta parte del tutor veremos cmo se crean otros objetos visuales disponibles en Velneo vDevelop V7. Creacin 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 aade una serie de controles que nos permitirn movernos al registro anterior/siguiente, al primero o al ltimo, o a un registro concreto de la lista.
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 (Tecla Insert) de Velneo vDevelop V7. de la galera de objetos
Para alimentar este bloc de formulario usaremos el proceso que habamos creado anteriormente en el captulo dedicado a la creacin 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 botn (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 tendramos que hacer sera especificar en la propiedad Objeto 2 la rejilla en lugar del bloc. Creacin 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.
En un objeto multivista se sincronizarn los distintos objetos visuales que formarn 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 aplicacin ya se ha programado previamente una bsqueda 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 habamos 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 aadir la lista resultante a la salida:
Para ver la letra (LYRIC) de una cancin (TRACK) se ha creado un formulario en la aplicacin 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):
El proceso lo nico que har ser aadir 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 galera de objetos (Tecla Insert) de Velneo vDevelop V7. Y le daremos las propiedades siguientes:
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 edicin de la letra de la pista. El siguiente paso ser crear la accin que dispare este objeto multivista; para ello haremos doble clic sobre el icono de la galera de objetos (Tecla Insert) de Velneo vDevelop V7 y le daremos las propiedades siguientes:
La accin partir de una bsqueda de artistas (ARTISTS) y tendr como salida el objeto multivista creado anteriormente. Esta accin podr ser disparada desde un men, desde una toolbar o desde un botn de formulario. La incluiremos en el men principal (MAIN) del proyecto. Como habamos 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 sera:
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 edicin 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):
Creacin 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 botn que permite ejecutar tres comandos: Ninguno: No har nada.
Editar formulario: Se editar el formulario asignado al casillero para la modificacin de la ficha correspondiente a la celda pulsada. La edicin del formulario se har en la propia celda. Ejecutar proceso: Se ejecutar un objeto proceso contenido en el proyecto. Los procesos disponibles sern los que tienen origen ficha de la tabla origen del casillero.
Para crear un casillero haremos doble clic sobre el icono Insert) de Velneo vDevelop V7. Las propiedades a configurar en el casillero son:
de la galera de objetos (Tecla
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. Tambin debemos definir el nmero de columnas que compondrn cada fila y las opciones de men y toolbar. Dado el casillero es un objeto de lista, para usarlo podemos crear una accin que dispare una bsqueda de Albums como Objeto 1 el casillero como Objeto 2. Esta accin podremos aadirla al men principal (MAIN) del proyecto. Creacin de eventos y conexiones El evento es un subobjeto contenedor de intrucciones, similar a un proceso, que podemos ejecutar asociado a una seal configurada en una conexin de evento, o desde un botn.
Las conexiones de evento permiten configurar una seal asociada al formulario o a un control. Cuando la seal se dispare forzar la ejecucin del evento. Ejemplos de seales son un timer, que se ejecuta cada cierto tiempo, una ganancia de foco, un doble clic en una rejilla o casillero, una pulsacin de botn, etc. Los eventos disponen de un grupo de comandos especfico que puede acceder al objeto desde donde se dispara denominado Comandos de interfaz. Estos comandos de interfaz nos permiten acceder a la gestin 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 edicin alfabtica 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 continuacin cancelaremos la prdida 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 aadiremos 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 funcin isEmpty(). Si no es as mostraremos un mensaje de error indicando al usuario cul 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 conexin de evento que definir el disparo de la seal. Para ello, de nuevo dentro del formulario, desde la barra de opciones del panel de subobjetos aadiremos un nuevo subobjeto de tipo Conexin de evento.
El siguiente paso ser completar las propiedades de este subobjeto: definiremos qu control ser el que dispare la seal, en este caso el control de edicin alfabtica del campo NAME, cul ser la seal que dispare, en este caso la prdida de foco del control y, por ltimo, qu evento se disparar, que ser el que acabamos de crear:
Ejecutar el proyecto
Una vez que hemos definido el interfaz de nuestra aplicacin, instanciaremos el proyecto de aplicacin y asignar los permisos de acceso a los usuarios para que pueda ser ejectuado.
Instancia el proyecto de aplicacin

El primer paso ser instanciar el proyecto de aplicacin desde Velneo vAdmin V7. Como el proyecto de aplicacin hereda del proyecto de datos, ste ltimo tambin debemos instanciarlo y asignar permisos al grupo de usuarios para que acceda, al igual que el proyecto de aplicacin, pero se har durante el proceso de instanciacin del proyecto de aplicacin.
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 aplicacin 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 pestaa de Instancias de aplicaciones y realizamos el mismo proceso para dar permisos al proyecto de aplicacin que hemos creado. De forma automtica se da permiso para ejecutar las instancias correspondientes al proyecto de datos.
Una vez que hemos seleccionado el proyecto de aplicacin y hemos configurado todo, pasamos al siguiente paso del asistente y Velneo vAdmin V7, que ser la resolucin de la herencia del proyecto de datos heredado:
Si hemos realizado previamente la instanciacin del proyecto de datos en este paso del asistente en lugar de decirle que cree una nueva instancia, pulsaramos sobre el texto Crear instancia y seleccionaramos la instancia de datos generada anteriormente. En caso contrario, dejaremos la opcin que propone el sistema por defecto y es la de crear una nueva instancia para el proyecto de datos heredado.
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.
El ltimo paso que nos queda por dar es asignar permisos al grupo de usuarios para que acceda a ambas instancias.
Permisos
Por ltimo, debemos asignar permisos al grupo de usuarios para acceder a ambas instancias. Para ello vamos a la pestaa de Grupos de usuarios y hacemos doble clic sobre el grupo para editarlo.
Sin embargo, tambin podemos hacer este paso de forma manual: Abrimos la pestaa correspondiente a las Instancias de proyectos de datos y seguimos los mismos pasos para seleccionar el proyecto de datos a ejecutar.
Cuando damos permiso de acceso de este modo a un proyecto de datos estaremos permitiendo que sea atacado con Velneo vDataClient V7.
Ejecutar la aplicacin con Velneo vClient V7

Al ejecutar Velneo vClient V7 se nos presentar una ventana solicitando los datos de conexin 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. Contrasea: Contrasea del usuario declarado en el parmetro 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 conexin con Velneo vServer V7. Si no es posible establecer la conexin el sistema devolver el siguiente mensaje en la parte inferior izquieda de la ventana de conexin: Error conexin con el servidor. Si el servidor es encontrado pero hemos introducido mal el usuario o la contrasea, el sistema devolver el mensaje de error siguiente: Usuario/Contrasea incorrectos. 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:
Haremos doble clic sobre la instancia deseada y accederemos al marco principal de la misma:
Los componentes del marco son: 1. Men principal del marco: Que incluye una serie de comandos propios programados en el proyecto y comandos estndar de visualizacin y personalizacin del entorno. 2. Toolbar definida como dock dentro del marco principal: Cuyas acciones disparan, de izquierda a derecha, una bsqueda de todos los lbumes ordenados alfabticamente, 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.
Ejecucin directa desde Velneo vDevelop V7

Es posible ejecutar desde Velneo vDevelop V7 un proyecto de la solucin que tengamos cargada pulsando F5. Para que sta pueda ser ejecutada se deben cumplir los siguientes requisitos: La solucin debe contener un proyecto de aplicacin con un marco AUTOEXEC. El proyecto de aplicacin debe estar instanciado. La instancia debe tener asignado un identificador:
El usuario con el que estamos editando la solucin debe tener definidos permisos de ejecucin al proyecto de aplicacin.

Primeros Pasos

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Primeros Pasos

Transféré par

Droits d'auteur :

Formats disponibles

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 1

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 2

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 3

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 4

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 5

Creacin de la solucin y los proyectos

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 6

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 7

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 8

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 9

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 10

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 11

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 12

Creacin de la estructura de datos

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 13

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

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 14

A continuacin pulsamos el botn Siguiente, lo que nos mostrar el formulario:

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 15

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 16

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 17

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 18

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 19

Creacin de los campos

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 20

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 21

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 22

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 23

Ejecutar el proyecto de datos

Instanciar el proyecto de datos

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 24

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 25

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 26

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 27

Por ltimo debemos pulsar el botn Finalizar.

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 28

Asignar permisos de ejecucin a la instancia de datos creada

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 29

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 30

Ejecutar con Velneo vDataClient V7

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 31

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 32

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 33

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 34

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 35

Creacin de los objetos de aplicacin

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 36

Creacin de objetos bsicos

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 37

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 38

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 39

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 40

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 41

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 42

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 43

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 44

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 45

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 46

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 47

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 48

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 49

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 50

Primeros pasos con Velneo V7 Fecha de creacin 12/04/2010 17:47:00 51