どんな発表? 他のシステム内の学習履歴 ( 評点 + フィードバック ) 他の LMS Excel 成績表やりたいこと Moodle オフライン課題や Gradebook に自動的に集約やりたくないこと Moodle プラグイン開発 Moodle ソース改変 Moodle Mood

Size: px

Start display at page:

Download "どんな発表? 他のシステム内の学習履歴 ( 評点 + フィードバック ) 他の LMS Excel 成績表やりたいこと Moodle オフライン課題や Gradebook に自動的に集約やりたくないこと Moodle プラグイン開発 Moodle ソース改変 Moodle Mood"

ゆゆこごみぶち
6 years ago
Views:

1 ID388 (Booklet p.27) Moodle Web Service を用いたバルク評定インポート Bulk Grade Import with Moodle Web Service 樋口三郎 ( 龍谷大学理工学部 ) Saburo Higuchi (Ryukoku University) hhp://hig3.net

2 どんな発表? 他のシステム内の学習履歴 ( 評点 + フィードバック ) 他の LMS Excel 成績表やりたいこと Moodle オフライン課題や Gradebook に自動的に集約やりたくないこと Moodle プラグイン開発 Moodle ソース改変 Moodle Moodle Web Service とは HTTP で Moodle に機能実行を指令, データ転送する機能 MoodleMoot Japan バルク評定インポート 2

3 評定インポートとは 3

4 LT293(at 東京家政大 2013) ユーザ視点から見た種々の評定インポート方法龍谷大学 Grade Import Techniques for Moodle 2.4 樋口三郎 ( 龍谷大学 ) Saburo Higuchi (Ryukoku University)

5 比較 CSV XML Grade Publishing LTI v1 Web Service 基本的柔軟対話的非対話的自動化可能とりあえず動く標準化標準化なんでもできる ( はず ) 自動化不可識別子固定危険受験のたびに 1 名ずつまだ実装がない認証認可 Moodle User 認証, capability IP + key as URL query parameter OAuth OAuth MoodleMoot Japan 評定インポート ( 樋口 ) 5

6 どんな報告者? 龍谷大学理工学部数理情報学科 ( 教員 ) 全学の仕様策定運用側ではない Moodle 歴全学サーバの教員ユーザ (1.x- ) 自前サーバ (2.7) の管理者 + 教員ユーザ学内的 LMS 普及活動 2008,2013, Mahara, 他 Web アプリ併用こんな科目計算科学演習 II, 確率統計演習 I, (1 年生向け計算機科学導入科目 ),(3 年生向けキャリア開発科目 ),(3,4 年生向け卒業研究 ),( インターンシップ科目 ),TA 向け, 学科学生向け龍谷大学全学 = 情報メディアセンターの LMS Moodle Moodle 2.7LTS + Manaba course (2015) MoodleMoot Japan バルク評定インポート 6

7 Introduc^on Demonstra^on Moodle Web Servicre とは実装比較と考察 MoodleMoot Japan バルク評定インポート 7

8 Demo hhps://gist.github.com/hig3/ Web Service Client HTTP サイト管理者がWeb Service 有効化コース教員がtoken生成 Moodleの`token を預ける目的に応じてプログラムプラウザ MoodleMoot Japan バルク評定インポート 8

9 クライアントから / バッチ処理も可能管理者が Web Service 有効化評定を管理できるコースの教員 wget, curl を用いた script MoodleMoot Japan バルク評定インポート 9

10 Moodle Web Service とは MoodleMoot Japan バルク評定インポート 10

11 Moodle Web Service in 5 minutes ( 要サイト管理者権限 ) 1 個のMoodleサーバで Web Service 機能 ( 総称 ) を有効化複数のWeb Service ( 可算名詞 ) を定義 Moodle Mobile Web Service (Built- in) External Service 1 (Custom) External Service 2 (Custom) MoodleMoot Japan バルク評定インポート 11

12 Web Service (External) 1 個の Web Service は, 次で定義される Web Service が使用できる Web Service 関数群 = 機能必要な capability 群が定まる Web Service を使用できるユーザ群全員の使用を許す選択肢もあり Userid による制限ユーザが持つべき capability による制限 Capabiilty: Moodle において, ユーザが特定の機能を実行できる権限 MoodleMoot Japan バルク評定インポート 12

13 Moodle Web Service 関数 hhps://tracker.moodle.org/browse/ MDL Administra^on > Site administra^on > Plugins > Web Services > API Documenta^on MoodleMoot Japan バルク評定インポート 13

14 MoodleMoot Japan バルク評定インポート 14

15 core_calendar_create_calendar_events core_calendar_delete_calendar_events core_calendar_get_calendar_events core_cohort_add_cohort_members core_cohort_create_cohorts core_cohort_delete_cohort_members core_cohort_delete_cohorts core_cohort_get_cohort_members core_cohort_get_cohorts core_cohort_update_cohorts core_course_create_categories core_course_create_courses core_course_delete_categories core_course_delete_courses core_course_delete_modules core_course_duplicate_course core_course_get_categories core_course_get_contents core_course_get_courses core_course_import_course core_course_update_categories core_course_update_courses core_enrol_get_course_enrolment_methods core_enrol_get_enrolled_users core_enrol_get_enrolled_users_with_capability core_enrol_get_users_courses core_files_get_files core_files_upload core_get_component_strings core_get_string core_get_strings core_grade_get_defini^ons core_grades_get_grades core_grades_update_grades core_grading_get_defini^ons core_grading_get_gradingform_instances core_grading_save_defini^ons core_group_add_group_members core_group_assign_grouping core_group_create_groupings core_group_create_groups core_group_delete_group_members core_group_delete_groupings core_group_delete_groups core_group_get_course_groupings core_group_get_course_groups core_group_get_group_members core_group_get_groupings core_group_get_groups core_group_unassign_grouping core_group_update_groupings core_message_block_contacts core_message_create_contacts core_message_delete_contacts core_message_get_contacts core_message_get_messages core_message_search_contacts core_message_send_instant_messages core_message_unblock_contacts core_notes_create_notes core_notes_delete_notes core_notes_get_notes core_notes_update_notes core_role_assign_roles core_role_unassign_roles core_user_add_user_device core_user_create_users core_user_delete_users core_user_get_course_user_profiles core_user_get_users core_user_get_users_by_field core_user_get_users_by_id core_user_update_users core_webservice_get_site_info enrol_manual_enrol_users enrol_self_get_instance_info message_airno^fier_are_no^fica^on_preferences_configured message_airno^fier_is_system_configured mod_assign_get_assignments mod_assign_get_grades mod_assign_get_submissions mod_assign_get_user_flags mod_assign_get_user_mappings mod_assign_lock_submissions mod_assign_reveal_iden^^es mod_assign_revert_submissions_to_drah mod_assign_save_grade mod_assign_save_grades mod_assign_save_submission mod_assign_save_user_extensions mod_assign_set_user_flags mod_assign_submit_for_grading mod_assign_unlock_submissions mod_forum_get_forum_discussion_posts mod_forum_get_forum_discussions mod_forum_get_forum_discussions_paginated mod_forum_get_forums_by_courses moodle_course_create_courses moodle_course_get_courses moodle_enrol_get_enrolled_users moodle_enrol_get_users_courses moodle_enrol_manual_enrol_users moodle_file_get_files moodle_file_upload moodle_group_add_groupmembers moodle_group_create_groups moodle_group_delete_groupmembers moodle_group_delete_groups moodle_group_get_course_groups moodle_group_get_groupmembers moodle_group_get_groups moodle_message_send_instantmessages moodle_notes_create_notes moodle_role_assign moodle_role_unassign moodle_user_create_users moodle_user_delete_users moodle_user_get_course_par^cipants_by_id moodle_user_get_users_by_courseid moodle_user_get_users_by_id moodle_user_update_users MoodleMoot Japan バルク評定インポート 15

16 評定関係の Moodle Web Service 関数 Gradebook 操作 ( すべての Ac^vity, Item を Grade 可能 ) core_grades_get_grades core_grades_update_grades (Assignment の中では Final Grade だけ変更されたように見える. Feedback 付加不能 ) Assignment 評定操作 mod_assign_get_grades mod_assign_save_grade (GUI と同等の Grading が可能 ) mod_assign_save_grades (GUI と同等の Grading が可能 ) 他の core module の評定の関数はない自作 module なら任意の Web service 関数を実装可能 MoodleMoot Japan バルク評定インポート 16

17 Web Service を使用するユーザ Web service 経由で指令を出す capability webservice/rest:use Web service で評定を実行する capability 評点を操作する関数を使うには教員 role くらい必要評定インポートの場合, 次のいずれかが適切? WS ユーザ role を作り, コース教員に付与する教員 role を修正 Role: 管理者, 教員, 編集権限のない教員, 学生, MoodleMoot Japan バルク評定インポート 17

18 実装 MoodleMoot Japan バルク評定インポート 18

19 Moodle 側設定手順 ( 要サイト管理者権限 ) hhps://docs.moodle.org/28/en/ Using_web_services Web Service 機能を有効化 Web Service を定義教員ユーザに必要な capability を与える教員ユーザにセキュリティキー (token) を与える MoodleMoot Japan バルク評定インポート 19

20 MoodleMoot Japan バルク評定インポート 20

21 Security key or token による認証 (Web Service, ユーザ ) の有効な組を指定するパスワードのようなもの生成サイト管理者が生成 capability moodle/webservice:createtoken を有するユーザ自身が生成 IP, 期間による制限 REST の場合, これを URL パラメタとして渡す MoodleMoot Japan バルク評定インポート 21

22 Web Service Client 実装 core_grade_xxx_grades の実装例 hhps://gist.github.com/jleyva/ by Juan Leyva Web Service 一般の実装例 hhps://github.com/moodlehq/sample- ws- clients (Java, Perl, JavaScript, PHP) (REST, SOAP, XML- RPC) MoodleMoot Japan バルク評定インポート 22

23 Web Service Client 実装方針 WSC 独自に教員ユーザを認証教員ユーザと, Web Service token ( 秘匿 ) を紐付け WSC 学生ユーザは Moodle の userid, , fistname, lastname などで一意対応評定項目は, 一意に識別できればいい適切な capability があれば, 活動を作って評定を記入, も可能 Mod_assgin_save_grades Assignmen^d=2 userid grade feedback 3 80 Well done 4 99 Excellent Resubmission required Core_grade_update_grades Userid\cmid MoodleMoot Japan バルク評定インポート 23

24 POST URL hhp://moodleserver.org/webservice/rest/server.php?wstoken=xxxxxxxxxxxxxxxxxxxxxxxxxxx &wsfunc^on=mod_assign_save_grades &moodlewsrespormat=json MoodleMoot Japan バルク評定インポート 24

25 POST Data (in JSON) {'assignmen^d' :1, // 課題 id 'applytoall' :1, // グループ提出課題の扱い 'grades' :{ {'userid' :1, // 変更したい学生のみ 'grade': 99, // 評点 'ahemptnumber' : - 1, 'addahempt' : 1, 'workflowstate' : 'released', 'plugindata':{'assignfeedbackcomments_editor': {'text':'feedback Text', // フィードバック 'format':1}, 'files_filemanager':0 } }, {'userid':2,...}, } } MoodleMoot Japan バルク評定インポート 25

26 比較と考察 MoodleMoot Japan バルク評定インポート 26

27 Web Service ( 対手動インポート ) 課題 (assign) オフライン評定ワークシート mod_assign_save_grades Web Service 関数評定 (Gradebook) CSV Import XML Import core_grade_save_grades Web Service 関数 Web Service を使うと完全な自動化が可能 MoodleMoot Japan バルク評定インポート 27

28 Web Service ( 対 Moodle カスタマイズ ) 長所既存の Web アプリの機能追加として実装容易 Moodle 側ではサイト管理者に一度だけ機能有効化してもらえばよい Moodle 側のカスタマイズ不要. バージョンアップの際に API が保たれる可能性が高い短所 Web Service 関数として提供される機能はごく一部 MoodleMoot Japan バルク評定インポート 28

29 比較課題オフライン評定 CSV Import XML Grade Publishing LTI / LIS Web Service 基本的柔軟対話的容易基本的柔軟対話的非対話的自動化可能とりあえず動く標準化標準化クライアント側の自由度高いバルクでない. 1 活動ずつ. 自動化不可. 自動化不可識別子固定危険バルクでない. 受験のたびに 1 名 /1 活動ずつ実装文書化進行中認証認可 Moodle User 認証 Moodle User 認証 IP + key as URL query parameter OAuth IP + Key as URL query parameter MoodleMoot Japan 評定インポート ( 樋口 ) 29

30 野望1:携帯出席データの集約 HTTP 全学Moodle サイト管理者に Web Service を有効化してもらう必要コース教員がtoken生成する必要 cron Web Service Client 携帯出席サーバスマートフォンフィーチャーフォン MoodleMoot Japan バルク評定インポート 30

31 野望2:クリッカー投票結果のリフレクション Web Service Client HTTP サイト管理者がWeb Service 有効化コース教員がtoken生成 MoodleMoot Japan バルク評定インポート変換サーバ Upload Excel Worksheets 31

32 評定インポートとは 32

33 拝啓サイト管理者様有効化してあげてください enablewebservices capability 与えてあげてください moodle/webservice:userest moodle/webservice:createtoken 33

MoodleGradeImport4Web.pptx

MoodleGradeImport4Web.pptx LT293 ユーザ視点から見た種々の評定インポート方法龍谷大学 Grade Import Techniques for Moodle 2.4 樋口三郎 ( 龍谷大学 ) http://hig3.net Saburo Higuchi (Ryukoku University) 評定インポートとは MoodleMoot Japan 2013-03-02 評定インポート ( 樋口 ) 2 インポートされる典型的データ

どんな発表? 他のシステム内の学習履歴 ( 評点 + フィードバック ) 他の LMS Excel 成績表 やりたいこと Moodle オフライン課題や Gradebook に自動的に集約 やりたくないこと Moodle プラグイン開発 Moodle ソース改変 Moodle Mood

どんな発表? 他のシステム内の学習履歴 ( 評点 + フィードバック ) 他の LMS Excel 成績表やりたいこと Moodle オフライン課題や Gradebook に自動的に集約やりたくないこと Moodle プラグイン開発 Moodle ソース改変 Moodle Mood