Skip to main content

导入目的

导入目的

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

重要

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

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

每个文件包含以下信息：

  1. 目的集信息。

  2. 类别信息。必须为目的集中的每个类别复制并编辑该代码。复制这个代码，粘贴到文件末尾</standard_document>行前面的一行。

  3. 目的信息。必须为类别中的每个目的复制并编辑该代码。复制这段代码，粘贴在文件末尾</标准>行前面的一行。

上传文件

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

目的集的 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>
其他示例

你可以通过登录Anthology Support Portal并访问第64730条，“州标准文档（目标集）”来查找其他XML文件示例。

元素/属性说明

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

元素/属性

描述

standard_document

<standard_document>元素描述目标集属性。文件中必须有一个，且只有一个<standard_document>元素。

年

年份，使用 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 中状态按钮的选择覆盖。

编辑

“true”或“false”。此元素是可选项。如果为 true，则目的集可以在 UI 中编辑。如果为 false，则无法在 UI 中编辑（将项目设置为“活动”、“非活动”或“受限制”除外）。

组织

<组织>元素描述了目标的来源组织。文件中必须有一个，且只有一个<组织>元素。

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

org_code

源的标识符。最多为 256 个字符。例如，“BB”。

country_code

源的国家/地区的两字符标识符。例如，“US”。

主题

<主语>元素指定目标集的名称。文件中必须有一个，且只有一个<主旨>元素。

替换“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>元素的数量必须与<标准>元素的数量相匹配。

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

此文本不在 UI 中显示。

喂，嗨

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

通常，这些位置用于覆盖按字母顺序对类别进行的默认排序。例如，以下各行会迫使“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

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

这必须与<成绩范围引用>元素中的code属性匹配。这用于将<成绩范围>元素与<成绩范围引用>元素连接起来。

标准

<标准>元素描述了某一类别的目标集合。

文件中必须有一个或多个<标准>元素。<标准>元素的数量必须与<成绩范围>元素的数量相匹配。

uid

目的的标识符。例如，“001”。每个<标准>必须有一个唯一的ID。

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

称谓

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

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

  1. 目的屏幕的类别列中。

  2. 内容屏幕的类别列中。

  3. 在发现目标界面的类别可展开列表中。

grade_range_ref

<成绩_range_ref>元素将目标集合与类别联系起来。文件中的每个<标准>元素内必须有一个且仅有一个<成绩_range_ref>元素。

code

输入对应类别的<成绩范围>元素的code属性。

项目

<物品>元素描述目标。文件中的每个<标准>元素内必须有一个或多个<item>元素。

uid

目的的唯一标识符。字符数不得超过 257 个。

parent_uid

父目的的 ID。如果不存在父目的，请删除占位符文本并将此属性留空。

label

目的类型。例如，“Instrumentation Type”。该文本显示在发现目标界面的目标类型可展开列表中。

可链接

以下其中一项：

  • Y - 目的将不受限制。

  • N - 目的将受限制。

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

茎

目的的引领文本。例如，“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文件中项目在目标界面出现的位置示意图。
“编辑目的”屏幕

该图表展示 XML 文件如何映射到编辑目的屏幕中的项目。如果您打开目的屏幕中目的右侧的菜单，然后选择编辑目的，则会显示此屏幕。如果 <standard_document> 元素中的 editable 属性设置为“false”，则无法使用 Edit Goal 命令。

XML文件中项目在编辑目标界面出现位置的示意图
“编辑目的集”屏幕

该图表展示 XML 文件如何映射到编辑目的集屏幕中的项目。如果你在 Goals 界面打开目标设置右侧的菜单，选择编辑，这个界面就会出现。如果<standard_document>元素中的 editable 属性为“false”，那么 Set Name 和 Set Type files 字段则不可编辑。）

XML文件中项目在编辑目标集界面出现的位置示意图
“内容”屏幕

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

XML文件中项目在内容界面出现位置的示意图
“查找目的”屏幕

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

XML文件中项目在“发现目标”界面出现的位置示意图

删除项目

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

添加和替换项目

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

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

UID 的层次结构

  • 每个目标的 UID 集合（换句话说，<standard_document>、<document_set>、<标准>和<item>的 UID 集合）必须在所有文件中唯一。

  • 这些 UID 形成了一个层次结构：

    • <standard_document>

    • <document_set>

    • <standard>

    • <item>

<standard>元素的UID还与<成绩范围>元素的code属互，如下所述。

添加新项目

你可以添加新物品或替换旧物品，方法是保持层级较高的物品不变，但对较低的物品使用不同的UID。

例如

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

    <standard_

    文档>

    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>
    目标界面，显示目标集1、类别1和DOC_NUM_1—这是目标。

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

    <standard_

    文档>

    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>
    进球界面显示进球组1、类别1和类别A（红色高亮），DOC_NUM_1 - 这是新的目标，红色高亮。

    注意

    如果你更改了<standard>元素的UID，你也必须更改<成绩范围>元素的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>
    目标界面，显示目标组1、类别1和类别A，DOC_NUM_1—这是修订后的目标，红色高亮显示。
更改名称

如果你上传的信息包含相同的 UID，但 code 属性不同，项目将被重命名。

例如

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

    <standard_

    文档>

    UID

    <subject>

    CODE

    <document_

    准备好了>

    UID

    <grade_

    范围>

    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>
    目标界面，显示目标集1、类别1和DOC_NUM_1—这是目标。

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

    <standard_

    文档>

    UID

    <subject>

    CODE

    <document_

    准备好了>

    UID

    <grade_

    范围>

    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>
    目标界面，显示目标组B，红色高亮，类别1，DOC_NUM_1—这就是目标。

该过程也适用于重命名<成绩范围>元素的code属性。

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

如果层级较低元素的UID已被使用，但高层元素的UID不同，文件将不会上传。

例如

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

    <standard_

    文档>

    UID

    <document_

    准备好了>

    UID

    <grade_

    范围>

    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_

    文档>

    UID

    <document_

    准备好了>

    UID

    <grade_

    范围>

    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。