See Release Notes
Long Term Support Release
<?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>.> namespace core_grades; /** > * Unit tests for grade/import/lib.php. > use grade_item; * >< * Unit tests for grade/import/lib.php.> * Tests grade_import_lib functions.< * @category phpunit> * @category test* @copyright 2015 Adrian Greeve <adrian@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU Public License */< < defined('MOODLE_INTERNAL') || die(); < < global $CFG; < require_once($CFG->dirroot . '/grade/import/lib.php');> class importlib_test extends \advanced_testcase {/**< * Tests grade_import_lib functions.> * Load required test libraries*/< class core_grade_import_lib_test extends advanced_testcase {> public static function setUpBeforeClass(): void { > global $CFG; > require_once("{$CFG->dirroot}/grade/import/lib.php"); > }/** * Import grades into 'grade_import_values' table. This is done differently in the various import plugins, * so there is no direct API to call. * * @param array $data Information to be inserted into the table. * @return int The insert ID of the sql statement. */ private function import_grades($data) { global $DB, $USER;< $graderecord = new stdClass();> $graderecord = new \stdClass();$graderecord->importcode = $data['importcode']; if (isset($data['itemid'])) { $graderecord->itemid = $data['itemid']; } $graderecord->userid = $data['userid']; if (isset($data['importer'])) { $graderecord->importer = $data['importer']; } else { $graderecord->importer = $USER->id; } if (isset($data['finalgrade'])) { $graderecord->finalgrade = $data['finalgrade']; } else { $graderecord->finalgrade = rand(0, 100); } if (isset($data['feedback'])) { $graderecord->feedback = $data['feedback']; } if (isset($data['importonlyfeedback'])) { $graderecord->importonlyfeedback = $data['importonlyfeedback']; } else { $graderecord->importonlyfeedback = false; } if (isset($data['newgradeitem'])) { $graderecord->newgradeitem = $data['newgradeitem']; } return $DB->insert_record('grade_import_values', $graderecord); } /** * Tests for importing grades from an external source.> * */ > * @covers ::grade_import_commitpublic function test_grade_import_commit() { global $USER, $DB, $CFG; $this->resetAfterTest(); $importcode = get_new_importcode(); $user1 = $this->getDataGenerator()->create_user(); $user2 = $this->getDataGenerator()->create_user(); $course = $this->getDataGenerator()->create_course(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); $itemname = $assign->name;< $modulecontext = context_module::instance($assign->cmid);> $modulecontext = \context_module::instance($assign->cmid);// The generator returns a dummy object, lets get the real assign object.< $assign = new assign($modulecontext, false, false);> $assign = new \assign($modulecontext, false, false);$cm = $assign->get_course_module(); // Enrol users in the course. $this->getDataGenerator()->enrol_user($user1->id, $course->id); $this->getDataGenerator()->enrol_user($user2->id, $course->id); // Enter a new grade into an existing grade item.< $gradeitem = grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));> $gradeitem = \grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));// Keep this value around for a test further down. $originalgrade = 55; $this->import_grades(array( 'importcode' => $importcode, 'itemid' => $gradeitem->id, 'userid' => $user1->id, 'finalgrade' => $originalgrade )); $status = grade_import_commit($course->id, $importcode, false, false); $this->assertTrue($status); // Get imported grade_grade.< $gradegrade = grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));> $gradegrade = \grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));$this->assertEquals($originalgrade, $gradegrade->finalgrade); // Overriden field will be a timestamp and will evaluate out to true. $this->assertTrue($gradegrade->is_overridden()); // Create a new grade item and import into that. $importcode = get_new_importcode();< $record = new stdClass();> $record = new \stdClass();$record->itemname = 'New grade item'; $record->importcode = $importcode; $record->importer = $USER->id; $insertid = $DB->insert_record('grade_import_newitem', $record); $finalgrade = 75; $this->import_grades(array( 'importcode' => $importcode, 'userid' => $user1->id, 'finalgrade' => $finalgrade, 'newgradeitem' => $insertid )); $status = grade_import_commit($course->id, $importcode, false, false); $this->assertTrue($status);< // Check that we have a new grade_item. < $gradeitem = grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'manual'));> // Check that we have a new \grade_item. > $gradeitem = \grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'manual'));$this->assertEquals($record->itemname, $gradeitem->itemname); // Grades were imported.< $gradegrade = grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));> $gradegrade = \grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));$this->assertEquals($finalgrade, $gradegrade->finalgrade); // As this is a new item the grade has not been overridden. $this->assertFalse($gradegrade->is_overridden()); // Import feedback only. $importcode = get_new_importcode();< $gradeitem = grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));> $gradeitem = \grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));$originalfeedback = 'feedback can be useful'; $this->import_grades(array( 'importcode' => $importcode, 'userid' => $user1->id, 'itemid' => $gradeitem->id, 'feedback' => $originalfeedback, 'importonlyfeedback' => true )); $status = grade_import_commit($course->id, $importcode, true, false); $this->assertTrue($status);< $gradegrade = grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));> $gradegrade = \grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));// The final grade should be the same as the first record further up. We are only altering the feedback. $this->assertEquals($originalgrade, $gradegrade->finalgrade); $this->assertTrue($gradegrade->is_overridden()); // Import grades only. $importcode = get_new_importcode();< $gradeitem = grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));> $gradeitem = \grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));$finalgrade = 60; $this->import_grades(array( 'importcode' => $importcode, 'userid' => $user1->id, 'itemid' => $gradeitem->id, 'finalgrade' => $finalgrade, 'feedback' => 'feedback can still be useful' )); $status = grade_import_commit($course->id, $importcode, false, false); $this->assertTrue($status);< $gradegrade = grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));> $gradegrade = \grade_grade::fetch(array('itemid' => $gradeitem->id, 'userid' => $user1->id));$this->assertEquals($finalgrade, $gradegrade->finalgrade); // The final feedback should not have changed. $this->assertEquals($originalfeedback, $gradegrade->feedback); $this->assertTrue($gradegrade->is_overridden()); // Check that printing of import status is correct. $importcode = get_new_importcode();< $gradeitem = grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));> $gradeitem = \grade_item::fetch(array('courseid' => $course->id, 'itemtype' => 'mod'));$this->import_grades(array( 'importcode' => $importcode, 'userid' => $user1->id, 'itemid' => $gradeitem->id )); ob_start(); $status = grade_import_commit($course->id, $importcode); $output = ob_get_contents(); ob_end_clean(); $this->assertTrue($status);< $this->assertContains("++ Grade import success ++", $output);> $this->assertStringContainsString("++ Grade import success ++", $output); > } > > /** > * Test grade import commit for users who aren't enrolled on the target course > * > * @covers ::grade_import_commit > */ > public function test_grade_import_commit_unenrolled_user(): void { > $this->resetAfterTest(); > > $course = $this->getDataGenerator()->create_course(); > $assign = $this->getDataGenerator()->create_module('assign', ['course' => $course->id]); > $user = $this->getDataGenerator()->create_user(['firstname' => 'Lionel', 'lastname' => 'Doe']); > > // Enter a new grade into an existing grade item. > $gradeitem = grade_item::fetch(['courseid' => $course->id, 'itemtype' => 'mod']); > > $importcode = get_new_importcode(); > $this->import_grades([ > 'importcode' => $importcode, > 'itemid' => $gradeitem->id, > 'userid' => $user->id, > 'finalgrade' => 10, > ]); > > ob_start(); > $status = grade_import_commit($course->id, $importcode); > $output = ob_get_contents(); > ob_end_clean(); > > // Assert commit succeeded and we didn't receive debugging about lack of name fields. > $this->assertTrue($status); > $this->assertStringContainsString('This import included the following grades for users not currently' . > ' enrolled in this course', $output); > $this->assertStringContainsString('User ' . fullname($user), $output); > $this->assertDebuggingNotCalled(); > } > > /** > * Test retrieving users included in impoty who aren't enrolled on the target course > * > * @covers ::get_unenrolled_users_in_import > */ > public function test_get_unenrolled_users_in_import(): void { > $this->resetAfterTest(); > > $course = $this->getDataGenerator()->create_course(); > $assign = $this->getDataGenerator()->create_module('assign', ['course' => $course->id, 'idnumber' => 'gid101']); > $user = $this->getDataGenerator()->create_user(['idnumber' => 'uid101']); > > // Enter a new grade into an existing grade item. > $gradeitem = grade_item::fetch(['courseid' => $course->id, 'itemtype' => 'mod']); > > $importcode = get_new_importcode(); > $importgradeid = $this->import_grades([ > 'importcode' => $importcode, > 'itemid' => $gradeitem->id, > 'userid' => $user->id, > 'finalgrade' => 10, > ]); > > $unenrolledusers = get_unenrolled_users_in_import($importcode, $course->id); > $this->assertCount(1, $unenrolledusers); > > $unenrolleduser = reset($unenrolledusers); > $this->assertEquals((object) [ > 'id' => $importgradeid, > 'firstnamephonetic' => $user->firstnamephonetic, > 'lastnamephonetic' => $user->lastnamephonetic, > 'middlename' => $user->middlename, > 'alternatename' => $user->alternatename, > 'firstname' => $user->firstname, > 'lastname' => $user->lastname, > 'useridnumber' => 'uid101', > 'gradeidnumber' => 'gid101', > ], $unenrolleduser);} }