4require_once 
'./Modules/TestQuestionPool/classes/class.assQuestion.php';
 
    5require_once 
'./Modules/Test/classes/inc.AssessmentConstants.php';
 
    6require_once 
'./Modules/TestQuestionPool/interfaces/interface.ilObjQuestionScoringAdjustable.php';
 
    7require_once 
'./Modules/TestQuestionPool/interfaces/interface.ilObjAnswerScoringAdjustable.php';
 
    8require_once 
'./Modules/TestQuestionPool/interfaces/interface.iQuestionCondition.php';
 
    9require_once 
'./Modules/TestQuestionPool/classes/class.ilUserQuestionResult.php';
 
   72        $this->answers = array();
 
   73        $this->coords = array();
 
  104        if (strlen($this->title)
 
  107            && ($this->image_filename)
 
  108            && (count($this->answers))
 
  138            "DELETE FROM qpl_a_imagemap WHERE question_fi = %s",
 
  140            array( $this->
getId() )
 
  144        foreach ($this->answers as 
$key => $value) {
 
  145            $answer_obj = $this->answers[
$key];
 
  146            $answer_obj->setOrder(
$key);
 
  147            $next_id = 
$ilDB->nextId(
'qpl_a_imagemap');
 
  149                "INSERT INTO qpl_a_imagemap (answer_id, question_fi, answertext, points, aorder, coords, area, points_unchecked) VALUES (%s, %s, %s, %s, %s, %s, %s, %s)",
 
  150                array( 
"integer", 
"integer", 
"text", 
"float", 
"integer", 
"text", 
"text", 
"float" ),
 
  151                array( $next_id, $this->
id, $answer_obj->getAnswertext(
 
  152                                    ), $answer_obj->getPoints(), $answer_obj->getOrder(
 
  153                                    ), $answer_obj->getCoords(), $answer_obj->getArea(
 
  154                                    ), $answer_obj->getPointsUnchecked() )
 
  167            array( $this->
getId() )
 
  172                                                                        ) . 
" (question_fi, image_file, is_multiple_choice) VALUES (%s, %s, %s)",
 
  173            array( 
"integer", 
"text", 
'integer' ),
 
  176                                $this->image_filename,
 
  177                                (
int) $this->is_multiple_choice
 
  189        if ($this->
id <= 0) {
 
  194        $this_id = $this->
getId();
 
  198        include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
 
  202        if ((
int) $testObjId > 0) {
 
  203            $clone->setObjId($testObjId);
 
  222        $clone->copyPageOfQuestion($this_id);
 
  224        $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
 
  226        $clone->duplicateImage($this_id, $thisObjId);
 
  228        $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
 
  242        if ($this->
id <= 0) {
 
  248        include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
 
  251        $source_questionpool_id = $this->
getObjId();
 
  252        $clone->setObjId($target_questionpool_id);
 
  263        $clone->copyImage(
$original_id, $source_questionpool_id);
 
  265        $clone->onCopy($source_questionpool_id, 
$original_id, $clone->getObjId(), $clone->getId());
 
  272        if ($this->
id <= 0) {
 
  277        include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
 
  280        $sourceParentId = $this->
getObjId();
 
  286        $clone->setObjId($targetParentId);
 
  288        if ($targetQuestionTitle) {
 
  289            $clone->setTitle($targetQuestionTitle);
 
  294        $clone->copyPageOfQuestion($sourceQuestionId);
 
  296        $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
 
  298        $clone->copyImage($sourceQuestionId, $sourceParentId);
 
  300        $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
 
  311        $imagepath_original = str_replace(
"/$this->id/images", 
"/$question_id/images", $imagepath);
 
  313        if ((
int) $objectId > 0) {
 
  314            $imagepath_original = str_replace(
"/$this->obj_id/", 
"/$objectId/", $imagepath_original);
 
  317        if (!file_exists($imagepath)) {
 
  323        if (!file_exists($imagepath_original . 
$filename)) {
 
  324            $ilLog->write(
"Could not find an image map file when trying to duplicate image: " . $imagepath_original . 
$filename);
 
  325            $imagepath_original = str_replace(
"/$this->obj_id/", 
"/$objectId/", $imagepath_original);
 
  326            $ilLog->write(
"Using fallback source directory:" . $imagepath_original);
 
  330            $ilLog->write(
"Could not duplicate image for image map question: " . $imagepath_original . 
$filename);
 
  334    public function copyImage($question_id, $source_questionpool)
 
  337        $imagepath_original = str_replace(
"/$this->id/images", 
"/$question_id/images", $imagepath);
 
  338        $imagepath_original = str_replace(
"/$this->obj_id/", 
"/$source_questionpool/", $imagepath_original);
 
  339        if (!file_exists($imagepath)) {
 
  344            print "image could not be copied!!!! ";
 
  369            $this->
setId($question_id);
 
  379            include_once(
"./Services/RTE/classes/class.ilRTE.php");
 
  390                "SELECT * FROM qpl_a_imagemap WHERE question_fi = %s ORDER BY aorder ASC",
 
  394            include_once 
"./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
 
  401        parent::loadFromDb($question_id);
 
  414        if (count($shapes) > 0) {
 
  415            foreach ($shapes as $shape) {
 
  416                $this->
addAnswer($shape->getAnswertext(), 0.0, count($this->answers), $shape->getCoords(), $shape->getArea());
 
  442        if (!empty($image_tempfilename)) {
 
  444            if (!file_exists($imagepath)) {
 
  448                $this->
ilias->raiseError(
"The image could not be uploaded!", $this->
ilias->error_obj->MESSAGE);
 
  468        for (
$i = 0; 
$i < count($this->answers); 
$i++) {
 
  498        $points_unchecked = 0.0
 
  500        include_once 
"./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
 
  501        if (array_key_exists($order, $this->answers)) {
 
  504            for (
$i = count($this->answers) - 1; 
$i >= $order; 
$i--) {
 
  505                $this->answers[
$i + 1] = $this->answers[
$i];
 
  506                $this->answers[
$i + 1]->setOrder(
$i + 1);
 
  508            $this->answers[$order] = $answer;
 
  512            array_push($this->answers, $answer);
 
  527        return count($this->answers);
 
  546        if (count($this->answers) < 1) {
 
  549        if (
$index >= count($this->answers)) {
 
  552        return $this->answers[
$index];
 
  584        if (count($this->answers) < 1) {
 
  587        if (
$index >= count($this->answers)) {
 
  590        unset($this->answers[
$index]);
 
  591        $this->answers = array_values($this->answers);
 
  592        for (
$i = 0; 
$i < count($this->answers); 
$i++) {
 
  593            if ($this->answers[
$i]->getOrder() > 
$index) {
 
  594                $this->answers[
$i]->setOrder(
$i);
 
  609        $this->answers = array();
 
  623        foreach ($this->answers as 
$key => $value) {
 
  624            if ($this->is_multiple_choice) {
 
  625                if ($value->getPoints() > $value->getPointsUnchecked()) {
 
  626                    $points += $value->getPoints();
 
  628                    $points += $value->getPointsUnchecked();
 
  631                if ($value->getPoints() > 
$points) {
 
  651        if ($returndetails) {
 
  652            throw new ilTestException(
'return details not implemented for ' . __METHOD__);
 
  658        $found_values = array();
 
  659        if (is_null(
$pass)) {
 
  664            if (strcmp(
$data[
"value1"], 
"") != 0) {
 
  665                array_push($found_values, 
$data[
"value1"]);
 
  702        if (is_null(
$pass)) {
 
  703            include_once 
"./Modules/Test/classes/class.ilObjTest.php";
 
  707        $solutionSelectionChanged = 
false;
 
  709        $this->
getProcessLocker()->executeUserSolutionUpdateLockOperation(
function () use (&$solutionSelectionChanged, 
$ilDB, $active_id, 
$pass, $authorized) {
 
  718                $solutionSelectionChanged = 
true;
 
  723                    $this->is_multiple_choice
 
  729                    foreach ($selection as $selectedIndex) {
 
  731                        $solutionSelectionChanged = 
true;
 
  737                        'value1' => (
int) $selection
 
  740                    $solutionSelectionChanged = 
true;
 
  744                    if ($this->is_multiple_choice) {
 
  746                            'value1' => (
int) 
$_GET[
'selImage']
 
  754                    $solutionSelectionChanged = 
true;
 
  759        require_once 
'Modules/Test/classes/class.ilObjAssessmentFolder.php';
 
  761            if ($solutionSelectionChanged) {
 
  775        if ($this->is_multiple_choice && strlen(
$_GET[
'remImage'])) {
 
  776            unset($solution[(
int) 
$_GET[
'remImage']]);
 
  779        if (strlen(
$_GET[
'selImage'])) {
 
  780            if (!$this->is_multiple_choice) {
 
  784            $solution[(int) 
$_GET[
'selImage']] = (
int) 
$_GET[
'selImage'];
 
  793            parent::syncWithOriginal();
 
  807        return "assImagemapQuestion";
 
  820        return "qpl_qst_imagemap";
 
  833        return "qpl_a_imagemap";
 
  842        $text = parent::getRTETextWithMediaObjects();
 
  843        foreach ($this->answers as 
$index => $answer) {
 
  844            $text .= $this->feedbackOBJ->getSpecificAnswerFeedbackContent($this->
getId(), 0, 
$index);
 
  854        parent::setExportDetailsXLS($worksheet, $startrow, $active_id, 
$pass);
 
  860            $worksheet->setCell($startrow + 
$i, 0, $answer->getArea() . 
": " . $answer->getCoords());
 
  861            $worksheet->setBold($worksheet->getColumnCoord(0) . ($startrow + 
$i));
 
  864            foreach ($solution as $solIndex => $sol) {
 
  865                if ($sol[
'value1'] == 
$id) {
 
  871            $worksheet->setCell($startrow + 
$i, 1, $cellValue);
 
  876        return $startrow + 
$i + 1;
 
  887        $this->image_filename = 
"";
 
  895        include_once(
"./Services/RTE/classes/class.ilRTE.php");
 
  905            'onenotcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), 
false)),
 
  906            'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), 
true))
 
  914                "answertext" => (
string) $answer_obj->getAnswertext(),
 
  915                "points" => (
float) $answer_obj->getPoints(),
 
  916                "points_unchecked" => (
float) $answer_obj->getPointsUnchecked(),
 
  917                "order" => (
int) $order,
 
  918                "coords" => $answer_obj->getCoords(),
 
  919                "state" => $answer_obj->getState(),
 
  920                "area" => $answer_obj->getArea(),
 
  921                "feedback" => $this->formatSAQuestion(
 
  922                    $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), 0, 
$key)
 
  942        if (count($found_values) > 0) {
 
  943            foreach ($this->answers as 
$key => $answer) {
 
  944                if (in_array(
$key, $found_values)) {
 
  945                    $points += $answer->getPoints();
 
  947                    $points += $answer->getPointsUnchecked();
 
  965        require_once 
"./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
 
  998        $maxStep = $this->lookupMaxStep($active_id, 
$pass);
 
 1000        if ($maxStep !== 
null) {
 
 1002                "SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step = %s",
 
 1003                array(
"integer", 
"integer", 
"integer", 
"integer"),
 
 1004                array($active_id, 
$pass, $this->
getId(), $maxStep)
 
 1008                "SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step IS NULL",
 
 1009                array(
"integer", 
"integer", 
"integer"),
 
 1046        $solution = parent::getTestOutputSolutions($activeId, 
$pass);
 
 1048        $this->currentSolution = array();
 
 1049        foreach ($solution as $record) {
 
 1050            $this->currentSolution[] = $record[
'value1'];
 
 1061        return $_GET[
"selImage"];
 
 1065        if (!isset(
$_GET[
"selImage"])) {
 
 1069        if (!strlen(
$_GET[
"selImage"])) {
 
 1081        return $_GET[
"remImage"];
 
 1085        if (!$this->is_multiple_choice) {
 
 1089        if (!isset(
$_GET[
"remImage"])) {
 
 1093        if (!strlen(
$_GET[
"remImage"])) {
 
 1113        if (!isset(
$_GET[
"reuseSelection"])) {
 
 1117        if (!strlen(
$_GET[
"reuseSelection"])) {
 
 1121        if (!preg_match(
'/\d(,\d)*/', 
$_GET[
"reuseSelection"])) {
 
Class for true/false or yes/no answers.
An exception for terminatinating execution or to throw for unit testing.
Class for image map questions.
getAvailableAnswerOptions($index=null)
If index is null, the function returns an array with all anwser options Else it returns the specific ...
createNewOriginalFromThisDuplicate($targetParentId, $targetQuestionTitle="")
getQuestionType()
Returns the question type of the question.
setIsMultipleChoice($is_multiple_choice)
Set true if the Imagemapquestion is a multiplechoice Question.
uploadImagemap(array $shapes)
Uploads an image map and takes over the areas.
flushAnswers()
Deletes all answers.
calculateReachedPointsFromPreviewSession(ilAssQuestionPreviewSession $previewSession)
toJSON()
Returns a JSON representation of the question.
isAddSolutionSelectionRequest()
duplicateImage($question_id, $objectId=null)
setImageFilename($image_filename, $image_tempfilename="")
Sets the image file name.
setExportDetailsXLS($worksheet, $startrow, $active_id, $pass)
{Creates an Excel worksheet for the detailed cumulated results of this question.object}
getAnswer($index=0)
Returns an answer.
getTestOutputSolutions($activeId, $pass)
getAnswerTableName()
Returns the name of the answer table in the database.
duplicate($for_test=true, $title="", $author="", $owner="", $testObjId=null)
Duplicates an assImagemapQuestion.
getExpressionTypes()
Get all available expression types for a specific question.
calculateReachedPoints($active_id, $pass=null, $authorizedSolution=true, $returndetails=false)
Returns the points, a learner has reached answering the question.
saveWorkingData($active_id, $pass=null, $authorized=true)
Saves the learners input of the question to the database.
copyObject($target_questionpool_id, $title="")
Copies an assImagemapQuestion object.
deleteImage()
Deletes the image file.
calculateReachedPointsForSolution($found_values)
isComplete()
Returns true, if a imagemap question is complete for use.
getOperators($expression)
Get all available operations for a specific question.
getRemoveSolutionSelectionParameter()
deleteArea($index=0)
Deletes an answer.
& getAnswers()
Returns the answer array.
saveAdditionalQuestionDataToDb()
Saves a record to the question types additional data table.
isReuseSolutionSelectionRequest()
getReuseSolutionSelectionParameter()
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
getAddSolutionSelectionParameter()
getAdditionalTableName()
Returns the name of the additional question data table in the database.
copyImage($question_id, $source_questionpool)
loadFromDb($question_id)
Loads a assImagemapQuestion object from a database.
__construct( $title="", $comment="", $author="", $owner=-1, $question="", $image_filename="")
assImagemapQuestion constructor
getRTETextWithMediaObjects()
Collects all text in the question which could contain media objects which were created with the Rich ...
saveAnswerSpecificDataToDb()
Saves the answer specific records into a question types answer table.
saveToDb($original_id="")
Saves an assImagemapQuestion object to a database.
addAnswer( $answertext="", $points=0.0, $order=0, $coords="", $area="", $points_unchecked=0.0)
Adds a possible answer for a imagemap question.
getAnswerCount()
Returns the number of answers.
get_imagemap_contents($href="#")
Gets the imagemap file contents.
getIsMultipleChoice()
Returns true, if the imagemap question is a multiplechoice question.
const MODE_MULTIPLE_CHOICE
isRemoveSolutionSelectionRequest()
savePreviewData(ilAssQuestionPreviewSession $previewSession)
Abstract basic class which is to be extended by the concrete assessment question type classes.
getCurrentSolutionResultSet($active_id, $pass, $authorized=true)
Get a restulset for the current user solution for a this question by active_id and pass.
getSolutionValues($active_id, $pass=null, $authorized=true)
Loads solutions of a given user from the database an returns it.
static _getOriginalId($question_id)
Returns the original id of a question.
formatSAQuestion($a_q)
Format self assessment question.
setId($id=-1)
Sets the id of the assQuestion object.
setOriginalId($original_id)
setObjId($obj_id=0)
Set the object id of the container object.
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
saveQuestionDataToDb($original_id="")
deleteSolutionRecordByValues($activeId, $passIndex, $authorized, $matchValues)
deleteDummySolutionRecord($activeId, $passIndex)
getId()
Gets the id of the assQuestion object.
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
getObjId()
Get the object id of the container object.
setTitle($title="")
Sets the title string of the assQuestion object.
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
setEstimatedWorkingTime($hour=0, $min=0, $sec=0)
Sets the estimated working time of a question from given hour, minute and second.
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
static explodeKeyValues($keyValues)
static logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
getImagePath($question_id=null, $object_id=null)
Returns the image path for web accessable images of a question.
removeCurrentSolution($active_id, $pass, $authorized=true)
setAuthor($author="")
Sets the authors name of the assQuestion object.
getTestPresentationConfig()
Get the test question configuration (initialised once)
forceExistingIntermediateSolution($activeId, $passIndex, $considerDummyRecordCreation)
getShuffle()
Gets the shuffle flag.
updateCurrentSolutionsAuthorization($activeId, $pass, $authorized, $keepTime=false)
getTitle()
Gets the title string of the assQuestion object.
setPoints($a_points)
Sets the maximum available points for the question.
setComment($comment="")
Sets the comment string of the assQuestion object.
setNrOfTries($a_nr_of_tries)
getQuestion()
Gets the question string of the question object.
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
setQuestion($question="")
Sets the question string of the question object.
getImagePathWeb()
Returns the web image path for web accessable images of a question.
ensureNonNegativePoints($points)
getParticipantsSolution()
setParticipantsSolution($participantSolution)
static _getLogLanguage()
retrieve the log language for assessment logging
static _enabledAssessmentLogging()
check wether assessment logging is enabled or not
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
static getOperatorsByExpression($expression)
static _replaceMediaObjectImageSrc($a_text, $a_direction=0, $nic=IL_INST_ID)
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Base Exception for all Exceptions relating to Modules/Test.
Class ilUserQuestionResult.
static makeDirParents($a_dir)
Create a new directory and all parent directories.
Class iQuestionCondition.
const PercentageResultExpression
getUserQuestionResult($active_id, $pass)
Get the user solution for a question by active_id and the test pass.
const EmptyAnswerExpression
const ExclusiveResultExpression
const NumberOfResultExpression
Interface ilObjAnswerScoringAdjustable.
Interface ilObjQuestionScoringAdjustable.
redirection script todo: (a better solution should control the processing via a xml file)