La localisation des formulaires adaptatifs repose sur deux types de dictionnaires de paramètres régionaux :
Dictionnaire spécifique au formulaireContient des chaînes utilisées dans les formulaires adaptatifs. Par exemple, étiquettes, noms de champs, messages d’erreur, descriptions d’aide, et ainsi de suite. Il est géré sous la forme d’un ensemble de fichiers XLIFF pour chaque paramètre régional et vous pouvez y accéder à l’adresse https://<host>:<port>/libs/cq/i18n/translator.html
.
dictionnaires globauxIl existe deux dictionnaires globaux, gérés en tant qu’objets JSON, dans AEM bibliothèque cliente. Ces dictionnaires contiennent les messages d’erreur par défaut, les noms des mois, les symboles de devise, les modèles de date et d’heure, et ainsi de suite. Vous pouvez trouver ces dictionnaires dans CRXDe Lite à l’adresse /libs/fd/xfaforms/clientlibs/I18N. Ces emplacements contiennent des dossiers distincts pour chaque jeu de paramètres régionaux. Étant donné que les dictionnaires globaux ne sont généralement pas mis à jour fréquemment, conserver des fichiers JavaScript distincts pour chaque jeu de paramètres régionaux permet aux navigateurs de les mettre en cache et de réduire l’utilisation de la bande passante du réseau lors de l’accès à différents formulaires adaptatifs sur le même serveur.
Il existe deux méthodes pour identifier les paramètres régionaux du formulaire adaptatif. Lorsqu’un formulaire adaptatif est rendu, il identifie les paramètres régionaux requis par :
consultez le sélecteur [local]
dans l’URL du formulaire adaptatif. Le format de l’URL est http://host:port/content/forms/af/[afName].[locale].html?wcmmode=disabled
. L’utilisation du sélecteur [local]
permet la mise en cache d’un formulaire adaptatif.
en examinant les paramètres suivants dans l’ordre spécifié :
Paramètre de requête afAcceptLang
Pour remplacer les paramètres régionaux du navigateur des utilisateurs, vous pouvez transmettre la variable
afAcceptLang
pour forcer le paramètre régional. Par exemple, l’URL suivante force le rendu du formulaire dans les paramètres régionaux japonais :
https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ja
Paramètre régional du navigateur défini pour l’utilisateur, qui est spécifié dans la requête à l’aide de l’en-tête Accept-Language
.
Paramètre de langue de l’utilisateur spécifié dans AEM.
Par défaut, les paramètres régionaux du navigateur sont activés. Pour modifier les paramètres régionaux du navigateur, procédez comme suit :
http://[server]:[port]/system/console/configMgr
Une fois que le paramètre régional est identifié, le formulaire adaptatif sélectionne le dictionnaire qui lui est spécifique. Si le dictionnaire spécifique au formulaire pour les paramètres régionaux demandés est introuvable, il utilise le dictionnaire pour la langue dans laquelle le formulaire adaptatif a été créé.
Si aucune information de paramètre régional n’est présente, le formulaire adaptatif est distribué dans la langue d’origine du formulaire. La langue d’origine est la langue utilisée lors du développement du formulaire adaptatif.
S’il n’existe pas de bibliothèque client pour le paramètre régional requis, il recherche une bibliothèque client correspondant au code de langue présent dans le paramètre régional. Par exemple, si le paramètre régional requis est en_ZA
( (anglais Afrique du sud) et qu’il n’existe pas de bibliothèque client correspondant à en_ZA
, le formulaire adaptatif utilise la bibliothèque client correspondant à la langue en
(anglais), si elle existe. Toutefois, si aucune de ces bibliothèques n’existe, le formulaire adaptatif utilise le dictionnaire correspondant au paramètre régional en
.
AEM Forms prend actuellement en charge la localisation du contenu des formulaires adaptatifs en anglais (en), espagnol (es), français (fr), italien (it), allemand (de), japonais (ja), portugais-brésilien (pt-BR), chinois (zh-CN), chinois-taïwanais (zh-TW) et coréen (ko-KR).
Pour ajouter un nouveau paramètre régional lors de l’exécution des formulaires adaptatifs :
Ajouter un paramètre régional au service GuideLocalizationService
Ajouter la bibliothèque XFA client pour un paramètre régional
Ajouter la bibliothèque cliente de formulaires adaptatifs pour un paramètre régional
https://'[server]:[port]'/system/console/configMgr
.Créez un noeud de type cq:ClientLibraryFolder
sous etc/<folderHierarchy>
, avec la catégorie xfaforms.I18N.<locale>
, et ajoutez les fichiers suivants à la bibliothèque cliente :
I18N. jsdéfinition xfalib.locale.Strings
pour la <locale>
fonction définie dans /etc/clientlibs/fd/xfaforms/I18N/ja/I18N
la.
js.txt contenant les éléments suivants :
/libs/fd/xfaforms/clientlibs/I18N/Namespace.js
I18N.js
/etc/clientlibs/fd/xfaforms/I18N/LogMessages.js
Créez un noeud de type cq:ClientLibraryFolder
sous etc/<folderHierarchy>
, avec la catégorie guides.I18N.<locale>
et les dépendances xfaforms.3rdparty
, xfaforms.I18N.<locale>
et guide.common
. "
Ajouter les fichiers suivants à la bibliothèque client :
guidelib.i18n
, ayant des modèles de "calendarSymbols", datePatterns
, timePatterns
, dateTimeSymbols
, numberPatterns
, numberSymbols
, , , pour les selon les spécifications XFA décrites dans le de spécification des ensembles de paramètres régionaux de l’.currencySymbols
typefaces
<locale>
Vous pouvez également voir comment il est défini pour les autres paramètres régionaux pris en charge dans /etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js
.guidelib.i18n.strings
et guidelib.i18n.LogMessages
pour la <locale>
fonction définie dans /etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js
la.i18n.js
LogMessages.js
Effectuez cette étape uniquement si le <locale>
que vous ajoutez n'est pas compris dans en
, de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
.
Créez un nt:unstructured
noeud languages
sous etc
, s’il n’est pas déjà présent.
Ajoutez une propriété de chaîne à plusieurs valeurs languages
au noeud, si elle n’est pas déjà présente.
Ajoutez les valeurs de paramètres régionaux par défaut <locale>
de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
, si elles ne sont pas déjà présentes.
Ajoutez <locale>
sur les valeurs de la propriété languages
de /etc/languages
.
Le <locale>
apparaît à https://'[server]:[port]'/libs/cq/i18n/translator.html
.
Redémarrez le serveur AEM pour que le paramètre régional ajouté entre en vigueur.
Exemples de bibliothèques clientes pour ajouter la prise en charge de l’espagnol