Modification dynamique de la langue en cours de session utilisateur

Permet aux utilisateurs de changer de langue pendant qu'ils sont connectés au portail.

Pourquoi et quand exécuter cette tâche

If you want your users to be able to change the language during the session, use the following command provided by HCL Digital Experience:
<portal-navigation:url command="ChangeLanguage">
   <portal-navigation:urlParam name="locale" value="language"/>
</portal-navigation:url>
où langue correspond aux deux codes caractères de la langue requise, comme en, de ou fr. Pour la liste des langues disponibles et de leurs deux codes de caractères, lisez la rubrique Langues prises en charge.
Pour permettre aux utilisateurs de modifier de façon dynamique la langue pour la session, ajoutez un lien vers le thème de portail avec le texte et la référence de lien suivants :
  • Le texte affiché avec le lien spécifie la langue pouvant être choisie par l'utilisateur.
  • La référence de lien appelle la commande décrite précédemment avec le paramètre d'environnement local correspondant à la langue spécifiée.

Les utilisateurs peuvent alors cliquer sur ce lien pour adopter la langue spécifiée par le paramètre d'environnement local avec la commande. Si vous voulez rendre plusieurs langues disponibles aux utilisateurs, créez un lien distinct pour chaque langue.

Exemple : Pour créer des liens pour l'anglais et l'allemand, ajoutez les lignes de l'exemple suivant à la zone de bannière de votre thème : 

<!-- add these lines -->
<a href="<portal-navigation:url command="ChangeLanguage"><portal-navigation:urlParam name="locale" 
     value="en"/></portal-navigation:url>">English</a>
<a href="<portal-navigation:url command="ChangeLanguage"><portal-navigation:urlParam name="locale" 
     value="de"/></portal-navigation:url>">Deutsch</a>

<%-- logout button --%>

La zone de bannière peut être définie dans plusieurs fichiers, en fonction des différents thèmes. Les thèmes dans les versions de portail récentes définissent généralement la zone de bannière dans le fichier Default.jsp, alors que les thèmes antérieurs peuvent inclure un JSP distinct tel que banner_toolbar.jsp. Pour plus d'informations sur la localisation des fichiers associés à vos thèmes, reportez-vous à la rubrique consacrée à l'emplacement des ressources de thème.

Notes :
  • Le paramètre modifié ne s'applique que pour la durée de la session en cours. Lorsque l'utilisateur se déconnecte, puis se reconnecte, le portail applique la langue par défaut, telle que déterminée par les étapes décrites sous la rubrique Sélection et modification de la langue.
  • Les exemples précédents utilisent le préfixe portal: pour désigner les balises JSP de la bibliothèque de balises du portail située dans le répertoire portal.tld. Vos pages JSP personnalisées peuvent utiliser un préfixe de balise différent. Pour plus d'informations, voir la rubrique Balises utilisées par les fichiers JSP du portail.
  • Important pour tous les systèmes d'exploitation : Appliquez la commande touch au fichier Default.jsp après avoir modifié les fichiers JSP et avant de redémarrer. Cela met à jour l'horodatage du fichier par rapport à l'heure en cours et entraînera une recompilation du fichier Default.jsp permettant d'incorporer les modifications provenant d'autres fichiers JSP. Entrez : 
     touch Default.jsp
    An alternative is to edit (open and save) Default.jsp, which has the same effect as the touch command. Après avoir mis à jour les JSP de thème, vous devez redémarrer HCL Portal, sauf si le rechargement des JSP est activé.