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

/**
 * Steps definitions for marking guides.
 *
 * @package   gradingform_guide
 * @category  test
 * @copyright 2015 Jun Pataleta
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

require_once(__DIR__ . '/../../../../../../lib/behat/behat_base.php');

use Behat\Gherkin\Node\TableNode as TableNode,
    Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException,
    Behat\Mink\Exception\ExpectationException as ExpectationException;

/**
 * Steps definitions to help with marking guides.
 *
 * @package   gradingform_guide
 * @category  test
 * @copyright 2015 Jun Pataleta
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class behat_gradingform_guide extends behat_base {

    /**
     * Defines the marking guide with the provided data, following marking guide's definition grid cells.
     *
     * This method fills the marking guide of the marking guide definition
     * form; the provided TableNode should contain one row for
     * each criterion and each cell of the row should contain:
     * # Criterion name, a.k.a. shortname
     * # Description for students
     * # Description for markers
     * # Max score
     *
     * Works with both JS and non-JS.
     *
     * @When /^I define the following marking guide:$/
     * @throws ExpectationException
     * @param TableNode $guide
     */
    public function i_define_the_following_marking_guide(TableNode $guide) {
        $steptableinfo = '| Criterion name | Description for students | Description for markers | Maximum score |';

        if ($criteria = $guide->getHash()) {
            $addcriterionbutton = $this->find_button(get_string('addcriterion', 'gradingform_guide'));

            foreach ($criteria as $index => $criterion) {
                // Make sure the criterion array has 4 elements.
                if (count($criterion) != 4) {
                    throw new ExpectationException(
                        'The criterion definition should contain name, description for students and markers, and maximum points. ' .
                        'Please follow this format: ' . $steptableinfo,
                        $this->getSession()
                    );
                }

                // On load, there's already a criterion template ready.
                $shortnamevisible = false;
                if ($index > 0) {
                    // So if the index is greater than 0, we click the Add new criterion button to add a new criterion.
                    $addcriterionbutton->click();
                    $shortnamevisible = true;
                }

                $criterionroot = 'guide[criteria][NEWID' . ($index + 1) . ']';

                // Set the field value for the Criterion name.
                $this->set_guide_field_value($criterionroot . '[shortname]', $criterion['Criterion name'], $shortnamevisible);

                // Set the field value for the Description for students field.
                $this->set_guide_field_value($criterionroot . '[description]', $criterion['Description for students']);

                // Set the field value for the Description for markers field.
                $this->set_guide_field_value($criterionroot . '[descriptionmarkers]', $criterion['Description for markers']);

                // Set the field value for the Max score field.
                $this->set_guide_field_value($criterionroot . '[maxscore]', $criterion['Maximum score']);
            }
        }
    }

    /**
     * Defines the marking guide with the provided data, following marking guide's definition grid cells.
     *
     * This method fills the table of frequently used comments of the marking guide definition form.
     * The provided TableNode should contain one row for each frequently used comment.
     * Each row contains:
     * # Comment
     *
     * Works with both JS and non-JS.
     *
     * @When /^I define the following frequently used comments:$/
     * @throws ExpectationException
     * @param TableNode $commentstable
     */
    public function i_define_the_following_frequently_used_comments(TableNode $commentstable) {
        $steptableinfo = '| Comment |';

        if ($comments = $commentstable->getRows()) {
            $addcommentbutton = $this->find_button(get_string('addcomment', 'gradingform_guide'));

            foreach ($comments as $index => $comment) {
                // Make sure the comment array has only 1 element.
                if (count($comment) != 1) {
                    throw new ExpectationException(
                        'The comment cannot be empty. Please follow this format: ' . $steptableinfo,
                        $this->getSession()
                    );
                }

                // On load, there's already a comment template ready.
                $commentfieldvisible = false;
                if ($index > 0) {
                    // So if the index is greater than 0, we click the Add frequently used comment button to add a new criterion.
                    $addcommentbutton->click();
                    $commentfieldvisible = true;
                }

                $commentroot = 'guide[comments][NEWID' . ($index + 1) . ']';

                // Set the field value for the frequently used comment.
                $this->set_guide_field_value($commentroot . '[description]', $comment[0], $commentfieldvisible);
            }
        }
    }

    /**
     * Performs grading of the student by filling out the marking guide.
     * Set one line per criterion and for each criterion set "| Criterion name | Points | Remark |".
     *
     * @When /^I grade by filling the marking guide with:$/
     *
     * @throws ExpectationException
     * @param TableNode $guide
     * @return void
     */
    public function i_grade_by_filling_the_marking_guide_with(TableNode $guide) {

        $criteria = $guide->getRowsHash();

        $stepusage = '"I grade by filling the rubric with:" step needs you to provide a table where each row is a criterion' .
            ' and each criterion has 3 different values: | Criterion name | Number of points | Remark text |';

        // First element -> name, second -> points, third -> Remark.
        foreach ($criteria as $name => $criterion) {

            // We only expect the points and the remark, as the criterion name is $name.
            if (count($criterion) !== 2) {
                throw new ExpectationException($stepusage, $this->getSession());
            }

            // Numeric value here.
            $points = $criterion[0];
            if (!is_numeric($points)) {
                throw new ExpectationException($stepusage, $this->getSession());
            }

            $criterionid = 0;
            if ($criterionnamediv = $this->find('xpath', "//div[@class='criterionshortname'][text()='$name']")) {
                $criteriondivname = $criterionnamediv->getAttribute('name');
                // Criterion's name is of the format "advancedgrading[criteria][ID][shortname]".
                // So just explode the string with "][" as delimiter to extract the criterion ID.
                if ($nameparts = explode('][', $criteriondivname)) {
                    $criterionid = $nameparts[1];
                }
            }

            if ($criterionid) {
                $criterionroot = 'advancedgrading[criteria]' . '[' . $criterionid . ']';

                $this->execute('behat_forms::i_set_the_field_to', array($criterionroot . '[score]', $points));

                $this->execute('behat_forms::i_set_the_field_to', array($criterionroot . '[remark]', $criterion[1]));
            }
        }
    }

    /**
     * Makes a hidden marking guide field visible (if necessary) and sets a value on it.
     *
     * @param string $name The name of the field
     * @param string $value The value to set
     * @param bool $visible
     * @return void
     */
    protected function set_guide_field_value($name, $value, $visible = false) {
        // Fields are hidden by default.
        if ($this->running_javascript() && $visible === false) {
            $xpath = "//*[@name='$name']/following-sibling::*[contains(concat(' ', normalize-space(@class), ' '), ' plainvalue ')]";
            $textnode = $this->find('xpath', $xpath);
            $textnode->click();
        }

        // Set the value now.
        $field = $this->find_field($name);
        $field->setValue($value);
    }
}