/** * Marshall a testVariable QTI element in its TestVariable object equivalent. * * @param \DOMElement A DOMElement object. * @return \qtism\data\QtiComponent The corresponding TestVariable object. */ protected function unmarshall(DOMElement $element) { $baseComponent = parent::unmarshall($element); if (($variableIdentifier = static::getDOMElementAttributeAs($element, 'variableIdentifier')) !== null) { $object = new TestVariables($variableIdentifier); $object->setSectionIdentifier($baseComponent->getSectionIdentifier()); $object->setIncludeCategories($baseComponent->getIncludeCategories()); $object->setExcludeCategories($baseComponent->getExcludeCategories()); if (($baseType = static::getDOMElementAttributeAs($element, 'baseType')) !== null) { $object->setBaseType(BaseType::getConstantByName($baseType)); } if (($weightIdentifier = static::getDOMElementAttributeAs($element, 'weightIdentifier')) !== null) { $object->setWeightIdentifier($weightIdentifier); } return $object; } else { $msg = "The mandatory attribute 'variableIdentifier' is missing from element '" . $element->localName . "'."; throw new UnmarshallingException($msg, $element); } }
/** * Append the outcome processing rules to populate an outcome variable with total score of items related to a given category. * * This method will append a QTI outcome processing to a given QTI-SDK AssessmentTest $test, dedicated to store * the total score of items related to a given QTI $category. * * In case of the $weightIdentifier argument is given, the score will consider weights defined at the assessmentItemRef * level identified by $weightIdentifier. Otherwise, no weights are taken into account while computing total scores. * * In case of an outcome processing rule targetting a variable name $varName already exists in the test, the outcome * processing rule is not appended to the test. * * @param qtism\data\AssessmentTest $test A QTI-SDK AssessmentTest object. * @param string $category A QTI category identifier. * @param string $varName The QTI identifier of the variable to be populated by the outcome processing rule. * @param string $scoreIdentifier (optional) An optional QTI identifier to be used as items' score variable (defaults to "SCORE"). * @param string $weightIdentifier (optional) An optional QTI identifier to be used as items' weight to be considered for total score. (defaults to empty string). */ public static function appendTotalScoreOutcomeProcessing(AssessmentTest $test, $category, $varName, $scoreVariableIdentifier = 'SCORE', $weightIdentifier = '') { if (self::isVariableSetOutcomeValueTarget($test, $varName) === false) { $testVariablesExpression = new TestVariables($scoreVariableIdentifier, BaseType::FLOAT); $testVariablesExpression->setWeightIdentifier($weightIdentifier); $testVariablesExpression->setIncludeCategories(new IdentifierCollection(array($category))); $setOutcomeValue = new SetOutcomeValue($varName, new Sum(new ExpressionCollection(array($testVariablesExpression)))); self::appendOutcomeRule($test, $setOutcomeValue); } }