Supporto di nuove lingue per la localizzazione di moduli adattivi supporting-new-locales-for-adaptive-forms-localization
Informazioni sui dizionari delle impostazioni internazionali about-locale-dictionaries
La localizzazione dei moduli adattivi si basa su due tipi di dizionari locali:
Dizionario specifico per modulo Contiene stringhe utilizzate nei moduli adattivi. Ad esempio, etichette, nomi dei campi, messaggi di errore, descrizioni della guida e così via. Viene gestito come un insieme di file XLIFF per ogni lingua e puoi accedervi all'indirizzo https://<host>:<port>/libs/cq/i18n/translator.html
.
Dizionari globali Nella libreria client AEM sono presenti 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 in CRXDe Lite su /libs/fd/xfaforms/clientlibs/I18N. Questi percorsi contengono cartelle separate per ogni lingua. Poiché i dizionari globali di solito 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.
Come funziona la localizzazione dei moduli adattivi how-localization-of-adaptive-form-works
Esistono due metodi per identificare le impostazioni locali del modulo adattivo. Quando viene eseguito il rendering di un modulo adattivo, questo identifica le impostazioni locali richieste tramite:
-
visualizzazione del selettore
[local]
nell'URL del modulo adattivo. Il formato dell'URL èhttp://host:port/content/forms/af/[afName].[locale].html?wcmmode=disabled
. Il selettore[local]
consente di memorizzare nella cache un modulo adattivo. -
esaminare i seguenti parametri nell'ordine specificato:
-
Parametro richiesta
afAcceptLang
Per ignorare le impostazioni locali del browser degli utenti, è possibile passare il parametro di richiestaafAcceptLang
per forzare le impostazioni locali. Ad esempio, il seguente URL è stato forzato a eseguire il rendering del modulo nelle impostazioni internazionali giapponesi:https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ja
-
Impostazioni locali del browser impostate per l'utente, specificate nella richiesta utilizzando l'intestazione
Accept-Language
. -
Impostazione della lingua dell'utente specificato nell'AEM.
-
Le impostazioni locali del browser sono attivate per impostazione predefinita. Per modificare le impostazioni internazionali del browser:
- Apri Gestione configurazione. URL:
http://[server]:[port]/system/console/configMgr
- Individua e apri la configurazione Modulo adattivo e canale web di comunicazione interattiva.
- Cambia lo stato dell'opzione Usa impostazioni internazionali del browser e Salva la configurazione.
- Apri Gestione configurazione. URL:
-
Una volta identificate le impostazioni locali, i moduli adattivi selezionano 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 è stato 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 è la lingua utilizzata durante lo sviluppo del modulo adattivo.
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 le impostazioni locali richieste sono en_ZA
(inglese sudafricano) e la libreria client per en_ZA
non esiste, il modulo adattivo utilizzerà la libreria client per la lingua en
(inglese), se esiste. Tuttavia, se non esiste nessuno di questi, il modulo adattivo utilizza il dizionario per le impostazioni locali di en
.
Aggiunta del supporto per la localizzazione per le lingue non supportate add-localization-support-for-non-supported-locales
AEM Forms attualmente supporta la localizzazione dei contenuti dei moduli 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 per moduli adattivi:
Aggiungere una lingua al servizio Localizzazione guida add-a-locale-to-the-guide-localization-service-br
- Passa a
https://'[server]:[port]'/system/console/configMgr
. - Fare clic per modificare il componente Servizio di localizzazione guida.
- Aggiungere le impostazioni locali da aggiungere all'elenco delle impostazioni internazionali supportate.
Aggiungere una libreria client XFA per una lingua add-xfa-client-library-for-a-locale-br
Creare un nodo di tipo cq:ClientLibraryFolder
in etc/<folderHierarchy>
, con categoria xfaforms.I18N.<locale>
, e aggiungere i seguenti file alla libreria client:
-
I18N.js che definisce
xfalib.locale.Strings
per<locale>
come definito in/etc/clientlibs/fd/xfaforms/I18N/ja/I18N
. -
js.txt contenente quanto segue:
/libs/fd/xfaforms/clientlibs/I18N/Namespace.js
I18N.js
/etc/clientlibs/fd/xfaforms/I18N/LogMessages.js
Aggiungere una libreria client per moduli adattivi per una lingua add-adaptive-form-client-library-for-a-locale-br
Creare un nodo di tipo cq:ClientLibraryFolder
in etc/<folderHierarchy>
, con categoria come guides.I18N.<locale>
e dipendenze come xfaforms.3rdparty
, xfaforms.I18N.<locale>
e guide.common
. "
Aggiungi i seguenti file alla libreria client:
- i18n.js che definisce
guidelib.i18n
, con pattern di "calendarSymbols",datePatterns
,timePatterns
,dateTimeSymbols
,numberPatterns
,numberSymbols
,currencySymbols
,typefaces
per<locale>
in base alle specifiche XFA descritte in Specifiche set di impostazioni locali. È inoltre possibile vedere come viene definito per altre impostazioni internazionali supportate in/etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js
. - LogMessages.js che definisce
guidelib.i18n.strings
eguidelib.i18n.LogMessages
per<locale>
come definito in/etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js
. - js.txt contenente quanto segue:
i18n.js
LogMessages.js
Aggiungere il supporto delle impostazioni locali per il dizionario add-locale-support-for-the-dictionary-br
Eseguire questo passaggio solo se il <locale>
che si sta aggiungendo non è tra en
, de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
.
-
Creare un nodo
nt:unstructured
languages
inetc
, se non già presente. -
Aggiungere una proprietà stringa multivalore
languages
al nodo, se non già presente. -
Aggiungere i valori predefiniti delle impostazioni locali
<locale>
de
,es
,fr
,it
,pt-br
,zh-cn
,zh-tw
,ja
,ko-kr
, se non già presenti. -
Aggiungere
<locale>
ai valori della proprietàlanguages
di/etc/languages
.
<locale>
verrà visualizzato in https://'[server]:[port]'/libs/cq/i18n/translator.html
.
Riavvia il server restart-the-server
Riavviare il server AEM per rendere effettive le impostazioni locali aggiunte.
Librerie di esempio per l’aggiunta del supporto per lo spagnolo sample-libraries-for-adding-support-for-spanish
Librerie client di esempio per aggiungere il supporto per la lingua spagnola