初めまして。Moodleのモジュール開発に勤しんでいる大学生です。宜しくお願いします。
自作のモジュールにおける学生の評価を、コースの評定に加えたいのですが、方法が分かりません。小テストのモジュールを解析して調べようと思ったのですが、私にはハードルが高すぎました。データベースのグレード関連にレコードを追加するだけかと思うのですが、ヒントをお持ちの方がおりましたら御指南頂けますでしょうか？宜しくお願いします。
自作モジュールの評価をコースの評定に
返信数: 9Re: 自作モジュールの評価をコースの評定に
Re: 自作モジュールの評価をコースの評定に
ありがとうございます。英語は弱いのですが、頑張ってみます。
Re: 自作モジュールの評価をコースの評定に
池田です。
バージョン1.9での評点機能との連携ですが、
mod/(モジュール名)/lib.php に
関数: (モジュール名)_grade_item_update
を用意して、grade_update (in lib/gradelib.php) 関数に渡すパラメタを
セットして、grade_update 関数を呼び出すようにしています。
これを、関数: (モジュール名)_add_instanceから呼び出すと、
モジュール追加時に、評点のデータベースも更新されると思います。
評点のデータ格納は、同じくmod/(モジュール名)/lib.php に
関数: (モジュール名)_update_grades
を用意して、モジュール単独の点数のデータベーステーブルに評点を格納するとともに、
(モジュール名)_grade_item_updateを呼び出して、
全体の評点のデータベースも更新しているようにわたしどもは作っています。
そのほか、(モジュール名)_grade_item_deleteで、モジュール削除時の処理などを
加えています。
時間がとれたら、きちんとドキュメントにしたいと思っていますが、取り急ぎ。
バージョン1.9での評点機能との連携ですが、
mod/(モジュール名)/lib.php に
関数: (モジュール名)_grade_item_update
を用意して、grade_update (in lib/gradelib.php) 関数に渡すパラメタを
セットして、grade_update 関数を呼び出すようにしています。
これを、関数: (モジュール名)_add_instanceから呼び出すと、
モジュール追加時に、評点のデータベースも更新されると思います。
評点のデータ格納は、同じくmod/(モジュール名)/lib.php に
関数: (モジュール名)_update_grades
を用意して、モジュール単独の点数のデータベーステーブルに評点を格納するとともに、
(モジュール名)_grade_item_updateを呼び出して、
全体の評点のデータベースも更新しているようにわたしどもは作っています。
そのほか、(モジュール名)_grade_item_deleteで、モジュール削除時の処理などを
加えています。
時間がとれたら、きちんとドキュメントにしたいと思っていますが、取り急ぎ。
Re: 自作モジュールの評価をコースの評定に
有り難う御座います。うまくいきましたら、ご報告させて頂きます。
Re: 自作モジュールの評価をコースの評定に
＞mod/(モジュール名)/lib.php に
＞関数: (モジュール名)_grade_item_update
＞を用意して、grade_update (in lib/gradelib.php) 関数に渡すパラメタを
＞セットして、grade_update 関数を呼び出すようにしています。
＞これを、関数: (モジュール名)_add_instanceから呼び出すと、
＞モジュール追加時に、評点のデータベースも更新されると思います。
ここまでは上手くいったのですが、データベースは mdl_grade_grades でしょうか、
評点を登録するAPIが分かりません。直接いじってしまうのは、仕様上
まずいのではないかと思うのですが、APIは存在するのでしょうか？
grade_update 等を含め、こういった様々なAPIを一覧化しているようなドキュメントは
存在するのでしょうか？現存するドキュメントでは分からない部分が多いのですが、
私の力不足でしょうか。。。
宜しくお願いします。
Re: 自作モジュールの評価をコースの評定に
池田です。
途中まで上手くいったようで、良かったです。
「APIを一覧化しているようなドキュメント」は、
ないのなら、このmoodle.orgのjapaneseコースの中で、
wikiモジュールを使って作り上げていけると良いですね。
さて、「評点を登録するAPI」ですが、
課題モジュールの評点の部分がシンプルなので参考になると思います。
参考ファイル名: mod/assignment/lib.php
参考になる関数: assignment_get_user_gradesや、assignment_update_grades、
assignment_grade_item_update
評点の登録の「データベース」は、
課題モジュールの場合「mdl_assignment_submissions」です。
課題モジュールの評点は、
テーブル「mdl_assignment_submissions」にまず格納されるように設計されています。
一旦「mdl_assignment_submissions」テーブルに点数を格納して、
その後そこから関数「assignment_get_user_grades」を利用して取り出した値を、
関数「assignment_grade_item_update」を使って、moodleの評点に流し込んでいると思います。
途中まで上手くいったようで、良かったです。
「APIを一覧化しているようなドキュメント」は、
ないのなら、このmoodle.orgのjapaneseコースの中で、
wikiモジュールを使って作り上げていけると良いですね。
さて、「評点を登録するAPI」ですが、
課題モジュールの評点の部分がシンプルなので参考になると思います。
参考ファイル名: mod/assignment/lib.php
参考になる関数: assignment_get_user_gradesや、assignment_update_grades、
assignment_grade_item_update
評点の登録の「データベース」は、
課題モジュールの場合「mdl_assignment_submissions」です。
課題モジュールの評点は、
テーブル「mdl_assignment_submissions」にまず格納されるように設計されています。
一旦「mdl_assignment_submissions」テーブルに点数を格納して、
その後そこから関数「assignment_get_user_grades」を利用して取り出した値を、
関数「assignment_grade_item_update」を使って、moodleの評点に流し込んでいると思います。
Re: 自作モジュールの評価をコースの評定に
度々のご指導有り難う御座います。色々と試行錯誤しているのですが、どうもうまくいきません。
＞関数「assignment_grade_item_update」を使って、moodleの評点に流し込んでいると思います。
このモジュールの assignment_grade_item_update 関数においては、grade_items にレコードを登録する以外に機能が存在するようには理解できないのですが、評点にレコードを追加する部分というのは、どの辺りが該当するのでしょうか？
すぐ上の関数、assignment_update_grades において、モジュール個々の評点ＤＢから評点を読み込んできて… $assignment に登録を… 辺りが関係しているのでしょうか？
うまく解読が出来ません。スキル不足で恐縮です。ヒントを頂けますでしょうか？宜しくお願いいたします。
Re: 自作モジュールの評価をコースの評定に
うまく説明できず恐縮です。池田です。
assignmentモジュールを例にしますと、
function assignment_grade_item_update($assignment, $grades)
の中で最後に呼び出されている
grade_update('mod/assignment', $assignment->courseid, 'mod', 'assignment', $assignment->id, 0, $grades, $params)
が、評点機能のAPIです。$gradesがNULLでなければ、
つまり、$gradesにモジュール個々の評点ＤＢから読み込んできた評点が入っていれば、
mdl_grade_gradesテーブルにその評点が記録される仕組みとなっています。おそらく。
そして、$gradesがNULLの場合は、ご指摘のとおり、mdl_grade_itemsテーブルにレコードを
登録する仕組みですね。
assignmentモジュールを例にしますと、
function assignment_grade_item_update($assignment, $grades)
の中で最後に呼び出されている
grade_update('mod/assignment', $assignment->courseid, 'mod', 'assignment', $assignment->id, 0, $grades, $params)
が、評点機能のAPIです。$gradesがNULLでなければ、
つまり、$gradesにモジュール個々の評点ＤＢから読み込んできた評点が入っていれば、
mdl_grade_gradesテーブルにその評点が記録される仕組みとなっています。おそらく。
そして、$gradesがNULLの場合は、ご指摘のとおり、mdl_grade_itemsテーブルにレコードを
登録する仕組みですね。
Re: 自作モジュールの評価をコースの評定に
出来ました！
度々のご指導、本当に有り難う御座いました。心から感謝しております。
まだ、$grades=NULL の場合と $grades に評点が入ってる場合で、自動的に場合分けをして実行する辺りが上手くいってませんが、何とか頑張ってみます。
***_add_instance($***) の中で ***_grade_item_update($***) を呼び出す場合に渡される $*** と、自作モジュール内から ***_grade_item_update($***) を呼び出す場合では、$***->id が異なるようで、新たな評点枠が作られてしまいまして…； また、前者については、評定の各モジュールの題名からモジュールへリンクが貼られているような形になっていますが、そのリンクが貼られず…だったりと、細かいバグ（ミス）が多々発生しています；
今のところは、$grades=NULL を使用せずに、直接評点を書き込む形にしています。評点枠を予め作っておかなくても、正常に枠が生成されるようで、また上記のリンクも貼られています。
まだまだ勉強が必要のようです。重ね重ね、有り難う御座いました。