Show Menu
SUJETS×

Support de nouveaux paramètres régionaux pour la localisation de formulaires adaptatifs

A propos des dictionnaires de paramètres régionaux

La localisation des formulaires adaptatifs repose sur deux types de dictionnaires de paramètres régionaux :
Dictionnaire spécifique au formulaire Contient les chaînes utilisées dans les formulaires adaptatifs. Par exemple, étiquettes, noms de champs, messages d’erreur, descriptions d’aide, et ainsi de suite. It is managed as a set of XLIFF files for each locale and you can access it at https://<host>:<port>/libs/cq/i18n/translator.html .
Dictionnaires globaux Il 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.

Comment fonctionne la localisation des formulaires adaptatifs

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 :
  • affichage du [local] sélecteur dans l’URL du formulaire adaptatif. The format of the URL is http://host:port/content/forms/af/[afName].[locale].html?wcmmode=disabled . L’utilisation du [local] sélecteur 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
    • The browser locale set for the user, which is specified in the request using the Accept-Language header.
    • 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 :
      • Ouvrez le gestionnaire de configuration. The URL is http://[server]:[port]/system/console/configMgr
      • Locate and open the Adaptive Form and Interactive Communication Web Channel configuration.
      • Modifiez l’état de l’option Utiliser les paramètres régionaux du navigateur et enregistrez la configuration.
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 .

Ajoutez la localisation pour les paramètres régionaux non pris en charge

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 :

Add a locale to the Guide Localization service

  1. Accédez à https://'[server]:[port]'/system/console/configMgr .
  2. Cliquer pour modifier le composant Guide Localization Service .
  3. Ajouter le paramètre régional que vous souhaitez à la liste des paramètres régionaux de supports

Ajouter la bibliothèque XFA client pour un paramètre régional

Créez un noeud de type cq:ClientLibraryFolder sous etc/<folderHierarchy> , avec catégorie xfaforms.I18N.<locale> , et ajoutez les fichiers suivants à la bibliothèque cliente :
  • I18N.js définissant xfalib.locale.Strings pour le <locale> comme défini dans /etc/clientlibs/fd/xfaforms/I18N/ja/I18N .
  • js.txt contenant les éléments suivants :
/libs/fd/xfaforms/clientlibs/I18N/Namespace.js
I18N.js
/etc/clientlibs/fd/xfaforms/I18N/LogMessages.js

Ajouter la bibliothèque cliente de formulaires adaptatifs pour un paramètre régional

Créez un noeud de type cq:ClientLibraryFolder sous etc/<folderHierarchy> , avec la catégorie comme guides.I18N.<locale> et les dépendances comme xfaforms.3rdparty , xfaforms.I18N.<locale> et guide.common . "
Ajouter les fichiers suivants à la bibliothèque client :
  • i18n.js définissant guidelib.i18n , ayant des modèles de "calendarSymbols", datePatterns , timePatterns , dateTimeSymbols , numberPatterns , numberSymbols , , pour la conformément aux spécifications XFA décrites dans le de spécification des ensembles de paramètres régionaux de l’. currencySymbols typefaces <locale> xfa_spec_3_3.pdf You can also see how it is defined for other supported locales in /etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js .
  • LogMessages.js définissant guidelib.i18n.strings et guidelib.i18n.LogMessages pour le <locale> contenu comme défini dans /etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js .
  • js.txt contenant les éléments suivants :
i18n.js
LogMessages.js

Ajouter un support pour la langue du dictionnaire

Perform this step only if the <locale> you are adding is not among en , de , es , fr , it , pt-br , zh-cn , zh-tw , ja , ko-kr .
  1. Create an nt:unstructured node languages under etc , if not present already.
  2. Add a multi-valued string property languages to the node, if not present already.
  3. ajoutez les valeurs de paramètres régionaux <locale> par défaut de , es , fr , it , pt-br , zh-cn , , , ,, si elles ne sont pas déjà présentes. zh-tw ja ko-kr
  4. Add the <locale> to the values of the languages property of /etc/languages .
Le <locale> sera affiché à https://'[server]:[port]'/libs/cq/i18n/translator.html .

Redémarrez le serveur

Redémarrez le serveur AEM pour que le paramètre régional ajouté entre en vigueur.

Exemples de bibliothèques pour ajouter la prise en charge de l'espagnol

Exemples de bibliothèques clientes pour ajouter la prise en charge de l’espagnol