Tutorial de in i Ciorapi Do Deserv Oy




Este documento es una gua inicial para ser utilizada con Servoy Developer versin 5.x . Para dudas o sugerencias contactarse por email a [email protected]

A) Introduccin a los Conceptos de Servoy .................................................................................3 A1) Sobre Servoy......................................................................................................................... 3 A2) Conceptos de Programacin ................................................................................................. 5 A3) Conceptos de Datos .............................................................................................................. 7

B) Bajar e Instalar Servoy Developer...........................................................................................9 C) Introduccin al Ambiente de Desarrollo Servoy ....................................................................10 D) Crear una Solucin...............................................................................................................13 E) Manejando Conexiones con Bases de Datos..........................................................................15 F) Creando Formularios ............................................................................................................17 G) Iniciando (debug) Clientes....................................................................................................19 H) Poniendo Formularios dentro de Formularios.......................................................................20 I) Implementando Lgica de Negocios ......................................................................................23 J) Aplicando Estilos con CSS ......................................................................................................27 K) Implementando una Solucin en Produccin ........................................................................31

K1) Exportando una Solucin..................................................................................................... 31 K2) Instalando y corriendo el Servidor de Aplicaciones de Servoy ............................................. 32 K3) Importando una Solucin en el Servidor de Aplicaciones de Servoy .................................... 33 K4) Corriendo una Solucin en el Cliente................................................................................... 34




A) Introduccin a los Conceptos de Servoy

A1) Sobre Servoy

Servoy es nico en el sentido que es tanto una herramienta de Desarrollo Rpido de Aplicaciones (RAD) y una plataforma de despliegue en produccin. Escrito enteramente en Java, usando componentes y protocolos estndar de la industria, Servoy ofrece la escalabilidad de una plataforma de cmputo de nivel empresarial, mientras que al mismo tiempo proporciona una productividad incomparable al programador.

Multi-Plataforma

Tal como es la promesa de Java, las aplicaciones construidas en Servoy pueden ser implementadas en todos los sistemas operativos modernos, incluyendo Windows, Mac, Linux, Solaris, etc. Sin necesidad de reescribir ni recompilar el cdigo.

Multi-Navegador

Las aplicaciones escritas en Servoy tambin pueden desplegarse en cualquier navegador moderno, incluyendo IE, Firefox, Safari, Opera, Chrome, etc. No hay necesidad de reescribir o ajustar una aplicacin para asegurar una experiencia consistente entre todos los navegadores y no deben usarse ningn protocolo ni plug-ins de navegador propietarios.

Un nico Cdigo Base

Servoy ofrece dos opciones principales de cliente y cualquier aplicacin desarrollada en Servoy puede ser desplegada en cualquiera de estos clientes sin necesidad de reescribir. Hurra!

El cliente nativo Smart Client proporciona una implementacin Cliente-Servidor, donde las aplicaciones asumen el look and feel nativo del sistema operativo cliente donde se lanza la aplicacin.

El Web Client proporciona una experiencia de navegacin dinmica enriquecida por la tecnologa AJAX, CSS y HTML. A los programadores nunca se les requiere tener que escribir su propio cdigo HTML, JavaScript de cliente o AJAX (Por supuesto que pueden hacerlo si quieren) .

Multiples Bases de Datos

Servoy NO ES una base de datos. Hay cantidad de excelentes bases de datos en el mercado y Servoy puede conectarse con cualquier RDBMS moderna (e incluso con varias no tan modernas).

Arquitectura de N-Capas

Servoy proporciona un poderoso Servidor de Aplicaciones que gestiona las conexiones entre clientes y los recursos del back-end. Esta arquitectura es mucho ms favorable que la arquitectura de 2 capas usada por




la mayora de las herramientas 4GL, donde los clientes se conectan directamente a las bases de datos del back-end. Un servidor de aplicaciones ofrece las siguientes ventajas sobre una configuracin de 2 capas.

Gran reduccin de carga en las bases de datos del back-end. Mejor performance Ms Escalabilidad Mayor Seguridad Habilidad de operar en una WAN (Wide Area Network) Data Broadcasting: La habilidad de todos los clientes de ver en tiempo real los cambios en los datos,

una caracterstica nica en Servoy.

Cero-Deployment, Cero-Instalacin

Las aplicaciones Servoy nunca deben ser instaladas en la mquina cliente.

Las aplicaciones que corren con Smart Client se bajarn e instalarn automticamente usando la tecnologa Java WebStart. De hecho, los programadores pueden poner en produccin fcilmente nuevos cambios a los usuarios, con un click para exportar una nueva versin al Servidor de Aplicaciones. El Servidor de Aplicaciones NO TIENE que reiniciarse y los clientes conectados NO DEBEN salir de la aplicacin. Ms an, el Servidor de Aplicaciones soporta versionado con capacidades de retroceso y avance de versin en produccin.

Resumiendo: Sin Instalacin. Sin Mantenimiento.




A2) Conceptos de Programacin

Soluciones

Una solucin es una aplicacin conteniendo formularios, mtodos, variables, y otros tems construida en Servoy Developer.

Las soluciones pueden ser independientes, o tambin pueden ser un mdulo. Un mdulo es una solucin que es parte de otra solucin.

Formularios

Un formulario es un objeto de Servoy que se usa para editar, ver, modificar, insertar, buscar y borrar datos. Los formularios pueden contener campos, etiquetas, grficos, tabpanels, lneas, botones, portales y formas cada uno de los cuales tiene su propio grupo de comandos en tiempo de diseo, eventos y propiedades.

Los formularios normalmente estn basados en una tabla de una base de datos, lo que significa que los datos de esta tabla estn vinculados al formulario. Los formularios tambin pueden no estar relacionados a ninguna tabla, lo que significa que no habr datos vinculados al formulario.

Los formularios tambin pueden tener mtodos y variables, haciendo del formulario una unidad alcance en la programacin Servoy. Esto significa que los formularios pueden tener mtodos y variables que solo estn dentro del alcance del formulario. Formularios heredados tambin pueden tener mtodos y variables que tambin son heredados del formulario padre.

Elementos del Formulario

Un elemento de un formulario es un objeto en Servoy que puede ser ubicado en un formulario para un propsito. Los elementos de formulario incluyen:

Etiquetas/Labels Texto que puede aparecer en un formulario; normalmente esttico pero que pueden asignarse en tiempo de ejecucin, no pueden ser cambiados o copiados por el usuario final.

Campo Un elemento conectado con un dataprovider; puede ser editado y seleccionado por el usuario final y tiene muchos formatos en que puede ser mostrado (texto, radio buttons, html)

Botones Tipo especial de etiqueta pre-formateada para que se vea como un objeto sobre el que se puede hacer click en un formulario, normalmente relacionado con un mtodo.

Lneas y formas varios objetos de dibujo que pueden se ubicados en un formulario por esttica y diseo de la Interfase de Usuario

Portal objeto que muestra datos relacionados en una relacin de uno a muchos. Tabpanel un objeto que permite desplegar mltiples formularios en un formulario. Los

formularios adicionales pueden agregarse a travs de una relacin (para mostrar datos relacionados) o como formularios no relacionados.




Beans Se puede agregar Java Beans a un formulario, extendiendo la funcionalidad de la interfase de usuario en Servoy. Est disponible una API de Java para escribir beans que puedan usarse en Servoy.

Dataproviders

Un dataprovider maneja informacin. Los Dataproviders no son solo columnas de una base de datos, sino que tambin incluyen clculos, sumas, variables globales y variables del formulario.

Mtodos

El motor de scripting de Servoy usa mtodos para identificar cdigo. Un mtodo en Servoy es esencialmente lo mismo que una funcin de JavaScript. Es un agrupamiento de cdigo en una nica unidad usada para realizar varias tareas en Servoy. Un mtodo puede llamar otros mtodos, setear propiedades en ejecucin para elementos de formularios de Servoy, y llamar funciones disponibles en las bibliotecas.

Funciones

Una funcin en Servoy es lo mismo que un mtodo. Es una funcin JavaScript y se ve como la primera lnea en una llamada a un mtodo como en el siguiente ejemplo:

function onActionAdd(event)

Todos los mtodos escritos en Servoy comenzarn con la palabra function en la pgina .js donde estn escritos.

Plugin

Un plugin extiende la funcionalidad de Servoy al usar el lenguaje de programacin Java. Escritos en Java, pueden ser accedidos en una solucin a travs de cdigo. Los plugins pueden agregar funciones adicionales a los programadores Servoy y pueden relacionarse con recursos por fuera de Servoy. Hay una API disponible para escribir plugins para Servoy.




A3) Conceptos de Datos

Los siguientes conceptos estn relacionados con el manejo de datos en Servoy

Tabla

Una tabla es un formato preestablecido de filas (registros) y columnas (campos) que definen una estructura de informacin en una base de datos relacional. Datos provenientes de una tabla creada o una pre-existente pueden ser usados por uno o ms formularios en una solucin Servoy.

Columna

Una columna es un atributo de la tabla de la base de datos.

Registro

Un registro se asigna a una fila individual en una tabla de base de datos SQL.

Foundset

Un foundset es un objeto Servoy que representa un query de una tabla en particular de una base de datos. Los foundsets manejan el almacenamiento en cache de datos para mostrar, pero no requieren volver a consultar la base de datos para hacerlo.

Cualquier formulario basado en una tabla en Servoy tiene un foundset subyacente manejando los datos para el formulario. Formularios basados en la misma tabla compartirn un foundset salvo que sean dirigidos de forma diferente a travs de cdigo o de propiedades en tiempo de diseo.

Los foundsets pueden ser creados, accedidos, alterados, controlados y aplicados a travs de programacin.

Relacin

Una relacin es un objeto Servoy usado para definir la relacin de claves entre dos tablas de bases de datos. Una relacin estndar se define por la clave primaria de una tabla relacionada con una clave externa de otra. Algunas caractersticas de una relacin incluyen:

Las tablas pueden relacionarse por igual, pero tambin por otros operadores (,like, y ms). Las tablas pueden existir en dos servidores de bases de datos diferentes en distintas plataformas de

bases de datos. Las tablas pueden relacionarse por ms de una columna. Una variable global puede usarse en la parte izquierda de la relacin. Esto es til para filtrar datos,

al poder usar una relacin para filtrar un grupo de registros seteando el valor de una variable global. Integridad referencial, puede forzarse, y tambin deletes en cascada.

Dataset




Un dataset es un objeto Servoy que puede contener datos de fila y columna. Los datasets pueden crearse por programacin, o tambin pueden ser devueltos por un query SQL. A diferencia de los foundsets, los datasets no representan un link vivo con un recurso de la base de datos.

Clculo

Un clculo es un valor derivado que acta como otra columna en la tabla de la base de datos. El dato calculado es el resultado de una funcin JavaScript y es similar a un mtodo Servoy. La diferencia principal es lo que est disponible para la funcin; una funcin de clculo no puede acceder variables de formulario, valores de elementos de un formulario, o funciones de la aplicacin ya que se calcula a nivel de los datos de la aplicacin. La funcin tiene disponibles los datos de las columnas y cualquier dato relacionado.

Los clculos vienen en dos variantes: Clculos Guardados (Stored) y Clculos no Guardados: los clculos guardados son columnas en la base de datos, mientras los clculos no guardados solo viven en memoria cuando la solucin est corriendo.

Los clculos se calculan cuando su valor es requerido, por ejemplo cuando es mostrado en la Interfase de Usuario o usado en programacin o en otro clculo y su valor no fue an calculado o ha sido marcado como invlido. Un clculo es marcado como invlido cuando ocurre un cambio en uno de los dataproviders del cual el clculo depende.

Si hay elementos en la Interfase de Usuario que muestran el clculo, sern notificados para actualizarse y el clculo se ejecutar para calcular el nuevo valor.

Si el clculo es un clculo guardado, el registro del cual es parte ser marcado como cambiado (por lo tanto estar en la lista de registros editados) y ser parte de la siguiente accin de grabacin.

Agregacin

Una agragacin es un valor derivado de un grupo de registros en una tabla, son calculados basados en una serie de valores en una columna. Semejante a los clculos, la metadata de la agregacin se guarda con la solucin, pero est basada en la tabla. Las agregaciones pueden ser contar, sumar, mximo, mnimo y promedio.

Variable

Una variable puede definirse y mantener datos en tiempo de ejecucin, pero no est atada a ninguna columna de la base de datos. Las variables pueden usarse como dataproviders en un formulario, y pueden ser creadas a nivel de formulario o a nivel global.




B) Bajar e Instalar Servoy Developer Si aun no lo hizo, debe bajar e instalar Servoy. Lo primer es bajarlo desde nuestro sitio web en http://www.prorm.com/prorm_siteweb/pages/servoy.php El nico requisito para correr Servoy es tener instalado un Runtime Environment de Java (JRE). Si no est seguro si cuenta con un JRE en su mquina puede probar aqu http://demo.servoy.com/autoinstallvm.html y si no est instalado se instalar automticamente. Eligiendo el instalador correcto

El instalador de Servoy viene en 2 variantes:

El instalador multi plataforma (.jar) El instalador ejecutable para Windows (.exe)

El instalador multi-plataforma tambin puede usarse en Windows, pero algunos programas anti-virus pueden bloquear la ejecucin de archivos .jar. Por lo tanto, se provee el instalador ejecutable para Windows como una alternativa.

Corriendo el instalador

Para comenzar la instalacin, ejecute el instalador. Dependiendo de la plataforma, o bien haga doble click sobre servoy_installer.jar o ejecute el siguiente comando en la lnea de comandos o en una ventana de terminal:

java -jar servoy_installer.jar

Si al hacer doble click sobre el instalador multi-plataforma el archivo servoy_installer.jar se abre como un archivo zip en vez de un ejecutable, es que la extensin '.jar' no est configurada para ser abierto por Java. Use la opcin de lnea de comando , use la opcin de su plataforma para Abrir con o configure la plataforma para abrir los archivos '.jar' usando Java.

Al correr el instalador se abrir el dilogo del instalador. Para una instalacin por defecto simplemente siga las instrucciones del instalador y no cambie ninguno de los paquetes por defecto. Puede elegir diferentes ubicaciones para los archivos y renombrar los accesos directos si desea.

NOTA: Usando la configuracin por defecto se instalar automticamente el motor de base de datos PostgreSQL, bases de datos de ejemplo, y soluciones de ejemplo en el repositorio.




C) Introduccin al Ambiente de Desarrollo Servoy

Informacin General

Servoy Developer es la herramienta RAD usada para construir aplicaciones de software. Incluye un constructor de formularios grfico WYSIWYG (what-you-see-is-what-you-get), combinado con sofisticadas herramientas de modelado de datos, un motor de scripting y una robustas APIs.

Desde la versin 4.0, Servoy Developer ha venido como un plug-in para el ambiente de desarrollo integrado (IDE) Eclipse. De cdigo abierto, un estndar de la industria, Eclipse es el IDE ms usado en el mundo, elogiado por su rico conjunto de caractersticas, productividad y extensibilidad. Los programadores que estn familiarizados con Eclipse, se sentirn en casa usando Servoy.

Conceptos de Eclipse

Workspace

Un workspace es donde se guarda todo el trabajo del programador en Eclipse. Es una carpeta de archivos ubicada en la mquina del programador y contiene archivos para cada proyecto tanto como metadata para Eclipse. El programador puede tener mltiples carpetas de workspace, pero solo puede trabajar con una a la vez.

Proyectos

Eclipse organiza diferentes grupos de cdigo en proyectos. En Servoy Developer, existen los siguientes proyectos

Proyectos de Recursos estos proyectos guardan informacin sobre bases de datos, estilos, usuarios y datos de internacionalizacin (i18n).

Proyectos de Soluciones todas las soluciones se guardan en proyectos separados en Servoy Developer

Perspectivas

Una perspectiva en Eclipse es un grupo de vistas para un propsito particular. En resumen, una perspectiva contiene todo lo que ves en la pantalla en Servoy Developer.

Cuando abres Servoy Developer la primera vez (luego de cerrar la Pantalla de Bienvenida), la primera perspectiva que vers es la perspectiva de Servoy Design. Esta perspectiva contiene las vistas para trabajar con soluciones Servoy y todas sus partes. Otras perspectivas usadas al programar en Servoy incluyen Debug, Resource, y Team Synchronizing, entre otras.

Las perspectivas pueden customizarse a gusto del programador. Las vistas pueden moverse o quitarse, y la perspectiva puede guardarse con un nombre diferente.

Vistas




Una vista es una ventana dentro de una perspectiva. Las vistas pueden proporcionar informacin al programador, mostrar objetos o funciones que pueden usarse en una solucin, o usarse para editar la solucin. Las vistas de edicin se usan para construir formularios o mtodos en Servoy; estas son las vistas que estn en el medio de la perspectiva.

Perspectiva Servoy Design

La perspectiva Servoy Design es donde el programador promedio Servoy pasar la mayor parte de su tiempo de desarrollo. Esta perspectiva contiene muchas vistas que ayudan al programador a ser productivo y eficiente. Algunas de las vistas ms importantes se listan a continuacin:

El Explorador de la Solucin (Solution Explorer)

La vista Solution Explorer es una vista de rbol jerrquico de todos los objetos disponibles en Servoy Developer. Es central al ambiente de desarrollo de Servoy; todo lo que puedes hacer en el Developer puede encontrarse en el Solution Explorer.

El Solution Explorer tiene dos partes, el rbol de objetos (aparece arriba) y una lista contextual (aparece debajo). Dependiendo en lo que se seleccione en la vista de rbol, diferentes objetos aparecern en la vista de lista.

Vista de Propiedades

La vista de Propiedades (aparece a la derecha del Workbench por defecto) muestra varias propiedades de tiempo de diseo que pueden ser editadas por el programador. Las propiedades que aparecen dependen en que se lo que est seleccionado tanto en el Solution Explorer o en el Diseador de Formularios. Todos los objetos que aparecen en un formulario tendrn un grupo de propiedades que pueden ser seteadas por el programador. Las propiedades de la Solucin se muestran cuando se selecciona la solucin en el Solution Explorer.

Diseador de Formularios

La vista de editor de Diseo de Formularios (aparece en el medio superior del Workbench por defecto) permite al programador crear las partes visuales de sus soluciones. Una vez que se abre el formulario en el Diseador de Formularios, varios controles pueden ubicarse en el formulario. Estos controles pueden modificarse seleccionndolos y arrastrndolos (tanto para el tamao como posicin), o el programador puede usar el toolbar disponible en la parte superior del Workbench para realizar tareas de alineacin y grupo.

Editor de Script

La vista de Editor de Script (aparece en el mismo lugar que el Diseador de Formularios por defecto) permite al programador crear y editar mtodos usados en sus soluciones. Las pginas de cdigo que aparecen en el Editor de Script estn vinculadas tanto a un formulario, la solucin (como un archivo global), o a una tabla (clculos).

Vista de Problemas




La vista de Problemas (aparece en la parte de abajo al centro en el Workbench por defecto) muestra errores y warning pertenecientes a la solucin y proyecto de recursos actualmente activa. Alguna informacin sobre el error o warning se muestra en esta vista tambin. Haciendo click derecho mostrar opciones, haciendo doble click abrir el error en la vista apropiada.

Guardando su Traabajo en Servoy Developer

Al editar su solucin en Servoy Developer, la mayora de los editores y vistas se salvan de la misma forma. Para grabar su trabajo en Servoy Developer

Seleccionar File>Save del archive menu Presionar la combinacin de teclas ctrl-s. Click en el icono con un disco en el toolbar Developer. Cerrando la vista del editor cuando los cambios no fueron grabados mostrar un dilogo

preguntando si desea salvar antes de cerrar.

NOTA: No se requiere salvar el developer antes de cerrar. Los tems se graban individualmente. Una vez que un item es salvado, es escrito al archivo del workspace.




D) Crear una Solucin

Crear una nueva solucin (o importar una solucin) en Servoy crea un Nuevo proyecto en Eclipse, lo que significa la creacin de una nueva carpeta en la carpeta del workspace activo. La nueva carpeta tendr el mismo nombre de la solucin.

Crear una Nueva Solucin

1. Elija alguna de las siguientes opciones 1. Seleccione File>New>New Project desde el menu en Servoy Developer. Aparecer una

ventana; seleccione el nodo Servoy y elija New Solution y haga click en Next. 2. Seleccione el Botn New en el toolbar de arriba. Aparecer una ventana; seleccione el

nodo Servoy y elija New Solution y haga click en Next. 3. Haga click con el botn derecho sobre el nodo All Solutions O sobre la solucin activa

actual. Seleccione Create new solution desde el menu. Aparecer una ventana. 2. En este punto, deber haber una ventana con el ttulo "Crear Nueva Solucin". Ingrese un nombre

para la solucin. 3. Seleccione el tipo de la solucin. Normal es suficiente en la mayora de los casos. Puede indicar si

es un modulo si solo la usar como un modulo. Las opciones solo smart client y solo web client tambin estn disponibles.

4. Seleccione un proyecto de recursos. El por defecto normalmente es suficiente. Puedes crear uno propio si quieres.

5. Hacer Click en Finish para terminar. La nueva solucin ser la solucin activa en el Solution Explorer.

TIP: Mejores prcticas: se recomienda usar solo un proyecto de recursos por workspace para no generar confusin.

Importando una Solucin Existente

Puede querer usar una solucin existente desde un archivo de exportacin de Servoy (.servoy). Si se realiz una instalacin por defecto, hay soluciones de ejemplo disponibles en la carpeta de instalacin de Servoy/ /application_server/solutions/examples que puedes instalar y usar.

Para importar una solucin en Servoy Developer:

1. Elegir uno de los siguientes 1. Seleccionar File>Import. Aparecer una ventana, elije la opcin >Import solution y haz click

en next. 2. Hacer click con el botn derecho sobre el nodo All solutions en el Solution Explorer y

seleccionar Import a solution. Aparecer una ventana. 2. Deberas tener una ventana con con ttulo "Import a solution". 3. Seleccionar el archive .servoy que deseas importar. 4. Mantn las opciones como aparecen par alas soluciones de ejemplo.




5. Puedes elegir usar un proyecto de recursos diferente (mira el tip ms arriba). 6. Haz click en Finish para terminar. 7. Puede haber ms cajas de dilogo preguntando sobre importar datos de ejemplo, estilos, etc. Para

las soluciones de ejemplo di a todo que Si. (Si el estilo puedes elegir skip para no copiarlo o overwrite para reescribirlo con este nuevo que ests importando).

8. Haz click en OK en la ventana de resultados una vez que termine la importacin. La nueva solucin importada se convertir en la solucin activa en el Solution Explorer.




E) Manejando Conexiones con Bases de Datos

Introduccin

Casi todas las aplicaciones Servoy utilizan una base de datos para almacenar los datos de usuario y la metadata de la aplicacin. Servoy puede conectarse con cualquier base de datos que tenga un driver JDBC disponible. Servoy viene con una base de datos, PostgreSQL, si no tienes un sistema de bases de datos (DBMS).

Creando una Nueva Base de DAtos en PostgreSQL

En Servoy Developer, puedes crear una nueva base de datos PostgreSQL desde al rbol de Solution Explorer.

1. En el rbol de Solution Explorer en Servoy Developer, expande el nodo Database Servers (debajo de Resources) y haz click con el botn derecho en cualquier base de datos PostgreSQL (todas las bases de datos de ejemplo provistas por Servoy son PostgreSQL) para que aparezca un popup menu.

2. Selecciona Create PostGreSQL Database. 3. Ingresa un nombre para la base de datos en la ventana de dilogo. 4. Aparecer un dilogo mientras la base de datos es creada. 5. Otro dilogo te alertar cuando la creacin haya finalizado. Entonces haz click en OK.

Conectndose a una Base de Datos Existente

Tambin puedes conectarte a una base de datos existente en Servoy Developer.

1. Determina el driver JDBC requerido para hacer las conexiones a tu base de datos. Normalmente obtienes el driver adecuado del fabricante de la base de datos; otra fuente que puede ayudar es el Foro de Servoy ya que otros programadores deben haber usado tu base de datos con Servoy.

2. Instalar el driver copiando el archivo .jar en la carpeta de instalacin de Servoy/application_server/drivers.

3. Reinicia Servoy Developer. 4. Crea una nueva conexin de Database Server hacienda click con el botn derecho en el nodo

Database Servers (debajo de Resources) y selecciona New Server. Un submenu te dar opciones de diferentes bases de datos tpicas que te ayudar completando varias de las opciones de conexin, o puedes elegir empty para hacerlo todo tu mismo.

NOTA: Aunque la base de datos deseada aparezca listada aqu, an debes instalar el driver en la carpeta drivers para poder conectarse a la base de datos.

5. Completa el Server Name poniendo un nombre a tu conexin, Usuario, Password, URL de conexin, y el Driver para tu base de datos. Puedes encontrar los valores correctos para la URL y Driver en la documentacin de tu base de datos, o se sugerirn valores si eliges tu base de datos del men New Server.

NOTA: la cuenta de usuario debe tener nivel administrativo para tener acceso total a los objetos de la base de datos en Servoy




6. Guarda los cambios haciendo click en el botn save en la toolbar o usando Ctrl-S. 7. Tu base de datos debera ahora aparecer en la lista de Database Servers.

Creando Tablas y Columnas

Es una buena prctica crear tu modelo de datos (tablas, claves primarias, claves externas, y campos) antes de crear tu solucin. Puedes crear objetos en la base de datos con las herramientas que te provee tu base de datos para administrar la base, o puedes crear objetos dentro del Servoy Developer.

Creando Tablas

Para crear una tabla en Servoy Developer:

1. Haz click con el botn derecho en el nombre del nodo de Database Servers y selecciona Create Table O Con el nombre de la base de datos seleccionado, hacer click en el botn create table del toolbar de la vista de lista en el Solution Explorer.

2. Un dilogo te preguntar por el nombre para la nueva tabla. Ingresa el nombre y haz click en OK. 3. El editor de tabla aparecer permitindote crear nuevas columnas.

NOTA: Cuando se crea una nueva tabla, Servoy agregar una columna en el editor de tabla para la clave primaria. Todas las tablas utilizadas en Servoy deben tener una clave primaria o un identificador de fila.

Creando Columnas

Para crear una columna en Servoy Developer:

1. Abrir el editor de tablas seleccionando el database server en el Solution Explorer y hacienda una de las siguientes opciones en la vista de lista:

1. Doble click sobre el nombre de la tabla. 2. Click derecho en el nombre de la tabla y seleccionar Edit table/view. 3. Seleccionar la tabla y hacer click en el boton edit table en el toolbar de la vista de lista.

2. Aparecer el editor de tabla permitindote editar las columnas de la tabla. 3. Para agregar una columna, haz click en el botn Add. Cambia el nombre donde dice "type here" por

el nombre que quieras, el tipo de columna, el tamao (si aplica). Asegrate de guardar los cambios al terminar.

4. Para quitar una columna, haz click en el botn Remove.




F) Creando Formularios

Introduccin

El objeto bsico de interfase de usuario en Servoy es un formulario. Los formularios tambin son una unidad de alcance en Servoy, lo que significa que los formularios pueden tener variables y mtodos atribuidos a ellos.

Creando un Formulario

Para crear un formulario:

Click derecho sobre la solucin active en el Solution Explorer, y seleccionar Create New Form Click derecho en el nodo Formularios bajo la solucin (o mdulo) en el que quieras crear el

formulario en el Solution Explorer y seleccionar Create New Form Click en el botn New Form en el toolbar de Servoy Developer

Cualquiera de estas acciones abrir el Wizard de Nuevo Formulario que te guiar en la creacin de un formulario.

Wizard de Nuevo Formulario

Para moverse entre las opciones disponibles en el Wizard de Nuevo Formulario, estas instrucciones usarn la conexin con example_data con la tabla customers.

1. Antes de ingresar el nombre para el formulario, selecciona la tabla deseada. Haz click en el botn y se abrir un rbol para seleccionar la tabla de todas las conexiones de bases de datos existentes. Si no quieres asociar el formulario con una tabla, selecciona none-. En nuestro ejemplo, selecciona example_data.customers.

2. Nota que el nombre de la tabla aparecer en el campo nombre del nuevo formulario. Puedes editar este nombre; mantn presente que dos formularios no pueden tener el mismo nombre en una solucin. Para nuestro ejemplo, nombra este formulario como customers_dtl.

TIP: Usar una convencin de nombres puede ayudarte a hacer un seguimiento de los formularios e indicarte cual es el propsito del formulario solo por su nombre

3. Si ests usando una hoja de estilo (style sheet), puedes elegir el nombre de la hoja de estilo que deseas usar.

4. Verifica que el nombre de la solucin es la solucin correcta para el formulario. 5. Haz click en Next. 6. Selecciona data providers que aparecern en el formulario. Nota que puedes seleccionar columnas,

clculos, variables de formulario, variables globales y data providers por una relacin. Manteniendo la tecla Shift apretada podrs seleccionar un rango; manteniendo la tecla Control apretada te permitir seleccin mltiple. Para este ejemplo, selecciona unas pocas columnas de la tabla.




7. Hay opciones para manejar como quieres que los data providers sean agregados al formulario. La mayora de las veces, para un formulario para ver un registro, solo necesitas marcar la opcin Place with Labels. Para este ejemplo, solo selecciona Place with Labels.

NOTA: Los formularios normalmente se crean en vista de registro (record view), pero si seleccionas Fill text property y Place horizontal, el formulario ser configurado como vista de tabla.

8. Haz click en Finish para terminar. 9. El Nuevo formulario creado ahora ser cargado en el Diseador de Formularios.

Editando un Formulario

Para editar un formulario pre-existente en el Diseador de Formularios:

1. Seleccionar el formulario en el Solution Explorer. 2. Hacer una de las siguientes opciones

1. Presionar Ctrl-Shift-a 2. Click derecho en el nombre del formulario (o cualquier nodo hijo del formulario en el rbol)

y seleccionar Open in Form Designer. 3. El formulario debera aparecer en el editor del Diseador de Formularios en el centro del

Workbench.

Para editar un formulario en el Editor de Cdigo (Script Editor):

1. Seleccionar el formulario en el Solution Explorer 2. Hacer una de las siguientes opciones

1. Presionar Ctrl-Shift-z 2. Click derecho en el nombre del formulario (o cualquier nodo hijo del formulario en el rbol)

y seleccionar Open in Script Editor. 3. Crear un Nuevo mtodo de formulario.

3. El formulario debera aparecer en el Editor de Cdigo en el centro del Workbench.

NOTA: Haciendo click derecho en cualquiera de los editores mostrar un men con opciones para abrir el formulario en el otro editor. Ejemplo: si tienes abierto el formulario en el Diseador de Formulario, puedes hacer click derecho y seleccionar Open in Script Editor.

Guardando un Formulario

Guardar y grabar un formulario es lo mismo que guardar cualquier otra vista de edicin en Servoy Developer (Control-S).




G) Iniciando (debug) Clientes

Introduccin

Con Servoy se puede testear (y depurar!) tu aplicacin directamente desde el ambiente de desarrollo. Esto incluye ambos el Cliente Smart y el Cliente Web. Esto es posible ya que cuando se inicia Servoy Developer, una instancia local del Application Server tambin se inicia en el background. Permite dos conexiones de cliente -una para cada uno el Smart y el Web.

Por otra parte, a medida que hagas cambios a tu aplicacin, Servoy difundir estos cambios en los clientes debug (tanto smart como web), permitindote ver los cambios en tiempo real, testear y debuguear sin necesidad de reiniciar el cliente.

Nota: Depurar aplicaciones de navegador es tradicionalmente muy difcil debido a que la lgica est dividida asincrnicamente entre el cliente y el servidor. Sin embargo, debido a que Servoy ejecuta toda tu lgica de negocios en el servidor, puedes testear y debuguear tus aplicaciones de navegador directamente desde la IDE.

Lanzando el Debug Smart Client

Para lanzar la solucin activa en el Debug Smart Client, selecciona la opcin de menu Actions > Start SmartClient.

O simplemente haz click en el botn Start SmartClient del toolbar.

Lanzando el Debug Web Client

Para lanzar la solucin activa en el Debug Web Client, selecciona la opcin de menu Actions > Start WebClient.

O simplemente haz click en el botn Start WebClient del toolbar.




H) Poniendo Formularios dentro de Formularios

Puede ponerse formularios dentro de otros formularios poniendo un tabpanel en un formulario. Un tabpanel puede mostrar otros formularios dentro de la solucin (incluyendo formularios en otros mdulos).

Ubicando un Formulario dentro de un Formulario

Para poner un formulario en otro formulario, necesitamos los siguientes objetos de Servoy

Una relacin Otro formulario Un tabpanel

Creando una Relacin

Antes que podamos poner un formulario relacionado en otro formulario, debemos crear una Relacin. Una relacin es un link entre dos tablas (o una variable global y una tabla).

Para este ejemplo, crearemos una relacin en la base de datos example_data de customers a orders.

Para crear la relacin:

1. Haz una de las siguientes opciones 1. Selecciona File>New>Other. Aparecer una ventana con un rbol. Selecciona Servoy>New

Relations. Aparecer una nueva ventana; selecciona la solucin donde crears la relacin y dale un nombre a la relacin.

2. Click en el botn New en el toolbar del Developer y selecciona Other. Aparecer una ventana con un rbol. Selecciona Servoy>New Relations. Aparecer una nueva ventana; selecciona la solucin donde crears la relacin y dale un nombre a la relacin.

3. Selecciona el nodo Relaciones en el Solution Explorer bajo la solucin deseada. Click en el botn Create relation en el toolbar del Solution Explorer.

4. Click derecho en el nodo Relations en el Solution Explorer bajo la solucin deseada. Seleccionar Create relation del menu.

TIP: Las ltimas dos opciones son las ms deseadas ya que te permitirn que Servoy Developer nombre las relaciones por ti

2. El editor de nueva relacin aparecer en medio del Workbench de Servoy. No edites el nombre en este momento.

3. Selecciona la tabla de la izquierda de la relacin hacienda click en el botn Para este ejemplo, selecciona example_data.customers.

4. Selecciona la tabla del lado derecho de la relacin hacienda click en el botn Para este ejemplo selecciona example_data.orders.

5. El nombre de la relacin se ha construido automticamente luego de seleccionar las tablas. Este nombre debe ser nico, por lo que debes verificar que el nombre sea suficiente para la relacin y no necesite ser editado. Para este ejemplo, el nombre por defecto est bien.




6. Selecciona la clave primaria de la tabla padre (izquierda) y la clave externa relacionada en la tabla hija (derecha). Parra este ejemplo, asegrate que customer_id es igual a customer_id.

NOTA: Servoy Developer normalmente propondr esta relacin si los identificadores tienen el mismo nombre y es una clave primaria para enlazar con la clave externa.

7. Configura las limitaciones para la relacin. Para este ejemplo, deja como est configurada por defecto.

8. Graba los cambios en el editor de relaciones.

Creando un Formulario

Antes de poder poner un formulario dentro de otro formulario, el formulario debe ser creado. No puedes crear nuevos formularios en el mismo editor; cada formulario abre su propio editor.

Para este ejemplo, crea un nuevo formulario basado en la tabla example_data.orders. Haz un formulario table view.

Para crear un formulario table view, usa las mismas instrucciones que vimos en Creando Formularios, con las siguientes excepciones:

Agrega los data providers con las opciones Fill text property y Place horizontal seleccionadas. Asegurate que el formulario es en Table View chequeando la propiedad view y que est seteada a

Table view (locked).

Creando un Tabpanel

Un tabpanel es un control/objeto de Servoy que puede ser ubicado en un formulario. Para este ejemplo, ubicaremos el recin creado formulario orders en el formulario de customers_dtl.

Para ubicar un tabpanel en un formulario:

1. Asegrate de tener abierto el formulario deseado en el Diseador de Formularios y tenerlo seleccionado

2. Haz una de las siguientes opciones 1. Presiona ctrl-alt-t. 2. Selecciona Elements>Place TabPanel desde el menu. 3. Haz Click enn el botn TabPanel del toolbar del Developer.

3. Aparecer una ventana para seleccionar el formulario a incluir en el tabpanel. 4. Selecciona un formulario

1. Para un formulario relacionado, selecciona el formulario a tavs de la relacin deseada. Para este ejemplo, abre el nodo para la relacin customers_to_orders y selecciona el formulario ordenes que acabas de crear.

2. Para un formulario no relacionado, elige el formulario del nodo Unrelated. 5. El tabpanel aparecer con el formulario seleccionado dentro de l. 6. Para incluir otro formulario en el tabpanel, selecciona el tabpanel en el Diseador de Formulario y

usa uno de los procedimientos indicados en el punto 2 ms arriba.




Conclusin

El formulario customers debera ahora mostrar las rdenes dentro del tabpanel. Ya que el formulario fue agregado a travs de una relacin, los datos en el formulario de rdenes son registros relacionados al cliente seleccionado. Si avanzas y retrocedes a travs de los distintos registros de clientes, los registros en el formulario de rdenes tambin se cargarn con los registros relacionados para el registro de cliente que hayas seleccionado.




I) Implementando Lgica de Negocios

Introduccin

Si bien la plataforma Servoy est basada enteramente en Java, uno no necesita escribir nada de Java durante el desarrollo o implementacin.

En su lugar, toda la lgica de negocios se implementa usando Javascript. Se eligi Javascript porque es un standard de internet, fcil de aprender como tal, el lenguaje de scripting ms usado en el mundo. Javascript es mucho ms productivo que programar en Java puro y Servoy proporciona robustas APIs con las que se puede implementer lgica de negocios rpido y fcilmente.

Nota Los programadores que estn familiarizados con Javascript pueden citar problemas con soporte de navegador y velocidad de ejecucin.

Sin embargo, vale la pena sealar que Servoy no implementa ningn Javascript. Todo el cdigo escrito en Servoy es implementado usando el proyecto Mozilla's Rhino, que es una implementacin de JavaScript basado en Java de cdigo abierto.

Esto significa que:

1. Todos los mtodos son ejecutados en Java (muchas veces ms rpido que JavaScript interpretado) 2. Ninguna lgica de negocio es jams expuesta o ejecutada en el navegador, de tal modo que se

eliminan problemas de soporte del navegador.

Los programadores experimentados pueen opcionalmente usar APIs de java de terceras partes, mezclando cdigo Java directamente en sus mtodos Servoy.

Alcance

El alcance define el dominio en el que el cdigo es ejecutado y subsecuentemente determina el namespace por los que los objetos de cdigo son referenciados. El cdigo Javascript (funciones y variables) pueden ser definidas en los siguientes dos alcances o mbitos:

Alcance Global: Encontrado en el archivo globals.js y accessible a travs del namespace globals, ej:

globals.crearNuevoCliente(); // invoca el mtodo global

Alcance del Formulario: Encontrado en el archive NombreDelFormulario.js y accesible a travs del namespace forms.NombreDelFormulario, ej:

forms.clientes.controller.newRecord(); // invoca un objeto del formulario desde otro alcance

en comparacin con:




function crearNuevoCliente(){ // un mtodo definido dentro del alcance del formulario clientes controller.newRecord(); // invoca el objeto del mismo formulario desde el alcance del formulario. Note que no se necesita especificar el namespace aqui }

Creando una Variable

Crear una Variable Global (dos formas):

Desde el rbol del Solution Explorer, navegar al nodo Active Solution > Globals > variables. Click derecho en el nodo variables y seleccionar Create Variable del pop-up menu. Elegir un nombre de variable, un tipo de dato y opcionalmente elegir un valor inicial y dar click en OK. La declaracin de la variable ser generada en el archive globals.js, que ser abierto en el Script Editor.

Desde el rbol del Solution Explorer, navegar al nodo Active Solution > Globals > variables. Iluminar elnodo variables y hacer click en el botn Create Variable del toolbar de abajo del Solution Explorer. Elegir un nombre de variable, un tipo de dato y opcionalmente elegir un valor inicial y dar click en OK. La declaracin de la variable ser generada en el archive globals.js, que ser abierto en el Script Editor.

Crear una Variable de Formulario (dos formas):

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution > Forms > miFormulario > variables. Click derecho en el nodo variables y seleccionar Create Variable del pop-up menu. Elegir un nombre de variable, un tipo de dato y opcionalmente elegir un valor inicial y dar click en OK. La declaracin de la variable ser generada en el archive miFormulario.js, que ser abierto en el Script Editor.

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution > Forms > miFormulario > variables. Iluminar el nodo variables y hacer click en el botn Create Variable del toolbar de abajo del Solution Explorer. Elegir un nombre de variable, un tipo de dato y opcionalmente elegir un valor inicial y dar click en OK. La declaracin de la variable ser generada en el archive miFormulario.js, que ser abierto en el Script Editor.

Crear un Mtodo

Crear un Mtodo Global en una de estas dos formas:

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution > Globals. Click derecho en el nodo Globals y seleccionar Create Method desde el menu pop-up. Elegir un nombre para el mtodo y dar click en OK. La declaracin del mtodo ser generada en el archivo globals.js, que ser abierto en el Script Editor.

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution > Globals. Iluminar el nodo Globals y dar click en el botn Create Method del toolbar debajo de Solution Explorer. Elegir un




nombre para el mtodo y dar click en OK. La declaracin del mtodo ser generada en el archivo globals.js, que ser abierto en el Script Editor.

Crear un Mtodo de Formulario en una de estas dos formas:

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution>Forms > miFormulario. Click derecho en el nodo miFormulario y seleccionar Create Method del menu pop-up. Elegir un nombre para el mtodo y dar click en OK. La declaracin del mtodo ser generada en el archivo miFormulario.js, que ser abierto en el Script Editor.

Desde el rbol Solution Explorer, navegar hasta el nodo Active Solution > Forms > miFormulario. Iluminar el nodo miFormulario y dar click en el botn Create Method desde el toolbar debajo de Solution Explorer. . Elegir un nombre para el mtodo y dar click en OK. La declaracin del mtodo ser generada en el archivo miFormulario.js, que ser abierto en el Script Editor.

Implementando Lgica de Negocios Bsica

Para implementar algo de lgica de negocio, crear un mtodo y completar el cuerpo de la funcin JavaScript con cdigo ejecutable.

El siguiente ejemplo implementa la funcionalidad para avanzar el ndice del registro seleccionado en un formulario:

function siguienteRegistro(){ var index = controller.getSelectedIndex(); // guarda el ndice actual controller.setSelectedIndex(index+1); // incrementa el ndice en 1 }

Este ejemplo usa el objeto controller del formulario, parte de la API de Javascript provista por Servoy.

Los programadores no necesitan memorizar la API . Las APIs de programacin son auto documentadas, y pueden insertarse fragmentos de cdigo de ejemplo fcilmente en el Editor de Cdigo.

Insertar un Fragmento de Cdigo

Cualquier API de programacin (incluidos los mtodos escritos por un programador) pueden ser insertados directamente en el Editor de Cdigo de una de estas dos formas:

Desde el rbol Solution Explorer, navegar hasta e iluminar el nodo en busca de un recurso de cdigo, (ejemplo Active Solution > Forms > miFormulario > controller). En la lista de mtodos y propiedades provista en la parte inferior del Solution Explorer, hacer click derecho sobre el mtodo o propiedad que quieras invocar y seleccionar Move Code. El cdigo sera copiado en el Editor de Cdigo y ser referenciado con el namespace correcto para el alcance actual. Puede que necesites completar argumentos especficos.




Desde el rbol Solution Explorer, navegar hasta e iluminar el nodo en busca de un recurso de cdigo. En la lista de mtodos y propiedades provista en la parte inferior del Solution Explorer, iluminar el mtodo o propiedad que quieras invocar y hacer click en el botn Move Code. El cdigo ser copiado en el Editor de Cdigo y ser referenciado con el namespace correcto para el alcance actual. Puede que necesites completar argumentos especficos.

Insertar Cdigo de Ejemplo

Cualquier cdigo de ejemplo comentado en las APIs de programacin puede ser insertado directamente en el Editor de Cdigo en una de estas dos formas:

Desde el rbol Solution Explorer , navegar hasta e iluminar el nodo del que se quiere un recurso de cdigo, (ejemplo: Active Solution > Forms > miFormulario > controller). En la lista de mtodos y propiedades provista en la parte inferior del Solution Explorer, hacer click derecho en el mtodo o propiedad que deseas invocar y seleccionar Move Sample. Un ejemplo detallado y comentado se copiara en el Editor de Cdigo.

Desde el rbol Solution Explorer , navegar hasta e iluminar el nodo del que se quiere un recurso de cdigo. En la lista de mtodos y propiedades provista en la parte inferior del Solution Explorer, iluminar el mtodo o propiedad que deseas invocar y hacer click en el botn Move Sample en el toolbar inferior del Solution Explorer. Un ejemplo detallado y comentado se copiara en el Editor de Cdigo.

Tip Cualquier API de programacin (incluyendo mtodos escritos por el programador) pueden auto-completarse usando combinaciones de teclas.

Para usar la funcin de autocompletar, comienza escribiendo el cdigo que quieras ejecutar, luego presiona ctrl+espacio en el teclado. Una lista de objetos de cdigo disponibles aparecer para que escojas de ella a medida que escribes. Esta es una forma altamente productiva y exacta de escribir cdigo cuando te has familiarizado con las APIs.

Tip Si aun no te has familiarizado con la sintaxis de Javascript, est bien. En el Solution Explorer, navegar hasta el nodo JS Lib. Este objeto contiene una lista de las APIs para manejarse con el lenguaje Javascript y tipos de datos nativos. Tambin contiene autocompletado de sintaxis para sentencias comunes en el nodo Statements.




J) Aplicando Estilos con CSS

Introduccin

Servoy soporta el uso de hojas de estilo en cascada de HTML (cascading style sheets) (CSS) para manejar el estilo de las aplicaciones. Estos archivos de texto se guardan en el proyecto de recursos. Un proyecto de recursos puede tener muchos archivos CSS, y una solucin puede usar ms de un CSS.

Los estilos en el CSS aplican al formulario y a los elementos en el formulario. A pesar que una solucin puede usar mltiples hojas de estilo en cascada, solo una hoja de estilo puede usarse a la vez en un formulario.

Los beneficios de usar CSS en Servoy incluyen:

Agrega consistencia de la interfase de usuario; todos los elementos de formulario a travs de una aplicacin pueden usar los mismos estilos.

Le da al programador la posibilidad de hacer cambios en el estilo sobre varios o todos los formularios cambiando un simple valor en la CSS.

Las hojas de estilo pueden usarse sobre mltiples aplicaciones, agregando consistencia a todas las aplicaciones de la compaa.

Agrega consistencia a una aplicacin que se desarrolla en equipo, haciendo ms fcil a los equipos de programacin usar los mismos estilos en todos los formularios.

Las hojas de estilo pueden cambiarse programticamente, permitiendo as al programador cambiar los estilos de acuerdo al gusto de cada usuario o para tener cambios de estilo peridicos en sus aplicaciones.

Creando un Estilo

Para crear un estilo en Servoy:

1. Haz una de estas opciones 1. Selecciona File>New>New Project desde el menu en Servoy Developer. Apaprecer una

ventana; selecciona el nodo Servoy y elige New Style, luego haz click en Next. 2. Selecciona el Botn Nuevo en el toolbar de arriba. Aparecer una ventana; selecciona el

nodo Servoy y elige New Style, luego haz click en Next. 3. Click derecho en un nodo Styles bajo el nodo Resources. Selecciona Create new

style desde el menu. Aparecer una ventana. 4. Con el nodo Styles seleccionado, click derecho en cualquier estilo existente y

seleccionar Create new style desde el menu. Aparecer una ventana. 5. Con el nodo Styles seleccionado, seleccionar el botn Create new style en el toolbar del

Solution Explorer. Aparecer una ventana. 2. Ingrese un nombre para el Nuevo estilo. Luego haga click en Next. 3. Seleccione para agregar contenido de ejemplo. Haga click en Finish para terminar. 4. El Nuevo archive css aparecer en el editor en el centro del Workbench.

TIP Normalmente es ms fcil trabajar con una hoja de estilo existente. La mayora de las soluciones de




ejemplo tienen un estilo asociado dentro de ellas y estos estilos son importados al importar la solucin en Servoy Developer. Tambin puedes crear un Nuevo estilo y copiar y pegar diferentes entradas de un estilo a otro.

Trabajando con un Estilo

Para abrir una hoja de estilo existente:

1. Dar click en Styles bajo el proyecto Resources en el Solution Explorer y hacer una de las siguientes opciones:

1. Seleccionar el estilo deseado (mostrado en la lista del Solution Explorer) y hacer click en el botn Open style en el toolbar de la lista del Solution Explorer.

2. Hacer doble click en el estilo deseado. 3. Click derecho en el estilo deseado y seleccionar Open style del menu.

2. El estilo se abrir en el centro del Workspace en un editor.

Estructura de una Hoja de Estilo

Una hoja de estilo para Servoy tiene definiciones de estilo bsicas y clases de definicin de estilos.

Las definiciones de estilos para Servoy son las siguientes:

form label button field check radio combobox tabpanel portal

Bajo cualquiera de estas definiciones de estilo, el programador puede crear muchas clases de definicin de estilo. Por ejemplo, la definicin de estilo label puede tener las clases de definicin de estilo label.titulo, label.chica, and label.negrita.

Cada definicin y definicin de clase puede tener una o muchas propiedades asociadas a ella. Las propiedades especificadas dentro de la definicin de estilo son heredadas (en cascada) para cualquier clase de definicin de estilo bajo ella. Miremos el siguiente ejemplo

label { color: #ffffff; border-style: solid; font: bold 10pt Verdana; }




label.mitexto { color: red; vertical-align: middle; border-width: 1px 1px 1px 1px; border-color: #111111 #111111 #111111 #111111; margin: 2px 2px 2px 2px; }

Vea que el estilo borde y letra no son modificados en la clase mitexto. Esto significa que si una etiqueta de texto se especifica queuse el estilo mitexto, ser bold, 10pt, Verdana porque eso es lo que est especificado en la definicin de estilo padre. El color puede ser rojo (no negro) porque esto fue sobreescrito por la definicin de clase mitexto.

Usando Estilos en Formularios

Para usar hojas de estilo, la hoja de estilo debe aplicarse a un formulario. Las soluciones no tienen hojas de estilo, solo los formularios. Los estilos para un elemento en un formulario dependen de la hoja de estilo aplicada al formulario.

Seteando el estilo en un formulario

Un estilo puede aplicarse a un formulario en una de estas dos formas.

Durante la creacin del formulario La opcin de especificar el estilo para un formulario est disponible en el Wizard para Nuevos Formularios como vimos antes.

En la vista de Propiedades del Formulario Cambiar la propiedad styleName por el nombre de hoja de estilo deseado.

TIP Si ests creando formularios, la hoja de estilo seleccionada para el primer formulario ser automticamente seleccionada en el Wizard de Nuevo Formulario para los formularios subsiguientes. Si no ingresas un nombre de estilo en el Wizard, pero quisieras aplicar un estilo a muchos formularios, simplemente selecciona mltiples formularios en el Solution Explorer y edita las Propiedades. Esto cambiar la propiedad en todos los formularios seleccionados.

Seteando estilos a los elementos de un formulario

Cualquier elemento en un formulario con un estilo aplicado Y una definicin de estilo ingresada para el tipo de elemento tomar el estilo de la entrada de definicin de estilo. Por ejemplo, si estoy usando el estilo test, y hay una entrada label en la hoja de estilo test, entonces CUALQUIER label ubicada en el formulario tomar el estilo label de la hoja de estilo.

Para usar algo diferente que el estilo por defecto para un elemento dado, hay que cambiar la Propiedad styleClass para ese elemento. Para hacer esto:

1. Seleccionar el elemento deseado.




2. En la vista de Propiedades, encontrar la propiedad styleClass. 3. Al hacer click en el campo, aparecer una lista de opciones con las clases de estilo disponibles para

ese elemento. Esta lista es contextual para el elemento (significa que solo versa las clases de estilo para label si el elemento es un label, clases field si el elemento es field, etc.)

4. Selecciona la clase deseada de la lista. 5. Si quieres volver atrs a la definicin de estilo por defecto, selecciona la opcin DEFAULT.




K) Implementando una Solucin en Produccin

Una vez que hayas desarrollado tu solucin y ests listo para implementar tu solucin en tus clientes, necesitas mover la solucin desde el ambiente de desarrollo al ambiente de produccin (Servidor de Aplicaciones). El primer paso para implementar es tener tu solucin en una forma en que pueda moverse: exportar la solucin.

K1) Exportando una Solucin

Para exportar una solucin desde el Servoy Developer, haz lo siguiente:

1. Haz una de las siguientes opciones 1. Ve a File>Export. Aparecer una ventana. En el rbol, seleccionar Servoy>Export Active

Solution. Dar click en el botn Next. 2. Click derecho en la solucin active en el Solution Explorer. Seleccionar Export

Solution. Aparecer una ventana. 2. Elegir un nombre y ubicacin para el archive de exportacin. Dar click en Next. 3. Hay una lista de opciones disponibles. Para una solucin simple, puedes dejar todas estas opciones

en blanco. Las opciones incluyen: 1. Proteger la Solucion con Password Requerir un password para importar la solucin; un

paso extra de seguridad para reducir que individuos no autorizados accedan a la solucin. 2. Exportar los mdulos referenciados si se marca, tambin exportar los mdulos adjuntos

a la solucin. Esto har aparecer una nueva ventana en el wizard para seleccionar que mdulos exportar.

3. Exportar todas las tablas de los servidores referenciados si se marca, exportar todas las tablas para cualquier servidor de datos usado en la solucin. Si se desmarca, solo se exportarn las tablas que actualmente se usan en la solucin.

4. Exportar datos de ejemplo de la solucin si se marca, datos (de la conexin actual) para cada tabla exportada sern incluidos. Se puede escoger un lmite especfico al nmero de filas a exportar o se puede elegir exportar todas las filas.

CUIDADO Si el juego de datos es muy grande, la exportacin de muchas filas puede fallar.

TIP Aun si has exportado datos de ejemplo, si ya hay datos en la tabla al importar, no se movern los datos de ejemplo a la tabla en el momento de la importacin.

5. Exportar datos de i18n exporta claves de i18n en la solucin (internacionalizacin) 6. Exportar usuarios exporta los usuarios de Servoy especficados en la seguridad de

usuarios y grupos 4. Hacer click en Finish para terminar (si se marc exportar mdulos referenciados, necesitars

seleccionar los mdulos a exportar, luego haz click en Finish) 5. El archivo .servoy aparecer en la ubicacin especificada.




K2) Instalando y corriendo el Servidor de Aplicaciones de Servoy

Los clientes debug son muy tiles para ver como correr la solucin durante desarrollo, para ver como corre la solucin en produccin, o para permitir que otra gente testee tu solucin, necesitas implementar tus soluciones en un servidor de aplicaciones. Esta seccin discute como instalar y correr el Servoy Application Server.

Instalando el Servidor

Si ya has instalado Servoy Developer en una mquina, el Servidor de Aplicaciones tambin ha sido instalado ya que la instalacin de Servoy Developer tambin instala el Servidor de Aplicaciones.

Corriendo el Servidor

Para correr el Servidor de Aplicaciones haz lo siguiente.

NOTA Estas instrucciones asumen que tu base de datos est corriendo.

Para Windows:

Si el Developer est corriendo, detener el Developer Hacer click en Inicio. Ir al menu de Servoy y seleccionar Servoy Server O Abrir una ventana de comando, navegar a la carpeta application_server dentro de la carpeta de

instalacin de Servoy, y correr el siguiente comando.

servoy_server.bat

Para MacOS o Linux:

Si el Developer est corriendo, detener el Developer Abrir una terminal, navegar a la carpeta application_server en la carpeta de instalacin de Servoy, y

correr el siguiente comando.

./servoy_server.sh

Una Nota sobre Database Servers

El Servidor de Aplicaciones de Servoy requiere una base de datos para poder operar. La connexion repository_server se require o el Servidor de Aplicaciones no iniciar.

En una instalacin por defecto de Servoy, la connexion repository_server ya est configurada a la base de datos provista con Servoy. Cuando Servoy Developer se inicia, esta base de datos tambin se inicia automticamente.




Para versiones de Servoy que usan PostGreSQL, la base de datos se para cuando se cierra el Developer. Para iniciar la base de datos usando una lnea de comando, navegar al directorio application_server y correr el siguiente comando

postgres_db\bin\pg_ctl start -D database -l postgres_db\postgres_log.txt

K3) Importando una Solucin en el Servidor de Aplicaciones de Servoy

Para importar una solucin, primero debemos tener un Servidor de Aplicaciones Servoy corriendo. Una vez que tengamos el servidor, podemos usar la utilidad web de Administracin del Servidor para manejar el servidor, incluyendo importar soluciones al Servidor de Aplicaciones.

Accediendo al Utilitario de Administracin del Servidor de Aplicaciones

Para acceder al Utilitario de Administracin del Servidor de Aplicaciones:

Abrir un navegador web Ingresar la siguiente URL

http://:8080/servoy-admin

reemplazando con la direccin del servidor de aplicaciones Servoy.

Importando una Solucin

Para importar una solucin en el Utilitario de Administracin:

1. Verificar que el Servidor de Aplicaciones no est iniciado como team repository: 1. Buscar el valor de servoy.application_server.startRepositoryAsTeamProvider cerca del final

de la pantalla principal del Utilitario de Administracin. 2. Si el valor dice true, cambiar el valor a false y grabar los cambios hacienda click en el botn

Save Settings. 3. Reiniciar el Servidor de Aplicaciones (hay un botn cerca de la parte superior en la pantalla

principal para esto). 2. Seleccionar el link Solutions en el menu de la izquierda. 3. Al final de la lista de soluciones, hacer click en el link Import a Solution. Aparecer la pgina de

Importar Solucin. 4. Ingresar la ubicacin del archive .servoy a importar. Si no tienes un archivo .servoy mira ms arriba

en Exportando una Solucin. 5. Para una importacin tpica, deja todas las opciones por defecto como estn. Algunas de las

opciones ms populares se explican en una nota aqu debajo. 6. Dar click en el botn Import! Una pantalla de resumen aparecer. 7. Al final de la importacin, la pantalla de resumen indicar que la importacin se ha realizado con

xito.




Para verificar que tu solucin se ha importado, haz click en el link Solutions de Nuevo para ver que aparece en la lista.

Algunas Opciones Populares de Importacin Algunas de las ms populares opciones de importacin incluyen:

Permitir palabras reservadas de SQL Esta opcin permitir que se usen palabras reservadas de SQL para nombres en la base de datos. Si se desmarca, la importacin fallar si se encuentra alguna palabra reservada sin tener en cuenta la plataforma de base de datos. Asegrese de chequear la documentacin de su DBMS por palabras reservadas.

Mostrar cambios en el modelo de datos cualquier cambio hecho a la base de datos ser mostrado en la pantalla de status mientras corre la importacin. sta puede ser una larga lista si hay muchos cambios.

Importar datos de ejemplo con la solucin si se han guardado datos de ejemplo con la solucin exportada, tratar de copiarlos en la base de datos. Si ya hay filas en la tabla de la base de datos a la cual quiere escribir, no copiar ningn dato aunque se haya indicado esta opcin.

Datos i18n Puedes escoger de importar datos de i18n guardados en tu archive de exportacin y puedes elegir solamente importar nuevas claves que no existan en la base de datos actual de i18n.

K4) Corriendo una Solucin en el Cliente

Para correr una solucin en un verdadero cliente, necesitas que la solucin se encuentre en un Servidor de Aplicaciones que est corriendo.

Ya hemos visto como iniciar el Servidor de Aplicaciones y como importar la solucin al Servidor de Aplicaciones.

Accediendo al Servidor de Aplicaciones

Al Servidor de Aplicaciones se accede a travs de un navegador web. La URL del servidor de aplicaciones debera ser

http://:8080

donde es la direccin del servidor. Si ests tratando de acceder a un Servidor de Aplicaciones que corre local, simplemente usa localhost para la direccin del servidor.

Accediendo a un Servidor a travs de un Firewall Si quieres permitir el acceso a travs de un firewall, debes permitir el trfico TCP en los puertos 8080 y 1099 para que el Servidor de Aplicaciones se conecte sin problemas.

Corriendo tu Solucin

Una solucin puede correrse desde el Servidor de Aplicaciones tanto con el Cliente Smart como con el Cliente Web.




Corriendo con Smart Client

Para correr una solucin en el Smart Client:

1. Abrir un navegador web e ingresar la URL del servidor, incluyendo el nmero de puerto. Aparecer una pgina para cargar el cliente.

2. Dar click en el cono. Comenzar la carga del cliente.

NOTA Si el Java Runtime Environment no est instalado en la computadora, puedes instalarlo hacienda click en el link al final de la pantalla de carga del cliente. Este link tambin verificar que el JRE est instalado.

3. Cuando se te pida, seleccionar la solucin que quieres abrir. 4. La solucin deseada se abrir en el Smart Client.

Corriendo con Web Client

Para correr una solucin en Web Client:

1. Abrir un navegador web e ingresar la siguiente URL:

http://:8080/servoy-webclient

donde es la direccin al Servidor de Aplicaciones.

2. Aparecer un menu con las soluciones disponibles. 3. Elije la solucin que quieres abrir. 4. La solucin se abrir en la ventana del navegador

Tutorial de in i Ciorapi Do Deserv Oy

Documents

Transcript of Tutorial de in i Ciorapi Do Deserv Oy