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

  1. Connectez-vous au serveur de collaboration.
  2. Accédez à l'emplacement suivant : blackboard/content/locale/YOURLANGUAGEPACK/collab/
  3. 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

  1. Connectez-vous au serveur d'applications.
  2. Accédez à l'emplacement suivant : blackboard/apps/collab-server/http/webapps/client-lib/
  3. Copiez le nouveau fichier jar (créé suite au déploiement du pack langue personnalisé) à partir du serveur d'applications.
  4. Connectez-vous au serveur de collaboration.
  5. Ajoutez le nouveau fichier jar au même emplacement du serveur de collaboration.
  6. 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.

En savoir plus sur les thèmes