导入目的

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

请勿使用 Mac 上的本地“压缩”功能创建 ZIP 文件以导入您的目的。改用 Terminal 中的 compress命令。

一个 XML 文件不得包含多个目的集。不过,该目的集中的类别和目的的数量不受限制。

每个文件包含以下信息:

  1. 目的集信息。
  2. 类别信息。必须为目的集中的每个类别复制并编辑该代码。复制该代码并将其粘贴到文件末尾的 </standard_document>行的前一行。
  3. 目的信息。必须为类别中的每个目的复制并编辑该代码。复制该代码并将其粘贴到靠近文件末尾的 </standard>行的前一行。

上传文件

管理员面板工具和实用工具区域,选择目的。在目的页面,将鼠标指针移到添加目的集上方以访问菜单,并选择导入目的集。Blackboard Learn 会同时处理所有文件。


目的集的 XML 模版,包括类别和目的

<?xml version="1.0" encoding="UTF-8"?>
<!-- Define a goal set -->
<!-- Create a separate XML file for each goal set -->
<standard_document year="ENTER RELEVANT YEAR HERE" revision_date="ENTER REVISION DATE AND TIME HERE" uid="ENTER DOCUMENT ID HERE. Do not uses spaces."
   uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
   
   <!-- Define the organization that is the source for this goal set -->
   <organization org_code="ENTER A SOURCE CODE HERE (UP TO 256 CHARACTERS)" country_code="US">
      ENTER FULL TEXT OF GOAL SOURCE HERE.
   </organization>
   
   <!-- Define the name of the goal set -->
   <subject code="ENTER ID FOR GOAL SET HERE. Do not use spaces.">
      ENTER GOAL SET NAME HERE</subject>
   
   <!-- Define the goal set type -->
   <document_set uid="ENTER ID FOR GOAL SET TYPE HERE. Do not use spaces.">
      ENTER FULL TEXT OF GOAL SET TYPE HERE</document_set>
   
   <!-- Define the categories -->
   <!-- Create one <grade_range&gt; element and one <standard&gt; element for each category -->
   <grade_range lo="ENTER LOWEST POSITION IN CATEGORY LIST" hi="ENTER HIGHEST POSITION IN CATEGORY LIST"
      code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE</grade_range>
   <standard uid="ENTER ID FOR CATEGORY HERE. Do not use spaces.">
      <title>ENTER FULL TEXT OF CATEGORY NAME HERE</title>
      <grade_range_ref code="ENTER CATEGORY ID HERE"/>
      
      <!-- Define the Goals -->
      <!-- Create one <item&gt; element for each goal in the category -->
      <item uid="ENTER UNIQUE ID OF GOAL HERE. Do not use spaces." parent_uid="ENTER ID OF PARENT GOAL HERE OR LEAVE BLANK" label="ENTER FULL TEXT OF GOAL TYPE HERE" linkable="ENTER Y OR N"
         stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
         <statement>ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE</statement>
      </item>
   </standard>
   
</standard_document>

示例

<?xml version="1.0" encoding="UTF-8"?>
<standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="PHYS101" uid_provider="PS" status="A" editable="true">
   <organization org_code="BB" country_code="US">Blackboard College</organization>
   <subject code="PHYSLAB01">Physics Lab Goals</subject>
   <document_set uid="INTRO">Introductory Goals</document_set>
   
   <grade_range lo="1" hi="1" code="MEASURE">The Measurement Category</grade_range>
   <standard uid="1">
      <title>Measurement</title>
      <grade_range_ref code="MEASURE"/>
      <item uid="001" parent_uid="" label="Instrumentation Type" linkable="Y" stem="The student will:" doc_num="MEASURE_001">
         <statement>learn how to use a micrometer</statement>
      </item>
      <item uid="002" parent_uid="001" label="Instrumentation Type" linkable="N" stem="The student will:" doc_num="MEASURE_002">
         <statement>understand the uncertainty in measurements</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="NOTEBOOK">The Lab Notebook Category</grade_range>
   <standard uid="2">
      <title>Lab Notebooks</title>
      <grade_range_ref code="NOTEBOOK"/>
      <item uid="003" parent_uid="" label="Documentation Type" linkable="Y" stem="The student will:" doc_num="NOTE_001">
         <statement>record lab results in detail</statement>
      </item>
   </standard>
</standard_document>

其他示例

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


元素/属性说明

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

元素/属性说明
standard_document<standard_document>元素描述目的集属性。文件中必须有且只能有一个 <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<organization>元素描述是目的源的组织。文件中必须有且只能有一个 <organization>元素。

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

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

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

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

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

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

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

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

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

此文本不在 UI 中显示。

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

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

<grade_range lo="1" hi="1" code="K">Kindergarten</grade_range>
<grade_range lo="2" hi="2" code="1">Grade 1</grade_range>
<grade_range lo="3" hi="3" code="2">Grade 2</grade_range>
<grade_range lo="4" hi="4" code="3">Grade 3</grade_range>
<grade_range lo="5" hi="5" code="4">Grade 4</grade_range>

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

这必须与一个 <grade_range_ref>元素中的 code 属性匹配。这用于将 <grade_range>元素与 <grade_range_ref> 元素关联。

standard<standard>元素描述类别的目的集。

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

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

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

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

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

  1. 目的屏幕的类别列中。
  2. 内容屏幕的类别列中。
  3. 查找目的屏幕的类别可展开列表中。
grade_range_ref<grade_range_ref>元素将目的集关联到类别。文件中的每个 <standard>元素内必须有且只能有一个 <grade_range_ref> 元素。
code为对应的类别输入 <grade_range>元素的 code 属性。
item<item>元素描述目的。文件中的每个 <standard>元素内必须有一个或多个 <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"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- ================================== -->
    <!-- Standard Document -->
    <xs:element name="standard_document">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="organization"/>
                <xs:element ref="subject"/>
                <xs:element ref="document_set"/>
                <xs:element ref="grade_range" maxOccurs="unbounded"/>
                <xs:element ref="standard" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="year" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d"/>
                        <!-- For example, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- For example, "PS" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\S{1,37}"/>
                        <!-- For example, "PHYS101" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="status" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="A"/>
                        <xs:enumeration value="I"/>
                        <xs:enumeration value="R"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="revision_date" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d"/>
                        <!-- For example, "2014-01-30 09:15:00" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="editable" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="true"/>
                        <xs:enumeration value="false"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Organization -->
    <xs:element name="organization">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="org_code" type="ST_256-character_code" use="required"/>
                    <xs:attribute name="country_code" type="ST_two-character_code" use="required"/>
                </xs:extension>
                <!-- For example, "Blackboard College" -->
                <!-- For example, "BB" -->
                <!-- For example, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Subject -->
    <xs:element name="subject">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="code" use="required">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:pattern value="\S{1,5}"/>
                                <!-- For example, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- For example, "Physics Lab Goals" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Document Set -->
    <xs:element name="document_set">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="uid" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- For example, "Introductory Goals" -->
                <!-- For example, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Grade Range -->
    <xs:element name="grade_range">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="lo" type="xs:integer" use="required"/>
                    <xs:attribute name="hi" type="xs:integer" use="required"/>
                    <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- For example, "The Measurement Category" -->
                <!-- For example, "1" -->
                <!-- For example, "1" -->
                <!-- For example, "NOTEBOOK" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Standard -->
    <xs:element name="standard">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="title"/>
                <xs:element ref="grade_range_ref"/>
                <xs:element ref="item" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_non_blank_string" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Title -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- For example, "Lab Notebooks" -->
    <!-- ================================== -->
    <!-- Grade Range Ref -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Item -->
    <xs:element name="item">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="statement"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_goal_uid" use="required"/>
            <xs:attribute name="stem" type="xs:string" use="required"/>
            <xs:attribute name="parent_uid" type="ST_parent_goal_uid" use="required"/>
            <xs:attribute name="linkable" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="N"/>
                        <xs:enumeration value="Y"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="label" type="ST__string" use="required"/>
            <xs:attribute name="doc_num" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value=".{0,101}"/>
                        <!-- 0 to 101 characters -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- For example, "The student will:"or blank -->
            <!-- For example, "Instrumentation Type" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Statement -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- For example, "understand the uncertainty in measurements" -->
    <!-- ================================== -->
    <!-- Simple Data Types -->
    <!-- ================================== -->
    <!-- String with no spaces -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Two-character code -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- 256-character code -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Goal UIDs -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- 1 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- 0 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- No more than 101 characters -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- 1 to 101 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Non-blank string -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- At least 1 character -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Possibly blank string -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Can be empty-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>


这些文件如何影响 UI

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

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

“目的”屏幕

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

“编辑目的”屏幕

该图表展示 XML 文件如何映射到编辑目的屏幕中的项目。如果您打开目的屏幕中目的右侧的菜单,然后选择编辑目的,则会显示此屏幕。The Edit Goal command isn't available if the editable attribute in the <standard_document> element is set to "false".

“编辑目的集”屏幕

该图表展示 XML 文件如何映射到编辑目的集屏幕中的项目。如果您打开目的屏幕中目的集右侧的菜单,然后选择编辑,则会显示此屏幕。  The Set Name and Set Type files fields aren't editable if the editable attribute in the <standard_document> element is set to "false".)

“内容”屏幕

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

“查找目的”屏幕

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


删除项目

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


添加和替换项目

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

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

UID 的层次结构

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

<standard>元素的 UID 还与 <grade_range> 元素的 code 属性交互,如下所述。

添加新项目

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

示例

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

    UID
    <document_set>
    UID
    <grade_range>
    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1span>">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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

    UID
    <document_set>
    UID
    <grade_range>
    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOCS_SET_1CATEGORY_ASTANDARD_AITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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

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

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the new goal.</statement>
          </item>
       </standard>
    </standard_document>

更改名称

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

示例

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

    UID
    <subject>
    CODE
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1SUBJECT_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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

    UID
    <subject>
    CODE
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1SUBJECT_BDOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_B">Goal Set B</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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

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

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

示例

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

    UID
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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

    UID
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_CDOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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