メインコンテンツまでスキップ

資料情報と設定の保存

資料情報​

sdk.material;
// {
// description: { type: 'text', text: '…' } 또는 { type: 'html', html: '…' },
// entries: { learn: 'index.html', instructor: 'instructor.html', edit: 'edit.html' },
// settings: { … }, // 설정 화면이 저장한 값
// completionPolicy: 'on_submit', // 이 페이지의 학습 완료 설정 (읽기만. 서버가 주지 않으면 null)
// }
  • entriesには、metadata.jsonで有効にした画面のエントリーファイルが入っています。
  • settingsは学生を含むすべての閲覧者に渡される公開値です。正解や秘密の値、学習者の個人情報は入れないでください。例外は採点設定のsettings.gradingだけです。サーバーは学習ページ(学生・チューター・教育者)のレスポンスからgradingを除外し、編集画面でのみ見えます。

設定画面で保存する​

編集ページはentries.editファイルをeditスコープのトークンで表示します。このときmaterial.settingsは資料のdraftの値(draftがなければ現在のバージョンの値)です。保存ボタンを設定画面の中に置いてsaveSettings()を呼び出すとdraftのsettingsが保存され、保存が完了するとmaterial.settingsが保存された値に変わります。学習者は、編集ページでdraftを反映(新しいバージョンとして保存)した後にこの値を受け取ります。

import { EliceCDKError } from '@eliceio/cdk';

if (sdk.screen === 'edit') {
document.getElementById('save').addEventListener('click', async () => {
try {
await sdk.saveSettings({ difficulty: 'hard', questionCount: 10 });
showMessage('저장했습니다.');
} catch (err) {
showMessage(
err.code === EliceCDKError.code.DraftNotSaved
? '자료를 먼저 저장하세요.'
: '저장하지 못했습니다.'
);
}
});
}
  • 同時に保存すると、後のものが残ります。
  • draftがまだ処理中、または処理に失敗した場合はcontent_not_readyで失敗します。
  • 保存前のアップロードの設定画面(#edit=1、トークンなし)ではdraft_not_savedで失敗します。ここで保存すると以前のバージョンの設定が変わり、アップロードが削除されるためです。資料を先に保存してから、設定画面を開き直します。
  • 設定画面の外で呼び出すとscreen_not_supported、セッションが終了していればsession_expiredで失敗します。

保存結果は編集ページにもメッセージで通知されます。成功すると、編集ページは資料を再読み込みします。コンテンツが別途処理することはありません。

{ source: 'eliceio-content-sdk', type: 'settings-saved', materialId, payload: { status: 'saved' } }
{ source: 'eliceio-content-sdk', type: 'settings-saved', materialId, payload: { status: 'failed', code } }

採点設定(settings.grading)​

採点方式と正解は、設定画面がsaveSettings()でsettings.gradingに保存します。型はEliceCDKGradingです。

settings.grading意味
{ type: "pattern", answer_key }answer_key:正規表現1つ。解答文字列(前後の空白を除去)全体が一致すれば100点、そうでなければ0点
{ type: "partial_pattern", answer_key, scores }問題ごとの部分点。answer_keyは正規表現の配列、scoresは点数の配列(同じ長さで1〜50、それぞれ0〜100の整数、合計100以上)。解答は文字列の配列で、正解した問題の点数の合計(最大100)
{ type: "rubric", rubric }rubric:評価基準。AIが0〜100点で採点
  • 正規表現はすべて、前後の空白を除去した解答全体と照合し(完全一致)、500文字以下で、コンパイルできる必要があります。
  • サーバーはPythonのreで照合します。大文字・小文字を区別しない場合は、先頭に(?i)を付けます(例:(?i)파리|paris)。
await sdk.saveSettings({
...sdk.material.settings,
grading: { type: 'partial_pattern', answer_key: ['(?i)paris', '4', '광합성'], scores: [34, 33, 33] },
});

学習完了設定​

学習完了の基準はsettingsではなく、LXPのページの設定です。資料をアップロードした後、教育者が資料編集画面の「設定」で選択し、バージョンに関係なく維持されます。コンテンツはmaterial.completionPolicyで読み取るだけで、変更しません。

completionPolicyLXPの画面名採点
on_access閲覧時に学習完了採点しない。学生が初めて開いたときに100点で完了
on_submit提出時に学習完了提出すると100点で完了
on_graded解答確認後に完了settings.gradingで採点

採点結果がどのように返されるかは、解答の提出と記録をご覧ください。