Supporto di nuove impostazioni internazionali per la localizzazione di moduli adattivi

Informazioni sui dizionari internazionali

La localizzazione dei moduli adattivi si basa su due tipi di dizionari locali:

Dizionario specifico per il moduloContiene le stringhe utilizzate nei moduli adattivi. Ad esempio, etichette, nomi di campo, messaggi di errore, descrizioni della guida e così via. Viene gestito come un set di file XLIFF per ogni impostazione internazionale ed è possibile accedervi in https://<host>:<port>/libs/cq/i18n/translator.html.

Dizionari globaliCi sono due dizionari globali, gestiti come oggetti JSON, nella libreria client AEM. Questi dizionari contengono messaggi di errore predefiniti, nomi di mese, simboli di valuta, pattern di data e ora e così via. Puoi trovare questi dizionari in CRXDe Lite su /libs/fd/xfaforms/clientlibs/I18N. Queste posizioni contengono cartelle separate per ogni impostazione internazionale. Poiché i dizionari globali di solito non vengono aggiornati frequentemente, mantenere file JavaScript separati per ogni impostazione internazionale consente ai browser di memorizzarli nella cache e di ridurre l’utilizzo della larghezza di banda della rete quando si accede a diversi moduli adattivi sullo stesso server.

Funzionamento della localizzazione dei moduli adattivi

Esistono due metodi per identificare le impostazioni internazionali del modulo adattivo. Quando viene eseguito il rendering di un modulo adattivo, identifica le impostazioni internazionali richieste da :

  • cerca il selettore [local] nell’URL del modulo adattivo. Il formato dell’URL è http://host:port/content/forms/af/[afName].[locale].html?wcmmode=disabled. L’utilizzo del selettore [local] consente di memorizzare nella cache un modulo adattivo.

  • osservando i seguenti parametri nell’ordine specificato:

    • Parametro della richiesta afAcceptLang
      Per ignorare le impostazioni internazionali del browser degli utenti, puoi trasmettere le
      afAcceptLang richiede il parametro per forzare le impostazioni internazionali. Ad esempio, con il seguente URL verrà eseguito il rendering del modulo nelle impostazioni internazionali giapponesi:
      https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ja

    • Le impostazioni internazionali del browser impostate per l’utente, specificate nella richiesta utilizzando l’intestazione Accept-Language .

    • Impostazione della lingua dell’utente specificata in AEM.

    • Per impostazione predefinita, le impostazioni internazionali del browser sono abilitate. Per modificare le impostazioni internazionali del browser,

      • Apri la gestione della configurazione. L'URL è http://[server]:[port]/system/console/configMgr
      • Individua e apri la configurazione Modulo adattivo e Canale web di comunicazione interattivo .
      • Cambia lo stato dell'opzione Usa impostazione internazionale browser e Salva la configurazione.

Una volta identificate le impostazioni internazionali, i moduli adattivi selezionano il dizionario specifico per il modulo. Se il dizionario specifico per il modulo per le impostazioni internazionali richieste non viene trovato, utilizza il dizionario per la lingua in cui è stato creato il modulo adattivo.

Se non sono presenti informazioni sulle impostazioni internazionali, il modulo adattivo viene distribuito 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 internazionali richieste, cerca in una libreria client il codice della lingua presente nelle impostazioni internazionali. Ad esempio, se le impostazioni internazionali 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 ne esiste nessuna, il modulo adattivo utilizza il dizionario per le impostazioni internazionali en.

Aggiunta del supporto per la localizzazione per le impostazioni internazionali non supportate

AEM Forms supporta attualmente la localizzazione di contenuti di moduli adattivi nelle impostazioni internazionali 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 impostazione internazionale in fase di esecuzione dei moduli adattivi:

  1. Aggiungere un’impostazione internazionale al servizio GuideLocalizationService

  2. Aggiungere una libreria client XFA per le impostazioni internazionali

  3. Aggiungere una libreria client per moduli adattivi per le impostazioni internazionali

  4. Aggiungere supporto per le impostazioni internazionali del dizionario

  5. Riavvia il server

Aggiungere un’impostazione internazionale al servizio Guide Localization

  1. Passa a https://'[server]:[port]'/system/console/configMgr.
  2. Fai clic su per modificare il componente Servizio di localizzazione guida .
  3. Aggiungi le impostazioni internazionali da aggiungere all’elenco delle impostazioni internazionali supportate.

GuideLocalizationService

Aggiungere una libreria client XFA per le impostazioni internazionali

Crea un nodo di tipo cq:ClientLibraryFolder in etc/<folderHierarchy>, con categoria xfaforms.I18N.<locale> e aggiungi i seguenti file alla libreria client:

  • I18N. jsdefinition xfalib.locale.Strings per <locale> come definito in /etc/clientlibs/fd/xfaforms/I18N/ja/I18N.

  • js. txtcontenenti 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 le impostazioni internazionali

Crea 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. jsdefinition guidelib.i18n, con pattern di "calendarSymSymbol", datePatterns, timePatterns, dateTimeSymbols, numberPatterns, numberSymbols, currencySymbols, typefaces per le specifiche XFA descritte in <locale> Impostazioni internazionali specifiche 🔗. Puoi anche vedere come viene definito per altre impostazioni internazionali supportate in /etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js.
  • LogMessages. jsdefinition guidelib.i18n.strings e guidelib.i18n.LogMessages per <locale> come definito in /etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js.
  • js. txtcontenenti quanto segue:
i18n.js
LogMessages.js

Aggiungere supporto per le impostazioni internazionali del dizionario

Esegui questo passaggio solo se il <locale> che stai aggiungendo non è compreso tra en, de, es, fr, it, pt-br, zh-cn, zh-tw, ja, ko-kr.

  1. Crea un nodo nt:unstructured languages in etc, se non è già presente.

  2. Aggiungi una proprietà stringa con più valori languages al nodo, se non è già presente.

  3. Aggiungi i valori <locale> predefiniti delle impostazioni internazionali de, es, fr, it, pt-br, zh-cn, zh-tw, ja, ko-kr, se non già presenti.

  4. Aggiungi <locale> ai valori della proprietà languages di /etc/languages.

Il simbolo <locale> verrà visualizzato in https://'[server]:[port]'/libs/cq/i18n/translator.html.

Riavvia il server

Riavvia il server AEM per rendere effettive le impostazioni internazionali aggiunte.

Librerie di esempio per aggiungere supporto per lo spagnolo

Librerie client di esempio per aggiungere supporto per lo spagnolo

Ottieni file

In questa pagina