メインコンテンツまでスキップ
pdf?stylesheet=default
Blackboard Help

目標のインポート

目標のインポート

一連のXMLファイルを使用して、目標をBlackboard Learnにインポートできます。目標セットごとにXMLファイルを作成し、それらのXMLファイルをzipパッケージにまとめて、パッケージをアップロードします。

Macでは、zipファイルを作成して目標をインポートする場合に、ネイティブの圧縮機能を使用しないでください。代わりにターミナルでcompressコマンドを使用します。

1つのXMLファイルに、複数の目標セットを入れることはできません。1つの目標セット内のカテゴリと目標の数には、制限はありません。

各ファイルには次の情報が記述されています。

  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>

その他の例

XMLファイルのその他の例については、Behind the Blackboardにログインし、「Blackboard Learn and CE/Vista Standards Documents (記事番号13668)」を参照してください。

エレメント/属性の説明

テンプレート内の関連する属性と値を編集します。

エレメント/属性 説明
standard_document

<standard_document>要素は、ゴールセットのプロパティを記述します。

<standard_document>要素は、ファイル内で1回だけ指定する必要があります。

year

YYYYの形式を使用した年です。

たとえば、"2103"などです。

revision_date

YYYY-MM-DD HH:MM:SSの形式を使用したリビジョンの日付と時刻です。

たとえば、「2013-12-20 13:40:00」などです。

uid

文書ID。37文字以下で入力します。スペースは使用しないでください。

uid_provider

ゴールセットのプロバイダの2文字の識別子です。

たとえば、「PS」などです。

status

1文字のステータス値です。この要素はオプションです。使用する場合は、以下のいずれかを指定する必要があります。

  • A - (アクティブ) すべてのコースでゴールセットが表示されます。
  • I - (非アクティブ) 一部のコースではゴールセットが表示されません。
  • R - (制限付き) カテゴリに明示的に関連付けられたコースでのみゴールセットが表示されます(コースをカテゴリに関連付けるには、カテゴリの横のコンテキストメニュー1つの山括弧を使用し、[コースへの関連付け]を選択します)。

 

この値は、XMLファイルのインポート時にUIの[ステータス]ボタンを選択することによって上書きされます。

editable

「true」または「false」を指定します。この要素はオプションです。

trueを指定すると、UIでゴールセットを編集できます。falseを指定すると、編集は実行できません (項目をアクティブ、非アクティブ、または制限付きに設定した場合を除きます)。

組織・グループ

<organization>要素は、ゴールのソースであるコミュニティを記述します。

“ENTER FULL TEXT OF GOAL SOURCE HERE"プレースホルダテキストを置換します。たとえば、「Blackboard College」に置換します。

<organization>要素は、ファイル内で1回だけ指定する必要があります。

org_code

ソースの識別子です。最大文字数は256文字です。

たとえば「BB」などです。

country_code

ソースの国の2文字の識別子です。

たとえば、「US」などです。

subject

<subject>要素は、ゴールセットの名前を指定します。

「ENTER GOAL SET NAME HERE」プレースホルダテキストを置換します。たとえば、「Physics Lab Goals」に置換します。

この名前は、以下の場所のUIに表示されます。

  1. [ゴール]画面の[ゴールセット]列。
  2. [ゴールセットの編集]画面の[セット名]フィールド。
  3. [コンテンツ]画面の[ゴールセット名]列。
  4. [ゴールの検出]画面の[ゴールセット]列と[ゴールセット]展開可能リスト。

XMLファイルのUIへの影響」を参照してください。

<subject>要素は、ファイル内で1回だけ指定する必要があります。

code

ゴールセットの識別子です。5文字以下で入力します。スペースは使用しないでください。

document_set

<document_set>要素は、ゴールセットタイプを記述します。

「ENTER FULL TEXT OF GOAL SET TYPE HERE」プレースホルダテキストを置換します。101文字以下で入力します。たとえば、「Introductory Goals」に置換します。

このテキストは、以下の場所のUIに表示されます。

  1. [ゴールセットの編集]画面の[セットタイプ]フィールド。
  2. [ゴールの検出]画面の[ゴールセットタイプ]展開可能リスト。

XMLファイルのUIへの影響」を参照してください。

<document_set>要素は、ファイル内で1回だけ指定する必要があります。

uid

ゴールセットタイプの識別子です。スペースは使用しないでください。
grade_range

<grade_range>要素は、カテゴリを記述します。

「ENTER FULL TEXT OF CATEGORY NAME HERE」プレースホルダのテキストを置換します。101文字以下で入力します。

このテキストは、UIには表示されません。

<grade_range要素は、ファイル内で1つまたは複数指定する必要があります。<grade_range>要素の数は、<standard>要素の数と一致している必要があります。

lo、high

このカテゴリがリストに表示される最下位の場所と最上位の場所に指定します。

通常、これらを使用すると、デフォルトでアルファベット順に並べられたカテゴリは無効になります。たとえば、以下の行の場合、「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

カテゴリの識別子です。スペースは使用しないでください。

注 : これは、1つの<grade_range_ref>要素のcode属性に一致している必要があります。これを使用して、<grade_range>要素を<grade_range_ref>要素とリンクします。

standard

<standard>要素は、カテゴリのゴールのセットを記述します。

<standard要素は、ファイル内で1つまたは複数指定する必要があります。<standard>要素の数は、<grade_range>要素の数と一致している必要があります。

uid

ゴールの識別子です。たとえば、"001"などです。

<standard>に含まれるIDは、それぞれ固有である必要があります。

この識別子は、[ゴールの編集]画面の[一意のID]フィールドのUIに表示されます。「XMLファイルのUIへの影響」を参照してください。

title

カテゴリのタイトルです。たとえば、「Measurement」などです。

このタイトルは、以下の場所のUIに表示されます。

  1. [ゴール]画面の[カテゴリ]列。
  2. [コンテンツ]画面の[カテゴリ]列。
  3. [ゴールの検出]画面の[カテゴリ]展開可能リスト。

XMLファイルのUIへの影響」を参照してください。

<title>要素は、ファイル内の<standard>要素ごとに1回だけ指定する必要があります。

grade_range_ref

<grade_range_ref>要素は、ゴールのセットをカテゴリに関連付けます。

<grade_range_ref>要素は、ファイル内の<standard>要素ごとに1回だけ指定する必要があります。

code

対応するカテゴリの<grade_range>要素のcode属性を入力します。

item

<item>要素は、ゴールを記述します。

<item要素は、ファイル内の<standard>要素ごとに1つまたは複数指定する必要があります。

uid

ゴールの一意の識別子です。257文字以下で入力します。

parent_uid

親ゴールのIDです。親ゴールが存在しない場合は、プレースホルダテキストを削除し、この属性を空白のままにします。

label

ゴールタイプです。たとえば、「Instrumentation Type」などです。

このテキストは、[ゴールの検出]画面の[ゴールタイプ]展開可能リストのUIに表示されます。「XMLファイルのUIへの影響」を参照してください。

linkable

以下のいずれかを指定します。

  • Y - ゴールは制限されません。
  • N - ゴールは制限されます。

制限付きゴールは、カテゴリに明示的に関連付けられたコースでのみ表示されます[ゴール]画面では、制限付きゴールの横にアイコン (制限付きのアイコン) が表示されます(コースをカテゴリと関連付けるには、カテゴリの横のコンテキストメニューsingle chevronをクリックし、[コースへの関連付け]を選択します)。

stem

ゴールの前に表示するテキストです。たとえば、「The student will:」などです。前に表示するテキストない場合は、プレースホルダテキストを削除し、この属性を空白のままにします。

このテキストは、以下の場所のUIに表示されます。

  1. [ゴール]画面の[ゴール]列。
  2. [ゴールの検出]画面の[ゴール]列。

XMLファイルのUIへの影響」を参照してください。

doc_num

ゴールの識別子です。101文字以下で入力します。たとえば、「MEASURE_001」などです。ゴールIDを表示しない場合は、プレースホルダテキストを削除し、この属性を空白のままにします。

このテキストは、以下の場所のUIに表示されます。

  1. [ゴール]画面の[ゴール]列。
  2. [ゴールの編集]画面の[ゴールのID]フィールド。
  3. [コンテンツ]画面の[ID]列。
  4. [ゴールの検出]画面の[ゴール]リスト。

XMLファイルのUIへの影響」を参照してください。

   

スキーマ

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>

XMLファイルのUIへの影響

下図は、XMLファイル内の項目がユーザインターフェイスにどのように表示されるかを示したものです。

 画像 は英語版のみが提供されています。

[ゴール]画面

下図は、XMLファイルが[ゴール]画面の項目にどのように対応付けられるかを示したものです。

UI_relationships_C.Goals.new.png

[ゴールの編集]画面

下図は、XMLファイルが[ゴールの編集]画面の項目にどのように対応付けられるかを示したものです(下図は、[ゴール]画面のゴールの右側にあるコンテキストメニューicon.single_chevron.png をクリックし、[ゴールの編集]を選択すると表示される画面です。<standard_document>要素のeditable属性が「false」に設定されている場合、[ゴールの編集]コマンドは使用できません)。

UI_relationships_D.Edit_Goals.new.png

[ゴールセットの編集]画面

下図は、XMLファイルが[ゴールセットの編集]画面の項目にどのように対応付けられるかを示したものです(下図は、[ゴール]画面のゴールセットの右側にあるコンテキストメニューicon.double_chevron.png をクリックし、[編集]を選択すると表示される画面です。<standard_document>要素のeditable属性が「false」に設定されている場合、[セット名]および[セットタイプ]フィールドは編集できません)。

UI_relationships_E.Edit_Goal_Set.new.png

[コンテンツ]画面

下図は、XMLファイルが[コンテンツ]画面の項目にどのように対応付けられるかを示したものです。

UI_relationships_A.Content.new.png

[ゴールの検出]画面

下図は、XMLファイルが[ゴールの検出]画面の項目にどのように対応付けられるかを示したものです(下図は、[コンテンツ]画面の[関連付けの追加]を選択したときに表示される画面です)。

UI_relationships_B.Discover_Goals.new.png

項目の削除

項目は、新しいファイルをアップロードしても削除できません。項目を削除するには、ユーザインターフェイスを使用します。

項目の追加と置換

項目を最も簡単に追加または置換するには、(ユーザインターフェイスから) 既存の項目を削除し、更新された情報を含むファイルをアップロードします。

ユーザインターフェイスを使用せずに項目を追加または置換する必要がある場合は、以下のセクションの方法を参照してください。

UIDの階層

  • ゴールごとのUIDのセット (つまり、<standard_document><document_set><standard>、および<item>のUIDのセット) は、すべてのファイルで一意である必要があります。
  • 以下のUIDにより、階層が形成されます。
    • <standard_document>
    • <document_set>
    • <standard>
    • <item>

以下に説明するように、<standard>要素のUIDは<grade_range>要素のcode属性と相互に作用します。

新しい項目の追加

階層内の上位の項目を同じUIDに保持し、階層内の下位の項目に別の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>

    test1.png
  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を使用する必要があります。