Cette section contient des informations sur les problèmes fréquents susceptibles de se produire lors de la création, la modification et le déploiement de packs langue dans Blackboard Learn.
Liens endommagés vers les ressources de documentation
Après avoir mis à jour ou modifié un pack langue, les utilisateurs ne peuvent pas accéder à l'aide de Blackboard depuis Learn. Au lieu de cela, la page Page introuvable apparaît avec un message de type :
Désolés, mais nous n'avons pas pu trouver la page ou le document que vous recherchez.
Cela signifie que les liens existants vers la documentation ont été endommagés lors de la mise à jour du pack langue.
Ouvrez le pack langue personnalisé et vérifiez que les liens contenus dans les groupes de paramètres régionaux documentation.properties pointent vers le matériel approprié.
Problèmes liés au serveur de collaboration
Déployer un pack langue personnalisé dans un environnement à équilibrage de charge peut occasionner des problèmes dans le serveur de collaboration. Ce problème concerne uniquement les utilisateurs du pack langue personnalisé. La création d'un pack langue personnalisé entraîne automatiquement celle d'un fichier .jar sur le serveur d'applications à l'emplacement suivant :
blackboard/apps/collab-server/http/webapps/clientlib/yourlanguagepack-collab-locale.jar
Toutefois, ce nouveau fichier .jar n'est pas créé sur le serveur de collaboration proprement dit, ce qui explique le problème.
Ce problème peut être résolu de deux façons :
Solution 1
- Connectez-vous au serveur de collaboration.
- Accédez à l'emplacement suivant : blackboard/content/locale/YOURLANGUAGEPACK/collab/
- Exécutez le script suivant :
[root@grimlock collab]# cat BuildCollabLocaleJar.sh
#! /bin/bash
## This script requires JAVA_HOME environment variable to be set
## This script takes an optional parameter for PATH_TO_COLLAB
############## BuildCollabLocaleJar.sh
#############################
#
# CHANGE THIS VALUE IF YOU COPY THIS SCRIPT FOR A DIFFERENT
LOCALE
################################################################
###
LOCALE=en_US <-------EDIT HERE TO SPECIFY YOUR LANGUAGE PACK
LOCALE
PATH_TO_COLLAB=$1
export LOCALE PATH_TO_COLLAB
if [ "$PATH_TO_COLLAB" != "" ]; then cd $PATH_TO_COLLAB; fi
if [ "$JAVA_HOME" = "" ]; then
echo "JAVA_HOME variable not defined."
exit 1
fi
echo "Using JAVA_HOME: $JAVA_HOME"
echo "PATH_TO_COLLAB: $PATH_TO_COLLAB »
JAR_CMD="$JAVA_HOME/bin/jar -cf »
JAR_DEPLOY_DIR=.. /.. /.. /.. /apps/collabserver/
http/webapps/client-lib/
export JAR_CMD JAR_DEPLOY_DIR
JAR_CMD="$JAR_CMD $LOCALE-collab-locale.jar images messages »
echo « Building $LOCALE-collab-locale.jar »
$JAR_CMD
echo « Deploying $LOCALE-collab-locale.jar to $JAR_DEPLOY_DIR »
cp $LOCALE-collab-locale.jar $JAR_DEPLOY_DIR
rm $LOCALE-collab-locale.jar
exit
Solution 2
- Connectez-vous au serveur d'applications.
- Accédez à l'emplacement suivant : blackboard/apps/collab-server/http/webapps/client-lib/
- Copiez le nouveau fichier jar (créé suite au déploiement du pack langue personnalisé) à partir du serveur d'applications.
- Connectez-vous au serveur de collaboration.
- Ajoutez le nouveau fichier jar au même emplacement du serveur de collaboration.
- Redémarrez le serveur de collaboration.
Problèmes liés à l'affichage des pages
Certaines pages du portail et le panneau Administrateur système peuvent rencontrer des problèmes lors de l'affichage de leur contenu. Le message d'erreur suivant peut s'afficher :
can't parse argument number module_title
Ce problème se produit plus fréquemment après une mise à niveau. La solution consiste à appliquer les modifications qui sont décrites dans le fichier bundle_diff.txt accompagnant la mise à niveau. Une fois le processus de mise à niveau terminé, assurez-vous d'actualiser le pack langue personnalisé avec la version actuelle.
Ouvrez et examinez le fichier bundle_diff.txt, puis mettez le pack langue personnalisé à niveau en conséquence.
En savoir sur la gestion des packs langue
Thèmes
Un stockage approprié des thèmes est primordial pour une utilisation réussie de Blackboard Learn. Déterminez s'ils sont situés dans les dossiers appropriés sur tous les serveurs d'applications.
Les thèmes doivent être définis par défaut après une modification. Cette opération est effectuée via le panneau de configuration de l'administrateur.
Une attention particulière doit être accordée lors de la modification du fichier CSS d'un thème. Il est recommandé d'utiliser un éditeur de texte doté d'une fonctionnalité de validation lors de la modification des fichiers CSS.
