atlas manual de usuario componente lista de valores
Contents
1. 13 de 22 ei Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores Soltero 1 2 Casado 3 Viudo vs En el par metro order se recibe un Object con la ordenaci n en este caso se puede hacer un casting a una clase de tipo atlas componentes bo OrderBean que contiene la columna y el sentido de la ordenaci n en caso en que la hubiera En el ltimo par metro filter se recibe una lista con dos elementos el primero es el valor del desplegable del filtro y el segundo el valor del campo de texto para especificar un filtro Si alguno de los dos es nulo se recibe null 4 2 1 pageCountProvider Este m todo debe devolver un nt con el n mero de registros totales Recibe como par metro el objeto filter 4 3 Atributos del componente Los principales atributos del componente atlas listaValores son los siguientes e Elatributo id sirve para establecer el identificador del componente Es obligatorio y debe ser nico e El atributo dataModel sirve para enlazar el componente con el objeto de la clase atlas componentes bo ListaValores declarado e El atributo aliasBean identificar la ruta de acceso en el contexto de JSF del objeto anterior Generalmente se corresponder con la propiedad dataModel pero en modo Texto en lugar de como expresi n e El atributo queryCode sirve para especificar cu l es la consulta a base de datos que se quiere utilizar para obtener2. Arquitectura de Aplicaciones columnaListaValores 4 1 5 Funcionamiento con ajax A adidas preguntar al FAQ sobre el funcionamiento con ajax RR 2 de 22 ptr Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio Modificaciones 2 Descripci n Actualizada captura del l Area de Integraci n y componente a 08 02 2011 Arquitectura de Aplicaciones 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta de Atlas Actualizados atributos 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta de Atlas Lista de valores Area de Aplicaciones A adido id a la lista de valores es l pi Especiales y Arquitectura de 01 09 2011 obligatorio como se especifica m s Software adelante Se modifica el nombre del Area rea de Aplicaciones Modificaci n general del documento por la migraci n Especiales y Arquitectura de 15 02 2012 del componente a JSF 2 Software Modificacion para utilizar un provider externo en lugar de la consulta en el fichero queries properties Esto permite usar la lista de valores sin conexi n a F o Area de Aplicaciones base de datos l l 1 6 Especiales y Arquitectura de 13 06 2012 Software Modificaci n del documento para los nuevos modos de renderizado del componente con sin campo de texto y modo suggestion rea de Aplicaciones 4 3 Atributos del componen
3. Nombre atributo Obligatorio Descripci n campoBD SI Campo o alias contenido en la clasula SELECT de la consulta que retornar los resultados sobre el que se aplicar n las propiedades de este componente dataModel SI Referencia al objeto de tipo ListaValores que dar soporte al componente debe corresponderse con la propiedad dataModel del componente listaPaginada Id del componente lista de valores que incluye la columna NO Label que se mostrar como cabecera de la columna si es mostrada y del desplegable del filtro si el campo es usado en este El valor por defecto es igual al valor de la propiedad campoBD condicion NO Condici n en formato SQL que se aplicar al campo Ejemplo condicion LIKE texto mostrarEnFiltro NO Valores true false Indica si se debe mostrar el campo en el combo del filtro de datos valor por defecto true mostrarColumna Valores truejfalse Indica si se debe mostrar el campo camo columna del listado valor por defecto true metodoRetorno Indica un m todo de retorno al que se llamar pas ndole el valor de este campo para el registro seleccionado el valor debe tener el formato nombreBean nombreMetodo y el m todo debe aceptar un String como par metro de entrada y no retornar valor alguno alias Tabla NO Alias de la tabla que contiene la columna en la consulta que se utilizar para obtener la lista de resultados render NO ld s en formato compatible con UlComponentfindComponent de los com
4. de los componentes del Framework Atlas Pregunta C mo puedo crear un nuevo tipo de Lista de valores Respuesta Para crear una nueva lista de valores lo primero necesario es establecer un nuevo grupo de elementos en el fichero de propiedades de la aplicaci n En este fichero es necesario establecer un par de sentencias SQL encargadas de obtener los datos que aparecer n en la lista de valores tanto para obtener los elementos en s como el total de los elementos Pregunta Se ejecutan los m todos de retorno en caso de utilizar el modo suggestion Respuesta S seleccionar un elemento mediante suggestion genera los mismo resultados que seleccionarlo en el panel modal Pregunta C mo puedo encadenar listas de valores que una dependa de lo seleccionado en otra Respuesta Usando un valor de retorno de la lista padre en el atributo condici n de la columna correspondiente en la lista dependiente Ejemplo Ejemplo Ak RRK 20 de 22 pi a Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores lt atlas listaValores queryCode provinciassuca aliasBean listaValoresProvincias dataModel listaValoresProvincias id provinciasLV titulo Provincias rows 10 filterIlnputsize 10 width 400 height 400 moveable true resizeable false paginatorMaxPages 4 gt lt atlas columnalistaValores campoBD CDPAIS dataModel listaValoresProvin
5. los elementos que la lista de valores va a presentar En este ejemplo se puede observar que este valor de identificador coincide con el mismo que se estableci como ejemplo en la sentencia de consulta de la lista de valores de este documento e El atributo titulo sirve para establecer el t tulo del panel emergente donde se presentan los elementos de la lista de valores e El atributo rows sirve para especificar el n mero de registros que se van a mostrar por p gina Los atributos de los componentes atlas columnaListaValores son los siguientes kk Ra Vi 14 de 22 ed Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores e El atributo for debe ser el id de la lista de valores en la que est el componente e Elatributo campoBD identifica un campo o alias contenido en la clausula WHERE de la query de datos e El atributo dataModel sirve para enlazar con el objeto de la clase atlas componentes bo ListaValores debe corresponderse con el atributo dataModel del componente atlas listaValores e Elatributo mostrarColumna Indica si se debe mostrar el campo en el listado de resultados de la consulta por defecto este atributo vale TRUE en el ejemplo no mostraremos la columna CDTVIA e Elatributo mostrarEnFiltro Indica si se debe mostrar el campo en el combo desplegable de filtro de datos por defecto el atributo vale TRUE En el ejemplo no mostraremos la columna CDTV
6. ATLAS MANUAL DE USUARIO COMPONENTE LISTA DE VALORES Versi n 1 9 Arquitectura de Software ASAS REE mC iT Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid is ef Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores Hoja de Control T tulo Manual de usuario Componente Lista de valores Documento de NORMATIVA ATLAS Referencia Responsable Arquitectura de Software Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio rea de Integraci n y 1 0 Versi n inicial del documento aa 26 05 2010 Arquitectura de Aplicaciones Modificaciones sobre la versi n 1 0 4 1 2 Paso 2 Declaraci n en el bean de respaldo de la p gina de un objeto de tipo atlas componente bo ListaValores e inicializaci n del mismo Utilizar una clase dentro de un bean en lugar de un bean en el rea de Integraci n y contexto de JSF para cada lista de valores Arquitectura de Aplicaciones DoE 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta de Atlas Eliminado atributo regsLimit y creado nuevos atributos ajax y tridentIVEngineSelectBehavior para la lista y aliasTabla para las columnas Modificaciones 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta de Atlas Modificado atributo ajax y a adido atributo reRender de la lista de l l Area de Integraci n y valores A adido atributo for de l SONE 19 10 2010
7. IA e Elatributo metodoRetorno establece que cuando se seleccione un registro se debe ejecutar el m todo especificado pasando como par metro el valor del campo para ese registro En el ejemplo se llamar a los m todos public void setCodigoVial String codigoVial y public void setNombreVial String nombreVial de un managedBean llamado miManagedBean pasando como par metros los valores de los campos CDTVIA y DSTVIA respectivamente paraun registro seleccionado e Elatributo inputRenderMode especifica si se quiere mostrar un campo de texto asociado al componente y el modo de uso de este campo los posibles valores son none no se muestra ning n campo opci n por defecto readOnly se muestra un campo de solo lectura y suggestion se muestra un campo en el que se podr n buscar y seleccionar registros e El atributo inputColumn debe especificarse si inputRenderMode es readOnly o suggestion y debe ser el valor campobBD de alguna de las columnas que contenga la lista El valor de esa columna ser el que se muestre en el campo y sobre esa columna se buscar para sugerir resultados e El atributo label indica el t tulo que debe utilizarse como cabecera en la columna del listado de valores y o como descripci n del item correspondiente en el combo desplegable de filtrado de datos En el ejemplo los campos DSTVABR y DSTVIA se mostrar n al usuario como Abreviatura y Descripci n respectivamente e El campo condicion permite la adici
8. Valores que dar soporte al componente Generalmente se corresponder con la propiedad dataModel pero en modo Texto en lugar de como expresi n C digo de las consultas SQL necesarias para los datos y el paginado de la lista de valores debe corresponderse con el distintivo de dos propiedades del fichero application properties de la aplicaci n con formato queryCode valorDeEstaPropiedad para la query de datos y queryCode valorDeEstaPropiedad count para la query que retorna el n mero de registros Si se activa la propiedad externalProvider no es obligatorio Valores true false Si es true no se utilizar la consulta sql del fichero queries properties En su lugar se obtendr n los elementos de la lista de los m todos se alados en las propiedades pageProvider y pageCountProvider Su valor por defecto es false pageProvider M todo de backingbean para obtener los elementos de la p gina Se debe especificar si externalProvider es true pageCountProvider M todo de backingbean para obtener el total de elementos existentes entre todas las p ginas Se debe especificar si externalProvider es true valorFiltro NO Valor que debe aplicarse en un filtrado inicial de datos debe usarse en conjunto con la propiedad camporiltro camporiltro Po inputRenderMode Campo sobre el que debe realizarse un filtrado inicial de datos debe usarse en conjunto con la propiedad valorFiltro Especifica si se quiere mostrar un campo
9. ara ejecutar la consulta kk RRK 6 de 22 nf Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores ARES Filtro se k Cod Comun Cod Prov Hombre Provincia 1 41 Sevila 42 Soria q Tarragona qe Teruel 45 Toledo 46 wal nciantalencia 47 valladolid do Bizkaia 25 Lleida 51 Ceuta E Total 55 3 INSTALACI N Y CONFIGURACI N En este apartado se incluye informaci n sobre la instalaci n y la configuraci n del componente Lista de Valores 3 1 INSTALACI N El componente de listado de valores 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 3 2 CONFIGURACI N u as 7 de 22 pi Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores Para la configuraci n del componente se debe crear una sentencia de consulta para la lista de valores Este paso es necesario para que el componente tenga acceso a los datos de la base de datos que queremos que sean mostrados en la lista Tenemos que establecer en el fichero queries properties de la aplicaci n para cada consulta las siguientes dos propiedades la primera es la consulta que se utilizar para recuperar los datos del listado de valores la segunda propiedad es una query que devuelva el n mero
10. cias condicion LIKE TES metodoRetorno listaValoresProvinciasSampleBean setCodigoPais mostrarColumna false mostrarEnFiltro false gt lt atlas columnaLlistaValores campoBD CDCOMU dataModel f listaValoresProvinciasj label Cod Comunidad gt lt atlas columnaLlistaValores campoBD CDPROV dataModel f listaValoresProvinciasj label Cod Provincia metodoRetorno listaValoresProvinciasSampleBean setCodigoProvincia gt lt atlas columnaLlistaValores campoBD DSPROV dataModel f listaValoresProvincias label Nombre Provincia metodoRetorno listaValoresProvinciasSampleBean setNombreProvincia gt lt a las lcd llo mel gt lt atlas listaValores queryCode localidadessSuca aliasBean listaValoresMunicipios dataModel listaValoresMunicipios id localidadesLV titulo Localidades rows 10 filterIlnputsize 10 width 400 height 400 moveable true resizeable false paginatorMaxPages 4 gt lt atlas columnalistaValores campoBD CDPAIS dataModel listaValoresMunicipios condicion LIKE 3ES 3 metodoRetorno listaValoresProvinciasSampleBean setCodigoPais mostrarColumna false mostrarEnFiltro false gt lt atlas columnaLlistaValores campoBD CDPROV dataModel f listaValoresMunicipiosj condicion Hf listaValoresProvinciasSampleBean codigoProvincia label Cod Provincia mostrarEnFiltro falise metodoRetorno listaValoresProvinciasSampleBean setCodigoProvincia gt lt at
11. de texto asociado al componente y el modo de uso de este campo los posibles valores son none no se muestra ning n campo opci n por defecto readOnly se muestra un campo de solo lectura y suggestion se muestra un campo en el que se podr n buscar y seleccionar registros 16 de 22 AA RRK cm Agencia de Framework Atlas Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores inputColumn Debe especificarse si inputRenderMode es readOnly o suggestion y debe ser el valor campoBD de alguna de las columnas que contenga la lista El valor de esa columna ser el que se muestre en el campo y sobre esa columna se buscar para sugerir resultados suggestionSize N mero de resultados sugeridos para el modo suggestion Su valor por defecto es 10 inputSize NO Tama o del inputText para el caso inputRenderMode readOnly inputWidth Clase css para especificar el tama o del input en el caso inputRenderMode suggestion inputClass Clase css para el campo input en los casos suggestion y readOn ly Peish No Ato de la ventana modal saa m o me truelfalse Indica si la venta admite ser arrastrada con el rat n Valor por defecto true resizeable Valores true false Indica si la venta admite ser redimensionada con el rat n Valor por defecto false autosized NO Valores true false Indica si la venta debe autodimensionarse Valor por defecto true Este atributo no funciona co
12. elocity apache org 22 de 22 kk Ak A A
13. emplo de Listas de valores del Atlas Framework 1 0 lt description gt lt managed bean name gt listaValoresTvialSampleBean lt managed bean name gt lt managed bean class gt atlas samples jsf ListaValoresTvialSampleBean lt managed bean class gt lt managed bean scope gt request lt managed bean scope gt lt managed property gt lt property name gt atlasFacade lt property name gt lt value gt Ff atlasFacade lt value gt lt managed property gt lt managed bean gt En dicho bean debe crearse un objeto de tipo atlas componente bo ListaValores e inicializarlo Por cada lista de valores ser necesario crear un objeto de este tipo ListaValoresTvialSampleBean java ARAS 11 10 de 22 et Agencia de o Framework Atlas Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores C pk The Class ListaValoresTvialSampleBean e public class ListaValoresTvialSampleBean extends BaseBean pk Lista de valores Ey private ListaValores listaValores EX non davadoc QinheritDoc x see atlas faces bean BaseBeanfinit 7 public void init this listaValores new ListaValores pk x lparam listaValores e public void setlistaValores ListaValores listaValores this listaValores listaValores l IA x return la lista de valores Ey public ListaValores getListaValores return listaValores 4 1 3 Paso 3 Definici n del espacio de n
14. las columnaListaValores campoBD CDMUNI dataModel listaValoresMunicipios label Cod Localidad metodoRetorno listaValoresProvinciasSampleBean setCodigolocalidad gt lt atlas columnaListaValores campoBD DSMUNI dataModel listaValoresMunicipios label Nombre Localidad metodoRetorno listaValoresProvinciasSampleBean setNombrelLocalidad gt lt tr gt ARAS e 1 21 de 22 kk Ak Ak kkk Agencia de C Inform tica y Comunicaciones de la Comunidad de Madrid Framework Atlas Componente Lista de Valores 7 ENLACES RELACIONADOS Producto URL Ajax4JSF Barbecue Commons BeanUtils Commons Configurations Facelets Hibernate Hibernate Annotations JAXB Jcaptcha JPA JSF JSFUnit Log4J MyFaces Core RichFaces Spring Spring Security Velocity http www jboss org jbossrichfaces http barbecue sourceforge net commons apache org beanutils http commons apache org configuration https facelets dev java net http www hibernate org http www hibernate org hib_docs annotations reference en html_single http java sun com webservices jaxb captcha sourceforge net http ava sun com developer technicalArticles J2EE pa http ava sun com javaee javaserverfaces http www boss org sfunit http logging apache orqg log4j http myfaces apache org http www boss org bossrichfaces http www springframework org httpo www springframework orqg http v
15. n de condiciones adicionales a la clausula WHERE de la consulta sobre el campo especificado en campoBD En el ejemplo se limita a la consulta a valores del campo DSTVIA que comiencen por C a adiendose a la clausula WHERE la condici n AND DSTVIA LIKE C e Elcampo alias Tabla permite especificar el alias de la tabla en caso de que tenga a la que pertenece la columna en la consulta que contenida en el queries properties Se utilizar para que en los filtros y condiciones se anteponga al nombre de la columna y as evitar posibles ambig edades si varias tablas contienen una columna con el mismo nombre e El atributo render contendr una lista de identificadores de los componentes que tengan que actualizarse al seleccionar un registro de la columna Los identificadores deben estar separados por espacios kk Ra Vi 15 de 22 AA Agencia de Te Inform tica y Comunicaciones de la Comunidad de Madrid Framework Atlas Componente Lista de Valores La lista completa de atributos del componente listaValores son los siguientes Nombre atributo Obligatorio Descripci n o E o externalProvider Modelo de datos empleado para una lista de valores Sirve para extraer los datos que se presentan en la lista de valores Se trata de un objeto de la clase atlas componentes bo ListaValores que se encuentra declarado e inicializado en un bean de respaldo Ruta de acceso en el contexto de JSF del objeto Lista
16. n del espacio de nombres de etiquetas de Atlas oooonoconncnnonnnnnnnnnnnnnnnonononnnnnonnnnnnnnnnnnnnnnnnnnnss ll 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta atlas lista Valores ooonnnnnnnnnnnnnncnnnnnnnnnnnnnnnnnnonononannnnnncnnnnnnnnninnns 12 4d METODOS EXTERNOS e N E E EA T E E N rao osados 12 dad PO O T aa E E A EE E E E E 13 kad POCO ON E R E E E E E S 14 Wde ATRIBUTOS DELCOMPONEN TE ai ariane ronen E EPR EENE EEE E SE N E E A E NE TN 14 5 RECOMENDACIONES Y BUENAS PR CTICAS s ss ssssssossossossossossosscssosssoseoseoseossossossossossossossosscssossesseossoseossoseeseeseese 19 Siles EJEMPLO DE USO raid 19 6 PREGUNTAS MAS E RECUENTES sanos 20 Te ENLACES RELACIONADOS cinrnssiaii aa a a a aa 22 kk Ak ARK 4 de 22 ei Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores 1 INTRODUCCI N Este documento contiene el manual de uso del componente visual Lista de valores del Framework Atlas En l se incluye informaci n sobre c mo utilizar dicho componente 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 complet
17. n una p gina de la lista de valores Ejemplo del m todo para el atributo pageProvider param index Indice de paginacion actual param pageSize Tama o de pagina param order Criterio de ordenacion param filter Filtro de busqueda hreturn Lista de objectos AtlasHashMap que representa la lista de registros i public List lt AtlasHashMap gt obtenerEstadosCiviles int index int pageSize Object order Object filter o List lt List lt Object gt gt listaEstadosCiviles new ArrayList lt List lt Object gt gt l Obtenci n de la lista 4 1d return this listaValoresEstadoCivil getPageProvider listaEstadosCiviles El primer par metro es el primer elemento que se pide de la lista El segundo el n mero de registros por p gina El m todo debe devolver una lista de objetos atlas componente utiles AtlasHashMap Para obtener esta lista se debe utilizar el m todo getPageProvider del objeto ListaValores asociado al componente tal y como se muestra en el ejemplo A este m todo se le debe pasar una lista en la que cada elemento debe ser un registro de la lista El formato del registro debe ser otra lista con tantos elementos como columnas tenga el componente en el orden en que se defina en la p gina xhtml Y en esa lista cada posici n ser un valor a mostrar En el siguiente ejemplo se muestra un ejemplo para estados civiles la primera columna representa el identificador y la segunda la descripci n kk Ra
18. o entendimiento del documento el lector deber tener conocimientos previos sobre las siguientes tecnolog as e Java Server Faces JSF e Facelets e Richfaces e Spring Framework e Hibernate Para saber m s sobre dichas tecnolog as consultar el apartado de este documento Enlaces Relacionados 2 DESCRIPCI N Este componente sirve para rellenar un campo de formulario con un valor elegido de entre un conjunto de m ltiples valores El usuario tendr que pulsar sobre el bot n del componente que deber situarse junto al campo que se quiere rellenar El componente tiene las siguientes caracter sticas e La lista de valores se puede prefiltrar de manera opcional y previamente a que aparezcan los valores para elegir en el panel emergente mediante controles que se dispongan para tal fin en el formulario conect ndolos a atributos de la etiqueta lista Valores e El componente tiene 3 modos de funcionamiento o Sin campo de texto asociado s lo mostrar los botones de abrir panel y borrar elemento seleccionado o Con campo de texto asociado el componente mostrar un campo de texto para el registro seleccionado o Con campo de tipo suggestion se a ade un campo en el que el usuario podr escribir y kk Ra OOO onxnccnmE A Vi 5 de 22 gfh Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores se sugerir n resultados En este caso se podr n
19. ombres de etiquetas de Atlas Es necesario crear un fichero xhtml y establecer la definici n del espacio de nombres para las etiquetas de componentes de Atlas Un ejemplo de cabecera de fichero xhtml es la siguiente Cabecera de fichero xhtml ARAS 1 11 de 22 x xk tus e e C Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores AAR Agencia de Framework Atlas lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE H ml PUBLIC lt WSC DTD XHTML 1 0 Transitional EN REED WWW W gt 0 9 TR xhtml1 DTD lt Atmll Eransitional dtd gt lt html xmlns http www w3 org 1999 xhtml xmlns h http java sun com jsf html xmlns f http java sun com jsf core xmlns ui http java sun com jsf facelets xmlns atlas http atlas core componentes jsf xmlnas a4j http richfaces org a4 gt 4 1 4 Paso 4 Inserci n en la p gina de la etiqueta atlas listaValores Es necesario insertar la etiqueta listaValores en el formulario de una p gina Un ejemplo de una lista de valores es el siguiente Ejemplo xhtml lt atlas listaValores id listaValoresTvial queryCode vialesSuca aliasBean listaValoresTvialSampleBean listaValores dataModel listaValoresTvialSampleBean listavalores titulo Tipos de viales rows 4 render nombreVial gt lt atlas columnalListaValores for listaValoresTvial campoBD CDTVIA dataModel listaValoresTvialSampleBean listaValore
20. ponentes que deber n renderizarse al seleccionar un registro de la columna Puede ser un id varios separados por espacio o una expresi n EL que devuelva un array o Collection Lista de id s de componentes separados por espacio 18 de 22 AA RRK cm effa Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores filtrarAcentos Valor truejfalse para especificar si se debe hacer una b squeda que filtre los caracteres acentuados Su valor por defecto es false Este atributo no tiene efecto si externalProvider es true 5 RECOMENDACIONES Y BUENAS PR CTICAS Se recomienda que el n mero de filas mostradas por p gina sea peque o para que no aparezca el scroll vertical para ello definimos una variable en la invocaci n al componente Dicha variable es rows 9 1 EJEMPLO DE USO Se puede ver varios ejemplos de dicho componente en la siguiente secuencia de navegaci n por la aplicaci n de demostraci n de los componentes Inicio gt Formularios gt Lista de Valores kk RRK 19 de 22 ed Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores 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 Respuesta En la aplicaci n de demostraci n
21. rdenaci n mediante los atributos del propio componente y los del componente columnaListaValores En el segundo caso se delega la responsabilidad en los m todos proporcionados por el usuario 4 1 Consulta SQL En este caso los pasos a seguir son los siguientes 4 1 1 Paso 1 Definici n de la consulta de la lista de valores Es necesario especificar en el fichero queries properties de la aplicaci n la consulta que tiene que usarse por la lista de valores que pongamos en nuestro formulario Por ejemplo queries properties queries para la lista de valores de viales queryCode vialessuca SELECT CDTVIA DSTVIA DSTVABR ITNIVEL USO FROM DBA SUCA SUCA TIPO VIAL queryCode vialesSsuca count SELECT COUNT EROM DBA SUCA SUCA TIPO VIAL En este ejemplo se define una lista de valores para selecciona un tipo de vial 4 1 2 Paso 2 Declaraci n en el bean de respaldo de la p gina de un objeto de tipo atlas componente bo ListaValores e inicializaci n del mismo El bean de respaldo de la p gina debe definirse en el fichero de configuraci n de JSF que puede encontrarse en el proyecto web generado por el arquetipo bajo este nombre IsrcimainlwebapplWEB INH faces managed beans xml faces managed beans xml kk RRK 9 de 22 Koa Agencia de Framework Atlas xk Ls e e C Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores lt managed bean gt lt description gt Bean de respaldo de los ej
22. rrectamente en Internet Explorer en cuanto al ancho de modo que habr que usarlo en combinaci n con la propiedad width para establecer el ancho correcto del panel modal En este caso si no se especifica un ancho ser 300px render Id s en formato compatible con UlComponentfindComponent de los componentes que deber n renderizarse al borrar el registro seleccionado en la lista Puede ser un id varios separados por espacio o una expresi n EL que devuelva un array o Collection paginatorMaxPages N mero m ximo de links de cambio de p gina que se mostrar n simultaneamente en el paginado de la tabla de valores rows NO N mero m ximo de registros que se mostrar n por p gina en la tabla de valores kk kk xk xk cm 17 de 22 AA Agencia de Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores filterlnputSize m Tama o del input filtro filtroAutomatico Si es true el filtrado se har autom ticamente en cada pulsaci n de una tecla o cambio en el valor del campo por el que se filtra se har la b squeda Si es false habr un icono para pulsar y realizar la b squeda Su valor por defecto es true Icono NO Ruta para el icono que mostrar el componente para abrir la lista Icono limpiar NO Ruta para el icono que mostrar el componente para borrar el valor seleccionado Los atributos del componente atlas columnaListaValores son los siguientes
23. s mostrarColumna false mostrarEnFiltro false metodoRetorno miManagedBean setCodigoVial gt lt atlas columnalListaValores campoBD DSTVABR dataModel listaValoresTvialSampleBean listaValores label Abreviatura render nombreVial gt lt atlas columnaListaValores campoBD DSTVIA dataModel listaValoresTvialSampleBean listaValores condicion LIKE C3S label Descripci n metodoRetorno miManagedBean setNombreVial render nombreVial gt fatlasc Llistavalores o 4 2 M todos externos ARAS a 11 12 de 22 ed Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores En este caso el componente delega en dos m todos la obtenci n de los datos Respecto al caso anterior no hay que definir ninguna consulta en el fichero queries properties El resto de pasos declaraci n en el bean de respaldo del objeto ListaValores definici n del espacio de nombres de Atlas e inserci n de la etiqueta son los mismos Adem s hay que especificar los siguientes atributos en el componente e externalProvider Debe ser true e pageProvider M todo al que se llamar para obtener la lista de elementos que se van a mostrar en la lista de valores Se detalla a continuaci n e pageCountProvider M todo al que se llamar para obtener el n mero total de registros 4 2 1 pageProvider El m todo pageProvider devuelve los registros que se muestran e
24. seleccionar registros sin necesidad de abrir el panel Componente none E ty readOniy DY suggestion CHALET oo CALLEJON 18 CENTRO SANITARIO Resultadd lt ERRO CIUDAD LEA El panel con los valores aparecer solamente cuando el usuario pulse el bot n correspondiente El panel desaparecer cuando el usuario seleccione un valor de la lista Tambi n puede borrar el elemento elegido en el formulario si pulsa sobre el icono correspondiente O bien cerrar el panel sin elegir ning n valor e Es posible ordenar la lista de valores por columnas e En la lista de valores aparecer el n mero total de registros encontrados e Eln mero de filas de la p gina se establece por un atributo en el componente e El componente utiliza ajax tanto para mostrar el panel y ocultarlo seleccionar el registro y paginar por lo que en ning n momento se realiza una recarga completa de la p gina Tambi n es posible especificar qu otros componentes deben actualizarse al seleccionar un elemento o borrar uno seleccionado previamente e En la secci n superior del panel aparecer un campo y un desplegable para el filtrado de resultados En el campo se establecer el valor por el que se quiere filtrar y en el desplegable se secciona la columna por la cu l se quiere filtrar por el valor introducido en el campo El filtrado puede ser autom tico cuando el usuario escriba en el campo de texto o cambie el valor del combo o bien con un bot n p
25. te a adido atributo l l Especiales y Arquitectura de 04 10 2012 filtrarAcentos Software 4 3 Atributos del componente ampliada la rea de Aplicaciones descripci n de la propiedad autosized y a adido Especiales y Arquitectura de 17 01 2013 nuevo atributo suggestionSize Software 4 3 Atributos del componente a adidos atributos l O Arquitectura de Software 16 04 2013 inputSize inputWidth e inputClass kk Ra ICM 3 de 22 iia Agencia de Te Inform tica y Comunicaciones de la Comunidad de Madrid ndice Framework Atlas Componente Lista de Valores 1 INTRODUCCI N oseeseesessesoesoesoosooseesessesoesoesoosossesoesossossossossossosoesoesossoesossossosresoossosossossossossossosoesoosoesosooesossosoeooeooesoesossossossoso 5 DA AUDIENCIA OBIETIVO eee 5 12 CONOCIMIENTOS PREVIOS ecos 5 2 MD AN oe estbenads 5 3 INSTALACI N Y CONFIGURACI N e ccoooconnconnconnnnnnonnnonnnonnnnnnonnnconacnnnonononnnonononnconaoonnonnonnnonnnone cone con non nonnnonn con aconacnnacnnnos 7 TS NINO O A e BR OONEIGURACI N nece neanmeceniaens 7 A O E 9 Ake CONSULTA oae ii idol A 9 4 1 1 Paso 1 Definici n de la consulta de la lista de valores ooooonnnnnnnnnnonnnnnonnnnnnnnnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnoss 9 4 1 2 Paso 2 Declaraci n en el bean de respaldo de la p gina de un objeto de tipo atlas componente bo Lista Valores E dao Lo VOL OU LS LL POCO OMR PO UU e E EU O A A A 9 4 1 3 Paso 3 Definici
26. total de registros El nombre de los par metros debe componerse de la siguiente manera y deben ser nicos en el fichero de propiedades queries properties queryCode nombreQuery SELECT CAMPO1 CAMPO2 FROM WHERE queryCode nombreQuery count SELECT COUNT 1 FROM WHERE El texto en color rojo es el identificador de la consulta Es el valor que es necesario poner en el atributo queryCode cuando se establece un elemento listaValores en la p gina por el cu l se puede seleccionar esta consulta cuando se inserta la etiqueta de este componente en un formulario Para el caso en que los datos no se deban obtener de una consulta sql el componente tiene un modo de funcionamiento en el que delega la obtenci n y el filtrado de los datos a unos m todos creados por el usuario del mismo modo que se hace en la lista paginada en este caso no es necesario crear las consulta en el fichero queries properties Este modo de funcionamiento se detalla en el siguiente apartado Ak RRK 8 de 22 ptr Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Lista de Valores 4 USO Una vez instalado el m dulo de componentes puede procederse a su utilizaci n El componente tiene dos posible or genes de datos e Obtenci n de los datos mediante una consulta SQL e Obtenci n de los datos mediante m todos externos En el primer caso el componente se encarga de gestionar el filtrado y la o
Download Pdf Manuals
Related Search