Импорт целей
Для импорта целей в Blackboard Learn можно использовать серию файлов XML. Создайте файл XML для каждого набора целей, упакуйте файлы XML в один архив формата ZIP и загрузите его на сайт.
При создании файлов ZIP для импорта целей на компьютерах Mac не следует использовать встроенную функцию сжатия. Вместо этого следует использовать команду compress в программе «Терминал».
Файл XML не должен содержать более одного набора целей. Количество возможных категорий в этом наборе целей не ограничено.
В каждом файле содержится следующая информация:
- Сведения о наборе целей.
- Сведения о категории. Этот код необходимо скопировать и отредактировать для каждой категории в наборе целей. Скопируйте и вставьте его в строку, предшествующую строке в конце файла.
- Сведения о цели. Этот код необходимо скопировать и отредактировать для каждой цели в категории. Скопируйте и вставьте его в строку, предшествующую строке в конце файла.
Отправка файлов
Откройте Панель администратора, перейдите в раздел Средства и утилиты и выберите пункт Цели. На странице Цели наведите указатель мыши на элемент Добавить набор целей и выберите из меню пункт Импортировать набор целей. Blackboard Learn обработает сразу все файлы.
Шаблон XML для набора целей с категориями и целями
<?xml version="1.0" encoding="UTF-8"?>
uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
ENTER FULL TEXT OF GOAL SOURCE HERE.
ENTER GOAL SET NAME HERE
ENTER FULL TEXT OF GOAL SET TYPE HERE
code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE
ENTER FULL TEXT OF CATEGORY NAME HERE
stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE
Пример
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Physics Lab Goals
Introductory Goals
The Measurement Category
Measurement
learn how to use a micrometer
understand the uncertainty in measurements
The Lab Notebook Category
Lab Notebooks
record lab results in detail
Другие примеры
Чтобы ознакомиться с другими примерами файлов XML, войдите на сайт Behind the Blackboard и перейдите к статье 13668, «Документы стандартов Blackboard Learn и CE/Vista».
Описание элементов/атрибутов
Измените соответствующие атрибуты и значения в шаблоне.
Элемент/атрибут | Описание |
---|---|
standard_document | Элемент описывает свойства набора целей. В файле должен содержаться только один элемент . |
year | Год в четырехзначном формате. Например, «2013». |
revision_date | Дата и время ревизии в формате ДД-ММ-ГГГГ ЧЧ:ММ:СС. Например, «2013-12-20 13:40:00». |
uid | Идентификатор документа. Используйте не более 37 символов. Не используйте пробелы. |
uid_provider | Идентификатор поставщика набора целей, включающий два символа. Например, «PS». |
status | Значение состояния, включающее один символ. Это необязательный элемент. Если он присутствует, то должен иметь одно из следующих значений:
Это значение переопределяется нажатием кнопки Состояние пользовательского интерфейса при импорте файла XML. |
editable | «Истина» или «ложь». Это необязательный элемент. Если задано значение true, набор целей будет доступен для редактирования в пользовательском интерфейсе. Если задано значение false, редактирование будет недоступно (за исключением установки для элементов состояния «Активный», «Неактивный» и «Ограниченный»). |
organization | Элемент описывает организацию-источник для цели. В файле должен содержаться только один элемент . Замените временный текст «ВВЕДИТЕ ЗДЕСЬ ИСТОЧНИК ЦЕЛИ ПОЛНОСТЬЮ». Например, введите вместо него «Колледж Blackboard». |
org_code | Идентификатор источника. Он может содержать до 256 символов. Например, «BB». |
country_code | Идентификатор страны источника, включающий два символа. Например, «US». |
subject | Элемент указывает название набора целей. В файле должен содержаться только один элемент . Замените временный текст «УКАЖИТЕ ЗДЕСЬ ИМЯ НАБОРА ЦЕЛЕЙ». Например, введите вместо него «Цели лабораторной работы по физике». Это название будет отображаться в таких элементах пользовательского интерфейса:
|
code | Идентификатор набора целей. Используйте не более пяти символов. Не используйте пробелы. |
document_set | Элемент описывает тип набора целей. В файле должен содержаться только один элемент . Замените временный текст «ВВЕДИТЕ ЗДЕСЬ ТИП НАБОРА ЦЕЛЕЙ ПОЛНОСТЬЮ». Используйте не более 101 символа. Например, введите вместо него «Вводные цели». Этот текст будет отображаться в таких элементах пользовательского интерфейса:
|
uid | Идентификатор типа набора целей. Не используйте пробелы. |
grade_range | Элемент описывает категорию. В файле должно быть не менее одного элемента . Количество элементов должно соответствовать количеству элементов . Замените временный текст «ВВЕДИТЕ ЗДЕСЬ НАЗВАНИЕ КАТЕГОРИИ ПОЛНОСТЬЮ». Используйте не более 101 символа. Этот текст не отображается в пользовательском интерфейсе. |
lo, hi | Указатели низшего и высшего места в списке, на котором должна находиться эта категория. Обычно они используются для изменения расположения категорий в алфавитном порядке, заданного по умолчанию. Например, следующие строки обеспечивают перемещение категории «Детский сад» в начало списка: Kindergarten |
code | Идентификатор категории. Не используйте пробелы. Идентификатор должен совпадать с атрибутом code одного из элементов . Он используется для связи элементов и . |
standard | Элемент описывает набор целей для категории. В файле должно быть не менее одного элемента . Количество элементов должно соответствовать количеству элементов . |
uid | Идентификатор целей. Например, «001». Каждый элемент должен иметь уникальный идентификатор. Он отображается в поле Уникальный идентификатор на экране Изменить цель пользовательского интерфейса. |
title | Заголовок категории. Например, «Измерение». Файл должен содержать только один элемент в каждом элементе . Этот заголовок будет отображаться в таких элементах пользовательского интерфейса:
|
grade_range_ref | Элемент связывает набор целей с категорией. Файл должен содержать только один элемент в каждом элементе . |
code | Введите атрибут code элемента для соответствующей категории. |
item | Элемент описывает цель. Файл должен содержать не менее одного элемента в каждом элементе . |
uid | Уникальный идентификатор цели. Используйте не более 257 символов. |
parent_uid | Идентификатор родительской цели. Если родительская цель отсутствует, удалите временный текст и оставьте этот атрибут пустым. |
label | Тип цели. Например, «Тип КИП». Этот текст отображается в раскрывающемся списке Тип цели на экране Найти цели пользовательского интерфейса. |
linkable | Одно из следующих значений:
Ограниченные цели видны только курсам, явно связанным с категорией. In the Goals screen, these goals have an arrow icon beside them to show that they can be opened in a new window. Чтобы связать курс с категорией, откройте меню категории и выберите пункт Сопоставить с курсами. |
stem | Основной текст для цели. Например, «Учащийся». Если основной текст отсутствует, удалите временный текст и оставьте этот атрибут пустым. Этот текст будет отображаться в таких элементах пользовательского интерфейса:
|
doc_num | Идентификатор цели. Например, "MEASURE_001". Используйте не более 101 символа. Если вы не хотите, чтобы идентификатор цели отображался, удалите временный текст и оставьте этот атрибут пустым. Этот текст будет отображаться в таких элементах пользовательского интерфейса:
|
Схема
Ниже приведена схема XML для этих файлов XML.
<?xml version="1.0" encoding="UTF-8"?>
http://www.w3.org/2001/XMLSchema">
Влияние этих файлов на пользовательский интерфейс
Далее приведены примеры того, как элементы файлов XML отображаются в пользовательском интерфейсе.
Изображения доступны только на английском языке.
Экран «Цели»
Это изображение иллюстрирует соответствие элементов файла XML объектам на экране Цели.
Экран «Изменить цель»
Это изображение иллюстрирует соответствие элементов файла XML объектам на экране Изменить цель. Этот экран отображается, если открыть меню справа от цели на экране Цели и выбрать пункт Изменить цель. Команда Изменить цель недоступна, если для атрибута editable элемента задано значение false.
Экран «Изменить набор целей»
Это изображение иллюстрирует соответствие элементов файла XML объектам на экране Изменить набор целей. Этот экран отображается, если открыть меню справа от цели на экране Цели и выбрать пункт Изменить. Поля Имя набора и Тип набора недоступны для редактирования, если для атрибута editable элемента задано значение false.
Экран «Содержимое»
Это изображение иллюстрирует соответствие элементов файла XML объектам на экране Содержимое.
Экран «Найти цели»
Это изображение иллюстрирует соответствие элементов файла XML объектам на экране Найти цели. Этот экран отображается, когда вы выбираете пункт Добавить сопоставления на экране Содержимое.
Удаление элементов
Элементы нельзя удалить путем добавления новых файлов. Удаляются элементы через пользовательский интерфейс.
Добавление и замена элементов
Самый простой способ добавить или заменить элементы — удалить существующие элементы (с помощью пользовательского интерфейса) и добавить файл с обновленными сведениями.
В следующих разделах описан процесс добавления и замены элементов без использования пользовательского интерфейса.
Иерархия уникальных идентификаторов
- Набор уникальных идентификаторов для каждой цели (или набор уникальных идентификаторов для элементов , , и ) должен быть уникальным для всех файлов.
- Эти уникальные идентификаторы имеют следующую иерархию:
Уникальный идентификатор элемента также взаимодействует с атрибутом codeэлемента , как описано ниже.
Добавление новых элементов
Добавлять новые элементы или заменять старые можно, оставляя те же элементы, расположенные выше по иерархии, и используя другие уникальные идентификаторы для элементов ниже по иерархии.
Пример
- Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
document>
UID
UID
Код элемента
UID
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
">Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Если впоследствии вы добавите файл с такими атрибутами, будет создана новая категория и новая цель:
document>
UID
UID
Код элемента
UID
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_A">Category A
STANDARD_A">
Category A
ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
При изменении уникального идентификатора элемента необходимо также изменить атрибут code элемента . Если изменить только уникальный идентификатор элемента , в процессе импорта произойдет сбой.
- При последующем добавлении файла с такими же атрибутами, но другим содержимым формулировка цели будет обновлена.
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Goal Set 1
Goal Set Type 1
Category A
Category A
This is the new goal.
Изменить названия
Если добавить данные с таким же набором уникальных идентификаторов, но с другими атрибутами code, элементы будут переименованы.
Пример
- Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
document>
UID
Код элементаset>
UIDrange>
Код элемента
UID
UIDSTANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_1">Goal Set 1
Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Если впоследствии вы добавите файл со следующими атрибутами, набор целей будет переименован (из «Набор целей 1» в «Набор целей B»).
document>
UID
Код элементаset>
UIDrange>
Код элемента
UID
UIDSTANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_B">Goal Set B
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
С помощью такой же процедуры можно переименовать атрибут code элемента .
Добавление или изменение элементов выше по иерархии
Система выдаст ошибку и файл не будет добавлен, если уникальные идентификаторы для элементов ниже по иерархии уже использовались, но с другими уникальными идентификаторами для элементов выше по иерархии.
Пример
- Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
document>
UIDset>
UIDrange>
Код элемента
UID
UIDSTANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Если впоследствии вы попытаетесь добавить файл со следующими атрибутами, во время загрузки произойдет сбой.
document>
UIDset>
UIDrange>
Код элемента
UID
UIDSTANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Если вы хотите добавить или изменить элементы выше по иерархии, необходимо использовать другие уникальные идентификаторы для элементов ниже по иерархии.