Aggiungere una lingua per un modulo adattivo basato sui componenti core supporting-new-locales-for-adaptive-forms-localization

Selettore impostazioni internazionali URL ([lingua]):

Il sistema assegna la priorità alle impostazioni locali specificate nell'URL utilizzando [lingua] selettore. Questo formato consente la memorizzazione nella cache per prestazioni migliori.

Formato: L’URL segue questo formato: http:/[URL del server AEM Forms]/content/forms/af/[afName].[lingua].html?wcmmode=disabled.

Esempio: https://[server]/content/forms/af/contact-us.hi.html esegue il rendering del modulo in hindi.

Parametro di richiesta afAcceptLang:

Per ignorare le impostazioni locali del browser dell'utente, è possibile utilizzare afAcceptLang nell'URL.

Esempio: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr forza il rendering della forma in francese canadese.

Impostazioni locali browser dell'utente (intestazione Accept-Language):

Se non viene specificata nessun'altra lingua, AEM Forms considera le impostazioni locali del browser dell'utente inviate utilizzando Accept-Language intestazione.

Apri la riga di comando o la finestra del terminale.

Passa alla posizione desiderata sul computer in cui desideri memorizzare l’archivio (ad esempio, /adaptive-forms-core-components).

Esegui il comando seguente per clonare l’archivio:

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

Questo comando scarica l’archivio e crea una cartella denominata aem-core-forms-components sul tuo computer. In questa guida, questa cartella viene definita [Adaptive Forms Core Components repository]

Apri la riga di comando e scegli una directory per memorizzare l’archivio as a Cloud Service AEM, ad esempio /cloud-service-repository/.

Esegui il comando seguente per clonare l’archivio:

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

Per clonare l’archivio Git, sono necessarie alcune informazioni:

• Nome organizzazione: identifica il team o il progetto in Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service).

• ID programma: specifica il programma associato all’archivio.

• Credenziali: per accedere all’archivio in modo sicuro, devi disporre di un nome utente e di una password (o di un token di accesso personale).

Dove si trovano queste informazioni?

Per istruzioni dettagliate su come individuare questi dettagli, consulta l’articolo di Adobe Experience League "Accesso a Git".

Il progetto è pronto.

Al termine del comando viene visualizzata una nuova cartella creata nella directory locale. Questa cartella prende il nome dal programma (ad esempio, program-id). Questa cartella contiene tutti i file e il codice scaricati dall’archivio Git as a Cloud Service dall’AEM.

In questa guida, questa cartella viene definita [AEMaaCS project directory].

Apri la cartella dell’archivio in un editor.

Individua il Guide Localization Service.cfg.json file. Questo file controlla le lingue supportate dall’applicazione AEM Forms. È possibile modificare questo file per aggiungere una nuova lingua.

• File esistente: se il file esiste già, individualo nella directory del progetto AEM Forms. La posizione tipica è:

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

  Sostituisci <appid> con l’ID app specifico del progetto. Puoi trovare <appid> per il progetto AEM nel archetype.properties file.

  

• Nuovo file: se il file non esiste, devi crearlo nella stessa posizione indicata in precedenza. Non copiare e incollare il nome del file da questo documento, ma digitarlo manualmente. Nome del file Guide Localization Service.cfg.json include spazi. Questo è intenzionale e non è un errore di battitura nella documentazione.

  Di seguito è riportato un esempio di file con l'elenco delle impostazioni internazionali supportate da OOTB:

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

Aggiungi al file il codice locale per la lingua desiderata.

1. Utilizza il Elenco dei codici ISO 639-1 per trovare il codice di due lettere che rappresenta la lingua desiderata.

2. Includi il codice locale in Guide Localization Service.cfg.json file. Di seguito sono riportati alcuni esempi:

   • Lingue da sinistra a destra:

     • Inglese (Stati Uniti): en-US
     • Spagnolo (Spagna): es-ES
     • Francese (Francia): fr-FR

   • Lingue da destra a sinistra:

     • Arabo (Emirati Arabi Uniti): ar-ae
     • Ebraico: he (o iw come riferimento storico)
     • Farsi: fa

Dopo aver apportato le modifiche, assicurati che Guide Localization Service.cfg.json il file è formattato correttamente come file JSON valido. Errori nella formattazione JSON possono impedirne il corretto funzionamento. Salva il file.

Individua la libreria client di esempio:

Nella copia locale del [Archivio dei componenti core di Forms adattivi], passa al seguente percorso:

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

Copiare e incollare la libreria:

1. Copia il clientlib-it-custom-locale cartella.

   

2. Passa alla seguente directory all’interno della [Directory del progetto AEMaaCS]:

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

   Importante: Sostituisci <app-id> con l’ID effettivo dell’applicazione.

3. Incolla il copiato clientlib-it-custom-locale in questa directory.

   

Passare alla directory delle impostazioni internazionali:

All’interno del tuo [AEMaaCS project directory], passa al seguente percorso:

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

Importante: Sostituisci <program-id> con l'ID applicazione effettivo.

Individua il file di esempio in lingua inglese:

AEM Forms fornisce una file locale inglese di esempio (.json) su GitHub.

Il file in lingua inglese include il set di stringhe predefinito come riferimento. Il file specifico della lingua deve simulare la struttura del file in lingua inglese.

Per lingue come l'arabo, l'ebraico e il farsi, il testo legge da destra a sinistra (RTL) invece che da sinistra a destra (LTR) come l'inglese. Per garantire la corretta visualizzazione dei moduli in queste lingue, si consiglia di utilizzare i file locali di esempio come guida. Questi file forniscono un riferimento per la formattazione di testo, date e altri elementi per le lingue RTL. È possibile trovare i file delle impostazioni locali di esempio per:

• Arabo
• Ebraico
• Farsi

Sfruttando questi file di esempio, è possibile garantire che i moduli forniscano un’esperienza fluida agli utenti che lavorano in lingue RTL.

Creare il file delle impostazioni internazionali:

1. Crea un nuovo file .json all’interno di i18n directory.
2. Denomina il file utilizzando il codice locale appropriato per la lingua desiderata (ad esempio, fr-FR.json per il francese e ar-ae.json per l’arabo). La struttura di questo file deve rispecchiare il file delle impostazioni locali in inglese.

Struttura e traduzione:

1. Apri il file appena creato in un editor di testo.

2. Sostituisci i valori in inglese con le traduzioni corrispondenti per la tua lingua di destinazione.

3. Una volta completata la traduzione delle stringhe, salva il file.

Individua la cartella di configurazione:

Passa alla seguente directory nel [Directory del progetto AEMaaCS]:

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

Crea le cartelle necessarie (se mancanti):

Se il etc la cartella non esiste in jcr_root cartella, creala. Interno etc, crea un’altra cartella denominata languages se manca.

Creare il file di configurazione delle impostazioni locali:

All'interno del languages cartella, crea un nuovo file denominato .content.xml. Non copiare e incollare il nome del file da questo documento, ma digitarlo manualmente.

Apri questo file e incolla il seguente contenuto, sostituendo [LOCALE_CODE] con il codice locale effettivo (ad esempio, ar-ae per l’arabo).

<?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]"/>

AVVISO: non sostituire l'elenco esistente. Aggiungi invece il nuovo codice locale tra parentesi quadre, separate da virgole, come segue (utilizzando ar-ae come esempio):

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

Includi le nuove cartelle nel file filter.xml:

Accedi a /ui.content/src/main/content/meta-inf/vault/filter.xml file nel tuo [Directory del progetto AEMaaCS].

Apri il file e aggiungi la seguente riga alla fine:

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

Salva il file.