はじめに
CSVを使うと、表計算ソフトでまとめて編集した問題をDiQtに取り込めます。作成・更新はWeb版で行います。問題作成機能を利用できるプレミアム会員でログインしてください。教室内では、そのチャプターの問題集を編集できる権限も必要です。
新規作成には、このページ上部の「CSVテンプレートをダウンロード」を使います。すでにある問題集を更新するときは、その問題集の「この問題集のCSVをダウンロード」を使ってください。
新しい問題集を作る
- 問題集をCSVで作成するを開きます。教室のチャプターに作る場合は、対象チャプター内の「問題集をCSVで作成する」から開きます。
- テンプレートをダウンロードし、ExcelやGoogleスプレッドシートなどで開きます。サンプル行を自分の問題に置き換えます。
- 1行目の英語の列名を保ち、2行目以降に1行1問で入力します。通常の問題では
questionとcorrect_answerが必須です。 - UTF-8・カンマ区切りのCSVで保存します。Excelでは「CSV UTF-8(コンマ区切り)」を選びます。
.xlsxのままでは取り込めません。 - 作成画面で問題集の名前・言語・必要な設定を入力し、CSVファイルを選んで「作成」を押します。
- 作成後の問題集で、問題数、問題文、正解、選択肢と設定を確認します。
テンプレートには、選択式と発音問題のサンプルが入っています。使わないサンプル行は削除してください。すべてのセルが空の行は読み飛ばされますが、問題文か正解だけが欠けた行があると、ファイル全体の取り込みが止まります。
既存の問題集を更新する
- 更新する問題集を開き、サイドバーの「設定」にある管理者機能から「CSVで問題を編集する」を開きます。
- 「この問題集のCSVをダウンロード」を押し、編集前のファイルを手元に残します。
- ダウンロードしたCSVを編集します。先頭の
quiz_id列は、今ある問題と行を対応させるためのものです。既存の問題のIDを変更しないでください。 - UTF-8のCSVで保存し、編集画面でファイルを選んで「更新」を押します。
- 表示された上書き・追加・削除の件数と、問題集の内容を確認します。
| したいこと | CSVの編集方法 |
|---|---|
| 問題の内容を直す | quiz_id は保ち、同じ行の問題文・正解などを編集します。 |
| 問題を追加する | 新しい行を追加し、その行の quiz_id を空欄にします。 |
| 問題の順番を変える | quiz_id を含む行全体を並べ替えます。取り込み後はCSVの行順になります。 |
| 問題を削除する | 対象の行を削除し、取り込み画面で「CSVに無い問題を削除する」をオンにします。 |
削除すると、その問題の解答履歴や復習などの学習記録も削除されます。 削除を許可しない状態では、削除が必要になるCSVは取り込まれず、何も変更されません。削除の許可は取り込みのたびに選び直します。
quiz_id 列のない古いCSVも読み込めますが、上から順に今ある問題へ上書きします。行の削除・追加・並べ替えには、問題集からダウンロードした quiz_id 付きのCSVを使ってください。他の問題集のID、重複したID、不正なIDは取り込めません。
更新用CSVは、一部の列だけを送る差分ファイルではありません。 列を削ったり空欄にしたりすると、既存の設定や内容が消える、または初期値に戻る項目があります。ダウンロードした列を保って編集してください。
基本の列
列名は半角の英小文字で、前後に空白を入れずに書きます。オン・オフの項目には true または false を使います。
| 列名 | 入れる内容 |
|---|---|
question |
問題文。通常の問題では必須です。 |
correct_answer |
正解。必須です。入力式で複数の正解を認める場合は color;colour のように半角の ; で区切ります。 |
distractor_1、distractor_2、distractor_3、distractor_4 |
誤りの選択肢。1から順に指定し、最大4件(正解と合わせて最大5択)です。 |
explanation |
解答後に確認できる解説。 |
hint |
問題を解くときのヒント。 |
short_answer_enabled |
true は入力式。false は選択肢があれば選択式、選択肢がなければ単語カード形式です。空欄は false。 |
question_hidden |
true で問題文を非表示にします。リスニング問題などに使います。空欄は false。 |
lang_code_of_question |
問題文の言語コード。日本語は ja、英語は en など。 |
lang_code_of_answer |
正解の言語コード。日本語は ja、英語は en など。 |
question_read_aloud |
true で問題文の読み上げを有効にします。空欄は false。 |
answer_read_aloud |
true で答えの読み上げを有効にします。自動再生は利用者の解答設定にも従います。空欄は false。 |
applied_dictionary_id |
問題で使う辞書のID。たとえば /ja/dictionaries/1 の辞書は 1 です。 |
auto_dict_link_of_question |
true で問題文全体を辞書リンクとして扱います。利用する辞書も設定してください。 |
auto_dict_link_of_answer |
true で正解全体を辞書リンクとして扱います。利用する辞書も設定してください。 |
問題文・正解・ヒント・解説にはディクトマークダウンを使えます。言語コードは日本語・英語以外にも対応しています。画面で選べる言語に合わせてコードを指定し、読み上げや発音問題の対応範囲はそれぞれの機能で確認してください。
最小限の例
question,correct_answer,distractor_1,distractor_2,distractor_3,lang_code_of_question,lang_code_of_answer
「りんご」は英語で?,apple,orange,grape,peach,ja,en
セル内にカンマや改行を含む場合は、表計算ソフトのCSV保存機能を使うと引用符が付けられます。手でCSVを書く場合はセル全体を " で囲み、セル内の " は "" と書きます。
発音問題・AI判定を使う
| 列名 | 入れる内容 |
|---|---|
answer_mode |
通常は text。声で答える発音問題は speech。空欄は text。 |
answer_judgement_mode |
通常は exact。入力内容をAIで判定する場合は azure_openai。空欄は exact。 |
pronunciation_accuracy_threshold |
発音の正確性の合格基準。0〜100の整数。空欄は既定値80。 |
pronunciation_completeness_threshold |
発音の完全性の合格基準。0〜100の整数。空欄は既定値80。 |
pronunciation_assessment_locale |
発音評価に使う言語・地域。答えの言語に対応する値(例: en-GB)を指定します。空欄はその言語の既定値。 |
- 発音問題は
short_answer_enabled=true、answer_mode=speechにします。 - AI判定は
short_answer_enabled=true、answer_mode=text、answer_judgement_mode=azure_openaiにします。 - AI判定は、試験モードの問題集で試験を提出したときだけ行われます。問題を解く画面や復習では、正解と一致した答えだけが正解になります。試験の設定は 試験の作成と実施 をご覧ください。
- 発音問題とAI判定を同じ問題に組み合わせることはできません。
語句整序問題を作る
question_formatにword_orderを指定します。tokensにWhen | do | you | get | upのように、語句を半角の|で区切って入力します。correct_answerにWhen do you get up?のように正解を入力します。promptに指示文を入力します。空欄は既定の指示文になります。questionも空欄なら、指示文と語句から問題文が作られます。
語句を半角スペースでつないだ内容が正解と一致するようにしてください。文末の . ? ! などは語句に含めなくてもかまいません。カンマなど、語句の途中に必要な記号は語句に含めます。
語句整序では、入力式・テキスト解答・厳格一致の設定になります。既存の語句整序問題の question だけを編集した場合は、その2行目の / 区切りから語句を読み取ります。tokens や prompt も変更した場合は、そちらが優先されます。
その他の列
| 列名 | 用途・注意点 |
|---|---|
question_format |
通常は standard。ほかに multiple_choice、fill_in_blank、word_order、sentence_transformation が使われます。 |
prompt、stem、target |
問題形式ごとの指示文・本文・対象語句。既存の形式を更新するときは保持してください。 |
tokens |
語句整序の語句。半角の縦棒(|)で区切ります。 |
accepted_answers |
問題形式の追加データとして使う正解候補。通常の入力式の複数正解は correct_answer の ; 区切りで指定します。 |
question_audio_url、answer_audio_url |
問題文・答えに使用する音声のURL。既存問題の更新時は、使う音声の値を保ってください。 |
synced_word_id、synced_sentence_id |
同期元の単語・例文のID。通常の独立した問題は空欄にします。 |
synced_question_type、synced_answer_type |
問題文・正解の同期方法。通常は not_synced。同期している問題では元の設定を保ちます。 |
needs_review |
内容確認が必要な問題は true、解除する場合は false。1・0 も使えます。更新時の空欄・列の省略では現在のフラグを保ちます。 |
review_reason |
内容確認が必要な理由。空欄を送ると理由を消し、列を省略すると現在の理由を保ちます。 |
ai_explanation |
書き出し時のAI解説の参照用。CSVからの取り込みでは更新されません。解説を編集する場合は explanation を使います。 |
quiz_id |
既存問題の更新用ID。問題集から書き出したCSVに付きます。新規テンプレートにはありません。 |
旧CSVに distractor_4 列がない場合、更新時も現在の4番目の誤答を保ちます。列を含めて空欄にすると、その誤答を削除できます。
誤りの選択肢をまとめて設定する
問題集の「設定」から「選択肢の設定」を開きます。既存の選択肢も上書きするか、AI生成を使うかを確認して実行してください。通常の一括設定は、その問題集内のほかの正解を候補に使います。生成後は、正解と誤答の組み合わせを確認してください。
エラーが出たとき
取り込み中のCSV検証でエラーになった場合、その取り込みによる作成・更新は保存されません。表示された行番号・列名を確認して修正します。
| 表示・症状 | 対処 |
|---|---|
| UTF-8として読み込めない・文字化けする | 「CSV UTF-8(コンマ区切り)」で保存し直します。 |
| 必須の列がない | 1行目に question、correct_answer があるか、英字の大文字・前後の空白・区切り文字を確認します。 |
| 問題文か正解がない | 指摘された行を埋めるか、使わない行全体を削除します。見た目が空でも、ほかの列に設定が残っている行には注意してください。 |
| 引用符や改行の書式エラー | 指摘された行と前後を直すか、表計算ソフトからCSVとして保存し直します。 |
| IDや行がずれている | 対象の問題集のCSVを再ダウンロードします。特定の列だけを並べ替えず、行全体を編集します。 |
| 問題の削除が必要 | 削除対象を確認します。学習記録も削除してよい場合だけ「CSVに無い問題を削除する」をオンにします。 |
| 表計算ソフトによる書き換えの疑い | 007 が 7、1/2 が日付になるなどの変化を確認します。元の値を保つ場合は、取り込み画面の「表計算ソフトが書き換えたように見えるセルを、今の値のまま残す」をオンにします。ほかのセルの変更は取り込まれます。 |
#NAME?、#VALUE!、#DIV/0! などのエラー値 |
セルを文字列として入力し直します。-ing などは先頭にアポストロフィを付けて入力する方法もあります。エラー値そのものを教材にしたい場合は、取り込み後に問題の編集画面で設定します。 |
列を減らしてエラーを回避すると、別の設定を消してしまう場合があります。更新では列を保ち、指摘された値を修正してください。