Merge branch 'wip-MDL-46547-master' of git://github.com/abgreeve/moodle
This commit is contained in:
Dan Poltawski
@@ -0,0 +1,608 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* A class for loading and preparing grade data from import.
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
/**
|
||||
* A class for loading and preparing grade data from import.
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
class gradeimport_csv_load_data {
|
||||
|
||||
/** @var string $error csv import error. */
|
||||
protected $error;
|
||||
/** @var int $iid Unique identifier for these csv records. */
|
||||
protected $iid;
|
||||
/** @var array $headers Column names for the data. */
|
||||
protected $headers;
|
||||
/** @var array $previewdata A subsection of the csv imported data. */
|
||||
protected $previewdata;
|
||||
|
||||
// The map_user_data_with_value variables.
|
||||
/** @var array $newgrades Grades to be inserted into the gradebook. */
|
||||
protected $newgrades;
|
||||
/** @var array $newfeedbacks Feedback to be inserted into the gradebook. */
|
||||
protected $newfeedbacks;
|
||||
/** @var int $studentid Student ID*/
|
||||
protected $studentid;
|
||||
|
||||
// The prepare_import_grade_data() variables.
|
||||
/** @var bool $status The current status of the import. True = okay, False = errors. */
|
||||
protected $status;
|
||||
/** @var int $importcode The code for this batch insert. */
|
||||
protected $importcode;
|
||||
/** @var array $gradebookerrors An array of errors from trying to import into the gradebook. */
|
||||
protected $gradebookerrors;
|
||||
/** @var array $newgradeitems An array of new grade items to be inserted into the gradebook. */
|
||||
protected $newgradeitems;
|
||||
|
||||
/**
|
||||
* Load CSV content for previewing.
|
||||
*
|
||||
* @param string $text The grade data being imported.
|
||||
* @param string $encoding The type of encoding the file uses.
|
||||
* @param string $separator The separator being used to define each field.
|
||||
* @param int $previewrows How many rows are being previewed.
|
||||
*/
|
||||
public function load_csv_content($text, $encoding, $separator, $previewrows) {
|
||||
$this->raise_limits();
|
||||
|
||||
$this->iid = csv_import_reader::get_new_iid('grade');
|
||||
$csvimport = new csv_import_reader($this->iid, 'grade');
|
||||
|
||||
$csvimport->load_csv_content($text, $encoding, $separator);
|
||||
$this->error = $csvimport->get_error();
|
||||
|
||||
// Get header (field names).
|
||||
$this->headers = $csvimport->get_columns();
|
||||
$this->trim_headers();
|
||||
|
||||
$csvimport->init();
|
||||
$this->previewdata = array();
|
||||
|
||||
for ($numlines = 0; $numlines <= $previewrows; $numlines++) {
|
||||
$lines = $csvimport->next();
|
||||
if ($lines) {
|
||||
$this->previewdata[] = $lines;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets all of the grade items in this course.
|
||||
*
|
||||
* @param int $courseid Course id;
|
||||
* @return array An array of grade items for the course.
|
||||
*/
|
||||
public static function fetch_grade_items($courseid) {
|
||||
$gradeitems = null;
|
||||
if ($allgradeitems = grade_item::fetch_all(array('courseid' => $courseid))) {
|
||||
foreach ($allgradeitems as $gradeitem) {
|
||||
// Skip course type and category type.
|
||||
if ($gradeitem->itemtype == 'course' || $gradeitem->itemtype == 'category') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$displaystring = null;
|
||||
if (!empty($gradeitem->itemmodule)) {
|
||||
$displaystring = get_string('modulename', $gradeitem->itemmodule).get_string('labelsep', 'langconfig')
|
||||
.$gradeitem->get_name();
|
||||
} else {
|
||||
$displaystring = $gradeitem->get_name();
|
||||
}
|
||||
$gradeitems[$gradeitem->id] = $displaystring;
|
||||
}
|
||||
}
|
||||
return $gradeitems;
|
||||
}
|
||||
|
||||
/**
|
||||
* Cleans the column headers from the CSV file.
|
||||
*/
|
||||
protected function trim_headers() {
|
||||
foreach ($this->headers as $i => $h) {
|
||||
$h = trim($h); // Remove whitespace.
|
||||
$h = clean_param($h, PARAM_RAW); // Clean the header.
|
||||
$this->headers[$i] = $h;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Raises the php execution time and memory limits for importing the CSV file.
|
||||
*/
|
||||
protected function raise_limits() {
|
||||
// Large files are likely to take their time and memory. Let PHP know
|
||||
// that we'll take longer, and that the process should be recycled soon
|
||||
// to free up memory.
|
||||
core_php_time_limit::raise();
|
||||
raise_memory_limit(MEMORY_EXTRA);
|
||||
}
|
||||
|
||||
/**
|
||||
* Inserts a record into the grade_import_values table. This also adds common record information.
|
||||
*
|
||||
* @param object $record The grade record being inserted into the database.
|
||||
* @param int $studentid The student ID.
|
||||
* @return bool|int true or insert id on success. Null if the grade value is too high.
|
||||
*/
|
||||
protected function insert_grade_record($record, $studentid) {
|
||||
global $DB, $USER, $CFG;
|
||||
$record->importcode = $this->importcode;
|
||||
$record->userid = $studentid;
|
||||
$record->importer = $USER->id;
|
||||
// By default the maximum grade is 100.
|
||||
$gradepointmaximum = 100;
|
||||
// If the grade limit has been increased then use the gradepointmax setting.
|
||||
if ($CFG->unlimitedgrades) {
|
||||
$gradepointmaximum = $CFG->gradepointmax;
|
||||
}
|
||||
// If the record final grade is set then check that the grade value isn't too high.
|
||||
// Final grade will not be set if we are inserting feedback.
|
||||
if (!isset($record->finalgrade) || $record->finalgrade <= $gradepointmaximum) {
|
||||
return $DB->insert_record('grade_import_values', $record);
|
||||
} else {
|
||||
$this->cleanup_import(get_string('gradevaluetoobig', 'grades', $gradepointmaximum));
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Insert the new grade into the grade item buffer table.
|
||||
*
|
||||
* @param array $header The column headers from the CSV file.
|
||||
* @param int $key Current row identifier.
|
||||
* @param string $value The value for this row (final grade).
|
||||
* @return array new grades that are ready for commiting to the gradebook.
|
||||
*/
|
||||
protected function import_new_grade_item($header, $key, $value) {
|
||||
global $DB, $USER;
|
||||
|
||||
// First check if header is already in temp database.
|
||||
if (empty($this->newgradeitems[$key])) {
|
||||
|
||||
$newgradeitem = new stdClass();
|
||||
$newgradeitem->itemname = $header[$key];
|
||||
$newgradeitem->importcode = $this->importcode;
|
||||
$newgradeitem->importer = $USER->id;
|
||||
|
||||
// Insert into new grade item buffer.
|
||||
$this->newgradeitems[$key] = $DB->insert_record('grade_import_newitem', $newgradeitem);
|
||||
}
|
||||
$newgrade = new stdClass();
|
||||
$newgrade->newgradeitem = $this->newgradeitems[$key];
|
||||
|
||||
// If the user has a grade for this grade item.
|
||||
if (trim($value) != '-') {
|
||||
// Instead of omitting the grade we could insert one with finalgrade set to 0.
|
||||
// We do not have access to grade item min grade.
|
||||
$newgrade->finalgrade = $value;
|
||||
$newgrades[] = $newgrade;
|
||||
}
|
||||
return $newgrades;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check that the user is in the system.
|
||||
*
|
||||
* @param string $value The value, from the csv file, being mapped to identify the user.
|
||||
* @param array $userfields Contains the field and label being mapped from.
|
||||
* @return int Returns the user ID if it exists, otherwise null.
|
||||
*/
|
||||
protected function check_user_exists($value, $userfields) {
|
||||
global $DB;
|
||||
|
||||
$usercheckproblem = false;
|
||||
$user = null;
|
||||
// The user may use the incorrect field to match the user. This could result in an exception.
|
||||
try {
|
||||
$user = $DB->get_record('user', array($userfields['field'] => $value));
|
||||
} catch (Exception $e) {
|
||||
$usercheckproblem = true;
|
||||
}
|
||||
// Field may be fine, but no records were returned.
|
||||
if (!$user || $usercheckproblem) {
|
||||
$usermappingerrorobj = new stdClass();
|
||||
$usermappingerrorobj->field = $userfields['label'];
|
||||
$usermappingerrorobj->value = $value;
|
||||
$this->cleanup_import(get_string('usermappingerror', 'grades', $usermappingerrorobj));
|
||||
unset($usermappingerrorobj);
|
||||
return null;
|
||||
}
|
||||
return $user->id;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the feedback matches a grade item.
|
||||
*
|
||||
* @param int $courseid The course ID.
|
||||
* @param int $itemid The ID of the grade item that the feedback relates to.
|
||||
* @param string $value The actual feedback being imported.
|
||||
* @return object Creates a feedback object with the item ID and the feedback value.
|
||||
*/
|
||||
protected function create_feedback($courseid, $itemid, $value) {
|
||||
// Case of an id, only maps id of a grade_item.
|
||||
// This was idnumber.
|
||||
if (!new grade_item(array('id' => $itemid, 'courseid' => $courseid))) {
|
||||
// Supplied bad mapping, should not be possible since user
|
||||
// had to pick mapping.
|
||||
$this->cleanup_import(get_string('importfailed', 'grades'));
|
||||
return null;
|
||||
}
|
||||
|
||||
// The itemid is the id of the grade item.
|
||||
$feedback = new stdClass();
|
||||
$feedback->itemid = $itemid;
|
||||
$feedback->feedback = $value;
|
||||
return $feedback;
|
||||
}
|
||||
|
||||
/**
|
||||
* This updates existing grade items.
|
||||
*
|
||||
* @param int $courseid The course ID.
|
||||
* @param array $map Mapping information provided by the user.
|
||||
* @param int $key The line that we are currently working on.
|
||||
* @param bool $verbosescales Form setting for grading with scales.
|
||||
* @param string $value The grade value .
|
||||
* @return array grades to be updated.
|
||||
*/
|
||||
protected function update_grade_item($courseid, $map, $key, $verbosescales, $value) {
|
||||
// Case of an id, only maps id of a grade_item.
|
||||
// This was idnumber.
|
||||
if (!$gradeitem = new grade_item(array('id' => $map[$key], 'courseid' => $courseid))) {
|
||||
// Supplied bad mapping, should not be possible since user
|
||||
// had to pick mapping.
|
||||
$this->cleanup_import(get_string('importfailed', 'grades'));
|
||||
return null;
|
||||
}
|
||||
|
||||
// Check if grade item is locked if so, abort.
|
||||
if ($gradeitem->is_locked()) {
|
||||
$this->cleanup_import(get_string('gradeitemlocked', 'grades'));
|
||||
return null;
|
||||
}
|
||||
|
||||
$newgrade = new stdClass();
|
||||
$newgrade->itemid = $gradeitem->id;
|
||||
if ($gradeitem->gradetype == GRADE_TYPE_SCALE and $verbosescales) {
|
||||
if ($value === '' or $value == '-') {
|
||||
$value = null; // No grade.
|
||||
} else {
|
||||
$scale = $gradeitem->load_scale();
|
||||
$scales = explode(',', $scale->scale);
|
||||
$scales = array_map('trim', $scales); // Hack - trim whitespace around scale options.
|
||||
array_unshift($scales, '-'); // Scales start at key 1.
|
||||
$key = array_search($value, $scales);
|
||||
if ($key === false) {
|
||||
$this->cleanup_import(get_string('badgrade', 'grades'));
|
||||
return null;
|
||||
}
|
||||
$value = $key;
|
||||
}
|
||||
$newgrade->finalgrade = $value;
|
||||
} else {
|
||||
if ($value === '' or $value == '-') {
|
||||
$value = null; // No grade.
|
||||
} else {
|
||||
// If the value has a local decimal or can correctly be unformatted, do it.
|
||||
$validvalue = unformat_float($value, true);
|
||||
if ($validvalue !== false) {
|
||||
$value = $validvalue;
|
||||
} else {
|
||||
// Non numeric grade value supplied, possibly mapped wrong column.
|
||||
$this->cleanup_import(get_string('badgrade', 'grades'));
|
||||
return null;
|
||||
}
|
||||
}
|
||||
$newgrade->finalgrade = $value;
|
||||
}
|
||||
$this->newgrades[] = $newgrade;
|
||||
return $this->newgrades;
|
||||
}
|
||||
|
||||
/**
|
||||
* Clean up failed CSV grade import. Clears the temp table for inserting grades.
|
||||
*
|
||||
* @param string $notification The error message to display from the unsuccessful grade import.
|
||||
*/
|
||||
protected function cleanup_import($notification) {
|
||||
$this->status = false;
|
||||
import_cleanup($this->importcode);
|
||||
$this->gradebookerrors[] = $notification;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check user mapping.
|
||||
*
|
||||
* @param string $mappingidentifier The user field that we are matching together.
|
||||
* @param string $value The value we are checking / importing.
|
||||
* @param array $header The column headers of the csv file.
|
||||
* @param array $map Mapping information provided by the user.
|
||||
* @param int $key Current row identifier.
|
||||
* @param int $courseid The course ID.
|
||||
* @param int $feedbackgradeid The ID of the grade item that the feedback relates to.
|
||||
* @param bool $verbosescales Form setting for grading with scales.
|
||||
*/
|
||||
protected function map_user_data_with_value($mappingidentifier, $value, $header, $map, $key, $courseid, $feedbackgradeid,
|
||||
$verbosescales) {
|
||||
|
||||
// Fields that the user can be mapped from.
|
||||
$userfields = array(
|
||||
'userid' => array(
|
||||
'field' => 'id',
|
||||
'label' => 'id',
|
||||
),
|
||||
'useridnumber' => array(
|
||||
'field' => 'idnumber',
|
||||
'label' => 'idnumber',
|
||||
),
|
||||
'useremail' => array(
|
||||
'field' => 'email',
|
||||
'label' => 'email address',
|
||||
),
|
||||
'username' => array(
|
||||
'field' => 'username',
|
||||
'label' => 'username',
|
||||
),
|
||||
);
|
||||
|
||||
switch ($mappingidentifier) {
|
||||
case 'userid':
|
||||
case 'useridnumber':
|
||||
case 'useremail':
|
||||
case 'username':
|
||||
// Skip invalid row with blank user field.
|
||||
if (!empty($value)) {
|
||||
$this->studentid = $this->check_user_exists($value, $userfields[$mappingidentifier]);
|
||||
}
|
||||
break;
|
||||
case 'new':
|
||||
$this->newgrades = $this->import_new_grade_item($header, $key, $value);
|
||||
break;
|
||||
case 'feedback':
|
||||
if ($feedbackgradeid) {
|
||||
$feedback = $this->create_feedback($courseid, $feedbackgradeid, $value);
|
||||
if (isset($feedback)) {
|
||||
$this->newfeedbacks[] = $feedback;
|
||||
}
|
||||
}
|
||||
break;
|
||||
default:
|
||||
// Existing grade items.
|
||||
if (!empty($map[$key])) {
|
||||
$this->newgrades = $this->update_grade_item($courseid, $map, $key, $verbosescales, $value,
|
||||
$mappingidentifier);
|
||||
}
|
||||
// Otherwise, we ignore this column altogether because user has chosen
|
||||
// to ignore them (e.g. institution, address etc).
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks and prepares grade data for inserting into the gradebook.
|
||||
*
|
||||
* @param array $header Column headers of the CSV file.
|
||||
* @param object $formdata Mapping information from the preview page.
|
||||
* @param object $csvimport csv import reader object for iterating over the imported CSV file.
|
||||
* @param int $courseid The course ID.
|
||||
* @param bool $separatemode If we have groups are they separate?
|
||||
* @param mixed $currentgroup current group information.
|
||||
* @param bool $verbosescales Form setting for grading with scales.
|
||||
* @return bool True if the status for importing is okay, false if there are errors.
|
||||
*/
|
||||
public function prepare_import_grade_data($header, $formdata, $csvimport, $courseid, $separatemode, $currentgroup,
|
||||
$verbosescales) {
|
||||
global $DB, $USER;
|
||||
|
||||
// The import code is used for inserting data into the grade tables.
|
||||
$this->importcode = $formdata->importcode;
|
||||
$this->status = true;
|
||||
$this->headers = $header;
|
||||
$this->studentid = null;
|
||||
$this->gradebookerrors = null;
|
||||
// Temporary array to keep track of what new headers are processed.
|
||||
$this->newgradeitems = array();
|
||||
$this->trim_headers();
|
||||
|
||||
$map = array();
|
||||
// Loops mapping_0, mapping_1 .. mapping_n and construct $map array.
|
||||
foreach ($header as $i => $head) {
|
||||
if (isset($formdata->{'mapping_'.$i})) {
|
||||
$map[$i] = $formdata->{'mapping_'.$i};
|
||||
}
|
||||
}
|
||||
|
||||
// If mapping information is supplied.
|
||||
$map[clean_param($formdata->mapfrom, PARAM_RAW)] = clean_param($formdata->mapto, PARAM_RAW);
|
||||
|
||||
// Check for mapto collisions.
|
||||
$maperrors = array();
|
||||
foreach ($map as $i => $j) {
|
||||
if ($j == 0) {
|
||||
// You can have multiple ignores.
|
||||
continue;
|
||||
} else {
|
||||
if (!isset($maperrors[$j])) {
|
||||
$maperrors[$j] = true;
|
||||
} else {
|
||||
// Collision.
|
||||
print_error('cannotmapfield', '', '', $j);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$this->raise_limits();
|
||||
|
||||
$csvimport->init();
|
||||
|
||||
while ($line = $csvimport->next()) {
|
||||
if (count($line) <= 1) {
|
||||
// There is no data on this line, move on.
|
||||
continue;
|
||||
}
|
||||
|
||||
// Array to hold all grades to be inserted.
|
||||
$this->newgrades = array();
|
||||
// Array to hold all feedback.
|
||||
$this->newfeedbacks = array();
|
||||
// Each line is a student record.
|
||||
foreach ($line as $key => $value) {
|
||||
|
||||
$value = clean_param($value, PARAM_RAW);
|
||||
$value = trim($value);
|
||||
|
||||
/*
|
||||
* the options are
|
||||
* 1) userid, useridnumber, usermail, username - used to identify user row
|
||||
* 2) new - new grade item
|
||||
* 3) id - id of the old grade item to map onto
|
||||
* 3) feedback_id - feedback for grade item id
|
||||
*/
|
||||
|
||||
// Explode the mapping for feedback into a label 'feedback' and the identifying number.
|
||||
$mappingbase = explode("_", $map[$key]);
|
||||
$mappingidentifier = $mappingbase[0];
|
||||
// Set the feedback identifier if it exists.
|
||||
if (isset($mappingbase[1])) {
|
||||
$feedbackgradeid = (int)$mappingbase[1];
|
||||
} else {
|
||||
$feedbackgradeid = '';
|
||||
}
|
||||
|
||||
$this->map_user_data_with_value($mappingidentifier, $value, $header, $map, $key, $courseid, $feedbackgradeid,
|
||||
$verbosescales);
|
||||
if ($this->status === false) {
|
||||
return $this->status;
|
||||
}
|
||||
}
|
||||
|
||||
// No user mapping supplied at all, or user mapping failed.
|
||||
if (empty($this->studentid) || !is_numeric($this->studentid)) {
|
||||
// User not found, abort whole import.
|
||||
$this->cleanup_import(get_string('usermappingerrorusernotfound', 'grades'));
|
||||
break;
|
||||
}
|
||||
|
||||
if ($separatemode and !groups_is_member($currentgroup, $this->studentid)) {
|
||||
// Not allowed to import into this group, abort.
|
||||
$this->cleanup_import(get_string('usermappingerrorcurrentgroup', 'grades'));
|
||||
break;
|
||||
}
|
||||
|
||||
// Insert results of this students into buffer.
|
||||
if ($this->status and !empty($this->newgrades)) {
|
||||
|
||||
foreach ($this->newgrades as $newgrade) {
|
||||
|
||||
// Check if grade_grade is locked and if so, abort.
|
||||
if (!empty($newgrade->itemid) and $gradegrade = new grade_grade(array('itemid' => $newgrade->itemid,
|
||||
'userid' => $this->studentid))) {
|
||||
if ($gradegrade->is_locked()) {
|
||||
// Individual grade locked.
|
||||
$this->cleanup_import(get_string('gradelocked', 'grades'));
|
||||
return $this->status;
|
||||
}
|
||||
}
|
||||
$insertid = self::insert_grade_record($newgrade, $this->studentid);
|
||||
// Check to see if the insert was successful.
|
||||
if (empty($insertid)) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Updating/inserting all comments here.
|
||||
if ($this->status and !empty($this->newfeedbacks)) {
|
||||
foreach ($this->newfeedbacks as $newfeedback) {
|
||||
$sql = "SELECT *
|
||||
FROM {grade_import_values}
|
||||
WHERE importcode=? AND userid=? AND itemid=? AND importer=?";
|
||||
if ($feedback = $DB->get_record_sql($sql, array($this->importcode, $this->studentid, $newfeedback->itemid,
|
||||
$USER->id))) {
|
||||
$newfeedback->id = $feedback->id;
|
||||
$DB->update_record('grade_import_values', $newfeedback);
|
||||
|
||||
} else {
|
||||
// The grade item for this is not updated.
|
||||
$insertid = self::insert_grade_record($newfeedback, $this->studentid);
|
||||
// Check to see if the insert was successful.
|
||||
if (empty($insertid)) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return $this->status;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the headers parameter for this class.
|
||||
*
|
||||
* @return array returns headers parameter for this class.
|
||||
*/
|
||||
public function get_headers() {
|
||||
return $this->headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the error parameter for this class.
|
||||
*
|
||||
* @return string returns error parameter for this class.
|
||||
*/
|
||||
public function get_error() {
|
||||
return $this->error;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the iid parameter for this class.
|
||||
*
|
||||
* @return int returns iid parameter for this class.
|
||||
*/
|
||||
public function get_iid() {
|
||||
return $this->iid;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the preview_data parameter for this class.
|
||||
*
|
||||
* @return array returns previewdata parameter for this class.
|
||||
*/
|
||||
public function get_previewdata() {
|
||||
return $this->previewdata;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the gradebookerrors parameter for this class.
|
||||
*
|
||||
* @return array returns gradebookerrors parameter for this class.
|
||||
*/
|
||||
public function get_gradebookerrors() {
|
||||
return $this->gradebookerrors;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,90 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* Renderers for the import of CSV files into the gradebook.
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
/**
|
||||
* Renderers for the import of CSV files into the gradebook.
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
class gradeimport_csv_renderer extends plugin_renderer_base {
|
||||
|
||||
/**
|
||||
* A renderer for the standard upload file form.
|
||||
*
|
||||
* @param object $course The course we are doing all of this action in.
|
||||
* @param object $mform The mform for uploading CSV files.
|
||||
* @return string html to be displayed.
|
||||
*/
|
||||
public function standard_upload_file_form($course, $mform) {
|
||||
|
||||
$output = groups_print_course_menu($course, 'index.php?id=' . $course->id, true);
|
||||
$output .= html_writer::start_tag('div', array('class' => 'clearer'));
|
||||
$output .= html_writer::end_tag('div');
|
||||
|
||||
// Form.
|
||||
ob_start();
|
||||
$mform->display();
|
||||
$output .= ob_get_contents();
|
||||
ob_end_clean();
|
||||
|
||||
return $output;
|
||||
}
|
||||
|
||||
/**
|
||||
* A renderer for the CSV file preview.
|
||||
*
|
||||
* @param array $header Column headers from the CSV file.
|
||||
* @param array $data The rest of the data from the CSV file.
|
||||
* @return string html to be displayed.
|
||||
*/
|
||||
public function import_preview_page($header, $data) {
|
||||
|
||||
$html = $this->output->heading(get_string('importpreview', 'grades'));
|
||||
|
||||
$table = new html_table();
|
||||
$table->head = $header;
|
||||
$table->data = $data;
|
||||
$html .= html_writer::table($table);
|
||||
|
||||
return $html;
|
||||
}
|
||||
|
||||
/**
|
||||
* A renderer for errors generated trying to import the CSV file.
|
||||
*
|
||||
* @param array $errors Display import errors.
|
||||
* @return string errors as html to be displayed.
|
||||
*/
|
||||
public function errors($errors) {
|
||||
$html = '';
|
||||
foreach ($errors as $error) {
|
||||
$html .= $this->output->notification($error);
|
||||
}
|
||||
return $html;
|
||||
}
|
||||
}
|
||||
+42
-370
@@ -22,7 +22,7 @@ require_once($CFG->dirroot. '/grade/import/grade_import_form.php');
|
||||
require_once($CFG->dirroot.'/grade/import/lib.php');
|
||||
require_once($CFG->libdir . '/csvlib.class.php');
|
||||
|
||||
$id = required_param('id', PARAM_INT); // course id
|
||||
$id = required_param('id', PARAM_INT); // Course id.
|
||||
$separator = optional_param('separator', '', PARAM_ALPHA);
|
||||
$verbosescales = optional_param('verbosescales', 1, PARAM_BOOL);
|
||||
$iid = optional_param('iid', null, PARAM_INT);
|
||||
@@ -46,92 +46,41 @@ $context = context_course::instance($id);
|
||||
require_capability('moodle/grade:import', $context);
|
||||
require_capability('gradeimport/csv:view', $context);
|
||||
|
||||
$separatemode = (groups_get_course_groupmode($COURSE) == SEPARATEGROUPS and !has_capability('moodle/site:accessallgroups', $context));
|
||||
$separatemode = (groups_get_course_groupmode($COURSE) == SEPARATEGROUPS and
|
||||
!has_capability('moodle/site:accessallgroups', $context));
|
||||
$currentgroup = groups_get_course_group($course);
|
||||
|
||||
print_grade_page_head($course->id, 'import', 'csv', get_string('importcsv', 'grades'));
|
||||
|
||||
// Set up the grade import mapping form.
|
||||
$gradeitems = array();
|
||||
if ($id) {
|
||||
if ($grade_items = grade_item::fetch_all(array('courseid'=>$id))) {
|
||||
foreach ($grade_items as $grade_item) {
|
||||
// Skip course type and category type.
|
||||
if ($grade_item->itemtype == 'course' || $grade_item->itemtype == 'category') {
|
||||
continue;
|
||||
}
|
||||
$renderer = $PAGE->get_renderer('gradeimport_csv');
|
||||
|
||||
$displaystring = null;
|
||||
if (!empty($grade_item->itemmodule)) {
|
||||
$displaystring = get_string('modulename', $grade_item->itemmodule).get_string('labelsep', 'langconfig')
|
||||
.$grade_item->get_name();
|
||||
} else {
|
||||
$displaystring = $grade_item->get_name();
|
||||
}
|
||||
$gradeitems[$grade_item->id] = $displaystring;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Set up the import form.
|
||||
$mform = new grade_import_form(null, array('includeseparator' => true, 'verbosescales' => true, 'acceptedtypes' =>
|
||||
array('.csv', '.txt')));
|
||||
// Get the grade items to be matched with the import mapping columns.
|
||||
$gradeitems = gradeimport_csv_load_data::fetch_grade_items($course->id);
|
||||
|
||||
// If the csv file hasn't been imported yet then look for a form submission or
|
||||
// show the initial submission form.
|
||||
if (!$iid) {
|
||||
|
||||
// Set up the import form.
|
||||
$mform = new grade_import_form(null, array('includeseparator' => true, 'verbosescales' => $verbosescales, 'acceptedtypes' =>
|
||||
array('.csv', '.txt')));
|
||||
|
||||
// If the import form has been submitted.
|
||||
if ($formdata = $mform->get_data()) {
|
||||
|
||||
// Large files are likely to take their time and memory. Let PHP know
|
||||
// that we'll take longer, and that the process should be recycled soon
|
||||
// to free up memory.
|
||||
core_php_time_limit::raise();
|
||||
raise_memory_limit(MEMORY_EXTRA);
|
||||
|
||||
// Use current (non-conflicting) time stamp.
|
||||
$importcode = get_new_importcode();
|
||||
|
||||
$text = $mform->get_file_content('userfile');
|
||||
$iid = csv_import_reader::get_new_iid('grade');
|
||||
$csvimport = new csv_import_reader($iid, 'grade');
|
||||
|
||||
$csvimport->load_csv_content($text, $formdata->encoding, $separator);
|
||||
|
||||
// --- get header (field names) ---
|
||||
$header = $csvimport->get_columns();
|
||||
|
||||
// Print a preview of the data.
|
||||
$numlines = 0; // 0 lines previewed so far.
|
||||
|
||||
echo $OUTPUT->heading(get_string('importpreview', 'grades'));
|
||||
|
||||
foreach ($header as $i => $h) {
|
||||
$h = trim($h); // Remove whitespace.
|
||||
$h = clean_param($h, PARAM_RAW); // Clean the header.
|
||||
$header[$i] = $h;
|
||||
$csvimport = new gradeimport_csv_load_data();
|
||||
$csvimport->load_csv_content($text, $formdata->encoding, $separator, $formdata->previewrows);
|
||||
$csvimporterror = $csvimport->get_error();
|
||||
if (!empty($csvimporterror)) {
|
||||
echo $renderer->errors(array($csvimport->get_error()));
|
||||
echo $OUTPUT->footer();
|
||||
die();
|
||||
}
|
||||
|
||||
$table = new html_table();
|
||||
$table->head = $header;
|
||||
$csvimport->init();
|
||||
$previewdata = array();
|
||||
while ($numlines <= $formdata->previewrows) {
|
||||
$lines = $csvimport->next();
|
||||
if ($lines) {
|
||||
$previewdata[] = $lines;
|
||||
}
|
||||
$numlines ++;
|
||||
}
|
||||
$table->data = $previewdata;
|
||||
echo html_writer::table($table);
|
||||
$iid = $csvimport->get_iid();
|
||||
echo $renderer->import_preview_page($csvimport->get_headers(), $csvimport->get_previewdata());
|
||||
} else {
|
||||
// Display the standard upload file form.
|
||||
groups_print_course_menu($course, 'index.php?id='.$id);
|
||||
echo html_writer::start_tag('div', array('class' => 'clearer'));
|
||||
echo html_writer::end_tag('div');
|
||||
|
||||
$mform->display();
|
||||
echo $renderer->standard_upload_file_form($course, $mform);
|
||||
echo $OUTPUT->footer();
|
||||
die();
|
||||
}
|
||||
@@ -140,314 +89,37 @@ if (!$iid) {
|
||||
// Data has already been submitted so we can use the $iid to retrieve it.
|
||||
$csvimport = new csv_import_reader($iid, 'grade');
|
||||
$header = $csvimport->get_columns();
|
||||
// Get a new import code for updating to the grade book.
|
||||
if (empty($importcode)) {
|
||||
$importcode = get_new_importcode();
|
||||
}
|
||||
|
||||
$mappingformdata = array(
|
||||
'gradeitems' => $gradeitems,
|
||||
'header' => $header,
|
||||
'iid' => $iid,
|
||||
'id' => $id,
|
||||
'importcode' => $importcode,
|
||||
'verbosescales' => $verbosescales
|
||||
);
|
||||
// we create a form to handle mapping data from the file to the database.
|
||||
$mform2 = new grade_import_mapping_form(null, array('gradeitems'=>$gradeitems, 'header'=>$header));
|
||||
$mform2->set_data(array('iid' => $iid, 'id' => $id, 'importcode'=>$importcode, 'verbosescales' => $verbosescales));
|
||||
$mform2 = new grade_import_mapping_form(null, $mappingformdata);
|
||||
|
||||
// Here, if we have data, we process the fields and enter the information into the database.
|
||||
if ($formdata = $mform2->get_data()) {
|
||||
$gradeimport = new gradeimport_csv_load_data();
|
||||
$status = $gradeimport->prepare_import_grade_data($header, $formdata, $csvimport, $course->id, $separatemode,
|
||||
$currentgroup, $verbosescales);
|
||||
|
||||
foreach ($header as $i => $h) {
|
||||
$h = trim($h); // Remove whitespace.
|
||||
$h = clean_param($h, PARAM_RAW); // Clean the header.
|
||||
$header[$i] = $h;
|
||||
}
|
||||
|
||||
$map = array();
|
||||
// loops mapping_0, mapping_1 .. mapping_n and construct $map array
|
||||
foreach ($header as $i => $head) {
|
||||
if (isset($formdata->{'mapping_'.$i})) {
|
||||
$map[$i] = $formdata->{'mapping_'.$i};
|
||||
}
|
||||
}
|
||||
|
||||
// if mapping information is supplied
|
||||
$map[clean_param($formdata->mapfrom, PARAM_RAW)] = clean_param($formdata->mapto, PARAM_RAW);
|
||||
|
||||
// check for mapto collisions
|
||||
$maperrors = array();
|
||||
foreach ($map as $i => $j) {
|
||||
if ($j == 0) {
|
||||
// you can have multiple ignores
|
||||
continue;
|
||||
} else {
|
||||
if (!isset($maperrors[$j])) {
|
||||
$maperrors[$j] = true;
|
||||
} else {
|
||||
// collision
|
||||
print_error('cannotmapfield', '', '', $j);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Large files are likely to take their time and memory. Let PHP know
|
||||
// that we'll take longer, and that the process should be recycled soon
|
||||
// to free up memory.
|
||||
core_php_time_limit::raise();
|
||||
raise_memory_limit(MEMORY_EXTRA);
|
||||
|
||||
$userfields = array(
|
||||
'userid' => array(
|
||||
'field' => 'id',
|
||||
'label' => 'id',
|
||||
),
|
||||
'useridnumber' => array(
|
||||
'field' => 'idnumber',
|
||||
'label' => 'idnumber',
|
||||
),
|
||||
'useremail' => array(
|
||||
'field' => 'email',
|
||||
'label' => 'email address',
|
||||
),
|
||||
'username' => array(
|
||||
'field' => 'username',
|
||||
'label' => 'username',
|
||||
),
|
||||
);
|
||||
|
||||
$csvimport->init();
|
||||
|
||||
$newgradeitems = array(); // temporary array to keep track of what new headers are processed
|
||||
$status = true;
|
||||
|
||||
while ($line = $csvimport->next()) {
|
||||
if(count($line) <= 1){
|
||||
// there is no data on this line, move on
|
||||
continue;
|
||||
}
|
||||
|
||||
// array to hold all grades to be inserted
|
||||
$newgrades = array();
|
||||
// array to hold all feedback
|
||||
$newfeedbacks = array();
|
||||
// each line is a student record
|
||||
foreach ($line as $key => $value) {
|
||||
|
||||
$value = clean_param($value, PARAM_RAW);
|
||||
$value = trim($value);
|
||||
|
||||
/*
|
||||
* the options are
|
||||
* 1) userid, useridnumber, usermail, username - used to identify user row
|
||||
* 2) new - new grade item
|
||||
* 3) id - id of the old grade item to map onto
|
||||
* 3) feedback_id - feedback for grade item id
|
||||
*/
|
||||
|
||||
$t = explode("_", $map[$key]);
|
||||
$t0 = $t[0];
|
||||
if (isset($t[1])) {
|
||||
$t1 = (int)$t[1];
|
||||
} else {
|
||||
$t1 = '';
|
||||
}
|
||||
|
||||
switch ($t0) {
|
||||
case 'userid':
|
||||
case 'useridnumber':
|
||||
case 'useremail':
|
||||
case 'username':
|
||||
// Skip invalid row with blank user field.
|
||||
if (empty($value)) {
|
||||
continue 3;
|
||||
}
|
||||
|
||||
if (!$user = $DB->get_record('user', array($userfields[$t0]['field'] => $value))) {
|
||||
// User not found, abort whole import.
|
||||
import_cleanup($importcode);
|
||||
$usermappingerrorobj = new stdClass();
|
||||
$usermappingerrorobj->field = $userfields[$t0]['label'];
|
||||
$usermappingerrorobj->value = $value;
|
||||
echo $OUTPUT->notification(get_string('usermappingerror', 'grades', $usermappingerrorobj));
|
||||
unset($usermappingerrorobj);
|
||||
$status = false;
|
||||
break 3;
|
||||
}
|
||||
$studentid = $user->id;
|
||||
break;
|
||||
case 'new':
|
||||
// first check if header is already in temp database
|
||||
|
||||
if (empty($newgradeitems[$key])) {
|
||||
|
||||
$newgradeitem = new stdClass();
|
||||
$newgradeitem->itemname = $header[$key];
|
||||
$newgradeitem->importcode = $importcode;
|
||||
$newgradeitem->importer = $USER->id;
|
||||
|
||||
// insert into new grade item buffer
|
||||
$newgradeitems[$key] = $DB->insert_record('grade_import_newitem', $newgradeitem);
|
||||
}
|
||||
$newgrade = new stdClass();
|
||||
$newgrade->newgradeitem = $newgradeitems[$key];
|
||||
|
||||
// if the user has a grade for this grade item
|
||||
if (trim($value) != '-') {
|
||||
// instead of omitting the grade we could insert one with finalgrade set to 0
|
||||
// we do not have access to grade item min grade
|
||||
$newgrade->finalgrade = $value;
|
||||
$newgrades[] = $newgrade;
|
||||
}
|
||||
break;
|
||||
case 'feedback':
|
||||
if ($t1) {
|
||||
// case of an id, only maps id of a grade_item
|
||||
// this was idnumber
|
||||
if (!$gradeitem = new grade_item(array('id'=>$t1, 'courseid'=>$course->id))) {
|
||||
// supplied bad mapping, should not be possible since user
|
||||
// had to pick mapping
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
// Relying on the default import failed message below.
|
||||
break 3;
|
||||
}
|
||||
|
||||
// t1 is the id of the grade item
|
||||
$feedback = new stdClass();
|
||||
$feedback->itemid = $t1;
|
||||
$feedback->feedback = $value;
|
||||
$newfeedbacks[] = $feedback;
|
||||
}
|
||||
break;
|
||||
default:
|
||||
// existing grade items
|
||||
if (!empty($map[$key])) {
|
||||
// case of an id, only maps id of a grade_item
|
||||
// this was idnumber
|
||||
if (!$gradeitem = new grade_item(array('id'=>$map[$key], 'courseid'=>$course->id))) {
|
||||
// supplied bad mapping, should not be possible since user
|
||||
// had to pick mapping
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
// Relying on the default import failed message below.
|
||||
break 3;
|
||||
}
|
||||
|
||||
// check if grade item is locked if so, abort
|
||||
if ($gradeitem->is_locked()) {
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('gradeitemlocked', 'grades'));
|
||||
break 3;
|
||||
}
|
||||
|
||||
$newgrade = new stdClass();
|
||||
$newgrade->itemid = $gradeitem->id;
|
||||
if ($gradeitem->gradetype == GRADE_TYPE_SCALE and $verbosescales) {
|
||||
if ($value === '' or $value == '-') {
|
||||
$value = null; // no grade
|
||||
} else {
|
||||
$scale = $gradeitem->load_scale();
|
||||
$scales = explode(',', $scale->scale);
|
||||
$scales = array_map('trim', $scales); //hack - trim whitespace around scale options
|
||||
array_unshift($scales, '-'); // scales start at key 1
|
||||
$key = array_search($value, $scales);
|
||||
if ($key === false) {
|
||||
echo "<br/>t0 is $t0";
|
||||
echo "<br/>grade is $value";
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('badgrade', 'grades'));
|
||||
break 3;
|
||||
}
|
||||
$value = $key;
|
||||
}
|
||||
$newgrade->finalgrade = $value;
|
||||
} else {
|
||||
if ($value === '' or $value == '-') {
|
||||
$value = null; // No grade.
|
||||
} else {
|
||||
// If the value has a local decimal or can correctly be unformatted, do it.
|
||||
$validvalue = unformat_float($value, true);
|
||||
if ($validvalue !== false) {
|
||||
$value = $validvalue;
|
||||
} else {
|
||||
// Non numeric grade value supplied, possibly mapped wrong column.
|
||||
echo "<br/>t0 is $t0";
|
||||
echo "<br/>grade is $value";
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('badgrade', 'grades'));
|
||||
break 3;
|
||||
}
|
||||
}
|
||||
$newgrade->finalgrade = $value;
|
||||
}
|
||||
$newgrades[] = $newgrade;
|
||||
} // otherwise, we ignore this column altogether
|
||||
// because user has chosen to ignore them (e.g. institution, address etc)
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
// no user mapping supplied at all, or user mapping failed
|
||||
if (empty($studentid) || !is_numeric($studentid)) {
|
||||
// user not found, abort whole import
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('usermappingerrorusernotfound', 'grades'));
|
||||
break;
|
||||
}
|
||||
|
||||
if ($separatemode and !groups_is_member($currentgroup, $studentid)) {
|
||||
// not allowed to import into this group, abort
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('usermappingerrorcurrentgroup', 'grades'));
|
||||
break;
|
||||
}
|
||||
|
||||
// insert results of this students into buffer
|
||||
if ($status and !empty($newgrades)) {
|
||||
|
||||
foreach ($newgrades as $newgrade) {
|
||||
|
||||
// check if grade_grade is locked and if so, abort
|
||||
if (!empty($newgrade->itemid) and $grade_grade = new grade_grade(array('itemid'=>$newgrade->itemid, 'userid'=>$studentid))) {
|
||||
if ($grade_grade->is_locked()) {
|
||||
// individual grade locked
|
||||
$status = false;
|
||||
import_cleanup($importcode);
|
||||
echo $OUTPUT->notification(get_string('gradelocked', 'grades'));
|
||||
break 2;
|
||||
}
|
||||
}
|
||||
|
||||
$newgrade->importcode = $importcode;
|
||||
$newgrade->userid = $studentid;
|
||||
$newgrade->importer = $USER->id;
|
||||
$DB->insert_record('grade_import_values', $newgrade);
|
||||
}
|
||||
}
|
||||
|
||||
// updating/inserting all comments here
|
||||
if ($status and !empty($newfeedbacks)) {
|
||||
foreach ($newfeedbacks as $newfeedback) {
|
||||
$sql = "SELECT *
|
||||
FROM {grade_import_values}
|
||||
WHERE importcode=? AND userid=? AND itemid=? AND importer=?";
|
||||
if ($feedback = $DB->get_record_sql($sql, array($importcode, $studentid, $newfeedback->itemid, $USER->id))) {
|
||||
$newfeedback->id = $feedback->id;
|
||||
$DB->update_record('grade_import_values', $newfeedback);
|
||||
|
||||
} else {
|
||||
// the grade item for this is not updated
|
||||
$newfeedback->importcode = $importcode;
|
||||
$newfeedback->userid = $studentid;
|
||||
$newfeedback->importer = $USER->id;
|
||||
$DB->insert_record('grade_import_values', $newfeedback);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// at this stage if things are all ok, we commit the changes from temp table
|
||||
// At this stage if things are all ok, we commit the changes from temp table.
|
||||
if ($status) {
|
||||
grade_import_commit($course->id, $importcode);
|
||||
} else {
|
||||
echo $OUTPUT->notification(get_string('importfailed', 'grades'));
|
||||
$errors = $gradeimport->get_gradebookerrors();
|
||||
$errors[] = get_string('importfailed', 'grades');
|
||||
echo $renderer->errors($errors);
|
||||
}
|
||||
echo $OUTPUT->footer();
|
||||
} else {
|
||||
// If data hasn't been submitted then display the data mapping form.
|
||||
$mform2->display();
|
||||
|
||||
@@ -0,0 +1,122 @@
|
||||
<?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/>.
|
||||
|
||||
require_once($CFG->dirroot . '/grade/import/csv/classes/load_data.php');
|
||||
require_once($CFG->dirroot . '/grade/import/lib.php');
|
||||
|
||||
/**
|
||||
* Class to open up private methods in gradeimport_csv_load_data().
|
||||
*/
|
||||
class phpunit_gradeimport_csv_load_data extends gradeimport_csv_load_data {
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*
|
||||
* @param object $record
|
||||
* @param int $studentid
|
||||
*/
|
||||
public function test_insert_grade_record($record, $studentid) {
|
||||
$this->importcode = 00001;
|
||||
$this->insert_grade_record($record, $studentid);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*/
|
||||
public function get_importcode() {
|
||||
return $this->importcode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*
|
||||
* @param array $header The column headers from the CSV file.
|
||||
* @param int $key Current row identifier.
|
||||
* @param string $value The value for this row (final grade).
|
||||
* @return array new grades that are ready for commiting to the gradebook.
|
||||
*/
|
||||
public function test_import_new_grade_item($header, $key, $value) {
|
||||
$this->newgradeitems = null;
|
||||
$this->importcode = 00001;
|
||||
return $this->import_new_grade_item($header, $key, $value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*
|
||||
* @param string $value The value, from the csv file, being mapped to identify the user.
|
||||
* @param array $userfields Contains the field and label being mapped from.
|
||||
* @return int Returns the user ID if it exists, otherwise null.
|
||||
*/
|
||||
public function test_check_user_exists($value, $userfields) {
|
||||
return $this->check_user_exists($value, $userfields);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*
|
||||
* @param int $courseid The course ID.
|
||||
* @param int $itemid The ID of the grade item that the feedback relates to.
|
||||
* @param string $value The actual feedback being imported.
|
||||
* @return object Creates a feedback object with the item ID and the feedback value.
|
||||
*/
|
||||
public function test_create_feedback($courseid, $itemid, $value) {
|
||||
return $this->create_feedback($courseid, $itemid, $value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*/
|
||||
public function test_update_grade_item($courseid, $map, $key, $verbosescales, $value) {
|
||||
return $this->update_grade_item($courseid, $map, $key, $verbosescales, $value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to open up the appropriate method for unit testing.
|
||||
*
|
||||
* @param int $courseid The course ID.
|
||||
* @param array $map Mapping information provided by the user.
|
||||
* @param int $key The line that we are currently working on.
|
||||
* @param bool $verbosescales Form setting for grading with scales.
|
||||
* @param string $value The grade value .
|
||||
* @return array grades to be updated.
|
||||
*/
|
||||
public function test_map_user_data_with_value($mappingidentifier, $value, $header, $map, $key, $courseid, $feedbackgradeid,
|
||||
$verbosescales) {
|
||||
// Set an import code.
|
||||
$this->importcode = 00001;
|
||||
$this->map_user_data_with_value($mappingidentifier, $value, $header, $map, $key, $courseid, $feedbackgradeid,
|
||||
$verbosescales);
|
||||
|
||||
switch ($mappingidentifier) {
|
||||
case 'userid':
|
||||
case 'useridnumber':
|
||||
case 'useremail':
|
||||
case 'username':
|
||||
return $this->studentid;
|
||||
break;
|
||||
case 'new':
|
||||
return $this->newgrades;
|
||||
break;
|
||||
case 'feedback':
|
||||
return $this->newfeedbacks;
|
||||
break;
|
||||
default:
|
||||
return $this->newgrades;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,430 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* Unit tests for the class in load_data.php
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @category phpunit
|
||||
* @copyright 2014 Adrian Greeve
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
global $CFG;
|
||||
require_once($CFG->dirroot . '/grade/import/csv/tests/fixtures/phpunit_gradeimport_csv_load_data.php');
|
||||
require_once($CFG->libdir . '/csvlib.class.php');
|
||||
require_once($CFG->libdir . '/grade/grade_item.php');
|
||||
require_once($CFG->libdir . '/grade/tests/fixtures/lib.php');
|
||||
|
||||
/**
|
||||
* Unit tests for lib.php
|
||||
*
|
||||
* @package gradeimport_csv
|
||||
* @copyright 2014 Adrian Greeve
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
class gradeimport_csv_load_data_testcase extends grade_base_testcase {
|
||||
|
||||
/** @var string $oktext Text to be imported. This data should have no issues being imported. */
|
||||
protected $oktext = '"First name",Surname,"ID number",Institution,Department,"Email address","Assignment: Assignment for grape group", "Feedback: Assignment for grape group","Course total"
|
||||
Anne,Able,,"Moodle HQ","Rock on!",[email protected],56.00,"We welcome feedback",56.00
|
||||
Bobby,Bunce,,"Moodle HQ","Rock on!",[email protected],75.00,,75.00';
|
||||
|
||||
/** @var string $badtext Text to be imported. This data has an extra column and should not succeed in being imported. */
|
||||
protected $badtext = '"First name",Surname,"ID number",Institution,Department,"Email address","Assignment: Assignment for grape group","Course total"
|
||||
Anne,Able,,"Moodle HQ","Rock on!",[email protected],56.00,56.00,78.00
|
||||
Bobby,Bunce,,"Moodle HQ","Rock on!",[email protected],75.00,75.00';
|
||||
|
||||
/** @var int $iid Import ID. */
|
||||
protected $iid;
|
||||
|
||||
/** @var object $csvimport a csv_import_reader object that handles the csv import. */
|
||||
protected $csvimport;
|
||||
|
||||
/** @var array $columns The first row of the csv file. These are the columns of the import file.*/
|
||||
protected $columns;
|
||||
|
||||
/**
|
||||
* Load up the above text through the csv import.
|
||||
*
|
||||
* @param string $content Text to be imported into the gradebook.
|
||||
* @return array All text separated by commas now in an array.
|
||||
*/
|
||||
protected function csv_load($content) {
|
||||
// Import the csv strings.
|
||||
$this->iid = csv_import_reader::get_new_iid('grade');
|
||||
$this->csvimport = new csv_import_reader($this->iid, 'grade');
|
||||
|
||||
$this->csvimport->load_csv_content($content, 'utf8', 'comma');
|
||||
$this->columns = $this->csvimport->get_columns();
|
||||
|
||||
$this->csvimport->init();
|
||||
while ($line = $this->csvimport->next()) {
|
||||
$testarray[] = $line;
|
||||
}
|
||||
|
||||
return $testarray;
|
||||
}
|
||||
|
||||
/**
|
||||
* Test loading data and returning preview content.
|
||||
*/
|
||||
public function test_load_csv_content() {
|
||||
$encoding = 'utf8';
|
||||
$separator = 'comma';
|
||||
$previewrows = 5;
|
||||
$csvpreview = new phpunit_gradeimport_csv_load_data();
|
||||
$csvpreview->load_csv_content($this->oktext, $encoding, $separator, $previewrows);
|
||||
|
||||
$expecteddata = array(array(
|
||||
'Anne',
|
||||
'Able',
|
||||
'',
|
||||
'Moodle HQ',
|
||||
'Rock on!',
|
||||
'[email protected]',
|
||||
56.00,
|
||||
'We welcome feedback',
|
||||
56.00
|
||||
),
|
||||
array(
|
||||
'Bobby',
|
||||
'Bunce',
|
||||
'',
|
||||
'Moodle HQ',
|
||||
'Rock on!',
|
||||
'[email protected]',
|
||||
75.00,
|
||||
'',
|
||||
75.00
|
||||
)
|
||||
);
|
||||
|
||||
$expectedheaders = array(
|
||||
'First name',
|
||||
'Surname',
|
||||
'ID number',
|
||||
'Institution',
|
||||
'Department',
|
||||
'Email address',
|
||||
'Assignment: Assignment for grape group',
|
||||
'Feedback: Assignment for grape group',
|
||||
'Course total'
|
||||
);
|
||||
// Check that general data is returned as expected.
|
||||
$this->assertEquals($csvpreview->get_previewdata(), $expecteddata);
|
||||
// Check that headers are returned as expected.
|
||||
$this->assertEquals($csvpreview->get_headers(), $expectedheaders);
|
||||
|
||||
// Check that errors are being recorded.
|
||||
$csvpreview = new phpunit_gradeimport_csv_load_data();
|
||||
$csvpreview->load_csv_content($this->badtext, $encoding, $separator, $previewrows);
|
||||
// Columns shouldn't match.
|
||||
$this->assertEquals($csvpreview->get_error(), get_string('csvweirdcolumns', 'error'));
|
||||
}
|
||||
|
||||
/**
|
||||
* Test fetching grade items for the course.
|
||||
*/
|
||||
public function test_fetch_grade_items() {
|
||||
|
||||
$gradeitemsarray = grade_item::fetch_all(array('courseid' => $this->courseid));
|
||||
$gradeitems = phpunit_gradeimport_csv_load_data::fetch_grade_items($this->courseid);
|
||||
|
||||
// Make sure that each grade item is located in the gradeitemsarray.
|
||||
foreach ($gradeitems as $key => $gradeitem) {
|
||||
$this->assertArrayHasKey($key, $gradeitemsarray);
|
||||
}
|
||||
|
||||
// Get the key for a specific grade item.
|
||||
$quizkey = null;
|
||||
foreach ($gradeitemsarray as $key => $value) {
|
||||
if ($value->itemname == "Quiz grade item") {
|
||||
$quizkey = $key;
|
||||
}
|
||||
}
|
||||
|
||||
// Expected modified item name.
|
||||
$testitemname = get_string('modulename', $gradeitemsarray[$quizkey]->itemmodule) . ': ' .
|
||||
$gradeitemsarray[$quizkey]->itemname;
|
||||
// Check that an item that is a module, is concatenated properly.
|
||||
$this->assertEquals($testitemname, $gradeitems[$quizkey]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test the inserting of grade record data.
|
||||
*/
|
||||
public function test_insert_grade_record() {
|
||||
global $DB, $USER;
|
||||
|
||||
$user = $this->getDataGenerator()->create_user();
|
||||
$this->setAdminUser();
|
||||
|
||||
$record = new stdClass();
|
||||
$record->itemid = 4;
|
||||
$record->newgradeitem = 25;
|
||||
$record->finalgrade = 62.00;
|
||||
$record->feedback = 'Some test feedback';
|
||||
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
$testobject->test_insert_grade_record($record, $user->id);
|
||||
|
||||
$gradeimportvalues = $DB->get_records('grade_import_values');
|
||||
// Get the insert id.
|
||||
$key = key($gradeimportvalues);
|
||||
|
||||
$testarray = array();
|
||||
$testarray[$key] = new stdClass();
|
||||
$testarray[$key]->id = $key;
|
||||
$testarray[$key]->itemid = $record->itemid;
|
||||
$testarray[$key]->newgradeitem = $record->newgradeitem;
|
||||
$testarray[$key]->userid = $user->id;
|
||||
$testarray[$key]->finalgrade = $record->finalgrade;
|
||||
$testarray[$key]->feedback = $record->feedback;
|
||||
$testarray[$key]->importcode = $testobject->get_importcode();
|
||||
$testarray[$key]->importer = $USER->id;
|
||||
|
||||
// Check that the record was inserted into the database.
|
||||
$this->assertEquals($gradeimportvalues, $testarray);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test preparing a new grade item for import into the gradebook.
|
||||
*/
|
||||
public function test_import_new_grade_item() {
|
||||
global $DB;
|
||||
|
||||
$this->setAdminUser();
|
||||
$this->csv_load($this->oktext);
|
||||
$columns = $this->columns;
|
||||
|
||||
// The assignment is item 6.
|
||||
$key = 6;
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
|
||||
// Key for this assessment.
|
||||
$this->csvimport->init();
|
||||
$testarray = array();
|
||||
while ($line = $this->csvimport->next()) {
|
||||
$testarray[] = $testobject->test_import_new_grade_item($columns, $key, $line[$key]);
|
||||
}
|
||||
|
||||
// Query the database and check how many results were inserted.
|
||||
$newgradeimportitems = $DB->get_records('grade_import_newitem');
|
||||
$this->assertEquals(count($testarray), count($newgradeimportitems));
|
||||
}
|
||||
|
||||
/**
|
||||
* Check that the user matches a user in the system.
|
||||
*/
|
||||
public function test_check_user_exists() {
|
||||
|
||||
// Need to add one of the users into the system.
|
||||
$user = new stdClass();
|
||||
$user->firstname = 'Anne';
|
||||
$user->lastname = 'Able';
|
||||
$user->email = '[email protected]';
|
||||
$userdetail = $this->getDataGenerator()->create_user($user);
|
||||
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
|
||||
$testarray = $this->csv_load($this->oktext);
|
||||
|
||||
$userfields = array('field' => 'email', 'label' => 'Email address');
|
||||
// If the user exists then the user id is returned.
|
||||
$userid = $testobject->test_check_user_exists($testarray[0][5] , $userfields);
|
||||
// Check that the user id returned matches with the user that we created.
|
||||
$this->assertEquals($userid, $userdetail->id);
|
||||
|
||||
// Check for failure.
|
||||
// Try for an exception.
|
||||
$userfields = array('field' => 'id', 'label' => 'userid');
|
||||
$userid = $testobject->test_check_user_exists($testarray[0][0], $userfields);
|
||||
// Check that the userid is null.
|
||||
$this->assertNull($userid);
|
||||
|
||||
// Expected error message.
|
||||
$mappingobject = new stdClass();
|
||||
$mappingobject->field = $userfields['label'];
|
||||
$mappingobject->value = $testarray[0][0];
|
||||
$expectederrormessage = get_string('usermappingerror', 'grades', $mappingobject);
|
||||
// Check that expected error message and actual message match.
|
||||
$gradebookerrors = $testobject->get_gradebookerrors();
|
||||
$this->assertEquals($expectederrormessage, $gradebookerrors[0]);
|
||||
|
||||
// The field mapping is correct, but the student does not exist.
|
||||
$userid = $testobject->test_check_user_exists($testarray[1][5], $userfields);
|
||||
// Check that the userid is null.
|
||||
$this->assertNull($userid);
|
||||
|
||||
// Expected error message.
|
||||
$mappingobject = new stdClass();
|
||||
$mappingobject->field = $userfields['label'];
|
||||
$mappingobject->value = $testarray[1][5];
|
||||
$expectederrormessage = get_string('usermappingerror', 'grades', $mappingobject);
|
||||
// Check that expected error message and actual message match.
|
||||
$gradebookerrors = $testobject->get_gradebookerrors();
|
||||
// This is the second error in the array of gradebook errors.
|
||||
$this->assertEquals($expectederrormessage, $gradebookerrors[1]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test preparing feedback for inserting / updating into the gradebook.
|
||||
*/
|
||||
public function test_create_feedback() {
|
||||
|
||||
$testarray = $this->csv_load($this->oktext);
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
|
||||
// Try to insert some feedback for an assessment.
|
||||
$feedback = $testobject->test_create_feedback($this->courseid, 1, $testarray[0][7]);
|
||||
|
||||
// Expected result.
|
||||
$expectedfeedback = array('itemid' => 1, 'feedback' => $testarray[0][7]);
|
||||
$this->assertEquals((array)$feedback, $expectedfeedback);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test preparing grade_items for upgrading into the gradebook.
|
||||
*/
|
||||
public function test_update_grade_item() {
|
||||
|
||||
$testarray = $this->csv_load($this->oktext);
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
|
||||
// We're not using scales so no to this option.
|
||||
$verbosescales = 0;
|
||||
// Map and key are to retrieve the grade_item that we are updating.
|
||||
$map = array(1);
|
||||
$key = 0;
|
||||
// We return the new grade array for saving.
|
||||
$newgrades = $testobject->test_update_grade_item($this->courseid, $map, $key, $verbosescales, $testarray[0][6]);
|
||||
|
||||
$expectedresult = array();
|
||||
$expectedresult[0] = new stdClass();
|
||||
$expectedresult[0]->itemid = 1;
|
||||
$expectedresult[0]->finalgrade = $testarray[0][6];
|
||||
|
||||
$this->assertEquals($newgrades, $expectedresult);
|
||||
|
||||
// Try sending a bad grade value (A letter instead of a float / int).
|
||||
$newgrades = $testobject->test_update_grade_item($this->courseid, $map, $key, $verbosescales, 'A');
|
||||
// The $newgrades variable should be null.
|
||||
$this->assertNull($newgrades);
|
||||
$expectederrormessage = get_string('badgrade', 'grades');
|
||||
// Check that the error message is what we expect.
|
||||
$gradebookerrors = $testobject->get_gradebookerrors();
|
||||
$this->assertEquals($expectederrormessage, $gradebookerrors[0]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test importing data and mapping it with items in the course.
|
||||
*/
|
||||
public function test_map_user_data_with_value() {
|
||||
// Need to add one of the users into the system.
|
||||
$user = new stdClass();
|
||||
$user->firstname = 'Anne';
|
||||
$user->lastname = 'Able';
|
||||
$user->email = '[email protected]';
|
||||
$userdetail = $this->getDataGenerator()->create_user($user);
|
||||
|
||||
$testarray = $this->csv_load($this->oktext);
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
|
||||
// We're not using scales so no to this option.
|
||||
$verbosescales = 0;
|
||||
// Map and key are to retrieve the grade_item that we are updating.
|
||||
$map = array(1);
|
||||
$key = 0;
|
||||
|
||||
// Test new user mapping. This should return the user id if there were no problems.
|
||||
$userid = $testobject->test_map_user_data_with_value('useremail', $testarray[0][5], $this->columns, $map, $key,
|
||||
$this->courseid, $map[$key], $verbosescales);
|
||||
$this->assertEquals($userid, $userdetail->id);
|
||||
|
||||
$newgrades = $testobject->test_map_user_data_with_value('new', $testarray[0][6], $this->columns, $map, $key,
|
||||
$this->courseid, $map[$key], $verbosescales);
|
||||
// Check that the final grade is the same as the one inserted.
|
||||
$this->assertEquals($testarray[0][6], $newgrades[0]->finalgrade);
|
||||
|
||||
$feedback = $testobject->test_map_user_data_with_value('feedback', $testarray[0][7], $this->columns, $map, $key,
|
||||
$this->courseid, $map[$key], $verbosescales);
|
||||
// Expected result.
|
||||
$resultarray = array();
|
||||
$resultarray[0] = new stdClass();
|
||||
$resultarray[0]->itemid = 1;
|
||||
$resultarray[0]->feedback = $testarray[0][7];
|
||||
$this->assertEquals($feedback, $resultarray);
|
||||
|
||||
// Default behaviour (update a grade item).
|
||||
$newgrades = $testobject->test_map_user_data_with_value('default', $testarray[0][6], $this->columns, $map, $key,
|
||||
$this->courseid, $map[$key], $verbosescales);
|
||||
$this->assertEquals($testarray[0][6], $newgrades[0]->finalgrade);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test importing data into the gradebook.
|
||||
*/
|
||||
public function test_prepare_import_grade_data() {
|
||||
global $DB;
|
||||
|
||||
// Need to add one of the users into the system.
|
||||
$user = new stdClass();
|
||||
$user->firstname = 'Anne';
|
||||
$user->lastname = 'Able';
|
||||
$user->email = '[email protected]';
|
||||
// Insert user 1.
|
||||
$this->getDataGenerator()->create_user($user);
|
||||
$user = new stdClass();
|
||||
$user->firstname = 'Bobby';
|
||||
$user->lastname = 'Bunce';
|
||||
$user->email = '[email protected]';
|
||||
// Insert user 2.
|
||||
$this->getDataGenerator()->create_user($user);
|
||||
|
||||
$this->csv_load($this->oktext);
|
||||
|
||||
$importcode = 007;
|
||||
$verbosescales = 0;
|
||||
|
||||
// Form data object.
|
||||
$formdata = new stdClass();
|
||||
$formdata->mapfrom = 5;
|
||||
$formdata->mapto = 'useremail';
|
||||
$formdata->mapping_0 = 0;
|
||||
$formdata->mapping_1 = 0;
|
||||
$formdata->mapping_2 = 0;
|
||||
$formdata->mapping_3 = 0;
|
||||
$formdata->mapping_4 = 0;
|
||||
$formdata->mapping_5 = 0;
|
||||
$formdata->mapping_6 = 'new';
|
||||
$formdata->mapping_7 = 'feedback_2';
|
||||
$formdata->mapping_8 = 0;
|
||||
$formdata->map = 1;
|
||||
$formdata->id = 2;
|
||||
$formdata->iid = $this->iid;
|
||||
$formdata->importcode = $importcode;
|
||||
|
||||
// Blam go time.
|
||||
$testobject = new phpunit_gradeimport_csv_load_data();
|
||||
$dataloaded = $testobject->prepare_import_grade_data($this->columns, $formdata, $this->csvimport, $this->courseid, '', '',
|
||||
$verbosescales);
|
||||
// If everything inserted properly then this should be true.
|
||||
$this->assertTrue($dataloaded);
|
||||
}
|
||||
}
|
||||
@@ -25,6 +25,6 @@
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
$plugin->version = 2014051200; // The current plugin version (Date: YYYYMMDDXX)
|
||||
$plugin->version = 2014093000; // The current plugin version (Date: YYYYMMDDXX)
|
||||
$plugin->requires = 2014050800; // Requires this Moodle version
|
||||
$plugin->component = 'gradeimport_csv'; // Full name of the plugin (used for diagnostics)
|
||||
|
||||
@@ -0,0 +1,71 @@
|
||||
<?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/>.
|
||||
|
||||
require_once($CFG->libdir.'/formslib.php');
|
||||
|
||||
if (!defined('MOODLE_INTERNAL')) {
|
||||
die('Direct access to this script is forbidden.'); // It must be included from a Moodle page.
|
||||
}
|
||||
|
||||
/**
|
||||
* Form for copying and pasting from a spreadsheet.
|
||||
*
|
||||
* @package gradeimport_direct
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
class gradeimport_direct_import_form extends moodleform {
|
||||
|
||||
/**
|
||||
* Definition method.
|
||||
*/
|
||||
public function definition() {
|
||||
global $COURSE;
|
||||
|
||||
$mform = $this->_form;
|
||||
|
||||
if (isset($this->_customdata)) { // Hardcoding plugin names here is hacky.
|
||||
$features = $this->_customdata;
|
||||
} else {
|
||||
$features = array();
|
||||
}
|
||||
|
||||
// Course id needs to be passed for auth purposes.
|
||||
$mform->addElement('hidden', 'id', optional_param('id', 0, PARAM_INT));
|
||||
$mform->setType('id', PARAM_INT);
|
||||
|
||||
$mform->addElement('header', 'general', get_string('pluginname', 'gradeimport_direct'));
|
||||
// Data upload from copy/paste.
|
||||
$mform->addElement('textarea', 'userdata', 'Data', array('rows' => 10, 'class' => 'gradeimport_data_area'));
|
||||
$mform->addRule('userdata', null, 'required');
|
||||
$mform->setType('userdata', PARAM_RAW);
|
||||
|
||||
$encodings = core_text::get_encodings();
|
||||
$mform->addElement('select', 'encoding', get_string('encoding', 'grades'), $encodings);
|
||||
|
||||
if (!empty($features['verbosescales'])) {
|
||||
$options = array(1 => get_string('yes'), 0 => get_string('no'));
|
||||
$mform->addElement('select', 'verbosescales', get_string('verbosescales', 'grades'), $options);
|
||||
}
|
||||
|
||||
$options = array('10' => 10, '20' => 20, '100' => 100, '1000' => 1000, '100000' => 100000);
|
||||
$mform->addElement('select', 'previewrows', get_string('rowpreviewnum', 'grades'), $options);
|
||||
$mform->setType('previewrows', PARAM_INT);
|
||||
$mform->addElement('hidden', 'groupid', groups_get_course_group($COURSE));
|
||||
$mform->setType('groupid', PARAM_INT);
|
||||
$this->add_action_buttons(false, get_string('uploadgrades', 'grades'));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,111 @@
|
||||
<?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/>.
|
||||
|
||||
require_once($CFG->libdir.'/formslib.php');
|
||||
require_once($CFG->libdir.'/gradelib.php');
|
||||
|
||||
if (!defined('MOODLE_INTERNAL')) {
|
||||
die('Direct access to this script is forbidden.'); // It must be included from a Moodle page.
|
||||
}
|
||||
|
||||
/**
|
||||
* Form for mapping columns to the fields in the table.
|
||||
*
|
||||
* @package gradeimport_direct
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
class gradeimport_direct_mapping_form extends moodleform {
|
||||
|
||||
/**
|
||||
* Definition method.
|
||||
*/
|
||||
public function definition() {
|
||||
global $CFG, $COURSE;
|
||||
$mform = $this->_form;
|
||||
|
||||
// This is an array of headers.
|
||||
$header = $this->_customdata['header'];
|
||||
// Course id.
|
||||
|
||||
$mform->addElement('header', 'general', get_string('identifier', 'grades'));
|
||||
$mapfromoptions = array();
|
||||
|
||||
if ($header) {
|
||||
foreach ($header as $i => $h) {
|
||||
$mapfromoptions[$i] = s($h);
|
||||
}
|
||||
}
|
||||
$mform->addElement('select', 'mapfrom', get_string('mapfrom', 'grades'), $mapfromoptions);
|
||||
|
||||
$maptooptions = array(
|
||||
'userid' => get_string('userid', 'grades'),
|
||||
'username' => get_string('username'),
|
||||
'useridnumber' => get_string('idnumber'),
|
||||
'useremail' => get_string('email'),
|
||||
'0' => get_string('ignore', 'grades')
|
||||
);
|
||||
$mform->addElement('select', 'mapto', get_string('mapto', 'grades'), $maptooptions);
|
||||
|
||||
$mform->addElement('header', 'general', get_string('mappings', 'grades'));
|
||||
|
||||
// Add a feedback option.
|
||||
$feedbacks = array();
|
||||
if ($gradeitems = $this->_customdata['gradeitems']) {
|
||||
foreach ($gradeitems as $itemid => $itemname) {
|
||||
$feedbacks['feedback_'.$itemid] = get_string('feedbackforgradeitems', 'grades', $itemname);
|
||||
}
|
||||
}
|
||||
|
||||
if ($header) {
|
||||
$i = 0;
|
||||
foreach ($header as $h) {
|
||||
$h = trim($h);
|
||||
// This is what each header maps to.
|
||||
$headermapsto = array(
|
||||
get_string('others', 'grades') => array(
|
||||
'0' => get_string('ignore', 'grades'),
|
||||
'new' => get_string('newitem', 'grades')
|
||||
),
|
||||
get_string('gradeitems', 'grades') => $gradeitems,
|
||||
get_string('feedbacks', 'grades') => $feedbacks
|
||||
);
|
||||
$mform->addElement('selectgroups', 'mapping_'.$i, s($h), $headermapsto);
|
||||
$i++;
|
||||
}
|
||||
}
|
||||
// Course id needs to be passed for auth purposes.
|
||||
$mform->addElement('hidden', 'map', 1);
|
||||
$mform->setType('map', PARAM_INT);
|
||||
$mform->setConstant('map', 1);
|
||||
$mform->addElement('hidden', 'id', $this->_customdata['id']);
|
||||
$mform->setType('id', PARAM_INT);
|
||||
$mform->setConstant('id', $this->_customdata['id']);
|
||||
$mform->addElement('hidden', 'iid', $this->_customdata['iid']);
|
||||
$mform->setType('iid', PARAM_INT);
|
||||
$mform->setConstant('iid', $this->_customdata['iid']);
|
||||
$mform->addElement('hidden', 'importcode', $this->_customdata['importcode']);
|
||||
$mform->setType('importcode', PARAM_FILE);
|
||||
$mform->setConstant('importcode', $this->_customdata['importcode']);
|
||||
$mform->addElement('hidden', 'verbosescales', 1);
|
||||
$mform->setType('verbosescales', PARAM_INT);
|
||||
$mform->setConstant('verbosescales', $this->_customdata['importcode']);
|
||||
$mform->addElement('hidden', 'groupid', groups_get_course_group($COURSE));
|
||||
$mform->setType('groupid', PARAM_INT);
|
||||
$mform->setConstant('groupid', groups_get_course_group($COURSE));
|
||||
$this->add_action_buttons(false, get_string('uploadgrades', 'grades'));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,37 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* Capabilities gradeimport plugin.
|
||||
*
|
||||
* @package gradeimport_direct
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
$capabilities = array(
|
||||
|
||||
'gradeimport/direct:view' => array(
|
||||
'captype' => 'write',
|
||||
'contextlevel' => CONTEXT_COURSE,
|
||||
'archetypes' => array(
|
||||
'editingteacher' => CAP_ALLOW,
|
||||
'manager' => CAP_ALLOW
|
||||
)
|
||||
)
|
||||
);
|
||||
@@ -0,0 +1,124 @@
|
||||
<?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/>.
|
||||
|
||||
require_once(__DIR__ . "../../../../config.php");
|
||||
require_once($CFG->libdir.'/gradelib.php');
|
||||
require_once($CFG->dirroot.'/grade/lib.php');
|
||||
require_once($CFG->dirroot.'/grade/import/lib.php');
|
||||
require_once($CFG->libdir . '/csvlib.class.php');
|
||||
|
||||
$id = required_param('id', PARAM_INT); // Course id.
|
||||
$verbosescales = optional_param('verbosescales', 1, PARAM_BOOL);
|
||||
$iid = optional_param('iid', null, PARAM_INT);
|
||||
$importcode = optional_param('importcode', '', PARAM_FILE);
|
||||
|
||||
$url = new moodle_url('/grade/import/direct/index.php', array('id' => $id));
|
||||
|
||||
if ($verbosescales !== 1) {
|
||||
$url->param('verbosescales', $verbosescales);
|
||||
}
|
||||
|
||||
$PAGE->set_url($url);
|
||||
|
||||
if (!$course = $DB->get_record('course', array('id' => $id))) {
|
||||
print_error('nocourseid');
|
||||
}
|
||||
|
||||
require_login($course);
|
||||
$context = context_course::instance($id);
|
||||
require_capability('moodle/grade:import', $context);
|
||||
require_capability('gradeimport/direct:view', $context);
|
||||
|
||||
$separatemode = (groups_get_course_groupmode($COURSE) == SEPARATEGROUPS and
|
||||
!has_capability('moodle/site:accessallgroups', $context));
|
||||
$currentgroup = groups_get_course_group($course);
|
||||
|
||||
print_grade_page_head($course->id, 'import', 'direct', get_string('pluginname', 'gradeimport_direct'), false, false, true,
|
||||
'userdata', 'gradeimport_direct');
|
||||
|
||||
$renderer = $PAGE->get_renderer('gradeimport_csv');
|
||||
|
||||
// Get the grade items to be matched with the import mapping columns.
|
||||
$gradeitems = gradeimport_csv_load_data::fetch_grade_items($course->id);
|
||||
|
||||
// If the csv file hasn't been imported yet then look for a form submission or
|
||||
// show the initial submission form.
|
||||
if (!$iid) {
|
||||
|
||||
// Set up the import form.
|
||||
$mform = new gradeimport_direct_import_form(null, array('includeseparator' => true, 'verbosescales' => true, 'acceptedtypes' =>
|
||||
array('.csv', '.txt')));
|
||||
|
||||
// If the import form has been submitted.
|
||||
if ($formdata = $mform->get_data()) {
|
||||
$text = $formdata->userdata;
|
||||
$csvimport = new gradeimport_csv_load_data();
|
||||
$csvimport->load_csv_content($text, $formdata->encoding, 'tab', $formdata->previewrows);
|
||||
$csvimporterror = $csvimport->get_error();
|
||||
if (!empty($csvimporterror)) {
|
||||
echo $renderer->errors($csvimport->get_error());
|
||||
echo $OUTPUT->footer();
|
||||
die();
|
||||
}
|
||||
$iid = $csvimport->get_iid();
|
||||
echo $renderer->import_preview_page($csvimport->get_headers(), $csvimport->get_previewdata());
|
||||
} else {
|
||||
// Display the standard upload file form.
|
||||
echo $renderer->standard_upload_file_form($course, $mform);
|
||||
echo $OUTPUT->footer();
|
||||
die();
|
||||
}
|
||||
}
|
||||
|
||||
// Data has already been submitted so we can use the $iid to retrieve it.
|
||||
$csvimport = new csv_import_reader($iid, 'grade');
|
||||
$header = $csvimport->get_columns();
|
||||
// Get a new import code for updating to the grade book.
|
||||
if (empty($importcode)) {
|
||||
$importcode = get_new_importcode();
|
||||
}
|
||||
|
||||
$mappingformdata = array(
|
||||
'gradeitems' => $gradeitems,
|
||||
'header' => $header,
|
||||
'iid' => $iid,
|
||||
'id' => $id,
|
||||
'importcode' => $importcode,
|
||||
'verbosescales' => $verbosescales
|
||||
);
|
||||
// We create a form to handle mapping data from the file to the database.
|
||||
$mform2 = new gradeimport_direct_mapping_form(null, $mappingformdata);
|
||||
|
||||
// Here, if we have data, we process the fields and enter the information into the database.
|
||||
if ($formdata = $mform2->get_data()) {
|
||||
$gradeimport = new gradeimport_csv_load_data();
|
||||
$status = $gradeimport->prepare_import_grade_data($header, $formdata, $csvimport, $course->id, $separatemode, $currentgroup,
|
||||
$verbosescales);
|
||||
|
||||
// At this stage if things are all ok, we commit the changes from temp table.
|
||||
if ($status) {
|
||||
grade_import_commit($course->id, $importcode);
|
||||
} else {
|
||||
$errors = $gradeimport->get_gradebookerrors();
|
||||
$errors[] = get_string('importfailed', 'grades');
|
||||
echo $renderer->errors($errors);
|
||||
}
|
||||
echo $OUTPUT->footer();
|
||||
} else {
|
||||
// If data hasn't been submitted then display the data mapping form.
|
||||
$mform2->display();
|
||||
echo $OUTPUT->footer();
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* Strings for component 'gradeimport_direct', language 'en', branch 'MOODLE_28_STABLE'
|
||||
*
|
||||
* @package gradeimport_direct
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
$string['direct:view'] = 'Import grades from CSV';
|
||||
$string['pluginname'] = 'Paste from spreadsheet';
|
||||
$string['userdata'] = 'Help copying data into this form.';
|
||||
$string['userdata_help'] = 'Grades may be copied and pasted from a spreadsheet into the gradebook. The spreadsheet should have a column containing user identity data - either username or ID number or email address. Each column for import should have a column header.';
|
||||
$string['userdata_link'] = 'grade/import/direct/index';
|
||||
@@ -0,0 +1,5 @@
|
||||
.gradeimport_data_area {
|
||||
margin: 0px 0px 10px;
|
||||
width: 475px;
|
||||
height: 209px;
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
<?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/>.
|
||||
|
||||
/**
|
||||
* Version details
|
||||
*
|
||||
* @package gradeimport_direct
|
||||
* @copyright 2014 Adrian Greeve <[email protected]>
|
||||
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||||
*/
|
||||
|
||||
defined('MOODLE_INTERNAL') || die();
|
||||
|
||||
$plugin->version = 2014080400; // The current plugin version (Date: YYYYMMDDXX)
|
||||
$plugin->requires = 2014050800; // Requires this Moodle version
|
||||
$plugin->component = 'gradeimport_direct'; // Full name of the plugin (used for diagnostics).
|
||||
$plugin->dependencies = array('gradeimport_csv' => 2014093000); // Grade import csv is required for this plugin.
|
||||
@@ -136,16 +136,22 @@ class grade_import_mapping_form extends moodleform {
|
||||
// course id needs to be passed for auth purposes
|
||||
$mform->addElement('hidden', 'map', 1);
|
||||
$mform->setType('map', PARAM_INT);
|
||||
$mform->addElement('hidden', 'id');
|
||||
$mform->setConstant('map', 1);
|
||||
$mform->addElement('hidden', 'id', $this->_customdata['id']);
|
||||
$mform->setType('id', PARAM_INT);
|
||||
$mform->addElement('hidden', 'iid');
|
||||
$mform->setConstant('id', $this->_customdata['id']);
|
||||
$mform->addElement('hidden', 'iid', $this->_customdata['iid']);
|
||||
$mform->setType('iid', PARAM_INT);
|
||||
$mform->addElement('hidden', 'importcode');
|
||||
$mform->setConstant('iid', $this->_customdata['iid']);
|
||||
$mform->addElement('hidden', 'importcode', $this->_customdata['importcode']);
|
||||
$mform->setType('importcode', PARAM_FILE);
|
||||
$mform->setConstant('importcode', $this->_customdata['importcode']);
|
||||
$mform->addElement('hidden', 'verbosescales', 1);
|
||||
$mform->setType('verbosescales', PARAM_INT);
|
||||
$mform->setConstant('verbosescales', $this->_customdata['verbosescales']);
|
||||
$mform->addElement('hidden', 'groupid', groups_get_course_group($COURSE));
|
||||
$mform->setType('groupid', PARAM_INT);
|
||||
$mform->setConstant('groupid', groups_get_course_group($COURSE));
|
||||
$this->add_action_buttons(false, get_string('uploadgrades', 'grades'));
|
||||
|
||||
}
|
||||
|
||||
+15
-4
@@ -780,12 +780,14 @@ class grade_plugin_info {
|
||||
* @param string $bodytags Additional attributes that will be added to the <body> tag
|
||||
* @param string $buttons Additional buttons to display on the page
|
||||
* @param boolean $shownavigation should the gradebook navigation drop down (or tabs) be shown?
|
||||
* @param string $headerhelpidentifier The help string identifier if required.
|
||||
* @param string $headerhelpcomponent The component for the help string.
|
||||
*
|
||||
* @return string HTML code or nothing if $return == false
|
||||
*/
|
||||
function print_grade_page_head($courseid, $active_type, $active_plugin=null,
|
||||
$heading = false, $return=false,
|
||||
$buttons=false, $shownavigation=true) {
|
||||
$buttons=false, $shownavigation=true, $headerhelpidentifier = null, $headerhelpcomponent = null) {
|
||||
global $CFG, $OUTPUT, $PAGE;
|
||||
|
||||
$plugin_info = grade_get_plugin_info($courseid, $active_type, $active_plugin);
|
||||
@@ -816,6 +818,7 @@ function print_grade_page_head($courseid, $active_type, $active_plugin=null,
|
||||
}
|
||||
|
||||
$returnval = $OUTPUT->header();
|
||||
|
||||
if (!$return) {
|
||||
echo $returnval;
|
||||
}
|
||||
@@ -831,10 +834,18 @@ function print_grade_page_head($courseid, $active_type, $active_plugin=null,
|
||||
$returnval .= print_grade_plugin_selector($plugin_info, $active_type, $active_plugin, $return);
|
||||
}
|
||||
|
||||
if ($return) {
|
||||
$returnval .= $OUTPUT->heading($heading);
|
||||
$output = '';
|
||||
// Add a help dialogue box if provided.
|
||||
if (isset($headerhelpidentifier)) {
|
||||
$output = $OUTPUT->heading_with_help($heading, $headerhelpidentifier, $headerhelpcomponent);
|
||||
} else {
|
||||
echo $OUTPUT->heading($heading);
|
||||
$output = $OUTPUT->heading($heading);
|
||||
}
|
||||
|
||||
if ($return) {
|
||||
$returnval .= $output;
|
||||
} else {
|
||||
echo $output;
|
||||
}
|
||||
|
||||
if ($courseid != SITEID &&
|
||||
|
||||
@@ -318,6 +318,7 @@ $string['gradetype_help'] = 'There are 4 grade types:
|
||||
* Text - Feedback only
|
||||
|
||||
Only value and scale grade types may be aggregated. The grade type for an activity-based grade item is set on the activity settings page.';
|
||||
$string['gradevaluetoobig'] = 'One of the grade values is larger than the allowed grade maximum of {$a}';
|
||||
$string['gradeview'] = 'View grade';
|
||||
$string['gradeweighthelp'] = 'Grade weight help';
|
||||
$string['groupavg'] = 'Group average';
|
||||
|
||||
@@ -1034,7 +1034,7 @@ class core_plugin_manager {
|
||||
),
|
||||
|
||||
'gradeimport' => array(
|
||||
'csv', 'xml'
|
||||
'csv', 'direct', 'xml'
|
||||
),
|
||||
|
||||
'gradereport' => array(
|
||||
|
||||
@@ -64,6 +64,7 @@
|
||||
<directory suffix="_test.php">lib/grade/tests</directory>
|
||||
<directory suffix="_test.php">grade/tests</directory>
|
||||
<directory suffix="_test.php">grade/grading/tests</directory>
|
||||
<directory suffix="_test.php">grade/import/csv/tests</directory>
|
||||
</testsuite>
|
||||
<testsuite name="core_availability_testsuite">
|
||||
<directory suffix="_test.php">availability/tests</directory>
|
||||
|
||||
Reference in New Issue
Block a user