您可以使用一系列 XML 文件将目的导入 Blackboard Learn。为每个目的集创建一个 XML 文件,将这些 XML 文件压缩到一起,然后上传该压缩包。

请勿使用 Mac 上的本地“压缩”功能创建 ZIP 文件以导入您的目的。改用 Terminal 中的 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
      
   

其他示例

您可以登录到 Behind the Blackboard 并转到文章编号 13668“Blackboard Learn 和 CE/Vista 标准文档”,查找其他 XML 文件示例。


元素/属性说明

在模板中编辑相关属性和值。

元素/属性 说明
standard_document 元素描述目的集属性。文件中必须有且只能有一个 元素。
year 年份,使用 YYYY 格式。例如,“2013”。
revision_date 修订日期和时间,使用“YYYY-MM-DD HH:MM:SS”格式。例如,“2013-12-20 13:40:00”。
uid 文档 ID。字符数不得超过 37 个。请勿使用空格。
uid_provider 目的集提供程序的两字符标识符。例如,“PS”。
status 单个字符的状态值。此元素是可选项。如果显示,必须是以下其中一项:
  • A -(活动)目的集可用于所有课程。
  • I -(非活动)目的集不可用于任何课程。
  • R -(受限制)目的集仅对明确与类别关联的课程可见。(要将课程与类别关联,请使用类别旁边的菜单并选择与课程关联。)

导入 XML 文件时,此值由 UI 中状态按钮的选择覆盖。

editable “true”或“false”。此元素是可选项。如果为 true,则目的集可以在 UI 中编辑。如果为 false,则无法在 UI 中编辑(将项目设置为“活动”、“非活动”或“受限制”除外)。
organization 元素描述是目的源的组织。文件中必须有且只能有一个 元素。

替换“ENTER FULL TEXT OF GOAL SOURCE HERE”占位符文本。例如,将其替换为“Blackboard College”。

org_code 源的标识符。最多为 256 个字符。例如,“BB”。
country_code 源的国家/地区的两字符标识符。例如,“US”。
subject 元素可指定目的集的名称。文件中必须有且只能有一个 元素。

替换“ENTER GOAL SET NAME HERE”占位符文本。例如,将其替换为“Physics Lab Goals”。

此名称在 UI 中的以下位置显示:

  1. 目的屏幕的目的集列中。
  2. 编辑目的集屏幕的集名称字段中。
  3. 内容屏幕的目的集名称列中。
  4. 查找目的屏幕的目的集列和目的集可展开列表中。
code 目的集的标识符。字符数不得超过五个。请勿使用空格。
document_set 元素描述目的集属性。文件中必须有且只能有一个 元素。

替换“ENTER FULL TEXT OF GOAL SET TYPE HERE”占位符文本。字符数不得超过 101 个。例如,将其替换为“Introductory Goals”。

此文本在 UI 中的以下位置显示:

  1. 编辑目的集屏幕的集类型字段中。
  2. 查找目的屏幕的目的集类型可展开列表中。
uid 目的集类型的标识符。请勿使用空格。
grade_range 元素描述类别。文件中必须有一个或多个 元素。 元素数必须与 元素数匹配。

替换“ENTER FULL TEXT OF CATEGORY NAME HERE”占位符文本。字符数不得超过 101 个。

此文本不在 UI 中显示。

lo, hi 指定此类别应在列表中显示的最低位置和最高位置。

通常,这些位置用于覆盖按字母顺序对类别进行的默认排序。例如,以下各行会迫使“Kindergarten”类别显示在列表顶部:

Kindergarten
Grade 1
Grade 2
Grade 3
Grade 4

code 类别的标识符。请勿使用空格。

这必须与 元素中的 code 属性匹配。这用于将 元素与 元素相关联。

standard 元素描述某个类别的目的集。

文件中必须有一个或多个 元素。 元素数必须与 元素数匹配。

uid 目的的标识符。例如,“001”。每个 都必须有一个唯一的 ID。

此标识符在 UI 中编辑目的屏幕的唯一 ID 字段中显示。

title 类别的标题。例如,“Measurement”。文件中的每个 元素必须有且只能有一个 元素。

此标题在 UI 中的以下位置显示:

  1. 目的屏幕的类别列中。
  2. 内容屏幕的类别列中。
  3. 查找目的屏幕的类别可展开列表中。
grade_range_ref 元素将目的集关联到类别。文件中的每个 元素必须有且只能有一个 元素。
code 为对应的类别输入 元素的 code 属性。
item 元素描述目的。文件中的每个 元素内必须有一个或多个 元素。
uid 目的的唯一标识符。字符数不得超过 257 个。
parent_uid 父目的的 ID。如果不存在父目的,请删除占位符文本并将此属性留空。
label 目的类型。例如,“Instrumentation Type”。此文本在 UI 中查找目的屏幕上的目的类型可展开列表中显示。
linkable 以下其中一项:
  • Y - 目的将不受限制。
  • N - 目的将受限制。

受限制目的仅对明确与类别关联的课程可见。在目的屏幕上,这些目的的旁边都有一个箭头图标,以显示其可供在新窗口中打开。要将课程与类别关联,请打开类别的菜单,然后选择与课程关联

stem 目的的引领文本。例如,“The student will:”。如果不存在引领文本,请删除占位符文本并将此属性留空。

此文本在 UI 中的以下位置显示:

  1. 目的屏幕的目的列中。
  2. 查找目的屏幕的目的列中。
doc_num 目的标识符。例如,“MEASURE_001”。字符数不得超过 101 个。如果不希望显示目的 ID,请删除该占位符文本并将此属性留空。

此文本在 UI 中的以下位置显示:

  1. 目的屏幕的目的列中。
  2. 编辑目的屏幕的目的 ID 字段中。
  3. 内容屏幕的 ID 列中。
  4. 查找目的屏幕的目的列表中。

架构

以下是这些 XML 文件的 XML 架构:

<?xml version="1.0" encoding="UTF-8"?>
http://www.w3.org/2001/XMLSchema">
    
    
    
        
            
                
                
                
                
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                        
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
        
    
   
    
    
        
            
                
                    
                    
                
                
                
                
            
        
    
   
    
    
        
            
                
                    
                        
                            
                                
                                
                            
                        
                    
                
                
            
        
    
   
    
    
        
            
                
                    
                
                
                
            
        
    
   
    
    
        
            
                
                    
                    
                    
                
                
                
                
                
            
        
    
   
    
    
        
            
                
                
                
            
            
        
    
   
    
    
    
   
    
    
        
            
        
    
   
    
    
        
            
                
            
            
            
            
            
                
                    
                        
                        
                    
                
            
            
            
                
                    
                        
                        
                    
                
            
            
            
        
    
   
    
    
    
   
    
   
    
    
        
            
        
    
    
    
        
            
        
    
    
    
        
            
        
    
    
    
        
            
            
        
    
    
        
            
            
        
    
    
    
        
            
            
        
    
    
    
        
            
            
        
    
    
    
        
            
            
        
    
   


这些文件如何影响 UI

以下图表展示 XML 文件中的项目如何在用户界面中显示。

这些图像仅提供英文版本。

“目的”屏幕

该图表展示 XML 文件如何映射到目的屏幕中的项目。

“编辑目的”屏幕

该图表展示 XML 文件如何映射到编辑目的屏幕中的项目。如果您打开目的屏幕中目的右侧的菜单,然后选择编辑目的,则会显示此屏幕。如果将 editable 属性(位于 元素中)设置为“false”,则编辑目的命令将不可用。

“编辑目的集”屏幕

该图表展示 XML 文件如何映射到编辑目的集屏幕中的项目。如果您打开目的屏幕上目的集右侧的菜单并选择编辑,则会显示此屏幕。如果 元素中的 editable 属性设置为“false”,则设置名称集类型文件字段不可编辑。  

“内容”屏幕

该图表展示 XML 文件如何映射到内容屏幕中的项目。

“查找目的”屏幕

该图表展示 XML 文件如何映射到查找目的屏幕中的项目。当您选择内容屏幕上的添加对齐时,系统会显示此屏幕。


删除项目

您无法通过上传新文件删除项目。要删除项目,请使用用户界面。


添加和替换项目

添加或替换项目的最简单方式是删除现有项目(通过用户界面),然后上传包含已更新信息的文件。

如果您需要添加或替换项目而不使用用户界面,以下部分介绍相关流程。

UID 的层次结构

  • 每个目的的 UID 集(换言之, 的 UID 集)在所有文件中必须是唯一的。
  • 这些 UID 形成了一个层次结构:

元素的 UID 还与 元素的 code 属性交互(如下所述)。

添加新项目

您可以将层次结构中较高的项目保持不变,而为层次结构中较低的项目使用其他 UID,来添加新项目或替换旧项目。

示例

  1. 假定您首先上传一个具有以下属性的文件。这将创建一个目的集、类别和目的。
    document>
    UID

    UID

    CODE

    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
       ">目的集 1
       DOC_SET_1">目的集类型 1
       CATEGORY_1">类别 1
       STANDARD_1">
          类别 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             这是目的。
          
       

  2. 如果您在之后上传具有以下属性的文件,这会创建一个新类别和一个新目的。
    document>
    UID

    UID

    CODE

    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
       目的集 1
       DOC_SET_1">目的集类型 1
       CATEGORY_A">类别 A
       STANDARD_A">
          类别 A
          
          ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

    如果您更改 元素的 UID,则还必须更改 元素的 code 属性。如果您只更改 元素的 UID,则导入会失败。

  3. 如果之后上传具有相同属性而内容不同的文件时,会更新目的语句。

    <?xml version="1.0" encoding="UTF-8"?>

       Blackboard College
       目的集 1
       目的集类型 1
       类别 A
       
          类别 A
          
          
             This is the new goal.
          
       

更改名称

如果上传具有相同 UID 集但 code 属性不同的信息,会重命名这些项目。

示例

  1. 假定您首先上传一个具有以下属性的文件。这将创建一个目的集、类别和目的。
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    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
       目的集类型 1
       CATEGORY_1">类别 1
       STANDARD_1">
          类别 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             这是目的。
          
       

  2. 然后再上传一个具有以下属性的文件,则系统会重命名目的集(从“Goal Set 1”更改为“Goal Set B”)。
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    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">目的集类型 1
       CATEGORY_1">类别 1
       STANDARD_1">
          类别 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             这是目的。
          
       

此步骤也适用于重命名 元素的 code 属性。

添加或更改层次结构中层次较高的项目

如果层次结构中层次较低的元素的 UID 已使用,但层次结构中层次较高的元素使用不同的 UID,则您会收到错误,且文件不会上传。

示例

  1. 假定您首先上传一个具有以下属性的文件。这将创建一个目的集、类别和目的。
    document>
    UID
    set>
    UID
    range>
    CODE

    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
       目的集 1
       DOC_SET_1">目的集类型 1
       CATEGORY_1">类别 1
       STANDARD_1">
          类别 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             这是目的。
          
       

  2. 如果您在之后尝试上传具有以下属性的文件,上传会失败。
    document>
    UID
    set>
    UID
    range>
    CODE

    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
       目的集 1
       DOC_SET_1">目的集类型 1
       CATEGORY_1">类别 1
       STANDARD_1">
          类别 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             这是目的。
          
       

如果您想要添加或更改层次结构中层次较高的项目,则必须为层次结构中层次较低的项目使用不同的 UID。