Archivo Documental FUJITSU ESPAÑA SERVICES, S.A. Abril de 2005

Transcripción

1 Archivo Documental NO HAY DOS OJOS QUE VEAN EL MUNDO DE LA MISMA MANERA. NI HAY DOS NEGOCIOS IGUALES. POR ESO HAY UNA COMPAÑÍA QUE LE OFRECE SOLUCIONES DE INTERNET PERSONALIZADAS. DOCUMENTACIÓN TECNICA Edición: 02 Ref: CIT_MINS 2005 FUJITSU ESPAÑA SERVICES, S.A. Abril de 2005 Este documento es propiedad de Fujitsu España Services, S.A. y su contenido es confidencial. Este documento no puede ser reproducido, ni total ni parcialmente, ni mostrado a otros, ni utilizado para propósitos distintos de los que han originado su entrega, sin permiso previo de Fujitsu España Services, S.A. En el caso de ser entregado en virtud de un contrato, su utilización estará limitada a lo expresamente autorizado en dicho contrato. Fujitsu España Services, S.A. no podrá ser considerada responsable de eventuales errores u omisiones en la edición del documento.

2 CONTROL DE CAMBIOS EN EL DOCUMENTO CAMBIO EDICIÓN Versión inicial 1 Actualización (nueva versión ADoc) FUJITSU ESPAÑA, S.A. 27/04/2005 Página 2 de 102

3 INDICE NO HAY DOS OJOS QUE VEAN EL MUNDO DE LA MISMA MANERA. NI HAY DOS NEGOCIOS IGUALES. POR ESO HAY UNA COMPAÑÍA QUE LE OFRECE SOLUCIONES DE INTERNET PERSONALIZADAS Objeto Introducción Arquitectura y estructura de la aplicación Arquitectura conceptos básicos Flujo de datos Estructura de la aplicación WEB Módulos de la aplicación Páginas JSP Componentes Web Cómo configurar la librería fichero cwhtm.conf Campo texto y sus descendientes Lista externa Componente lista desplegable y sus descendientes Componente tabla VentanaModal Botonera Cómo se construye la página? Cabecera Paneles Paneles con pestañas Ventanas de diálogo FUJITSU ESPAÑA, S.A. 27/04/2005 Página 3 de 102

4 4.3.1 Ventanas de errores y confirmación Presentación con componentes del catalogo Presentación sin componentes Control de Acceso Propiedades de acceso La interfaz ControlBean Componente CWHTM.Control Multiidioma Ficheros de propiedades Presentación de etiquetas Otros idiomas Servlets y Web beans Idea de los Beans Bean Genérico Propiedades de configuración Control de Acceso Presentación errores CreadorObjeto Acceso a la base de datos JOMDB Introducción a OJB Idea de OJB Configuración de OJB Repositorio Objetos Java Configuración Cómo ampliar el repositorio? Uso de FLBUtils Inserción FUJITSU ESPAÑA, S.A. 27/04/2005 Página 4 de 102

5 6.3.2 Modificación Eliminación Consultas Transacciones Ejecución de las instrucciones SQL Resumen Métodos de FLBToJOMDB Mapeo de tipos JDBC Java Utilidades Codificador Macros Clase ResultadoMacro Ejemplos de macros Ejecución de macros FWUtils - librería de utilidades Paquetes de la librería Clases más utilizadas en Archivo Documental Gestión de excepciones Idea de gestión de excepciones Clases de excepciones en Archivo Documental Presentación de excepciones Descripción de javadocs Enlaces de interés Paquetes Java en Archivo Documental Glosario FUJITSU ESPAÑA, S.A. 27/04/2005 Página 5 de 102

6 1. Objeto Este documento es el recopilatorio de toda la información necesaria para poder seguir desarrollando y manteniendo el proyecto Archivo Documental tanto para la corrección de errores, desarrollo de los módulos nuevos o cambios en el funcionamiento. El resto del documento está organizado en la forma siguiente: capítulo Introducción describe la aplicación Archivo Documental, su funcionalidad y objetivos capítulo Arquitectura de la aplicación presenta la arquitectura multicapa que se ha implementado en la aplicación: capítulo Estructura de la aplicación Web describe las carpetas de la parte Web de Archivo Documental capítulo Páginas JSP describe la capa de la presentación de datos de la aplicación. Se introducen los componentes Web en las cuales se basa la interfaz de la aplicación. El capítulo presenta como se construye una página utilizando paneles y pestañas. También se describe como se controla el acceso a las secciones de la aplicación y la implementación del modo multiidioma en el Archivo Documental. capítulo Servlet y Web beans describe el puente entre la interfaz gráfica y la regla de negocio de la aplicación que está formado por los web beans y los servlets. Se explica la idea de esta capa y se presenta las soluciones generales implementadas para ella. capítulo Acceso a la base de datos JOMDB describe con detalles como se ha construido la capa de la conexión con la base de datos utilizando la tecnología OJB y la capa JOMDB implementada por Fujitsu. Se explica la arquitectura de una consulta simple y la capa de utilidades FLBUtils. capítulo Utilidades describe las utilidades que se usan en la aplicación Archivo Documental. Son el codificador de cadenas, macros y la librería de diversas herramientas útiles FWUtils. capítulo Gestión de excepciones explique como se gestionan las excepciones en la aplicación. capítulo Descripción de javadocs describe la organización de carpetas para la documentación técnica de las clases generada como los javadocs. capítulo Enlaces de interés contiene la lista de todas las páginas Web donde se puede encontrar la información detallada sobre las cuestiones mencionadas a lo largo de este documento. capítulo Paquetes Java en Archivo Documental describe como se organiza la implementación de las clases en la aplicación. Sirve no sólo para facilitar la localización de las clases sino también como un patrón para los desarrollos posteriores FUJITSU ESPAÑA, S.A. 27/04/2005 Página 6 de 102

7 capítulo Glosario contiene el listado y explicaciones de los términos más comunes utilizados en este documento FUJITSU ESPAÑA, S.A. 27/04/2005 Página 7 de 102

8 2. Introducción Archivo Documental es una aplicación que permite gestionar los documentos escaneados, organizarlas en una estructura de carpetas y asignar atributos que permiten identificar y localizarlos. Los documentos se almacenan en los servidores FTP y se presentan al usuario mediante un visor de imágenes. La aplicación cuenta también con un módulo de adquisición de documentos, que permite escanear las páginas utilizando una caja AXIS, subir las imágenes ya escaneadas desde otro servidor FTP o desde el sistema de ficheros accesible al usuario. Como una herramienta útil se ha agregado un módulo que permite diseñar los formularios HTML, que, en caso de la aplicación, se utilizan para presentar los datos de objetos documentales. La herramienta forma parte de la aplicación Web y opera en el modo drag-and-drop. Archivo Documental contiene también la sección de la administración de usuarios y sus permisos en el contexto de aplicación. La especificación funcional completa del proyecto se encuentra en los documentos _CIT_EFS_v2.doc _CIT_Mejoras2_2.doc 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 8 de 102

9 3. Arquitectura y estructura de la aplicación 3.1 Arquitectura conceptos básicos La aplicación Archivo Documental se basa en la arquitectura de tres capas: presentación de datos la interfaz gráfica y todos los elementos responsables de presentar los datos al usuario regla de negocio implementa la lógica de la aplicación capa de datos contenedor de datos con los elementos que permiten manejar la conexión con el almacén de datos La estructura de las capas y sus elementos se presentan en la siguiente imagen: Imagen 3.a Diagrama de arquitectura de Archivo Documental FUJITSU ESPAÑA, S.A. 27/04/2005 Página 9 de 102

10 Los elementos de las capas particulares son los siguientes: Capa Elemento Descripción Navegador El cliente fino la única herramienta que necesita el usuario. Presenta la interfaz gráfica de la aplicación. Se recomienda usar Mozilla o Internet Explorer a partir de versión 6. Presentación de datos JSP Servlets Componentes Páginas JSP. Como pertenecen a la capa de la presentación de datos, no deben llevar ninguna parte de la lógica de la aplicación. Se comunican con la capa de regla de negocio mediante los Web beans. Son también los beans que ejecutan cualquier calculación o comprobación necesaria para mostrar los datos de una forma u otra. Por eso es fuertemente desaconsejable poner dentro de la página cualquier código JSP distinto de la lectura de las propiedades de los beans. Los servlets. Heredan del servlet genérico HttpServlet tal y como lo indica la especificación de Sun [4]. Componentes Web que se basan en la tecnología taglibs. Fujitsu dispone de una amplia librería de los componentes Web, que se encuentran en los CWHTM.jar y CWHTM_EXT.jar. Véase el apartado Componentes Web para más información. Web beans Puesto que forman un puente de comunicación entre la capa de presentación de datos (páginas JSP) y la regla de negocio están ubicados en la imagen entre ambas capas. Por eso también, no deben llevar ninguna parte de la lógica de la aplicación FUJITSU ESPAÑA, S.A. 27/04/2005 Página 10 de 102

11 Web beans Manejadores Los manejadores son los objetos que implementan la lógica de negocio de la aplicación. En caso de Archivo Documental existen dos tipos de manejadores: Regla de negocio - Los manejadores JOMDB implementan la gestión de datos de la base de datos mediante OJB y JOMDB. Heredan de la clase FLBUtils.Manejadores.FLBToJOMDB y utilizan los beans de repositorio. - Otros manejadores que implementan otra parte de la regla de negocio. Pueden utilizar los manejadores JOMDB para gestionar los datos. Puesto que pertenecen solamente a la capa de la regla de negocio, los manejadores no deben llevar ningún código que dependiese de la presentación de datos (código HTML, llamadas al API de servlets o JSP etc.) Por lo tanto si fuera necesario cambiar la capa de presentación, lo único que habría que cambiar son los web beans (los manejadores deberían funcionar igual sin ningún cambio en el código) JOMDB OJB JDBC Estos tres elementos forman la capa de la conexión con la base de datos. - JOMDB es la librería de Fujitsu que encapsula OJB facilitando su uso Datos - OJB (Object Relational Bridge) producto de Apache que proporciona el mapeo de la base de datos relacional a los objetos persistentes de Java. Más información en [1] - JDBC forma parte de Java SDK estándar e implementa las conexiones con la base de datos desde Java Base de Datos Otros elementos Beans de repositorio Se ha comprobado con éxito la cooperación con las bases de datos Oracle y PostgreSQL. Son los objetos Java que reflejan las tablas y relaciones de la base de datos. Se construyen para facilitar las operaciones de inserción, modificación o eliminación de datos. Utilizados por los manejadores JOMDB FUJITSU ESPAÑA, S.A. 27/04/2005 Página 11 de 102

12 3.2 Flujo de datos Cada simple operación de cualquier mantenimiento como por ejemplo la inserción del usuario, pasa por todas las capas de la arquitectura de la aplicación. La correcta división del código es esencial para la creación de una aplicación robusta y de fácil ampliación. A continuación se describen cada una de las capas con su parte de la implementación correspondiente. El siguiente diagrama presenta el flujo de datos entre las capas de Archivo Documental FUJITSU ESPAÑA, S.A. 27/04/2005 Página 12 de 102

13 Imagen 3.2.a Arquitectura de una llamada la base de datos utilizando JOMDB Utilicemos el ejemplo de creación de una nueva cuenta del usuario para describir el proceso entero. El usuario de Archivo Documental con los permisos adecuados entra mediante su navegador a la aplicación. La página JSP presenta el formulario de la inserción de un usuario (capa: presentación de datos). Mediante una request HTTP la información del formulario se envía al servidor una vez el usuario pulse el botón Insertar. Allí, es donde opera el Bean (en este caso de usuarios). El Bean construye un objeto de repositorio tipo Usuario que corresponde a la tabla USUARIO en la base de datos, utilizando los datos del request y los métodos SETs del objeto. Según la operación indicada por el usuario el Bean envía el objeto al manejador llamando su método adecuado. Generando un objeto de repositorio y comunicándose con el manejador un Bean ya entra en la parte de la regla de negocio. Puesto que forma un puente entre los formularios HTML y los manejadores, se sitúa entre las dos capas. El manejador JOMDB implementa la regla de negocio. Ejecuta todos los procedimientos que la aplicación debe llevar a cabo cuando se llama a la operación particular. En nuestro ejemplo puede encriptar la contraseña, guardar en los logs la información sobre fecha y hora de la generación de la cuenta, comprobar si los datos son consistentes, etc. Una vez procesados los datos el manejador llama a la función de JOMDB / OJB que ya forma la capa de Datos. La parte JOMDB / OJB genera a partir de los datos del objeto y dependiendo del método ejecutado, la instrucción SQL adecuada (en nuestro ejemplo sería INSERT... ) y la ejecuta contra la base de datos. El registro se inserta correctamente. Nota: Puesto que el proceso pasa por todas las capas e incluye varios objetos, es imprescindible proporcionar una buena gestión de excepciones para poder localizar el problema si falla la operación. Lee la sección Gestión de Excepciones para obtener la información detallada sobre este tema en Archivo Documental. 3.3 Estructura de la aplicación WEB Este capitulo pretende explicar como se ha organizado la aplicación web y donde se ubican todos los elementos que forman parte de la aplicación. La carpeta de la aplicación ubicada en un servidor JSP contiene los siguientes catálogos: admin - contiene todas las páginas jsp que sirven para administrar la aplicación (gestión de estructura, usuarios, grupos, entidades, volúmenes): adquisición - contiene todas las páginas que permiten gestionar lotes y adquirir las páginas mediante el escáner. El directorio imagenesescaneadas sirve para guardar temporalmente las páginas escaneadas o para ejecutar una operación sobre dichas páginas. El contenido de dicho directorio se borra temporalmente. ayuda - contiene las páginas html con la ayuda de la aplicación 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 13 de 102

14 catalogo contiene las páginas que permiten gestionar el catalogo css aquí se ubican todas las hojas de estilo css de aplicación: ayuda.css la hoja de estilo para la ayuda HTML conselleria.css la hoja de estilo para la aplicación Todos los estilos nuevas que se definan deberían ubicarse en un fichero css colocado en dicho directorio. dialogos aquí se ubican las páginas jsp que corresponden a las ventanas modales de la aplicación catálogo que contiene las carpetas temporales generadas para efectuar el envío de los documentos por correo electrónico. formulariosnodos páginas JSP con los formularios de nodos creados por los usuarios de la aplicación images imágenes utilizadas en la aplicación impresión carpeta donde se encuentra el JAR con los applets de impresión y a donde se descargan las imágenes de objetos para imprimir. includes las páginas JSP que se agregan a otras mediante la directiva <jsp:include> (por ejemplo la cabecera) js contiene las librerías de JavaScript pdfs carpeta donde se almacenan los PDFs generados visualizacion - las páginas JSP y la librería Java del visor de las imágenes TIFF. WEB-INF: adquisicion contiene el fichero de la configuración de las cajas AXIS classes el repositorio de objetos (los beans de repositorio) para la conexión con la base de datos (OJB) y la configuración de dicha conexión. codificador la herramienta para encriptar y desaencriptar las URLs de las entradas externas. La carpeta contiene el fichero BAT y las clases utilizadas por la herramienta. lib contiene las librerías Java (los JARs) properties contiene todos los ficheros de propiedades (aparte de cit.conf que está en el nivel más arriba, directamente en la carpeta WEB-INF). sql contiene las plantillas para las bases de datos Oracle y PostgreSQL. Dichas plantillas se utilizan para generar los scripts SQL que reflejan los cambios en la estructura documental 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 14 de 102

15 temp una carpeta temporal. Se usa por ejemplo a la hora de generar un PDF de un objeto documental. xml_forms ficheros XML para los nodos de la aplicación xsl las hojas de estilo XSL. Aquí se encuentra el fichero que permite visualizar los XMLs de los nodos, y también otro usado para publicar un PDF. 3.4 Módulos de la aplicación La aplicación Archivo Documental se divide en dos secciones principales: la parte de Administración y la parte de Catalogación. La parte de Administración incluye gestión de usuarios, grupos, entidades y volúmenes y la generación de la estructura documental. La última funcionalidad incluye generación y modificación de nodos, diseño de los formularios y listados, asignación de macros a las operaciones principales sobre los objetos documentales y la definición de las búsquedas expertas. La parte de Catalogación contiene la adquisición de páginas mediante el escáner, y por lotes, visualización de documentos escaneados, gestión de los objetos documentales (inserción, modificación, eliminación, vinculación, etc.) y las utilidades que permiten publicar (generar PDF), imprimir o enviar por correo un objeto documental. También se ha agregado una herramienta que facilita el acceso al Archivo Documental desde las aplicaciones externas. La estructura general de los módulos lógicos de la aplicación es la siguiente: Imagen. Estructura de módulos lógicos en Archivo Documental FUJITSU ESPAÑA, S.A. 27/04/2005 Página 15 de 102

16 La implementación de cada módulo está agrupada en los JARs adecuados. La siguiente tabla presenta los nombres de las librerías con las clases de cada módulo junto con la breve descripción del contenido de cada una. Nota: En casi todos los casos los nombres de los JARs corresponden a los nombres de proyectos. Se indica el proyecto si su nombre no cumple esta regla. Módulo JARs Dependencias Descripción 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 16 de 102

17 ADOC ADMINISTRACIÓN entidades GestionUsuarios.jar CITMetaDatos.jar CITAdminEstructura.jar CITManejadoresComunes.j ar Bean y manejador de entidades CitWebGenerico.jar CWHTM.jar CWHTMEXT.jar Flogger.jar FWUtils.jar JOMDB.jar BusqExpCit.jar FLBUtils.jar ControlUsuario.jar CITMetaDatos.jar BusquedaExperta.jar Disenyador.jar Repositorio de objetos : Entidad, Vista grupos GestionUsuarios.jar CITMetaDatos.jar CITAdminEstructura.jar CITManejadoresComunes.j ar Bean y manejador de grupos y sus relaciones con permisos usuarios y entidades CitWebGenerico.jar CWHTM.jar CWHTMEXT.jar Flogger.jar FWUtils.jar JOMDB.jar BusqExpCit.jar FLBUtils.jar ControlUsuario.jar CITMetaDatos.jar BusquedaExperta.jar Repositorio de objetos: Perfil, Disenyador.jar 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 17 de 102

18 Las soluciones de distintas partes de la implementación se agrupan en los módulos físicos. Uno de ellos se basa en el software de terceros tipo open source. En estos casos, mire la bibliografía para encontrar la referencia al producto. La siguiente tabla presenta las librerías que forman parte de los módulos físicos de la aplicación. Módulo Jar Proyecto Descripción Acceso a BD CITManejadoresComunes.jar Contiene las clases de los manejadores genéricos y comunes utilizados por varias partes de la regla de negocio. CITMetaDatos.jar Repositorio de objetos que reflejan la base de datos de la aplicación (los beans del repositorio). Utilizado para la gestión de datos con OJB classes12.jar [6] Driver Java para la base de datos Oracle db-ojb-1.0.rc3.jar [1] Proyecto Apache que forma un puente entre la base de datos relacional y la aplicación Java. Forma la base para la gestión de datos en Archivo Documental FLBUtils.jar JOMDB.jar Las clases que contienen los métodos más utilizados en gestión de datos con OJB y JOMDB Capa que facilita el uso de OJB pg_driver.jar [7] Driver Java para la base de datos PostrgreSQL torque jar [8] Proyecto de Apache utilizado en Archivo Documental para la generación de los scripts SQL en la gestión de estructura. Componentes CWHTM.jar Componentes Web mire: Componentes Web CWHTMEXT.jar Componentes Web adicionales (lista externa, tipo de, vínculo) struts.jar [9] Proyecto Apache que facilita el desarrollo de las aplicaciones Web en el modelo MVC. Forma base para los componentes Web. Control Usuarios ControlUsuario.jar Contiene las clases que permiten controlar el acceso a la aplicación, comprobando la autorización del usuario 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 18 de 102

19 y sus permisos particulares. El proyecto define la estructura necesaria y una interfaz del ControlBean para implementar en los proyectos definidos. Logs FLogger.jar Una capa que facilita el uso del log4j log4j jar [10] Proyecto Apache que permite gestionar los logs dentro de una aplicación Java. Multiidioma Idioma.jar La librería general que permite gestionar varios idiomas de la interfaz. Contiene el repositorio de idiomas junto con el contenedor de etiquetas para cada uno de ellos y los métodos que permiten obtener el valor de una etiqueta para un idioma definido. La aplicación que usa el modo multiidioma debe implementar los métodos que permiten cargar las etiquetas al contexto de la aplicación. Utilidades/JAI jai_codec.jar jai_core.jar [3] Librería Java Advanced Imaging de Sun. Utilizada para procesar las imágenes escaneadas de los objetos documentales. Parte Web CitWebGenerico.jar Contiene las clases genéricas de la parte Web de la aplicación, como el web bean genérico, los beans que construyen los árboles de nodos, los servlets genéricos, y las utilidades de la aplicación upld.jar [11] JSP Smart Upload. Permite subir los ficheros desde una página JSP al servidor. Utilizado en la adquisición de páginas mediante el sistema de ficheros FUJITSU ESPAÑA, S.A. 27/04/2005 Página 19 de 102

20 Utilidades FWUtils.jar Fujitsu Framework Utilities. Una librería de utilidades que incluye utilidades para: - bases de datos - fechas - ficheros y directorios - red - seguridad - sistema - texto - aplicaciones Web GeneradorSQL.jar Conjunto de utilidades para generar los scripts SQL a partir de los parámetros. velocity jar [12] Proyecto de Apache que permite procesar los ficheros de plantillas para obtener salidas en distintos formatos. En Archivo Documental se usa para construir los scripts SQL a partir de las plantillas preparadas para distintas bases de datos. Utilidades/Apache commons-....jar [13] Librerías de Apache que proporcionan los componentes Java reutilizables para el entorno de todos los proyectos Apache. fop.jar [2] Proyecto de Apache que permite procesar los datos formateando diferentes tipos de salida (PDF, PCL, PS, SVG, XML, impresora, AWT, MIF y TXT) mediante XSL y XSL-FO. En Archivo Documental se usa para publicar los objetos documentales (convertirlos en documentos PDF). Utilidades/FTP GestorDocs.jar Proporciona la interfaz para los datos básicos del servidor FTP Utilidades/XML jdom.jar [14] El proyecto que permite manejar y procesar los datos almacenados en el formato XML desde el código Java FUJITSU ESPAÑA, S.A. 27/04/2005 Página 20 de 102

21 4. Páginas JSP 4.1 Componentes Web Los componentes web utilizados en Gestión Documental se basan en la tecnología taglibs definida en la especificación de 2.0 de JSP [5] y están implementados en el proyecto CWHTM. Al principio de cada página JSP que contiene por lo menos un componente hay que añadir las líneas siguientes: <%@ page language="java" import="cwhtm.*" %> <%@ taglib uri="/web-inf/cwhtm.tld" prefix="cwhtm" %> Todos los componentes de la librería heredan de la clase común llamada: CWHTM.ManejadoresComponentesForm esta clase define las propiedades y métodos comunes para todos los componentes. Su explicación detallada se puede encontrar en el JavaDoc del CWHTM. Lo más importante que habaría que destacar es la propiedad estado que permite indicar el estado de componente poniendo uno de los valores que se encuentra en la tabla siguiente. En práctica definición del estado influye al estilo del componente y la posibilidad de su edición. Estado DESCONOCIDO INACTIVO OPCIONAL OBLIGATORIO ERROR NO_PERMISO Descripción ningún valor se ha establecido no se usa ningún estilo para él el campo es de solo lectura el campo es opcional - no existe ninguna restricción, pero si que se usa el estilo El campo es obligatorio debería estar rellenado. Si no está rellenado al enviar el formulario con dicho componente aparecerá un error El estado indica que la lógica de aplicación ha devuelto un valor erróneo. El campo es de solo lectura y al mismo tiempo al probar modificarlo sale el mensaje que informa que el usuario no tiene permiso de edición A continuación se explica como configurar la librería y como usar los componentes más importantes. Nota: Se especifica el nombre de la página JSP en todos los ejemplos de este capítulo que se pueden ver en la aplicación WEB de prueba FUJITSU ESPAÑA, S.A. 27/04/2005 Página 21 de 102

22 4.1.1 Cómo configurar la librería fichero cwhtm.conf El fichero de propiedades que permite configurar la librería se encuentra en <HOME_APLICACIÓN>/WEB-INF/properties/cwhtm.conf. La tabla siguiente explica significado de cada propiedad. Nota: No olvide que después de hacer cambios en el fichero cit.conf es imprescindible reiniciar la aplicación WEB: Propiedad CWHTM.RUTA_ESTILO, CWHTM.ARBOL.RUTA_ESTILO, CWHTM.PANEL.BORDER, CWHTM.PANEL.BORDER.MOZILLA CWHTM.RUTA_JS, CWHTM.RUTA_JS_MASCARA, CWHTM.RUTA_JS_MENU, CWHTM.ARBOL.RUTA_MENU, CWHTM.ARBOL.RUTA_ARBOL, CWHTM.ARBOL.RUTA_NODO_CONTENEDOR, CWHTM.ARBOL.RUTA_NODO_ABSTRACTO, CWHTM.ARBOL.RUTA_MENU_ITEM, CWHTM.ARBOL.RUTA_MENU_GESTOR, CWHTM.RUTA.FUNCIONES, CWHTM.AVISO.RUTA_FUNCIONES CWHTM.RUTA_DIALOGOS, CWHTM.ARBOL.RUTA_IMAGES, CWHTM.PANEL.IMAGES CWHTM.IMAGEN_ESTANDAR CWHTM.USAR_STRUTS CWHTM.COMPROBAR_OBLIGATORIO_ONBLUR Valor Todas estas propiedades indican las rutas donde se ubican los ficheros css usados en los componentes, normalmente lo único que hay que cambiar es el nombre de la aplicación web. Por ejemplo si el nombre de la aplicación es puertos el valor del atributo CWHTM.RUTA_ESTILO debería ser igual a /puertos/css/cwhtm.css Todas estas propiedades indican las rutas donde se ubican los ficheros js usados en los componentes. Como en el caso anterior lo único que hay que cambiar es el nombre de la aplicación web. Todas estas propiedades indican los directorios donde se ubican los recursos (imágenes, ventanas auxiliares) usados en los componentes. Como en los casos anteriores lo único que hay que cambiar es el nombre de la aplicación web Indica si la aplicación web utiliza Apache Struts. La mayoría de los componentes está preparada para poder trabajar con Apache Struts. Más información sobre Apache Struts se puede encontrar en: [9] El nombre del atributo de la aplicación que determina si se debería comprobar si el campo obligatorio este rellenado cuando se ejecuta el evento onblur (perdida del foco) Campo texto y sus descendientes El componente definido en la clase CWHTM.CWCampoTexto permite incrustar dentro de la página un campo de texto configurable con las funcionalidades adicionales FUJITSU ESPAÑA, S.A. 27/04/2005 Página 22 de 102

23 Puesto que dicho componente se basa en el componente estándar disponible en HTML puro (<INPUT type= TEXT...) con lo cual hereda toda su funcionalidad básica. Dicha sección se centrará en dos aspectos: explicación de las funcionalidades adicionales propios para el componente CWCampoTexto descripción de los componentes derivados del componente CWHTM.CWCampoTexto Cómo definir el formato del campo texto? La funcionalidad nueva más importante del componente campo texto es la posibilidad de definir el patrón de los datos aceptados por el componente. Los atributos que influyen al formato aceptable están definidos en la tabla siguiente. mascara Atributo Descripción Define el formato de la mascara - la serie formada por los siguientes caracteres: 'n' - para referenciar números 'c' - para referenciar caracteres 'M' para referenciar Mayúsculas 'm' para referenciar minúsculas '-' para referenciar un carácter - '/' - para referenciar un separador de fecha, ':' - para referenciar un separador de hora '.' - para referenciar un punto decimal ',' - para referenciar una coma ' ' - para referenciar un espacio Por ejemplo para conseguir el formato de la fecha se puede poner: nn/nn/nnnn longitudminima maxcaracteres Define el mínimo número de caracteres que tiene que introducir el usuario en este campo. Define el número máximo de caracteres. En este caso se usa el evento onkeyup para averiguar si el usuario no sale fuera del número de caracteres permitido. Se usa para omitir el atributo maxlength del tag INPUT, porque Mozilla corta los valores de entrada. Se puede juntar con maxlength, por ejemplo, para permitir la presentación de una cadena larga, pero permitir solamente la entrada de X caracteres en caso de cambio o inserción. Hay que recordar que cuando maxlength < maxcaracteres, la comprobación de maxcaracteres nunca se realizará FUJITSU ESPAÑA, S.A. 27/04/2005 Página 23 de 102

24 El ejemplo siguiente muestra varios componentes tipo campo texto definidos (todos ellos se resaltan con negrita). Es importante destacar que no es necesario añadir a la página HTML ni la referencia al código javascript ni la definición de los eventos. Todo esto incluye automáticamente servidor de JSP al interpretar la etiqueta CWHTM: CampoTexto: <%@ page language="java" import="cwhtm.*" %> <%@ taglib uri="/web-inf/cwhtm.tld" prefix="cwhtm" %> <%@ taglib uri="/web-inf/struts-html.tld" prefix="html" %> <html> <head> </head> <body bgcolor="white"> <ul> <li>el primer campo es solo lectura<br></li> <li>el segundo es obligatorio<br></li> <li>el tercero tiene el formato de la fecha y es opcional<br></li> <li>el cuarto es númerico y es obligatorio</li> <li>al quinto hay introducir por lo menos 3 caracteres y tiene el estado ERROR</li> </ul> <CWHTM:Formulario action="" name="form1" id="form1"> <table> <tr><td> 1.Código asignado: </td> <td><cwhtm:campotexto estado="inactivo" value="65345" name="codigo"/></td> </tr> <tr><td> 2.Nombre: </td> <td><cwhtm:campotexto estado="obligatorio" name="nombre"/></td> <td> 3.Fecha de nacimiento: <CWHTM:CampoTexto estado="obligatorio" mascara="nn/nn/nnnn" name="fecha"/> </b></td> </tr> <tr><td> 4.Sueldo:</td> <td><cwhtm:campotextonumerico estado="obligatorio" name="sueldo" /></br> </td> </tr> <tr><td> 5. Apodo: </td> <td><cwhtm:campotexto estado="error" longitudminima="3" name="apodo" mascara="mnc-m.mm"/></br> <CWHTM:BotonSubmit value="enviar"/> </td> </tr> </table> </CWHTM:Formulario> </body> </html> Ejemplo disponible en la página campomascara.jsp Al enviar los datos al servidor (en esto caso pulsando al componente BotonSubmit) se comprueba si todos los componentes tipo campo texto están rellenadas con los valores aceptables (tal como se definió en los atributos correspondientes). Si por lo menos un campo contuviera datos incorrectos el formulario no se enviaría. Descendientes del campo texto El componente campo texto es bastante genérico. Basándose en él se crearon otros componentes más específicos. Sus descripciones se encuentran en la tabla siguiente: 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 24 de 102

25 Nombre del componente Clase principal Descripción CWHTM:CampoPassword CWCampoPassword El campo texto que sirve para introducir datos confidenciales (por ejemplo contraseñas) CWHTM: CampoTextoNumerico CWHTM: CampoFechaCalendario CWCampoTextoNumerico CWCampoFechaCalendario El campo texto que sirve solamente para introducir datos numéricos El campo texto que contiene un botón que al pulsar muestra una ventana modal con el calendario. Usando este calendario se puede elegir la fecha con la cual se rellenará el campo texto CWHTM:ListaExterna CWListaExterna El campo texto que contiene un botón que al pulsar ejecuta una consulta SQL pasada como un atributo del componente. Los resultados de dicha consulta se mostrarán en la forma de la ventana modal. Al pulsar a esta ventana se puede rellenar el componente con el valor de la fila seleccionada del componente. Vea también la sección siguiente El ejemplo siguiente muestra todos los componentes en una página JSP. <%@ page language="java" import="cwhtm.*" %> <%@ taglib uri="/web-inf/cwhtm.tld" prefix="cwhtm" %> <%@ taglib uri="/web-inf/struts-html.tld" prefix="html" %> <html> <head> </head> <body bgcolor="white"> <CWHTM:Formulario action="" name="form1" id="form1"> <table> <tr><td> 1.Contraseña: </td> <td> <CWHTM:CampoPassword name="contrasenya" value="" longitudminima="5" mascara="cccccccccccccccccccc"/> </td></tr> <tr><td> 2.Solo número:</td> <td><cwhtm:campotextonumerico name="contrasenya" value=""/></td> 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 25 de 102

26 </tr> <tr><td> 3.Calendario: </td> <td><cwhtm:campofechacalendario name="calendario" value=""/></td> </tr> <tr><td> 4.ListaExterna: </td> <td> <CWHTM:ListaExterna name="calendario" tabla="pais" campopk="pk" campoconsulta="nombre" alturaventana="500" VENTANA_VINCULO="dialogos/externos/listamodal.jsp" rutaimagenborrar="images/botones/60.gif" value=""/> </td> </tr> </table> <CWHTM:BotonSubmit value="enviar"/> </CWHTM:Formulario> </body> </html> Ejemplo disponible en la página campohijos.jsp El uso de tres primeros componentes no debería provocar problemas. El uso de la lista externa, debido a su complejidad merece más explicaciones. Por eso se dedica a este problema toda la sección siguiente. Imagen a La página con el ejemplo ejecutando. Se muestra también la ventana de dialogo con el calendario Lista externa Aunque la lista externa indirectamente hereda del componente campo texto, debido a su complejidad, merece una sección separada. La idea más importante del componente es enriquecer el campo texto con el botón que permite hacer consulta SELECT en la tabla especificada en los parametros del componente. El desarrollador no tiene que especificar la consulta a mano. Lo único que hay que introducir aparte del nombre de la tabla, es el nombre de la columna que es la clave pública, y el nombre de la columna cuyos datos servirán para rellenar el campo texto asociado. Analizando el ejemplo anterior uno puede darse cuenta que no se especifica en ningún sitio las propiedades de la conexión con la base de datos. Estas propiedades se leen del repositorio OJB definido (vea el capitulo 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 26 de 102

27 Acceso a la base de datos JOMDB para obtener más informaciones sobre la conexión con la base de datos) Aparte de los atributos derivados de sus ancestores, dicho componente introduce los atributos propios cuya descripción se puede encontrar en la tabla siguiente: Atributo alturaventana anchuraventana campoconsulta campopk esquema modificarmanualmente rutaimagenborrar VENTANA_VINCULO tabla Descripción La anchura de la ventana modal que aparece al pulsar el botón "detalles" La altura de la ventana modal que aparece al pulsar el botón "detalles" El nombre de la columna de la base de datos cuyos datos sirven para rellenar el campo texto del componente El nombre de la columna de la base de datos que denomina la clave publica de la tabla usada en el componente El nombre del alias de OJB Indica si el valor de campo texto se puede modificar manualmente (sin necesidad de abrir la ventana modal con la lista de registros) La ruta y el nombre de la imagen que sirve como el botón vaciar campo La ruta y el nombre de la página JSP que corresponde al contenido de la ventana modal El nombre de la tabla de la cual se muestra datos en la ventana modal 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 27 de 102

28 Imagen a La página con el ejemplo anterior ejecutado. En este caso se muestra la ventana del dialogo del componente lista externa Componente lista desplegable y sus descendientes El componente lista desplegable se basa en el elemento <select> del HTML estándar. Hay tres tipos de este componente que difieren en la fuente de datos. En su forma más fácil implementada con la etiqueta CWHTM: CWListSimple los datos se leen de una colección de cadenas pasada en el atributo collection. En este caso la colección es una interfaz definida en java.util.collection. En el ejemplo siguiente aparte del componente se muestra también la definición de una colección de prueba. En el uso real dicha colección debería provenir de un web bean que a su vez debería obtenerla de su manejador. Recuerde que la colocación del código java dentro de una página JSP es fuertemente desaconsejable (excepto las llamadas a los métodos del web-bean asociado) <% Vector v=new Vector(); v.add("sara"); v.add("maria"); v.add("teresa"); %> <CWHTM:CWListSimple name="listasimple" collection="<%=v %>"/> Todos los ejemplos mencionados en esta sección están disponibles en la página lista.jsp El segundo ejemplo como la fuente de datos coge la colección de objetos. En este caso hay que especificar la clase de los objetos que forman parte de la colección (atributo classobjetojomdb) Adicionalmente, es imprescindible indicar la propiedad cuyos valores aparecerán en la lista desplegable como etiquetas (atributo nombrecampovisualizar) y la propiedad cuyos valores se envía al servidor (atributo: nombrecampopk) FUJITSU ESPAÑA, S.A. 27/04/2005 Página 28 de 102

29 <% Vector coleccion=new Vector(); Usuario u1=new Usuario(); u1.setid(1); u1.setapellidos("ramirez Sanchez"); u1.setnombre("inmaculada Concepción"); u1.setlogin("inmarasa"); u1.setactivo(true); coleccion.add(u1); %> <CWHTM:CWList name="listanormal" collection="<%=coleccion %>" nombrecampopk="id" nombrecampovisualizar="login" classobjetojomdb="cit.admin.repositorio.usuario"/> En el tercer ejemplo como la fuente de datos se usa la base de datos. La conexión con la base de datos se realiza mediante la librería JOMDB que a su vez utiliza el proyecto OJB de apache [1]. La descripción detallada del uso de JOMDB se encuentra en el capitulo Acceso a la base de datos JOMDB. En el caso de trabajar con JOMDB no es necesario especificar la colección. La capa de OJB por su cuenta ejecuta la consulta select y convierte el resultado en la colección de objetos. <CWHTM:CWListBD name="listanormal" nombrecampopk="id" nombrecampovisualizar="login" classobjetojomdb="cit.admin.repositorio.usuario" esquema=""/> El atributo esquema especifica el alias OJB que se utiliza para conectarse con la base de datos. Si esquema es vacío (como en este ejemplo) se usa el alias por defecto. El último ejemplo visualizaba los logins del usuario de toda la tabla. Muchas veces interesa restringir un poco el conjunto de datos. En JOMDB se usa los criterios que corresponden a la cláusula WHERE de SQL. El ejemplo siguiente muestra como utilizar los criterios con el componente lista. En este caso la consulta debería obtener el login y la pk de todos los usuarios cuyos login contiene la frase ario <% CriteriosSQL criterio=new CriteriosSQL(); criterio.anyadirlike("login","%ario%"); %> <CWHTM:CWListBD name="listanormal" nombrecampopk="id" nombrecampovisualizar="login" classobjetojomdb="cit.admin.repositorio.usuario" esquema="" criteriossql="<%=criterio %>" /> Componente tabla El componente tabla es el más complejo de todos los componentes definidos en la librería. Dicho componente sirve para visualizar e editar los datos en la forma de la tabla (grid). El componente puede trabajar en tres modos (consulta SQL pasada de la forma explicita, acceso a la base de datos mediante JOMDB, trabajo con colecciones). El aspecto y funcionalidad del componente cambia drásticamente según los valores que toman los atributos de la etiqueta. Por todas estas razones se ha decidido dividir la descripción del componente en los apartados que explican como obtener la funcionalidad particular FUJITSU ESPAÑA, S.A. 27/04/2005 Página 29 de 102

30 Cuestiones básicas Imagen a Uno de los aspectos que puede tener la tabla El componente tabla tiene que colocarse dentro del componente Formulario. Los atributos id y nombre del formulario deberían ser iguales al atributo nombreformulario de la tabla. Adicionalmente a la página que contiene la tabla hay que añadir la referencia al fichero js que contiene las funciones javascript que usa el componente tabla: <script language="javascript1.2" src="js/grid.js"></script> Acceso a la base de datos externa mediante consulta SQL En este modo la consulta SQL con el comando SELECT se pasa mediante el atributo consultaselect. Adicionalmente, es imprescindible anidar la etiqueta CWHTM:ConnectionDB para definir las propiedades de conexión JDBC con la base de datos externa. En este modo no es posible modificar los datos visualizados. El ejemplo siguiente muestra la página HTML con un grid de dos columnas. En este primer ejemplo se muestra la página HTML entera (el código del componente se marca con negrita). En otros ejemplos se mostrará solamente la parte que corresponde al componente FUJITSU ESPAÑA, S.A. 27/04/2005 Página 30 de 102

31 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> page language="java" import="cwhtm.*" %> taglib uri="/web-inf/cwhtm.tld" prefix="cwhtm" %> <html><body> <script language="javascript1.2" src="js/grid.js"></script> <CWHTM:Formulario name="formnodo" id="formnodo" action="" > <CWHTM:TablaJSP consultaselect="select usu_nombre,usu_apellidos FROM USUARIO" coleccionconclase="false" columnasenselect="true" nombreformulario="formnodo" rutajsp="/tablasql.jsp" maxfilasporpagina="10" rutaimagenes="/images/grid/" dibujartabla="true" montarform="false"> <CWHTM:ConnectionDB </CWHTM:TablaJSP> </CWHTM:Formulario> </body> </html> user="ctr password="ctr" url="jdbc:postgresql:// :5432/adoc" driver="org.postgresql.driver"/> Ejemplo disponible en la página tablasql.jsp La descripción detallada de cada atributo usado en el ejemplo se encuentra en Javadocs del proyecto CWHTM. Para que sea posible usar este modo es imprescindible poner el valor del atributo ColeccionConClase a false y el valor del atributo ColumnasEnSelect a true. El resto de los atributos usados en el ejemplo tiene el siguiente significado: nombreformulario el nombre del formulario HTML en el cual se ubica la tabla. El nombre del formulario se utiliza para montar el javascript de la tabla y generar los atributos únicos de la sesión rutajsp La ruta relativa de la página en la cual se ubica la tabla. rutaimagenes la ruta relativa de las imágenes que utiliza la tabla dibujartabla Si el valor del atributo es true la tabla debería dibujarse en la página (comportamiento normal). En el otro caso la tabla se guarda en la sesión montarform Indica si la tabla al dibujarse debería incluir el formulario (valor true). En este caso no sería necesario anidar la tabla dentro de componente formulario. Si el formulario que contiene la tabla tuviera también otros componentes (por ejemplo un campo del texto, una lista desplegable) se recomendaría poner este atributo a false y añadir la etiqueta del formulario manualmente maxfilasporpagina El número máximo de las filas que se debería mostrar a la vez. Si el número entero de las filas supera el valor de este parámetro se dividirá todas las filas en páginas separadas (paginación) 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 31 de 102

32 Acceso a la base de datos mediante JOMDB El acceso a la base de datos más frecuente es mediante JOMDB. JOMDB es el API creado por Fujitsu para facilitar el uso de OJB [1]. La idea de trabajar con OJB consiste en mapear cada tabla de la base de datos con una clase cuyas propiedades, accesibles mediante los métodos get y set, corresponden a las columnas de la tabla. Para más informaciones acerca de OJB consulte el capitulo Acceso a la base de datos JOMDB y la documentación de Apache[1]. El ejemplo siguiente permite obtener el grid con los datos del usuario. La clase CIT.admin.repositorio.Usuario es la clase del repositorio que corresponde a la tabla de la base de datos. Su nombre se pasa en el atributo classobjetojomdb. Se han definido 5 columnas (para cada una hay un tag anidado llamado Columna). Los atributos que no han aparecieron en el ejemplo anterior se marcan con negrita <CWHTM:TablaJSP nombreformulario="formnodo" rutajsp="/tablajomdb1.jsp" classobjetojomdb="cit.admin.repositorio.usuario" maxfilasporpagina="10" rutaimagenes="/images/grid/" dibujartabla="true" montarform="false" > <CWHTM:Columna nombrecolumnabd="id" width="0" componente="hidden" eseditable="false" tipocolumna="long" /> <CWHTM:Columna nombrecolumnabd="apellidos" width="230" componente="label" eseditable="false" tipocolumna="varchar" titulo="apellido" /> <CWHTM:Columna nombrecolumnabd="nombre" width="130" componente="label" eseditable="false" tipocolumna="varchar" titulo="nombre" /> <CWHTM:Columna nombrecolumnabd="login" width="100" componente="label" eseditable="false" tipocolumna="varchar" titulo="usuaruario" /> <CWHTM:Columna nombrecolumnabd="activo" width="60" componente="checkbox" eseditable="false" tipocolumna="boolean" titulo="activo" /> </CWHTM:TablaJSP> Ejemplo disponible en la página tablajomdb1.jsp Para cada columna hay que especificar: nombrecolumnabd el nombre de la columna en la base de datos asignada a esta columna del componente tabla eseditable - indica si el usuario puede cambiar el valor de las celdas en esta columna titulo especifica el título que aparecerá en la cabecera width define la anchura de la columna. La anchura de la tabla es la suma de las anchuras de todas las columnas tipocolumna el tipo de la columna tal como se definió en la base de datos (CHAR, VARCHAR, INTEGER, NUMERIC, DECIMAL, BOOLEAN, LONG, FLOAT, DOUBLE, DATE, TIME, DATETIME) FUJITSU ESPAÑA, S.A. 27/04/2005 Página 32 de 102

33 componente el tipo de componente dentro de cada celda de la columna. Los valores disponibles con la descripción se encuentran en la tabla siguiente: Nombre del componente HIDDEN LABEL TEXT TEXTAREA SELECT IMAGEN HTML CHECKBOX ANIDADO Valor no coloca contenido visible para el usuario, sino el campo oculto que guarda el valor muestra el contenido de la comuna en el modo texto Muestra dentro de cada celda la lista desplegable. Si la columna tiene este tipo se asume que dentro se anida el componente CWCampoTexto Muestra dentro de cada celda el área de texto Muestra dentro de cada celda la lista desplegable. Si la columna tiene este tipo se asume que dentro se anida el componente CWList Muestra dentro de la celda la imagen. Si la columna tiene este tipo se asume que dentro se anida el componente CWImagenTabla Permite anidar dentro de la columna el código HTML Muestra dentro de cada celda el checkbox Indica que dentro de la columna está anidado el componente que hereda de la clase ManejadoresComponentesForm la clase principal de la jerarquía El concepto de los componentes anidados se presentará más adelante. Adicionalmente, habría que resaltar que al componente tabla trabajando en este modo se puede pasar el criterio OJB usando el atributo criteriossql (homologo de la cláusula WHERE en la consulta SELECT). Para saber más sobre los criterios consulte la sección Consultas con criterios. En los casos muy especiales es posible ejecutar una query SQL mediante JOMDB (omitiendo la capa del mapeo). El componente tabla aprovecha esta funcionalidad de la librería JOMDB que muestra el ejemplo siguiente <CWHTM:TablaJSP nombreformulario="formnodo" coleccionconclase="false" rutajsp="/tablacolht.jsp" consultaselect="select usu_nombre,usu_apellidos FROM USUARIO WHERE usu_nombre like '%usu%'" classobjetojomdb="cit.admin.repositorio.usuario" maxfilasporpagina="10" rutaimagenes="/images/grid/" dibujartabla="true" montarform="false" 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 33 de 102

34 > <CWHTM:Columna nombrecolumnabd="usu_nombre" width="200" componente="label" eseditable="false" tipocolumna="long" titulo="nombre" /> <CWHTM:Columna nombrecolumnabd="usu_apellidos" width="230" componente="label" eseditable="false" tipocolumna="varchar" titulo="apellido" /> </CWHTM:TablaJSP> Ejemplo disponible en la página tablacolht.jsp Trabajo con la colección de objetos Aparte del contenido de la base de datos, el componente tabla puede utilizar la colección de objetos como la fuente de datos. En este contexto la colección es la clase java que implementa la interfaz java.util.collection disponible en el SDK estándar. El SDK proporciona las implementaciones de este interfaz. El más conocido y usado es java.util.vector. El uso de la colección de objetos es muy útil no solamente cuando datos visualizados no provienen de la base de datos, sino también cuando provienen de la base de datos pero antes de mostrarlos es imprescindible efectuar alguna operación especial. Por ejemplo el uso de una colección sería útil, si la visualización de cada fila dependiese de los permisos que tuviese el usuario y dichos permisos se encontrasen en un fichero de propiedades. El ejemplo siguiente muestra la tabla con una colección que utiliza los objetos JOMDB. Las diferencias en la definición de los atributos están resaltadas con negrita. Aparte del componente se muestra también la definición de una colección de prueba. En el uso real dicha colección debería provenir de un bean que a su vez debería obtenerla de su manejador. Recuerde que la colocación del código java dentro de una página JSP es fuertemente desaconsejable (excepto las llamadas a los métodos del web-bean asociado). <% Vector coleccion=new Vector(); Usuario u1=new Usuario(); u1.setid(1); u1.setapellidos("ramirez Sanchez"); u1.setnombre("inmaculada Concepción"); u1.setlogin("inmarasa"); u1.setactivo(true); coleccion.add(u1); %> <CWHTM:TablaJSP nombreformulario="formnodo" collection="<%=coleccion %>" rutajsp="/tablajomdbcol.jsp" classobjetojomdb="cit.admin.repositorio.usuario" maxfilasporpagina="10" rutaimagenes="/images/grid/" dibujartabla="true" montarform="false" > <CWHTM:Columna nombrecolumnabd="id" width="0" componente="hidden" eseditable="false" tipocolumna="long" /> <CWHTM:Columna nombrecolumnabd="apellidos" width="230" componente="label" eseditable="false" tipocolumna="varchar" titulo="apellido" /> <CWHTM:Columna nombrecolumnabd="nombre" width="130" componente="label" eseditable="false" tipocolumna="varchar" titulo="nombre" /> <CWHTM:Columna nombrecolumnabd="login" width="100" componente="label" eseditable="false" tipocolumna="varchar" titulo="usuaruario" /> <CWHTM:Columna nombrecolumnabd="activo" width="60" componente="checkbox" 2005 FUJITSU ESPAÑA, S.A. 27/04/2005 Página 34 de 102