Proyectos de Subversion Moodle

<?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/>.

use core_competency\competency;

use core_competency\competency_framework;

use core_competency\plan;

/**

 * Behat data generator for core_competency.

 *

 * @package   core_competency

 * @category  test

 * @copyright 2022 Noel De Martin

 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

class behat_core_competency_generator extends behat_generator_base {

    /**

     * Get a list of the entities that Behat can create using the generator step.

     *

     * @return array

     */

    protected function get_creatable_entities(): array {

        return [

            'competencies' => [

                'singular' => 'competency',

                'datagenerator' => 'competency',

                'required' => ['shortname', 'competencyframework'],

                'switchids' => ['competencyframework' => 'competencyframeworkid'],

            ],

            'course_competencies' => [

                'singular' => 'course_competency',

                'datagenerator' => 'course_competency',

                'required' => ['course', 'competency'],

                'switchids' => ['course' => 'courseid', 'competency' => 'competencyid'],

            ],

            'frameworks' => [

                'singular' => 'framework',

                'datagenerator' => 'framework',

                'required' => ['shortname'],

                'switchids' => ['scale' => 'scaleid'],

            ],

            'plans' => [

                'singular' => 'plan',

                'datagenerator' => 'plan',

                'required' => ['name'],

                'switchids' => ['user' => 'userid'],

            ],

            'related_competencies' => [

                'singular' => 'related_competency',

                'datagenerator' => 'related_competency',

                'required' => ['competency', 'relatedcompetency'],

                'switchids' => ['competency' => 'competencyid', 'relatedcompetency' => 'relatedcompetencyid'],

            ],

            'user_competency' => [

                'singular' => 'user_competency',

                'datagenerator' => 'user_competency',

                'required' => ['competency', 'user'],

                'switchids' => ['competency' => 'competencyid', 'user' => 'userid'],

            ],

            'user_competency_courses' => [

                'singular' => 'user_competency_course',

                'datagenerator' => 'user_competency_course',

                'required' => ['course', 'competency', 'user'],

                'switchids' => ['course' => 'courseid', 'competency' => 'competencyid', 'user' => 'userid'],

            ],

            'user_competency_plans' => [

                'singular' => 'user_competency_plan',

                'datagenerator' => 'user_competency_plan',

                'required' => ['plan', 'competency', 'user'],

                'switchids' => ['plan' => 'planid', 'competency' => 'competencyid', 'user' => 'userid'],

            ],

        ];

    }

    /**

     * Get the competecy framework id using an idnumber.

     *

     * @param string $idnumber

     * @return int The competecy framework id

     */

    protected function get_competencyframework_id(string $idnumber): int {

        global $DB;

        if (!$id = $DB->get_field('competency_framework', 'id', ['idnumber' => $idnumber])) {

            throw new Exception('The specified competency framework with idnumber "' . $idnumber . '" could not be found.');

        }

        return $id;

    }

    /**

     * Get the competecy id using an idnumber.

     *

     * @param string $idnumber

     * @return int The competecy id

     */

    protected function get_competency_id(string $idnumber): int {

        global $DB;

        if (!$id = $DB->get_field('competency', 'id', ['idnumber' => $idnumber])) {

            throw new Exception('The specified competency with idnumber "' . $idnumber . '" could not be found.');

        }

        return $id;

    }

    /**

     * Get the learning plan id using a name.

     *

     * @param string $name

     * @return int The learning plan id

     */

    protected function get_plan_id(string $name): int {

        global $DB;

        if (!$id = $DB->get_field('competency_plan', 'id', ['name' => $name])) {

            throw new Exception('The specified learning plan with name "' . $name . '" could not be found.');

        }

        return $id;

    }

    /**

     * Get the related competecy id using an idnumber.

     *

     * @param string $idnumber

     * @return int The related competecy id

     */

    protected function get_relatedcompetency_id(string $idnumber): int {

        return $this->get_competency_id($idnumber);

    }

    /**

     * Add a plan.

     *

     * @param array $data Plan data.

     */

    public function process_plan(array $data): void {

        $generator = $this->get_data_generator();

        $competencyids = $data['competencyids'] ?? [];

        unset($data['competencyids']);

        $plan = $generator->create_plan($data);

        foreach ($competencyids as $competencyid) {

            $generator->create_plan_competency([

                'planid' => $plan->get('id'),

                'competencyid' => $competencyid,

            ]);

        }

    }

    /**

     * Preprocess user competency data.

     *

     * @param array $data Raw data.

     * @return array Processed data.

     */

    protected function preprocess_user_competency(array $data): array {

        $this->prepare_grading($data);

        return $data;

    }

    /**

     * Preprocess user course competency data.

     *

     * @param array $data Raw data.

     * @return array Processed data.

     */

    protected function preprocess_user_competency_course(array $data): array {

        $this->prepare_grading($data);

        return $data;

    }

    /**

     * Preprocess user learning plan competency data.

     *

     * @param array $data Raw data.

     * @return array Processed data.

     */

    protected function preprocess_user_competency_plan(array $data): array {

        $this->prepare_grading($data);

        return $data;

    }

    /**

     * Preprocess plan data.

     *

     * @param array $data Raw data.

     * @return array Processed data.

     */

    protected function preprocess_plan(array $data): array {

        if (isset($data['competencies'])) {

            $competencies = array_map('trim', str_getcsv($data['competencies']));

            $data['competencyids'] = array_map([$this, 'get_competency_id'], $competencies);

            unset($data['competencies']);

        }

        global $USER;

        return $data + [

            'userid' => $USER->id,

            'status' => plan::STATUS_ACTIVE,

        ];

    }

    /**

     * Prepare grading attributes for record data.

     *

     * @param array $data Record data.

     */

    protected function prepare_grading(array &$data): void {

        if (!isset($data['grade'])) {

            return;

        }

        global $DB;

        $competency = competency::get_record(['id' => $data['competencyid']]);

        $competencyframework = competency_framework::get_record(['id' => $competency->get('competencyframeworkid')]);

        $scale = $DB->get_field('scale', 'scale', ['id' => $competencyframework->get('scaleid')]);

        $grades = array_map('trim', explode(',', $scale));

        $grade = array_search($data['grade'], $grades);

        if ($grade === false) {

            throw new Exception('The grade "'.$data['grade'].'" was not found in the "'.

                $competencyframework->get('shortname').'" competency framework.');

        }

        $data['proficiency'] = true;

        $data['grade'] = $grade + 1;

    }

    /**

     * Get the module data generator.

     *

     * @return core_competency_generator Competency data generator.

     */

    protected function get_data_generator(): core_competency_generator {

        return $this->componentdatagenerator;

    }

}