Class for ordering questions. More...

Inheritance diagram for assOrderingQuestion:

Collaboration diagram for assOrderingQuestion:

Public Member Functions
	__construct (string $title="", string $comment="", string $author="", int $owner=-1, string $question="", protected int $ordering_type=self::OQ_TERMS)

	isComplete ()

	saveToDb (?int $original_id=null)

	loadFromDb ($question_id)
	Loads a assOrderingQuestion object from a database. More...

	cloneImages (int $source_question_id, int $source_parent_id, int $target_question_id, int $target_parent_id)

	setOrderingType (int $ordering_type=self::OQ_TERMS)

	getOrderingType ()

	isOrderingTypeNested ()

	isImageOrderingType ()

	setContentType ($ct)

	setNestingType (bool $nesting)

	hasOrderingTypeUploadSupport ()

	getOrderingElementListForSolutionOutput (bool $force_correct_solution, int $active_id, ?int $pass_index)

	getSolutionOrderingElementListForTestOutput (ilAssNestedOrderingElementsInputGUI $input_gui, array $last_post, int $active_id, int $pass)

	getSolutionOrderingElementList (array $indexed_solution_values)

	getShuffledOrderingElementList ()

	getOrderingElementList ()

	setOrderingElementList (ilAssOrderingElementList $list)

	getAnswer (int $index=0)
	Returns the ordering element from the given position. More...

	deleteAnswer (int $random_identifier)

	getAnswerCount ()

	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)

	getMaximumPoints ()

	getEncryptedFilename ($filename)

	dropImageFile ($imageFilename)

	isImageFileStored ($imageFilename)

	isImageReplaced (ilAssOrderingElement $newElement, ilAssOrderingElement $oldElement)

	storeImageFile (string $upload_file, string $upload_name)

	updateImageFile (string $existing_image_name)

	validateSolutionSubmit ()

	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)

	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...

	saveAnswerSpecificDataToDb ()
	Saves the answer specific records into a question types answer table. More...

	getQuestionType ()
	Returns the question type of the question. More...

	getAdditionalTableName ()
	Returns the name of the additional question data table in the database. More...

	getAnswerTableName ()
	Returns the name of the answer table in the database. More...

	getRTETextWithMediaObjects ()
	Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More...

	getOrderElements ()
	Returns the answers array. More...

	getElementHeight ()

	setElementHeight (?int $a_height)

	rebuildThumbnails ()

	getThumbPrefix ()

	toJSON ()
	Returns a JSON representation of the question. More...

	buildOrderingElementInputGui ()

	initOrderingElementAuthoringProperties (ilFormPropertyGUI $formField)

	initOrderingElementFormFieldLabels (ilFormPropertyGUI $formField)

	buildOrderingTextsInputGui ()

	buildOrderingImagesInputGui ()

	buildNestedOrderingElementInputGui ()

	fetchSolutionListFromFormSubmissionData (array $user_solution_post)

	getSolutionListFromPostSubmit ()

	getOperators (string $expression)
	Get all available operations for a specific question. More...

	getExpressionTypes ()
	Get all available expression types for a specific question. More...

	getUserQuestionResult (int $active_id, int $pass)
	Get the user solution for a question by active_id and the test pass. More...

	getAvailableAnswerOptions ($index=null)
	If index is null, the function returns an array with all anwser options Else it returns the specific answer option. More...

	buildTestPresentationConfig ()
	Get the test question configuration. More...

	fetchSolutionSubmit (array $form_submission_data_structure)

	toLog (AdditionalInformationGenerator $additional_info)

	solutionValuesToText (array $solution_values)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

Public Member Functions inherited from assQuestion
	getQuestionType ()

	isComplete ()

	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)

	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)

	getAdditionalTableName ()

	getAnswerTableName ()

	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...

	getCurrentUser ()

	getShuffler ()

	setShuffler (Transformation $shuffler)

	setProcessLocker (ilAssQuestionProcessLocker $processLocker)

	getProcessLocker ()

	fromXML (string $importdirectory, int $user_id, ilQTIItem $item, int $questionpool_id, ?int $tst_id, ?ilObject &$tst_object, int &$question_counter, array $import_mapping, array $solutionhints=[])

	toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $force_image_references=false)
	Returns a QTI xml representation of the question. More...

	setTitle (string $title="")

	setId (int $id=-1)

	setTestId (int $id=-1)

	setComment (string $comment="")

	setShuffle (?bool $shuffle=true)

	setAuthor (string $author="")

	setOwner (int $owner=-1)

	getTitle ()

	getTitleForHTMLOutput ()

	getTitleFilenameCompliant ()

	getId ()

	getShuffle ()

	getTestId ()

	getComment ()

	getDescriptionForHTMLOutput ()

	getThumbSize ()

	setThumbSize (int $a_size)

	getMinimumThumbSize ()

	getMaximumThumbSize ()

	getAuthor ()

	getAuthorForHTMLOutput ()

	getOwner ()

	getObjId ()

	setObjId (int $obj_id=0)

	getLifecycle ()

	setLifecycle (ilAssQuestionLifecycle $lifecycle)

	setExternalId (?string $external_id)

	getExternalId ()

	getSuggestedSolutionOutput ()

	getSuggestedSolutions ()

	getReachedPoints (int $active_id, int $pass)

	getMaximumPoints ()

	getAdjustedReachedPoints (int $active_id, int $pass, bool $authorized_solution=true)

	calculateResultsFromSolution (int $active_id, int $pass)
	Calculates the question results from a previously saved question solution. More...

	persistWorkingState (int $active_id, $pass, bool $authorized=true)
	persists the working state for current testactive and testpass More...

	persistPreviewState (ilAssQuestionPreviewSession $preview_session)
	persists the preview state for current user and question More...

	validateSolutionSubmit ()

	getSuggestedSolutionPath ()

	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...

	getSuggestedSolutionPathWeb ()

	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...

	getTestOutputSolutions (int $activeId, int $pass)

	getUserSolutionPreferingIntermediate (int $active_id, ?int $pass=null)

	getSolutionValues (int $active_id, ?int $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. More...

	deleteAnswers (int $question_id)

	deleteAdditionalTableData (int $question_id)

	delete (int $question_id)

	getTotalAnswers ()

	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)

	createPageObject ()

	clonePageOfQuestion (int $a_q_id)

	getPageOfQuestion ()

	setOriginalId (?int $original_id)

	getOriginalId ()

static	fixSvgToPng (string $imageFilenameContainingString)

	fixUnavailableSkinImageSources (string $html)

	loadFromDb (int $question_id)

	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...

	saveQuestionDataToDb (?int $original_id=null)

	duplicate (bool $for_test=true, string $title='', string $author='', int $owner=-1, $test_obj_id=null)

	copyObject (int $target_parent_id, string $title='')

	createNewOriginalFromThisDuplicate (int $target_parent_id, string $target_question_title='')

	saveToDb (?int $original_id=null)

	deleteSuggestedSolutions ()

	getSuggestedSolution (int $subquestion_index=0)

	resolveInternalLink (string $internal_link)

	resolveSuggestedSolutionLinks ()

	getInternalLinkHref (string $target)

	syncWithOriginal ()

	getPoints ()

	setPoints (float $points)

	getSolutionMaxPass (int $active_id)

	isWriteable ()

	deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $preview_session, $reached_points)

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)

	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)

	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...

	buildHashedImageFilename (string $plain_image_filename, bool $unique=false)

	getQuestion ()

	getQuestionForHTMLOutput ()

	setQuestion (string $question="")

	getQuestionTypeID ()

	cloneHints (int $source_question_id, int $target_question_id)

	cleanupMediaObjectUsage ()

	getInstances ()

	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...

	hasSpecificFeedback ()

	getNrOfTries ()

	setNrOfTries (int $a_nr_of_tries)

	setExportImagePath (string $path)

	formatSAQuestion ($a_q)

	setPreventRteUsage (bool $prevent_rte_usage)

	getPreventRteUsage ()

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)

	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)

	getSelfAssessmentEditingMode ()

	setDefaultNrOfTries (int $defaultnroftries)

	getDefaultNrOfTries ()

	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)

	ensureHintPageObjectExists ($pageObjectId)

	isAnswered (int $active_id, int $pass)

	getAdditionalContentEditingMode ()

	setAdditionalContentEditingMode (?string $additionalContentEditingMode)

	isAdditionalContentEditingModePageObject ()

	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)

	getValidAdditionalContentEditingModes ()

	getHtmlUserSolutionPurifier ()

	getHtmlQuestionContentPurifier ()

	setLastChange (int $lastChange)

	getLastChange ()

	removeIntermediateSolution (int $active_id, int $pass)

	removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)

	saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)

	updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)

	updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)

	setStep ($step)

	getStep ()

	toJSON ()

	intermediateSolutionExists (int $active_id, int $pass)

	authorizedSolutionExists (int $active_id, ?int $pass)

	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)

	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...

	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)

	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)

	removeAllExistingSolutions ()

	removeExistingSolutions (int $activeId, int $pass)

	resetUsersAnswer (int $activeId, int $pass)

	removeResultRecord (int $activeId, int $pass)

	fetchValuePairsFromIndexedValues (array $indexedValues)

	fetchIndexedValuesFromValuePairs (array $value_pairs)

	updateTimestamp ()

	getTestPresentationConfig ()

	hasWritableOriginalInQuestionPool ()

	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)

	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, TestQuestionAdministrationInteractionTypes $interaction_type)

	getSolutionForTextOutput (int $active_id, int $pass)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

	getVariablesAsTextArray (int $active_id, int $pass)

Public Member Functions inherited from iQuestionCondition
	getAvailableAnswerOptions (?int $index=null)
	If index is null, the function returns an array with all anwser options else it returns the specific answer option. More...

Data Fields
const	ORDERING_ELEMENT_FORM_FIELD_POSTVAR = 'order_elems'

const	ORDERING_ELEMENT_FORM_CMD_UPLOAD_IMG = 'uploadElementImage'

const	ORDERING_ELEMENT_FORM_CMD_REMOVE_IMG = 'removeElementImage'

const	OQ_PICTURES = 0

const	OQ_TERMS = 1

const	OQ_NESTED_PICTURES = 2

const	OQ_NESTED_TERMS = 3

const	OQ_CT_PICTURES = 'pics'

const	OQ_CT_TERMS = 'terms'

const	VALID_UPLOAD_SUFFIXES = ["jpg", "jpeg", "png", "gif"]

int	$element_height = null

	$old_ordering_depth = []

	$leveled_ordering = []

Data Fields inherited from assQuestion
const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

const	TRIM_PATTERN = '/^[\p{C}\p{Z}]+\|[\p{C}\p{Z}]+$/u'

ilAssQuestionFeedback	$feedbackOBJ

bool	$prevent_rte_usage = false

bool	$selfassessmenteditingmode = false

int	$defaultnroftries = 0

string	$questionActionCmd = 'handleQuestionAction'

const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Data Fields inherited from iQuestionCondition
const	StringResultExpression = '~TEXT~'

const	PercentageResultExpression = '%n%'

const	NumericResultExpression = '#n#'

const	MatchingResultExpression = ';n:m;'

const	OrderingResultExpression = '$n,m,o,p$'

const	NumberOfResultExpression = '+n+'

const	ExclusiveResultExpression = 'n,m,o,p'

const	EmptyAnswerExpression = "?"

Protected Member Functions
	getRepository ()

	cloneQuestionTypeSpecificProperties (\assQuestion $target)

	getValidOrderingTypes ()

	getSolutionValuePairBrandedOrderingElementByRandomIdentifier (int $value1, string $value2)

	getSolutionValuePairBrandedOrderingElementBySolutionIdentifier (int $value1, string $value2)

	cleanImagefiles ()

	savePreviewData (ilAssQuestionPreviewSession $previewSession)

	getQuestionRepository ()

	generateThumbForFile ($path, $file)

	calculateReachedPointsForSolution (ilAssOrderingElementList $solution_ordering_element_list)

	ensureImagePathExists ()

	buildOrderingElementFormDataConverter ()

	buildOrderingImagesFormDataConverter ()

	buildOrderingTextsFormDataConverter ()

	buildNestedOrderingFormDataConverter ()

	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)

Protected Member Functions inherited from assQuestion
	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...

	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...

	getQuestionAction ()

	isNonEmptyItemListPostSubmission (string $post_submission_field_name)

	savePreviewData (ilAssQuestionPreviewSession $preview_session)

	deletePageOfQuestion (int $question_id)

	cloneQuestionTypeSpecificProperties (self $target)

	removeAllImageFiles (string $image_target_path)

	onDuplicate (int $original_parent_id, int $original_question_id, int $duplicate_parent_id, int $duplicate_question_id)

	afterSyncWithOriginal (int $original_question_id, int $clone_question_id, int $original_parent_id, int $clone_parent_id)

	onCopy (int $sourceParentId, int $sourceQuestionId, int $targetParentId, int $targetQuestionId)

	duplicateComments (int $parent_source_id, int $source_id, int $parent_target_id, int $target_id)

	deleteComments ()

	getNotesManager ()

	getNotesDataService ()

	getNotesRepo ()

	cloneSuggestedSolutions (int $source_question_id, int $target_question_id)

	duplicateSuggestedSolutionFiles (int $parent_id, int $question_id)
	Duplicates the files of a suggested solution if the question is duplicated. More...

	cloneSuggestedSolutionFiles (int $source_question_id, int $target_question_id)

	copySuggestedSolutions (int $target_question_id)

	ensureNonNegativePoints (float $points)

	purifyAndPrepareTextAreaOutput (string $content)

	getRTETextWithMediaObjects ()

	getSelfAssessmentFormatter ()

	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

	duplicateQuestionHints (int $original_question_id, int $duplicate_question_id)

	duplicateSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)

	buildQuestionDataQuery ()

	getCurrentSolutionResultSet (int $active_id, int $pass, bool $authorized=true)

	removeSolutionRecordById (int $solutionId)

	getSolutionRecordById (int $solutionId)

	deleteDummySolutionRecord (int $activeId, int $passIndex)

	isDummySolutionRecord (array $solutionRecord)

	deleteSolutionRecordByValues (int $activeId, int $passIndex, bool $authorized, array $matchValues)

	duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex)

	forceExistingIntermediateSolution (int $activeId, int $passIndex, bool $considerDummyRecordCreation)

	lookupMaxStep (int $active_id, int $pass)

	buildTestPresentationConfig ()

	getSuggestedSolutionsRepo ()

	loadSuggestedSolutions ()

	answerToLog (AdditionalInformationGenerator $additional_info, int $active_id, int $pass)

Protected Attributes
const	HAS_SPECIFIC_FEEDBACK = false

OQRepository	$oq_repository = null

ilAssOrderingElementList	$element_list_for_deferred_saving = null

Protected Attributes inherited from assQuestion
const	HAS_SPECIFIC_FEEDBACK = true

GeneralQuestionPropertiesRepository	$questionrepository

RequestDataCollector	$questionpool_request

QuestionFiles	$question_files

ilAssQuestionProcessLocker	$processLocker

ilTestQuestionConfig	$testQuestionConfig

SuggestedSolutionsDatabaseRepository	$suggestedsolution_repo

ILIAS	$ilias

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

ilDBInterface	$db

ilObjUser	$current_user

SkillUsageService	$skillUsageService

HTTPServices	$http

Refinery	$refinery

Transformation	$shuffler

LoggingServices	$log

Container	$dic

ilAssQuestionLifecycle	$lifecycle

ilAssQuestionPage	$page

int	$id

string	$title

string	$comment

int	$owner

string	$author

int	$thumb_size

string	$question

float	$points = 0.0

bool	$shuffle = true

int	$test_id

int	$obj_id = 0

int	$original_id = null

int	$lastChange = null

string	$external_id = null

int	$step = null

array	$suggested_solutions

Private Member Functions
	getOrderingTypeLangVars (int $ordering_type)

	getSolutionOutputForLog ()

	getElementArrayWithIdentationsForTextOutput (array $elements)

Private Attributes
ilAssOrderingElementList	$postSolutionOrderingElementList = null

Additional Inherited Members
Static Public Member Functions inherited from assQuestion
static	setForcePassResultUpdateEnabled (bool $force_pass_results_update_enabled)

static	isForcePassResultUpdateEnabled ()

static	_getSuggestedSolutionOutput (int $question_id)

static	_getReachedPoints (int $active_id, int $question_id, int $pass)

static	isFileAvailable (string $file)

static	saveOriginalId (int $questionId, int $originalId)

static	resetOriginalId (int $questionId)

static	instantiateQuestion (int $question_id)

static	_getSolutionMaxPass (int $question_id, int $active_id)
	Returns the maximum pass a users question solution. More...

static	getFeedbackClassNameByQuestionType (string $questionType)

static	_questionExistsInTest (int $question_id, int $test_id)

static	lookupParentObjId (int $question_id)

static	implodeKeyValues (array $keyValues)

static	explodeKeyValues (string $keyValues)

static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)

static	extendedTrim (string $value)
	Trim non-printable characters from the beginning and end of a string. More...

Static Protected Member Functions inherited from assQuestion
static	getNumExistingSolutionRecords (int $activeId, int $pass, int $questionId)

Static Protected Attributes inherited from assQuestion
static	$force_pass_results_update_enabled = false

static	$imageSourceFixReplaceMap

Detailed Description

Class for ordering questions.

assOrderingQuestion is a class for ordering questions.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de; Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de; Nils Haagen nils..nosp@m.haag.nosp@m.en@co.nosp@m.ncep.nosp@m.ts-an.nosp@m.d-tr.nosp@m.ainin.nosp@m.g.de

Version: $Id$

\

Definition at line 40 of file class.assOrderingQuestion.php.

Constructor & Destructor Documentation

◆ __construct()

assOrderingQuestion::__construct	(	string	$title = `""`,
		string	$comment = `""`,
		string	$author = `""`,
		int	$owner = `-1`,
		string	$question = `""`,
		protected int	$ordering_type = `self::OQ_TERMS`
	)

Definition at line 65 of file class.assOrderingQuestion.php.

References assQuestion\$author, assQuestion\$comment, assQuestion\$owner, assQuestion\$question, assQuestion\$title, and ILIAS\GlobalScreen\Provider\__construct().

       {
         parent::__construct($title, $comment, $author, $owner, $question);
     }

Here is the call graph for this function:

Member Function Documentation

◆ buildNestedOrderingElementInputGui()

assOrderingQuestion::buildNestedOrderingElementInputGui ( )

Returns: ilAssNestedOrderingElementsInputGUI

Definition at line 960 of file class.assOrderingQuestion.php.

References buildNestedOrderingFormDataConverter(), assQuestion\getId(), assQuestion\getImagePathWeb(), getOrderingType(), getThumbPrefix(), and initOrderingElementFormFieldLabels().

Referenced by fetchSolutionListFromFormSubmissionData(), and getSolutionOutputForLog().

                                                         : ilAssNestedOrderingElementsInputGUI
     {
         $form_data_converter = $this->buildNestedOrderingFormDataConverter();
 
         $ordering_element_input = new ilAssNestedOrderingElementsInputGUI(
             $form_data_converter,
             self::ORDERING_ELEMENT_FORM_FIELD_POSTVAR
         );
 
         $ordering_element_input->setUniquePrefix($this->getId());
         $ordering_element_input->setOrderingType($this->getOrderingType());
         $ordering_element_input->setElementImagePath($this->getImagePathWeb());
         $ordering_element_input->setThumbPrefix($this->getThumbPrefix());
 
         $this->initOrderingElementFormFieldLabels($ordering_element_input);
 
         return $ordering_element_input;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNestedOrderingFormDataConverter()

assOrderingQuestion::buildNestedOrderingFormDataConverter ( )

protected

Returns: ilAssOrderingFormValuesObjectsConverter

Definition at line 1247 of file class.assOrderingQuestion.php.

References buildOrderingElementFormDataConverter(), ilAssOrderingFormValuesObjectsConverter\CONTEXT_MAINTAIN_HIERARCHY, assQuestion\getImagePathWeb(), getOrderingType(), and getThumbPrefix().

Referenced by buildNestedOrderingElementInputGui().

                                                              : ilAssOrderingFormValuesObjectsConverter
     {
         $form_data_converter = $this->buildOrderingElementFormDataConverter();
         $form_data_converter->setContext(ilAssOrderingFormValuesObjectsConverter::CONTEXT_MAINTAIN_HIERARCHY);
 
         if ($this->getOrderingType() === self::OQ_NESTED_PICTURES) {
             $form_data_converter->setImageRemovalCommand(self::ORDERING_ELEMENT_FORM_CMD_REMOVE_IMG);
             $form_data_converter->setImageUrlPath($this->getImagePathWeb());
             $form_data_converter->setThumbnailPrefix($this->getThumbPrefix());
         }
 
         return $form_data_converter;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildOrderingElementFormDataConverter()

assOrderingQuestion::buildOrderingElementFormDataConverter ( )

protected

Returns: ilAssOrderingFormValuesObjectsConverter

Definition at line 1208 of file class.assOrderingQuestion.php.

Referenced by buildNestedOrderingFormDataConverter(), buildOrderingImagesFormDataConverter(), and buildOrderingTextsFormDataConverter().

                                                               : ilAssOrderingFormValuesObjectsConverter
     {
         $converter = new ilAssOrderingFormValuesObjectsConverter();
         $converter->setPostVar(self::ORDERING_ELEMENT_FORM_FIELD_POSTVAR);
 
         return $converter;
     }

Here is the caller graph for this function:

◆ buildOrderingElementInputGui()

assOrderingQuestion::buildOrderingElementInputGui ( )

Returns: ilAssNestedOrderingElementsInputGUI|ilAssOrderingImagesInputGUI|ilAssOrderingTextsInputGUI

Exceptions

ilTestQuestionPoolException

Definition at line 882 of file class.assOrderingQuestion.php.

References buildOrderingImagesInputGui(), buildOrderingTextsInputGui(), and isImageOrderingType().

Referenced by ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput().

     {
         if ($this->isImageOrderingType()) {
             return $this->buildOrderingImagesInputGui();
         }
         return $this->buildOrderingTextsInputGui();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildOrderingImagesFormDataConverter()

assOrderingQuestion::buildOrderingImagesFormDataConverter ( )

protected

Returns: ilAssOrderingFormValuesObjectsConverter

Definition at line 1219 of file class.assOrderingQuestion.php.

References buildOrderingElementFormDataConverter(), ilAssOrderingFormValuesObjectsConverter\CONTEXT_MAINTAIN_ELEMENT_IMAGE, assQuestion\getImagePath(), assQuestion\getImagePathWeb(), and getThumbPrefix().

Referenced by buildOrderingImagesInputGui().

                                                              : ilAssOrderingFormValuesObjectsConverter
     {
         $formDataConverter = $this->buildOrderingElementFormDataConverter();
         $formDataConverter->setContext(ilAssOrderingFormValuesObjectsConverter::CONTEXT_MAINTAIN_ELEMENT_IMAGE);
 
         $formDataConverter->setImageRemovalCommand(self::ORDERING_ELEMENT_FORM_CMD_REMOVE_IMG);
         $formDataConverter->setImageUrlPath($this->getImagePathWeb());
         $formDataConverter->setImageFsPath($this->getImagePath());
 
         if ($this->getThumbPrefix()) {
             $formDataConverter->setThumbnailPrefix($this->getThumbPrefix());
         }
         return $formDataConverter;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildOrderingImagesInputGui()

assOrderingQuestion::buildOrderingImagesInputGui ( )

Returns: ilAssOrderingImagesInputGUI

Definition at line 940 of file class.assOrderingQuestion.php.

References buildOrderingImagesFormDataConverter(), and initOrderingElementFormFieldLabels().

Referenced by buildOrderingElementInputGui().

                                                  : ilAssOrderingImagesInputGUI
     {
         $formDataConverter = $this->buildOrderingImagesFormDataConverter();
 
         $orderingElementInput = new ilAssOrderingImagesInputGUI(
             $formDataConverter,
             self::ORDERING_ELEMENT_FORM_FIELD_POSTVAR
         );
 
         $orderingElementInput->setImageUploadCommand(self::ORDERING_ELEMENT_FORM_CMD_UPLOAD_IMG);
         $orderingElementInput->setImageRemovalCommand(self::ORDERING_ELEMENT_FORM_CMD_REMOVE_IMG);
 
         $this->initOrderingElementFormFieldLabels($orderingElementInput);
 
         return $orderingElementInput;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildOrderingTextsFormDataConverter()

assOrderingQuestion::buildOrderingTextsFormDataConverter ( )

protected

Returns: ilAssOrderingFormValuesObjectsConverter

Definition at line 1237 of file class.assOrderingQuestion.php.

References buildOrderingElementFormDataConverter(), and ilAssOrderingFormValuesObjectsConverter\CONTEXT_MAINTAIN_ELEMENT_TEXT.

Referenced by buildOrderingTextsInputGui().

                                                             : ilAssOrderingFormValuesObjectsConverter
     {
         $form_data_converter = $this->buildOrderingElementFormDataConverter();
         $form_data_converter->setContext(ilAssOrderingFormValuesObjectsConverter::CONTEXT_MAINTAIN_ELEMENT_TEXT);
         return $form_data_converter;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildOrderingTextsInputGui()

assOrderingQuestion::buildOrderingTextsInputGui ( )

Returns: ilAssOrderingTextsInputGUI

Definition at line 923 of file class.assOrderingQuestion.php.

References buildOrderingTextsFormDataConverter(), and initOrderingElementFormFieldLabels().

Referenced by buildOrderingElementInputGui().

                                                 : ilAssOrderingTextsInputGUI
     {
         $formDataConverter = $this->buildOrderingTextsFormDataConverter();
 
         $orderingElementInput = new ilAssOrderingTextsInputGUI(
             $formDataConverter,
             self::ORDERING_ELEMENT_FORM_FIELD_POSTVAR
         );
 
         $this->initOrderingElementFormFieldLabels($orderingElementInput);
 
         return $orderingElementInput;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildTestPresentationConfig()

assOrderingQuestion::buildTestPresentationConfig ( )

Get the test question configuration.

Returns: ilTestQuestionConfig

Definition at line 1131 of file class.assOrderingQuestion.php.

References ILIAS\Repository\lng(), and ilTestQuestionConfig\setIsUnchangedAnswerPossible().

                                                  : ilTestQuestionConfig
     // hey.
     {
         // hey: refactored identifiers
         return parent::buildTestPresentationConfig()
         // hey.
             ->setIsUnchangedAnswerPossible(true)
             ->setUseUnchangedAnswerLabel($this->lng->txt('tst_unchanged_order_is_correct'));
     }

Here is the call graph for this function:

◆ calculateReachedPoints()

assOrderingQuestion::calculateReachedPoints	(	int	$active_id,
		?int	$pass = `null`,
		bool	$authorized_solution = `true`
	)

Definition at line 472 of file class.assOrderingQuestion.php.

References calculateReachedPointsForSolution(), assQuestion\fetchIndexedValuesFromValuePairs(), assQuestion\getSolutionMaxPass(), getSolutionOrderingElementList(), and assQuestion\getSolutionValues().

Referenced by getUserQuestionResult().

      : float {
         if ($pass === null) {
             $pass = $this->getSolutionMaxPass($active_id);
         }
 
         $solution_value_pairs = $this->getSolutionValues($active_id, $pass, $authorized_solution);
 
         if ($solution_value_pairs === []) {
             return 0.0;
         }
 
         $solution_ordering_element_list = $this->getSolutionOrderingElementList(
             $this->fetchIndexedValuesFromValuePairs($solution_value_pairs)
         );
 
         return $this->calculateReachedPointsForSolution($solution_ordering_element_list);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateReachedPointsForSolution()

assOrderingQuestion::calculateReachedPointsForSolution ( ilAssOrderingElementList $solution_ordering_element_list )

protected

Definition at line 1024 of file class.assOrderingQuestion.php.

References ilAssOrderingElementList\getElementByPosition(), getOrderingElementList(), and assQuestion\getPoints().

Referenced by calculateReachedPoints(), and calculateReachedPointsFromPreviewSession().

                                                                                                                   : float
     {
         $reached_points = $this->getPoints();
 
         foreach ($this->getOrderingElementList() as $correct_element) {
             $user_element = $solution_ordering_element_list->getElementByPosition($correct_element->getPosition());
             if (!$correct_element->isSameElement($user_element)) {
                 $reached_points = 0;
                 break;
             }
         }
 
         return $reached_points;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateReachedPointsFromPreviewSession()

assOrderingQuestion::calculateReachedPointsFromPreviewSession ( ilAssQuestionPreviewSession $preview_session )

Definition at line 494 of file class.assOrderingQuestion.php.

References calculateReachedPointsForSolution(), assQuestion\deductHintPointsFromReachedPoints(), assQuestion\ensureNonNegativePoints(), ilAssQuestionPreviewSession\getParticipantsSolution(), and ilAssQuestionPreviewSession\hasParticipantSolution().

                                                                                                           : float
     {
         if (!$preview_session->hasParticipantSolution()) {
             return 0.0;
         }
 
         $solution_ordering_element_list = unserialize(
             $preview_session->getParticipantsSolution(),
             ['allowed_classes' => true]
         );
 
         $reached_points = $this->deductHintPointsFromReachedPoints(
             $preview_session,
             $this->calculateReachedPointsForSolution($solution_ordering_element_list)
         );
 
         return $this->ensureNonNegativePoints($reached_points);
     }

Here is the call graph for this function:

◆ cleanImagefiles()

assOrderingQuestion::cleanImagefiles ( )

protected

Definition at line 535 of file class.assOrderingQuestion.php.

References Vendor\Package\$f, ilFileUtils\delDir(), ilFileUtils\getDir(), assQuestion\getImagePath(), getOrderingElementList(), getOrderingType(), and getThumbPrefix().

                                         : void
     {
         if ($this->getOrderingType() == self::OQ_PICTURES) {
             if (@file_exists($this->getImagePath())) {
                 $contents = ilFileUtils::getDir($this->getImagePath());
                 foreach ($contents as $f) {
                     if (strcmp($f['type'], 'file') == 0) {
                         $found = false;
                         foreach ($this->getOrderingElementList() as $orderElement) {
                             if (strcmp($f['entry'], $orderElement->getContent()) == 0) {
                                 $found = true;
                             }
                             if (strcmp($f['entry'], $this->getThumbPrefix() . $orderElement->getContent()) == 0) {
                                 $found = true;
                             }
                         }
                         if (!$found) {
                             if (@file_exists($this->getImagePath() . $f['entry'])) {
                                 @unlink($this->getImagePath() . $f['entry']);
                             }
                         }
                     }
                 }
             }
         } else {
             if (@file_exists($this->getImagePath())) {
                 ilFileUtils::delDir($this->getImagePath());
             }
         }
     }

Here is the call graph for this function:

◆ cloneImages()

assOrderingQuestion::cloneImages	(	int	$source_question_id,
		int	$source_parent_id,
		int	$target_question_id,
		int	$target_parent_id
	)

Definition at line 175 of file class.assOrderingQuestion.php.

References $filename, assQuestion\getImagePath(), getOrderingElementList(), getThumbPrefix(), isImageOrderingType(), ilFileUtils\makeDirParents(), and assQuestion\removeAllImageFiles().

Referenced by cloneQuestionTypeSpecificProperties().

      : void {
         if (!$this->isImageOrderingType()) {
             return;
         }
 
         $image_source_path = $this->getImagePath($source_question_id, $source_parent_id);
         $image_target_path = $this->getImagePath($target_question_id, $target_parent_id);
 
         if (!file_exists($image_target_path)) {
             ilFileUtils::makeDirParents($image_target_path);
         } else {
             $this->removeAllImageFiles($image_target_path);
         }
         foreach ($this->getOrderingElementList() as $element) {
             $filename = $element->getContent();
 
             if ($filename === '') {
                 continue;
             }
 
             if (!file_exists($image_source_path . $filename)
                 || !copy($image_source_path . $filename, $image_target_path . $filename)) {
                 $this->log->root()->warning('Image could not be cloned for object for question: ' . $target_question_id);
             }
             if (!file_exists($image_source_path . $this->getThumbPrefix() . $filename)
                 || !copy($image_source_path . $this->getThumbPrefix() . $filename, $image_target_path . $this->getThumbPrefix() . $filename)) {
                 $this->log->root()->warning('Image thumbnails could not be cloned for object for question: ' . $target_question_id);
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneQuestionTypeSpecificProperties()

assOrderingQuestion::cloneQuestionTypeSpecificProperties ( \assQuestion $target )

protected

Definition at line 163 of file class.assOrderingQuestion.php.

References cloneImages(), assQuestion\getId(), assQuestion\getObjId(), getRepository(), and assQuestion\saveToDb().

      : \assQuestion {
         $list = $this->getRepository()->getOrderingList($this->getId())
             ->withQuestionId($target->getId());
         $list->distributeNewRandomIdentifiers();
         $target->setOrderingElementList($list);
         $this->cloneImages($this->getId(), $this->getObjId(), $target->getId(), $target->getObjId());
         $target->saveToDb();
         return $target;
     }

Here is the call graph for this function:

◆ deleteAnswer()

assOrderingQuestion::deleteAnswer ( int $random_identifier )

Definition at line 459 of file class.assOrderingQuestion.php.

References getOrderingElementList().

                                                         : void
     {
         $this->getOrderingElementList()->removeElement(
             $this->getOrderingElementList()->getElementByRandomIdentifier($random_identifier)
         );
         $this->getOrderingElementList()->saveToDb();
     }

Here is the call graph for this function:

◆ dropImageFile()

assOrderingQuestion::dropImageFile ( $imageFilename )

Definition at line 572 of file class.assOrderingQuestion.php.

References assQuestion\getImagePath(), and getThumbPrefix().

     {
         if (!strlen($imageFilename)) {
             return false;
         }
 
         $result = @unlink($this->getImagePath() . $imageFilename);
         $result = $result && @unlink($this->getImagePath() . $this->getThumbPrefix() . $imageFilename);
 
         return $result;
     }

Here is the call graph for this function:

◆ ensureImagePathExists()

assOrderingQuestion::ensureImagePathExists ( )

protected

Definition at line 1142 of file class.assOrderingQuestion.php.

References assQuestion\getImagePath(), and ilFileUtils\makeDirParents().

Referenced by storeImageFile().

                                               : void
     {
         if (!file_exists($this->getImagePath())) {
             ilFileUtils::makeDirParents($this->getImagePath());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchSolutionListFromFormSubmissionData()

assOrderingQuestion::fetchSolutionListFromFormSubmissionData ( array $user_solution_post )

Definition at line 979 of file class.assOrderingQuestion.php.

References ilAssOrderingElementList\buildInstance(), buildNestedOrderingElementInputGui(), ilAssNestedOrderingElementsInputGUI\CONTEXT_USER_SOLUTION_SUBMISSION, assQuestion\getId(), getOrderingElementList(), and isOrderingTypeNested().

Referenced by getSolutionListFromPostSubmit(), and getSolutionOrderingElementListForTestOutput().

                                                                                       : ilAssOrderingElementList
     {
         $ordering_gui = $this->buildNestedOrderingElementInputGui();
         $ordering_gui->setContext(ilAssNestedOrderingElementsInputGUI::CONTEXT_USER_SOLUTION_SUBMISSION);
         $ordering_gui->setValueByArray($user_solution_post);
 
         if (!$ordering_gui->checkInput()) {
             throw new ilTestException('error on validating user solution post');
         }
 
         $solution_ordering_element_list = ilAssOrderingElementList::buildInstance($this->getId());
 
         $stored_element_list = $this->getOrderingElementList();
 
         foreach ($ordering_gui->getElementList($this->getId()) as $submitted_element) {
             $solution_element = $stored_element_list->getElementByRandomIdentifier(
                 $submitted_element->getRandomIdentifier()
             )->getClone();
 
             $solution_element->setPosition($submitted_element->getPosition());
 
             if ($this->isOrderingTypeNested()) {
                 $solution_element->setIndentation($submitted_element->getIndentation());
             }
 
             $solution_ordering_element_list->addElement($solution_element);
         }
 
         return $solution_ordering_element_list;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchSolutionSubmit()

assOrderingQuestion::fetchSolutionSubmit ( array $form_submission_data_structure )

Returns: array

Definition at line 1152 of file class.assOrderingQuestion.php.

References getOrderingElementList(), and getOrderingType().

                                                                               : array
     {
         $solution_submit = [];
 
         if (isset($form_submission_data_structure['orderresult'])) {
             $orderresult = $form_submission_data_structure['orderresult'];
 
             if (strlen($orderresult)) {
                 $orderarray = explode(":", $orderresult);
                 $ordervalue = 1;
                 foreach ($orderarray as $index) {
                     $idmatch = null;
                     if (preg_match("/id_(\\d+)/", $index, $idmatch)) {
                         $randomid = $idmatch[1];
                         foreach ($this->getOrderingElementList() as $answeridx => $answer) {
                             if ($answer->getRandomIdentifier() == $randomid) {
                                 $solution_submit[$answeridx] = $ordervalue;
                                 $ordervalue++;
                             }
                         }
                     }
                 }
             }
         } elseif ($this->getOrderingType() == self::OQ_NESTED_TERMS || $this->getOrderingType() == self::OQ_NESTED_PICTURES) {
             $index = 0;
             foreach ($form_submission_data_structure['content'] as $randomId => $content) {
                 $indentation = $form_submission_data_structure['indentation'];
 
                 $value1 = $index++;
                 $value2 = implode(':', [$randomId, $indentation]);
 
                 $solution_submit[$value1] = $value2;
             }
         } else {
             foreach ($form_submission_data_structure as $key => $value) {
                 $matches = null;
                 if (preg_match("/^order_(\d+)/", $key, $matches)) {
                     if (!(preg_match("/initial_value_\d+/", $value))) {
                         if (strlen($value)) {
                             foreach ($this->getOrderingElementList() as $answeridx => $answer) {
                                 if ($answer->getRandomIdentifier() == $matches[1]) {
                                     $solution_submit[$answeridx] = $value;
                                 }
                             }
                         }
                     }
                 }
             }
         }
 
         return $solution_submit;
     }

Here is the call graph for this function:

◆ generateThumbForFile()

assOrderingQuestion::generateThumbForFile	(	$path,
		$file
	)

protected

Definition at line 813 of file class.assOrderingQuestion.php.

References $filename, $path, ilShellUtil\convertImage(), getThumbPrefix(), and assQuestion\getThumbSize().

Referenced by rebuildThumbnails().

                                                          : void
     {
         $filename = $path . $file;
         if (@file_exists($filename)) {
             $thumbpath = $path . $this->getThumbPrefix() . $file;
             $path_info = @pathinfo($filename);
             $ext = "";
             switch (strtoupper($path_info['extension'])) {
                 case 'PNG':
                     $ext = 'PNG';
                     break;
                 case 'GIF':
                     $ext = 'GIF';
                     break;
                 default:
                     $ext = 'JPEG';
                     break;
             }
             ilShellUtil::convertImage($filename, $thumbpath, $ext, (string) $this->getThumbSize());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAdditionalTableName()

assOrderingQuestion::getAdditionalTableName ( )

Returns the name of the additional question data table in the database.

Returns: string The additional table name public

Definition at line 744 of file class.assOrderingQuestion.php.

Referenced by loadFromDb(), and saveAdditionalQuestionDataToDb().

                                             : string
     {
         return "qpl_qst_ordering";
     }

Here is the caller graph for this function:

◆ getAnswer()

assOrderingQuestion::getAnswer ( int $index = 0 )

Returns the ordering element from the given position.

Parameters

int $position

Returns: ilAssOrderingElement|null

Definition at line 450 of file class.assOrderingQuestion.php.

References getOrderingElementList().

                                              : ?ilAssOrderingElement
     {
         if (!$this->getOrderingElementList()->elementExistByPosition($index)) {
             return null;
         }
 
         return $this->getOrderingElementList()->getElementByPosition($index);
     }

Here is the call graph for this function:

◆ getAnswerCount()

assOrderingQuestion::getAnswerCount ( )

Definition at line 467 of file class.assOrderingQuestion.php.

References getOrderingElementList().

                                     : int
     {
         return $this->getOrderingElementList()->countElements();
     }

Here is the call graph for this function:

◆ getAnswerTableName()

assOrderingQuestion::getAnswerTableName ( )

Returns the name of the answer table in the database.

Returns: string The answer table name public

Definition at line 755 of file class.assOrderingQuestion.php.

                                         : string
     {
         return "qpl_a_ordering";
     }

◆ getAvailableAnswerOptions()

assOrderingQuestion::getAvailableAnswerOptions ( $index = null )

If index is null, the function returns an array with all anwser options Else it returns the specific answer option.

Parameters

null | int $index

Definition at line 1116 of file class.assOrderingQuestion.php.

References getOrderingElementList().

     {
         if ($index !== null) {
             return $this->getOrderingElementList()->getElementByPosition($index);
         }
 
         return $this->getOrderingElementList()->getElements();
     }

Here is the call graph for this function:

◆ getCorrectSolutionForTextOutput()

assOrderingQuestion::getCorrectSolutionForTextOutput	(	int	$active_id,
		int	$pass
	)

Definition at line 1335 of file class.assOrderingQuestion.php.

References getElementArrayWithIdentationsForTextOutput(), and getOrderingElementList().

                                                                               : array
     {
         return $this->getElementArrayWithIdentationsForTextOutput(
             $this->getOrderingElementList()->getElements()
         );
     }

Here is the call graph for this function:

◆ getElementArrayWithIdentationsForTextOutput()

assOrderingQuestion::getElementArrayWithIdentationsForTextOutput ( array $elements )

private

Parameters

array<ilAssOrderingElement> $elements

Returns: array

Definition at line 1347 of file class.assOrderingQuestion.php.

References Vendor\Package\$a, Vendor\Package\$b, ilAssOrderingElement\getContent(), ilAssOrderingElement\getIndentation(), and ilAssOrderingElement\getPosition().

Referenced by getCorrectSolutionForTextOutput(), solutionValuesToLog(), and solutionValuesToText().

                                                                                  : array
     {
         usort(
             $elements,
             static fn(ilAssOrderingElement $a, ilAssOrderingElement $b): int
                 => $a->getPosition() - $b->getPosition()
         );
 
         return array_map(
             function (ilAssOrderingElement $v): string {
                 $indentation = '';
                 for ($i = 0;$i < $v->getIndentation();$i++) {
                     $indentation .= ' |';
                 }
                 return $indentation . $v->getContent();
             },
             $elements
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getElementHeight()

assOrderingQuestion::getElementHeight ( )

Definition at line 784 of file class.assOrderingQuestion.php.

References $element_height.

Referenced by saveAdditionalQuestionDataToDb().

                                       : ?int
     {
         return $this->element_height;
     }

Here is the caller graph for this function:

◆ getEncryptedFilename()

assOrderingQuestion::getEncryptedFilename ( $filename )

Definition at line 526 of file class.assOrderingQuestion.php.

References $filename.

                                                    : string
     {
         $extension = "";
         if (preg_match("/.*\\.(\\w+)$/", $filename, $matches)) {
             $extension = $matches[1];
         }
         return md5($filename) . "." . $extension;
     }

◆ getExpressionTypes()

assOrderingQuestion::getExpressionTypes ( )

Get all available expression types for a specific question.

Returns: array

Implements iQuestionCondition.

Definition at line 1044 of file class.assOrderingQuestion.php.

References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumericResultExpression, iQuestionCondition\OrderingResultExpression, and iQuestionCondition\PercentageResultExpression.

                                         : array
     {
         return [
             iQuestionCondition::PercentageResultExpression,
             iQuestionCondition::NumericResultExpression,
             iQuestionCondition::OrderingResultExpression,
             iQuestionCondition::EmptyAnswerExpression,
         ];
     }

◆ getMaximumPoints()

assOrderingQuestion::getMaximumPoints ( )

Definition at line 513 of file class.assOrderingQuestion.php.

References assQuestion\getPoints().

Referenced by getUserQuestionResult(), and isComplete().

                                       : float
     {
         return $this->getPoints();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOperators()

assOrderingQuestion::getOperators ( string $expression )

Get all available operations for a specific question.

Parameters

$expression

Implements iQuestionCondition.

Definition at line 1039 of file class.assOrderingQuestion.php.

                                                     : array
     {
         return ilOperatorsExpressionMapping::getOperatorsByExpression($expression);
     }

◆ getOrderElements()

assOrderingQuestion::getOrderElements ( )

Returns the answers array.

Deprecated:: seriously, stop looking for this kind data at this point (!) look where it comes from and learn (!)

Definition at line 779 of file class.assOrderingQuestion.php.

References getOrderingElementList().

Referenced by rebuildThumbnails().

                                       : array
     {
         return $this->getOrderingElementList()->getRandomIdentifierIndexedElements();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOrderingElementList()

assOrderingQuestion::getOrderingElementList ( )

Returns: ilAssOrderingElementList

Definition at line 419 of file class.assOrderingQuestion.php.

References assQuestion\getId(), and getRepository().

Referenced by calculateReachedPointsForSolution(), cleanImagefiles(), cloneImages(), deleteAnswer(), fetchSolutionListFromFormSubmissionData(), fetchSolutionSubmit(), getAnswer(), getAnswerCount(), getAvailableAnswerOptions(), getCorrectSolutionForTextOutput(), getOrderElements(), getOrderingElementListForSolutionOutput(), getRTETextWithMediaObjects(), getShuffledOrderingElementList(), getSolutionOrderingElementList(), getSolutionOutputForLog(), getSolutionValuePairBrandedOrderingElementByRandomIdentifier(), getSolutionValuePairBrandedOrderingElementBySolutionIdentifier(), getUserQuestionResult(), isComplete(), toJSON(), and validateSolutionSubmit().

                                             : ilAssOrderingElementList
     {
         return $this->getRepository()->getOrderingList($this->getId());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOrderingElementListForSolutionOutput()

assOrderingQuestion::getOrderingElementListForSolutionOutput	(	bool	$force_correct_solution,
		int	$active_id,
		?int	$pass_index
	)

Definition at line 299 of file class.assOrderingQuestion.php.

References assQuestion\fetchIndexedValuesFromValuePairs(), getOrderingElementList(), getShuffledOrderingElementList(), getSolutionOrderingElementList(), and assQuestion\getSolutionValues().

      : ilAssOrderingElementList {
         if ($force_correct_solution || !$active_id || $pass_index === null) {
             return $this->getOrderingElementList();
         }
 
         $solution_values = $this->getSolutionValues($active_id, $pass_index);
 
         if (!count($solution_values)) {
             return $this->getShuffledOrderingElementList();
         }
 
         return $this->getSolutionOrderingElementList($this->fetchIndexedValuesFromValuePairs($solution_values));
     }

Here is the call graph for this function:

◆ getOrderingType()

assOrderingQuestion::getOrderingType ( )

Definition at line 229 of file class.assOrderingQuestion.php.

Referenced by buildNestedOrderingElementInputGui(), buildNestedOrderingFormDataConverter(), cleanImagefiles(), fetchSolutionSubmit(), isImageOrderingType(), isOrderingTypeNested(), saveWorkingData(), toJSON(), and toLog().

                                      : int
     {
         return $this->ordering_type;
     }

Here is the caller graph for this function:

◆ getOrderingTypeLangVars()

assOrderingQuestion::getOrderingTypeLangVars ( int $ordering_type )

private

Definition at line 1281 of file class.assOrderingQuestion.php.

Referenced by toLog().

                                                                 : array
     {
         switch ($ordering_type) {
             case self::OQ_PICTURES:
                 return ['qst_nested_nested_answers_off', 'oq_btn_use_order_pictures'];
             case self::OQ_TERMS:
                 return ['qst_nested_nested_answers_off', 'oq_btn_use_order_terms'];
             case self::OQ_NESTED_PICTURES:
                 return ['qst_nested_nested_answers_on', 'oq_btn_use_order_pictures'];
             case self::OQ_NESTED_TERMS:
                 return ['qst_nested_nested_answers_on', 'oq_btn_use_order_terms'];
             default:
                 return ['', ''];
         }
     }

Here is the caller graph for this function:

◆ getQuestionRepository()

assOrderingQuestion::getQuestionRepository ( )

protected

Definition at line 718 of file class.assOrderingQuestion.php.

                                               : OQRepository
     {
         return new OQRepository($this->db);
     }

◆ getQuestionType()

assOrderingQuestion::getQuestionType ( )

Returns the question type of the question.

Returns: integer The question type of the question public

Definition at line 733 of file class.assOrderingQuestion.php.

Referenced by toJSON(), and toLog().

                                      : string
     {
         return "assOrderingQuestion";
     }

Here is the caller graph for this function:

◆ getRepository()

assOrderingQuestion::getRepository ( )

protected

Definition at line 98 of file class.assOrderingQuestion.php.

References $oq_repository.

Referenced by cloneQuestionTypeSpecificProperties(), getOrderingElementList(), and setOrderingElementList().

                                       : OQRepository
     {
         if (is_null($this->oq_repository)) {
             $this->oq_repository = new OQRepository($this->db);
         }
         return $this->oq_repository;
     }

Here is the caller graph for this function:

◆ getRTETextWithMediaObjects()

assOrderingQuestion::getRTETextWithMediaObjects ( )

Collects all text in the question which could contain media objects which were created with the Rich Text Editor.

Definition at line 764 of file class.assOrderingQuestion.php.

References $text, and getOrderingElementList().

                                                 : string
     {
         $text = parent::getRTETextWithMediaObjects();
 
         foreach ($this->getOrderingElementList() as $orderingElement) {
             $text .= $orderingElement->getContent();
         }
 
         return $text;
     }

Here is the call graph for this function:

◆ getShuffledOrderingElementList()

assOrderingQuestion::getShuffledOrderingElementList ( )

Parameters

$active_id
$pass

Returns: ilAssOrderingElementList

Definition at line 403 of file class.assOrderingQuestion.php.

References getOrderingElementList(), and assQuestion\getShuffler().

Referenced by getOrderingElementListForSolutionOutput(), and getSolutionOrderingElementListForTestOutput().

                                                     : ilAssOrderingElementList
     {
         $shuffledRandomIdentifierIndex = $this->getShuffler()->transform(
             $this->getOrderingElementList()->getRandomIdentifierIndex()
         );
 
         $shuffledElementList = $this->getOrderingElementList()->getClone();
         $shuffledElementList->reorderByRandomIdentifiers($shuffledRandomIdentifierIndex);
         $shuffledElementList->resetElementsIndentations();
 
         return $shuffledElementList;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionListFromPostSubmit()

assOrderingQuestion::getSolutionListFromPostSubmit ( )

Definition at line 1012 of file class.assOrderingQuestion.php.

References $postSolutionOrderingElementList, fetchSolutionListFromFormSubmissionData(), and ILIAS\FileDelivery\http().

Referenced by savePreviewData(), saveWorkingData(), and validateSolutionSubmit().

                                                    : ilAssOrderingElementList
     {
         if ($this->postSolutionOrderingElementList === null) {
             $list = $this->fetchSolutionListFromFormSubmissionData(
                 $this->http->request()->getParsedBody()
             );
             $this->postSolutionOrderingElementList = $list;
         }
 
         return $this->postSolutionOrderingElementList;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionOrderingElementList()

assOrderingQuestion::getSolutionOrderingElementList ( array $indexed_solution_values )

Exceptions

ilTestQuestionPoolException

Definition at line 376 of file class.assOrderingQuestion.php.

References assQuestion\getId(), getOrderingElementList(), getSolutionValuePairBrandedOrderingElementByRandomIdentifier(), getSolutionValuePairBrandedOrderingElementBySolutionIdentifier(), and isOrderingTypeNested().

Referenced by calculateReachedPoints(), getOrderingElementListForSolutionOutput(), getSolutionOrderingElementListForTestOutput(), solutionValuesToLog(), and solutionValuesToText().

                                                                                   : ilAssOrderingElementList
     {
         $solution_ordering_list = new ilAssOrderingElementList();
         $solution_ordering_list->setQuestionId($this->getId());
 
         foreach ($indexed_solution_values as $value1 => $value2) {
             if ($this->isOrderingTypeNested()) {
                 $element = $this->getSolutionValuePairBrandedOrderingElementByRandomIdentifier($value1, $value2);
             } else {
                 $element = $this->getSolutionValuePairBrandedOrderingElementBySolutionIdentifier($value1, $value2);
             }
 
             $solution_ordering_list->addElement($element);
         }
 
         if (!$this->getOrderingElementList()->hasSameElementSetByRandomIdentifiers($solution_ordering_list)) {
             throw new ilTestQuestionPoolException('inconsistent solution values given');
         }
 
         return $solution_ordering_list;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionOrderingElementListForTestOutput()

assOrderingQuestion::getSolutionOrderingElementListForTestOutput	(	ilAssNestedOrderingElementsInputGUI	$input_gui,
		array	$last_post,
		int	$active_id,
		int	$pass
	)

Definition at line 317 of file class.assOrderingQuestion.php.

References assQuestion\fetchIndexedValuesFromValuePairs(), fetchSolutionListFromFormSubmissionData(), getShuffledOrderingElementList(), getSolutionOrderingElementList(), assQuestion\getTestOutputSolutions(), and ilAssNestedOrderingElementsInputGUI\isPostSubmit().

      : ilAssOrderingElementList {
         if ($input_gui->isPostSubmit($last_post)) {
             return $this->fetchSolutionListFromFormSubmissionData($last_post);
         }
         $indexedSolutionValues = $this->fetchIndexedValuesFromValuePairs(
             // hey: prevPassSolutions - obsolete due to central check
             $this->getTestOutputSolutions($active_id, $pass)
             // hey.
         );
 
         if (count($indexedSolutionValues)) {
             return $this->getSolutionOrderingElementList($indexedSolutionValues);
         }
 
         return $this->getShuffledOrderingElementList();
     }

Here is the call graph for this function:

◆ getSolutionOutputForLog()

assOrderingQuestion::getSolutionOutputForLog ( )

private

Definition at line 1297 of file class.assOrderingQuestion.php.

References buildNestedOrderingElementInputGui(), ilAssNestedOrderingElementsInputGUI\CONTEXT_CORRECT_SOLUTION_PRESENTATION, and getOrderingElementList().

Referenced by toLog().

                                               : string
     {
         $solution_ordering_list = $this->getOrderingElementList();
 
         $answers_gui = $this->buildNestedOrderingElementInputGui();
         $answers_gui->setContext(ilAssNestedOrderingElementsInputGUI::CONTEXT_CORRECT_SOLUTION_PRESENTATION);
         $answers_gui->setInteractionEnabled(false);
         $answers_gui->setElementList($solution_ordering_list);
 
         return $answers_gui->getHTML();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionValuePairBrandedOrderingElementByRandomIdentifier()

assOrderingQuestion::getSolutionValuePairBrandedOrderingElementByRandomIdentifier	(	int	$value1,
		string	$value2
	)

protected

Definition at line 339 of file class.assOrderingQuestion.php.

References getOrderingElementList(), and ILIAS\Repository\int().

Referenced by getSolutionOrderingElementList().

      : ilAssOrderingElement {
         $value = explode(':', $value2);
 
         $random_identifier = (int) $value[0];
         $selected_position = $value1;
         $selected_indentation = (int) $value[1];
 
         $element = $this->getOrderingElementList()->getElementByRandomIdentifier($random_identifier)->getClone();
 
         $element->setPosition($selected_position);
         $element->setIndentation($selected_indentation);
 
         return $element;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionValuePairBrandedOrderingElementBySolutionIdentifier()

assOrderingQuestion::getSolutionValuePairBrandedOrderingElementBySolutionIdentifier	(	int	$value1,
		string	$value2
	)

protected

Definition at line 357 of file class.assOrderingQuestion.php.

References getOrderingElementList().

Referenced by getSolutionOrderingElementList().

      : ilAssOrderingElement {
         $solution_identifier = $value1;
         $selected_position = ($value2 - 1);
         $selected_indentation = 0;
 
         $element = $this->getOrderingElementList()->getElementBySolutionIdentifier($solution_identifier)->getClone();
 
         $element->setPosition($selected_position);
         $element->setIndentation($selected_indentation);
 
         return $element;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getThumbPrefix()

assOrderingQuestion::getThumbPrefix ( )

Definition at line 808 of file class.assOrderingQuestion.php.

Referenced by buildNestedOrderingElementInputGui(), buildNestedOrderingFormDataConverter(), buildOrderingImagesFormDataConverter(), cleanImagefiles(), cloneImages(), dropImageFile(), generateThumbForFile(), storeImageFile(), and updateImageFile().

                                     : string
     {
         return "thumb.";
     }

Here is the caller graph for this function:

◆ getUserQuestionResult()

assOrderingQuestion::getUserQuestionResult	(	int	$active_id,
		int	$pass
	)

Get the user solution for a question by active_id and the test pass.

Implements iQuestionCondition.

Definition at line 1054 of file class.assOrderingQuestion.php.

References $data, assQuestion\$points, calculateReachedPoints(), assQuestion\getId(), getMaximumPoints(), getOrderingElementList(), isOrderingTypeNested(), and assQuestion\lookupMaxStep().

      : ilUserQuestionResult {
         $result = new ilUserQuestionResult($this, $active_id, $pass);
 
         $maxStep = $this->lookupMaxStep($active_id, $pass);
         if ($maxStep > 0) {
             $data = $this->db->queryF(
                 "SELECT value1, value2 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step = %s ORDER BY value1 ASC ",
                 ["integer", "integer", "integer","integer"],
                 [$active_id, $pass, $this->getId(), $maxStep]
             );
         } else {
             $data = $this->db->queryF(
                 "SELECT value1, value2 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s ORDER BY value1 ASC ",
                 ["integer", "integer", "integer"],
                 [$active_id, $pass, $this->getId()]
             );
         }
 
         $elements = [];
         while ($row = $this->db->fetchAssoc($data)) {
             $newKey = explode(":", $row["value2"]);
 
             foreach ($this->getOrderingElementList() as $answer) {
                 // Images not supported
                 if (!$this->isOrderingTypeNested()) {
                     if ($answer->getSolutionIdentifier() == $row["value1"]) {
                         $elements[$row["value2"]] = $answer->getSolutionIdentifier() + 1;
                         break;
                     }
                 } else {
                     if ($answer->getRandomIdentifier() == $newKey[0]) {
                         $elements[$row["value1"]] = $answer->getSolutionIdentifier() + 1;
                         break;
                     }
                 }
             }
         }
 
         ksort($elements);
 
         foreach (array_values($elements) as $element) {
             $result->addKeyValue($element, $element);
         }
 
         $points = $this->calculateReachedPoints($active_id, $pass);
         $max_points = $this->getMaximumPoints();
 
         $result->setReachedPercentage(($points / $max_points) * 100);
 
         return $result;
     }

Here is the call graph for this function:

◆ getValidOrderingTypes()

assOrderingQuestion::getValidOrderingTypes ( )

protected

Definition at line 211 of file class.assOrderingQuestion.php.

Referenced by setOrderingType().

                                               : array
     {
         return [
             self::OQ_PICTURES,
             self::OQ_TERMS,
             self::OQ_NESTED_PICTURES,
             self::OQ_NESTED_TERMS
         ];
     }

Here is the caller graph for this function:

◆ hasOrderingTypeUploadSupport()

assOrderingQuestion::hasOrderingTypeUploadSupport ( )

Definition at line 294 of file class.assOrderingQuestion.php.

References isImageOrderingType().

Referenced by isImageReplaced().

                                                   : bool
     {
         return $this->isImageOrderingType();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initOrderingElementAuthoringProperties()

assOrderingQuestion::initOrderingElementAuthoringProperties ( ilFormPropertyGUI $formField )

Parameters

ilAssOrderingTextsInputGUI | ilAssOrderingImagesInputGUI | ilAssNestedOrderingElementsInputGUI $formField

Definition at line 894 of file class.assOrderingQuestion.php.

References isOrderingTypeNested().

Referenced by ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput().

                                                                                         : void
     {
         switch (true) {
             case $formField instanceof ilAssNestedOrderingElementsInputGUI:
                 $formField->setInteractionEnabled(true);
                 $formField->setNestingEnabled($this->isOrderingTypeNested());
                 break;
 
             case $formField instanceof ilAssOrderingTextsInputGUI:
             case $formField instanceof ilAssOrderingImagesInputGUI:
             default:
 
                 $formField->setEditElementOccuranceEnabled(true);
                 $formField->setEditElementOrderEnabled(true);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initOrderingElementFormFieldLabels()

assOrderingQuestion::initOrderingElementFormFieldLabels ( ilFormPropertyGUI $formField )

Parameters

ilFormPropertyGUI $formField

Definition at line 914 of file class.assOrderingQuestion.php.

References ILIAS\Repository\lng(), ilFormPropertyGUI\setInfo(), and ilFormPropertyGUI\setTitle().

Referenced by buildNestedOrderingElementInputGui(), buildOrderingImagesInputGui(), and buildOrderingTextsInputGui().

                                                                                     : void
     {
         $formField->setInfo($this->lng->txt('ordering_answer_sequence_info'));
         $formField->setTitle($this->lng->txt('answers'));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isComplete()

assOrderingQuestion::isComplete ( )

Definition at line 76 of file class.assOrderingQuestion.php.

References assQuestion\getAuthor(), getMaximumPoints(), getOrderingElementList(), assQuestion\getQuestion(), and assQuestion\getTitle().

                                 : bool
     {
         $elements_list = $this->getOrderingElementList()->getElements();
         if ($elements_list === [] && $this->element_list_for_deferred_saving !== null) {
             $elements_list = $this->element_list_for_deferred_saving->getElements();
         }
         $elements = array_filter(
             $elements_list,
             fn($element) => trim($element->getContent()) != ''
         );
 
         $has_at_least_two_elements = count($elements) > 1;
 
         $complete = $this->getAuthor()
             && $this->getTitle()
             && $this->getQuestion()
             && $this->getMaximumPoints()
             && $has_at_least_two_elements;
 
         return $complete;
     }

Here is the call graph for this function:

◆ isImageFileStored()

assOrderingQuestion::isImageFileStored ( $imageFilename )

Definition at line 584 of file class.assOrderingQuestion.php.

References assQuestion\getImagePath().

                                                      : bool
     {
         if (!strlen($imageFilename)) {
             return false;
         }
 
         if (!file_exists($this->getImagePath() . $imageFilename)) {
             return false;
         }
 
         return is_file($this->getImagePath() . $imageFilename);
     }

Here is the call graph for this function:

◆ isImageOrderingType()

assOrderingQuestion::isImageOrderingType ( )

Definition at line 243 of file class.assOrderingQuestion.php.

References getOrderingType().

Referenced by ilAssOrderingQuestionAuthoringFormGUI\addSpecificOrderingQuestionCommandButtons(), buildOrderingElementInputGui(), cloneImages(), hasOrderingTypeUploadSupport(), rebuildThumbnails(), and setNestingType().

                                          : bool
     {
         $with_images = [
             self::OQ_PICTURES,
             self::OQ_NESTED_PICTURES
         ];
         return in_array($this->getOrderingType(), $with_images);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isImageReplaced()

assOrderingQuestion::isImageReplaced	(	ilAssOrderingElement	$newElement,
		ilAssOrderingElement	$oldElement
	)

Definition at line 597 of file class.assOrderingQuestion.php.

References ilAssOrderingElement\getContent(), and hasOrderingTypeUploadSupport().

                                                                                                        : bool
     {
         if (!$this->hasOrderingTypeUploadSupport()) {
             return false;
         }
 
         if (!$newElement->getContent()) {
             return false;
         }
 
         return $newElement->getContent() != $oldElement->getContent();
     }

Here is the call graph for this function:

◆ isOrderingTypeNested()

assOrderingQuestion::isOrderingTypeNested ( )

Definition at line 234 of file class.assOrderingQuestion.php.

References getOrderingType().

Referenced by fetchSolutionListFromFormSubmissionData(), getSolutionOrderingElementList(), getUserQuestionResult(), initOrderingElementAuthoringProperties(), and setContentType().

                                           : bool
     {
         $nested = [
             self::OQ_NESTED_TERMS,
             self::OQ_NESTED_PICTURES
         ];
         return in_array($this->getOrderingType(), $nested);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadFromDb()

assOrderingQuestion::loadFromDb ( $question_id )

Loads a assOrderingQuestion object from a database.

Parameters

object	$db	A pear DB object
integer	$question_id	A unique key which defines the multiple choice test in the database public

Definition at line 123 of file class.assOrderingQuestion.php.

References $data, Vendor\Package\$e, ilRTE\_replaceMediaObjectImageSrc(), getAdditionalTableName(), ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), assQuestion\getMinimumThumbSize(), ILIAS\Repository\int(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setId(), assQuestion\setLifecycle(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), assQuestion\setThumbSize(), and assQuestion\setTitle().

                                             : void
     {
         $result = $this->db->queryF(
             "SELECT qpl_questions.*, " . $this->getAdditionalTableName() . ".* FROM qpl_questions LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s",
             ["integer"],
             [$question_id]
         );
         if ($result->numRows() == 1) {
             $data = $this->db->fetchAssoc($result);
             $this->setId($question_id);
             $this->setObjId($data["obj_fi"]);
             $this->setTitle((string) $data["title"]);
             $this->setComment((string) $data["description"]);
             $this->setOriginalId($data["original_id"]);
             $this->setAuthor($data["author"]);
             $this->setNrOfTries($data['nr_of_tries']);
             $this->setPoints($data["points"]);
             $this->setOwner($data["owner"]);
             $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc((string) $data["question_text"], 1));
             $this->ordering_type = $data["ordering_type"] !== null ? (int) $data["ordering_type"] : self::OQ_TERMS;
             if ($data['thumb_geometry'] !== null && $data['thumb_geometry'] >= $this->getMinimumThumbSize()) {
                 $this->setThumbSize($data['thumb_geometry']);
             }
             $this->element_height = $data["element_height"] ? (int) $data['element_height'] : null;
 
             try {
                 $this->setLifecycle(ilAssQuestionLifecycle::getInstance($data['lifecycle']));
             } catch (ilTestQuestionPoolInvalidArgumentException $e) {
                 $this->setLifecycle(ilAssQuestionLifecycle::getDraftInstance());
             }
 
             try {
                 $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
             } catch (ilTestQuestionPoolException $e) {
             }
         }
 
         parent::loadFromDb($question_id);
     }

Here is the call graph for this function:

◆ rebuildThumbnails()

assOrderingQuestion::rebuildThumbnails ( )

Definition at line 797 of file class.assOrderingQuestion.php.

References generateThumbForFile(), assQuestion\getImagePath(), getOrderElements(), and isImageOrderingType().

                                        : void
     {
         if ($this->isImageOrderingType()) {
             foreach ($this->getOrderElements() as $orderingElement) {
                 if ($orderingElement->getContent() !== '') {
                     $this->generateThumbForFile($this->getImagePath(), $orderingElement->getContent());
                 }
             }
         }
     }

Here is the call graph for this function:

◆ saveAdditionalQuestionDataToDb()

assOrderingQuestion::saveAdditionalQuestionDataToDb ( )

Saves a record to the question types additional data table.

Returns: mixed

Implements ilObjQuestionScoringAdjustable.

Definition at line 695 of file class.assOrderingQuestion.php.

References getAdditionalTableName(), getElementHeight(), assQuestion\getId(), and assQuestion\getThumbSize().

Referenced by saveToDb().

     {
         // save additional data
         $this->db->manipulateF(
             "DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s",
             ["integer"],
             [$this->getId()]
         );
 
         $this->db->manipulateF(
             "INSERT INTO " . $this->getAdditionalTableName() . " (question_fi, ordering_type, thumb_geometry, element_height)
                             VALUES (%s, %s, %s, %s)",
             ["integer", "text", "integer", "integer"],
             [
                 $this->getId(),
                 $this->ordering_type,
                 $this->getThumbSize(),
                 ($this->getElementHeight() > 20) ? $this->getElementHeight() : null
             ]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAnswerSpecificDataToDb()

assOrderingQuestion::saveAnswerSpecificDataToDb ( )

Saves the answer specific records into a question types answer table.

Returns: mixed

Implements ilObjAnswerScoringAdjustable.

Definition at line 723 of file class.assOrderingQuestion.php.

724 {

725 }

◆ savePreviewData()

assOrderingQuestion::savePreviewData ( ilAssQuestionPreviewSession $previewSession )

protected

Definition at line 688 of file class.assOrderingQuestion.php.

References getSolutionListFromPostSubmit(), ilAssQuestionPreviewSession\setParticipantsSolution(), and validateSolutionSubmit().

                                                                                    : void
     {
         if ($this->validateSolutionSubmit()) {
             $previewSession->setParticipantsSolution(serialize($this->getSolutionListFromPostSubmit()));
         }
     }

Here is the call graph for this function:

◆ saveToDb()

assOrderingQuestion::saveToDb ( ?int $original_id = null )

Definition at line 106 of file class.assOrderingQuestion.php.

References assQuestion\$original_id, saveAdditionalQuestionDataToDb(), assQuestion\saveQuestionDataToDb(), and setOrderingElementList().

                                                       : void
     {
         $this->saveQuestionDataToDb($original_id);
         $this->saveAdditionalQuestionDataToDb();
         parent::saveToDb();
         if ($this->element_list_for_deferred_saving !== null) {
             $this->setOrderingElementList($this->element_list_for_deferred_saving);
         }
     }

Here is the call graph for this function:

◆ saveWorkingData()

assOrderingQuestion::saveWorkingData	(	int	$active_id,
		?int	$pass = `null`,
		bool	$authorized = `true`
	)

Definition at line 659 of file class.assOrderingQuestion.php.

References ilObjTest\_getPass(), getOrderingType(), assQuestion\getProcessLocker(), getSolutionListFromPostSubmit(), assQuestion\removeCurrentSolution(), and assQuestion\saveCurrentSolution().

      : bool {
         if ($this->questionpool_request->raw('test_answer_changed') === null) {
             return true;
         }
 
         if (is_null($pass)) {
             $pass = ilObjTest::_getPass($active_id);
         }
 
         $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(
             function () use ($active_id, $pass, $authorized) {
                 $this->removeCurrentSolution($active_id, $pass, $authorized);
 
                 foreach ($this->getSolutionListFromPostSubmit() as $orderingElement) {
                     $value1 = $orderingElement->getStorageValue1($this->getOrderingType());
                     $value2 = $orderingElement->getStorageValue2($this->getOrderingType());
 
                     $this->saveCurrentSolution($active_id, $pass, $value1, trim((string) $value2), $authorized);
                 }
             }
         );
 
         return true;
     }

Here is the call graph for this function:

◆ setContentType()

assOrderingQuestion::setContentType ( $ct )

Definition at line 252 of file class.assOrderingQuestion.php.

References assQuestion\getThumbSize(), isOrderingTypeNested(), setOrderingType(), and assQuestion\setThumbSize().

     {
         if (!in_array($ct, [
             self::OQ_CT_PICTURES,
             self::OQ_CT_TERMS
         ])) {
             throw new \InvalidArgumentException("use OQ content-type", 1);
         }
         if ($ct == self::OQ_CT_PICTURES) {
             if ($this->isOrderingTypeNested()) {
                 $this->setOrderingType(self::OQ_NESTED_PICTURES);
             } else {
                 $this->setOrderingType(self::OQ_PICTURES);
             }
             $this->setThumbSize($this->getThumbSize());
         }
         if ($ct == self::OQ_CT_TERMS) {
             if ($this->isOrderingTypeNested()) {
                 $this->setOrderingType(self::OQ_NESTED_TERMS);
             } else {
                 $this->setOrderingType(self::OQ_TERMS);
             }
         }
     }

Here is the call graph for this function:

◆ setElementHeight()

assOrderingQuestion::setElementHeight ( ?int $a_height )

Definition at line 789 of file class.assOrderingQuestion.php.

                                                     : void
     {
         $this->element_height = ($a_height < 20) ? null : $a_height;
     }

◆ setNestingType()

assOrderingQuestion::setNestingType ( bool $nesting )

Definition at line 277 of file class.assOrderingQuestion.php.

References isImageOrderingType(), and setOrderingType().

     {
         if ($nesting) {
             if ($this->isImageOrderingType()) {
                 $this->setOrderingType(self::OQ_NESTED_PICTURES);
             } else {
                 $this->setOrderingType(self::OQ_NESTED_TERMS);
             }
         } else {
             if ($this->isImageOrderingType()) {
                 $this->setOrderingType(self::OQ_PICTURES);
             } else {
                 $this->setOrderingType(self::OQ_TERMS);
             }
         }
     }

Here is the call graph for this function:

◆ setOrderingElementList()

assOrderingQuestion::setOrderingElementList ( ilAssOrderingElementList $list )

Parameters

ilAssOrderingElementList $orderingElementList

Definition at line 427 of file class.assOrderingQuestion.php.

References Vendor\Package\$e, ilAssOrderingElementList\ensureValidIdentifiers(), ilAssOrderingElementList\getElements(), assQuestion\getId(), getRepository(), ilAssOrderingElementList\withElements(), and ilAssOrderingElementList\withQuestionId().

Referenced by saveToDb().

                                                                           : void
     {
         if ($this->getId() <= 0) {
             $this->element_list_for_deferred_saving = $list;
             return;
         }
         $list = $list->withQuestionId($this->getId());
         $elements = $list->getElements();
         $nu = [];
         foreach ($elements as $e) {
             $nu[] = $list->ensureValidIdentifiers($e);
         }
         $this->getRepository()->updateOrderingList(
             $list->withElements($nu)
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setOrderingType()

assOrderingQuestion::setOrderingType ( int $ordering_type = self::OQ_TERMS )

Definition at line 221 of file class.assOrderingQuestion.php.

References getValidOrderingTypes().

Referenced by setContentType(), and setNestingType().

     {
         if (!in_array($ordering_type, $this->getValidOrderingTypes())) {
             throw new \InvalidArgumentException('Must be valid ordering type.');
         }
         $this->ordering_type = $ordering_type;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ solutionValuesToLog()

assOrderingQuestion::solutionValuesToLog	(	AdditionalInformationGenerator	$additional_info,
		array	$solution_values
	)

protected

Definition at line 1309 of file class.assOrderingQuestion.php.

References assQuestion\fetchIndexedValuesFromValuePairs(), getElementArrayWithIdentationsForTextOutput(), and getSolutionOrderingElementList().

      : array {
         if ($solution_values === []) {
             return [];
         }
         return $this->getElementArrayWithIdentationsForTextOutput(
             $this->getSolutionOrderingElementList(
                 $this->fetchIndexedValuesFromValuePairs($solution_values)
             )->getElements()
         );
     }

Here is the call graph for this function:

◆ solutionValuesToText()

assOrderingQuestion::solutionValuesToText ( array $solution_values )

Definition at line 1323 of file class.assOrderingQuestion.php.

References assQuestion\fetchIndexedValuesFromValuePairs(), getElementArrayWithIdentationsForTextOutput(), and getSolutionOrderingElementList().

                                                                 : array
     {
         if ($solution_values === []) {
             return [];
         }
         return $this->getElementArrayWithIdentationsForTextOutput(
             $this->getSolutionOrderingElementList(
                 $this->fetchIndexedValuesFromValuePairs($solution_values)
             )->getElements()
         );
     }

Here is the call graph for this function:

◆ storeImageFile()

assOrderingQuestion::storeImageFile	(	string	$upload_file,
		string	$upload_name
	)

Definition at line 611 of file class.assOrderingQuestion.php.

References assQuestion\buildHashedImageFilename(), ilShellUtil\convertImage(), ensureImagePathExists(), assQuestion\getImagePath(), getThumbPrefix(), assQuestion\getThumbSize(), and ilFileUtils\moveUploadedFile().

                                                                             : ?string
     {
         $name_parts = explode(".", $upload_name);
         $suffix = strtolower(array_pop($name_parts));
         if (!in_array($suffix, self::VALID_UPLOAD_SUFFIXES)) {
             return null;
         }
 
         $this->ensureImagePathExists();
         $target_filename = $this->buildHashedImageFilename($upload_name, true);
         $target_filepath = $this->getImagePath() . $target_filename;
         if (ilFileUtils::moveUploadedFile($upload_file, $target_filename, $target_filepath)) {
             $thumb_path = $this->getImagePath() . $this->getThumbPrefix() . $target_filename;
             ilShellUtil::convertImage($target_filepath, $thumb_path, "JPEG", (string) $this->getThumbSize());
 
             return $target_filename;
         }
 
         return null;
     }

Here is the call graph for this function:

◆ toJSON()

assOrderingQuestion::toJSON ( )

Returns a JSON representation of the question.

Implements ILIAS\TestQuestionPool\Questions\QuestionLMExportable.

Definition at line 838 of file class.assOrderingQuestion.php.

References ilObjMediaObject\_getMobsOfObject(), assQuestion\formatSAQuestion(), assQuestion\getId(), assQuestion\getImagePathWeb(), assQuestion\getNrOfTries(), getOrderingElementList(), getOrderingType(), assQuestion\getPoints(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffler(), and assQuestion\getTitleForHTMLOutput().

                             : string
     {
         $result = [];
         $result['id'] = $this->getId();
         $result['type'] = (string) $this->getQuestionType();
         $result['title'] = $this->getTitleForHTMLOutput();
         $result['question'] = $this->formatSAQuestion($this->getQuestion());
         $result['nr_of_tries'] = $this->getNrOfTries();
         $result['shuffle'] = true;
         $result['points'] = $this->getPoints();
         $result['feedback'] = [
             'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
             'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
         ];
         if ($this->getOrderingType() == self::OQ_PICTURES) {
             $result['path'] = $this->getImagePathWeb();
         }
 
         $counter = 1;
         $answers = [];
         foreach ($this->getOrderingElementList() as $orderingElement) {
             $answers[$counter] = $orderingElement->getContent();
             $counter++;
         }
         $answers = $this->getShuffler()->transform($answers);
         $arr = [];
         foreach ($answers as $order => $answer) {
             array_push($arr, [
                 "answertext" => (string) $answer,
                 "order" => (int) $order
             ]);
         }
         $result['answers'] = $arr;
 
         $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
         $result['mobs'] = $mobs;
 
         return json_encode($result);
     }

Here is the call graph for this function:

◆ toLog()

assOrderingQuestion::toLog ( AdditionalInformationGenerator $additional_info )

Implements ILIAS\TestQuestionPool\Questions\Question.

Definition at line 1261 of file class.assOrderingQuestion.php.

References assQuestion\formatSAQuestion(), getOrderingType(), getOrderingTypeLangVars(), assQuestion\getPoints(), assQuestion\getQuestion(), getQuestionType(), getSolutionOutputForLog(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTagForLangVar(), and assQuestion\getTitleForHTMLOutput().

                                                                           : array
     {
         return [
             AdditionalInformationGenerator::KEY_QUESTION_TYPE => (string) $this->getQuestionType(),
             AdditionalInformationGenerator::KEY_QUESTION_TITLE => $this->getTitleForHTMLOutput(),
             AdditionalInformationGenerator::KEY_QUESTION_TEXT => $this->formatSAQuestion($this->getQuestion()),
             AdditionalInformationGenerator::KEY_QUESTION_ORDERING_NESTING_TYPE => array_reduce(
                 $this->getOrderingTypeLangVars($this->getOrderingType()),
                 static fn(string $string, string $lang_var) => $string . $additional_info->getTagForLangVar($lang_var),
                 ''
             ),
             AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $this->getPoints(),
             AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION => $this->getSolutionOutputForLog(),
             AdditionalInformationGenerator::KEY_FEEDBACK => [
                 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_INCOMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_COMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
             ]
         ];
     }

Here is the call graph for this function:

◆ updateImageFile()

assOrderingQuestion::updateImageFile ( string $existing_image_name )

Definition at line 632 of file class.assOrderingQuestion.php.

References assQuestion\buildHashedImageFilename(), ilShellUtil\convertImage(), assQuestion\getImagePath(), getThumbPrefix(), assQuestion\getThumbSize(), and ilFileUtils\rename().

                                                                 : ?string
     {
         $existing_image_path = $this->getImagePath() . $existing_image_name;
         $target_filename = $this->buildHashedImageFilename($existing_image_name, true);
         $target_filepath = $this->getImagePath() . $target_filename;
         if (ilFileUtils::rename($existing_image_path, $target_filepath)) {
             unlink($this->getImagePath() . $this->getThumbPrefix() . $existing_image_name);
             $thumb_path = $this->getImagePath() . $this->getThumbPrefix() . $target_filename;
             ilShellUtil::convertImage($target_filepath, $thumb_path, "JPEG", (string) $this->getThumbSize());
 
             return $target_filename;
         }
 
         return $existing_image_name;
     }

Here is the call graph for this function:

◆ validateSolutionSubmit()

assOrderingQuestion::validateSolutionSubmit ( )

Implements ILIAS\TestQuestionPool\Questions\Question.

Definition at line 648 of file class.assOrderingQuestion.php.

References getOrderingElementList(), and getSolutionListFromPostSubmit().

Referenced by savePreviewData().

                                             : bool
     {
         $submittedSolutionList = $this->getSolutionListFromPostSubmit();
 
         if (!$submittedSolutionList->hasElements()) {
             return true;
         }
 
         return $this->getOrderingElementList()->hasSameElementSetByRandomIdentifiers($submittedSolutionList);
     }