Prueba de WebCliente 1_4r19

Prueba de WebClient con Plex 5.5

CA Plex + WebClient

Versión 1.00

Lic. Darío Fabini

PDF created with pdfFactory trial version www.pdffactory.com

http://www.pdffactory.com

Revisiones Fecha de

modificación Versión Descripción de la modificación Autor

28.03.10 1.00 Documento inicial Lic. Darío Fabini

14.04.10 2.00 Revisión para publicación. Lic. Darío Fabini



Tabla de Contenidos 1. INTRODUCCIÓN ......................................................................................................................................................4

1.1 RESUMEN ...............................................................................................................................................................4 1.2 OBJETIVO...............................................................................................................................................................4

2. DEFINICIÓN DE LA PRUEBA ..............................................................................................................................4 2.1 AUDIENCIA ESPERADA..........................................................................................................................................5 2.2 AMBIENTE..............................................................................................................................................................5

2.2.1 Software y Hardware requerido..................................................................................................................5 2.2.2 Elaborables...................................................................................................................................................7 2.2.3 Escenario actual...........................................................................................................................................7 2.2.4 Alcance de la propuesta...............................................................................................................................7

3. DESARROLLO DE LA PRUEBA...........................................................................................................................7 3.1 INSTALACIÓN DE WEBCLIENT-LIVEINSTALL-1.4R19 .........................................................................................7 3.2 INSTALACIÓN DEL MODELO LOCAL CON EL EJEMPLO ..........................................................................................8

3.2.1 Configuración del modelo local..................................................................................................................9 3.3 ENTENDIENDO LA ESTRUCTURA DE LIVEINSTALL .............................................................................................12

3.3.1 PlexBuil.......................................................................................................................................................12 3.3.2 Server ..........................................................................................................................................................12 3.3.3 WebsydianWebClient .................................................................................................................................12 3.3.4 Wxpcourse60 ..............................................................................................................................................13 3.3.5 Wxpcourse60web........................................................................................................................................13

3.4 CONFIGURACIÓN DE WEBSYDIAN WEBCLIENT .................................................................................................13 3.4.1 Vaciar las carpetas del package ...............................................................................................................13 3.4.2 Ingresar a Websydian WebClient..............................................................................................................14 3.4.3 Configurar el proyecto PlexBuild .............................................................................................................14 3.4.4 Configurar el proyecto principal wxpcourse60 .......................................................................................16 3.4.5 Build ............................................................................................................................................................19 3.4.6 Arrancando los servidores.........................................................................................................................20 3.4.7 Run!!!!! .......................................................................................................................................................21



CA Plex + WebClient Versión 1.00 Prueba de WebClient con Plex 5.5 Fecha: 20/Abr/10

Confidencial DF, 2010 Página

4

Prueba de WebClient con Plex 5.5 1. Introducción

1.1 RESUMEN A la hora de querer probar WebClient uno se encuentra con algunas trabas producto de los distintas versiones que se fueron originando y la falta de actualización de la documentación original sucedido durante el año 2009, en este documento se resume una instalación para poder evaluar o al menos comprender un poco más de lo que se trata esta herramienta considerando que tenemos la versión de Plex 5.5. Como punto de partida se supone que ya se tienen instalado el ambiente Plex configurado para generar con Java.

1.2 OBJETIVO Utilizando los modelos de ejemplos y el paquete WebClient-LiveInstall-1.4r19.exe (353 MB) que viene prepara para armar un ambiente de prueba, generaremos el cliente web para una entidad simple.

2. Definición de la prueba Se realizará una prueba básica del producto WebClient para evaluar las características principales del mismo. Esta primer parte prentende hacer funcionar la demo del proveedor usando el material brindado en el sitio oficial de ADC Austin http://www.webclientiplus.com/


http://www.webclientiplus.com/




5

Es posible crear una cuenta con la autorización de ADC Austin Tech, se requiere acceso a Developer Content / Software Download

2.1 AUDIENCIA ESPERADA Desarrolladores con experiencia en Plex que esten usando la versión 5.5 y que tengan previamente andando el ambiente para generar clientes Java. Si nunca a generado aplicaciones usando el generador de Java, se recomienda que primero haga esto.

2.2 AMBIENTE

2.2.1 Software y Hardware requerido Componente Referencia

Software





6

Sistema Operativo

Windows XP SP3

CA Plex 5.5 AllFusion Plex 5.5 SP1

Visual Studio Microsoft Visual Studio .NET 2003

(Si bien esto no es requerido para genera Java, lo ponemos porque la PC donde estamos trabajando lo tiene instalado)

Java En la PC esta instalado jdk1.6.0_17

El LiveInstall usa el jdk5





7

pero esto no genera problemas

WebClient WebClient-LiveInstall-1.4r19.exe (353 MB)

Se usa el LiveInstall el cual se obtiene de acá: http://www.webclientiplus.com/ (se requiere cuenta para bajarlo)

Modelo ejemplo

WXPCOURSE55-Sample El modelo local con el ejemplo esta publicado en el sitio http://www.webclientiplus.com/ (se requiere cuenta para bajarlo)

Web Server Jetty Viene con LiveInstall

Hardware

PC Procesador AMD Quad-Core. RAM 3GB. Disco 500GB

Es una PC común.

2.2.2 Elaborables Al finalizar la prueba tendremos un documento con el resumen (este) Artefacto Descripción Tipo de documento

Evaluación Prueba de WebCliente 1.4r19 Word

2.2.3 Escenario actual

2.2.4 Alcance de la propuesta

3. Desarrollo de la prueba

3.1 INSTALACIÓN DE WEBCLIENT-LIVEINSTALL-1.4R19 Instalar el paquete sobre una carpeta nueva preferentemente sobre la raíz del disco para evitar la navegación por los subdirectorios. En este caso usamos como raíz D:\ WebClient19\







8

Esta instalación tienen embebido el IDE Eclipce con la Base de datos Dervy y el Web Server Jetty todo listo para usar. NOTA: Dejar la configuración por omisión y asegurarse que los port no estén siendo usado por otras aplicaciones (Tomcat puede estar usando el puerto 8080, asegurarse de que no esté corriendo) Finalizada esta instalación tendremos los dos productos principales instalados WebCliente (Eclipse) y Plex 5.5.

3.2 INSTALACIÓN DEL MODELO LOCAL CON EL EJEMPLO Usaremos el archivo WXPCOURSE55-Sample.zip que se baja del sitio, que contiene el modelo local WXPCOURSE55.MDL. Crear una carpeta raíz, en nuestro caso D:\Plex55 y copiar el .ZIP dentro de esta carpeta y descomprimirlo manteniendo la estructura original, la estructura de directorio se verá de la siguiente manera luego de generar las funciones.

NOTA: También podemos crear este modelo loca a partir del grupal que esta dentro del LiveInstall Al abrirlo encontraremos la entidad DB con las entidades que componen la aplicación, de todas estas usaremos solamente ItemMaster





9

3.2.1 Configuración del modelo local

3.2.1.1 Build Directories

Source Directory: D:\PLEX55\WXPCOURSE55-SAMPLE\GEN\SRC Para asegurarnos que genere correctamente, crear la siguiente estructura de carpetas:

Target Directory: D:\PLEX55\WXPCOURSE55-SAMPLE\GEN Local Buil Target: D:\PLEX55\WXPCOURSE55-SAMPLE\GEN





10

Presionar OK y Apply Default

3.2.1.2 Java Generation Options

Dejar tildado todo tal cual indica esta pantalla y prestar especial atención al nombre del package, WXPCOURSE60, usaremos este nombre para no cambiar tanto la configuración de los proyectos de Eclipse, dado que están preparados para funcionar con la versión 6.0 de Plex. NOTA: Si no se especifica ningún package no anda. Para el nombre del package hay que respetar mayúsculas y minúsculas, este doc esta preparado para que el nombre del package este en mayúscula Revisar las siguientes configuraciones que depende de donde tengamos instalado Plex y Visual Studio: Template file: C:\Archivos de programa\CA\AllFusion Plex r5.5\OBJAVA\default140.tpl Client properties file: C:\Archivos de programa\CA\AllFusion Plex r5.5\OBJAVA





11

3.2.1.3 System Definitions

Nmake directory: C:\ARCHIVOS DE PROGRAMA\MICROSOFT VISUAL STUDIO .NET 2003\SDK\V1.1\BIN Compiler: C:\ARCHIVOS DE PROGRAMA\JAVA\JDK1.6.0_17\BIN\JAVAC.EXE Uses Classes: C:\Archivos de programa\CA\AllFusion Plex r5.5\Class550\PatternLibs\Obptjavaimpl.jar

3.2.1.4 Gen and buil Ya terminamos con la configuración a continuación solamente generemos las funciones de la entidad DB.ItemMaster





12

Si todo esta bien, estas funciones tienen que haber quedado generada en la carpeta correspondiente al Source Directory: D:\Plex55\WXPCOURSE55-Sample\GEN\SRC, en nuestro caso. Hasta acá nada nuevo, se supone que el lector conoce Plex.

3.3 ENTENDIENDO LA ESTRUCTURA DE LIVEINSTALL Antes de seguir con la configuración del ambiente analizaremos brevemente que es el LiveInstall, este paquete contiene un IDE Eclipce con un conjunto de proyectos que permite generar el cliente web de nuestra aplicación Plex, en resumen los fuentes .java que nosotros generamos con Plex son movidos a uno de estos proyectos por medio de un script de ANT que está en el proyecto PlexBuil. Veamos la parte principal de la estructura del LiveInstall, que esta dentro del Workspace wxpcourse60:

3.3.1 PlexBuil Este es un proyecto estático que nos permite básicamente mover los fuentes Java generado por Plex a nuestro proyecto principal wxpcourse60 dentro del workspace wxpcourse60.

3.3.2 Server Irrelevante

3.3.3 WebsydianWebClient Este también es un proyecto estático usado por el proyecto principal. Aca esta todo lo que agrega WebClient a nuestros fuentes java.

Nosotros trabajaremos con este workspace. Ojo como estamos trabajando con Plex5.5 tendremos que hacer algunos cambios pero mantendremos los nombres.





13

3.3.4 Wxpcourse60 Este es el proyecto principal, que corresponde a nuestro modelo local. Acá se mueven nuestras clase desde Plex y se compilan y generan recursos para que finalmente funcionen en la web. Este proyecto tiene embebida la Base de Datos DERBY, los datos se guardan en la carpeta wcli60.

3.3.5 Wxpcourse60web Este proyecto aporta componentes para el deploy de la aplicación web, es estático no cambia una vez que se configura para un modelo.

3.4 CONFIGURACIÓN DE WEBSYDIAN WEBCLIENT Básicamente hay que configurar tres archivos que por alguna razón no están bien, pero primero vamos a borrar todo lo que viene generado, para iniciar desde cero con el entorno de WebClient:

3.4.1 Vaciar las carpetas del package Ir a la carpeta del proyecto principal D:\WebClient19\wxpcourse60\wxpcourse60 y borrar todo el contenido de las subcarpetas ….WXPCORSE60… NOTA: No la del proyecto!!!!! Ni la del workspace, las otras que corresponden al package. Entonces, las siguientes tres carpetas deben quedar vacías o borradas, el proceso de build las creará nuevamente:

..\BIN Borrar todos los archivos sueltos .resource y .panelresource

…\BIN\WXPCOURSE60 …\PlexResource\ Borrar todos los archivos sueltos .resource y

.panelresource …\src\WXPCOURSE60 Borrar todos (.java) …\WebGenTemplates\WXPCOURSE60 Borrar todos (.wcli)

WORKSPACE

PROYECTO





14

3.4.2 Ingresar a Websydian WebClient Iniciamos el ambiente del WebClient mediante el acceso que se nos instalo en el Escritorio, la vista normal nos trae un paso a paso para realizar la configuración, pero hay que ir haciendo unos pequeños cambios extra.

3.4.3 Configurar el proyecto PlexBuild (Acá seguramente el lector no estará familiarizado con esta herramienta así que haremos algunas indicaciones extras) Localizar el archivo build.properties y editarlo (doble clic) para realizar los siguientes cambios sobre BuildConfig (hay que modificar 4 líneas de este archivo):





15

En el primer bloque reemplazar esta asignación (podemos usar # para comentar la línea): plex.source.target_name=src plex.build.target_name=bin por plex.source.target_name=src/WXPCOURSE60 plex.build.target_name=bin/WXPCOURSE60 NOTA: no usar ('\'), en cambio usar ('/') en el nombre del path. NOTA: prestar atención que el nombre de la carpeta WXPCOURSE60 esta en mayúscula porque corresponde con el nombre del package que configuramos en Plex. En el segundo bloque de variables modificar las siguiente línea, para indicar muestro GEN: plex.gen.root=C:/Program Files/Websydian WebClient/wxpcourse60/GEN por plex.gen.root= D:/Plex55/WXPCOURSE55-Sample/GEN

Carpeta raíz donde generamos las funciones Plex (ojo con las ‘/’). Por último, corregimos la siguiente líneas: plex.gen.location_res=${plex.gen.root}/src/res por





16

plex.gen.location_res=${plex.gen.root}/src Estas dos líneas están indicando el directorio de Plex donde estarán los fuentes y recursos que serán movidos por el proceso ANT que arma el proyecto: plex.gen.location_src=${plex.gen.root}/src plex.gen.location_res=${plex.gen.root}/src Cerrar la solapa y guardar los cambios (clic en la cruz). El .properties debería verse de la siguiente forma.

3.4.4 Configurar el proyecto principal wxpcourse60

3.4.4.1 Renombra el archivo ob600client.properties Como nosotros estamos usando Plex 5.5 debemos renombrar ob600client.properties por ob550client.properties que en nuestro caso esta en la carpeta D:\WebClient19\wxpcourse60\wxpcourse60\src (OJO ver nota)





17

Para lo cual expandimos el proyecto hasta localizar el archivo, seleccionar y precionar botón derecho del mouse, y opción Rename (F2) NOTA: Este archivo que viene instalado en D:\WebClient19\wxpcourse60\wxpcourse60\src debemos moverlo a D:\WebClient19\wxpcourse60\wxpcourse60\bin para que sea encontrado, por algún motivo esta mal documentado.

3.4.4.2 Java Build Path Hay que configurar la posición del ObRun.jar y pvAll.jar en los dos proyectos principales wxpcourse60 y wxpcourse60web, realizando los siguiente:

3.4.4.2.1 Configurar path de wxpcourse60

1. Right-click en el proyecto wxpcourse60, ir a Properties → seleccionar Java Build Path → abrir Libraries tab → Seleccionar ObRun.jar and pvAll.jar → click en botón Remove.

2. Click Add External JARs... → localizar los archivos ObRun.jar and pvAll.jar en nuestro directorio de Plex.

En nuestro caso:

C:\Archivos de programa\CA\AllFusion Plex r5.5\ObJava\Lib

C:\Archivos de programa\CA\AllFusion Plex r5.5\CLASS550\PatternLibs\ACTIVE\Beans

3. Click Apply → Click OK.





18

3.4.4.2.2 Configurar path de wxpcourse60web

1. Right-click sobre el proyecto wxpcourse60web, ir a Properties → seleccionar J2EE Module Dependencies → desmarcar (uncheck) ObRun.jar and pvAll.jar.

2. Click Add External JARs... → localizar los archivos ObRun.jar and pvAll.jar en nuestro directorio de Plex.

En nuestro caso:

C:\Archivos de programa\CA\AllFusion Plex r5.5\ObJava\Lib

C:\Archivos de programa\CA\AllFusion Plex r5.5\CLASS550\PatternLibs\ACTIVE\Beans

3. Click Apply → Click OK.





19

3.4.5 Build Se recuerda que las funciones en Plex habían quedado generadas, por lo tanto acá hacemos el “build”, que moverá estas funciones hacia el entorno de Eclipse. En Eclipse, seleccionar Run → External Tools → PlexBuild. El modelo debería comenzar a compilarse y luego mostrar esta pantalla:





20

Si se muestra algún error de compilación es porque algo nos quedó mal configurado, esto requerirá una revisión.

3.4.6 Arrancando los servidores Ahora tenemos que arrancar el Webserver Jetty y la base de datos Dervy que ya están preinstaladas en el Eclipse.

1. Arrancar Jetty: Open the Servers tab at the bottom of Eclipse workbench, right-click on the server and choose Start. The server will publish the project. Wait until the console displays “No Transaction manager found - if your webapp requires one, please configure one” before running wxpcourse60web on server.

2. Arrancar Dervy: In the Project Explorer, right-click on the project wxpcourse60, choose Apache Derby → Start Derby Network Server.





21

Aceptar y sobre la consola debe aparecer el mensaje: El servidor está listo para aceptar conexiones en el puerto 1527. 3.4.7 Run!!!!! Abrir Internet Explorer y acceder a la url: http://localhost:8080/wxpcourse60web/webclient.

3.4.7.1 Grilla





22

3.4.7.2 Añadir En la versión original no esta el botón “Cerrar”, dado que los paneles heredan de pattern y no tienen este botón. Agregarlo es un buen ejercicio para ver como se trabaja con el ambiente.

3.4.7.3 Modificar



Documents

Prueba de WebCliente 1_4r19