Añadir una configuración regional para Formularios adaptables basada en componentes principales supporting-new-locales-for-adaptive-forms-localization

Selector de configuración regional de URL ([locale]):

El sistema da prioridad a la configuración regional especificada en la dirección URL mediante el selector [locale]. Este formato permite el almacenamiento en caché para obtener un mejor rendimiento.

Formato: la dirección URL adopta este formato: http:/[AEM Forms Server URL]/content/forms/af/[afName].[locale].html?wcmmode=disabled.

Ejemplo: https://[server]/content/forms/af/contact-us.hi.html procesa el formulario en hindi.

Parámetro de solicitud afAcceptLang:

Para anular la configuración regional del explorador del usuario, puede utilizar el parámetro afAcceptLang en la dirección URL.

Ejemplo: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr fuerza al formulario a procesarse en francés de Canadá.

Configuración regional del explorador del usuario (encabezado Accept-Language):

Si no se especifica ninguna otra configuración regional, AEM Forms adopta la configuración regional del explorador del usuario enviada mediante el encabezado Accept-Language.

Abra la línea de comandos o la ventana de terminal.

Navegue hasta la ubicación deseada en el equipo donde desee almacenar el repositorio (por ejemplo, /adaptive-forms-core-components).

Ejecute el siguiente comando para clonar el repositorio:

git clone https://github.com/adobe/aem-core-forms-components.git

Este comando descarga el repositorio y crea una carpeta denominada aem-core-forms-components en su equipo. En esta guía, nos referimos a esta carpeta como el [Adaptive Forms Core Components repository]

Abra la línea de comandos y seleccione un directorio para almacenar el repositorio de AEM as a Cloud Service, como /cloud-service-repository/.

Ejecute el siguiente comando para clonar el repositorio:

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

Para clonar el repositorio Git, necesita determinada información:

• Nombre de organización: identifica al equipo o proyecto dentro de Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• ID de programa: especifica el programa asociado al repositorio.

• Credenciales: necesita un nombre de usuario y una contraseña (o un token de acceso personal) para acceder al repositorio de forma segura.

¿Dónde se encuentra esta información?

Para obtener instrucciones paso a paso sobre cómo localizar estos detalles, consulte el artículo de Adobe Experience League “Acceder a Git”.

Su proyecto está listo.

Cuando el comando se complete correctamente, verá que se ha creado una nueva carpeta en su directorio local. Esta carpeta recibe el nombre de su programa (por ejemplo, program-id). Esta carpeta contiene todos los archivos y el código descargados del repositorio de Git de AEM as a Cloud Service.

En esta guía, nos referimos a esta carpeta como [AEMaaCS project directory].

Abra la carpeta del repositorio en un editor.

Guarde el archivo Guide Localization Service.cfg.json. Este archivo controla las configuraciones regionales admitidas por la aplicación de AEM Forms. Puede editar este archivo para añadir una nueva configuración regional.

• Archivo existente: si el archivo ya existe, búsquelo en el directorio del proyecto de AEM Forms. La ubicación típica es:

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  Reemplace <appid> por el ID de aplicación específico del proyecto. Puede encontrar <appid> para su proyecto de AEM en el archivo archetype.properties.

  

• Nuevo archivo: si el archivo no existe, debe crearlo en la misma ubicación mencionada anteriormente. No copie y pegue el nombre del archivo de este documento, sino que debe escribirlo manualmente el nombre. El nombre de archivo Guide Localization Service.cfg.json incluye espacios. Es intencionado y no se trata de un error tipográfico de la documentación.

  Un archivo de muestra con la lista de configuraciones regionales compatibles con OOTB es:

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

Añada el código de configuración regional del idioma deseado al archivo.

1. Utilice la Lista de códigos ISO 639-1 para encontrar el código de dos letras que represente el idioma deseado.

2. Añada el código de configuración regional al archivo Guide Localization Service.cfg.json. Estos son algunos ejemplos:

   • Idiomas de izquierda a derecha:

     • Inglés (Estados Unidos): en-US
     • Español (España): es-ES
     • Francés (Francia): fr-FR

   • Idiomas de derecha a izquierda:

     • Árabe (Emiratos Árabes Unidos): ar-ae
     • Hebreo: he (o iw para referencia histórica)
     • Farsi: fa

Después de realizar los cambios, asegúrese de que el archivo Guide Localization Service.cfg.json tiene el formato correcto de un archivo JSON válido. Los errores en el formato JSON pueden impedir que funcione correctamente. Guarde el archivo.

Busque la biblioteca de cliente de ejemplo:

En la copia local del [repositorio de componentes principales de formularios adaptables], navegue hasta la siguiente ruta:

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

Copie y pegue la biblioteca:

1. Copie la carpeta clientlib-it-custom-locale.

   

2. Navegue hasta el siguiente directorio dentro de su [directorio del proyecto AEMaaCS]:

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   Importante: reemplace <app-id> por el ID real de su aplicación.

3. Pegue la carpeta clientlib-it-custom-locale copiada en este directorio.

   

Vaya al directorio de configuración regional adecuado:

Dentro de su [AEMaaCS project directory], vaya a la siguiente ruta:

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

Importante: reemplace <program-id> por su ID de aplicación real.

Busque el archivo de idioma inglés de ejemplo:

AEM Forms proporciona un archivo de configuración regional de ejemplo en inglés (.json) en GitHub.

El archivo en inglés incluye el conjunto predeterminado de cadenas como referencia. El archivo específico de la configuración regional debe imitar la estructura del archivo en inglés.

En idiomas como el árabe, el hebreo y el persa, el texto se lee de derecha a izquierda (RTL) en lugar de izquierda a derecha (LTR) como el inglés. Para garantizar que los formularios se muestren correctamente en estos idiomas, se recomienda utilizar nuestros archivos de configuración regional de ejemplo como guía. Estos archivos proporcionan una referencia sobre cómo dar formato al texto, fechas y otros elementos para los idiomas RTL. Puede encontrar los archivos de configuración regional de ejemplo para los siguientes idiomas:

• Árabe
• Hebreo
• Farsi

Si aprovecha estos archivos de ejemplo, podrá asegurarse de que los formularios proporcionen una experiencia perfecta a los usuarios que trabajan con idiomas RTL.

Cree su archivo de configuración regional:

1. Cree un nuevo archivo .json dentro del directorio i18n.
2. Asigne un nombre al archivo utilizando el código de configuración regional adecuado para el idioma deseado (por ejemplo, fr-FR.json para francés y ar-ae.json para árabe). La estructura de este archivo debe reflejar el archivo de configuración regional en inglés.

Estructura y traducción:

1. Abra el archivo recién creado en un editor de texto.

2. Reemplace los valores en inglés por las traducciones correspondientes para su idioma de destino.

3. Una vez que haya terminado de traducir las cadenas, guarde el archivo.

Localice la carpeta de configuración:

Navegue hasta el siguiente directorio en su [directorio del proyecto AEMaaCS]:

/ui.content/src/main/content/jcr_root/etc

Cree las carpetas necesarias (si faltan):

Si la carpeta etc no está dentro de la carpeta jcr_root, créela. Dentro de etc, cree otra carpeta llamada languages si falta.

Cree el archivo de configuración regional:

En la carpeta languages, cree un nuevo archivo con el nombre .content.xml. No copie y pegue el nombre del archivo de este documento, sino que debe escribirlo manualmente el nombre.

.

Abra este archivo y pegue el siguiente contenido: [LOCALE_CODE] con el código de configuración regional real (por ejemplo, ar-ae para árabe).

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

ADVERTENCIA: No reemplace la lista existente. En su lugar, debe escribir el nuevo código de configuración regional entre corchetes, separados por comas, de esta manera (utilizando ar-ae como ejemplo):

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

Incluya las carpetas nuevas en filter.xml:

Vaya al archivo /ui.content/src/main/content/meta-inf/vault/filter.xml en su [directorio del proyecto AEMaaCS].

Abra el archivo y añada la siguiente línea al final:

<filter root="/etc/languages"/>

Guarde el archivo.