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

Selettore impostazioni locali URL ([impostazioni locali]):

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

Formato: l'URL segue questo formato: http:/[URL server AEM Forms]/content/forms/af/[afName].[impostazioni locali].html?wcmmode=disabled.

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

afAcceptLang Parametro richiesta:

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

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

Impostazioni locali browser utente (intestazione Accept-Language):

Se non vengono specificate altre impostazioni locali, AEM Forms considera le impostazioni locali del browser dell'utente inviate utilizzando l'intestazione Accept-Language.

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 nel computer. In questa guida questa cartella viene indicata come [Adaptive Forms Core Components repository]

Aprire la riga di comando e scegliere una directory in cui archiviare l'archivio AEM as a Cloud Service, 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: è necessario un nome utente e una password (o un token di accesso personale) per accedere al repository in modo sicuro.

Dove trovare 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 di AEM as a Cloud Service.

In questa guida questa cartella viene indicata come [AEMaaCS project directory].

Apri la cartella dell’archivio in un editor.

Individuare il file Guide Localization Service.cfg.json. 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 file archetype.properties.

  

• Nuovo file: se il file non esiste, è necessario crearlo nella stessa posizione indicata in precedenza. Non copiare e incollare il nome del file da questo documento, ma digitarlo manualmente. Il nome 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. Utilizzare Elenco di codici ISO 639-1 per trovare il codice di due lettere che rappresenta la lingua desiderata.

2. Includere il codice locale nel file Guide Localization Service.cfg.json. 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, verificare che il file Guide Localization Service.cfg.json sia 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 dell'[archivio dei componenti core adattivi di Forms], passa al percorso seguente:

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

Copiare e incollare la libreria:

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

   

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 la cartella clientlib-it-custom-locale copiata in questa directory.

   

Passare alla directory delle impostazioni internazionali:

All'interno di [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 il tuo ID applicazione effettivo.

Individua il file di esempio in lingua inglese:

AEM Forms fornisce un 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. Creare un nuovo file .json nella directory i18n.
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 nella directory del progetto [AEMaaCS]:

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

Crea le cartelle necessarie (se mancanti):

Se la cartella etc non esiste nella cartella jcr_root, creala. All'interno di etc, creare un'altra cartella denominata languages se manca.

Creare il file di configurazione delle impostazioni locali:

Nella cartella languages, creare 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 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:

Passa al file /ui.content/src/main/content/meta-inf/vault/filter.xml nella directory del progetto [AEMaaCS].

Apri il file e aggiungi la seguente riga alla fine:

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

Salva il file.