Madrid, XX de XXXXX de 2006
Contents
1. Scroll horizontal Total 14 Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 9 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 5 3 Lista paginada extendida con paginaci n o con scroll vertical Si se quiere que la lista p ginada extendida tenga un paginador como la lista paginada se tendr que incluir el siguiente c digo listaPaginadaExtendidaSample xhtml lt atlasc listaPaginadaExtended id clienteTable pageProvider clienteBean obtener pageCountProvider clienteBean obtenerTotal width 966px height 260px orderAndFilterProvider clienteBean getOrderAndFilter sortAscending fclienteBean orderAndFilter ordenarAscendente sortColumn fclienteBean orderAndFilLter columnaOrdenj filter clLienteBean orderAndFilter filtro export true frozenColumns 2 selectionMode multipLe gt lt atlas columnaListaPaginada id columnaClienteldClLiente Si se quiere que la lista p ginada extendida no tenga paginador pero tenga scroll vertical se deber establecer la propiedad clientrows que indica el n mero de filas que se cargan de golpe Esa opci n se debe usar teniendo en cuenta que el n mero de filas a cargar no deber a ser mayor de 20 30 como m ximo ya que puede repercutir negativamente en el rendimiento de la aplicaci n listaPaginadaExtendidaSample xhtml lt atlasc listaPaginadaExtended id clienteTable pageProvi2. Respuesta En la aplicaci n de demostraci n de los componentes del Framework Atlas Pregunta C mo se ha implementado el componente en su capa de presentaci n Respuesta Se ha utilizado la tecnolog a Composite de JSF Facelets JavaScript y CSS Pregunta Se puede usar una columna personalizada con este componente Por ejemplo se puede introducir una columna con iconos o botones Respuesta Si se puede utilizando el atributo define de facelets El componente columnaListaPaginada permite personalizar el contenido que se muestre Por defecto se muestra un outputText pero se puede utilizar cualquier otro componente como por ejemplo un commandLink En la secci n 5 2 hay un ejemplo de este caso Pregunta C mo puedo modificar los estilos del componente Respuesta Mediante los atributos de estilo del componente Para m s informaci n consultar la tabla de atributos en la secci n de Uso del componente 7 ENLACES RELACIONADOS Producto Versi n RichFaces 3 4 3 1 i i 4 3 1 Final JSF http docs oracle com javaee 6 javaserverfaces 2 1 docs vdldocs facelets index html JavaScript https developer mozilla org es docs Web JavaScript CSS http www w3schools com css default asp MyFaces http myfaces apache org core21 index html Core Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 15 Fecha 02 12 2013
3. para multi selecci n Strin Estilo de la lista paginada Este campo es Y 8 opcional y por defecto vale tablaPijama M todo de backingbean para obtener los pageProvider String E elementos de la p gina M todo de backingbean para obtener el total de pageCountProvider String los elementos de la p gina selectionMode M todo de backingbean para obtener el bean de orderAndFilterProvider String 5 P filtrado de los elementos de la lista Boolean para indicar si se ordena de forma boolean ascendente por defecto Atributo del ordenandFilterBean para guardar el String pp nombre de columna de ordenaci n String Estilo del paginador de la tabla Anchura de la paginaci n del componente Por sortAscending sortColumn cai En el caso de que se utilice un filtrado para la query de la lista paginada especifica el atributo donde se va a establecer el valor que representa el filtro widthNavigator String defecto tiene el valor del campo width leftNavigator No String Distancia al margen izquierdo de la secci n de Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 Fecha 02 12 2013 N DIRECCI N DE INGENIERIA paginaci n del componente Campo opcional y valor por defecto Opx scrollerPanelColumns No String N mero columnas del datascroller paginatorMaxPages Not Atributo maxPages del dataScroller de Rich
4. 4 Arroyo Culebro 248 Madrid 6665556665 23 11 2014 E Casado apellido3 622330277 24 09 2014 X Casado ipellido6 622330270 24 09 2014 E Casado ipellido9 622330272 24 09 2014 E Casado apellido7 622330277 24 09 2014 x Casado Calle n 4 Arroyo Culebro 248 Madrid 95865211125 24 09 2014 X Casado apellido4 622330276 24 09 2014 4 b 1 2 O Total 14 3 DIFERENCIAS RESPECTO AL COMPONENTE atlas listaPaginada El componente Lista Paginada Extendida tiene las siguientes diferencias respecto al componente listaPaginada No tiene la opci n de cambiar en caliente el n mero de filas de la tabla esto debido a que este componente cuando tiene scroll vertical se define un n mero de filas que se cargan por ajax y entra en conflicto con la carga en caliente La lista paginada Extendida no se ajusta al ancho de la pantalla como hace la lista paginada debido a tiene scroll horizontal y hay que darle un tama o espec fico tanto al total de la tabla como a cada una de las columnas Si a las columnas no se les pone tama o tendr n por defecto un tama o de 100 pixeles cada una La lista paginada Extendida no se ajusta su alto dependiendo del n mero de filas como si hace el componente lista paginada Con lo que habr indicar un tama o especifico para el alto de la lista paginada extendida El namespace es diferente uno usa facelets atlas listaPaginada y el otro usa composite atlasc listaPaginadaExtended Framework ATLAS Manual MANUAL DE USUARIO COM
5. 8 5 1 PASO 1 DEFINICI N DEL ESPACIO DE NOMBRES DE ETIQUETAS DE ATLAS 8 3 2 PASO 2 INSERCI N EN LA P GINA DE LA ETIQUETA DE 5 5 8 5 3 LISTA PAGINADA EXTENDIDA CON PAGINACI N O CON SCROLL 10 5 4 ATRIBUTOS DE LA LISTA PAGINADA EXTENDIDA 0oooocncononcnnononnononoonononno nooo nono nono non no non no na nnnnonnono nano nanncnannos 11 5 5 NUEVOS ATRIBUTOS DE LA COLUMNA EN LA LISTA PAGINADA 13 5 6 14 EIEMPLODE USU 14 6 PREGUNTAS M S 15 7 ENLACES RELACIONADOS din iiiaia 15 Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 1 INTRODUCCI N Este documento contiene el manual de uso del componente Lista Paginada Extendida del framework Atlas En l se incluye informaci n sobre c mo utilizar dicho compo
6. FRAMEWORK ATLAS MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 UNIDAD DE ARQUITECTURA DE SOFTWARE DE APLICACIONES encia de XXX Inform tica y Comunicaciones de la Comunidad de Madrid DIRECCI N DE INGENIERIA Hoja de Control T tulo Manual de usuario Componente Lista Paginada Extendida Responsable Unidad de Arquitectura Software de Aplicaciones Gai reca vesiin a A Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha Versi n inicial del documento Arquitectura de Software 02 12 2014 Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 Fecha 02 12 2013 DIRECCI N DE INGENIERIA ndice 1 3 1 1 AUDIENCIA OBJETIVO usa a 3 1 2 CONOCIMIENTOS PRETO Sutil si n 3 TO LO O 4 3 DIFERENCIAS RESPECTO AL COMPONENTE ATLAS LISTAPAGINADA 9 0 6 4 INSTALACI N Y 7 41 INSTALACI N ee 7 4 1 1 CONFIGURACI N 7 S5 DU cias
7. IO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 Fecha 02 12 2013 DIRECCI N DE INGENIERIA e Scroll Vertical mediante el atributo clientRows se establece el n mero de filas que se cargan mediante ajax cada vez que se baje el scroll solicitando m s filas si el n mero es m s grande que el total de filas entonces se trae todas las filas en una sola llamada cuando se dan estas condiciones no existen los botones de paginaci n puesto que el scroll hace que se traiga todos los registros sin paginar Id Cliente Estado Civil Telefono Fc Nacimiento Eliminar Editar 10708 Divorciado 622330271522 24 09 2014 E s 10709 Casado 622330277 24 09 2014 X 10710 Casado 622330276 24 09 2014 6 Casado 4589632152 24 09 2014 _Seroll Vertical 7 Preso 96867003822 24 09 2014 x 8 9154786935 20 10 1971 amp E 35840 8652411125 24 09 2014 ci n cuando ay scroll v rtical 10713 0277 4 09 2 10715 0 6223340272 24 08 2014 Xx 10714 Casado 447 JAIAL A nan e Ancho de columnas mediante el atributo width del componente lt atlas columnaListaPaginada gt se puede establece el ancho inicial de las columnas de las tablas este ancho se puede modificar en tiempo de ejecuci n usando el raton sobre las columnas de la tabla Para modificar el ancho de la columna hay que poner el rat n a la derecha de columa hasta ver el icono y luego arrastrar hasta que se obtenga el ancho deseado de la column
8. PONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 4 INSTALACI N Y CONFIGURACI N En este apartado se incluye informaci n sobre la instalaci n y la configuraci n de este componente 4 1 INSTALACI N El componente de lista paginada extendida ya viene instalado en el arquetipo web incluido con el m dulo de componentes visuales Por este motivo no es necesaria una instalaci n adicional si se parte del arquetipo 4 1 1 CONFIGURACI N No es necesaria ninguna configuraci n adicional si se ha partido del arquetipo web Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 7 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 5 USO Una vez instalado el m dulo de componentes puede procederse a su utilizaci n Para ello deben realizarse los pasos indicados en los siguientes apartados 5 1 Paso 1 Definici n del espacio de nombres de etiquetas de Atlas Composite Es necesario crear un fichero xhtml y establecer la definici n del espacio de nombres para las etiquetas de componentes de Atlas Composite Un ejemplo de cabecera de fichero xhtml es la siguiente Cabecera de fichero xhtml lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE html PUBLIC W3C DTD XHTML 1 0 Transitional EN http ww w3 org TR xhtml1 DTD xhtml1 transitional dtd gt lt html xmlns http www w3 org 1999 xhtml xmlns h http java sun com jsf
9. a e Reordenamiento de columnas el componente permite el arrastrar y soltar una columna bien hacia la derecha o izquierda hasta la posici n deseada En la siguiente figura se muestra un ejemplo donde la columna Apellido 2 se mueve hacia la posici n que esta entre la columna Nombre y Apellido 1 se puede ver que haya una flecha hacia arriba de color azul que indica donde se va a poner la columna arrastrada Id Cliente Estado Civil Nombre Apellido 1 Apellido 2 0708 Diworciado nombre2 t segundoapellido2 0709 Casado nombre3 apelli segundoapellido3 10710 Casado nombre4 apellido4 segundoapellido4 6 Casado Jose Antonio Jimenez De laOsaccc4 7 Preso Jose Vi ente Perez Martinez 4 8 Preso Calvin Cordozar Broadus Jr L 9 Casado Maria Josefa Jimenez De la olla 10712 Casado nombres apelido6 segundoapelido6 0713 Casado nombre apellido 7 segundoapellido 7 10715 Casado nombre9 apellido9 segundoapellido9 1 2 Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 5 Fecha 02 12 2013 DIRECCI N DE INGENIERIA A continuaci n se muestra un ejemplo completo de la apariencia visual del componente Cliente Estado Civil y 2 Direccion Telefono Fc Nacimiento Eliminar Preso 1 Calle n 4 Arroyo Culebro 248 Madrid 96867003822 24 09 2014 Preso Jr Long Beach California Estados Unidos de Am rica 9154786935 20 10 1971 E Divorciado ipellido2 622330271522 24 09 2014 X Deshauciado Calle n
10. al con el resto de columnas de la tabla A continuaci n se muestra un ejemplo de 2 columnas fijas Id Cliente Estado Civil bre Apellido 1 10708 Divorciado rel apeliido2 10709 Casado weg apellido3 10710 Casado red apellido4 6 Casado Antonio Jimenez 7 Preso vicente Perez Columnas Fijas 5 reso n Cordozar 9 Casado t Josefa Jimenez 10712 Casado weg apellidos 10713 Casado rel apellido 10715 Casado weg apellido9 1071 Casado ywein anelidnin 4 Scroll ld Cliente 10708 10709 10710 g 10712 10713 10715 Selecci n multiple de filas mediante el atributo selectionMode se puede establecer el tipo de selecci n de las filas de la tabla los posibles valores son none ninguna single solo una fila puede ser seleccionada multiple se usa en conjunto con las teclas Ctrl Shift multipleKeyboardFree uso de clicks para multi selecci n Estado Civil Telefono Fc Nacimiento Eliminar Editar Divorciado 622330271522 24 09 2014 Casado 622330277 24 09 2014 E Casado 622330276 24 09 2014 E Casado 4589632152 24 09 2014 x Preso oyo Culebro 248 Madrid 96867003822 24 09 2014 x Preso california Estados Unidos d 9154786935 20 10 1971 Casado Culebro 248 Madrid 95865211125 24 09 2014 Casado 622330270 24 09 2014 x Casado 622330277 24 09 2014 Selecci n Multiple Casado 622330272 24 09 2014 x 4 o l gt 1 2 Total 14 Framework ATLAS Manual MANUAL DE USUAR
11. cutado cuando se presiona 8 y suelta una tecla sobre una fila de la tabla Seva Stin M todo javascript ejecutado cuando se suelta 8 una tecla sobre una fila de la tabla M todo javascript ejecutado cuando el boton del onrowmousedown String rat n se mantiene presionado sobre una fila de la tabla Strin M todo javascript ejecutado cuando el puntero 8 del rat n se mueve dentro de la fila de la tabla Strin M todo javascript ejecutado cuando el puntero 8 del rat n se mueve fuera de la fila de la tabla Strin M todo javascript ejecutado cuando el puntero 8 del rat n se mueve sobre la fila de la tabla Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 11 Fecha 02 12 2013 DIRECCI N DE INGENIERIA Strin M todo javascript ejecutado cuando el bot n del 8 rat n se suelta de la fila de la tabla M todo javascript que se llama despues que se onselectionchange String J p q p a ha cambiado la selecci n de la fila rowClasses String Asigna uno o mas estilos a las filas de la tabla N mero de filas a mostrar en la tabla selection java util Coll Colecci n de filas que se han seleccionado ection Tipo de selecci n de las filas none ninguna org richface single solo una fila puede ser seleccionada s model Sel multiple se usa en conjunto con las teclas ectionMode Ctrl Shift multipleKeyboardFree uso de clicks
12. der clienteBean obtener pageCountProvider clienteBean obtenerTotal width 966px height 260px orderAndFilterProvider clienteBean getOrderAndFilter sortAscending fclienteBean orderAndFilter ordenarAscendente sortColumn fclienteBean orderAndFilter columnaOrden filter clLienteBean orderAndFilter filtro export true frozenColumns 2 selectionMode multipLe gt lt atlas columnaListaPaginada id columnaClienteldClLiente Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 10 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 5 4 Atributos de la lista paginada extendida ATRIBUTO OBLIGATORIO TIPO DESCRIPCION Identificador del componente Recomendable String especificarlo si se utilizan varias listas paginadas en la misma p gina headerClass No String Estilos css para la cabecera de la tabla l l M todo javascript que se llama antes de que onbeforeselectionchange String l cambie la selecci n de la fila M todo javascript que se llama despues que la onread Strin AA Strin M todo javascript que se llama cuando se hace 8 click sobre una fila de la tabla E M todo javascript que se llama cuando se hace onrowdblclick Strin l doble click sobre una fila de la tabla Strin M todo javascript ejecutado cuando se mantiene y 8 presionado una tecla sobre una fila de la tabla Strin M todo javascript eje
13. faces l Boolean Muestra el datascroller si s lo hay una renderlfSinglePage boolean p gina Su valor por defecto es true fastStep Nit Atributo fastStep del dataScroller Permite activar la exportaci n Su valor por export boolean defecto es false Nombre que se dar al fichero de exportaci n su exportFile String l valor por defecto es export exportLimit Oo Noo fome N mero m ximo de filas a exportar 5 5 Nuevos atributos de la columna en la lista paginada extendida ATRIBUTO TIPO DESCRIPCION No Por defecto Ancho en pixeles de cada columna 100px Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 13 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 5 6 RECOMENDACIONES Y BUENAS PR CTICAS 5 7 EJEMPLO DE USO Se puede ver 2 ejemplos de dicho componente en la aplicaci n de componentes a partir de la versi n 1 2 8 en la siguiente secuencia de navegaci n Inicio gt Paginaci n de Resultados gt Lista Paginada Extendida Inicio gt Paginaci n de Resultados gt Lista Paginada Extendida con scroll Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 14 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 6 PREGUNTAS M S FRECUENTES En este apartado se incluyen una lista de preguntas m s frecuentes sobre el componente Pregunta D nde puedo encontrar informaci n general sobre los componentes
14. html xmlns atlasc http atlas core componentes jsf composite xmlns a4j http richfaces org a4j xmlns rich http richfaces org rich gt 5 2 Paso 2 Inserci n en la p gina de la etiqueta de lt atlasc listaPaginadaExtended gt Se incluir una etiqueta lt atlasc listaPaginadaExtended gt que inserta el componente en la p gina A continuaci n se muestra un ejemplo listaPaginadaExtendidaSample xhtml lt atlasc listaPaginadaExtended id clienteTable pageProvider clienteBean obtener pageCountProvider clienteBean obtenerTotal width 966px height 260px orderAndFilterProvider clienteBean getOrderAndFilter sortAscending fclienteBean orderAndFilter ordenarAscendente sortColumn fclienteBean orderAndFilter columnaOrdenj filter clLienteBean orderAndFilter filtro export true 2 1 selectionMode multiple p 10 gt lt atlas columnaListaPaginada id columnaCLienteldCliente for clienteTable label fbundle table clienteidcliente orderAndFilterBean fclienteBean orderAndFilterj orderValue idClLiente exportValue idCliente anchoColumna 75px gt lt ui define name value gt lt h o0utputText id outputTextClLienteldCliente Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 9 Fecha 02 12 2013 DIRECCI N DE INGENIERIA value fitem idCliente gt lt h outputText gt lt ui define g
15. nente en una aplicaci n Web as como informaci n acerca de la configuraci n de los par metros fundamentales del componente 1 1 AUDIENCIA OBJETIVO Este documento est orientado a toda aquella persona que est desarrollando una aplicaci n Web basada en el Framework Atlas y necesite utilizar componentes de presentaci n en su aplicaci n Web 1 2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento el lector deber tener conocimientos previos sobre las siguientes tecnolog as e Java Server Faces JSF e RichFaces e Spring Framework e Hibernate e JavaScript e CSS Para saber m s sobre dichas tecnolog as consultar el apartado de este documento ENLACES RELACIONADOS Framework ATLAS Manual MANUAL DE USUARIO COMPONENTE LISTA PAGINADA EXTENDIDA Versi n 1 0 3 Fecha 02 12 2013 DIRECCI N DE INGENIERIA 2 DESCRIPCI N El componente Lista Paginada Extendida atlasc listaPaginadaExtended esta construido tomando como base el componente Lista Paginada agregando nuevas funcionalidades como scroll vertical y horizontal columnas fijas selecci n multiple de filas ancho inicial de las columnas y el poder arrastrar y soltar una columna para moverla a una nueva posici n A continuaci n detallamos cada una de las nuevas caracteristicas e Columnas Fijas mediante el atributo frozenColumns se puede establece el n mero de columnas que quedar n fijas en la tabla por lo que se podr hacer scroll vertic
16. t lt atlas columnaListaPaginada gt lt atlas columnaListaPaginada id columnaCLienteEstadoCivil for clienteTable label f bundle table clienteestadocivil 3 orderAndFilterBean f clienteBean orderAndFilterj orderValue estadoCivil estadoCivil exportValue estadoCivil textoListavalores gt lt ui define name value gt lt h outputText id outputTextClienteEstadoCivil value fitem estadoCivil textolistaValores gt lt h outputText gt lt ui define gt lt atlas columnaListaPaginada gt A continuaci n se muestra un ejemplo de la lista paginada extendida sobre la tabla de clientes cuyo atributo m s relevante es frozenColumns 2 fd Cliente Estado Civil 10708 Divorciado 10709 Casado yor Apellido t Apellido2 Direccion bre2 apellido2 segundoapellido2 ombres apellido3 segundoapellido3 10710 Casado bre4 apelido4 segundoapelido4 6 Casado Joke Antonio Jimenez DelaOsaccc Columnas Fijas Joke Vicente Perez Martinez 4 o Calle n 4 Arroyo Culebro 248 Madrid 8 Preso Cordozar Broadus Jr Long Beach California Estados Unidos de Am rica 9 Casado Mafia Josefa Jimenez De la olla Calle n 4 Arroyo Culebro 248 Madrid Casado ohhbres apellido segundoapellidoS Casado bre7 apellido7 segundoapellido7 Casado apellido9 segundoapelido9 Paginaci n
Download Pdf Manuals
Related Search