Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

< /** < * Competency rule tests. < * < * @package core_competency < * @copyright 2015 Frédéric Massart - FMCorz.net < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */
> namespace core_competency;
defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/webservice/tests/helpers.php');
< use core_competency\user_competency; < use core_competency\competency; < use core_competency\competency_rule_all; < use core_competency\competency_rule_points; <
/** * Competency rule testcase. * * @package core_competency * @copyright 2015 Frédéric Massart - FMCorz.net * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */
< class core_competency_competency_rule_testcase extends externallib_advanced_testcase {
> class competency_rule_test extends \externallib_advanced_testcase {
public function test_rule_all_matching() { $this->resetAfterTest(true); $this->setAdminUser(); $lpg = $this->getDataGenerator()->get_plugin_generator('core_competency'); $u1 = $this->getDataGenerator()->create_user(); // Set up the framework and competencies. $framework = $lpg->create_framework(); $c1 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c11 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c111 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c11->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c112 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c11->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c12 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c13 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); $c131 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c13->get('id'), 'ruletype' => 'core_competency\competency_rule_all')); // Create some user competency records. $uc1 = $lpg->create_user_competency(array('competencyid' => $c1->get('id'), 'userid' => $u1->id)); $uc11 = $lpg->create_user_competency(array('competencyid' => $c11->get('id'), 'userid' => $u1->id, 'grade' => 1, 'proficiency' => 1)); $uc111 = $lpg->create_user_competency(array('competencyid' => $c111->get('id'), 'userid' => $u1->id, 'grade' => 1, 'proficiency' => 1)); $uc112 = $lpg->create_user_competency(array('competencyid' => $c112->get('id'), 'userid' => $u1->id, 'grade' => 1, 'proficiency' => 1)); $uc12 = $lpg->create_user_competency(array('competencyid' => $c12->get('id'), 'userid' => $u1->id)); $uc13 = new user_competency(0, (object) array('userid' => $u1->id, 'competencyid' => $c13->get('id'))); // Not all children are met. $cr = new competency_rule_all($c1); $this->assertFalse($cr->matches($uc1)); // All children are met. $cr = new competency_rule_all($c11); $this->assertTrue($cr->matches($uc11)); // The competency doesn't have any children. $cr = new competency_rule_all($c12); $this->assertFalse($cr->matches($uc12)); // The competency doesn't have saved user competency records. $cr = new competency_rule_all($c13); $this->assertFalse($cr->matches($uc13)); } public function test_rule_points_validation() { $this->resetAfterTest(true); $this->setAdminUser(); $lpg = $this->getDataGenerator()->get_plugin_generator('core_competency'); $framework = $lpg->create_framework(); $framework2 = $lpg->create_framework(); $c1 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'))); $c2 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); $c3 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); $c4 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'))); $cx = $lpg->create_competency(array('competencyframeworkid' => $framework2->get('id'))); $c1->set('ruletype', 'core_competency\competency_rule_points'); $rule = new competency_rule_points($c1); // Invalid config. $config = json_encode(array()); $this->assertFalse($rule->validate_config($config)); // Missing required points. $config = json_encode(array( 'base' => array(), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Invalid required points. $config = json_encode(array( 'base' => array('points' => 'abc'), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Less than 1 required points. $config = json_encode(array( 'base' => array('points' => 0), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Not enough required points. $config = json_encode(array( 'base' => array('points' => 3), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Duplicate competency. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Competency includes itself. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( array('id' => $c1->get('id'), 'points' => 1, 'required' => 0), array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Cannot use negative points. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( array('id' => $c2->get('id'), 'points' => -1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // Not competencies set. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( ) )); $this->assertFalse($rule->validate_config($config)); // There is a competency that is not a child. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( array('id' => $c1->get('id'), 'points' => 1, 'required' => 0), array('id' => $c2->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // There is a competency from another framework in there. $config = json_encode(array( 'base' => array('points' => 1), 'competencies' => array( array('id' => $cx->get('id'), 'points' => 1, 'required' => 0), array('id' => $c3->get('id'), 'points' => 1, 'required' => 0), ) )); $this->assertFalse($rule->validate_config($config)); // A normal config. $config = json_encode(array( 'base' => array('points' => 4), 'competencies' => array( array('id' => $c2->get('id'), 'points' => 3, 'required' => 0), array('id' => $c3->get('id'), 'points' => 2, 'required' => 1), ) )); $this->assertTrue($rule->validate_config($config)); } public function test_rule_points_matching() { $this->resetAfterTest(true); $this->setAdminUser(); $lpg = $this->getDataGenerator()->get_plugin_generator('core_competency'); $u1 = $this->getDataGenerator()->create_user(); // Set up the framework and competencies. $framework = $lpg->create_framework(); $c1 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'))); $c1->set('ruletype', 'core_competency\competency_rule_points'); $comprule = new competency_rule_points($c1); $c11 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); $c12 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); $c13 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); $c14 = $lpg->create_competency(array('competencyframeworkid' => $framework->get('id'), 'parentid' => $c1->get('id'))); // Create some user competency records. $uc1 = $lpg->create_user_competency(array('competencyid' => $c1->get('id'), 'userid' => $u1->id)); $uc11 = $lpg->create_user_competency(array('competencyid' => $c11->get('id'), 'userid' => $u1->id, 'grade' => 1, 'proficiency' => 1)); $uc12 = $lpg->create_user_competency(array('competencyid' => $c12->get('id'), 'userid' => $u1->id, 'grade' => 1, 'proficiency' => 1)); $uc13 = $lpg->create_user_competency(array('competencyid' => $c13->get('id'), 'userid' => $u1->id)); // Enough points. $rule = array( 'base' => array('points' => 8), 'competencies' => array( array( 'id' => $c11->get('id'), 'points' => 4, 'required' => 0 ), array( 'id' => $c12->get('id'), 'points' => 4, 'required' => 0 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertTrue($comprule->matches($uc1)); // Not enough points. $rule = array( 'base' => array('points' => 8), 'competencies' => array( array( 'id' => $c11->get('id'), 'points' => 4, 'required' => 0 ), array( 'id' => $c13->get('id'), 'points' => 4, 'required' => 0 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertFalse($comprule->matches($uc1)); // One required that is not met but points were OK. $rule = array( 'base' => array('points' => 8), 'competencies' => array( array( 'id' => $c11->get('id'), 'points' => 4, 'required' => 0 ), array( 'id' => $c12->get('id'), 'points' => 4, 'required' => 0 ), array( 'id' => $c13->get('id'), 'points' => 4, 'required' => 1 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertFalse($comprule->matches($uc1)); // One required, one not, should match. $rule = array( 'base' => array('points' => 8), 'competencies' => array( array( 'id' => $c11->get('id'), 'points' => 4, 'required' => 0 ), array( 'id' => $c12->get('id'), 'points' => 4, 'required' => 1 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertTrue($comprule->matches($uc1)); // All required and should match. $rule = array( 'base' => array('points' => 8), 'competencies' => array( array( 'id' => $c11->get('id'), 'points' => 4, 'required' => 1 ), array( 'id' => $c12->get('id'), 'points' => 4, 'required' => 1 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertTrue($comprule->matches($uc1)); // All required, but one doesn't have a user record. $rule = array( 'base' => array('points' => 4), 'competencies' => array( array( 'id' => $c12->get('id'), 'points' => 4, 'required' => 1 ), array( 'id' => $c14->get('id'), 'points' => 4, 'required' => 1 ), ) ); $c1->set('ruleconfig', json_encode($rule)); $c1->update(); $this->assertFalse($comprule->matches($uc1)); } }