В этом разделе приводится информация о наиболее распространенных проблемах, которые могут возникать при создании, редактировании и развертывании языковых пакетов в системе Blackboard Learn.

Поврежденные ссылки на ресурсы документации

После обновления или изменения языкового пакета пользователи не могут войти в Справку Blackboard из системы Learn. Вместо этого открывается страница Справки Страница не найдена со следующим сообщением:

К сожалению, нам не удалось найти нужные вам страницу или документ.

Причина этой проблемы в том, что при обновлении языкового пакета существующие ссылки на документацию были повреждены.

Откройте пользовательский языковой пакет и убедитесь, что ссылки в пакетах локали documentation.properties указывают на соответствующие материалы.

Проблемы, связанные с сервером совместной работы

Развертывание пользовательского языкового пакета в среде с балансировкой нагрузки может вызвать проблемы, связанные с сервером совместной работы. Эти проблемы касаются только пользовательских языковых пакетов. При создании пользовательского языкового пакета создается также новый файл .JAR на сервере приложений по адресу:

blackboard/apps/collab-server/http/webapps/clientlib/yourlanguagepack-collab-locale.jar

Однако этот новый файл .JAR не создается на самом сервере Collaboration, что приводит к проблеме.

Эта проблема может быть устранена двумя способами.

Способ 1

  1. Выполните вход на сервере совместной работы.
  2. Перейдите в каталог blackboard/content/locale/YOURLANGUAGEPACK/collab/
  3. Выполните следующий сценарий:

    [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

Способ 2

  1. Выполните вход на сервере приложений.
  2. Перейдите в каталог blackboard/apps/collab-server/http/webapps/client-lib/
  3. Копируйте новый файл .JAR (созданный в результате развертывания пользовательского языкового пакета) с сервера приложений.
  4. Выполните вход на сервере совместной работы.
  5. Добавьте новый файл .JAR в то же местоположение на сервере совместной работы.
  6. Перезапустите сервер совместной работы.

Проблемы с отображением страницы

На некоторых страницах портала и на панели системного администратора могут возникать проблемы, связанные с отображением содержимого. Может быть получено следующее сообщение об ошибке:

can't parse argument number module_title

Эта проблема чаще всего возникает после обновления. Решение заключается во внесении изменений, которые указаны в файле bundle_diff.txt, сопровождающем обновление. После завершения первоначального процесса обновления приведите пользовательский языковой пакет в соответствие с текущей версией.

Откройте файл bundle_diff.txt и обновите пользовательский языковой пакет соответствующим образом.

Подробнее о сохранении языковых пакетов

Темы

Надлежащее хранение тем имеет важное значение для их успешного использования в системе Blackboard Learn. Убедитесь, что они хранятся в нужных папках на всех соответствующих серверах приложений.

После редактирования темы должны быть заданы как используемые по умолчанию. Это выполняется посредством панели администратора.

Необходимо соблюдать осторожность при редактировании CSS-файлов тем. При редактировании CSS-файлов рекомендуется использовать текстовый редактор с поддержкой проверки правильности.

Подробнее о темах