カルテデータ エクスポート/インポート

修学カルテで定義した任意のデータ項目(ユーザのプロフィール情報や取得資格、TOEICの点数など)について、学生や指導教員が入力したデータを、CSVファイルでエクスポートしたり、インポートしたりすることができます。

カルテデータをエクスポートするには「CSVデータエクスポート」権限、インポートするには「CSVデータインポート」権限が必要です。

エクスポート

以下の手順で、カルテデータをエクスポートできます。

  1. カルテを登録するの手順通りに、修学カルテ(管理)画面を開きます。

  2. 画面左に、修学カルテ用に権限設定された組織が表示されます。組織を選んでクリックします。

    shugaku carte admin organizations
  3. 画面右に以下のような画面が表示されます。カルテを選択します。

    select carte
  4. 「カルテデータエクスポート」ボタンをクリックするとエクスポートフォームが表示されます。出力するユーザを「検索結果の全員」か「チェックボックスで選択」のいずれかから選択します。

    export form
  5. 入力内容を出力する場合は「入力内容を含める」にチェックを入れ、出力形式を選択します。必要に応じて「ファイルを含める」や「カードごとの入力状況を含める」にもチェックを入れます。

  6. 「エクスポートファイルを生成する」をクリックし、生成されたリンクからZIPファイルをダウンロードします。

出力形式を選択する

入力内容の用途に合わせて、次の出力形式を選択できます。

出力形式 用途と特徴 インポート

標準形式(インポート可能)

バックアップやデータ更新に使用します。固定式カードはユーザごと、追記式カードは入力データごとに1行で出力します。

可能

集計形式(複合回答を列に分割)

表計算ソフトでの集計に使用します。標準形式と同じ行構成で、ルーブリックの各評価項目と複数選択の各選択肢を別々の列に出力します。

不可

分析形式(回答ごとに1行・複数CSV)

BIツールや統計ソフトでの分析に使用します。ユーザ、設問、選択肢、回答を別々のCSVに出力します。

不可

エクスポートしたデータを再度インポートする場合は、「標準形式(インポート可能)」を選択してください。

「入力内容を含める」のチェックを外すと、出力形式と「ファイルを含める」は選択できません。「カードごとの入力状況を含める」は、入力内容とは別に出力できます。

標準形式

ZIPファイル内では、固定式カードのデータを static_cards/static_cards.csv、追記式カードのデータを appendable_cards ディレクトリ内のカードごとのCSVに出力します。

追記式CSVの先頭行には、次の値が出力されます。

  • doc_id=<カルテID>

  • appendable_card_id=<追記式カードID>

2行目の先頭には action 列が出力されます。エクスポート時の action は空欄です。空欄のまま再インポートした行は処理されないため、エクスポートしたCSVをそのままインポートしても追記式データは変更されません。

追記式CSVの対象カードは、先頭行の doc_id と appendable_card_id で判定されます。CSVのファイル名は変更できます。

集計形式

ZIPファイル内の構成とデータの行単位は標準形式と同じです。ルーブリックは評価項目ごと、複数選択は選択肢ごとに列を分けて出力します。複数選択の値は、選択済みの場合は 1、未選択の場合は 0 です。

集計形式のCSVはインポートできません。

分析形式

ZIPファイル内のカルテIDのディレクトリ直下に、次のCSVを出力します。

ファイル 内容

users.csv

対象ユーザのユーザID、氏名、プロフィール項目

questions.csv

カードと設問の定義。ルーブリックは評価項目ごと、複数選択は選択肢ごとに1行

options.csv

選択式項目、ルーブリック、複数選択の選択肢

answers.csv

各ユーザの回答。通常の項目、ルーブリックの評価項目、複数選択の選択肢ごとに1行

answers.csv の card_key には追記式カードの入力データを識別する値、modified_at には項目の更新日時を出力します。複数選択の回答値は、選択済みの場合は 1、未選択の場合は 0 です。

分析形式のCSVはインポートできません。

添付ファイルとカードごとの入力状況

「ファイルを含める」を選択すると、添付ファイルを files ディレクトリへ格納します。標準形式と集計形式では各カードのディレクトリ内、分析形式ではカルテIDのディレクトリ直下に作成されます。CSVにはZIPファイル内の相対パスを出力します。

「カードごとの入力状況を含める」を選択すると、出力形式にかかわらず card_input_status.csv を出力します。

インポート

以下の手順で、カルテデータをインポートできます。

  1. カルテを登録するの手順通りに、修学カルテ(管理)画面を開きます。

  2. 画面左に、修学カルテ用に権限設定された組織が表示されます。組織を選んでクリックします。

    shugaku carte admin organizations
  3. 画面右に以下のような画面が表示されます。カルテを選択します。

    select carte
  4. 「カルテデータインポート」ボタンをクリックするとインポートフォームが表示されます。

    batch import form
  5. CSVあるいはCSVを含んだZIPファイルをアップロードし、「一括登録する」ボタンをクリックするとインポートできます。

    batch import submit

追記式データを追加・更新・削除する

追記式CSVの各行の action に、実行する操作を指定します。

action card_key 処理

insert

任意

レコードを追加します。card_key が空欄の場合は自動生成されます。指定する場合は、対象ユーザの対象追記式カード内で未使用の値を入力します。項目がすべて空欄でも、空のレコードを追加できます。

update

必須

既存レコードを更新します。エクスポートされた card_key は変更しないでください。

delete

必須

既存レコードを削除します。card_key 以外の項目値は参照されません。

空欄

参照されません

行全体を処理しません。

insert、update、delete 以外の値はエラーになります。

ファイル入力項目へ添付ファイルを取り込む場合は、CSVでファイル名を指定し、CSVと対象ファイルを1つのZIPファイルにまとめてインポートします。

インポート機能では、アドバイザーが編集可能な項目のみ更新できます。学生の入力欄は更新されません。
インポート時、CSVに含まれている列のみ更新されます。更新の必要のない列は削除してインポートすることで、誤って上書きすることを防ぐことができます。
カルテXMLで設定することでWebClassのプロフィールデータを修学カルテ上で表示することが可能ですが、この項目はインポートの対象外です。WebClassシステム管理者がユーザ管理画面からCSVで一括更新することができます。