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';
73 $this->answers = array();
74 $this->coords = array();
105 if (strlen($this->title)
108 && ($this->image_filename)
109 && (count($this->answers))
138 $ilDB->manipulateF(
"DELETE FROM qpl_a_imagemap WHERE question_fi = %s",
140 array( $this->
getId() )
144 foreach ($this->answers as $key => $value)
146 $answer_obj = $this->answers[$key];
147 $next_id =
$ilDB->nextId(
'qpl_a_imagemap' );
148 $ilDB->manipulateF(
"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)",
149 array(
"integer",
"integer",
"text",
"float",
"integer",
"text",
"text",
"float" ),
150 array( $next_id, $this->
id, $answer_obj->getAnswertext(
151 ), $answer_obj->getPoints(), $answer_obj->getOrder(
152 ), $answer_obj->getCoords(), $answer_obj->getArea(
153 ), $answer_obj->getPointsUnchecked() )
164 array( $this->
getId() )
168 ) .
" (question_fi, image_file, is_multiple_choice) VALUES (%s, %s, %s)",
169 array(
"integer",
"text",
'integer' ),
172 $this->image_filename,
173 (
int)$this->is_multiple_choice
191 $this_id = $this->
getId();
195 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
199 if( (
int)$testObjId > 0 )
201 $clone->setObjId($testObjId);
226 $clone->copyPageOfQuestion($this_id);
228 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
230 $clone->duplicateImage($this_id, $thisObjId);
232 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
253 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
256 $source_questionpool_id = $this->
getObjId();
257 $clone->setObjId($target_questionpool_id);
269 $clone->copyImage(
$original_id, $source_questionpool_id);
271 $clone->onCopy($source_questionpool_id,
$original_id, $clone->getObjId(), $clone->getId());
284 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
287 $sourceParentId = $this->
getObjId();
293 $clone->setObjId($targetParentId);
295 if ($targetQuestionTitle)
297 $clone->setTitle($targetQuestionTitle);
302 $clone->copyPageOfQuestion($sourceQuestionId);
304 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
306 $clone->copyImage($sourceQuestionId, $sourceParentId);
308 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
318 $imagepath_original = str_replace(
"/$this->id/images",
"/$question_id/images", $imagepath);
320 if( (
int)$objectId > 0 )
322 $imagepath_original = str_replace(
"/$this->obj_id/",
"/$objectId/", $imagepath_original);
325 if(!file_exists($imagepath))
332 if(!file_exists($imagepath_original .
$filename))
334 $ilLog->write(
"Could not find an image map file when trying to duplicate image: " . $imagepath_original .
$filename);
335 $imagepath_original = str_replace(
"/$this->obj_id/",
"/$objectId/", $imagepath_original);
336 $ilLog->write(
"Using fallback source directory:" . $imagepath_original);
341 $ilLog->write(
"Could not duplicate image for image map question: " . $imagepath_original .
$filename);
348 $imagepath_original = str_replace(
"/$this->id/images",
"/$question_id/images", $imagepath);
349 $imagepath_original = str_replace(
"/$this->obj_id/",
"/$source_questionpool/", $imagepath_original);
350 if (!file_exists($imagepath))
357 print "image could not be copied!!!! ";
381 $this->
setId($question_id);
391 include_once(
"./Services/RTE/classes/class.ilRTE.php");
404 $result =
$ilDB->queryF(
"SELECT * FROM qpl_a_imagemap WHERE question_fi = %s ORDER BY aorder ASC",
408 include_once
"./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
417 parent::loadFromDb($question_id);
430 if(count($shapes) > 0)
432 foreach($shapes as $shape)
434 $this->
addAnswer($shape->getAnswertext(), 0.0, count($this->answers), $shape->getCoords(), $shape->getArea());
461 if (!empty($image_tempfilename))
464 if (!file_exists($imagepath))
470 $this->
ilias->raiseError(
"The image could not be uploaded!", $this->
ilias->error_obj->MESSAGE);
472 global
$ilLog;
$ilLog->write(
"gespeichert: " . $imagepath.$image_filename);
487 for ($i = 0; $i < count($this->answers); $i++) {
491 $imagemap_contents .=
"href=\"$href&selimage=" . $this->answers[$i]->getOrder() .
"\" /> ";
517 $points_unchecked = 0.0
520 include_once
"./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
521 if (array_key_exists($order, $this->answers))
525 for ($i = count($this->answers) - 1; $i >= $order; $i--)
527 $this->answers[$i+1] = $this->answers[$i];
528 $this->answers[$i+1]->setOrder($i+1);
530 $this->answers[$order] = $answer;
536 array_push($this->answers, $answer);
550 return count($this->answers);
565 if ($index < 0)
return NULL;
566 if (count($this->answers) < 1)
return NULL;
567 if ($index >= count($this->answers))
return NULL;
568 return $this->answers[$index];
597 if ($index < 0)
return;
598 if (count($this->answers) < 1)
return;
599 if ($index >= count($this->answers))
return;
600 unset($this->answers[$index]);
601 $this->answers = array_values($this->answers);
602 for ($i = 0; $i < count($this->answers); $i++) {
603 if ($this->answers[$i]->getOrder() > $index) {
604 $this->answers[$i]->setOrder($i);
618 $this->answers = array();
631 foreach ($this->answers as $key => $value) {
632 if($this->is_multiple_choice)
634 if($value->getPoints() > $value->getPointsUnchecked())
636 $points += $value->getPoints();
640 $points += $value->getPointsUnchecked();
645 if($value->getPoints() >
$points)
668 throw new ilTestException(
'return details not implemented for '.__METHOD__);
673 $found_values = array();
681 if (strcmp(
$data[
"value1"],
"") != 0)
683 array_push($found_values,
$data[
"value1"]);
721 include_once
"./Modules/Test/classes/class.ilObjTest.php";
725 $solutionSelectionChanged =
false;
727 $this->
getProcessLocker()->executeUserSolutionUpdateLockOperation(
function() use (&$solutionSelectionChanged,
$ilDB, $active_id,
$pass, $authorized) {
738 $solutionSelectionChanged =
true;
743 $active_id,
$pass, $this->is_multiple_choice
750 foreach($selection as $selectedIndex)
753 $solutionSelectionChanged =
true;
761 'value1' => (
int)$selection
764 $solutionSelectionChanged =
true;
770 if( $this->is_multiple_choice )
773 'value1' => (
int)
$_GET[
'selImage']
783 $solutionSelectionChanged =
true;
788 require_once
'Modules/Test/classes/class.ilObjAssessmentFolder.php';
791 if( $solutionSelectionChanged )
808 if( $this->is_multiple_choice && strlen(
$_GET[
'remImage']) )
810 unset($solution[(
int)
$_GET[
'remImage']]);
813 if( strlen(
$_GET[
'selImage']) )
815 if( !$this->is_multiple_choice )
820 $solution[(int)
$_GET[
'selImage']] = (
int)
$_GET[
'selImage'];
838 parent::syncWithOriginal();
852 return "assImagemapQuestion";
865 return "qpl_qst_imagemap";
878 return "qpl_a_imagemap";
887 $text = parent::getRTETextWithMediaObjects();
888 foreach ($this->answers as $index => $answer)
890 $text .= $this->feedbackOBJ->getSpecificAnswerFeedbackContent($this->
getId(), $index);
907 $worksheet->setCell($startrow + $i, 0, $answer->getArea() .
": " . $answer->getCoords());
911 foreach($solution as $solIndex => $sol)
913 if( $sol[
'value1'] ==
$id )
920 $worksheet->setCell($startrow + $i, 1, $cellValue);
925 return $startrow + $i + 1;
936 $this->image_filename =
"";
944 include_once(
"./Services/RTE/classes/class.ilRTE.php");
954 'onenotcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
false)),
955 'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
true))
961 foreach ($this->
getAnswers() as $key => $answer_obj)
964 "answertext" => (
string)$answer_obj->getAnswertext(),
965 "points" => (
float)$answer_obj->getPoints(),
966 "points_unchecked" => (
float)$answer_obj->getPointsUnchecked(),
967 "order" => (
int)$order,
968 "coords" => $answer_obj->getCoords(),
969 "state" => $answer_obj->getState(),
970 "area" => $answer_obj->getArea(),
971 "feedback" => $this->formatSAQuestion(
972 $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), $key)
992 if(count($found_values) > 0)
994 foreach($this->answers as $key => $answer)
996 if(in_array($key, $found_values))
998 $points += $answer->getPoints();
1001 $points += $answer->getPointsUnchecked();
1019 require_once
"./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1051 $maxStep = $this->lookupMaxStep($active_id,
$pass);
1053 if( $maxStep !==
null )
1055 $data =
$ilDB->queryF(
"SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step = %s",
1056 array(
"integer",
"integer",
"integer",
"integer"),
1057 array($active_id,
$pass, $this->
getId(), $maxStep)
1062 $data =
$ilDB->queryF(
"SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step IS NULL",
1063 array(
"integer",
"integer",
"integer"),
1104 $solution = parent::getTestOutputSolutions($activeId,
$pass);
1106 $this->currentSolution = array();
1107 foreach($solution as $record)
1109 $this->currentSolution[] = $record[
'value1'];
1121 return $_GET[
"selImage"];
1125 if( !isset(
$_GET[
"selImage"]) )
1130 if( !strlen(
$_GET[
"selImage"]) )
1144 return $_GET[
"remImage"];
1148 if( !$this->is_multiple_choice )
1153 if( !isset(
$_GET[
"remImage"]) )
1158 if( !strlen(
$_GET[
"remImage"]) )
1181 if( !isset(
$_GET[
"reuseSelection"]) )
1186 if( !strlen(
$_GET[
"reuseSelection"]) )
1191 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.
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()
saveWorkingData($active_id, $pass=NULL, $authorized=true)
Saves the learners input of the question to the database.
calculateReachedPoints($active_id, $pass=NULL, $authorizedSolution=true, $returndetails=FALSE)
Returns the points, a learner has reached answering the question.
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.
reworkWorkingData($active_id, $pass, $obligationsAnswered, $authorized)
{Reworks the allready saved working data if neccessary.}
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.
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)
getSolutionValues($active_id, $pass=NULL, $authorized=true)
Loads solutions of a given user from the database an returns it.
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 moveUploadedFile($a_file, $a_name, $a_target, $a_raise_errors=true, $a_mode="move_uploaded")
move uploaded file
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)
if(!file_exists("$old.txt")) if( $old===$new) if(file_exists("$new.txt")) $file