Skip to content

Actualizar 5.x.x

Jump to bottom Edit New page
Xabi edited this page Apr 9, 2024 · 1 revision

En esta sección iremos indicando como mantenerse actualizado con las últimas versiones disponibles de los componentes de UDA, es decir, cuando ya se dispone de una aplicación generada y se desea incorporar las últimas actualizaciones.

Para el proceso de actualización se da por hecho lo siguiente:

  • La actualización se realiza sobre una aplicación con la versión previa dentro de la misma mayor version 5.x.x. La actualización desde versiones anteriores requiere realizar bastantes modificaciones extras y no está recomendada.
  • Los ficheros originales de RUP no han sido modificados.

Si lo que buscas es información sobre cómo mantener tu entorno de desarrollo actualizado, debes consultar la sección Instalar o por el contrario, si lo que quieres es actualizar una aplicación con UDA 4.x.x, debes de consultar la wiki Actualizar 4.x.x.

IMPORTANTE:

  • Existe la posibilidad de que el validador de JavaScript de Eclipse IDE, arroje falsos positivos con operadores de ES2020 cuando analice la carpeta de estáticos de UDA, a fin de evitar este inconveniente, hay que suspender los validadores de JavaScript sobre la carpeta problemática:
    • Para ello, se debe acceder a las propiedades del proyecto de estáticos, después entrar a la sección de validación y una vez situados en la fila que hace referencia a las validaciones de JavaScript, pulsar sobre el botón que hay en la columna de ajustes (tercera columna) y se abrirá una nueva ventana.
    • En la ventana recién abierta, hay que pulsar sobre el botón que permite crear una regla de exclusión grupal, después seleccionar el grupo creado y a continuación, pulsar sobre el botón de añadir regla, esto abrirá otra ventana donde se deberá seleccionar la segunda opción ("Folder or file name") e incluir la ruta WebContent/rup.
    • Una vez hecho esto, solo habría que pulsar sobre aceptar o aplicar en todas las ventanas que se hayan ido abriendo durante el proceso y finalmente, forzar la ejecución de los validadores, haciendo desaparecer los falsos positivos.

v5.4.1 (09-abril-2024)

Para actualizar una aplicación UDA a la versión v5.4.1 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Templates

Para generar código correspondiente a la versión v5.4.1 de UDA bastará con actualizar las plantillas puesto que el plugin no ha recibido cambios.

Actualizar la versión de x38

Será necesario descargar la nueva versión de x38:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.4.1-RELEASE</com.ejie.x38.version>
</properties>

v5.4.0 (04-enero-2024)

Para actualizar una aplicación UDA a la versión v5.4.0 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.4.0 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las plantillas que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38 y Hdiv

Será necesario descargar la nueva versión de x38 además de la de Hdiv:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.4.0-RELEASE</com.ejie.x38.version>
	<com.ejie.hdiv.ce.version>5.1.0-RELEASE</com.ejie.hdiv.ce.version>
</properties>

Aplicación

Cambiar paquetería del bean secureSerializerModule

En la configuración de jackson, concretamente en jackson-config.xml se debe sustituir la paquetería del bean indicado por la siguiente:

<!-- Serializador utilizado por Hdiv  -->
<bean id="secureSerializerModule" class="com.ejie.x38.hdiv.serialization.EjieSecureModule" />
Implementar un método nuevo en la clase de configuración UDA4HdivConfig

El método permite ajustar configuraciones internas de Hdiv:

@Override
public void customConfigure(final SecurityConfigBuilder builder) {
}
Cambios en el mock de XLNetS

Ha dejado de usarse el componente rup_combo en favor de rup_select, y como para ello ha sido necesario ajustar las claves de los valores que devuelve el mock, ahora solo es compatible con rup_select.

El cambio mínimo a realizar es sencillo, se trata de sustituir el siguiente pedazo de código:

//Se Crea el combo de seleccion
$('#userCombo').rup_combo({
	source : USERNAMES,
	width: 250,
	selected: 'udaAnonymousUser',
	select: function(event, object){
		$('#selectedUserName').html(object.value);	
	}
});

Por este otro:

// Crea el select de seleccion.
$('#userCombo').rup_select({
	data: USERNAMES,
	allowClear: false,
	selected: 'udaAnonymousUser'
});

Aunque en realidad la mejor forma de poner al día la pantalla del mock es realizando todos los cambios del commit Poner al día el mock.

Incluir un formulario para el seeker

El seeker de la tabla (buscador) fallaba porque necesitaba disponer de un formulario, por ese motivo, es necesario incluirlo en la JSP que contenga la tabla siempre y cuando se use este módulo de la tabla. Por ejemplo:

<!-- Formulario necesario para garantizar el correcto funcionamiento del seeker con Hdiv -->
<spring:url value="/table/search" var="seekerURL"/>
<form:form modelAttribute="usuario" id="example_seeker_form" class="d-none" action="${seekerURL}" method="POST">
	<form:input path="nombre" id="nombre_example_seeker_form" />
	<form:input path="apellido1" id="apellido1_example_seeker_form" />
	<form:input path="apellido2" id="apellido2_example_seeker_form" />
	<form:input path="fechaAlta" id="fechaAlta_example_seeker_form" />
	<form:input path="fechaBaja" id="fechaBaja_example_seeker_form" />
	<form:radiobutton path="ejie" value="0"/>
	<form:radiobutton path="ejie" value="1"/>
	<form:select path="rol" id="rol_example_seeker_form" />
</form:form>
Cambios de Hdiv

Ahora existe la posibilidad de desactivar Hdiv sin que esto conlleve problemas en la aplicación. El documento Hdiv menciona los pasos a seguir para su desactivación.

v5.3.0 (24-mayo-2023)

Para actualizar una aplicación UDA a la versión v5.3.0 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.3.0 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las plantillas que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38 y Hdiv

Será necesario descargar la nueva versión de x38 además de la de Hdiv:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.3.0-RELEASE</com.ejie.x38.version>
	<com.ejie.hdiv.ce.version>5.0.0-RELEASE</com.ejie.hdiv.ce.version>
</properties>

Aplicación

Método deprecado

El método getSelectMultipleQuery de la clase de x38 TableManager y que es usado en los DaoImpl ha sido deprecado, en su lugar, debería comenzar a usarse su homólogo de cinco parámetros, enviando como nuevo parámetro el valor de la constante ORDER_BY_WHITE_LIST que contenga la clase desde la que se le llama, por ejemplo:

// Deprecado
StringBuilder sbRemoveMultipleSQL = sbSQL.append(TableManager.getSelectMultipleQuery(tableRequestDto, Usuario.class, params, "ID"));

// Nuevo
StringBuilder sbRemoveMultipleSQL = sbSQL.append(TableManager.getSelectMultipleQuery(tableRequestDto, Usuario.class, params, TableUsuarioDaoImpl.ORDER_BY_WHITE_LIST, "ID"));
Cambios de Hdiv

Comprobar que los cambios descritos en el documento de migración Hdiv EE a Hdiv CE están aplicados

Cambio en la paquetería de las librerías

// Reemplazar la paquetería en todos los archivos que la usen (.java, .xml, etc.)).
// Anterior
package org.hdiv

// Nuevo
package com.ejie.hdiv

v5.2.0 (5-abril-2023)

Para actualizar una aplicación UDA a la versión v5.2.0 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.2.0 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las plantillas que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38 y añadir nueva dependencia para PIF

Será necesario descargar la nueva versión de x38 además de incluir una nueva dependencia:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.2.0-RELEASE</com.ejie.x38.version>
</properties>
<dependency>
	<groupId>commons-configuration</groupId>
	<artifactId>commons-configuration</artifactId>
	<version>1.6</version>
</dependency>

Aplicación

En esta versión, es necesario llevar a cabo los siguientes cambios indicados en el documento migración Hdiv EE a Hdiv CE.

v5.1.0 (14-noviembre-2022)

Para actualizar una aplicación UDA a la versión v5.1.0 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.1.0 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las plantillas que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38

Para actualizar la librería habrá que descargar la nueva versión de x38 y seguir los siguientes pasos:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.1.0-RELEASE</com.ejie.x38.version>
</properties>

Aplicación

En esta versión, es necesario llevar a cabo los siguientes cambios de configuración:

  • Incluir la propiedad DEFAULT_LANG en el archivo base-includes de la aplicación que está ubicado en xxxAppWar\WebContent\WEB-INF\layouts\base-includes.jsp:

     DEFAULT_LANG = "${mvcInterceptor.defaultLanguage}"

  • Añadir la propiedad locale.allowInheritance que sirve para definir la herencia en LocaleContextHolder. Realizar el cambio en el archivo properties de la aplicación que está ubicado en xxxConfig\xxx.properties:

     #Locale
 locale.allowInheritance=false

Esta versión incluye una gran actualización del componente rup_tree en la que se ha actualizado el componente subyacente (jsTree v3.3.12) y se ha eliminado código innecesario u obsoleto, por lo que en caso de usarlo, es necesario revisar la documentación de rup_tree y jsTree para poder realizar los cambios pertinentes.

También ha sido incluido un nuevo componente llamado rup_select que viene a sustituir a los actuales rup_autocomplete y rup_combo, por este motivo, a partir de ahora quedan deprecados y serán eliminados en UDA 6.0.0. Los métodos que expone el nuevo componente son similares a los existentes, lo que facilita enormemente su adopción. Puede encontrarse más información en la documentación del componente.

v5.0.4 (20-julio-2022)

Para actualizar una aplicación UDA a la versión v5.0.4 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.0.4 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las templates que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38

Para actualizar la librería habrá que descargar la nueva versión de x38 y seguir los siguientes pasos:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.0.4-RELEASE</com.ejie.x38.version>
</properties>

Aplicación

En esta versión, hay varios cambios a llevar a cabo:

  • Sustituir la clase com.ejie.x38.util.UdaMultipartResolver del bean multipartResolver que está en xxxAppWar\WebContent\WEB-INF\spring\mvc-config.xml por org.hdiv.web.multipart.HdivCommonsMultipartResolver.

  • Por sugerencia de esta norma de Hdiv, hay que activar el escapamiento por defecto de HTML. Para ello, se deben de incluir las siguientes líneas en el fichero de configuración de Spring xxxAppWar\WebContent\WEB-INF\web.xml:

    <context-param>
	<param-name>defaultHtmlEscape</param-name>
	<param-value>true</param-value>
</context-param>

  • También hay que incluir estas propiedades en el archivo properties de la aplicación que está ubicado en xxxConfig\xxx.properties:

    isEjie=true

#Cookie
cookie.rootPath=true
cookie.secure=false

    Los valores de las propiedades arriba expuestos suelen ser los más comunes, pero es importante ajustarlos al caso de uso de cada aplicación:

    • isEjie: indica si la aplicación es para un entorno de EJIE. La inmensa mayoría de veces este campo tendrá un valor true.
    • cookie.rootPath: permite definir / como el path de la cookie de idioma. Hasta ahora, ese ha sido el valor usado y por el momento, true se considerará el valor habitual, aunque para todos aquellos casos en los que se quiera que el path de la cookie solo sirva para el contexto de la aplicación, será necesario definir el valor de la propiedad a false.
    • cookie.secure: define si la cookie solo será enviada bajo conexiones seguras. Para entornos locales e intranet el valor común suele ser false y true para aplicaciones expuestas en internet.

  • Es necesario eliminar la definición del bean localeResolver (genera la cookie del idioma) en el fichero xxxAppWar\WebContent\WEB-INF\spring\mvc-config.xml y crearla de nuevo en una clase llamada MvcConfig en xxxAppWar\src\com\ejie\config con el siguiente código:

    package com.ejie.xxx.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.context.WebApplicationContext;
import org.springframework.web.servlet.i18n.CookieLocaleResolver;

import com.ejie.x38.util.StaticsContainer;

@Configuration
public class MvcConfig {

	/** 
	 * Gestiona la locale (idioma) mediante una cookie.
	 * 
	 * @param webApplicationContext Contexto de la aplicación Web.
	 * @return La cookie de idioma.
	 */
	@Bean
	public CookieLocaleResolver localeResolver(WebApplicationContext webApplicationContext) {
		final CookieLocaleResolver cookieLocaleResolver = new CookieLocaleResolver();
		cookieLocaleResolver.setCookieName("language");
		cookieLocaleResolver.setCookieHttpOnly(false);
		cookieLocaleResolver.setCookieSecure(StaticsContainer.isCookieSecure());
		cookieLocaleResolver.setCookiePath(
				(StaticsContainer.isCookiePathRoot() ? "/" : webApplicationContext.getServletContext().getContextPath())
						+ "; SameSite=Lax;");
		return cookieLocaleResolver;
	}

}

v5.0.3 (3-mayo-2022)

Para actualizar una aplicación UDA a la versión v5.0.3 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.0.3 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las templates que correspondan a la versión. Es importante no marcar la casilla que dice "Contact all update sites during install to find required software" porque actualizará paquetes de Eclipse IDE a versiones no compatibles con la JDK 1.8.

Actualizar la versión de x38

Para actualizar la librería habrá que descargar la nueva versión de x38 y seguir los siguientes pasos:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.0.3-RELEASE</com.ejie.x38.version>
</properties>

Además se deberán actualizar las dependencias de Hdiv.

  • Eliminar en el fichero xxxEar\pom.xml 
<properties>
	<hdivsecurity.version>2.4.1</hdivsecurity.version>
</properties>
<dependencies>
	<dependency>
		<groupId>com.hdivsecurity</groupId>
		<artifactId>hdiv-for-services</artifactId>
		<version>${hdivsecurity.version}</version>
		<exclusions>
			<exclusion>
				<groupId>com.github.fge</groupId>
				<artifactId>btf</artifactId>
			</exclusion>
			<exclusion>
				<groupId>com.github.fge</groupId>
				<artifactId>jackson-coreutils</artifactId>
			</exclusion>
			<exclusion>
				<groupId>com.fasterxml.jackson.module</groupId>
				<artifactId>jackson-module-jsonSchema</artifactId>
			</exclusion>
			<exclusion>
				<groupId>net.jcip</groupId>
				<artifactId>jcip-annotations</artifactId>
			</exclusion>
			<exclusion>
				<groupId>com.edropple.jregex</groupId>
				<artifactId>jregex</artifactId>
			</exclusion>
			<exclusion>
				<groupId>com.github.fge</groupId>
				<artifactId>json-patch</artifactId>
			</exclusion>
			<exclusion>
				<groupId>com.github.jsqlparser</groupId>
				<artifactId>jsqlparser</artifactId>
			</exclusion>
			<exclusion>
				<groupId>javax.annotation</groupId>
				<artifactId>jsr250-api</artifactId>
			</exclusion>
			<exclusion>
				<groupId>net.sourceforge.streamsupport</groupId>
				<artifactId>streamsupport</artifactId>
			</exclusion>
			<exclusion>
				<groupId>stax</groupId>
				<artifactId>stax-api</artifactId>
			</exclusion>
			<exclusion>
				<groupId>javax.activation</groupId>
				<artifactId>activation</artifactId>
			</exclusion>
			<exclusion>
				<groupId>org.freemarker</groupId>
				<artifactId>freemarker</artifactId>
			</exclusion>
		</exclusions>
	</dependency>
</dependencies>
  • Insertar las nuevas dependencias de Hdiv:
<properties>
	<hdivsecurity.version>2.6.6</hdivsecurity.version>
	<org.hdiv.version>2.8.27</org.hdiv.version>
	<org.hdiv.ee.version>3.5.2</org.hdiv.ee.version>
</properties>

<dependencies>
	<dependency>
		<groupId>com.hdivsecurity</groupId>
		<artifactId>hdiv-for-services-hateoas0</artifactId>
		<version>${hdivsecurity.version}</version>
		<exclusions>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-webmvc</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-aop</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-beans</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-context</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-core</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-expression</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-web</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>commons-logging</groupId>
			  <artifactId>commons-logging</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>com.edropple.jregex</groupId>
			  <artifactId>jregex</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-jdbc</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>com.fasterxml.jackson.module</groupId>
			  <artifactId>jackson-module-jsonSchema</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>javax.annotation</groupId>
			  <artifactId>jsr250-api</artifactId>				
			</exclusion>
			<exclusion>
			  <groupId>javax.activation</groupId>
			  <artifactId>activation</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>net.jcip</groupId>
			  <artifactId>jcip-annotations</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>commons-io</groupId>
			  <artifactId>commons-io</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>com.fasterxml.jackson.core</groupId>
			  <artifactId>jackson-annotations</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.slf4j</groupId>
			  <artifactId>slf4j-api</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>org.springframework</groupId>
			  <artifactId>spring-tx</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>javax.validation</groupId>
			  <artifactId>validation-api</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>com.fasterxml.jackson.core</groupId>
			  <artifactId>jackson-core</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>com.google.code.findbugs</groupId>
			  <artifactId>jsr305</artifactId>
			</exclusion>
			<exclusion>
			  <groupId>net.sourceforge.streamsupport</groupId>
			  <artifactId>streamsupport</artifactId>
			</exclusion>
		</exclusions>
	</dependency>
	<dependency>
	  <groupId>org.hdiv</groupId>
	  <artifactId>hdiv-config</artifactId>
	  <version>${org.hdiv.ee.version}</version>
	</dependency>
	<dependency>
	  <groupId>org.hdiv</groupId>
	  <artifactId>hdiv-core</artifactId>
	  <version>${org.hdiv.ee.version}</version>
	</dependency>
	<dependency>
	  <groupId>org.hdiv</groupId>
	  <artifactId>hdiv-services</artifactId>
	  <version>${org.hdiv.ee.version}</version>
	</dependency>
	<dependency>
	  <groupId>org.hdiv.ee</groupId>
	  <artifactId>hdiv-ee-discovery-core</artifactId>
	  <version>${org.hdiv.version}</version>
	</dependency>
	<dependency>
	  <groupId>org.hdiv.ee</groupId>
	  <artifactId>hdiv-ee-commons</artifactId>
	  <version>${org.hdiv.version}</version>
	</dependency>
	<dependency>
	  <groupId>org.hdiv.ee</groupId>
	  <artifactId>hdiv-ee-config</artifactId>
	  <version>${org.hdiv.version}</version>
	</dependency>	
	<dependency>
	  <groupId>org.hdiv.ee</groupId>
	  <artifactId>hdiv-ee-spring-mvc</artifactId>
	  <version>${org.hdiv.version}</version>
	</dependency>
	<dependency>
		<groupId>javassist</groupId>
		<artifactId>javassist</artifactId>
		<version>3.6.0.GA</version>
	</dependency>
	<dependency>
		<groupId>commons-dbcp</groupId>
		<artifactId>commons-dbcp</artifactId>
		<version>1.2.2</version>
	</dependency>

</dependencies>

v5.0.2 (29-diciembre-2021)

Para actualizar una aplicación UDA a la versión v5.0.2 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.0.2 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las templates que correspondan a la versión.

Actualizar la versión de x38

Para actualizar la librería habrá que descargar la nueva versión de x38 y seguir los siguientes pasos:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.0.2-RELEASE</com.ejie.x38.version>
</properties>

Aplicación

El fichero xxxAppWar\WebContent\WEB-INF\includeTemplate.inc contiene una asignación incorrecta por no ser el lugar adecuado (solo si se generó la aplicación como desarrollo para EJIE) y otra totalmente innecesaria, por lo tanto, hay que eliminar ambas:

<script>
//Habilitamos el envío de trazas a PIB
window.IS_EJIE = true;
</script>
<c:set var="staticsUrl" value='${staticsUrl}' />

Siempre y cuando se trate de un desarrollo para EJIE, es posible habilitar el envío de trazas a PIB definiendo en los ficheros correctos el primer bloque de código anteriormente eliminado. Esto nos ayudará a conocer el uso real de los componentes, permitiéndonos enfocarnos más en el desarrollo de unos u otros. Si se desea activar, hay que incluir el siguiente bloque de código en todos los xxxAppWar\WebContent\WEB-INF\layouts\template***.jsp justo antes del cierre de la etiqueta head:

<script>
	// Habilitar el envío de trazas a PIB.
	window.IS_EJIE = true;
</script>

Cambios opcionales

Incluir fichero de estilos personalizados

Puede que no todas las aplicaciones tengan la necesidad de crear estilos personalizados, por ese motivo este cambio se presenta como opcional, pero, en caso de necesitar crear estilos específicos para la aplicación, habrá que generar un fichero CSS e incluirlo en xxxAppWar\WebContent\WEB-INF\layouts\includes\xxx.styles.inc:

<!-- CSS personalizado -->
<link href="${staticsUrl}/xxx/styles/xxx.css" rel="stylesheet" type="text/css" />
Añadir appender de Hdiv a logback.xml

Aunque este cambio también es opcional, se aconseja llevarlo a cabo porque permitirá disponer de las trazas de Hdiv en un fichero específico, para ello, bastará con añadir las siguientes definiciones en el fichero xxxConfig\logback.xml del proyecto que contiene las configuraciones de la aplicación:

<appender name="salidaHdivAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
	<File>${log.path}/salidaHdiv_${CONTEXT_NAME}_${weblogic.Name}.log</File>
	<encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
		<layout class="com.ejie.x38.log.LogLayout">
			<appCode>${CONTEXT_NAME}</appCode>
			<instance>${weblogic.Name}</instance>	
		</layout>
	</encoder>
	<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
		<!-- rollover daily -->
		<fileNamePattern>${log.path}/salidaHdiv_${CONTEXT_NAME}_${weblogic.Name}.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
		<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
			<maxFileSize>100MB</maxFileSize>
		</timeBasedFileNamingAndTriggeringPolicy>
		<!-- 7-day history -->
		<maxHistory>6</maxHistory>
	</rollingPolicy>
</appender>

<!-- Appender para las trazas de Hdiv -->
<logger name="com.ejie.x38.hdiv" level="${log.level.udaTrazas}">
	<appender-ref ref="salidaHdivAppender"/>
</logger>

<logger name="com.hdivsecurity" level="${log.level.udaTrazas}">
	<appender-ref ref="salidaHdivAppender"/>
</logger>

<logger name="org.hdiv" level="${log.level.udaTrazas}">
	<appender-ref ref="salidaHdivAppender"/>
</logger>

v5.0.1 (20-julio-2021)

Para actualizar una aplicación UDA a la versión v5.0.1 se deben realizar las siguientes modificaciones.

Componentes RUP

Se debe sustituir la carpeta xxxStatics\WebContent\rup por la carpeta incluida en el fichero rup.

Plugin y Templates

Para generar código correspondiente a la versión v5.0.1 de UDA mediante el plugin de generación de código, se deberá actualizar y usar también las templates que correspondan a la versión.

Actualizar la versión de x38

Para actualizar la librería habrá que descargar la nueva versión de x38 y seguir los siguientes pasos:

  • Actualizar fichero xxxEar\pom.xml 
<properties>
	<com.ejie.x38.version>5.0.1-RELEASE</com.ejie.x38.version>
</properties>

v5.0.0 (30-junio-2021)

La actualización de una aplicación UDA desde una versión 4.x.x a la nueva versión v5.0.0 se recoge de forma más detallada en el siguiente documento.

Siempre es recomendable actualizar lo siguiente:

La documentación y la información contenida en estas páginas se ofrecen bajo licencia

El plugin , las extensiones para Hibernate Tools, las plantillas de generación de código, las librerías de utilidades y los componentes RUP se ofrecen con arreglo a la European Union Public Licence (EUPL), exclusivamente en su versión 1.1.

Clone this wiki locally