Импорт целей

Для импорта целей в Blackboard Learn можно использовать серию файлов XML. Создайте файл XML для каждого набора целей, упакуйте файлы XML в один архив формата ZIP и загрузите его на сайт.

При создании файлов ZIP для импорта целей на компьютерах Mac не следует использовать встроенную функцию сжатия. Вместо этого следует использовать команду compress в программе «Терминал».

Файл XML не должен содержать более одного набора целей. Количество возможных категорий в этом наборе целей не ограничено.

В каждом файле содержится следующая информация:

  1. Сведения о наборе целей.
  2. Сведения о категории. Этот код необходимо скопировать и отредактировать для каждой категории в наборе целей. Скопируйте и вставьте его в строку, предшествующую строке в конце файла.
  3. Сведения о цели. Этот код необходимо скопировать и отредактировать для каждой цели в категории. Скопируйте и вставьте его в строку, предшествующую строке в конце файла.

Отправка файлов

Откройте Панель администратора, перейдите в раздел Средства и утилиты и выберите пункт Цели. На странице Цели наведите указатель мыши на элемент Добавить набор целей и выберите из меню пункт Импортировать набор целей. 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 Значение состояния, включающее один символ. Это необязательный элемент. Если он присутствует, то должен иметь одно из следующих значений:
  • A (активный) — набор целей доступен для всех курсов.
  • I (неактивный) — набор целей недоступен для курсов.
  • R (ограниченный) — набор целей виден только участникам курсов, явно связанных с категорией. (Чтобы связать курс с категорией, откройте меню рядом с категорией и выберите пункт Сопоставить с курсами.)

Это значение переопределяется нажатием кнопки Состояние пользовательского интерфейса при импорте файла XML.
editable «Истина» или «ложь». Это необязательный элемент. Если задано значение true, набор целей будет доступен для редактирования в пользовательском интерфейсе. Если задано значение false, редактирование будет недоступно (за исключением установки для элементов состояния «Активный», «Неактивный» и «Ограниченный»).
organization Элемент описывает организацию-источник для цели. В файле должен содержаться только один элемент .

Замените временный текст «ВВЕДИТЕ ЗДЕСЬ ИСТОЧНИК ЦЕЛИ ПОЛНОСТЬЮ». Например, введите вместо него «Колледж Blackboard».
org_code Идентификатор источника. Он может содержать до 256 символов. Например, «BB».
country_code Идентификатор страны источника, включающий два символа. Например, «US».
subject Элемент указывает название набора целей. В файле должен содержаться только один элемент .

Замените временный текст «УКАЖИТЕ ЗДЕСЬ ИМЯ НАБОРА ЦЕЛЕЙ». Например, введите вместо него «Цели лабораторной работы по физике».

Это название будет отображаться в таких элементах пользовательского интерфейса:

  1. Столбец Набор целей на экране Цели.
  2. Столбец Имя набора на экране Изменить набор целей.
  3. Столбец Имя набора целей на экране Содержимое.
  4. Столбец Набор целей и раскрывающийся список Набор целей на экране Найти цели.
code Идентификатор набора целей. Используйте не более пяти символов. Не используйте пробелы.
document_set Элемент описывает тип набора целей. В файле должен содержаться только один элемент .

Замените временный текст «ВВЕДИТЕ ЗДЕСЬ ТИП НАБОРА ЦЕЛЕЙ ПОЛНОСТЬЮ». Используйте не более 101 символа. Например, введите вместо него «Вводные цели».

Этот текст будет отображаться в таких элементах пользовательского интерфейса:

  1. Столбец Тип набора на экране Изменить набор целей.
  2. Раскрывающийся список Тип набора целей на экране Найти цели.
uid Идентификатор типа набора целей. Не используйте пробелы.
grade_range Элемент описывает категорию. В файле должно быть не менее одного элемента . Количество элементов должно соответствовать количеству элементов .

Замените временный текст «ВВЕДИТЕ ЗДЕСЬ НАЗВАНИЕ КАТЕГОРИИ ПОЛНОСТЬЮ». Используйте не более 101 символа.

Этот текст не отображается в пользовательском интерфейсе.
lo, hi Указатели низшего и высшего места в списке, на котором должна находиться эта категория.

Обычно они используются для изменения расположения категорий в алфавитном порядке, заданного по умолчанию. Например, следующие строки обеспечивают перемещение категории «Детский сад» в начало списка:

Kindergarten
Grade 1
Grade 2
Grade 3
Grade 4
code Идентификатор категории. Не используйте пробелы.

Идентификатор должен совпадать с атрибутом code одного из элементов . Он используется для связи элементов и .
standard Элемент описывает набор целей для категории.

В файле должно быть не менее одного элемента . Количество элементов должно соответствовать количеству элементов .
uid Идентификатор целей. Например, «001». Каждый элемент должен иметь уникальный идентификатор.

Он отображается в поле Уникальный идентификатор на экране Изменить цель пользовательского интерфейса.
title Заголовок категории. Например, «Измерение». Файл должен содержать только один элемент в каждом элементе .

Этот заголовок будет отображаться в таких элементах пользовательского интерфейса:

  1. Столбец Категория на экране Цели.
  2. Столбец Категория на экране Содержимое.
  3. Раскрывающийся список Категория на экране Найти цели.
grade_range_ref Элемент связывает набор целей с категорией. Файл должен содержать только один элемент в каждом элементе .
code Введите атрибут code элемента для соответствующей категории.
item Элемент описывает цель. Файл должен содержать не менее одного элемента в каждом элементе .
uid Уникальный идентификатор цели. Используйте не более 257 символов.
parent_uid Идентификатор родительской цели. Если родительская цель отсутствует, удалите временный текст и оставьте этот атрибут пустым.
label Тип цели. Например, «Тип КИП». Этот текст отображается в раскрывающемся списке Тип цели на экране Найти цели пользовательского интерфейса.
linkable Одно из следующих значений:
  • Y — цель не будет ограничена.
  • N — цель будет ограничена.

Ограниченные цели видны только курсам, явно связанным с категорией. In the Goals screen, these goals have an arrow icon beside them to show that they can be opened in a new window. Чтобы связать курс с категорией, откройте меню категории и выберите пункт Сопоставить с курсами.
stem Основной текст для цели. Например, «Учащийся». Если основной текст отсутствует, удалите временный текст и оставьте этот атрибут пустым.

Этот текст будет отображаться в таких элементах пользовательского интерфейса:

  1. Столбец Цели на экране Цели.
  2. Столбец Цель на экране Найти цели.
doc_num Идентификатор цели. Например, "MEASURE_001". Используйте не более 101 символа. Если вы не хотите, чтобы идентификатор цели отображался, удалите временный текст и оставьте этот атрибут пустым.

Этот текст будет отображаться в таких элементах пользовательского интерфейса:

  1. Столбец Цели на экране Цели.
  2. Столбец Идентификатор цели на экране Изменить цель.
  3. Столбец Идентификатор на экране Содержимое.
  4. Список Цель на экране Найти цели.

Схема

Ниже приведена схема 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элемента , как описано ниже.

Добавление новых элементов

Добавлять новые элементы или заменять старые можно, оставляя те же элементы, расположенные выше по иерархии, и используя другие уникальные идентификаторы для элементов ниже по иерархии.

Пример

  1. Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
    document>
    UID
    UID
    Код элемента
    UID
    UID
    STANDARD_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.
          
       

  2. Если впоследствии вы добавите файл с такими атрибутами, будет создана новая категория и новая цель:
    document>
    UID
    UID
    Код элемента
    UID
    UID
    STANDARD_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 элемента . Если изменить только уникальный идентификатор элемента , в процессе импорта произойдет сбой.

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

    <?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, элементы будут переименованы.

Пример

  1. Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
    document>
    UID
    Код элемента    		 set>
    UID    		 range>
    Код элемента
    UID
    UID
    STANDARD_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.
          
       

  2. Если впоследствии вы добавите файл со следующими атрибутами, набор целей будет переименован (из «Набор целей 1» в «Набор целей B»).
    document>
    UID
    Код элемента    		 set>
    UID    		 range>
    Код элемента
    UID
    UID
    STANDARD_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 элемента .

Добавление или изменение элементов выше по иерархии

Система выдаст ошибку и файл не будет добавлен, если уникальные идентификаторы для элементов ниже по иерархии уже использовались, но с другими уникальными идентификаторами для элементов выше по иерархии.

Пример

  1. Допустим, сначала вы добавляете файл с указанными ниже атрибутами. При этом будут созданы набор целей, категория и цель.
    document>
    UID    		 set>
    UID    		 range>
    Код элемента
    UID
    UID
    STANDARD_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.
          
       

  2. Если впоследствии вы попытаетесь добавить файл со следующими атрибутами, во время загрузки произойдет сбой.
    document>
    UID    		 set>
    UID    		 range>
    Код элемента
    UID
    UID
    STANDARD_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.
          
       

Если вы хотите добавить или изменить элементы выше по иерархии, необходимо использовать другие уникальные идентификаторы для элементов ниже по иерархии.