top of page

¿Cómo solucionar el error de formatos de configuración regional en Salesforce por API inferior a la 45?

Foto del escritor: Elena IñurrateguiElena Iñurrategui

Estos días nos están llegando muchísimas consultas  de administrador@s y desarrollador@s de Salesforce han recibido una notificación como esta:


"Asunto: Salesforce ATENCIÓN: Fallo de activación de producción.

Hola administrador/a,


Su organización de producción (o sandbox)  XXXXXXX  no se activó con los formatos de configuración regional ICU como se notificó debido a que se utilizó una versión de la API inferior a la 45 en la organización.


Actualice sus clases de Apex, desencadenadores de Apex y páginas personalizadas de Visualforce a la versión 45 o superiores de la API. Para obtener detalles, consulte el artículo de la Ayuda Versiones de API para clases de Apex, desencadenadores de Apex y páginas de Visualforce.


Para formular preguntas sobre la implementación por fases, consulte el artículo de conocimiento Retirada del formato de configuración regional JDK y actualización de versión Activar formatos de configuración regional ICU."


Este mensaje puede generar confusión, pero no te preocupes. En este artículo, te explicamos qué significa, por qué ocurre y cómo solucionarlo.


 ¿Qué significa este error?

Salesforce está migrando sus formatos de configuración regional al estándar ICU (International Components for Unicode), lo que afecta es cómo se manejan fechas, horas, números y monedas. Si tu organización utiliza clases de Apex, desencadenadores o páginas Visualforce con una versión de API inferior a la 45, es posible que no se complete la activación de estos nuevos formatos.


¿Por qué ocurre?

La causa principal es que tu código personalizado todavía usa una versión antigua de la API (anterior a la 45). Esto puede deberse a:

  • Clases de Apex con versiones antiguas.

  • Desencadenadores (triggers) creados antes del cambio.

  • Páginas de Visualforce que no han sido actualizadas.


Pasos para solucionar el problema

Para solucionar este problema podés seguir estos pasos para actualizar tu código y activar correctamente los formatos ICU:


  1. Identificar las clases y componentes afectados

Siempre lo primero que vas a tener qué hacer es identificar cuáles son los elementos afectados.

En este paso de identificación, es indistinto que lo hagas en Sandbox o Producción. Pero los cambios de versiones sólo pueden hacerse desde Sandbox.


Ingresá a Configuración > Configuración Personalizada > Clases de Apex, ordenando por la columna de versión de API y alli veras las que están en una versión de API menor.. 

Este mismo proceso lo repetís para  los Desencadenadores de Apex y las páginas de Visualforce.


Importante: Si la clase, desencadenador o página de Visualforce tiene alguno de estos símbolos adelante, no vas a poder actualizar la versión. 


¿Por qué? Porque forma parte de un paquete gestionado  de una aplicación que descargaste del Appexchange o que creó un@ desarrollador@ con esas características.

En estos casos, debés comunicarte con quién haya desarrollado esa aplicación o paquete para que lo modifique. 

Si lo creó un@ consultor@ o desarrollador@ para tu organización, vas a poder modificarlo en Sandbox y luego pasarlo a Producción. 


2. Actualizar la versión de la API en Sandbox

Las actualizaciones de versiones de API sólo pueden hacerse en Sandbox.

Los pasos para cambiarlas son:

  1. Ingresar a Sandbox

  2. Buscar la Clase, Desencadenador o página con una versión menor a 45. 

  3. Hacer click en el botón Modificar

  4. Hacer click en la pestaña  Version Settings


  5. Cambiar la versión de API

  6. Hacer click en el botón Guardar


3. Probar el impacto en Sandbox

Es importante que pruebes todas las funcionalidades relacionadas con formatos  de fechas, números y  monedas para asegurarte de que no se vean afectadas por el cambio de versión de API.

No deberías tener problemas a menos que haya una fecha o fecha y hora definida en el código. 


4. Migrar a producción

Una vez que hayas testeado el impacto en tu Sandbox, podés migrar los código que modificaste a producción utilizando un conjunto de cambio o el sistema que utilices para migrar metadata. 


Otros recursos

Para entender cualquier cambio de comportamiento, siempre es importante que consultes recursos oficiales de Salesforce. Te dejamos aquí los relevantes en este punto:


Consejos adicionales

  • Siempre realizá todos los testeos necesarios en un ambiente de prueba→  Sandbox.

  • Documentá qué clases y componentes fueron actualizados.

  • Mantené tu código actualizado con las versiones más recientes para evitar este tipo de problemas en el futuro.

  • Acercate a las Office Hours de TRIBO si tienes dudas. 


Si seguís estos pasos, tu organización podrá aprovechar correctamente los formatos ICU, evitando errores y asegurando una mejor experiencia para tus usuarios.



Entradas relacionadas

Ver todo

Comments


bottom of page