目標のインポート

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

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

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

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

  1. 目標セットの情報。
  2. カテゴリ情報。目標セットの各カテゴリについて、このコードを複製して編集する必要があります。このコードをコピーし、ファイルの最後にある行の直前の行に貼り付けてください。
  3. 目標情報。カテゴリの各目標について、このコードを複製して編集する必要があります。このコードをコピーし、ファイルの最後の方にある行の直前の行に貼り付けてください。

ファイルのアップロード

管理パネルの[ツール/ユーティリティ]セクションで、[ゴール]を選択します。[ゴール]ページの[ゴールセットの追加]をポイントしてメニューにアクセスし、[ゴールセットのインポート]を選択します。Blackboard Learnによりすべてのファイルが一括処理されます。


カテゴリとゴールが記述されているゴールセットのXMLテンプレート

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


   uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
   
   
   
      ENTER FULL TEXT OF GOAL SOURCE HERE.
   
   
   
   
      ENTER GOAL SET NAME HERE
   
   
   
      ENTER FULL TEXT OF GOAL SET TYPE HERE
   
   
   
          code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE
   
      ENTER FULL TEXT OF CATEGORY NAME HERE
      
      
      
      
                stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
         ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE
      
   
   

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

   Blackboard College
   Physics Lab Goals
   Introductory Goals
   
   The Measurement Category
   
      Measurement
      
      
         learn how to use a micrometer
      
      
         understand the uncertainty in measurements
      
   
   
   The Lab Notebook Category
   
      Lab Notebooks
      
      
         record lab results in detail
      
   

その他の例

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


エレメント/属性の説明

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

エレメント/属性 説明
standard_document 要素は、ゴールセットのプロパティを記述します。要素は、ファイル内で1回だけ指定する必要があります。
year YYYYの形式を使用した年です。たとえば、「2013」などです。
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 - (制限付き) カテゴリに明示的に関連付けられたコースでのみゴールセットが表示されます(コースをカテゴリに関連付けるには、カテゴリの横のメニューを使用し、[コースへの関連付け]を選択します)。

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

editable 「true」または「false」のいずれかです。この要素はオプションです。trueを指定すると、UIでゴールセットを編集できます。falseを指定すると、編集は実行できません (項目をアクティブ、非アクティブ、または制限付きに設定した場合を除きます)。
organization 要素は、ゴールのソースであるコミュニティを記述します。要素は、ファイル内で1回だけ指定する必要があります。

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

org_code ソースの識別子です。最大文字数は256文字です。たとえば、「BB」などです。
country_code ソースの国の2文字の識別子です。たとえば、「US」などです。
subject 要素は、ゴールセットの名前を指定します。要素は、ファイル内で1回だけ指定する必要があります。

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

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

  1. [ゴール]画面の[ゴールセット]列。
  2. [ゴールセットの編集]画面の[セット名]フィールド。
  3. [コンテンツ]画面の[ゴールセット名]列。
  4. [ゴールの検出]画面の[ゴールセット]列と[ゴールセット]展開可能リスト。
code ゴールセットの識別子です。5文字以下で入力します。スペースは使用しないでください。
document_set 要素は、ゴールセットのタイプを記述します。要素は、ファイル内で1回だけ指定する必要があります。

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

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

  1. [ゴールセットの編集]画面の[セットタイプ]フィールド。
  2. [ゴールの検出]画面の[ゴールセットタイプ]展開可能リスト。
uid ゴールセットタイプの識別子です。スペースは使用しないでください。
grade_range 要素は、カテゴリを記述します。要素は、ファイル内で1つ以上指定する必要があります。要素の数は、要素の数と一致している必要があります。

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

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

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

通常、これらを使用すると、デフォルトでアルファベット順に並べられたカテゴリは無効になります。たとえば、以下の行の場合、「Kindergarten」カテゴリが強制的にリストの最上位になります。

Kindergarten
Grade 1
Grade 2
Grade 3
Grade 4

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

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

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

要素は、ファイル内で1つ以上指定する必要があります。要素の数は、要素の数と一致している必要があります。

uid ゴールの識別子です。たとえば、「001」などです。各に含まれるIDは、それぞれ固有である必要があります。

この識別子は、[ゴールの編集]画面の[一意のID]フィールドのUIに表示されます。

title カテゴリのタイトルです。たとえば、「Measurement」などです。各要素の要素は、ファイル内で1回だけ指定する必要があります。

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

  1. [ゴール]画面の[カテゴリ]列。
  2. [コンテンツ]画面の[カテゴリ]列。
  3. [ゴールの検出]画面の[カテゴリ]展開可能リスト。
grade_range_ref 要素は、ゴールのセットをカテゴリに関連付けます。各要素内の要素は、ファイル内で1回だけ指定する必要があります。
code 対応するカテゴリの要素のcode属性を入力します。
item 要素はゴールを記述します。各要素内の要素は、ファイル内で1つ以上指定する必要があります。
uid ゴールの一意の識別子です。257文字以下で入力します。
parent_uid 親ゴールのIDです。親ゴールが存在しない場合は、プレースホルダテキストを削除し、この属性を空白のままにします。
label ゴールタイプです。たとえば、「Instrumentation Type」などです。このテキストは、[ゴールの検出]画面の[ゴールタイプ]展開可能リストのUIに表示されます。
linkable 次の内のいずれかです。
  • Y - ゴールは制限されません。
  • N - ゴールは制限されます。

制限付きゴールは、カテゴリに明示的に関連付けられたコースでのみ表示されますゴール画面では、これらのゴールの横には矢印アイコンが付いていて、新しいウィンドウで開けることを示しています。コースをカテゴリに関連付けるには、カテゴリのメニューを開いて、[コースへの関連付け]を選択します。

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

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

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

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

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

スキーマ

XMLファイルのXMLスキーマを以下に示します。

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


XMLファイルのUIへの影響

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

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

[ゴール]画面

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

[ゴールの編集]画面

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

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

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

[コンテンツ]画面

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

[ゴールの検出]画面

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


項目の削除

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


項目の追加と置換

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

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

UIDの階層

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

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

新しい項目の追加

階層内の上位の項目を同じUIDに保持し、階層内の下位の項目に別のUIDを使用することによって、新しい項目を追加したり古い項目を置換したりすることができます。

  1. 最初に以下の属性が含まれるファイルをアップロードするとします。これにより、ゴールセット、カテゴリ、およびゴールが作成されます。
    document>
    UID

    UID

    CODE

    UID

    UID
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       ">Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. 次に、以下の属性が含まれるファイルをアップロードすると、新しいカテゴリと新しいゴールが作成されます。
    document>
    UID

    UID

    CODE

    UID

    UID
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_A">Category A
       STANDARD_A">
          Category A
          
          ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

    要素のUIDを変更する場合は、要素のcode属性も変更する必要があります。要素のUIDだけを変更した場合、インポートは失敗します。

  3. 次に、同じ属性でコンテンツが異なるファイルをアップロードすると、ゴールのステートメントが更新されます。

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

       Blackboard College
       Goal Set 1
       Goal Set Type 1
       Category A
       
          Category A
          
          
             This is the new goal.
          
       

名前の変更

同じUIDのセットでcode属性が異なる情報をアップロードすると、項目名が変更されます。

  1. 最初に以下の属性が含まれるファイルをアップロードするとします。これにより、ゴールセット、カテゴリ、およびゴールが作成されます。
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       SUBJECT_1">Goal Set 1
       Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. 次に、以下の属性が含まれるファイルをアップロードすると、(「Goal Set 1」から「Goal Set B」に) ゴールセット名が変更されます。
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       SUBJECT_B">Goal Set B
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

この手順は要素のcode属性の名前を変更することもできます。

階層の上位項目の追加または変更

階層内の下位の要素のUIDがすでに使用されているが、階層内の上位の要素に別のUIDが使用されている場合は、エラーが表示され、ファイルがアップロードされません。

  1. 最初に以下の属性が含まれるファイルをアップロードするとします。これにより、ゴールセット、カテゴリ、およびゴールが作成されます。
    document>
    UID
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. 次に、以下の属性が含まれるファイルをアップロードしようとすると、アップロードは失敗します。
    document>
    UID
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

階層内の上位の項目を追加または変更する場合は、階層内の下位の項目に別のUIDを使用する必要があります。