お問い合わせ

セッションのインポート/更新（新しいグループを含む）

CSVインポート機能には、最も一般的に使用されるインポートオプションのテンプレートがあらかじめ用意 されています。このトピックでは、新しいグループを持つセッションのCSVインポートのサンプルと、対応するテンプレート内の各エンティティの情報を提供します。

を作成する方法については CSVファイルを作成する方法については、 CSVファイルを使用したデータのインポートを参照してください。

セッションと配信のリンク

  1. データの一括インポート]ウィンドウで、[ CSVテンプレートのダウンロード]を選択します。

  2. ダウンロードしたファイルから sessions-with-delivery-in-new-groups.csv.

  3. CSVファイルで、各列（テンプレートテーブルの最上行）に定義されたエンティティに従って、各選択フィールドに情報を入力する。

新しいグループのセッションをインポートするためのCSVフォーマットのサンプル：

session_deliveryId,group_name,group_description,group_active,session_name,session_timezone,session_startDate,session_endDate,session_submissionDate,session_waitingPageDate,session_securitySettings,session_reviewSettings,session_testRunnerAccessibilityPlugins,session_testRunnerSessionPlugins,session_reportSettings,session_readAloud,group_organizationId
MyDeliveryID,Group B,Grade 10 Math,TRUE,Session 3,Europe/Warsaw,2023-01-01T12:00:00Z,2023-12-31T12:00:00Z,2024-1-31T12:00:00Z,2022-12-1T12:00:00Z, "requireFullscreen,preventRightClickAndKeyboardShortcuts,preventScreenshot", "enableTTReview", "contrast,contrastToolOptions,customPointer,customPointerOptions,font,fontToolOptions,zoom", "studentReport", "print",コンテンツベース,ルート

一番上の行（または行）は、下の対応するフィールドに値を入力するエンティティを指定します。

エンティティ

必須

  • session_deliveryId

    • 既存の配信を参照する。

    • セッションを作成する際には、このフィールドに値を入力することが必須です。

    • この値は、テストの実行が開始されるまで更新することができる。

  • session_name

    • TAOポータルでセッションを識別するために使用される名前。

    • このフィールドへの値の入力は、セッションの作成または更新時に必須です。

  • group_name

    • 新しいグループを参照する。

    • セッションを作成する際には、このフィールドに値を入力することが必須です。

    • CSVインポートで既存のセッションの割り当てグループ（名前）を更新できません。CSVインポートレポートで更新しようとするとエラーが表示されます。

  • group_organizationId

    • グループが割り当てられている（階層内の）組織単位。

    • このフィールドは、組織（階層）が有効になっている場合にのみ有効である。

    • 有効な場合、このフィールドは必須である。

利用可能

  • group_description

    • 新しいグループについての説明。

  • group_active

    • 有効（アクティブ）または無効（非アクティブ）グループを作成する。

    • 空の場合、デフォルト値はActive (TRUE).追加 FALSE をクリックして、グループに非アクティブのフラグを立てる。

    • 数値1と0が使われた場合、それらは自動的にtrueとfalseに変換され、ログファイルに警告が送られる。

  • セッション・タイムゾーン

    • セッションが行われるタイムゾーン。上記で入力された日時を解釈するために使用されます。

    • タイムゾーンが選択されていない場合、TAOポータルのデフォルトタイムゾーンが適用されます。

    • 利用可能なタイムゾーンのリストを表示するには：

      1. セッション管理ウィンドウのテーブルの右上にあるCREATE SESSIONを選択します。

      2. セッションの作成フォームで、タイムゾーンの下にあるリストを表示します。

    • このフィールドの値は以下のフォーマットで入力する：

      • Europe/Berlin

      • America/New_York

  • session_startDate

    • 指定されたグループの受験者がセッションを利用できるようになる日付（別名「オープン日」）。これは必須ではありません。空白の場合、セッションは作成され次第、利用可能になります。

    • 開始日の書式は以下の例に基づいてください：

      • 2023-01-01T11:00:00.000Z日付は2023年1月1日午前11時。

  • session_endDate

    • 割り当てられたグループの受験者がセッションを利用できなくなる日付（別名「終了日」）。進行中のセッションは、この日以降も受験者が提出するまで、または自動提出が実行されるま で（設定されている場合、以下のオプションを参照してください）継続されます。

    • 終了日の選択は必須ではありません。空欄の場合、セッションは時間制限なしで利用できます。

    • 終了日の書式は以下の例に基づいてください：

      • 2023-12-31T12:00:00.000Z日付は2023年12月31日午後12時。

  • session_submissionDate

    • 開始済みで未提出のセッションは、この日に自動的に提出されます。

    • 提出日の書式は、以下の例に基づいてください：

      • 2024-1-31T12:00:00.000Z日付は2024年1月1日午後12時。

  • session_waitingPageDate

    • このフィールドは、「My Sessions」タブ（受験者用）に「Upcoming」として表示されるセッションの日付を指定します。

    • すべての受験者に、同時にテストを開始する前に待機ページを表示させたい場合は、このフィー ルドを以下の日付より後に定義してください。 session_startDate.それが定義されていない場合、またはそれ以降でない場合。 session_startDateその場合、セッションを開始するとすぐにテストの実行が開始されます。

    • ウェイティングページの日付の書式は、以下の例に基づいてください：

      • 2022-12-1T12:00:00.000Z日付は2022年12月1日午後12時。

  • セッション・セキュリティ設定

    • セキュリティオプションは、特にセッションを開始するための承認と、セッション中の受験者の制限に関連して、実行時のテストの動作を制御します。

    • このフィールドに TRUE を、有効にしたい設定の各列に入力してください。値を空にすると、その機能は削除されます。

      • requireFullscreen

        • このオプションを選択すると、受験者は強制的にフルスクリーンモードになり、他のタブやウィンドウに移動できなくなります。

      • preventRightClickAndKeyboardShortcuts

        • このオプションは、コピー／カットペースト、タブの切り替え、ブックマークを開く、開発者モードを開く、その他多くの操作を無効にします。

      • requireAuthorization_pauseTestOnExist

        • このオプションは、禁止された活動の後、セッションを一時停止します。セッションを再開するには、プロクターが必要です。

        • このオプションは requireFullscreen が有効になっている。

      • preventScreenshot

        • このオプションはスクリーンショットを撮る機能を無効にします。

      • requireAuthorization

        • このオプションを選択すると、受験者は試験を開始する前に、試験監督官がセッ ションの状態を承認するのを待つ必要があります。

    • 数値1と0が使われた場合、それらは自動的にtrueとfalseに変換され、ログファイルに警告が送られる。

  • セッション_レビュー設定

    • このフィールドに TRUE を、有効にしたい設定の各列に入力してください。値を空にすると、その機能は削除されます。

      • enableTTReview_showCorrectAnswers

        • このオプションは、受験者に自分の解答の上に正解を表示します。

      • enable_TTReview_showScores

        • このオプションにより、受験者はグループの得点を見ることができます。

      • enableTTReview

        • このオプションでは、受験者が提供したすべての解答を表示しながら、提出されたテストをレビューすることができます。

    • 数値1と0が使われた場合、それらは自動的にtrueとfalseに変換され、ログファイルに警告が送られる。

  • session_testRunnerAccessibilityPlugins

    • アクセシビリティオプションは、セッション中に受験者が利用できる補助ツールを制御します。各アクセシビリティオプションの詳細については、「」のアクセシビリティオプションを参照してください。

    • このフィールドに、有効にしたいアクセシビリティ・ツールを引用符で囲んだリストとして入力します（各設定はカンマで区切ります）：

      • 対照
      • コントラストツールオプション
      • カスタムポインタ
      • カスタムポインターオプション
      • フォント
      • フォントツールオプション
      • ズーム

  • session_testRunnerSessionPlugins

    • このフィールドに "print" は、セッション中に印刷するオプションを非表示にします（テストレベルで印刷を許可するように設定されている場合）。

      • 値が指定されていない場合、デフォルトでは印刷オプションは非表示にならない。

  • session_reportSettings

    • このフィールドに “studentReport" では、受験者が自分の成績のレポートを見ることができます。

  • session_readAloud

    • 有効にすると、このツールは現在の質問の定義された言語でスクリーンリーダーとして動作します。デフォルトでは、このオプションはコンテンツベースで、特定のインタラクションの間のみ利用可能です。

    • このフィールドには、以下の値のいずれかを入力する：

      • "content-based"

      • "always-enabled" (テストレベルでの設定を上書きする）

      • "always-disabled"（テストレベルでの設定を上書きします。）

         

既存のグループのセッションを更新する

  1. CSVインポートでセッションを更新する際に、任意のエンティティ/値を更新できます。

  2. カラムの値が空白の場合、対応する値は削除される（必須でない場合、そうでない場合はエラーとなる）。

  3. カラムの値に新しい値があると、前の値に置き換わる。

  4. カラムが削除された場合、既存の値が保持されます。