COMPONENTES COMUNES (T46BB)

Transcripción

1 COMPONENTES COMUNES (T46BB) Fecha: 01/12/2007 Referencia: EJIE S.A. Mediterráneo, 3 Tel * Fax Vitoria-Gasteiz Posta-kutxatila / Apartado: Vitoria-Gasteiz Este documento es propiedad de EJIE, S.A. y su contenido es confidencial. Este documento no puede ser reproducido, en su totalidad o parcialmente, ni mostrado a otros, ni utilizado para otros propósitos que los que han originado su entrega, sin el previo permiso escrito de EJIE, 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. EJIE, S.A. no podrá ser considerada responsable de eventuales errores u omisiones en la edición del documento.

2 Control de documentación Título de documento: COMPONENTES COMUNES (T46BB). Código: Versión: 1.0 Fecha: 01/12/2007 Resumen de cambios: Histórico de versiones Cambios producidos desde la última versión Primera versión. Utilidad para el parseo de las fechas al exportar a fichero Componente común de tipos de interesado Componente WebDav-Almacén de Documentos Incluir subsección en la búsqueda de sección procedimiento y en el censo identificativo. Responsable: Aprobado por: Control de difusión Firma: Fecha: Distribución: Referencias de archivo Autor: mbre archivo: Antonio Gallego Eneko Sagredo NB29_ARQ_Componente Comunes.doc

3 Contenido Capítulo/sección Página 1 Introducción Nuevos elementos A tener en cuenta Componentes de búsqueda Estructura del componente Creación de los componentes tag tld class xml properties oi mapas errores js 11 2 Componente Búsqueda (código+descripción) Búsqueda genérica Actividades Actos notificados Agrupaciones Áreas 19 NB29_ARQ_Componente Comunes ii/109

4 2.6 Buzón Calle Catálogo Censos Departamento Direcciones Estados Estructura orgánicas Estructura orgánica completa Familia Forma de envío Hitos Hitos de pasos Lista de secciones Localidad Motivo Municipio Naturaleza Organismo País Portal Procedimiento Provincia Tipo de participaciones Tipo de participaciones EAV Responsable / Instructos 43 NB29_ARQ_Componente Comunes iii/109

5 2.32 Sección - Procedimiento Sección Series Servicio Subfamilia Subsección Terceros del procedimiento Tercero de la EAV Tipo de pasos Tipologías Tipologías de pasos Unidad orgánica Categoría Censo identificativo Unidad orgánica Tipos de interesado 57 3 Procedimiento Procedimiento (un campo código) Procedimiento (dos campos códigos) Procedimiento (sección + ruta) 60 4 Dirección Componente Dirección Componente Dirección Nacional Componente Dirección Extranjera Componente Dirección Contacto 64 5 Persona 65 NB29_ARQ_Componente Comunes iv/109

6 6 Persona + Dirección 67 7 Subida de Archivos 70 8 Almacén de Documentos 71 9 Tipo de Tercero Documentos Búsqueda de Documentos Descarga de Documentos de platea Generación de Documentos Guardar Documentos Exportar resultados Exportar a excel Exportar a PDF Utilidad 83 fechas 10.6 Tipo / Subtipo Documentos Tab Desplegable Combo Botón Trabajos Habituales / Recientes Seguridad Simulación de Xlnets Validator Validator-rules-componentes.xml Validación 102 t46bbarraystringobligatorio NB29_ARQ_Componente Comunes v/109

7 Validación Validación Validación Validación 102 obligatoriosi fechaintervalo documentovalido documentovalidosi NB29_ARQ_Componente Comunes vi/109

8 1 Introducción. Este documento pretende ser un guía de cómo incluir y configurar los diferentes componentes comunes identificados en el SGI y que se utilizan en el desarrollo de las aplicaciones que componen la capa de presentación. Hasta el momento los componentes comunes eran configurados en cada una de las aplicaciones y muchas veces accedían al negocio de forma distinta en cada implementación que se hacía. Con este nuevo modelo de componentes se pretende que cada uno de ellos funcione siempre de la misma manera esté en la aplicación que esté. Además, se minimiza considerablemente el tiempo dedicado al desarrollo de modificaciones y adaptaciones, ya que bastaría con cambiar el propio componente y desplegar la aplicación que los alberga, y no habría que modificar ni redeseplegar el resto de aplicaciones usuarias del mismo. El objetivo principal y primordial del diseño de los componentes comunes es facilitar y unificar el desarrollo de rutinas ampliamente reutilizadas en el conjunto de las aplicaciones que componen el Sistema General de Industria. 1.1 Nuevos elementos Estos nuevos componentes estarán desplegados en la aplicación t46bb-componentes Comunes, con lo que su configuración y funcionamiento varía un poco de lo que tenemos actualmente. Para que la nueva configuración funcione correctamente tendremos que tener en nuestra aplicación los siguientes elementos: - t46bb-***.tld, en el directorio /WEB-INF/tld de cada aplicación WAR que tengamos. - t46bbcomponentes***.jar, en el directorio lib de cada aplicación WAR que tengamos. - Archivos de recursos, en el directorio html/datos. Estos archivos son: o o o t46bbrecursos_es.properties t46bbrecursos_eu.properties t46bbrecursos_en.properties Además, en los PCs de desarrollo, tendremos que tener: - La aplicación t46bb desplegada en nuestro servidor weblogic (t46bb.ear) - Los archivos de configuración de la aplicación t46bb (/config/t46bb) - La aplicación de contenidos estáticos para los componentes comunes (/aplic/xxx/html/sgi_comun) NOTA: Todos los archivos están disponibles en N:\Grupo_Migración_B29\CSI\t46bb-Componentes Comunes., salvo el contenido estático que se encontrará en el SVN correspondiente. NB29_ARQ_Componente Comunes 1/109

9 1.2 A tener en cuenta Antes de entrar a detallar la lista de todos los componentes comunes desarrollados, tendremos que tener en cuenta una serie de cambios comunes a todos ellos y que deberemos implementar para el correcto funcionamiento de los propios componentes. Además, de los elementos explicados en el punto anterior: Incluiremos en las plantillas de cada aplicación, los archivos javascript comunes que necesitemos. La forma de incluir estos archivos será la siguiente: String jspath = Q70ListenerUtils.getApplicationResourceURI("PREFIJO_URL_ESTATICO_RECURSOS"," ALIAS_ESTATICO_RECURSOS")+"/scripts"; <script src="<%=jspath%>/mostrarocultar.js" type="text/javascript"></script> <script src="<%=jspath%>/navnew.js" type="text/javascript"></script> <script src="<%=jspath%>/eventotecladoraton.js" type="text/javascript"></script> <script src="<%=jspath%>/ventanabusqueda.js" type="text/javascript"></script> PREFIJO_URL_ESTATICO_RECURSOS y ALIAS_ESTATICO_RECURSOS son dos propiedades que tendremos que tener incluidas en el archivo.properties correspondiente a la aplicación. 1.3 Componentes de búsqueda Los componentes son un elemento de búsqueda para devolver un registro de un maestro o de otro sistema. rmalmente, la búsqueda devolverá a la pantalla un código y una descripción (aunque existen varias excepciones que devuelve más información) Ante todo, son elementos visuales, es decir, una vez se pone el tag en el formulario, éste a través de la clase java que define el componente, pinta el código HTML necesario para su visualización. Así, como las llamadas a las funciones javascript para que se abra una ventana o retorne datos, es decir, en el caso de que el formulario de datos tenga valores para esos campos, el componente los pintará en su campo. En caso contrario, los mostrará vacíos. Estas funciones javascript están definidas en un archivo js del contenido estático común. Es importante tener en cuenta que el componente no hace ninguna validación. Los componentes suelen dividirse en campo código (que puede mostrarse o estar oculto), un campo descripción y una imagen lupa. Cada uno de ellos tiene eventos javascript asociados. NB29_ARQ_Componente Comunes 2/109

10 El campo código y la lupa lanzan el evento de abrir ventana. A la hora de seleccionar los elementos de la lista, existe una diferencia entre ambas. Y es que el campo código lo hace de forma oculta seleccionando el único registro obtenido (en caso de haber más de uno, no recupera ninguno), mientras que, cuando se pulsa la lupa, se visualiza la ventana de selección con todos los registros. rmalmente, esta llamada llama a la misma acción definida en un strut, mandando pintar un jsp con los resultados. Más adelante se explicará con más detalle este proceso. El campo descripción suele tener un evento que comprueba si es vacío. En dicho caso, manda borrar el campo código. Se ofrece, además, la posibilidad de mandar ejecutar alguna acción adicional. Los componentes, normalmente, suelen pintar su propia capa li. En el caso que se tengan que desarrollar nuevos elementos, se tendrá que tener en cuenta esos estilos para que su tamaño sea similar al resto de componentes salvo que se diga o se modifique los tags para pasar sus propios estilos. 1.4 Estructura del componente Todas las plantillas de las aplicaciones utilizan el componente t46bbcomunes:mostrarcapacargar. Este componente se encarga de pintar una serie de capas y, dentro de ella, un iframe. El nombre es i más el nombre de la propiedad del campo código. Pe.: si un componente tiene como nombre de propiedad provinciacod, se crea un iframe con nombre iprovinciacod. Como he comentado anteriormente, el campo código y la lupa invocan a la misma función javascript (en la mayoría de los casos es abrirventanabusqueda). Esta función lo que hace es buscar el nombre del iframe en el que se encuentra el componente y enviar por la request a la acción definida los valores y nombres de los campos para realizar la búsqueda. En este punto, el control pasa a la aplicación t46bb (salvo en los casos de componentes propios que seguirán estando en la misma aplicación, en cualquier caso el tratamiento es el mismo) La aplicación invocada lee de la request los valores de los campos por los que se quiere filtrar (estos pueden ser vacíos, o tener valores de los cuales dependen para la búsqueda como, por ejemplo, para buscar municipios necesitas el código de provincia, esto es lo que se denomina padre). Una vez realizada la búsqueda, con los resultados obtenidos se redirige la acción a mostrar un tiles (éste puede estar oculto, en el caso de mandarse a través del código o en una ventana emergente, en el caso de haberse mandado a través de la lupa. Esta nueva ventana es hija de la anterior) Este tiles tendrá las funciones js necesarias para devolver los datos a la ventana padre. Esto es debido a que en la llamada hemos pasado por la request los ids de los campos a los que hay que devolver los valores, así como el nombre del iframe y la capa que se ha levantado para que se mande ocultar o borrar el contenido. Adicionalmente, los componentes pueden lanzar un evento adicional (como para borrar otros campos o mostrar una capa ). Este evento se ejecuta al final de todo y estará definido en la ventana padre, nunca en la hija. Resumiendo, un jsp hace una llamada a una aplicación para que devuelva los datos. Para ello, se hace una llamada javascript para que el iframe del componente llame a la acción definida en la aplicación. NB29_ARQ_Componente Comunes 3/109

11 En esta aplicación, se recuperarán los valores de los campos y pondrá en una variable de contexto el resultado. Finalmente, se llamará a un jsp que mostrará los resultados. Dependiendo de la manera de visualización (es decir, si éste se ha llamado por la lupa o por el campo código), puede invocar a una función javascript automáticamente o esperar a que se seleccione un registro a través del radio o del botón aceptar. Esta función definida en este último jsp utiliza los nombres de los campos para asignar los valores de retorno, cerrando la ventana emergente e invocando a la función padre definida en el evento adicional, en caso de existir. Explicación gráfica de todo lo anterior: Componente búsqueda Al pulsar la lupa o tabular en el código con un valor Función javascript. Se concatena los valores para la búsqueda y se llama usando el iframe asociado A través del iframe, se llama a la acción definida en la ruta Pone los valores en el componente Función javascript Devuelve el primer registro automaticamente Es una ventana emergente? Jsp Se pinta el resultado de la busqueda Una vez realizada la acción, se redirige a un tiles Si Clase java Se recupera de la request los valores y se asocian al contexto para la búsqueda Función javascript Devuelve el registro al pulsar aceptar o doble click en el radio 1.5 Creación de los componentes Un resumen de los pasos para la creación de un componente se puede ver en la siguiente tabla: tag tld class xml properties OI Mapas errores JS Prueba Tag Clase java encargada de pintar el componente. Esta clase se distribuye a las aplicaciones dentro de un jar NB29_ARQ_Componente Comunes 4/109

12 Tld Archivo donde se definen los atributos que tendrá la clase (tag) y que, a la hora de poner en el jsp, tendrán que pasarse con valor en caso se ser obligatorio. Class Clase java encargada de realizar la operación de búsqueda. Xml Struct donde se encuentra la acción que invoca la clase (tag) para realizar la búsqueda y que utiliza la clase (class) para obtener los valores. Properties Fichero de recurso donde se encuentra el nombre que se mostrará en la cabecera de la tabla. OI Archivo configuracionoi.xml donde se encuentra definida la operación interna que utiliza la clase (class) y que está definida en el parámetro parameter del struts (xml). Mapas Archivo mapasaplicacion.xml donde se encuentran definidos los parámetros de invocación. Errores Fichero de recursos de errores con el valor oierrorkey definido en OI. JS Crear funciones javascript para la llamada y retorno de los datos. Prueba Realizar una prueba del componente. A continuación, se explica con ejemplos el componente forma de envío: tag Todo el código está en la clase T46bbBusquedaFormaEnvioTag. /** Variable en la que se guarda el nombre del servicio que realizará la busqueda en la nueva ventana. */ private String nombreservicio ="/t46bbcomponenteswar/busquedajsp/t46bbmaestroformaenvio.do?aplicacionext="; tld Este puede ser un ejemplo del tld de un componente: <tag> <name>busquedaformaenvio</name> <tagclass>com.ejie.t46bb.componentes.tags.busqueda.t46bbbusquedaformaenviotag</tagclass> <bodycontent>empty</bodycontent> <attribute> <name>propertycodigo</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> NB29_ARQ_Componente Comunes 5/109

13 <name>propertydescripcion</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>estiloclass</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>name</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>soloconsulta</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>propertycondicion</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>eventoadicionales</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>mostrarbaja</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> class Clase que se ejecuta al llamar al componente: NB29_ARQ_Componente Comunes 6/109

14 public class T46bbMaestroFormaEnvio extends Q70ActionOIDeclarativo { protected void processop(q70contextoejie contexto, ActionErrors errors, ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { contexto.set("listaxml", ""); if (T46bbMaestroFormaEnvio.log.isDebugEnabled()){ } T46bbMaestroFormaEnvio.log.debug(" T46bbMaestroFormaEnvio OP"); String idioma = contexto.get("idiomacompartido").tostring(); String campocod = ""; String campodes = ""; //comparamos si estoy buscando por código o por descripción String iframe =(String)request.getParameter("mostrarLista"); if("true".equals(iframe)){ } if(request.getparameter("campodes")!=null){ } else{ } campodes=request.getparameter("campodes").tostring(); if(request.getparameter("campocod")!=null){ } campocod=request.getparameter("campocod").tostring(); String altalog = "false"; if(request.getparameter("mostrarbaja")!=null){ } if("true".equals(request.getparameter("mostrarbaja"))){ } else{ } else{ } contexto.set("alta",boolean.false); contexto.set("alta",boolean.true); altalog="true"; contexto.set("alta",boolean.true); altalog="true"; contexto.set("idjerarq1", request.getparameter("condiccion1")); contexto.set("idjerarq2", ""); NB29_ARQ_Componente Comunes 7/109

15 contexto.set("idjerarq3", ""); contexto.set("codigo", campocod); contexto.set("texto", campodes); request.setattribute("simulacionparamname", "listaxml"); Properties propiedades = Q70GestorMensajesi18n.getSingleton().getProperties("t46bbRecursos",idioma); String titulo = request.getparameter("titulo").tostring(); contexto.set("titulotabla", propiedades.getproperty(titulo)); if(t46bbmaestroformaenvio.log.isdebugenabled()){ T46bbMaestroFormaEnvio.log.debug("Estos son los parametros que recibimos para la busqueda:\n" +"codigo: "+campocod+"\n"+"texto: "+campodes+"\nidjerarq1: "+(String)request.getParameter("condiccion1")+"\nidJerarq2: \nidjerarq3: \nalta: " + altalog+"\n"); } } T46bbMaestroFormaEnvio.log.debug("idJerarq1: "+(String)request.getParameter("condiccion1")+"\n"); T46bbMaestroFormaEnvio.log.debug("idJerarq2: \n"); T46bbMaestroFormaEnvio.log.debug("idJerarq3: \n"); super.processop(contexto, errors, mapping, form, request, response); protected ActionForward processforward(q70contextoejie contexto, ActionErrors errors, ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { if (T46bbMaestroFormaEnvio.log.isDebugEnabled()){ T46bbMaestroFormaEnvio.log.debug(" Obtenida ListaXml de T46bbMaestroFormaEncio " +contexto.get("listaxml")); String idioma = contexto.get("idiomacompartido").tostring().tolowercase(); if(contexto.get("listaxml")==null contexto.get("listaxml").equals("")){ contexto.set("listaarray", new ArrayList()); }else{ contexto.set("listaarray",t46bbcargamaestros.getregistros((string)contexto.get("listaxml"), idioma, false)); } contexto.set("listaxml", ""); return mapping.findforward("ok"); } } xml Acciones del struts: <!-- Maestro de forma de envio --> NB29_ARQ_Componente Comunes 8/109

16 <action path="/t46bbmaestroformaenvio" type="com.ejie.t46bb.componentes.operacionesinternas.comunicados.t46bbinstanciarseguridadcomunicados" name="formbusqueda" scope="request"> <forward name="ok" path="/t46bbrecuperarseguridadformaenvio.do"/> <forward name="continuar" path="/t46bbrecuperarformaenvioactuales.do"/> <forward name="error" path="/t46bbrecuperarseguridadformaenvio.do"/> </action> <action path="/t46bbrecuperarseguridadformaenvio" parameter="recuperarseguridad" type="com.ejie.t46bb.componentes.operacionesinternas.comunicados.t46bbestablecerseguridad"> <forward name="ok" path="/t46bbrecuperarformaenvioactuales.do"/> <forward name="error" path="/t46bbrecuperarformaenvioactuales.do"/> </action> <action path="/t46bbrecuperarformaenvioactuales" parameter="buscardatoscatalogoformasenviooi" type="com.ejie.t46bb.componentes.operacionesinternas.t46bbmaestroformaenvio"> <forward name="ok" path="/t46bbresultado.do"/> <forward name="error" path="/t46bbresultado.do"/> </action> <!-- LLAMADA AL SERVLET PARA MOSTRAR LA BUSQUEDA --> <action path="/t46bbresultado" forward="mostrartabla"/> Se puede observar que hasta que se muestre la pantalla del tiles (mostrartabla) se han definido tres acciones. - La primera es la que está definida en el tag (t46bbmaestroformaenvio). Esta acción utiliza la clase T46bbInsatanciarSeguridadComunicados que es común en toda la aplicación de comunes y es la que asigna el código de la aplicación que está invocando al componente para que se instancie la seguridad con ese código y no con la de la aplicación de comunes (t46bb). - La segunda clase (t46bbrecuperarseguridadformaenvio) utiliza una clase que también es común. Y es la que se encarga de recuperar el b29seguridad de la aplicación invocante. A ésta sólo se le invoca si, en la primera acción, se ha salido por la opción continuar. - La tercera clase es la que tiene definida la operación interna que llama al negocio y suele ser la encargada de recuperar los valores de la request para hacer la llamada y transformar la entidad resultante a un arraylist de HashMap que utiliza el jsp de resultado. Por ejemplo, la aplicación invocante puede ser el sistema de salidas que es la que tiene definido en un jsp la llamada al tag. NB29_ARQ_Componente Comunes 9/109

17 <t46bbbusquedas:busquedaformaenvio name="formbusqueda" propertydescripcion="des1" soloconsulta="false" propertycodigo="cod1" estiloclass="width20" propertycondicion="cod" /> Mientras que la aplicación invocada es la t46bb que es la que tiene definida la acción en su struts. Así, en el caso de ser necesario obtener el b29seguridad, (2ª clase) se obtendrá el de la t46kb y no el de la t46bb properties tabla.formaenvio = Forma envio tabla.modoenvio = Modo envio oi <estructura name="buscardatoscatalogoformasenviooi"> <propiedad name="oiclase" value="com.ejie.t46bb.componentes.excepciones.t46bbadaptadorexcepcionesnegocio"></propiedad> <propiedad name="fimbre" value="ejb.t49cbcatmaestrosconsulta"></propiedad> <propiedad name="fimetodo" value="buscardatoscatalogoformasenvio"></propiedad> <propiedad name="fimapainvocacion" value="buscardatoscatalogomapai"></propiedad> <propiedad name="fimaparetorno" value="resultadomapar"></propiedad> <propiedad name="oierrorkey" value="error.oi.buscardatoscatalogosubfamilias"></propiedad> <propiedad name="fiinitialcontextfactory" value="$$$oi_initial_context$$$"></propiedad> <propiedad name="fiproviderurl" value="$$$oi_provider_tramitaciones_url$$$"></propiedad> </estructura> mapas <mapa nombre="buscardatoscatalogomapai"> <mapa ref="mapaseguridad"/> <mapa ref="mapacodigo"/> <mapa ref="mapatexto"/> <mapa ref="mapaidjerarq1"/> <mapa ref="mapaidjerarq2"/> NB29_ARQ_Componente Comunes 10/109

18 <mapa ref="mapaidjerarq3"/> <mapa ref="mapaalta"/> </mapa> <mapa nombre="mapaseguridad" tipoargumento="java.lang.string" nombreargumento="b29seguridad"/> <mapa nombre="mapaidjerarq1" tipoargumento="java.lang.string" nombreargumento="idjerarq1"/> <mapa nombre="mapaidjerarq2" tipoargumento="java.lang.string" nombreargumento="idjerarq2"/> <mapa nombre="mapaidjerarq3" tipoargumento="java.lang.string" nombreargumento="idjerarq3"/> <mapa nombre="mapacodigo" tipoargumento="java.lang.string" nombreargumento="codigo"/> <mapa nombre="mapatexto" tipoargumento="java.lang.string" nombreargumento="texto"/> <mapa nombre="mapaalta" tipoargumento="java.lang.boolean" nombreargumento="alta"/> <mapa nombre="resultadomapar" nombredestinoencontexto="listaxml"/> errores error.oi.buscardatoscatalogoformasenvio = Se ha producido un error al tratar de recuperar las formas de envio js function abrirventanabusqueda( pagina, ancho, alto, izqda, arriba, idcampodes, idcampocod, idcampopadre, idcampopadre1, idcampopadre2, mostrarlista, idcampohijocod, idcampohijodes, nombrepadre,enteros){ var que_navegador = detectbrowser(); var nombrehiddenframecarga = document.getelementbyid("nombreiframebloqueo").value; var nombreframecarga = "iframei"+nombrehiddenframecarga; var nombretitulocarga = "boxb"+nombreframecarga; var nombrecapacarga = "capai"+nombrehiddenframecarga +"Deshabilitada"; var campocod = window.document.getelementbyid(idcampocod); var campodes = window.document.getelementbyid(idcampodes); var campohijocod=null; var campohijodes=null; var iex = false; var forzar = false; if(que_navegador == "ie"){ } iex = true; NB29_ARQ_Componente Comunes 11/109

19 if(idcampohijocod!= null && idcampohijocod!=""){ } campohijocod = window.document.getelementbyid(idcampohijocod); if(idcampohijodes!= null && idcampohijodes!=""){ } var var var var campohijodes = window.document.getelementbyid(idcampohijodes); anchoventana=ancho; altoventana=alto; izqdaventana=izqda; arribaventana=arriba; if(mostrarlista!= null && mostrarlista!="true"){ } anchoventana="0"; altoventana="0"; izqdaventana="0"; arribaventana="0"; var evento = recuperarevento(pagina); var continuar = false; var paginaenvio = definirrutapagina( pagina, anchoventana, altoventana, izqdaventana, arribaventana, idcampodes, idcampocod, idcampopadre, idcampopadre1, idcampopadre2, mostrarlista, idcampohijocod, idcampohijodes, nombrepadre,iex,enteros,false); var opciones = cadenaopciones(anchoventana, altoventana, izqdaventana, arribaventana,"auto",false); var errorpadre = comprobarpaginaerror( idcampopadre, idcampopadre1, idcampopadre2, nombrepadre,false); var buscar = "true"; if(mostrarlista!= null && mostrarlista!="true"){ buscar = "false"; if(campocod.value == ""){ } campodes.value = ""; if(campohijocod!= null){ } else{ modificarhijos(idcampohijocod,idcampohijodes); continuar = true; var nombreframe = "i"+idcampocod; if(!errorpadre){ if(iex){ } else{ document.frames(nombreframe).location.replace(paginaenvio); var eliframe = eval(document.getelementbyid(nombreframe)); eliframe.contentdocument.location.replace(paginaenvio); NB29_ARQ_Componente Comunes 12/109

20 } campoerroneo(idcampodes,false); modificarhijos(idcampohijocod,idcampohijodes); if(""!= evento){ eval(evento); } } else{ continuar = false; } } } else{ continuar = true; if(errorpadre){ anchoventana = "350" altoventana = "90" } if(document.getelementbyid(nombrecapacarga)!= null){ mostrarventanacapa(nombrecapacarga,nombretitulocarga,nombreframecarga,anchoventana,altoventana,izqdaventana,arribaventan a,paginaenvio,iex,idcampodes,forzar); } } } else{ } if(iex){ } var retorno = window.showmodaldialog(paginaenvio,"","\""+opciones+"\"",""); if ( retorno!= null ){ } } else{ campocod.value = retorno[0]; campodes.value = retorno[1]; campocorrecto(idcampodes,true); valoresmodificados(); var retorno = window.open(paginaenvio,"","\""+opciones+"\"",""); NB29_ARQ_Componente Comunes 13/109

21 2 Componente Búsqueda (código+descripción). El componente búsqueda se compone, en la mayoría de los casos, de dos campos de texto (código y descripción) y un icono lupa que permite realizar la búsqueda. El funcionamiento del mismo permite que, si el usuario conoce el código del elemento, lo introduzca en el campo código y aparezca directamente en el campo descripción el texto descriptivo del mismo si existiese. En el caso de que el usuario desee realizar una búsqueda por la descripción, podrá introducir en el campo el texto, o parte del mismo, y pulsando sobre la lupa aparecerá una ventana en la que se listarán los resultados coincidentes. Este funcionamiento es el mismo que en el caso que el usuario no introduzca ni código ni descripción. Todos estos componentes tendrán el mismo aspecto visual que el siguiente ejemplo: A tener en cuenta a la hora del diseño de la pantalla. Estos componentes dibujan un bloque <li class="dos"> de la hoja de estilos dos columnas. Un ejemplo de utilización sería el siguiente: <li class="uno"><html:message key="visor.familia"/>:</li> <t46bb:busquedafamilia name="formbusquedaexpedientes" mostrarcodigo="true" propertycodigo="familiacod" propertydescripcion="familiades" soloconsulta="false"/> A continuación se especifican los componentes de este tipo y la línea de código que habrá que introducir para incorporarlos a las pantallas de las aplicaciones de presentación que lo utilicen. Lista de parámetros y su descripción: name: mbre del form-bean asociado. mostrarcodigo: (true/false) si se quiere mostrar el campo código. propertycodigo: nombre de la property del form-bean donde se recogerá el valor para el código. propertydescripcion: nombre de la property del form-bean donde se recogerá el valor para la descripción. soloconsulta: (true/false) si el elemento es de solo consulta. propertycondicion: nombre del propertycodigo del cual depende. propertycondicion1: nombre de otro propertycodigo del cual depende. propertycondicion2: nombre de otro propertycodigo del cual depende. Aquellos campos que aparezcan subrayados serán obligatorios (name). El resto son opcionales. NB29_ARQ_Componente Comunes 14/109

22 2.1 Búsqueda genérica Realiza la búsqueda y selección de los elementos definidos en la acción. Esta acción no es común y esta definida en el strut de esa aplicación <t46bbbusquedas:busqueda conboton="" mostrarcodigo="" name="" nombreservicio="" propertycodigo="" propertydescripcion="" soloconsulta="" altboton="" altoventana="" anchoventana="" classcod="" classdes="" classsincod="" descripcioneditable="" escodigonumero="" eventoadicionales="" largocodigo="" largodescripcion="" mostrarbaja="" nombrepadre="" propertycondicion="" propertycondicion1="" propertycondicion2="" propertyhijocod="" propertyhijodes="" recursos="" titulo=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo conboton nombreservicio soloconsulta escodigonumero titulo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si se tiene que mostrar la imagen de la lupa para acceder a la búsqueda. Los valores posibles son true o false mbre de la acción del struct que se encargara de realizar la llamada a negocio para recuperar los valores a mostrar en el idioma correspondiente Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si el código es numérico o no. Los valores posibles son true o false. Sólo es obligatorio cuando se utilizan tablas de códigos. Título para la ventan de búsqueda. Deberá ser una etiqueta del fichero de propiedades para que admita multi- NB29_ARQ_Componente Comunes 15/109

23 mbre Descripción Obligatorio idioma. recursos mbre del fichero de propiedades para el multi-idioma del Tag. Si no se especica se asume el de la página donde está el tag búsqueda. largocodigo Indica la longitud máxima que tendrá el campo código largodescripcion Indica la longitud máxima que tendrá el campo descripción classcod Indica el estilo asociado al campo código classdes Indica el estilo asociado al campo descripción classsincod altoventana anchoventana Indica el estilo asociado al campo descripción en el caso de no mostrarse el campo código Altura de la ventana que se abrirá con el listado de búsqueda. El valor por defecto es 400. Anchura de la ventana que se abrirá con el listado de búsqueda. El valor por defecto es 250. descripcioneditable Indica si la descripción no puede editarse para realizar búsquedas filtradas por descripción. Los valores posibles son true o false mostrarbaja eventoadicionales altboton imagenboton nombrepadre propertyhijocod propertyhijodes propertycondicion Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Propiedad del fichero.properties correspondiente para la burbuja de texto de la imagen de búsqueda. Imagen que se utilizará como botón de búsqueda. Por defecto se utiliza el fichero images/lupa.gif Título del elemento del que depende la búsqueda. Deberá ser una etiqueta del fichero de propiedades para que admita multi-idioma. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada NB29_ARQ_Componente Comunes 16/109

24 mbre Descripción Obligatorio propertycondicion1 propertycondicion2 Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada 2.2 Actividades Realiza la búsqueda y selección de las Actividades. <t46bbbusquedas:busquedaactividad name="" propertycodigo="" propertydescripcion="" mostrarcodigo="" soloconsulta="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o NB29_ARQ_Componente Comunes 17/109

25 mbre Descripción Obligatorio false 2.3 Actos notificados Realiza la búsqueda y selección de los Actos notificados, también se llama asunto. <t46bbbusquedas:busquedaactotificado name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false NB29_ARQ_Componente Comunes 18/109

26 2.4 Agrupaciones Realiza la búsqueda y selección de una agrupación. <t46bbbusquedas:busquedaagrupacion name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.5 Áreas Realiza la búsqueda y selección de un área funcional, para seleccionar una sección o lista de secciones. NB29_ARQ_Componente Comunes 19/109

27 <t46bbbusquedas:busquedaarea name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertylistasecciones="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales propertylistaseccione s mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. mbre de la propiedad del FormBean correspondiente al campo lista sección. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.6 Buzón Realiza la búsqueda y selección de un buzón. <t46bbbusquedas:busquedabuzon busqueda="" name="" propertycodigo="" propertydescripcion="" soloconsulta="" todosgrupos="" unidadorgcod="" unidadorgdes="" departamentocod="" mostrardepartamento=""> NB29_ARQ_Componente Comunes 20/109

28 mbre Descripción Obligatorio name propertycodigo propertydescripcion busqueda soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja todosgrupos departamentocod departamentodes unidadorgcod unidadorgdes mostrardepartamento mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Indica si el componente se encuentra en un formulario de búsqueda, para poder permitir eliminar el contenido del campo. Los posibles valores son true o false, siendo true el valor para buscar en los maestros Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false indica si se tiene que mostrar todos los buzones de grupo (1) o solo algunos (0) mbre de la propiedad del FormBean correspondiente al campo código del departamento. mbre de la propiedad del FormBean correspondiente al campo descripción del departamento. mbre de la propiedad del FormBean correspondiente al campo código de la unidad orgánica. mbre de la propiedad del FormBean correspondiente al campo descripción de la unidad orgánica. Indica si se tiene que mostrar el departamento en la búsqueda. Los posibles valores son true o false, NB29_ARQ_Componente Comunes 21/109

29 2.7 Calle Realiza la búsqueda y selección de una calle en base a una provincia, un municipio y una localidad seleccionados anteriormente. <t46bbbusquedas:busquedacalle name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" propertycondicion="" propertycondicion1="" propertycondicion2="" soloconsulta="" propertytipocodigo="" propertytipodescripcion="" propertyhijocod="" propertyhijodes="" mostrarbaja="" sinportal="" ocultartipocalle=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertycondicion propertycondicion1 propertycondicion2 propertyhijocod propertyhijodes sinportal propertytipocodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso provincia. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso municipio. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso localidad. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si el componente esta relacionado con un bean o no, los posibles valores son false si los datos están vinculados a un Bean mbre de la propiedad del FormBean correspondiente al campo código del tipo de calle. NB29_ARQ_Componente Comunes 22/109

30 mbre Descripción Obligatorio propertytipodescripci on ocultartipocalle mostrarbaja mbre de la propiedad del FormBean correspondiente al campo descripción del tipo de calle. Indica si se tiene que mostrar el tipo de via seleccionable. Los valores posibles son true o false Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.8 Catálogo Realiza la búsqueda y selección de un país <t46bbbusquedas:busquedacatalogo name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" propertycondicion="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertycondicion eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso agrupación. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false NB29_ARQ_Componente Comunes 23/109

31 2.9 Censos Realiza la búsqueda y selección de un censo del Departamento de Industria, Comercio y Turismo. <t46bbbusquedas:busquedacenso name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes="" ocultarcensopersona=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja ocultarcensopersona mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Indica si se quiere que se muestre el censo de personas o no. Si se informa un true, no lo muestra Departamento Realiza la búsqueda y selección de un departamento. NB29_ARQ_Componente Comunes 24/109

32 <t46bbbusquedas:busquedadepartamento name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.11 Direcciones Realiza la búsqueda y selección de una dirección funcional, para seleccionar una sección o lista de secciones. <t46bbbusquedas:busquedadireccion name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertylistasecciones="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio NB29_ARQ_Componente Comunes 25/109

33 mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales propertylistaseccione s mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. mbre de la propiedad del FormBean correspondiente al campo lista sección. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.12 Estados Realiza la búsqueda y selección de estados. <t46bbbusquedas:busquedaestado name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" tipoeconomico="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. NB29_ARQ_Componente Comunes 26/109

34 mbre Descripción Obligatorio propertycodigo propertydescripcion mostrarcodigo soloconsulta tipoeconomico propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si el componente es de tipo económico. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.13 Estructura orgánicas Realiza la búsqueda y selección de una estructura orgánica de un departamento. <t46bbbusquedas:busquedaorgancas name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" propertycondicion="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. NB29_ARQ_Componente Comunes 27/109

35 mbre Descripción Obligatorio propertydescripcion mostrarcodigo soloconsulta propertycondicion propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso departamento Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.14 Estructura orgánica completa Realiza la búsqueda y selección de una estructura orgánica de un departamento, devolviendo la ruta completa. <t46bbbusquedas:busquedaestructuraorganicacompleta name="" propertycodigo="" propertydescripcion="" mostrarcodigo="" soloconsulta="" propertydescripciones="" propertydescripcioneu="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. propertydescripcion mbre de la propiedad del FormBean correspondiente al NB29_ARQ_Componente Comunes 28/109

36 mbre Descripción Obligatorio campo descripción. mostrarcodigo soloconsulta Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false propertydescripciones mbre de la propiedad del FormBean correspondiente al campo descripción en castellano. propertydescripcioneu mbre de la propiedad del FormBean correspondiente al campo descripción en euskera. propertyhijocod propertyhijodes eventoadicionales mostrarbaja Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.15 Familia Realiza la búsqueda y selección de una familia. <t46bbbusquedas:busquedafamilia name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. NB29_ARQ_Componente Comunes 29/109

37 mbre Descripción Obligatorio mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.16 Forma de envío Realiza la búsqueda y selección de una forma de envío. <t46bbbusquedas:busquedaformaenvio name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" propertycondicion="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion estiloclass soloconsulta mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Estilo que se quiere asociar al elemento búsqueda, se recomienda que sea un estilo que defina width, ej: width20 Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false NB29_ARQ_Componente Comunes 30/109

38 mbre Descripción Obligatorio propertycondicion eventoadicionales mostrarbaja Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso modo de envio. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.17 Hitos Realiza la búsqueda y selección de un hito. <t46bbbusquedas:busquedahito name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta visualizable eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si en los resultados deben mostrarse los elementos dados de alta. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false NB29_ARQ_Componente Comunes 31/109

39 2.18 Hitos de pasos Realiza la búsqueda y selección un hito de paso. <t46bbbusquedas:busquedahitopasos name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.19 Lista de secciones Componente en el que se guarda la lista de secciones recuperadas por la búsqueda de áreas funcionales, direcciones, servicios y/o secciones. NB29_ARQ_Componente Comunes 32/109

40 <t46bbbusquedas:busquedalistasecciones name="" propertycodigo="" propertyservicio="" propertyseccion="" mostrarbaja="" propertyarea="" propertydireccion=""/> mbre Descripción Obligatorio name propertycodigo propertyservicio propertyseccion propertydireccion propertyarea mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo código del servicio. mbre de la propiedad del FormBean correspondiente al campo código del sección. mbre de la propiedad del FormBean correspondiente al campo código del dirección. mbre de la propiedad del FormBean correspondiente al campo código del área. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.20 Localidad Realiza la búsqueda y selección de una localidad en base a una provincia y un municipio seleccionados anteriormente. <t46bbbusquedas:busquedalocalidad name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" propertycondicion="" propertycondicion1="" soloconsulta="" propertyhijocod="" propertyhijodes="" mostrarbaja="" sincalle=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. propertycodigo mbre de la propiedad del FormBean correspondiente al NB29_ARQ_Componente Comunes 33/109

41 mbre Descripción Obligatorio campo código. propertydescripcion mostrarcodigo soloconsulta propertycondicion propertycondicion1 propertyhijocod propertyhijodes sincalle mostrarbaja mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso provincia. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso municipio. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si el componente esta relacionado con un bean o no, los posibles valores son false si los datos están vinculados a un Bean Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.21 Motivo Realiza la búsqueda y selección de un motivo de expediente. <t46bbbusquedas:busquedamotivo name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" tipoeconomico="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. propertycodigo mbre de la propiedad del FormBean correspondiente al NB29_ARQ_Componente Comunes 34/109

42 mbre Descripción Obligatorio campo código. propertydescripcion mostrarcodigo soloconsulta propertycondicion propertyhijocod propertyhijodes sinlocalidad mostrarbaja mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso provincia. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si el componente esta relacionado con un bean o no, los posibles valores son false si los datos están vinculados a un Bean Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.22 Municipio Realiza la búsqueda y selección de un municipio en base a una provincia seleccionada anteriormente. <t46bbbusquedas:busquedamunicipio name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" propertycondicion="" soloconsulta="" propertyhijocod="" propertyhijodes="" mostrarbaja="" sinlocalidad=""/> mbre Descripción Obligatorio name propertycodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. propertydescripcion mbre de la propiedad del FormBean correspondiente al NB29_ARQ_Componente Comunes 35/109

43 mbre Descripción Obligatorio campo descripción. mostrarcodigo soloconsulta propertycondicion propertyhijocod propertyhijodes sinlocalidad mostrarbaja Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso provincia. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si el componente esta relacionado con un bean o no, los posibles valores son false si los datos están vinculados a un Bean Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.23 Naturaleza Realiza la búsqueda y selección de una naturaleza. <t46bbbusquedas:busquedanaturaleza name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. mostrarcodigo Los valores posibles son true o false, dependiendo si NB29_ARQ_Componente Comunes 36/109

44 mbre Descripción Obligatorio se quiere hacer visible el campo código. soloconsulta eventoadicionales mostrarbaja Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.24 Organismo Realiza la búsqueda y selección de un organismo. <t46bbbusquedas:busquedaorganismo name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false NB29_ARQ_Componente Comunes 37/109

45 2.25 País Realiza la búsqueda y selección de un país. <t46bbbusquedas:busquedapais name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" soloconsulta="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.26 Portal Realiza la búsqueda y selección de un portal en base a una provincia, un municipio, una localidad y una calle seleccionados anteriormente. < t46bbbusquedas:busquedaportal name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" propertycondicion="" propertycondicion1="" soloconsulta="" propertyhijocod="" propertyhijodes="" mostrarbaja=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. NB29_ARQ_Componente Comunes 38/109

46 mbre Descripción Obligatorio propertycodigo propertydescripcion mostrarcodigo soloconsulta propertycondicion propertycondicion1 propertyhijocod propertyhijodes mostrarbaja mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso localidad. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso calle. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.27 Procedimiento Realiza la búsqueda y selección de un procedimiento. <t46bbbusquedas:busquedaprocedimiento name="" mostrarcodigo=""propertycodigo="" propertydescripcion="" soloconsulta="" datodevolver="" indvigente="" numerocamposcod="" solonb29="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. NB29_ARQ_Componente Comunes 39/109

47 mbre Descripción Obligatorio propertydescripcion mostrarcodigo soloconsulta numerocampocod solonb29 mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica el numero de campos código que tiene el componente, los valores son 1 ó 2 (sección ruta) Indica si los procedimientos son de la NB29 o no, los posibles valores son true o false datodevolver Indica si el componente se tiene recuperar los procedimientos de B29, los posibles valores son RECUPERAR_B29 o RECUPERAR_TODOS indvigente eventoadicionales mostrarbaja Indica si se tienen que recuperar los procedimientos vigentes. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.28 Provincia Realiza la búsqueda y selección de una provincia. <t46bbbusquedas:busquedaprovincia name="" mostrarcodigo="" propertycodigo="" propertydescripcion="" provinciascav="" soloconsulta="" propertyhijocod="" propertyhijodes="" mostrarbaja="" sinmunicipio=""/> mbre Descripción Obligatorio name propertycodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. NB29_ARQ_Componente Comunes 40/109

48 mbre Descripción Obligatorio propertydescripcion mostrarcodigo soloconsulta provinciacav propertyhijocod propertyhijodes sinmunicipio mostrarbaja mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si el componente solo muestra las provincias del territorio. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Indica si el componente esta relacionado con un bean o no, los posibles valores son false si los datos están vinculados a un Bean Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.29 Tipo de participaciones Realiza la búsqueda y selección de un tipo de participación. <t46bbbusquedas:busquedatipoparticipacion name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. NB29_ARQ_Componente Comunes 41/109

49 mbre Descripción Obligatorio mostrarcodigo soloconsulta eventoadicionales mostrarbaja Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.30 Tipo de participaciones EAV Realiza la búsqueda y selección de un tipo de participación de la EAV. <t46bbbusquedas:busquedatipoparticipacioneav name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false NB29_ARQ_Componente Comunes 42/109

50 2.31 Responsable / Instructos Realiza la búsqueda y selección de un responsable. t46bbbusquedas:busquedaresponsable name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.32 Sección - Procedimiento Realiza la búsqueda y selección de un procedimiento a partir de la sección seleccionada. <t46bbbusquedas:busquedaseccionprocedimiento name="" propertycodigoprocedimiento="" soloconsulta="" propertycodigoseccion="" propertydescripcionprocedimiento="" propertydescripcionseccion="" eventoadicionales="" mostrarbaja="" obligatorio="" propertyservicio="" propertysubseccion="" /> NB29_ARQ_Componente Comunes 43/109

51 mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. propertycodigoseccion mbre de la propiedad del FormBean correspondiente al campo código de la sección. propertydescripcionse ccion propertycodigoprocedi miento propertydescripcionpr ocedimiento soloconsulta propertyservicio obligatorio eventoadicionales mostrarbaja propertysubseccion mbre de la propiedad del FormBean correspondiente al campo descripción de la sección. mbre de la propiedad del FormBean correspondiente al campo código del procedimiento. mbre de la propiedad del FormBean correspondiente al campo descripción del procedimiento. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false mbre de la propiedad del FormBean correspondiente al campo código del servicio. Indica si los campos son obligatorios. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false mbre de la propiedad del FormBean correspondiente al campo código de la subsección del procedimiento Sección Realiza la búsqueda y selección de una sección. <t46bbbusquedas:busquedaseccion name="" propertycodigo="" propertydescripcion="" mostrarbaja="" mostrarcodigo="" soloconsulta="" eventoadicionales="" propertycondicion="" propertycondicion1="" propertycondicion2="" propertyhijocod="" propertyhijodes="" propertylistasecciones=""/> NB29_ARQ_Componente Comunes 44/109

52 mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta mostrarbaja eventoadicionales propertylistaseccione s propertyhijocod propertyhijodes propertycondicion propertycondicion1 propertycondicion2 mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Función javascript adicional que se ejecutara una vez seleccionado un elemento. mbre de la propiedad del FormBean correspondiente al campo lista sección. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso dirección Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso servicio Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este área 2.34 Series Realiza la búsqueda y selección de un motivo de expediente. <t46bbbusquedas:busquedaserie name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> NB29_ARQ_Componente Comunes 45/109

53 mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja busqueda mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Indica si la serie esta definida en los maestros o en dokusi. Los posibles valores son true o false, siendo true el valor para buscar en los maestros 2.35 Servicio Realiza la búsqueda y selección de un servicio, para seleccionar una sección o lista de secciones. <t46bbbusquedas:busquedaservicio name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertylistasecciones="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio NB29_ARQ_Componente Comunes 46/109

54 mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales propertylistaseccione s mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. mbre de la propiedad del FormBean correspondiente al campo lista sección. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.36 Subfamilia Realiza la búsqueda y selección de una subfamilia, dependiente de una familia seleccionada previamente. <t46bbbusquedas:busquedasubfamilia name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" propertycondicion="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. NB29_ARQ_Componente Comunes 47/109

55 mbre Descripción Obligatorio propertycodigo propertydescripcion mostrarcodigo soloconsulta propertycondicion eventoadicionales mostrarbaja mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso familia. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.37 Subsección Realiza la búsqueda y selección de una sección en base a una sección seleccionada previamente. <t46bbbusquedas:busquedasubseccion name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" propertycondicion="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. NB29_ARQ_Componente Comunes 48/109

56 mbre Descripción Obligatorio soloconsulta propertycondicion eventoadicionales mostrarbaja propertyhijocod propertyhijodes Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, de cuyo valor depende esta búsqueda para ser realizada, en este caso sección. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado Terceros del procedimiento Realiza la búsqueda y selección de un tercero, si este no existe en el procedimiento, nos devuelve el tercero del maestro. <t46bbbusquedas:busquedatercerosprocedimiento name="" propertycodigo="" propertydescripcion="" mostrarcodigo="" soloconsulta="" idparticipacion="" idprocedimiento="" indcensocod="" indcensodes="" eventoadicionales="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. soloconsulta Indica si el componente se tiene que mostrar como solo NB29_ARQ_Componente Comunes 49/109

57 mbre Descripción Obligatorio consulta o no. Los valores posibles son true o false idprocedimiento idparticipacion indcensocod indcensodes eventoadicionales mostrarbaja mbre de la propiedad del FormBean correspondiente al campo procedimiento. mbre de la propiedad del FormBean correspondiente al campo participación. mbre de la propiedad del FormBean correspondiente al campo código de censo. mbre de la propiedad del FormBean correspondiente al campo descripción de censo. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.39 Tercero de la EAV Realiza la búsqueda y selección de un tercero de la EAV. <t46bbbusquedas:busquedatipoterceroeav name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false NB29_ARQ_Componente Comunes 50/109

58 mbre Descripción Obligatorio eventoadicionales mostrarbaja propertyhijocod Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado Tipo de pasos Realiza la búsqueda y selección de un tipo de paso. <t46bbbusquedas:busquedatipopasos name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. NB29_ARQ_Componente Comunes 51/109

59 mbre Descripción Obligatorio mostrarbaja Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.41 Tipologías Realiza la búsqueda y selección de una tipología. <t46bbbusquedas:busquedatipologia name="" propertycodigo="" propertydescripcion="" mostrarcodigo="" soloconsulta="" propertydocumentostr="" propertyindobligatorio="" mostrarbaja=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyindobligatori o propertydocumentostr mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false mbre de la propiedad del FormBean correspondiente al campo código indicador de obligatorio. mbre de la propiedad del FormBean correspondiente al campo con el contenido de la entidad documento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.42 Tipologías de pasos Realiza la búsqueda y selección de una tipología de pasos. NB29_ARQ_Componente Comunes 52/109

60 <t46bbbusquedas:busquedatipologiaspasos name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.43 Unidad orgánica Realiza la búsqueda y selección de una unidad orgánica. <t46bbbusquedas:busquedaunidadorganica name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio NB29_ARQ_Componente Comunes 53/109

61 mbre Descripción Obligatorio name propertycodigo propertydescripcion mostrarcodigo soloconsulta propertyhijocod propertyhijodes eventoadicionales mostrarbaja mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. Indica si el componente se tiene que mostrar como solo consulta o no. Los valores posibles son true o false Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento. Indica si en los resultados deben mostrarse los elementos que están dados de baja. Los valores posibles son true o false 2.44 Categoría Realiza la búsqueda y selección de un a categoría. La llamada esta definida en el tld t46bbbusquedacategorias.tld <t46bbcategorias:busquedacategorias mostrarcodigo="" propertycodseccion="" tipo="" propertytipoempresa="" name="" propertycodigo="" propertydescripcion="" eventoadicionales="" propertyhijocod="" propertyhijodes=""/> mbre Descripción Obligatorio name mbre del FormBean definido en el correspondiente sruts-xxxx.xml al que pertenecerán los campos de búsqueda. NB29_ARQ_Componente Comunes 54/109

62 mbre Descripción Obligatorio propertycodigo propertydescripcion mostrarcodigo tipo propertytipoempresa propertycodseccion propertyhijocod propertyhijodes eventoadicionales mbre de la propiedad del FormBean correspondiente al campo código. mbre de la propiedad del FormBean correspondiente al campo descripción. Los valores posibles son true o false, dependiendo si se quiere hacer visible el campo código. mbre de la propiedad del FormBean correspondiente al campo tipo de busqueda. Los posibles valores son E (empresa) o C (Carnet). mbre de la propiedad del FormBean correspondiente al campo tipo de empresa. mbre de la propiedad del FormBean correspondiente al campo código de la sección. Id de otro campo código, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Id de otro campo descripción, cuyo valor depende del resultado de esta búsqueda para ser seleccionado. Función javascript adicional que se ejecutara una vez seleccionado un elemento Censo identificativo Realiza la búsqueda y selección de un identificativo (tercero) de un censo. La llamada esta definida en el tld t46bb-busquedacensoidentificativo.tld <t46bbcensoidentificativo:busquedacensoidentificativo name="" incluirtipointeresado="" propertycodcenso="" propertydescenso="" propertyidentificativo ="" soloconsulta="" propertylistatipointeresado="" propertytipointeresado="" propiedadpersona="" capapersona ="" idseccion="" parametrosadicionales="" soloconsultaidentificativo="" soloconsultainteresado="" recuperarsoloidentificativo="" busquedas="" capadireccion="" formularioalta="" mostrarbaja="" propiedadcontacto="" propiedaddireccion="" idsubseccion="" /> mbre Descripción Obligatorio incluirtipointeresado (true/false) Flag que indica si se ha de incluir un combo NB29_ARQ_Componente Comunes 55/109

63 mbre Descripción Obligatorio para el tipo de interesado name mbre del form-bean asociado propertycodcenso propertydescenso propertyidentificativ o soloconsulta idseccion propiedadpersona mbre de la propiedad del formulario en la que se guardará el código del censo mbre de la propiedad del formulario en la que se guardará la descripción del censo mbre de la propiedad del formulario en la que se guardará el identificativo (true/false)indica si se muestran los campos en solo consulta ID en el que se guarda el código de la sección en la página mbre de la propiedad del formulario en la que se guardará la persona capapersona Identificativo de la capa de persona propiedaddireccion mbre de la propiedad del formulario en la que se guardará la dirección capadireccion Identificativo de la capa dirección propiedadcontacto idseccion propertylistatipointe resado propertytipointeresad o mbre de la propiedad del formulario en la que se guardará el contacto ID en el que se guarda el código de la sección en la página Propiedad del contexto donde se almacena la lista con los diferentes tipos de interesados (obligatorio si el flag incluirtipointeresado es true) mbre de la propiedad del formulario en la que se guardará la el tipo de interesado (obligatorio si el flag incluirtipointeresado es true) parametrosadicionales mbre de los IDs de la página que almacenan parámetros adicionales, estos se separan por. Por ejemplo, se guardará el nombre del campo donde se informa la sección / subsección para la búsqueda en acreditaciones. soloconsultainteresad o (true/false)indica si se muestran el campo tipo interesados en solo consulta NB29_ARQ_Componente Comunes 56/109

64 mbre Descripción Obligatorio soloconsultaidentific ativo recuperarsoloidentifi cativo busquedas formularioalta mostrarbaja tipotercero idsubseccion (true/false)indica si se muestran el campo de censo e identificativo en solo consulta y sin lupa de busqueda (true/false)indica si solo se va a recuperar el identificativo o todos los datos asociados (true/false)indica si se tiene que mostrar el campo identificativo como solo lectura, pero con lupa para su busqueda (true/false)indica si el componente se encuentra en un formlario para dar de alta, por lo que la sección debe ser obligatoria Propiedad que indica si se quiere que se visualice o no los registros de baja mbre del campo donde se guarda el código del tipo de tercero mbre de la propiedad del formulario en la que se guardará la subsección del procedimiento 2.46 Unidad orgánica Realiza la búsqueda y selección de una unidad orgánica. <t46bbbusquedas:busquedaunidadorganica name="" propertydescripcion="" soloconsulta="" propertycodigo="" mostrarcodigo="" eventoadicionales="" mostrarbaja="" propertyhijocod="" propertyhijodes=""/> 2.47 Tipos de interesado Realiza la búsqueda y selección de un tipo de interesado de una sección. La llamada esta definida en el tld t46bb-busquedas.tld <t46bbbusquedas:busquedatipointeresado recuperardesc="true" propertycodcenso="idcenso" propertydescenso="descenso" name="formdetalleinteresado" mostrarcodigo="false" seccionsubseccioncod="seccionsubseccion" soloconsulta="<%=soloconsulta%>" mostrarbaja="true" propertycodigo="idtipointeresado" NB29_ARQ_Componente Comunes 57/109

65 propertydescripcion="idtipointeresadodesc" propertytercerocodigo="tipotercerocod"/> mbre Descripción Obligatorio recuperardesc propertycodcenso propertydescenso (true/false) Flag que indica si se ha de incluir un combo para el tipo de interesado mbre de la propiedad del formulario en la que se guardará el código del censo mbre de la propiedad del formulario en la que se guardará la descripción del censo name mbre del form-bean asociado mostrarcodigo Propiedad que indica si se quiere que se visualice o no el código del tipo de interesado seccionsubseccioncod mbre del campo donde se guarda la sección / subsección. Por ejemplo: AE-A soloconsulta mostrarbaja propertycodigo propertydescripcion propertytercerocodigo eventoadicionales (true/false)indica si se muestran los campos en solo consulta Propiedad que indica si se quiere que se visualice o no los registros de baja mbre de la propiedad del formulario en la que se guardará el código del tipo de interesado mbre de la propiedad del formulario en la que se guardará la descripción del tipo de interesado mbre de la propiedad del formulario en la que se guardará el código del tipo de tercero Función javascript adicional que se ejecutara una vez seleccionado un elemento. NB29_ARQ_Componente Comunes 58/109

66 3 Procedimiento Realiza la búsqueda y selección de procedimientos. El componente de búsqueda de procedimientos es del tipo código+descripción, pero tiene una serie de particularidades que lo hacen distinto al grupo descrito en el punto anterior. Para empezar, los parámetros del componente y sus descripciones son las siguientes (subrayados aquellos que son obligatorios): name: mbre del form-bean asociado mostrarcodigo: (true/false ) si se quiere mostrar el campo código propertycodigo: nombre de la property del form-bean donde se recogerá el valor para el código. * propertydescripcion: nombre de la property del form-bean donde se recogerá el valor para la descripción. soloconsulta: (true/false) si el elemento es de solo consulta datodevolver: nombre con los datos a devolver, sus valores son 'MAESTRO', '' o 'ALL'. indvigente: (true/false) si los elementos están vigentes o no. numerocamposcod: (1 2) numero de campos código que tendrá, solo si mostrarcodigo es true. solonb29: (true/false) solo recuperar aquellos que pertenecen al grupo NB29. Además, en función del parámetro numerocamposcod, el componente se mostrará de forma distinta. <t46bb:busquedaprocedimiento name=" " mostrarcodigo=" " propertycodigo=" " propertydescripcion=" " soloconsulta=" " datodevolver=" " indvigente=" " numerocamposcod="" solonb29=" "/> * IMPORTANTE: En el caso que utilicemos el componente con el parámetro numcamposcod=2, deberemos tener en cuenta que, en el <form-bean> donde definimos las propiedades, tendremos que crear dos propiedades con el propertydescripcion y las terminaciones Seccion y Ruta. Por ejemplo: Si propertycodigo=procedimiento, deberemos tener definidas las propiedades procedimientoseccion y procedimientorutam. Si utilizamos el componente con un solo campo, sólo tendremos que tener definida la propiedad que incluyamos en el parámetro propertydescripcion. 3.1 Procedimiento (un campo código) Permite realizar la búsqueda y selección de un procedimiento en base al código completo del mismo introducido. NOTA: El componente se dibujará en un bloque <li class="tres">. NB29_ARQ_Componente Comunes 59/109

67 3.2 Procedimiento (dos campos códigos) Permite realizar la búsqueda y selección de un procedimiento en base al código de la sección y el código de la ruta a la que pertenece. NOTA: El componente se dibujará en un bloque <li class="tres">. 3.3 Procedimiento (sección + ruta) Permite realizar la búsqueda y selección de un procedimiento en base al código de la sección y el código de la ruta a la que pertenece. La diferencia con los dos anteriores estriba en que este último muestra además la descripción de la sección seleccionada. El funcionamiento interno será igual en todos los componentes. Existe la posibilidad de que sólo se seleccione la sección sin asociar un procedimiento. NB29_ARQ_Componente Comunes 60/109

68 4 Dirección El componente dirección permite incluir en un fomulario los campos que componen una dirección, bien sea nacional o extranjera, junto con la lógica de funcionamiento y de interrelación entre ellos. Técnicamente se subdivide en dos subcomponentes totalmente funcionales y que se pueden usar independientemente. Estos son: Componente Dirección Nacional: <t46bb:direccionnacional name="" property="" extendida="" obligatorio="" soloconsulta="" contador="" ubicacion="" /> Componente Dirección Extranjera: <t46bb:direccionextranjero name="" property="" obligatorio="" soloconsulta="" contador=""/> Si lo que queremos es incluir el componente completo, con los dos tipos de dirección, utilizaremos el siguiente código: <t46bb:direccion contador="" name="" property="" obligatorio="" soloconsulta=""> <t46bb:direccionnacional name="" property="" extendida="" obligatorio="" soloconsulta="" contador="" ubicacion="" /> <t46bb:direccionextranjero name="" property="" obligatorio="" soloconsulta="" contador=""/> </t46bb:direccion> Esto nos incluirá también los dos radio buttons de selección para el tipo de dirección. Los parámetros y sus descripciones son: tas: contador: numero entero para diferenciar las capas. Pondremos el mismo contador por bloque (el número debe ser único para cada bloque, si tenemos otra dirección nacional no debe tener el mismo contador porque de lo contrario, al activar las capas, afectaría al funcionamiento de todas aquellas que coincidan con ese contador). name: mbre del form-bean asociado. property: nombre de la property del form-bean donde se encuentra definido el bean. obligatorio: (true/false) marca en negrita los campos he indica que son obligatorio rellenarlos. soloconsulta: (true/false) si el elemento es de solo consulta. extendida: (true/false) se debe mostrar la información extendida de la dirección nacional, edificio, piso, portal y código postal. ubicacion: (true/false) el componente se comporta como una ubicación en la cual se muestra como información extendida los siguientes campos de la dirección nacional, portal, UTM y código postal. El valor del property debe ser un T46bbDireccionBean para los componentes t46bb:direccion, t46bb:direccionnacional y t46bb:direccionextranjero De esta forma definiremos en el form-bean el nombre que pondremos luego en el componente. Por ejemplo: NB29_ARQ_Componente Comunes 61/109

69 Si en el form-bean del struts hemos puesto <form-property type="com.ejie.t46bb.componentes.beans.direccionct.t46bbdireccionbean" name="direccionexpediente"/> el valor del property a poner en el componente es direccionexpediente Para el componente t46bb:direccioncontacto el property debe ser un T46bbContactoBean, así tendremos definido en el form-bean correspondiente la siguiente propiedad: <form-property type="com.ejie.t46bb.componentes.beans.contactoct.t46bbcontactobean" name="contactotercero"/> y en el componente pondremos contactotercero Visualmente el componente se mostrará y funcionará de la siguiente manera: 4.1 Componente Dirección Incluye la opción de seleccionar el tipo de dirección. o o o o o Asocia los radiobuttons y las capas que se mostrarán en función del que se haya seleccionado. Los radios tendrán como nombre el valor del atributo property más el texto tipo. P.ej.: Si property=direccion, el nombre de los radios será direccion.tipo. El radio también tiene id. Este identificador se formará a partir del atributo property junto con el texto tipo_ identificativo de capa. Así, para la dirección nacional el id sería direccion.tipo_dn, mientras que para la dirección extranjera sería direccion.tipo_de. Si el componte se marca como soloconsulta los radios se mostraran deshabilitados. La propiedad contador nos sirve para identificar de forma única las capas de dirección que pueda existir en la pantalla. Si ningún radio esta seleccionado no se mostrara ninguna capa. 4.2 Componente Dirección Nacional Propiedad extendida = true. NB29_ARQ_Componente Comunes 62/109

70 Propiedad extendida = false. Propiedad ubicacion = true. o o o o o o Se encarga de dibujar la capa de dirección nacional que contiene la información de provincia, municipio, localidad, calle. Si el valor de extendida=true mostrará los campos edificio, portal, piso y código postal. Si el valor de ubicación=true se mostrarán los campos portal, UTM y código postal. Los valores de extendida son opcionales, por lo que en caso de no ponerlos tomara el valor como false por defecto, así que evitaremos en todo momento que ambos valores tengan valor true. Como norma (no quiere decir que no se pueda utilizar otros valores) los valores de name, property, obligatorio, soloconsulta y contador serán iguales que el del componente t46bb:direccion que los incluye. Si el valor busquedadatosportal=false al buscar los datos del portal, no se rellenarán los campos CP ni Complemento dirección, en el caso contario o no se añade el atributo busquedadatosportal si se rellenarán. 4.3 Componente Dirección Extranjera o o Se encargará de dibujar la capa de dirección extranjera que contiene la información del país y de la dirección de ésta Como norma (no quiere decir que no se pueda utilizar otros valores) los valores de name, property, obligatorio, soloconsulta y contador serán iguales que el del componente t46bb:direccion que los incluye. NB29_ARQ_Componente Comunes 63/109

71 4.4 Componente Dirección Contacto es un componente dirección propiamente dicho, sino que se refiere mayormente a los datos de contacto de una persona. Se puede utilizar de forma aislada o en conjunto con el componente dirección. <t46bb:direccioncontacto contador="" obligatorio="" property="" name="" soloconsulta=""/> El atributo contador deberá ser el mismo que el indicado para el componente dirección si éste forma parte de él, si no es indistinto. Cada componente dirección crea su propia capa <div class="doscolumnas">. NB29_ARQ_Componente Comunes 64/109

72 5 Persona El componente persona permite incluir en un formulario los campos que componen los datos de una persona, física, jurídica u organismo público, junto a la lógica de funcionamiento y de interrelación entre ellos. Técnicamente se subdivide en tres subcomponentes totalmente funcionales y que se pueden usar independientemente, aunque normalmente se utilizarán todos bajo el componente global. Esto son: Componente Persona Física: <t46bb:personafisica name="" property="" obligatorio="" soloconsulta="" contador="" preseleccionado=""/> Componente Dirección Jurídica: <t46bb:personajuridica name="" property="" obligatorio="" soloconsulta="" contador="" preseleccionado=""/> Componente Organismo Público: <t46bb:organismopublico name="" property="" obligatorio="" soloconsulta="" contador="" preseleccionado=""/> Para incluir el componente completo, con los tres tipos de persona, utilizaremos el siguiente código: <t46bb:persona contador="" property="" name="" soloconsulta="" obligatorio="" propiedaddireccion="" capadireccion="" ocultarlupa="" propiedadcontacto="" tipofijo="" preseleccionado="" checkfisicadesabilitado="" checkjuridicadesabilitado="" checkopdesabilitado="" > <t46bb:personafisica name="" property="" obligatorio="" soloconsulta="" contador="" tratamientoespecial="" preseleccionado=""/> <t46bb:personajuridica name="" property="" obligatorio="" soloconsulta="" contador="" preseleccionado=""/> <t46bb:organismopublico name="" property="" obligatorio="" soloconsulta="" contador="" preseleccionado=""/> </t46bb:persona> Esto nos incluirá también los dos radio buttons de selección para el tipo de dirección. Los parámetros y sus descripciones son: Descripción de los parámetros: contador: número entero para diferenciar las capas. Pondremos el mismo contador por bloque (el número debe ser único para cada bloque. Si tenemos otra persona, no debería tener el mismo contador, ya que de lo contrario al activar las capas afectaría al funcionamiento de todas aquellas que coincidan con ese contador). name: mbre del form-bean asociado. property: nombre del property del form-bean donde se encuentra definido el bean. obligatorio: (true/false) marca en negrita los campos he indica que son obligatorio rellenarlos. soloconsulta: (true/false) si el elemento es de sólo consulta. NB29_ARQ_Componente Comunes 65/109

73 tipofijo: Valor del tipo de persona siempre que se desee que sólo muestre uno de ellos. Por ejemplo, PF para Persona Física. tratamientoespecial: Valor para aplicar un tratamiento especial al componente de persona. Los valores pueden ser: o AUT Sólo muestra DNI/NIF y NIE en la combo de tipo de documento identificativo. preseleccionado: Permite que sea preseleccionado un tipo de persona en concreto. Para poder usar esta opción, este atributo se va a tener que añadir con el mismo valor en los cuatro elementos del componente. checkfisicadesabilitado: Con valor a true, el radio de persona física se muestra deshabilitado. checkjuridicadesabilitado: Con valor a true, el radio de persona jurídica se muestra deshabilitado. checkopdesabilitado: Con valor a true, el radio de organismo público se muestra deshabilitado. Visualmente el componente dibujaría lo siguiente: Persona Física Persona Jurídica Organismo Público NB29_ARQ_Componente Comunes 66/109

74 6 Persona + Dirección En muchas ocasiones, será necesario utilizar los componentes persona y dirección de forma conjunta. En este punto se especificará como hacerlo, además de explicar un ejemplo completo sobre su posible uso. Código ejemplo para incluir ambos componentes: <t46bb:persona contador="0" property="personatercero" name="formmodificartercero" soloconsulta="false" obligatorio="true" propiedaddireccion="direcciontercero" capadireccion="0" propiedadcontacto="contactotercero"> <t46bb:personafisica name="formmodificartercero" property="personatercero" obligatorio="true" soloconsulta="false" contador="0" /> <t46bb:personajuridica name="formmodificartercero" property="personatercero" obligatorio="true" soloconsulta="false" contador="0" /> <t46bb:organismopublico name="formmodificartercero" property="personatercero" obligatorio="true" soloconsulta="false" contador="0"/> </t46bb:persona> <t46bb:direccion contador="0" name="formmodificartercero" property="direcciontercero" obligatorio="true" soloconsulta="false"> <t46bb:direccionnacional name="formmodificartercero" property="direcciontercero" extendida="true" obligatorio="true" soloconsulta="false" contador="0"/> <t46bb:direccionextranjero name="formmodificartercero" property="direcciontercero" obligatorio="true" soloconsulta="false" contador="0"/> </t46bb:direccion> <t46bb:direccioncontacto contador="0" obligatorio="false" property="contactotercero" name="formmodificartercero" soloconsulta="false" /> A tener en cuenta para incluir ambos componentes: Los componente t46bb:persona, t46bb:personafisica, t46bb:personajuridica y t46bb:organismopublico el property debe ser un T46bbDireccionBean, así tendremos definido en el form-bean correspondiente la siguiente propiedad: <form-property type="com.ejie.t46bb.componentes.beans.direccionct.t46bbdireccionbean" name="direcciontercero"/> y en los componentes pondremos direcciontercero. NB29_ARQ_Componente Comunes 67/109

75 Los atributos opcionales del componente persona son los siguientes, y se utilizan para rellenar los campos del componente direccion y direccioncontacto cuando se selecciona a partir de un DNI o de la búsqueda en los censos o expedientes propiedaddireccion: nombre del property usado en el componente dirección asociado a esta persona capadireccion: numero del contador asociado al componente dirección. propiedadcontacto: nombre del property usado en el componente direccioncontacto asociado a esta persona. ocultarlupa: (true/false) no se mostrara la lupa, y no se podrá llamar a la búsqueda de personas. Funcionamiento de la opción de búsqueda: Cuando tenemos una pantalla como ésta y pulsamos la lupa marcada 1.- Si hemos introducido un DNI en el campo, y el usuario existe, el componente nos devolverá los datos de esa persona en cada uno de los campos del componente. 2.- Si el campo está vacío, se abrirá una nueva ventana para seleccionar los criterios de la búsqueda. NB29_ARQ_Componente Comunes 68/109

76 Una vez realizada la búsqueda y seleccionada la persona que queríamos encontrar, el componente arrastará todos los datos que se tengan de esa persona a los campos del formulario, quedando éste de la siguiente manere: NB29_ARQ_Componente Comunes 69/109

77 7 Subida de Archivos El componente subida de archivos nos porporciona la utilidad de subir archivos a la zona temporal del servidor de la eav. Este proceso devuelve el path completo del servidor en el que se ha almacenado el archivo de forma que podamos utilizarlo después en las invocaciones a la infraestructura (tareas, PPS, ). El componente subida de archivos se puede configurar para utilizar el almacén de documentos-webdav. (Ver siguiente punto) NB29_ARQ_Componente Comunes 70/109

78 8 Almacén de Documentos El Almacén de Documentos nos permite guardar de forma temporal un documento Word y editarlo directamente sin tener que guardarlo en el disco duro del equipo cliente, antes de la consolidación final del mismo en Deokusi (bien directamente, bien a través de una tarea de tramitación Platea). Se compone de un sistema de negocio (T50cbAlmacenDocumentosEJB) y un War (T46bbAlmacenDocumentosWar). Para utilizar el componente, basta con incluir el parámetro sistemadocumentos=true, en el componente de subida de Documentos. Esto hará que el documento se suba al Almacén de Documentos y que podamos después editarlo. Para ello, el componente crea las utilidades necesarias en la página (javascript) para que la aplicación cliente pueda utilizarlas, dibujando en pantalla los botones o enlaces necesarios (normalmente un botón Editar y un botón Nuevo Documento). Para poder utilizar este componente es necesario, incluir en la aplicación cliente: -El jar del propio almacén t50cbclasses.jar -El jar cliente del EJB del almacén t50cbalmacendocumentos.jar -El jar del componente de gestión de archivos t46bbcomponentesgestorarchivos.jar -Añadir en el archivo de configuración (codapp.properties) las siguientes entradas: # # Almacen de Documentos # URL_T50CB_EJB=t3://webldes53,webldes54:7341 (Servidor de Integración) URL_T50CB_SERVLET= NB29_ARQ_Componente Comunes 71/109

79 9 Tipo de Tercero Este componente nos permite buscar y seleccionar un tipo de tercero del catálogo de procedimientos o del maestro correspondiente y traernos todos los datos asosciados al mismo rellenando los campos de formulario que deseemos. Componente y atributos: <t46bb:busquedatipotercero maestros="" mostrarcodigo="" name="" propertycodigo="" propertydescripcion="" soloconsulta="" idprocedimiento="" indcabecera="" indcensocod="" indcensodes="" indlider="" indobligatorio="" indotros="" indrespeconomico="" indresplegal="" indrolcod="" indroldes="" indsede="" indsolicitud=""/> maestros: (true/false): Indica si se quiere realizar la búsqueda contra el maestro correspondiente (true) o contra el catálogo de procedimientos (false). En este último caso, el atributo idprocedimiento será también obligatorio. mostrarcodigo: (true/false) Indica si se desea mostrar o no el campo que incluye el código del tipo de tercero. name: mbre del form-bean asociado. propertycodigo: nombre del property del form-bean donde se recupera el código del tipo de tercero. propertydescripcion: nombre del property del form-bean donde se recupera la descripción del tipo de tercero. soloconsulta: (true/false) si el elemento es de sólo consulta. idprocedimiento, indcabecera, indcensocod, indcensodes, indlider, indobligatorio, indotros, indrespeconomico, indresplegal, indrolcod, indroldes, indsede, indsolicitud. Estos atributos se referirán a los campos de formulario que deberán completarse con los datos del tipo de tercero que se recuperen. Así, si en un formulario tengo los campos correspondientes a rol y censo, deberá indicarse como se llaman esos campos en los atributos indcensocod, indcensodes, indrolcod y indroldes. Pantalla ejemplo: NB29_ARQ_Componente Comunes 72/109

80 10 Documentos 10.1 Búsqueda de Documentos Este componente común es para la búsqueda de documentos en las aplicaciones del back office de industria INFORMACION DEL TAG <t46bbdocumento:documento property="" name="" tipoacceso="" accionrecuperar="" propertymbremetadato="" propertyvaloresobligatorios="" propertyvalormetadato="" sistemadocumentos="" /> Property = nombre del bean documento donde están o se van a recuperar los datos. Name = nombre del formulario que contiene la propiedad documento bean. TipoAcceso = DETALLE: todos los campos se mostrarán en sólo lectura y no existe botón de asociar documento BUSQUEDA: todos los campos son editables y no existe botón de asociar documento ALTA: ciertos campos son editables, si no viene con datos y existe botón de asociar documento REPROGRAMAR: todos los campos salvo la topología se muestran como solo lectura y no existe boton de asociar documento MODIFICAR: todos los campos que muestra el estado de ALTA menos la topología y no existe boton de asociar documento MOD_ARCHIVO: todos los campos son no editables y existe botón de asociar documento AccionRecuperar = acción de la operación de presentación por la que se pasa para poder recuperar y pintar los metadatos. Sólo para las opciones de alta y reprogramar. PropertymbreMetadato = Raíz de las propiedades definidas en el formulario donde se guardarán los nombres de los metadatos. Esto se explica más adelante. PropertyValorMetadato = Raíz de las propiedades definidas en el formulario donde se guardarán los valores de los metadatos. Esto se explicara más adelante. NB29_ARQ_Componente Comunes 73/109

81 PropertyValoresObligatorios = Raíz de las propiedades definidas en el formulario donde se guardaran los valores obligatorios de los metadatos. sistemadocumentos = Dato para el acceso a webdav. Apartado de webdav (Almacén de documentos). En el formulario se definen 5 propiedades para los metadatos, es decir, se definirán: propiedadmbre0, propiedadmbre1 propiedadmbre4 pero en el tag se pondrá únicamente propertymbremetadato="propiedadmbre" También se definirán: ValoresObli0, propiedadvaloresobli1 propiedadvaloresobli4 pero en el tag se pondrá propertyvaloresobligatorios="propiedadvaloresobli" También se definirán: propiedadvalor0, propiedadvalor1 propiedadvalor4 pero en el tag se pondrá propertyvalormetadato="propiedadvalor" NB29_ARQ_Componente Comunes 74/109

82 RECUPERACION DE LOS DATOS Para recuperar los datos se hará lo siguiente: 1. Se manda recuperar el bean, Object documentobean = formulario.get("documentobean"); Se crea la entidad documentoet. DocumentoET documentoet = ((T46bbDocumentoGenericoBean)documentoBean).getDocumento(); Para el formulario de alta y/o reprogramación se tendrá que comprobar si se tienen que recuperar los metadatos. Para ello, se comprabará el número de metadatos: int elementos = Integer.parseInt(((T46bbDocumentoGenericoBean)documentoBean).getNumeroElementos()); Si este valor es mayor que 0, entonces se tienen metadatos. Al tener metadatos, se tiene que comprobar si sus valores son correctos. Para ello se mandarán comprobar los valores, de la siguiente manera: if(!t46bbutilidades.comprobarmetadatos(formulario, "propiedadvalor", "propiedadvaloresobli", elementos, **)) { } errores.add("error",new ActionError("metadato incorrecto")); Para mandar recuperar los valores de los metadatos se utilizará la siguiente función: T46bbUtilidades.recuperarMetadatos(formulario, documentoet, "propiedadmbre", "propiedadvalor", elementos, **); ** Es un valor booleano (true/false) que indica si el formulario es multipart o no, es decir, si yo he definido mi formulario como multipart, pondré como valor true. NB29_ARQ_Componente Comunes 75/109

83 Para recuperar el contenido del documento, el formulario tiene que ser multipart, y se llamará a esta función: FormFile myfichero = T46bbUtilidades.recuperarFicheroSubida(formulario, "documentobeanfile"); Y se añade el contenido a nuestra entidad: documentoet.getdatosgeneracionet().setcontenido(t46bbutilidades.codificarcontenidofichero(myfichero)); 10.2 Descarga de Documentos de platea Componente de descarga de documentos de platea. Es necesario para incluirlo lo siguiente: 1) Tener importado en el web.xml y el tld de gestor (t46bb-gestor.tld). 2) En la pantalla en la que se quiere descargar, se incluirá el siguiente componente <t46bbgestor:descargarfichero name="" procedureid="" nombreservlet=""/> Las propiedades son: Name = mbre de la función javascript encargada de abrir el documento. Esta función tiene dos parámetros, el oid y el nombre del documento pero en el name sólo se pone el nombre. Esta es la única propiedad obligatoria del componente nombreservlet = Valor opcional para invocar a un servlet propio de la aplicación. Si este atributo no existe, se invoca al servlet definido en la t46bb. procedureid = Valor del procedimiento en el que se va a recuperar el documento, es un valor opcional, pero si se pone mejor. Ejemplo de componente de descarga de documentos de platea: <t46bbgestor:descargarfichero name="recuperardocumento"/>... <html:column titlekey="visor.archivofinal" sortable="true" headerclass="sortable" > <a href="javascript:recuperardocumento('valoroid', 'nombredoc');"> NB29_ARQ_Componente Comunes 76/109

84 <img src="<%=imgword%>" border="0" alt="archivo"/> </a> </html:column> El valoroid y el nombredoc se recupera de la entidad documento Generación de Documentos Se ha construido un componente común para la generación de documentos Word. En la parte de presentación se tendrá en cuenta los siguientes puntos: Tener las siguientes propiedades definidas en contexto de la operación de presentación que trate los documentos <!-- Documentos WORD --> <form-property name="plantilladoc" type="java.lang.string"/> <form-property name="resultadowordbytes" type="java.lang.object"/> Tener las siguientes operaciones de presentación definidas en el struts: <!-- Documento WORD --> <action path="/t46dbpeticionexternaword" type="com.ejie.t46db.catprocedimiento.acciones.t46dbprepararwordresumen"> <forward name="ok" path="/t46dbobtenertargetwordexternoporbean.do"></forward> </action> <action path="/t46dbobtenertargetwordexternoporbean" parameter="obtenerdatosword" type="com.ejie.t46bb.componentes.exportar.t46bbprepararimprimirword"> <forward name="ok" path="/t46dbmensaje2fase.do"/><!-- cambiar esto --> </action> Las librerías que se tienen que importar en los proyectos son: t47ibserviciosdocumentosejb.jar t49cbdocumentosejb.jar NB29_ARQ_Componente Comunes 77/109

85 En los ficheros de configuracionoi y mapasaplicacion, se realizarán las siguientes modificaciones: configuracionoi.xml <estructura name="obtenerdatosword"> <propiedad value="com.ejie.t46bb.componentes.excepciones.t46bbadaptadorexcepcionesnegocio"/> <propiedad name="fimbre" value="ejb.t47ibserviciosdocumentos"/> <propiedad name="fimetodo" value="invocarejbgeneracionword"/> <propiedad name="fimapainvocacion" value="datosdocumentowordmapai"/> <propiedad name="fimaparetorno" value="plantilladocmapar"/> <propiedad name="oierrorkey" value="error.oi.obtenerdatosword"/> </estructura> name="oiclase" mapasaplicacion.xml <mapa nombre="datosdocumentowordmapai"> <mapa ref="mapaseguridad"/> <mapa ref="mapaplantilladoc"/> </mapa> <mapa nombre="mapaplantilladoc" tipoargumento="java.lang.string" nombreargumento="plantilladoc"/> <mapa nombre="plantilladocmapar" nombredestinoencontexto="resultadowordbytes"/> 10.4 Guardar Documentos Se ha creado un componente para la acción de grabar contenido de un fichero en BBDD. Para ello, se deben realizar una serie de pasos. Lo primero de todo es que se tiene que definir un formulario como multipart. <html:form action= enctype="multipart/form-data" method="post" > Cuando se submite el formulario a una operación de presentación u operación interna, se tiene que recuperar el contenido del archivo. Para ello se hará lo siguiente: NB29_ARQ_Componente Comunes 78/109

86 En este ejemplo, la entidad a mandar es un documentogenericoet. En cada caso, dependerá de la entidad donde se guarda el contenido del fichero. FormFile myfichero = T46bbUtilidades.recuperarFicheroSubida(formulario, "nombre_del_campo_file"); if(!documentogenericoet.issetdatosgeneracionet()){ documentogenericoet.addnewdatosgeneracionet(); } documentogenericoet.getdatosgeneracionet().setcontenido(t46bbutilidades.codificarcontenidofichero(myfi chero)); formulario: es el Q70OPForm o Q70OPValidatorForm, nunca el Action nombre_del_campo_file: mbre del campo Así, si en el jsp se tiene <html:file property="ficherosubida"/> El nombre del fichero es ficherosubida. T46bbUtilidades.codificarContenidoFichero devuelve un String en base64. Una vez recuperado el contenido y añadido a la entidad se procede normalmente Exportar resultados Exportar a excel Se ha creado una utilidad para exportar a Excel una tabla de resultados. Su funcionamiento se explica a continuación. Para exportar, lo que se hace es utilizar un iframe para enviar la información a una acción definida en el struts. Para ello, lo que se hace es crear un HashMap en el contexto: NB29_ARQ_Componente Comunes 79/109

87 <form-property name="tablaexportar" type="java.util.hashmap" /> Y se pone estas acciones en el struts: <!-- exportar tabla --> <action path="/t46*bprepararexportartabla" type="com.ejie.t46*b.****.t46*bpreparartabla"> <forward name="ok" path="/t46dbexportarexcelaction.do"></forward> </action> <action path="/t46dbexportarexcelaction" type="com.ejie.t46bb.componentes.exportar.t46bbprepararimprimirexcel"> <forward name="ok" path="/t46dbmensaje2fase.do"/> </action> La primera clase de las acciones descritas es la que se encargará de poner en la propiedad tablaexportar los datos, transformando las fechas en caso necesario. La segunda clase está definida dentro del jar de T46bComponentesClases. Nunca se redirije al forward, ya que se manda inyecta en la request pero para en el struts es necesario poner un forward en la acción. En el JSP: <a href="t46*bprepararexportartabla.do" target="iframeiiframecapaexpediente" class="botongris"><html:message key="boton.imprimirexcel"/></a> El target está haciendo referencia al iframe definido en la plantilla en el componente t46bbcomunes:mostrarcapacargar. Este componente es el que se usa para pintar una capa donde se muestran las búsquedas y errores. A continuación, se indica un ejemplo de lo que tendría que ser la clase T46*bPrepararTabla (o cualquier otro nombre que se le quiera poner). Este hashmap de nombre tablaexportar tiene la siguiente estructura: HashMap hashmap = new HashMap(); hashmap.put("titulo", "titulo.tabla.busqueda"); // mbre que tendra la tabla hashmap.put("i18nkey", "t46dbrecursos"); hashmap.put("cabecera", cabecera); // mbre del fichero de recursos // ArrayList con el nombre de las columnas NB29_ARQ_Componente Comunes 80/109

88 hashmap.put("criteriosbusqueda", criterios); // ArrayList de HashMap con propiedades crit y critvalor con los valores de la búsqueda de la tabla hashmap.put("datostabla", arraydatos); // ArrayList de HashMap con propiedades elemento*, donde * (0 --> n), que contiene el valor de cada celda contexto.set("tablaexportar", hashmap); ArrayList cabecera = new ArrayList(); cabecera.add("procedimiento.tabla.procedimiento"); cabecera.add("procedimiento.tabla.descripcion"); cabecera.add("procedimiento.tabla.fecha"); cabecera.add("procedimiento.tabla.estado"); cabecera.add("procedimiento.tabla.familia"); cabecera.add("procedimiento.tabla.subfamilia"); cabecera.add("procedimiento.tabla.eco"); cabecera.add("procedimiento.tabla.informacion"); ArrayList criterios = new ArrayList(); se comprueba que exista ese valor para añadirlo al array de criterios if(datosprocedimientoet.issetseccion() datosprocedimientoet.getseccion().issetdescripcionidioma()){ criteriohash = new HashMap(); criteriohash.put("crit", "procedimiento.buscar.seccion"); criteriohash.put("critvalor", datosprocedimientoet.getseccion().getid()); criterios.add(criteriohash); } && resto de criterios ArrayList arraydatos = new ArrayList(); HashMap auxiliar = new HashMap(); String idprocedimiento = ""; String descripcion = ""; String fechainicio = ""; String estado = ""; NB29_ARQ_Componente Comunes 81/109

89 String familia = ""; String subfamilia = ""; String economico = ""; String negocio = ""; cálculo de las variables procedimientohash.put("elemento0", idprocedimiento); procedimientohash.put("elemento1", descripcion); procedimientohash.put("elemento2", fechainicio); procedimientohash.put("elemento3", estado); procedimientohash.put("elemento4", familia); procedimientohash.put("elemento5", subfamilia); procedimientohash.put("elemento6", economico); procedimientohash.put("elemento7", negocio); arraydatos.add(procedimientohash); El número de elementos del arraydatos tiene que coincidir con el tamaño del array de las cabeceras Exportar a PDF Para exportar los resultados a formato PDF, en el struts se tienen que incluir las siguientes acciones: <!-- Imprimir PDFs --> <action path="/t46ebprepararexportarpdf" type="com.ejie.t46eb.entradas.acciones.t46ebprepararjustificante"> <forward name="ok" path="/t46ebexportarpdf.do"></forward> </action> <action path="/t46ebexportarpdf" type="com.ejie.t46bb.componentes.exportar.t46bbprepararimprimirpdf"> <forward name="ok" path="/t46dbmensaje2fase.do"/> </action> Después, en la clase T46ebPrepararJustificante lo que se hace es preparar un hashmap con la información necesaria para generar el PDF. Este hashmap de nombre tablaexportar tiene la siguiente estructura HashMap hashmap = new HashMap(); hashmap.put("nombrepdf",...); // String con el nombre que por defecto tendra el PDF, ejemplo Justificante.pdf hashmap.put("entidadxml",...); // String con el xml que contiene los datos a mostrar. Hay que recordar que esta entidad tendrá las fechas modificadas. hashmap.put("entidadxsl",...); // String con la ruta al xsl que se usa como plantilla para generar el pdf. NB29_ARQ_Componente Comunes 82/109

90 Caracteres especiales Al generar un documento PDF mediante plantillas usando nuestra utilidad, hay que tener en cuenta que si el XML de datos contiene los caracteres especiales &, < o > y éste ha sido generado directamente desde la ET con la función tostring(), es el propio componente el que se encarga de realizar el parseo de caracteres especiales (actualizar la librería t49ebclasses.jar). En el caso que se cree el XML de datos mediante un String, entonces cada campo que sea sensible de contener caracteres especiales, es necesario que se invoque al método que se encuentra en la librería de la arquitectura (T49ebClasses.jar): public String reemplazarcaracteresespeciales(string cadenaentrada) La clase es T49ebDocumentoPDF.java. Este método sustituye los caracteres extraños en un String que se va a incluir como dato de un tag de un xml. De momento, sólo sustituye el &, el < y el > Utilidad fechas Para mostrar las fechas al exportarlas, se ha creado en los componentes comunes una utilidad que formatea la fecha al formato que se informe. El método es devolverfecha de la clase T46bbUtilidades.java (t46bbcomponentesutilidades.jar). Descripción Método que devuelve una fecha, a partir de un string con un long y según el formato. Si el formato es vacío, se devuelve la fecha como dd/mm/yyyy. El valor booleano es para indicar, si es una fecha desde (true) o fecha hasta (false). En caso de ser solo una fecha, el valor del booleano debe ser true. Parámetros de entrada fechas Milisegundos de la fecha desde Indica si es o no fecha desde. True es fecha desde. False es fecha hasta. formato Formato en el que se quiere visualizar la fecha. Parámetros de salida Valor de la fecha formateada. Por ejemplo: T46bbUtilidades.devolverFecha(fchaproxInsp, true, "dd/mm/yyyy") NB29_ARQ_Componente Comunes 83/109

91 10.6 Tipo / Subtipo Documentos Se ha definido un componente común para seleccionar el tipo y el subtipo de un documento. Las propiedades del tag son (las subrayadas son obligatorias): <t46bbtiposubtipodocumento:tiposubtipodocumento name="" propertycodigotipo="" propertydescripciontipo="" propertycodigosubtipo="" propertydescripcionsubtipo="" propertyindobligatorio="" propertymbremetadato="" propertyvalormetadato="" propertyvaloresobligatorios="" soloconsulta="" bloqueatipo="" bloqueasubtipo="" bloqueametadato="" descripciontipo="" accionrecuperar="" propertydocumentoet="" reprogramar="" propertynumerometadatos=""/> Name -> mbre del formulario donde se guardarán los datos propertycodigotipo -> Propiedad del formulario donde se guardará el código del tipo de documento propertydescripciontipo -> Propiedad del formulario donde se guardará la descripción del tipo de documento propertycodigosubtipo -> Propiedad del formulario donde se guardará el código del subtipo de documento propertydescripcionsubtipo -> Propiedad del formulario donde se guardará la descripción del subtipo de documento propertyindobligatorio -> Propiedad del formulario donde se guardará si el documento tiene metadatos que son obligatorios recuperar soloconsulta -> Propiedad para indicar que el componente es de solo lectura y se tiene que mostrar en forma no editable bloqueatipo -> Propiedad (true/false) para bloquear la propiedad tipo bloqueasubtipo -> Propiedad (true/false) para bloquear el subtipo NB29_ARQ_Componente Comunes 84/109

92 bloqueametadato -> Propiedad (true/false) para bloquear los metadatos descripciontipo -> Propiedad (true/false) para indicar que la descripción a mostrar es del tipo de documento y no del subtipo accionrecuperar -> Acción a la que se invoca para que se guarden los valores del formulario y se pinten los nombres de los metadatos para que se rellenen. propertydocumentoet -> Propiedad del formulario donde se guardará la entidad DocumentoET con sus datos rellenos. reprogramar -> Valor para indicar que el documento es una reprogramación y que tiene que mostrar los campos de tipo y subtipo. propertynumerometadatos -> Propiedad del formulario donde se guardará el número de metadatos que tiene el documento. propertymbremetadato -> Propiedad del formulario donde se guardarán los nombres de los metadatos. propertyvalormetadato -> Propiedad del formulario donde se guardarán los valores de los metadatos. propertyvaloresobligatorios -> Propiedad del formulario donde se guardarán los valores posibles de un metadato. ta: Las propiedades de nombremetadato, valormetadato y valoresobligatorios se corresponden a la raíz del nombre a usar. Así, en el formulario, se tendrá definidos hasta 5 campos con ese mismo nombre pero terminando con un número (0 4, ambos inclusive) Por ejemplo: En el formulario se definen las siguientes propiedades: <!-- ponemos hasta 5 posibles valores para los metadatos--> <form-property name="nombremetadato0" type="java.lang.string" /> <form-property name="valormetadato0" type="java.lang.string" /> <form-property name="valoresobligatorios0" type="java.lang.string" /> <form-property name="nombremetadato1" type="java.lang.string" /> <form-property name="valormetadato1" type="java.lang.string" /> <form-property name="valoresobligatorios1" type="java.lang.string" /> NB29_ARQ_Componente Comunes 85/109

93 <form-property name="nombremetadato2" type="java.lang.string" /> <form-property name="valormetadato2" type="java.lang.string" /> <form-property name="valoresobligatorios2" type="java.lang.string" /> <form-property name="nombremetadato3" type="java.lang.string" /> <form-property name="valormetadato3" type="java.lang.string" /> <form-property name="valoresobligatorios3" type="java.lang.string" /> <form-property name="nombremetadato4" type="java.lang.string" /> <form-property name="valormetadato4" type="java.lang.string" /> <form-property name="valoresobligatorios4" type="java.lang.string" /> En el tag se pondrá lo siguiente: propertymbremetadato="nombremetadato" propertyvaloresobligatorios="valoresoblimetadato" propertyvalormetadato="valormetadato" Funcionamiento En una acción previa a pintar el componente, se pondrá, en la propiedad del formulario, la entidad del documento que se quiere pintar. Si la entidad es vacía o nula, se pintará el componente para dar de alta (siempre y cuando las opciones de bloqueo o solo consulta no estén marcadas a true). El componente dependiendo del valor de los bloqueos, solo consulta o reprogramar, pintará un campo con el nombre del tipo o subtipo o pintará ambos campos para que se seleccionen. En el caso de que la entidad de transferencia tenga metadatos, se mostrarñan las descripciones para esos metadatos y sus valores. En la acción definida en el atributo accionrecuperar se guardará en el formulario la nueva ET seleccionada junto con los demás campos del formulario y se redirigirá la pantalla otra vez a si misma. Una vez introducidos los metadatos, será necesario validar sus valores. Esta validación no es posible hacerla en GEREMUA pero se han implementado las siguientes funcionalidades para realizar la comprobación: T46bbValidacionesCampo.comprobarValoresMetadatos(documentoETDocument) Siendo documentoetdocument un DocumentoETDocument creado a partir del String que está en la propiedad del formulario definido en el propertydocumentoet. NB29_ARQ_Componente Comunes 86/109

94 Ejemplo del código para validar el documento a guardar: NB29_ARQ_Componente Comunes 87/109

95 String entidadstr = (String)formulario.get("entidadDocET"); documentoetdocument = DocumentoETDocument.Factory.parse(entidadStr); if(!t46bbvalidacionescampo.comprobarvaloresmetadatos(documentoetdocument)){ actionerrors.add("error", new ActionError("error.valores.metadatos")); } else{ } return super.processforward(contexto, actionerrors, mapping, actionform, request, response); NB29_ARQ_Componente Comunes 88/109

96 11 Tab Desplegable El componente tab desplegable nos permite mostrar u ocultar capas que continen información dentro de un formulario, pulsando sobre un icono + (para mostrarla) y (para ocultarla). Para incluirlo, utilizaremos el siguiente código: <t46bb:tabdesplegable capa="" ocultarimagen ="" obligatorio="" texto=""/> Atributos del componente: capa: mbre de la capa asociada para mostrar y ocultar su contenido ocultarimagen: (true/false) no se mostrara la imagen, y no se tendrá en cuenta el valor de capa para nada, ya que solo mostrara el texto. obligatorio: (true/false) marca en negrita el nombre de la capa he indica que contiene campos que son obligatorio rellenarlos, en caso de no tener valor se toma false por defecto texto: nombre subrayado que da información de la capa que contiene Su aspecto visual sería: Componente plegado: Componente desplegado: En este ejemplo hemos usado <!-- capa datos --> <t46bb:tabdesplegable texto="visor.datos" capa="datos" /> <div id='datos' style='display:none'> </div> OTROS ELEMENTOS DEFINIDOS COMO OTRAS CAPAS, ELEMENTOS DE BÚSQUEDA ETC. En el caso de querer usar el componente como separador de bloques de datos pondremos el atributo ocultarimagen=true. NB29_ARQ_Componente Comunes 89/109

97 12 Combo s permite incluir una lista desplegable en nuestra pantalla de formulario. Para incluirlo utilizaremos: <t46bb:combo campo="tipo" name="contexto" property="tiposprocedimientoarray" formulario="formbusqueda" novalorblanco=""/> Descripción de los parámetros del componente: campo: nombre de la property del form-bean donde se recogerá el valor del combo. name: mbre del form-bean asociado que contiene la lista. Property: mbre de la property del form-bean que contiene la lista con los valores a mostrar. formulario: mbre del form-bean donde se recogerá el valor del código de la lista seleccionado. novalorblanco: Permite que se muestre el primer elemento seleccionables sea un valor blanco (opcion por defecto) o no. A tener en cuenta para su utilización: Deberemos tener cargado en un ArrayList de Hashmap los valores a mostrar con el par key-vvalor. La forma en la que esta trabajando el componente es la siguiente: Con el par de name-property recupera la lista con los datos a mostrar en la lista. Cada elemento de la lista se dibuja en una capa mientras que el par fomulario-campo tendrá el valor del elemento seleccionado, en caso de existir. A la hora de seleccionar, el componente mostrar la capa cuyo valor coincida con el elemento seleccionado. Con el componente solo recuperamos el código, no la descripción, así que en caso de necesitar la descripción tendremos que recorrer al array con los valores comparando sus códigos contra el seleccionado. Se permite en el componente combo que no se muestre un elemento en blanco seleccionable, la forma de que éste no se muestre es poner la nueva propiedad no obligatoria novalorblanco= true El componente se mostrará de la siguiente manera: Combo plegado Combo desplegado NB29_ARQ_Componente Comunes 90/109

98 13 Botón A continuación, se explica el componente común botón que se ofrece a las aplicaciones del back office desde los componentes comunes. Este componente debe ser incluido en todas las aplicaciones que se desarrollen para industria en la parte del back office. Dentro se han definido una serie de propiedades que indicarán el comportamiento del botón dentro de la aplicación. Estas se detallan a continuación: <t46bbcomunes:boton accion="" tipoaccion="" estilo="" funcionseguridad="" texto="" i18n="" id="" validar="" deshabilitar="" iniciardeshabilitado= /> Todos estos valores son obligatorios accion = nombre de la acción o función javascript que se quiere ejecutar cuando se realice un click sobre él. tipoaccion = extensión de la acción que se quiere ejecutar. Sus valores son "do" o "js", dependiendo de la acción a realizar. Estilo = estilo vinculado al botón. Sus valores son "botongris" o "botonazul". Texto = etiqueta que se quiere mostrar en el cuerpo del botón. i18n = fichero de recursos donde esta el texto asociado a la etiqueta usada en "texto". Id = valor único de la página para asociar al enlace del botón. Pe: "boton_aceptar", "boton_cancelar", "b_acep_1", "id_buscar"... Validar = true/false. Si es trae, cuando se pulse el botón, se comprobará si se han realizado modificaciones en el formulario y mostrará una ventana pidiendo confirmación para ejecutar la acción que se definió en la propiedad. funcionseguridad = código que securiza el elemento. Si no se posee la función se mostrará una ventana indicando que no se tiene permisos. Deshabilitar = true/false. Si se pone true, el botón sólo se podrá pulsar una vez, tras lo cual se deshabilitara. Deberá ser cada programador quien tiene que volver a activar el botón si realiza alguna validación javascript NB29_ARQ_Componente Comunes 91/109

99 antes de submitir. Es decir, si cuando yo voy a grabar, compruebo con javascript que tengo que tener 2 fechas o campos rellenos, se tendrá que reactivar el botón a través de una función javascript. iniciardeshabilitado= true/false. Si se pone true, el botón se muestra deshabilitado. Una de las propiedades importantes es la que mostrará el botón deshabilitado y no ejecutará ninguna acción en caso de ser presionado o habilitado, que ejecutará la acción que se indique. Esta propiedad es iniciardeshabilitado. Es importante conocer que botones se deben mostrar deshabilitados y cuales no. Un botón como Cancelar nunca se deberá deshabilitar, y tendrá que tener siempre la función de acceso a la aplicación. Esto se debe a que, en algunos casos, se debe acceder a pantallas de detalle y el único botón activo será el de cancelar. En el caso del visor de expedientes, para poder ver la información de un tercero hay que pulsar el botón modificar, así que este botón deberá tener la función de acceso a la aplicación. Una vez dentro de la página del detalle del tercero ésta se mostrará en solo consulta para que a todos los componentes se les pueda pasar la propiedad soloconsulta. Para determinar este valor se utiliza una propiedad de contexto. A continuación, se muestra fragmentos del código con el uso del componente común botón en solo consulta: <%@ page import="es.ejie.frmk.presentacion.sesiondatos.q70contextoejie"%> <% Q70ContextoEJIE contexto = (Q70ContextoEJIE)session.getAttribute("contexto"); boolean soloconsulta = "true".equals((string)contexto.get("visionconsulta")); %>... <tercero:tercero soloconsulta="<%=soloconsulta%>"/> Botón <t46bbcomunes:boton accion="guardartercero('',false)" tipoaccion="js" validar="false" deshabilitar="true" funcionseguridad="pte-grt" estilo="botongris" id="b_guardar" i18n="t46gbrecursos" texto="boton.grabar" iniciardeshabilitado="false"/> Botón explicación NB29_ARQ_Componente Comunes 92/109

100 <t46bbcomunes:boton accion="" accion a ejecutar tipoaccion="" tipo de la acción a ejecutar validar="" si tiene que validar cambios en el formulario deshabilitar="" si tiene que deshabilitar el botón tras click funcionseguridad="" funcion seguridad vinculada al permiso estilo="" estilo del botón (gris o azul) id="" id para asociar al botón (unico en el sistema) i18n="" fichero de recursos texto="" propertie a mostrar en el boton iniciardeshabilitado="" indica si se tiene que mostrar deshabilitado el boton /> confundir la propiedad validar con la función de seguridad. Validar comprueba si se han producido cambios en el formulario. Pero, antes de realizar esta comprobación, se comprueba que se posea la función definida. Si no existe, se mostrará el mensaje indicando que no posee la función necesaria. Es por ello que se utilizará la función de acceso a la aplicación (en el caso del visor de expedientes es GEX-00). NB29_ARQ_Componente Comunes 93/109

101 14 Trabajos Habituales / Recientes El componente trabajos habituales / recientes nos permitirá añadir nuevos trabajos a la lista de habituales o recientes. El componente se utiliza en la cabecera y no requiere apenas configuración. Eso sí, para su funcionamiento correcto deberemos seguir los siguientes pasos: Añadiremos al contexto (struts-config.xml) las siguientes propiedades: <!-- trabajos habituales --> <form-property name="arraytrabajos" type="java.util.arraylist"/> <form-property name="origenurltrabajo" type="java.lang.string"/> <form-property name="destinourltrabajo" type="java.lang.string"/> <form-property name="infotrabajo" type="java.lang.string"/> <form-property name="tipotrabajo" type="java.lang.string"/> <form-property name="idtrabajo" type="java.lang.string"/> <!-- fin trabajos habituales --> El componente utiliza estos valores de contexto para mostrar los enlaces correspondientes, así que realizaremos una tarea similar a la que realizamos con el componente migas, es decir, especificaremos en cada OI o acción previa a mostrar un jsp si se deben mostrar o no los enlaces que nos interesen. Podremos proceder de tres maneras: 1. Especificando todos los puntos del menú en el ArrayList, y si se deben mostrar activos o no: // // -- Preparación de arraytrabajos // (true activa el enlace, false lo desactiva) // ArrayList arraytrabajos = new ArrayList(); HashMap hash = new HashMap(); hash.put("habituales", "true"); hash.put("recientes", "false"); hash.put("paginaaviso", "false"); hash.put("aviso", "false"); arraytrabajos.add(hash); contexto.set("arraytrabajos", arraytrabajos); 2. Especificando sólo aquellos puntos que deben mostrarse activos: ArrayList arraytrabajos = new ArrayList(); HashMap hash = new HashMap(); hash.put("habituales", "true"); arraytrabajos.add(hash); contexto.set("arraytrabajos", arraytrabajos); 3. Dejando el array a null, si no queremos que se active ningún enlace: contexto.set("arraytrabajos", null); NOTA: Es aconsejable poner en el tag de inicio una nueva propiedad con el valor del ArrayList que contiene la lista. Este tag esta situado en la t46xbcabecera.jsp. Por defecto el ArrayList se llamará arraytrabajos. <t46bb:inicio enlaceinicio="<%=webroot%>" enlaceayuda="#" property="arraytrabajos"/> NB29_ARQ_Componente Comunes 94/109

102 Todo lo explicado hasta ahora nos permite almacenar un trabajo habitual o reciente en la lista de trabajos del usuario. Para recuperarlos realizaremos lo siguiente: Sustituiremos el contenido del archivo t46*bpie.jsp, por el siguiente código: <%@ taglib uri="/web-inf/tld/t46bb-html.tld" prefix="t46bb" %> <%@ taglib uri="/web-inf/tld/struts-logic.tld" prefix="logic" %> <t46bb:pie/> <logic:present parameter="recuperartrabajoxxx"> <script type="text/javascript"> <!-- //--> </script> cargartrabajorecuperado(); </logic:present> Las funciones javascript que se encargan de realizar las tareas de recuperar y cargar los trabajos se encuentran en el archivo eventotecladoraton.js que se encuentra en la carpeta de scripts de sgi_comun, así que realizaremos la importación del archivo en el lugar correspondiente (plantilla de la aplicación). NB29_ARQ_Componente Comunes 95/109

103 15 Seguridad El componente seguridad nos permitirá: Comprobar que el usuario ha iniciado una sesión de XL-Nets válida o redireccionarle a la página de inicio si no la tuviera o ésta hubiera caducado. Comprobar que el B29Seguridad del usuario tiene los datos correctos y si no es así, invocar al sistema de seguridad para completarlo. Configurar las aplicaciones para chequear los permisos del usuario y permitirle ejecutar sólo las acciones a las que está autorizado (puntos del menú, botones, ) La configuración de este componente implica, sobre todo, cambios a nivel de Operaciones Internas y Operaciones de Presentación. En todas las clases encargadas de poner y/o recuperar valores del contexto debermos realizar lo siguiente: En el processop tendrán una invocación a la clase padre, ya que ésta se encargará de constituir el nuevo B29Seguridad. En este método la clase padre generará un error en caso de que no exista sesión de XL-Nets, para poder redirigir al usuario a la página de login. En el processforward tendrá un return.super, ya que será la clase padre la que se encargue de redireccionar a XL-Nets en caso de ser necesario Las clases que actúen como Operaciones Internas (OI) extenderán de la clase T46bbActionOIDeclarativo. Las clases que actúen como acciones (es decir pasos de operación sin acceso a la capa de negocio) extenderán de la clase T46bbActionPasoOP. Si alguna de nuestras clases hacía un mapping.forward con un valor que no era ok o error tendrá que modificar las acciones de la operación de presentación. Tendrá que crear un action del tipo Q70ActionDispatchOPDeclarativo que será la que se encargue de procesar según el valor de alguna propiedad a que forward tiene que redirigirse. Además, todas las aplicaciones deberán incluir en su archivo t46xb.properties las siguientes propiedades: XLNET_APLICACION = ioma= INICIO_APLICACION = &N38API=@@@@@@@@/t46gbVisorExpedientesWar/gestorExpedientesJSP/t46gbinicio.d o CAST = Cast EUSK = Eusk NOTA: Dónde sustituiremos por el servidor de aplicaciones correspondiente: o NB29_ARQ_Componente Comunes 96/109

104 Una vez hecho esto, deberemos configurar los enlaces y acciones de las aplicaciones para controlar si el usuario conectado tiene o no los permisos necesarios para realizarlas. Para ello, utilizaremos dos componentes: <t46bb:configuracionseguridadmenu/> que será el encargado de generar un array javascript con el nombre elementosseguridad, que contendrá la lista de funciones de seguridad que tenga el usuario conectado. Este componente lo utilizaremos en las plantillas de nuestras aplicaciones, y se situará en el cuerpo HEAD de la plantilla. Función javascript comprobarseguridad(): Esta función realizará la comprobación del permiso necesario en la lista de funciones de seguridad del usuario y dará o no acceso a la acción correspondiente. Los parámetros serán: o o o Función de seguridad. Enlace, puede ser un.do o una función javascript. Tipo enlace, do o js en función del enlace que hayamos puesto Está función se implementará tanto en los menús de las aplicaciones como en los enlaces y botones de formularios y pantallas. Ejemplo de uso en los menús (configuracionmenus.xml): location="javascript:comprobarseguridad('01','/t46gbvisorexpedienteswar/band ejasjsp/t46gbbusquedafiltro.do','do');" location="javascript:comprobarseguridad('03','javascript:operacciontramiteba ndeja(\'t46gbinspeccionextra.do\', \'INSPECCION EXTRA\', \'true\')','js');" NOTA: En el caso de que sea una función javascript la que pasemos como parámetro tendremos que escapar la posibles comillas que existan (\ ). La función de seguridad se encuentra en el archivo seguridad.js en la carpeta de script de sgi_comun. NB29_ARQ_Componente Comunes 97/109

105 16 Simulación de Xlnets Para el tratamiento de Xlnets en las aplicaciones de industria se debe tener en cuenta las siguientes propiedades. En el fichero de properties de cada aplicación, existirá una propiedad con nombre PATH_XLNET. Si su valor es 1, indica que la instancia de seguridad a usar por la aplicación va a ser simulada, es decir, se llama a un método del sistema de seguridad para que devuelva un b29seguridad ficticio. Si su valor es distinto a 1, indica que la instancia de seguridad se recuperará de XLNET. Para poder simular tiene que existir esta operación y los valores necesarios en el archivo donde se definen las operaciones internas de la aplicación. En el configuracionoi.xml <estructura name="recuperarseguridadsimulado"> <propiedad name="oiclase" value="com.ejie.t46bb.componentes.excepciones.t46bbadaptadorexcepcionesnegocio"/> <propiedad name="fimbre" value="ejb.t47abserviciosinternos"/> <propiedad name="fimetodo" value="recuperarseguridadsimulado"/> <propiedad name="fimapainvocacion" value="datosseguridadsimuladomapai"/> <propiedad name="fimaparetorno" value="resultadomapaseguridadr"/> <propiedad name="oierrorkey" value="error.oi.serviciorecuperarseguridad"/> <propiedad name="fiinitialcontextfactory" value="$$$oi_initial_context$$$"></propiedad> <propiedad name="fiproviderurl" value="$$$oi_provider_tramitaciones_url$$$"></propiedad> </estructura> En el mapasaplicacion.xml <mapa nombre="datosseguridadmapai"> <mapa ref="mapaseguridad"/> <mapa ref="mapausuariosimulado"/> <mapa ref="mapafactoria"/> <mapa ref="maparuta"/> <mapa ref="mapatipo"/> NB29_ARQ_Componente Comunes 98/109

106 <mapa ref="mapaidaplicacion"/> </mapa> <mapa nombre="mapaseguridad" tipoargumento="java.lang.string" nombreargumento="b29seguridad"/> <mapa nombre="mapafactoria" tipoargumento="java.lang.string" nombreargumento="factoriaoperacionejecutar"/> <mapa nombre="mapausuariosimulado" tipoargumento="java.lang.string" nombreargumento="usuariosimuladoejecutar"/> <mapa nombre="maparuta" tipoargumento="java.lang.string" nombreargumento="rutaoperacionejecutar"/> <mapa nombre="mapatipo" tipoargumento="java.lang.string" nombreargumento="tipooperacionejecutar"/> <mapa nombre="mapaidaplicacion" tipoargumento="java.lang.string" nombreargumento="idaplicacion"/> <mapa nombre="resultadomapar" nombredestinoencontexto="listaxml"/> Simulación de las operaciones Si en el fichero de properties de la aplicación, se define la propiedad PATH_SIMULACION= ^^^^ ruta que se quiera ^^^^, la aplicación hará lo siguiente: Busca en la ruta definida en la propiedad, un xml cuyo nombre sea el valor definido en la propiedad parameter de la acción de la operación. Por ejemplo: En el t46**.properties: PATH_SIMULACION=/datos/simulados/ Esto en el strut-**.xml: <action path="" parameter="recuperarseguridad" type="clasea">... </action> Es decir, en el ejemplo, se buscaría en el directorio /datos/simulados el archivo recuperarseguridad.xml. Si este archivo no existe, entonces realiza la llamada a la operación definida en el configuracionoi.xml y crea dicho archivo con el resultado obtenido. Si el archivo existe, entonces pasa el contenido del documento a la variable de contexto definida en el configuracionoi.xml. NB29_ARQ_Componente Comunes 99/109

107 En el caso de querer realizar una simulación, se definirá en el processop de las clases la siguiente llamada request.setattribute("simulacionparamname", "***"); Siendo *** la variable de contexto encargada de recuperar el valor de la llamada. Por ejemplo: En el configuracionoi.xml <estructura name="recuperarseguridad"> <propiedad name="oiclase" value="com.ejie.t46bb.componentes.excepciones.t46bbadaptadorexcepcionesnegocio"/> <propiedad name="fimbre" value="ejb.t47abserviciosinternos"/> <propiedad name="fimetodo" value="recuperarseguridad"/> <propiedad name="fimapainvocacion" value="datosseguridadmapai"/> <propiedad name="fimaparetorno" value="resultadomapaseguridadr"/> <propiedad name="oierrorkey" value="error.oi.serviciorecuperarseguridad"/> <propiedad name="fiinitialcontextfactory" value="$$$oi_initial_context$$$"></propiedad> <propiedad name="fiproviderurl" value="$$$oi_provider_tramitaciones_url$$$"></propiedad> </estructura> En el mapasaplicacion.xml <mapa nombre="datosseguridadmapai"> <mapa ref="mapaseguridad"/> </mapa> <mapa ref="mapafactoria"/> <mapa ref="maparuta"/> <mapa ref="mapatipo"/> <mapa ref="mapaidaplicacion"/> <mapa nombre="mapaseguridad" tipoargumento="java.lang.string" nombreargumento="b29seguridad"/> <mapa nombre="mapafactoria" tipoargumento="java.lang.string" nombreargumento="factoriaoperacionejecutar"/> <mapa nombre="maparuta" tipoargumento="java.lang.string" nombreargumento="rutaoperacionejecutar"/> <mapa nombre="mapatipo" tipoargumento="java.lang.string" nombreargumento="tipooperacionejecutar"/> <mapa nombre="mapaidaplicacion" tipoargumento="java.lang.string" nombreargumento="idaplicacion"/> <mapa nombre="resultadomapar" nombredestinoencontexto="listaxml"/> NB29_ARQ_Componente Comunes 100/10 9

108 En la clasea.java protected void processop(q70contextoejie contexto, ActionErrors actionerrors, ActionMapping mapping, ActionForm actionform, HttpServletRequest request, HttpServletResponse response) throws Exception { } request.setattribute("simulacionparamname", " resultadomapar "); super.processop(contexto, actionerrors, mapping, actionform, request, response); protected ActionForward processforward(q70contextoejie contexto, ActionErrors actionerrors, ActionMapping mapping, ActionForm actionform, HttpServletRequest request, HttpServletResponse response) throws Exception { MiEntidadETDoc mientidadetdoc = null; MiEntidadET mientidadet = null; if (contexto.get("resultadomapar ")!= null && contexto.get("resultadomapar ") instanceof String) { } else { } mientidadetdoc = MiEntidadETDoc.Factory.parse((String)contexto.get("resultadoMapaR ")); mientidadet = mientidadetdoc.getmientidadet(); mientidadetdoc = MiEntidadETDoc.Factory.newInstance(); mientidadet = mientidadetdoc.addnewmientidadet(); contexto.set("variablecontexto", mientidadet); contexto } // o lo que sea que queramos tener en el // puede ser un String, un arraylist, etc return super.processforward(contexto, actionerrors, mapping, actionform, request, response); NB29_ARQ_Componente Comunes 101/10 9

109 17 Validator Validaciones de los componentes comunes Validator-rules-componentes.xml Validación t46bbarraystringobligatorio Comprobación que verifica que se ha seleccionado al menos un campo de checkbox en un listado. sirve para los elementos radio button Validación obligatoriosi Esta validación comprueba si es obligatorio el valor de un campo para el caso que se cumplan ciertas propiedades. Se basa en el método requiredif pero se le añade como valores posibles un NOTEQUAL. Esto se debe a que algunos campos son obligatorios siempre que se cumplan las dos condiciones Validación fechaintervalo Valida si una fecha es mayor que otra y que se ponga la hora si se pone la fecha. También comprueba que, si se pone la de fin, tenga que existir la de inicio Validación documentovalido Esta validación comprueba si se ha informado el tipo identificativo (DNI, CIF, NIE) Validación documentovalidosi Es la misma validación que la anterior pero utilizando la opción de la validación de obligatoriosi. NB29_ARQ_Componente Comunes 102/10 9