Manual de Usuario Componente de Calendario
Contents
1. n los festivos habilitados para el Municipio de Madrid Capital Y por otra parte los d as festivos podr n ser seleccionados por el usuario debido a que as se espec fica mediante el atributo festivosSeleccionables Manual de usuario Componente Calendario sous 13 05 2010 P gina 6 de 12 LS kk _ 11 RR Manual de usuario del Componente Calendario Fecha Proyecto Framework Atlas 08 feb 2010 En el siguiente ejemplo se presenta un calendario en el cu l no aparecer n los festivos de una manera destacada Fichero xhtml lt atlas calendario i id calendarioSinFestivos value t calendarioSampleBean fecha2 festivosHabilidatos false title bundle calendar fecha label bundle calendar fecha inputClass cajaTexto zindex 10 inputSize 8 gt Los atributos del componente son los siguientes Nombre atributo Obligatorio Descripci n id NO Identificador del componente boundaryDatesMode NO Modo de los l mites de las fechas Los posibles valores son inactive scroll select Por defecto es inactive buttonClass NO Clases de estilo del bot n Por defecto este campo esta vac o datePattern NO Patr n de Fecha para establecer el d a seleccionado como una cadena El valor por defecto es dd MM yyyy direction NO Define la direccion del calendario top left top right bottom left bottom right Default auto El valor2. por defecto es bottom right entidad NO Codigo de la entidad para la cual se van a mostar sus festivos Por defecto vac o festivoLocalClass NO Estilo de los d as festivos de la Localidad Seleccionada festivosHabilitados NO Booleano para especificar si en el calendario van a aparecer resaltados los d as festivos festivosSeleccionables NO Booleano que indica si los festivos son seleccionables por parte del usuario festivoStyleClass NO Estilo de los d as festivos de la Comunidad de Madrid Este estilo debe estar en el css de la aplicaci n inputClass NO Estilo caja de texto inputSize NO Tama o de la caja de texto donde se establece la fecha jointPoint NO Este atributo sirve para establecer la capa relativamente a la caja de texto donde se establece la fecha Los valores posibles son top left top right bottom left Por defecto bottom right auto label NO Titulo emergente informativo Manual de usuario Componente Calendario SA 13 05 2010 P gina 7 de z xk xk k jm RRK Manual de usuario del Componente Calendario Fecha tformistea y Cemusleazisnns Proyecto Framework Atlas 08 feb 2010 locale NO Identificador para la definici n de Locale Por defecto es el valor de definici n de Locale por defecto en el servidor localidad NO Atributo que indica el c digo de la localidad para mostrar sus festivos Por ejemplo 079 para M
3. ATLAS MANUAL DE USUARIO COMPONENTE DE CALENDARIO Versi n 1 0 rea de Integraci n y Arquitectura de Aplicaciones AAA xo a LEN Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid KRK Manual de usuario del Componente Calendario Fecha Proyecto Framework Atlas 08 feb 2010 Hoja de Control T tulo Manual de usuario del Componente Calendario Documento de Referencia Responsable Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio Versi n inicial del documento 08 02 2010 Manual de usuario Componente Calendario sos 13 05 2010 P gina 2 de 12 xk X xk RRK Manual de usuario del Componente Calendario Fecha tformisiea y Cemusitarisnns Proyecto Framework Atlas 08 feb 2010 ndice L INTRODUCCION cti 4 1 1 AUDIENCIA OBJETIVO oocccccconccnnonncncnnnonnncnnnnnnnnonnnncnnonnonccnnnnnnconnnnn E E E nn nr conan nn nr rana nn cnn NEEN OERE OROEN 4 12 CONOCIMIENTOS PREVIOS c occocoococonnnccnnononnnccconnncconanoncononncnconnnncononnnnconnnnnnr cone nncnnnnnnronnn rra ronnnnrnnnnnnnrrnnn rra ronna nac ESENS TESS 4 7 DESCRIPCION oia adi 4 3 INSTALACI N Y CONFIGURACI N sisnncacniamas nin a 5 3 1 INSTALACI N A jaca 5 32 CONFIGURACION cana dad 5 O A NN 6 4 1 PASO 1 DEFINICI N DEL ESPACIO DE NOMBRES DE ETIQUETAS DE ATLAS ccocooccccononcnnonnnncononncnccnnnncnconnnnonoonn
4. K Manual de usuario del Componente Calendario Fecha Proyecto Framework Atlas 08 feb 2010 4 4 RECOMENDACIONES Y BUENAS PR CTICAS Si se decide cambiar el tono de los colores del componente se recomienda que no sean colores fuertes para que cumpla la accesibilidad WCAG 4 5 EJEMPLO DE USO Se puede ver un ejemplo de dicho componente en la aplicaci n de demostraci n de componentes bajo la siguiente secuencia de navegaci n Inicio gt Formularios gt Calendario Manual de usuario Componente Calendario CEE 13 05 2010 P gina 10 de z kxk kk xk _ 11 E Manual de usuario del Componente Calendario Fecha C aforminica y Comusirartones Proyecto Framework Atlas 08 feb 2010 de la Comrarid 5 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 de los componentes del Framework Atlas Pregunta C mo se ha implementado el componente en su capa de presentaci n Respuesta Mediante un componente de Facelets Hace uso adem s de un componente de calendario de RichFaces 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 compone
5. adrid Capital Por defecto vac o mode NO Valores v lidos ajax o client El valor por defecto es ajax monthLabels NO Personalizaci n de las etiquetas de los meses Por defecto son Enero Febrero Marzo Abril Mayo Junio Julio Agosto Septiembre Octubre Noviembre Diciembre monthLabelsShort NO Personalizaci n de las etiquetas de los meses cuando aparecen en su formato corto Por defecto son Ene Feb Mar Abr May Jun Jul Ago Sep Oct Nov Dic popup NO Valor truelfalse para seleccionar si este componente se va a mostrar como un pop up Por defecto es true rendered NO Valor truelfalse para seleccionar si este componente se va a mostrar Por defecto es true showWeeksBar NO Booleano que determina si aparece la barra vertical de semanas title NO Titulo emergente informativo todayControlMode NO Indica la configuraci n del par metro Hoy value SI EL Expression Language que indica el atributo de backing bean donde se guardar la fecha que sea seleccionada weekDayLabelsShort NO Personalizaci n de las etiquetas de los d as Dom Lun Mar Mie Jue Vie Sab zindex NO Atributo similar al estadar HTML Puede indicar posicionamiento relativo del contenido Por defecto es 3 4 3 Paso 3 Creaci n del bean de respaldo Por otra parte es necesario crear una clase que consiste en un backing bean don
6. de se recibir el valor que ha sido seleccionado por el usuario A continuaci n se muestra un ejemplo de dicha clase CalendarioSampleBean java package atlas samples bean The Class CalendarioSampleBean ad public class CalendarioSampleBean private Date fechal private Date fecha2 Manual de usuario Componente Calendario ER 13 05 2010 P gina 8 de z xk xk k jm Manual de usuario del Componente Calendario Fecha afomminiea y Comuatencanos Proyecto Framework Atlas 08 feb 2010 public Date getFechal return fechal public void setFechal Date fecha this fechal fecha public Date getFecha2 return fecha2 public void setFechal Date fecha this fecha2 fecha Es necesario tambi n configurar dicho bean en el fichero de configuraci n de JSF en web src main webapp WEB INF faces managed beans xml Un ejemplo de configuraci n podr a ser la siguiente faces managed beans xml lt managed bean gt lt description gt Bean de respaldo de calendarios lt description gt lt managed bean name gt calendarioSampleBean lt managed bean name gt lt managed bean class gt atlas samples bean CalendarioSampleBean lt managed bean class gt lt managed bean scope gt request lt managed bean scope gt lt managed bean gt Manual de usuario Componente Calendario sus 13 05 2010 P gina 9 de 12 pu CM RR
7. ilo correspondiente a este tipo de d as Este estilo puede ser configurado en la hoja de estilos o Los d as festivos de una poblaci n pasando un identificador como par metro al componente aparecer n distinguidos por un estilo correspondiente Este estilo puede ser configurado en la hoja de estilos o El componente tiene un par metro para elegir si los d as festivos pueden ser seleccionados o no Fecha sin festivos Fecha con festivos i Localidad s Seleccionables 3 INSTALACI N Y CONFIGURACI N En este apartado se incluye informaci n sobre la instalaci n y la configuraci n del componente Calendario 3 1 INSTALACI N El componente del calendario 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 Este componente no requiere configuraci n adicional Manual de usuario Componente Calendario sos 13 05 2010 P gina 5 de 12 RK CM RR Manual de usuario del Componente Calendario Fecha C slormancay Comusicsricoss Proyecto Framework Atlas 08 feb 2010 de la Comaridad de Madrid 4 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 4 1 Paso 1 Definici n del espacio de nombres de etiquetas de Atlas Es necesario c
8. las 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 Facelets 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 introducir un dato de tipo fecha en un formulario Se basa en el componente de calendario del API RichFaces con funcionalidad a adida para la presentaci n de festivos de la Comunidad de Madrid El componente tiene las siguientes caracter sticas e Enlace para seleccionar el d a de hoy o Si el usuario pulsa sobre el enlace Hoy entonces se seleccionar el d a actual como valor del campo de tipo fecha e El usuario podr pulsar sobre uno de los d as que se presentan El d a seleccionado aparecer en la caja de texto correspondiente e D as festivos o El componente tiene una opci n para que se distingan los d as festivos del resto de los d as Manual de usuario Componente Calendario A 13 05 2010 P gina 4 de z xk xk k jm RRK Manual de usuario del Componente Calendario Fecha afennisiea y Carmusicezianss Proyecto Framework Atlas 08 feb 2010 o Los d as festivos de la Comunidad de Madrid aparecer n distinguidos por un est
9. nnccnnnnnnnonnnnoss 6 4 2 PASO 2 INSERCI N EN LA P GINA DE LA ETIQUETA DE ATLAS ccccoocccooncnonnnoonnconnnnonnnccnnnconnnrcnnnnonnncrnnnnonnnrcnnnnonn nr cnnanonnanonns 6 4 3 PASO 3 CREACI N DEL BEAN DE RESPALDO coin oceaan a a a as a aa e aaeain iiae aseara 8 4 4 RECOMENDACIONES Y BUENAS PR CTICAS cocooococonononiononcocononononncnconononcnnnncocononenennnncoonnnnnnnn nn cenanenenn arca canancnna 10 43 EJEMPLODE USO vrecia a E O A E E E 10 5 PREGUNTAS M S FRECUENTES sss essesseeeesseeeeseesssesoeeceoosscessesccressecssescesssscrssescesssscossescrsssscrsssscrsssecrsseetosseecrsseeersse 11 6 ENLACES RELACIONADOS cnsocooniccososioniconisioioevan esca a reinos ianO daa reses ONES OV OSV nOs e CIU ESKES IN coca nenes cnc cre LIN Acsn aida caaran deci Tirns 12 eS Componente Calendario P gina 3de z LS xk k _ ij RE Manual de usuario del Componente Calendario Fecha C aferminiea y Comusiesciones Proyecto Framework Atlas 08 feb 2010 Contenido 1 INTRODUCCI N Este documento contiene el manual de uso del componente visual Calendario del Framework Atlas 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 At
10. nte Manual de usuario Componente Calendario A 13 05 2010 P gina 11 de z kxk kk xk _ 11 KE Manual de usuario del Componente Calendario Fecha san Proyecto Framework Atlas 08 feb 2010 6 ENLACES RELACIONADOS Producto URL Versi n Ajax4JSF http www jboss org jbossrichfaces 3 1 4 GA Commons BeanUtils commons apache orqg beanutils 1 7 0 Commons Configurations http commons apache org configuration 1 3 Facelets https facelets dev java net 1 1 11 Hibernate http www hibernate org 3 2 6 ga Hibernate Annotations http www hibernate org hib_docs annotations reference en html_single 3 3 0 ga JAXB http java sun com webservices jaxb 2 1 JPA http java sun com developer technicalArticles J2EE pa 1 0 JSF http java sun com javaee javaserverfaces 1 1 JSFUnit http www boss org jsfunit 1 0 0 Beta3 MyFaces Core http myfaces apache orqg 1 1 5 RichFaces http www jboss org jbossrichfaces 3 1 4 GA Spring http www springframework org 2 5 5 Tomahawk http myfaces apache org tomahawk 1 1 6 Manual de usuario Componente Calendario 13 05 2010 P gina 12 de 12 Xx k kk xk jm
11. rear 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 Fichero xhtml lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE html PUBLIC W3C DTD XHTML 1 0 Transitional EN http www w3 org TR xhtml1 DITD xhtml1 transitional dtd gt lt html xmlns http www w3 org 1999 xhtml xml lang es xmlns ui http java sun com 3jsf facelets xmlns h http java sun com 3jsf html xmlns f http java sun com 3jsf core xmlns atlas http atlas core componentes j3sf gt 4 2 Paso 2 Inserci n en la p gina de la etiqueta de Atlas Es necesario insertar la etiqueta en la p gina Un ejemplo para un calendario con festivos habilitados es el siguiente Fichero xhtml lt atlas calendario id calendarioFestivos value t calendarioSampleBean fechal festivosHabilidatos true festivosSeleccionables true localidad 79 festivoStyleClass festivosCAM festivolocalClass festivosLocal title bundle calendar fecha label bundle calendar fecha inputClass cajaTexto zindex 10 inputSize 8 gt En este ejemplo se establece en el formulario un calendario en el que aparecen los festivos habilitados Con lo cu l aparecer n los festivos habilitados de la Comunidad de Madrid Adem s como el atributo localidad es 79 entonces aparecer n tambi
Download Pdf Manuals
Related Search