DocumentaciónKCS de Experience Cloud

AEM as a Cloud Service: La caché del paquete de recursos i18n no se actualiza después de realizar cambios en el diccionario

Última actualización: 3 de septiembre de 2026

En Adobe Experience Manager as a Cloud Service, es posible que las actualizaciones de los archivos de diccionario i18n en /conf no aparezcan en la caché del paquete de recursos de Sling, lo que provoca que las etiquetas de interfaz de usuario muestren claves i18n sin resolver en lugar del texto traducido.

Descripción description

Entorno

Adobe Experience Manager as a Cloud Service (AEMaaCS) (todas las versiones)

Problema/Síntomas

  • Las claves i18n recién agregadas o actualizadas en /conf/.../i18n/en.json o fr.json están presentes en el repositorio JCR, pero no aparecen en la caché de Sling ResourceBundle.
  • Las etiquetas de interfaz de usuario muestran claves i18n sin procesar (por ejemplo, lblExampleKey) en lugar del texto traducido esperado en el entorno de creación.
  • Los intentos de reconstruir las bibliotecas de cliente o invalidar la caché no resuelven el problema.

Causa

Los archivos de diccionario i18n obsoletos o conflictivos bajo /conf pueden impedir que la caché del Sling ResourceBundle se actualice con claves nuevas. Esto da como resultado etiquetas de IU sin resolver. Eliminar los nodos obsoletos y asegurarse de que solo están presentes los diccionarios deseados permite que la caché se actualice y muestre las traducciones correctas.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Identifique archivos de diccionario i18n obsoletos o en conflicto en /conf, como /conf/<project>/i18n/en.json y fr.json.
  2. Cree un paquete de contenido FileVault con una definición de filtro que dirija los archivos de diccionario obsoletos para su eliminación. Utilice mode="replace" para cada nodo de diccionario obsoleto que desee eliminar y mantenga vacía la carga útil del paquete para esas rutas, de modo que la instalación elimine los nodos especificados del repositorio.
  3. Implemente el paquete a través de la canalización de CI/CD en el entorno de creación.
  4. Repita los cambios en el entorno de publicación para garantizar la coherencia en todos los niveles.
  5. Compruebe que los archivos de diccionario obsoletos, como /conf/<project>/i18n/en.json y fr.json, ya no son accesibles y devuelva una respuesta 404 cuando se accede directamente.
  6. Confirme que las etiquetas de la interfaz de usuario ahora se resuelven en el texto traducido correcto.

Nota

Si migra diccionarios a /apps, agregue los nuevos diccionarios y asegúrese de que los antiguos filtros de /conf usen el modo de reemplazo para eliminar nodos obsoletos en la misma versión.

Lectura relacionada

Internacionalizar componentes y aplicaciones

recommendation-more-help
experience-cloud-kcs-help-kbarticles