/**
* Performs class creation
* @throws moodle_exception If there was an error in passed parameters.
* @throws data_object_exception If there was an error creating the entity.
* @param array $data The incoming data parameter.
* @return array An array of parameters, if successful.
*/
public static function class_create(array $data)
{
global $USER, $DB;
if (static::require_elis_dependencies() !== true) {
throw new moodle_exception('ws_function_requires_elis', 'local_datahub');
}
// Parameter validation.
$params = self::validate_parameters(self::class_create_parameters(), array('data' => $data));
// Context validation.
$context = context_user::instance($USER->id);
self::validate_context($context);
// Capability checking.
require_capability('local/elisprogram:class_create', context_system::instance());
// Initialize version1elis importplugin for utility functions.
$importplugin = rlip_dataplugin_factory::factory('dhimport_version1elis');
// Create the class.
$data = (object) $data;
$data = $importplugin->add_custom_field_prefixes($data);
// Parse startdate and enddate.
foreach (array('startdate', 'enddate') as $date) {
if (isset($data->{$date})) {
$data->{$date} = $importplugin->parse_date($data->{$date});
}
}
// Check for duplicate idnumbers.
if ($DB->record_exists(pmclass::TABLE, array('idnumber' => $data->idnumber))) {
throw new moodle_exception('ws_class_create_fail_duplicateidnumber', 'local_datahub');
}
// Do course assignment.
$crsid = $DB->get_field(course::TABLE, 'id', array('idnumber' => $data->assignment));
if (empty($crsid)) {
throw new moodle_exception('ws_class_create_fail_invalidcourseassignment', 'local_datahub');
}
$data->courseid = $crsid;
$class = new pmclass();
$class->set_from_data($data);
$class->save();
// Associate this class instance to a track, if necessary.
$importplugin->associate_class_to_track($data, $class->id);
// Associate this class instance to a Moodle course, if necessary.
$importplugin->associate_class_to_moodle_course($data, $class->id);
// Respond.
if (!empty($class->id)) {
$classrec = (array) $DB->get_record(pmclass::TABLE, array('id' => $class->id));
$classobj = $class->to_array();
// Convert multi-valued custom field arrays to comma-separated listing.
$fields = static::get_class_custom_fields();
foreach ($fields as $field) {
// Generate name using custom field prefix.
$fullfieldname = data_object_with_custom_fields::CUSTOM_FIELD_PREFIX . $field->shortname;
if ($field->multivalued && !empty($classobj[$fullfieldname]) && is_array($classobj[$fullfieldname])) {
$classobj[$fullfieldname] = implode(',', $classobj[$fullfieldname]);
}
}
return array('messagecode' => get_string('ws_class_create_success_code', 'local_datahub'), 'message' => get_string('ws_class_create_success_msg', 'local_datahub'), 'record' => array_merge($classrec, $classobj));
} else {
throw new data_object_exception('ws_class_create_fail', 'local_datahub');
}
}
