Jutro Digital Platform Jasper

Novedades del parche 10.3.6 de Jutro

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.6:

ID	Descripción
JUT-22215	El inicio de sesión ya no se activa automáticamente en el cliente de autenticación Okta para las páginas que no requieren autenticación.
JUT-21946	La biblioteca okta-auth-js se actualizó a la versión 7.8.1.
JUT-21934	eslint-config ya no utiliza un paquete antiguo esm, que causaba problemas con el nodo 22.
JUT-21785	Se actualizó la dependencia de Webpack a la versión 5.95.0 en @jutro/cli-app.
JUT-21783	Se actualizó @babel/traverse a la versión 7.23.2.
JUT-21787	Se actualizó htmlparser2 a la versión 5.0.0.
JUT-21788	Se actualizó ejs a la versión 3.1.0.
JUT-21793	Se actualizó micromatch a la versión 4.0.8.
JUT-21794	Se actualizó braces a la versión 3.0.3.
JUT-21795	Se actualizó tar a la versión 6.2.1.
JUT-21801	Se actualizó rollup a la versión 2.79.2.
JUT-21804	Se actualizó postcss a la versión 8.4.31.
JUT-21805	Se actualizó express a la versión 4.20.0.
JUT-21805	Se actualizó express a la versión 4.20.0.
JUT-21934	El paquete esm no era compatible con el nodo 22.
JUT-22076	Se actualizó http-proxy-middleware a la versión 2.0.7 para corregir la vulnerabilidad del paquete.
JUT-22077	Se actualizó cookie a la versión 0.7.1 para corregir la vulnerabilidad del paquete.

Novedades del parche 10.3.5 de Jutro

Bibliotecas de interfaz de usuario de Jutro 10.3.5

Cliente de autenticación de Okta

Ahora se admite la autenticación de Okta en el paquete @jutro/auth.

Para habilitar Okta, establezca JUTRO_AUTH_USE_NATIVE_OKTA_CLIENT=true en su entorno. El uso del cliente de autenticación de Okta es igual que el cliente genérico, excepto por los siguientes cambios de comportamiento:

1. Inicio de sesión silencioso y flujo emergente de autenticación simplificados.
   Utiliza un mecanismo personalizado (response-mode: okta_post_message) para pasar los tokens actualizados desde un iframe o ventana emergente ocultos a la ventana principal. Como resultado, no carga ninguna ruta de aplicación. Esto significa que las variables JUTRO_AUTH_SILENT_LOGIN_PATH y JUTRO_AUTH_SILENT_REDIRECT_PATH son obsoletas.

2. La memoria es el almacenamiento de tokens. No hay una opción de service worker. La memoria para el almacenamiento de tokens es la opción más segura en el cliente nativo de Okta. Hay dos diferencias en el comportamiento de la aplicación:

   1. Cada vez que se abre o actualiza una página, se inicia un flujo de inicio de sesión completo para obtener tokens. El usuario verá un cargador y /auth/callback cambia en la navegación de su navegador durante un breve período.
   2. No hay sincronización, cada pestaña usa sus propios tokens.

3. No hay parámetros adicionales. El cierre de sesión con el cliente nativo de Okta ignora los parámetros adicionales de JUTRO_AUTH_LOGOUT_QUERY_EXTRAS.

Para obtener más información sobre el uso del cliente nativo de Okta, consulte la página de documentos de autenticación.

Si ha utilizado el paquete de autenticación nativo de Okta heredado desde la versión 8.12 o anteriores, consulte los pasos para migración del cliente de autenticación para obtener detalles sobre en qué difiere.

Obsolescencia de la versión 18 del nodo

Warning: A partir del 30 de abril de 2025, no podrá crear nuevas aplicaciones en el nodo 18. Está llegando al final de su vida útil y no recibirá actualizaciones de seguridad.

Es posible que la ejecución de versiones obsoletas exponga la aplicación a vulnerabilidades.

Puede migrar aplicaciones existentes al nodo 22 hasta el 30 de septiembre de 2025. Actualice todas las aplicaciones lo antes posible.

El mantenimiento del nodo 18 finaliza en abril de 2025 y no recibirá asistencia técnica después de esa fecha. El uso del nodo 18 en Jutro queda obsoleto y se recomienda actualizar al nodo 22.6.0 o uno posterior.

Para migrar, haga lo siguiente:

• Actualice el campo engines en su package.json a:

  "engines": {
    "node": ">=22.6.0 < 23",
    "npm": ">=10.8.2 "
  }

• Si usa NVM para administrar versiones del nodo, debe actualizar su archivo .nvmrc a v22.6.0.
• Instale Node.js v22.6.0 (y si no es usuario de NVM, elimine la versión anterior).
• Actualice las pruebas unitarias que utilizan Intl (Node.js v22 se actualiza de acuerdo con la última versión de Intl).
• Elimine node-sass de su package.json y agregue "sass": "1.81.0" en su lugar.
  • Si tiene problemas con "sass": "1.81.0", intente usar "sass": "1.77.8" en su lugar.

Para comprobar si la aplicación sigue funcionando con una versión más reciente de Node.js (por ejemplo, en las canalizaciones de TeamCity), haga lo siguiente:

• Actualice el campo engines en su package.json a:

  "engines": {
    "node": ">=22.6.0 < 23",
    "npm": ">=10.8.2 "
  }

• Elimine node-sass de su package.json y agregue "sass": "1.81.0" en su lugar.
  • Si tiene problemas con "sass": "1.81.0", intente usar "sass": "1.77.8" en su lugar.

Warning: Problema conocido

Un cambio en el proceso de traducción en el nodo 22 hace que un carácter de espacio sea reemplazado por un espacio Unicode estrecho de no separación. Esto puede dar lugar a pruebas unitarias fallidas, ya que no coincide con el patrón regex \s.

Note: Webpack 4 no es compatible con el nodo 22; el uso del nodo 22 requiere la actualización a Webpack 5.

Note: Las diferentes versiones de Node.js en entornos locales y de CI pueden llevar a un comportamiento incoherente de las pruebas unitarias para los componentes que utilizan Intl.

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.5:

ID	Descripción
JUT-21453	La redirección de inicio de sesión no respetaba routerBasename.
JUT-21542	La aplicación Jutro genérica mostraba un error al cerrar sesión en una segunda pestaña.
JUT-21543	En el cliente de autenticación genérico, el cierre de sesión no finalizaba la sesión de manera coherente.
JUT-20970	La validación antigua no funcionaba cuando se alternaba la visibilidad de los campos.
JUT-21149	Un error de autenticación aparecía durante el cierre y el inicio de sesión cuando el usuario abría 3 pestañas.
JUT-21177	El menú desplegable DropdownSelectField y TypeaheadMultiSelectField en ModalNext de un microfrontend se renderizaba detrás de la ventana modal.
JUT-21226	El componente cargador de microfrontend no se podía invalidar.

Novedades del parche 10.3.4 de Jutro

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.4:

ID	Descripción
JUT-20964	Si se iniciaban varios flujos de inicio de sesión desde varias pestañas, el estado no era válido y no se podía iniciar sesión.
JUT-20609	Los estilos de encabezado de las ventanas emergentes de ShowConfirmModal estaban rotos.
JUT-21006	JUTRO_AUTH_LOGIN_QUERY_EXTRAS no se pasaban en el inicio de sesión silencioso.
JUT-20929	La autenticación independiente de iframe no funcionaba si iframe era multisitio.
JUT-20857	Cargador infinito al ir a una URL diferente que renderizaba ese mismo microfrontend anidado.
JUT-20420	El cliente OIDC genérico de @jutro/auth llevaba a un usuario de agente inactivo a la pantalla de inicio de sesión de Guidewire Hub.
JUT-20571	Se corrigieron los problemas de sincronización de autenticación al usar varias pestañas.
JUT-20848	El microfrontend de iframe abría varias ventanas emergentes para la autenticación.
JUT-20846	No aparecía una notificación del sistema cuando el microfrontend intermedio usaba la versión 8.13 de Jutro.
JUT-20820	Se solucionó una pérdida de memoria cuando una aplicación de Jutro se cargaba varias veces dentro de un iframe.
JUT-20814	Se aumentó el tiempo de espera de inicio de sesión silencioso.
JUT-19975	location.state pasado al componente enlace no estaba definido.
JUT-20860	El modal no estaba presente en el árbol de accesibilidad.
JUT-20740	Retardo en la aplicación de estilos cuando la vista rápida estaba abierta.
JUT-20970	La validación no funcionaba cuando se alternaba la visibilidad de los campos.

Novedades del parche 10.3.3 de Jutro

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.3:

ID	Descripción
JUT-20420	El cliente OIDC genérico de @jutro/auth llevaba a un usuario de agente inactivo a la pantalla de inicio de sesión de Guidewire Hub, en lugar de a la pantalla de inicio de sesión de su IdP.

Novedades del parche 10.3.2 de Jutro

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.2:

ID	Descripción
JUT-19817	El idioma se cambiaba a inglés después de cerrar la sesión e iniciar sesión cuando se utilizaba el almacén de globalización.
JUT-19818	Se cerraba la sesión del usuario por la inactividad después de cambiar al nuevo cliente genérico Oauth.
JUT-19828	Tener más de dos vistas rápidas en un plano de planta interrumpía la composición y disposición de cuadrícula.
JUT-19840	Guidewire Cloud Home informa 429 (demasiadas solicitudes) después de permanecer inactivo durante 2 horas.
JUT-19854	Las páginas que se abrían con window.open() no debían cerrarse automáticamente después de iniciar sesión.
JUT-19938	La propiedad type de la insignia marca la opción neutral como obsoleta.

Novedades del parche 10.3.1 de Jutro

Mejoras y problemas solucionados

Los siguientes problemas se resolvieron en el parche 10.3.1:

ID	Descripción
JUT-19308	Se corrigió un problema de accesibilidad del componente Avatar relacionado con los roles ARIA.
JUT-19090/JUT-19444	Se solucionó el problema con los estilos que no se aplicaban a los componentes modal y vista rápida cuando se usaban en un microfrontend con el modo moduleFederation.
JUT-19092	Se solucionó un problema que impedía que el microfrontend se volviera a renderizar cuando se actualizaban los datos pasados.
JUT-19243	Se restauró la lógica relacionada con schemaRequired para evitar el problema con las condiciones opcionales de visualización del indicador.
JUT-19481	Se restauró el esquema de metadatos para que coincidiera con la versión 10.0.
JUT-19636	Se evitó el error de tiempo de espera en iPhone cuando se utilizaba el componente Microfrontend con el modo iframe.

Novedades de Jutro Digital Platform Jasper

Jutro Design System 10.3.0

Mejoras técnicas

Esta actualización incluye una serie de mejoras y correcciones de errores.

Componentes nuevos

Se han agregado dos nuevos componentes de hora, los componentes TimezonePicker y TimePicker. Para obtener más información, consulte su página de documentación.

Nuevos componentes que reemplazan componentes obsoletos

Algunos componentes han quedado obsoletos y fueron reemplazados por otros más nuevos. La siguiente lista contiene las importaciones de componentes obsoletos junto con las importaciones actualizadas:

Importación de componente obsoleto	Importación de componente nuevo
import { InputMaskField } from '@jutro/components'	import { MaskInput } from '@jutro/components/new'
import { StepperField } from '@jutro/components'	import { Stepper } from '@jutro/components/new'

Actualización del componente MultipleCombobox

El componente MultipleCombobox ahora contiene una nueva propiedad, onAddNew. Esta devolución de llamada se invoca al agregar una nueva opción. Para obtener más información, consulte la página de Storybook.

Actualización del componente etiqueta

El componente Tag ahora contiene una nueva propiedad, iconAriaLabel. Esto establece el valor aria-label para el botón de ícono de la etiqueta e invalida el rótulo aria predeterminado eliminar o expandir. Para obtener más información, consulte la página de Storybook.

Elementos obsoletos

Hay elementos obsoletos en esta versión. Consulte nuestra página sobre elementos obsoletos para obtener más información.

Jutro Web Apps

Clonación de la aplicación de Jutro

Ahora puede clonar una aplicación de Jutro existente mediante la interfaz de usuario de JWA. Una aplicación nueva clonada tiene su propio repositorio de Bitbucket y la canalización de compilación de TeamCity, y es una aplicación nueva e independiente de la original.

Actualizaciones realizadas para permitir la clonación de aplicaciones:

• Se mejoró el tiempo necesario para crear e implementar la compilación inicial.
• Una nueva API para devolver ramas y etiquetas de Bitbucket.
• Documentación del producto para explicar la clonación de aplicaciones.
• Nueva interfaz de usuario para la característica de clonación de aplicaciones.

Para obtener más información, consulte Clonación de una aplicación de Jutro.

Creación y uso compartido de componentes personalizados con paquetes compartidos

Ahora puede crear y publicar sus propios paquetes de componentes personalizados. Esto le permite crear componentes que se pueden reutilizar en otras aplicaciones. Compartir componentes con esta nueva función elimina la necesidad de copiar y pegar código.

La URL de registro se encuentra en la página Paquetes compartidos, en la pestaña Configuraciones de la aplicación. Este es este registro al que apunta cuando se autentica con npm login.

Actualizaciones realizadas para permitir la creación y el intercambio de componentes personalizados:

• Repositorio de Bitbucket para almacenar los paquetes de componentes personalizados o el código fuente.
• Infraestructura de TeamCity para la creación y distribución de componentes personalizados basados en inquilinos.
• Un repositorio binario para almacenar los archivos binarios de los componentes publicados.
• El acceso a la instalación de componentes compartidos de un sistema principal solo está abierto a quienes tengan los parámetros de grupo de IdP adecuados para ese sistema principal en su token de autenticación.

Para obtener más información, consulte Paquetes compartidos.

Implementaciones mutables e inmutables

Las implementaciones mutables e inmutables ahora están disponibles en Jutro Web Apps. Esta característica es útil cuando se quiere compartir una versión actualizada de la aplicación con un cliente o un colega antes de una versión general. También se pueden utilizar implementaciones inmutables para asegurarse de que puede volver a una versión concreta de una compilación tras una actualización de su aplicación de Jutro.

Para obtener más información, consulte Implementaciones mutable e inmutable.

Otras notas de la versión de JWA

• Se actualizaron las dependencias para mejorar la postura de seguridad.
• Se añadió compatibilidad para superplanetas.
• Se solucionó un problema en el que los dominios personalizados de preproducción se incluían en la lista para los ascensos de producción.
• Se corrigieron problemas que podían bloquear los ascensos.
• Se solucionó un problema por el que la configuración del acceso a BillingCenter no funcionaba correctamente.
• Se solucionó un problema en el que las implementaciones que se renderizaban en el orden incorrecto.
• Se agregó el indicador “heredado” a las implementaciones para cuando las implementaciones inmutables están habilitadas.
• Se solucionó un problema por el cual un usuario sin permisos para ascender una aplicación podía ver el formulario de ascenso, pero no ascender aplicaciones.
• La sección de autenticación del formulario de implementación/ascenso ahora actualiza las variables para que reflejen el código fuente de la compilación que se implementará o ascenderá.
• Se solucionó un problema en el que las clases de planetas no disponibles se podían seleccionar en la creación de la lista de IP permitida.
• La ventana TemplatePreview ahora muestra la versión de la plantilla junto con el nombre de la plantilla.

Para obtener más información sobre todo lo anterior, consulte la documentación de desarrollo de aplicaciones de Jutro.

SDK de Digital 10.3.0

El SDK de Digital está diseñado específicamente para funcionar con las Cloud API de InsuranceSuite y facilitar la interacción con ellas. Puede generar su SDK de Digital a medida dentro de su propia aplicación, en función de sus líneas de negocio. Para ello, utilice Jutro CLI, en función de sus definiciones específicas de la API abierta de Cloud API y de la lista de esquemas expuestos en InsuranceSuite.

Para obtener más información, consulte las notas de la versión del SDK de Digital.

Mejoras y problemas solucionados

ID	Descripción
JUT-18104	Se agregó una propiedad iconAriaLabel para el componente Tag.
JUT-18383	Se agregó la funcionalidad AddNew al componente MultipleCombobox.
JUT-17141	Se agregó el componente TimePicker.
JUT-17142	Se agregó el componente TimezonePicker.
JUT-18425	Se agregó el componente MaskInput para reemplazar al componente InputMaskField.
JUT-18559	Se agregó el componente Stepper para reemplazar al componente StepperField.
AFP-2814	El SDK de Digital muestra un error cuando se intenta recuperar ediciones para líneas de negocio instaladas que no son de APD en la nube.
JUTSDK-1285	Se produce un error en el archivo de índices cuando hay una LOB en varios productos.

Problemas conocidos

Error de sintaxis al ejecutar las pruebas de Jest para aplicaciones después de instalar paquetes compartidos (JINFRA-2064)

Problema: Se arroja SyntaxError: Unexpected token 'export' al ejecutar las pruebas de Jest para aplicaciones después de instalar paquetes compartidos. Esto sucede cuando un paquete compartido requiere una versión estricta de Jutro que no coincida con la versión de Jutro utilizada en su aplicación host. En este caso, se instala una versión duplicada de Jutro en un directorio anidado node_modules para el paquete compartido. Cuando el ejecutor de pruebas de Jest de la aplicación carga el código de JavaScript necesario para las pruebas, Jest tiene problemas para cargar el código proveniente de la versión duplicada de Jutro instalada solo para el paquete compartido.

Solución temporal: Cambie los requisitos de la versión de Jutro del paquete compartido por un intervalo flexible, por ejemplo, ^10.3.0 en lugar de 10.3.0, y vuelva a publicar el paquete compartido. El uso de esta nueva versión publicada en la aplicación permitirá que el paquete compartido reutilice la versión de Jutro de su aplicación host y evitará duplicar Jutro en node_modules. Esto, a su vez, evitará el problema en el que Jest no puede analizar el código duplicado previamente al ejecutar las pruebas.

Entradas en .gitignore que se concatenan con src/i18n/lang.json

Problema: Es posible que se encuentre con problemas donde las entradas recién agregadas a .gitignore se concatenan con la entrada para src/i18n/lang.json.

Solución temporal: Asegúrese de que la entrada src/i18n/lang.json tenga una nueva línea después de ella, de modo que la entrada que le sigue se coloque correctamente en una nueva línea.

En ocasiones, los tokens de autenticación pueden caducar

Problema: Debido a los cambios en la forma de funcionamiento del cliente de autenticación OIDC, en ocasiones, se puede producir un error en el flujo de actualización del token de autenticación al alcanzar el límite de tiempo de espera.

Solución temporal: Se recomienda actualizar a Jutro 10.3.4 o posterior, que soluciona el problema, así como realizar pruebas del comportamiento de carga y renovación de sesiones de la aplicación autenticada a través de conexiones más lentas, por ejemplo, Internet móvil. Como alternativa, puede cambiar del cliente de autenticación OIDC al cliente nativo de autenticación Okta. Para obtener más información, consulte la documentación de autenticación.

En ocasiones, los agentes de escucha globales window.onmessage pueden ejecutarse incorrectamente

Problema: Las versiones anteriores de Jutro se basaban en una funcionalidad de OIDC que aprovechaba las invalidaciones window.onmessage del método global para configurar los agentes de escucha de mensajes. Cierta lógica personalizada puede interferir con esto y provocar errores en la funcionalidad.

Solución temporal: Hay dos soluciones temporales:

• Modifique la invalidación personalizada de la aplicación para utilizar window.addEventListener('message', listener) en su lugar.
• Adopte el parche de Jutro 10.3.4 o uno posterior, que solucionan el problema.
• Cambie del cliente de autenticación OIDC al cliente nativo de autenticación Okta. Para obtener más información, consulte la documentación de autenticación.

Versión actualizada de Webpack (JUT-21785)

Problema: Cuando compila una aplicación de Jutro, puede encontrarse con errores si Webpack está en la lista de dependencias.

Solución temporal: Los errores pueden estar relacionados con su versión de Webpack. Si su versión de Webpack no es 5.95.0, intente actualizar a esa versión y vuelva a compilar la aplicación.

Navegadores compatibles

• Chrome y navegadores basados en Chromium (probados en Chrome v110)
• Firefox (probado en v107)
• Safari (probado en v15.6)
• Tablet y dispositivo móvil (iOS Safari + Android Chrome mismas versiones que arriba)

Dependencias de terceros

• Versión del nodo: 18.14.2 < 19 || >= 22.6.0 < 23
• Versión de NPM: >=9.5.0
• Versión de React: 18.2.0