AEM Forms fornisce supporto predefinito per le lingue inglese (en), spagnolo (es), francese (fr), italiano (it), tedesco (de), giapponese (ja), portoghese-brasiliano (pt-BR), cinese (zh-CN), cinese-Taiwan (zh-TW) e coreano (ko-KR). È possibile aggiungere il supporto anche per altre impostazioni internazionali, come Hindi(hi_IN).
La localizzazione dei moduli adattivi si basa su due tipi di dizionari locali:
Dizionario specifico per modulo Contiene le stringhe utilizzate nei moduli adattivi. Ad esempio, etichette, nomi dei campi, messaggi di errore, descrizioni dell’Aiuto. Viene gestito come un insieme di file XLIFF per ogni lingua e puoi accedervi all’indirizzo [author-instance]/libs/cq/i18n/gui/translator.html
.
Dizionari globali Nella libreria client AEM sono disponibili due dizionari globali gestiti come oggetti JSON. Questi dizionari contengono messaggi di errore predefiniti, nomi dei mesi, simboli di valuta, modelli di data e ora e così via. Puoi trovare questi dizionari all'indirizzo [author-instance]/libs/fd/xfaforms/clientlibs/I18N
. Questi percorsi contengono cartelle separate per ogni lingua. Poiché i dizionari globali non vengono aggiornati frequentemente, la separazione dei file JavaScript per ciascuna lingua consente ai browser di memorizzarli nella cache e di ridurre l’utilizzo della larghezza di banda di rete quando si accede a moduli adattivi diversi sullo stesso server.
Per aggiungere il supporto per una nuova lingua, effettua le seguenti operazioni:
AEM Forms attualmente supporta la localizzazione di contenuti Forms adattivi nelle lingue inglese (en), spagnolo (es), francese (fr), italiano (it), tedesco (de), giapponese (ja), portoghese-brasiliano (pt-BR), cinese (zh-CN), cinese-Taiwan (zh-TW) e coreano (ko-KR).
Per aggiungere il supporto per una nuova lingua in fase di esecuzione di Adaptive Forms:
git clone https://git.cloudmanager.adobe.com/<my-org>/<my-program>/
.Individua il Guide Localization Service.cfg.json
e aggiungere le impostazioni locali da aggiungere all'elenco delle impostazioni locali supportate.
Crea un file con il nome Guide Localization Service.cfg.json
file, se non già presente.
etc/clientlibs
cartella.locale-name
in etc/clientlibs
per fungere da contenitore per clientlibs xfa e af.Crea un nodo denominato come [locale-name]_xfa
e digita come cq:ClientLibraryFolder
in etc/clientlibs/locale_name
, con categoria xfaforms.I18N.<locale>
e aggiungi i seguenti file:
xfalib.locale.Strings
per <locale>
come definito in /etc/clientlibs/fd/xfaforms/I18N/ja/I18N
.Crea un nodo denominato come [locale-name]_af
e digita come cq:ClientLibraryFolder
in etc/clientlibs/locale_name
, con categoria come guides.I18N.<locale>
dipendenze e come xfaforms.3rdparty
, xfaforms.I18N.<locale>
e guide.common
.
Crea una cartella denominata come javascript
e aggiungi i seguenti file:
guidelib.i18n
, con pattern di "calendarSymbols", datePatterns
, timePatterns
, dateTimeSymbols
, numberPatterns
, numberSymbols
, currencySymbols
, typefaces
per <locale>
secondo le specifiche XFA descritte in Specifica set di impostazioni internazionali.guidelib.i18n.strings
e guidelib.i18n.LogMessages
per <locale>
come definito in /etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js
.Aggiungi js.txt contenente:
i18n.js
LogMessages.js
Esegui questo passaggio solo se <locale>
stai aggiungendo non è tra en
, de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
.
Creare una cartella languages
in etc
, se non già presente.
Aggiungere una proprietà stringa multivalore languages
al nodo, se non già presente.
Aggiungi il <locale-name>
valori predefiniti per le impostazioni locali de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
, se non già presente.
Aggiungi il <locale>
ai valori del languages
proprietà di /etc/languages
.
Aggiungi le cartelle appena create in filter.xml
in etc/META-INF/[gerarchia di cartelle] come:
<filter root="/etc/clientlibs/[locale-name]"/>
<filter root="/etc/languages"/>
Prima di eseguire il commit delle modifiche nell’archivio Git dell’AEM, devi accedere al tuo Informazioni sull’archivio Git.
Apporta le modifiche all’archivio GIT dopo l’aggiunta di un nuovo supporto delle impostazioni internazionali. Distribuisci il codice utilizzando la pipeline full stack. Scopri come impostare una pipeline per aggiungere nuovo supporto per le impostazioni internazionali.
Una volta completata la pipeline, nell’ambiente AEM viene visualizzata la lingua appena aggiunta.
Per utilizzare ed eseguire il rendering di un modulo adattivo utilizzando le impostazioni locali appena aggiunte, effettua le seguenti operazioni:
&afAcceptLang=<locale-name>
nell’URL di un modulo adattivo.Esistono due metodi per identificare le impostazioni locali di un modulo adattivo. Quando viene eseguito il rendering di un modulo adattivo, questo identifica le impostazioni locali richieste tramite:
Recupero di [local]
nell’URL del modulo adattivo. Il formato dell’URL è http://host:[port]/content/forms/af/[afName].[locale].html?wcmmode=disabled
. Utilizzo di [local]
consente di memorizzare in cache un modulo adattivo.
Recupero dei seguenti parametri nell'ordine elencato:
Parametro di richiesta afAcceptLang
Per ignorare le impostazioni locali del browser per gli utenti, puoi trasmettere il
afAcceptLang
per forzare le impostazioni locali. Ad esempio, l’URL seguente forza il rendering del modulo nelle impostazioni locali canadesi-francesi:
https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ca-fr
Impostazioni locali del browser impostate per l'utente, specificate nella richiesta utilizzando Accept-Language
intestazione.
Se non esiste una libreria client per le impostazioni locali richieste, verifica la presenza di una libreria client per il codice della lingua presente nelle impostazioni locali. Ad esempio, se la lingua richiesta è en_ZA
(inglese sudafricano) e la libreria client per en_ZA
non esiste, il modulo adattivo utilizza la libreria client per en
(Inglese), se esiste. Tuttavia, se non esiste nessuno di questi, il modulo adattivo utilizza il dizionario per en
lingua.
Una volta identificate le impostazioni locali, il modulo adattivo seleziona il dizionario specifico per il modulo. Se non viene trovato il dizionario specifico per la lingua richiesta, viene utilizzato il dizionario per la lingua in cui viene creato il modulo adattivo.
Se non sono presenti informazioni sulle impostazioni internazionali, il modulo adattivo viene consegnato nella lingua originale del modulo. La lingua originale è quella utilizzata durante lo sviluppo del modulo adattivo.
Ottenere libreria client di esempio per aggiungere il supporto per le nuove impostazioni locali. È necessario modificare il contenuto della cartella nelle impostazioni internazionali richieste.
L’Adobe consiglia di creare un progetto di traduzione dopo la creazione di un modulo adattivo.
Quando vengono aggiunti nuovi campi in un modulo adattivo esistente:
[server:port]/libs/cq/i18n/gui/translator.html
. Aggiorna il dizionario per i campi appena aggiunti e caricalo.