导入目的

您可以使用一系列 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> element and one <standard> 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> 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 文件如何映射到编辑目的屏幕中的项目。如果您打开目的屏幕中目的右侧的菜单，然后选择编辑目的，则会显示此屏幕。如果将 editable 属性（位于 <standard_document> 元素中）设置为“false”，则编辑目的命令将不可用。

“编辑目的集”屏幕

该图表展示 XML 文件如何映射到编辑目的集屏幕中的项目。如果您打开目的屏幕上目的集右侧的菜单并选择编辑，则会显示此屏幕。如果 <standard_document> 元素中的 editable 属性设置为“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_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_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_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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。