Inheritance diagram for ilObjTest:

Collaboration diagram for ilObjTest:

Public Member Functions
	getLocalDIC ()

	getTestLogger ()

	getTestLogViewer ()

	getQuestionSetConfig ()

	getTitleFilenameCompliant ()
	returns the object title prepared to be used as a filename More...

	getTmpCopyWizardCopyId ()

	setTmpCopyWizardCopyId (int $tmpCopyWizardCopyId)

	create ()

	update ()

	read ()

	delete ()

	deleteTest ()

	createExportDirectory ()
	creates data directory for export files (data_dir/tst_data/tst_<id>/export, depending on data directory that is set in ILIAS setup/ini) More...

	getExportDirectory ()

	isComplete (ilTestQuestionSetConfig $test_question_set_config)

	saveCompleteStatus (ilTestQuestionSetConfig $test_question_set_config)

	saveToDb (bool $properties_only=false)

	saveQuestionsToDb ()

	copyQuestions (array $question_ids)

	getNrOfResultsForPass ($active_id, $pass)
	Calculates the number of user results for a specific test pass. More...

	loadFromDb ()

	loadQuestions (int $active_id=0, ?int $pass=null)
	Load the test question id's from the database. More...

	getIntroduction ()

	getFinalStatement ()

	getTestId ()
	Gets the database id of the additional test data. More...

	isPostponingEnabled ()

	isScoreReportingEnabled ()

	getAnswerFeedbackPoints ()

	getGenericAnswerFeedback ()

	getInstantFeedbackSolution ()

	getCountSystem ()

	getScoreCutting ()
	Determines if the score of a question should be cut at 0 points or the score of the whole test. More...

	getPassScoring ()
	Gets the pass scoring type. More...

	getMarkSchema ()

	storeMarkSchema (MarkSchema $mark_schema)

	getNrOfTries ()

	isBlockPassesAfterPassedEnabled ()

	getKioskMode ()

	getShowKioskModeTitle ()

	getShowKioskModeParticipant ()

	getUsePreviousAnswers ()

	getTitleOutput ()

	isPreviousSolutionReuseEnabled ($active_id)

	getProcessingTime ()

	getProcessingTimeInSeconds (int $active_id=0)

	getEnableProcessingTime ()

	getResetProcessingTime ()

	isStartingTimeEnabled ()

	getStartingTime ()

	isEndingTimeEnabled ()

	getEndingTime ()

	getRedirectionMode ()

	isRedirectModeKiosk ()

	isRedirectModeNone ()

	getRedirectionUrl ()

	isPasswordEnabled ()

	getPassword ()

	removeQuestionsWithResults (array $question_ids)

	removeQuestionFromSequences (int $question_id, array $active_ids, ilTestReindexedSequencePositionMap $reindexed_sequence_position_map)

	removeQuestions (array $question_ids)

	removeQuestion (int $question_id)

	removeTestResultsFromSoapLpAdministration (array $user_ids)

	removeTestResults (ilTestParticipantData $participant_data)

	removeTestResultsByUserIds (array $user_ids)

	removeTestActives (array $active_ids)

	questionMoveUp ($question_id)
	Moves a question up in order. More...

	questionMoveDown ($question_id)
	Moves a question down in order. More...

	duplicateQuestionForTest ($question_id)
	Takes a question and creates a copy of the question for use in the test. More...

	insertQuestion (int $question_id, bool $link_only=false)

	getQuestionTitlesAndIndexes ()
	Returns the titles of the test questions in question sequence. More...

	getQuestionTitle ($title, $nr=null, $points=null)
	Returns the title of a test question and checks if the title output is allowed. More...

	getQuestionDataset ($question_id)
	Returns the dataset for a given question id. More...

&	getExistingQuestions ($pass=null)
	Get the id's of the questions which are already part of the test. More...

	getQuestionType ($question_id)
	Returns the question type of a question with a given id. More...

	startWorkingTime ($active_id, $pass)
	Write the initial entry for the tests working time to the database. More...

	updateWorkingTime ($times_id)
	Update the working time of a test when a question is answered. More...

&	getWorkedQuestions ($active_id, $pass=null)
	Gets the id's of all questions a user already worked through. More...

	isTestFinishedToViewResults ($active_id, $currentpass)
	Returns true if an active user completed a test pass and did not start a new pass. More...

	getAllQuestions ($pass=null)
	Returns all questions of a test in test order. More...

	getActiveIdOfUser ($user_id="", $anonymous_id="")
	Gets the active id of a given user. More...

	pcArrayShuffle ($array)
	Shuffles the values of a given array. More...

	getTestResult (int $active_id, ?int $pass=null, bool $ordered_sequence=false, bool $consider_hidden_questions=true, bool $consider_optional_questions=true)
	Calculates the results of a test for a given user and returns an array with all test results. More...

	evalTotalPersons ()
	Returns the number of persons who started the test. More...

	getCompleteWorkingTime ($user_id)
	Returns the complete working time in seconds a user worked on the test. More...

&	getCompleteWorkingTimeOfParticipants ()
	Returns the complete working time in seconds for all test participants. More...

&	_getCompleteWorkingTimeOfParticipants ($test_id)
	Returns the complete working time in seconds for all test participants. More...

	getCompleteWorkingTimeOfParticipant ($active_id)
	Returns the complete working time in seconds for a test participant. More...

	getWorkingTimeOfParticipantForPass (int $active_id, int $pass)

	evalStatistical ($active_id)
	Returns the statistical evaluation of the test for a specified user. More...

	getTotalPointsPassedArray ()
	Returns an array with the total points of all users who passed the test This array could be used for statistics. More...

	getParticipants ()
	Returns all persons who started the test. More...

	evalTotalPersonsArray (string $name_sort_order='asc')

	evalTotalParticipantsArray (string $name_sort_order='asc')

	getQuestionsOfTest (int $active_id)

	getQuestionsOfPass (int $active_id, int $pass)

	getAccessFilteredParticipantList ()

	setAccessFilteredParticipantList (ilTestParticipantList $access_filtered_participant_list)

	buildStatisticsAccessFilteredParticipantList ()

	getUnfilteredEvaluationData ()

	getQuestionCountAndPointsForPassOfParticipant (int $active_id, int $pass)

	getCompleteEvaluationData ($filterby='', $filtertext='')

	buildName (?int $user_id, ?string $firstname, ?string $lastname)
	Builds a user name for the output depending on test type and existence of the user. More...

	evalTotalStartedAverageTime (?array $active_ids_to_filter=null)

	getAvailableQuestionpools (bool $use_object_id=false, ?bool $equal_points=false, bool $could_be_offline=false, bool $show_path=false, bool $with_questioncount=false, string $permission='read')
	Returns the available question pools for the active user. More...

	getImagePath ()
	Returns the image path for web accessable images of a test The image path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_TEST/images. More...

	getImagePathWeb ()
	Returns the web image path for web accessable images of a test The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_TEST/images. More...

	createQuestionGUI ($question_type, $question_id=-1)
	Creates a question GUI instance of a given question type. More...

	moveQuestions (array $move_questions, int $target_index, int $insert_mode)

	startingTimeReached ()
	Returns true if the starting time of a test is reached A starting time is not available for self assessment tests. More...

	endingTimeReached ()
	Returns true if the ending time of a test is reached An ending time is not available for self assessment tests. More...

	getAvailableQuestions ($arr_filter, $completeonly=0)
	Calculates the available questions for a test. More...

	fromXML (ilQTIAssessment $assessment, array $mappings)
	Receives parameters from a QTI parser and creates a valid ILIAS test object. More...

	toXML ()
	Returns a QTI xml representation of the test. More...

	exportPagesXML (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog)
	export pages of test to xml (see ilias_co.dtd) More...

	modifyExportIdentifier ($a_tag, $a_param, $a_value)
	Returns the installation id for a given identifier. More...

	exportXMLPageObjects (&$a_xml_writer, $inst, &$expLog)
	export page objects to xml (see ilias_co.dtd) More...

	exportXMLMediaObjects (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog)
	export media objects to xml (see ilias_co.dtd) More...

	exportFileItems ($target_dir, &$expLog)
	export files of file itmes More...

	getImportMapping ()
	get array of (two) new created questions for import id More...

	onMarkSchemaSaved ()

	marksEditable ()

	saveAuthorToMetadata ($author="")
	Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be called for conversion of "old" tests where the author hasn't been stored in the lifecycle metadata. More...

	getAuthor ()
	Gets the authors name of the ilObjTest object. More...

	cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false)
	Clone object. More...

	getQuestionCount ()

	getQuestionCountWithoutReloading ()

	getTextAnswer ($active_id, $question_id, $pass=null)
	Returns the text answer of a given user for a given question. More...

	getQuestiontext ($question_id)
	Returns the question text for a given question. More...

	getActiveParticipantList ()

&	getInvitedUsers (int $user_id=0, $order="login, lastname, firstname")
	Returns a list of all invited users in a test. More...

	getTestParticipants ()

	getTestParticipantsForManualScoring ($filter=null)

	getUserData ($ids)
	Returns a data of all users specified by id list. More...

	getGroupData ($ids)

	getRoleData ($ids)

	inviteUser ($user_id, $client_ip="")
	Invites a user to a test. More...

	setQuestionSetSolved ($value, $question_id, $user_id)
	sets question solved state to value for given user_id More...

	isTestFinished ($active_id)
	returns if the active for user_id has been submitted More...

	isActiveTestSubmitted ($user_id=null)
	returns if the active for user_id has been submitted More...

	hasNrOfTriesRestriction ()
	returns if the numbers of tries have to be checked More...

	isNrOfTriesReached ($tries)
	returns if number of tries are reached More...

	getAllTestResults ($participants)
	returns all test results for all participants More...

	getAnsweredQuestionCount ($active_id, $pass=null)
	Retrieves the number of answered questions for a given user in a given test. More...

	isExecutable ($test_session, $user_id, $allow_pass_increase=false)
	Checks if the test is executable by the given user. More...

	isNextPassAllowed (ilTestPassesSelector $testPassesSelector, int &$next_pass_allowed_timestamp)

	canShowTestResults (ilTestSession $test_session)

	hasAnyTestResult (ilTestSession $test_session)

	getStartingTimeOfUser ($active_id, $pass=null)
	Returns the unix timestamp of the time a user started a test. More...

	isMaxProcessingTimeReached (int $starting_time, int $active_id)
	Returns whether the maximum processing time for a test is reached or not. More...

	getTestQuestions ()

	isTestQuestion (int $question_id)

	checkQuestionParent (int $question_id)

	getFixedQuestionSetTotalPoints ()

	getPotentialRandomTestQuestions ()

	getShuffleQuestions ()

	getListOfQuestionsSettings ()
	Returns the settings for the list of questions options in the test properties This could contain one of the following values: 0 = No list of questions offered 1 = A list of questions is offered 3 = A list of questions is offered and the list of questions is shown as first page of the test 5 = A list of questions is offered and the list of questions is shown as last page of the test 7 = A list of questions is offered and the list of questions is shown as first and last page of the test. More...

	getListOfQuestions ()

	getUsrPassOverviewEnabled ()

	getListOfQuestionsStart ()

	getListOfQuestionsEnd ()

	getListOfQuestionsDescription ()

	getShowPassDetails ()
	Returns if the pass details should be shown when a test is not finished. More...

	getShowSolutionPrintview ()
	Returns if the solution printview should be presented to the user or not. More...

	canShowSolutionPrintview ($user_id=null)

	getShowSolutionFeedback ()
	Returns if the feedback should be presented to the solution or not. More...

	getShowSolutionAnswersOnly ()
	Returns if the full solution (including ILIAS content) should be presented to the solution or not. More...

	getShowSolutionSignature ()
	Returns if the signature field should be shown in the test results. More...

	getShowSolutionSuggested ()

	getShowSolutionListComparison ()

	getShowSolutionListOwnAnswers ()

	_getLastAccess (int $active_id)

	isHTML ($a_text)
	Checks if a given string contains HTML or not. More...

	qtiMaterialToArray ($a_material)
	Reads an QTI material tag and creates a text string. More...

	addQTIMaterial (ilXmlWriter &$xml_writer, ?int $page_id, string $material='')

	prepareTextareaOutput ($txt_output, $prepare_for_latex_output=false, $omitNl2BrWhenTextArea=false)
	Prepares a string for a text area output in tests. More...

	getAnonymity ()

	getShowCancel ()

	getShowMarker ()

	getFixedParticipants ()

	lookupQuestionSetTypeByActiveId (int $active_id)

	userLookupFullName ($user_id, $overwrite_anonymity=false, $sorted_order=false, $suffix="")
	Returns the full name of a test user according to the anonymity status. More...

	getAvailableDefaults ()
	Returns the available test defaults for the active user. More...

	getTestDefaults ($test_defaults_id)

	deleteDefaults ($test_default_id)

	addDefaults ($a_name)
	Adds the defaults of this test to the test defaults. More...

	applyDefaults (array $test_defaults)

	processPrintoutput2FO ($print_output)
	Convert a print output to XSL-FO. More...

	deliverPDFfromHTML ($content, $title=null)
	Delivers a PDF file from XHTML. More...

	deliverPDFfromFO ($fo, $title=null)
	Delivers a PDF file from a XSL-FO string. More...

	getCompleteManualFeedback (int $question_id)
	Retrieves the manual feedback for a question in a test. More...

	saveManualFeedback (int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized=false)

	getJavaScriptOutput ()
	Returns if Javascript should be chosen for drag & drop actions for the active user. More...

&	createTestSequence ($active_id, $pass, $shuffle)

	setTestId ($a_id)
	Sets the test ID. More...

	getDetailedTestResults ($participants)
	returns all test results for all participants More...

	isPluginActive ($a_pname)
	Checks wheather or not a question plugin with a given name is active. More...

	getPassed ($active_id)

	getParticipantsForTestAndQuestion ($test_id, $question_id)
	Creates an associated array with all active id's for a given test and original question id. More...

	getAggregatedResultsData ()

	getXMLZip ()
	Get zipped xml file for test. More...

	getMailNotification ()

	sendSimpleNotification ($active_id)

	sendAdvancedNotification (int $active_id)

	getResultsForActiveId (int $active_id)

	getMailNotificationType ()

	getExportSettings ()

	setTemplate (int $template_id)

	getTemplate ()

	reindexFixedQuestionOrdering ()

	setQuestionOrder (array $order)

	hasQuestionsWithoutQuestionpool ()

	getQuestions ()

	isOnline ()

	isOfferingQuestionHintsEnabled ()

	setActivationVisibility ($a_value)

	getActivationVisibility ()

	isActivationLimited ()

	setActivationLimited ($a_value)

	storeActivationSettings (?bool $is_activation_limited=false, ?int $activation_starting_time=null, ?int $activation_ending_time=null, bool $activation_visibility=false,)

	getIntroductionPageId ()

	getConcludingRemarksPageId ()

	getHighscoreEnabled ()

	getHighscoreAnon ()
	Gets if the highscores should be anonymized per setting. More...

	isHighscoreAnon ()
	Gets if the highscores should be displayed anonymized. More...

	getHighscoreAchievedTS ()
	Returns if date and time of the scores achievement should be displayed. More...

	getHighscoreScore ()
	Gets if the score column should be shown. More...

	getHighscorePercentage ()
	Gets if the percentage column should be shown. More...

	getHighscoreHints ()
	Gets, if the column with the number of requested hints should be shown. More...

	getHighscoreWTime ()
	Gets if the column with the workingtime should be shown. More...

	getHighscoreOwnTable ()
	Gets if the own rankings table should be shown. More...

	getHighscoreTopTable ()
	Gets, if the top-rankings table should be shown. More...

	getHighscoreTopNum (int $a_retval=10)
	Gets the number of entries which are to be shown in the top-rankings table. More...

	getHighscoreMode ()

	getSpecificAnswerFeedback ()

	getAutosave ()

	isPassDeletionAllowed ()

	getEnableExamview ()

	setActivationStartingTime (?int $starting_time=null)

	setActivationEndingTime (?int $ending_time=null)

	getActivationStartingTime ()

	getActivationEndingTime ()

	getStartingTimeOfParticipants ()
	Note, this function should only be used if absolutely necessary, since it perform joins on tables that tend to grow huge and returns vast amount of data. More...

	getTimeExtensionsOfParticipants ()

	getMaxPassOfTest ()

	isShowExamIdInTestPassEnabled ()

	isShowExamIdInTestResultsEnabled ()

	setQuestionSetType (string $question_set_type)

	getQuestionSetType ()

	isFixedTest ()
	Returns the fact wether this test is a fixed question set test or not. More...

	isRandomTest ()
	Returns the fact wether this test is a random questions test or not. More...

	getQuestionSetTypeTranslation (ilLanguage $lng, $questionSetType)

	participantDataExist ()

	recalculateScores ($preserve_manscoring=false)

	isSkillServiceEnabled ()

	isSkillServiceToBeConsidered ()
	Returns whether this test must consider skills, usually by providing appropriate extensions in the user interface components. More...

	isShowGradingStatusEnabled ()

	isShowGradingMarkEnabled ()

	isFollowupQuestionAnswerFixationEnabled ()

	isInstantFeedbackAnswerFixationEnabled ()

	isForceInstantFeedbackEnabled ()

	adjustTestSequence ()

	getGeneralQuestionPropertiesRepository ()

	getGlobalSettings ()

	getMainSettings ()

	getMainSettingsRepository ()

	getScoreSettings ()

	getScoreSettingsRepository ()

	updateTestResultCache (int $active_id, ?ilAssQuestionProcessLocker $process_locker=null)

	updateTestPassResults (int $active_id, int $pass, ?ilAssQuestionProcessLocker $process_locker=null, ?int $test_obj_id=null)

	addToNewsOnOnline (bool $old_online_status, bool $new_online_status)

	getVisitingTimeOfParticipant (int $active_id)

Public Member Functions inherited from ilObject
	getObjectProperties ()

	flushObjectProperties ()

	withReferences ()
	determines whether objects are referenced or not (got ref ids or not) More...

	processAutoRating ()

	read ()

	getId ()

	setId (int $id)

	setRefId (int $ref_id)

	getRefId ()

	getType ()

	setType (string $type)

	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...

	getTitle ()

	getUntranslatedTitle ()
	Get untranslated object title WebDAV needs to access the untranslated title of an object. More...

	setTitle (string $title)

	getDescription ()

	setDescription (string $description)

	getLongDescription ()
	get object long description (stored in object_description) More...

	getImportId ()

	setImportId (string $import_id)

	setOfflineStatus (bool $status)

	getOfflineStatus ()

	supportsOfflineHandling ()

	getOwner ()

	getOwnerName ()
	get full name of object owner More...

	setOwner (int $usr_id)

	getCreateDate ()
	Get create date in YYYY-MM-DD HH-MM-SS format. More...

	getLastUpdateDate ()
	Get last update date in YYYY-MM-DD HH-MM-SS format. More...

	create ()
	note: title, description and type should be set when this function is called More...

	update ()

	MDUpdateListener (string $element)
	Metadata update listener. More...

	createMetaData ()

	updateMetaData ()

	deleteMetaData ()

	updateOwner ()
	update owner of object in db More...

	putInTree (int $parent_ref_id)
	maybe this method should be in tree object!? More...

	setPermissions (int $parent_ref_id)

	setParentRolePermissions (int $parent_ref_id)
	Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More...

	createReference ()
	creates reference for object More...

	countReferences ()

	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...

	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type. More...

	applyDidacticTemplate (int $tpl_id)

	getXMLZip ()

	getHTMLDirectory ()

	appendCopyInfo (int $target_id, int $copy_id)
	Prepend Copy info if object with same name exists in that container. More...

	cloneDependencies (int $target_id, int $copy_id)
	Clone object dependencies. More...

	cloneMetaData (ilObject $target_obj)
	Copy meta data. More...

	selfOrParentWithRatingEnabled ()

	getPossibleSubObjects (bool $filter=true)
	get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More...

Static Public Member Functions
static	_createImportDirectory ()
	creates data directory for import files (data_dir/tst_data/tst_<id>/import, depending on data directory that is set in ILIAS setup/ini) More...

static	_getCountSystem ($active_id)

static	_getPassScoring (int $active_id)
	Gets the pass scoring type. More...

static	_getScoreCutting (int $active_id)
	Determines if the score of a question should be cut at 0 points or the score of the whole test. More...

static	_getActiveIdOfUser ($user_id="", $test_id="")

static	_instanciateQuestion ($question_id)
	Creates an instance of a question with a given question id. More...

static	_lookupAuthor ($obj_id)
	Gets the authors name of the ilObjTest object. More...

static	_getAvailableTests ($use_object_id=false)
	Returns the available tests for the active user. More...

static	_getObjectIDFromTestID ($test_id)
	Returns the ILIAS test object id for a given test id. More...

static	_getObjectIDFromActiveID ($active_id)
	Returns the ILIAS test object id for a given active id. More...

static	_getTestIDFromObjectID ($object_id)
	Returns the ILIAS test id for a given object id. More...

static	_getSolvedQuestions ($active_id, $question_fi=null)
	get solved questions More...

static	_getPass ($active_id)
	Retrieves the actual pass of a given user for a given test. More...

static	_getMaxPass ($active_id)
	Retrieves the maximum pass of a given user for a given test in which the user answered at least one question. More...

static	_getBestPass ($active_id)
	Retrieves the best pass of a given user for a given test. More...

static	_getResultPass ($active_id)
	Retrieves the pass number that should be counted for a given user. More...

static	lookupPassResultsUpdateTimestamp ($active_id, $pass)

static	_getUserIdFromActiveId (int $active_id)

static	_lookupAnonymity ($a_obj_id)

static	getManualFeedback (int $active_id, int $question_id, ?int $pass)
	Retrieves the feedback comment for a question in a test if it is finalized. More...

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

static	_lookupTestObjIdForQuestionId (int $q_id)
	Get test Object ID for question ID. More...

static	_lookupFinishedUserTests ($a_user_id)
	Gather all finished tests for user. More...

static	lookupExamId ($active_id, $pass)

static	buildExamId ($active_id, $pass, $test_obj_id=null)

static	getTestObjIdsWithActiveForUserId ($userId)

static	isSkillManagementGloballyActivated ()

static	isParticipantsLastPassActive (int $test_ref_id, int $user_id)

static	_lookupRandomTest (int $obj_id)

Static Public Member Functions inherited from ilObject
static	_lookupObjIdByImportId (string $import_id)
	Get (latest) object id for an import id. More...

static	_lookupImportId (int $obj_id)

static	_lookupOwnerName (int $owner_id)
	Lookup owner name for owner id. More...

static	_getIdForImportId (string $import_id)

static	_getAllReferences (int $id)
	get all reference ids for object ID More...

static	_lookupTitle (int $obj_id)

static	lookupOfflineStatus (int $obj_id)
	Lookup offline status using objectDataCache. More...

static	_lookupOwner (int $obj_id)
	Lookup owner user ID for object ID. More...

static	_getIdsForTitle (string $title, string $type='', bool $partial_match=false)

static	_lookupDescription (int $obj_id)

static	_lookupLastUpdate (int $obj_id, bool $formatted=false)

static	_getLastUpdateOfObjects (array $obj_ids)

static	_lookupObjId (int $ref_id)

static	_setDeletedDate (int $ref_id, int $deleted_by)

static	setDeletedDates (array $ref_ids, int $user_id)

static	_resetDeletedDate (int $ref_id)

static	_lookupDeletedDate (int $ref_id)

static	_writeTitle (int $obj_id, string $title)
	write title to db (static) More...

static	_writeDescription (int $obj_id, string $desc)
	write description to db (static) More...

static	_writeImportId (int $obj_id, string $import_id)
	write import id to db (static) More...

static	_lookupType (int $id, bool $reference=false)

static	_isInTrash (int $ref_id)

static	_hasUntrashedReference (int $obj_id)
	checks whether an object has at least one reference that is not in trash More...

static	_lookupObjectId (int $ref_id)

static	_getObjectsDataForType (string $type, bool $omit_trash=false)
	get all objects of a certain type More...

static	_exists (int $id, bool $reference=false, ?string $type=null)
	checks if an object exists in object_data More...

static	_getObjectsByType (string $obj_type="", ?int $owner=null)

static	_prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true)
	Prepare copy wizard object selection. More...

static	getIconForType (string $type)

static	_getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false)
	Get icon for repository item. More...

static	collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0)
	Collect deletion dependencies. More...

static	getDeletionDependencies (int $obj_id)
	Get deletion dependencies. More...

static	getLongDescriptions (array $obj_ids)

static	getAllOwnedRepositoryObjects (int $user_id)

static	fixMissingTitles ($type, array &$obj_title_map)
	Try to fix missing object titles. More...

static	_lookupCreationDate (int $obj_id)

static	_getObjectTypeIdByTitle (string $type, ?\ilDBInterface $ilDB=null)

Data Fields
const	QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET'

const	QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET'

const	INVITATION_OFF = 0

const	INVITATION_ON = 1

const	SCORE_LAST_PASS = 0

const	SCORE_BEST_PASS = 1

const	REDIRECT_NONE = 0

const	REDIRECT_ALWAYS = 1

const	REDIRECT_KIOSK = 2

int	$test_id = -1

int	$invitation = self::INVITATION_OFF

string	$author

	$metadata
	A reference to an IMS compatible matadata set. More...

array	$questions = []

	$evaluation_data
	Contains the evaluation data settings the tutor defines for the user. More...

	$test_sequence = false
	contains the test sequence data More...

Data Fields inherited from ilObject
const	TITLE_LENGTH = 255

const	DESC_LENGTH = 128

const	LONG_DESC_LENGTH = 4000

const	TABLE_OBJECT_DATA = "object_data"

array	$objectList

string	$untranslatedTitle

Protected Member Functions
	buildIso8601PeriodForExportCompatibility (DateTimeImmutable $date_time)

	buildDateTimeImmutableFromPeriod (?string $period)

	doCreateMetaData ()

	secondsToHoursMinutesSecondsString (int $seconds)

	getHtmlQuestionContentPurifier ()

Protected Member Functions inherited from ilObject
	doMDUpdateListener (string $a_element)

	beforeMDUpdateListener (string $a_element)

	doCreateMetaData ()

	beforeCreateMetaData ()

	doUpdateMetaData ()

	beforeUpdateMetaData ()

	doDeleteMetaData ()

	beforeDeleteMetaData ()

	handleAutoRating ()

	hasAutoRating ()

Protected Attributes
GeneralQuestionPropertiesRepository	$questionrepository

bool	$print_best_solution_with_result = true

bool	$activation_visibility = false

int	$activation_starting_time = null

int	$activation_ending_time = null

ilCtrlInterface	$ctrl

Refinery	$refinery

ilSetting	$settings

ilBenchmark	$bench

ilTestParticipantAccessFilterFactory	$participant_access_filter

GlobalSettingsRepository	$global_settings_repo

MainSettings	$main_settings = null

MainSettingsRepository	$main_settings_repo = null

ScoreSettings	$score_settings = null

ScoreSettingsRepository	$score_settings_repo = null

TestLogger	$logger

TestLogViewer	$log_viewer

ilTestQuestionSetConfigFactory	$question_set_config_factory

ExportImportFactory	$export_factory

ilTestParticipantList	$access_filtered_participant_list = null

ParticipantRepository	$participant_repository

LOMetadata	$lo_metadata

Protected Attributes inherited from ilObject
ilLogger	$obj_log

ILIAS	$ilias

ilObjectDefinition	$obj_definition

ilDBInterface	$db

ilLogger	$log

ilErrorHandling	$error

ilTree	$tree

ilAppEventHandler	$app_event_handler

ilRbacAdmin	$rbac_admin

ilRbacReview	$rbac_review

ilObjUser	$user

ilLanguage	$lng

LOMServices	$lom_services

bool	$call_by_reference

int	$max_title = self::TITLE_LENGTH

int	$max_desc = self::DESC_LENGTH

bool	$add_dots = true

int	$ref_id = null

string	$type = ""

string	$title = ""

string	$desc = ""

string	$long_desc = ""

int	$owner = 0

string	$create_date = ""

string	$last_update = ""

string	$import_id = ""

bool	$register = false

Private Member Functions
	cloneIntroduction ()

	cloneConcludingRemarks ()

	clonePage (int $source_page_id)

	getProcessingTimeForXML ()

	removeQuestionWithResults (int $question_id, TestScoring $scoring)

	removeTestResultsByActiveIds (array $active_ids)

	getQuestionTitles ()

	addIntroductionToSettingsFromImport (SettingsIntroduction $settings, array $material, string $importdir, array $mappings)

	addConcludingRemarksToSettingsFromImport (SettingsFinishing $settings, array $material, string $importdir, array $mappings)

	replaceMobsInPageImports (string $text, array $mappings)

	replaceFilesInPageImports (string $text, array $mappings)

	retrieveMobsFromLegacyImports (string $text, array $mobs, string $importdir)

	convertTimeToDateTimeImmutableIfNecessary (DateTimeImmutable\|int\|null $date_time)

	insertManualFeedback (int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized, array $feedback_old)

	getExtraTime (int $active_id)

Private Attributes
bool	$activation_limited = null

array	$mob_ids

array	$file_ids = []

bool	$online

RequestDataCollector	$testrequest

MarksRepository	$marks_repository

MarkSchema	$mark_schema = null

int	$template_id = 0

	$participantDataExist = null
	holds the fact wether participant data exists or not DO NOT USE TIS PROPERTY DRIRECTLY ALWAYS USE ilObjTest::paricipantDataExist() since this method initialises this property More...

int	$tmpCopyWizardCopyId = null

TestManScoringDoneHelper	$test_man_scoring_done_helper

ilComponentRepository	$component_repository

ilComponentFactory	$component_factory

Filesystem	$filesystem_web

Static Private Attributes
static	$isSkillManagementGloballyActivated = null

Detailed Description

Definition at line 64 of file class.ilObjTest.php.

Member Function Documentation

◆ _createImportDirectory()

static ilObjTest::_createImportDirectory ( )

static

creates data directory for import files (data_dir/tst_data/tst_<id>/import, depending on data directory that is set in ILIAS setup/ini)

Definition at line 400 of file class.ilObjTest.php.

References $DIC, ilObject\$ilias, ilFileUtils\delDir(), ilFileUtils\getDataDir(), ilFileUtils\makeDir(), and ILIAS\raiseError().

                                                    : string
     {
         global $DIC;
         $ilias = $DIC['ilias'];
         $tst_data_dir = ilFileUtils::getDataDir() . "/tst_data";
         ilFileUtils::makeDir($tst_data_dir);
 
         if (!is_writable($tst_data_dir)) {
             $ilias->raiseError("Test Data Directory (" . $tst_data_dir
                 . ") not writeable.", $ilias->error_obj->FATAL);
         }
 
         // create test directory (data_dir/tst_data/tst_import)
         $tst_dir = $tst_data_dir . "/tst_import";
         ilFileUtils::makeDir($tst_dir);
         if (!@is_dir($tst_dir)) {
             $ilias->raiseError("Creation of test import directory failed.", $ilias->error_obj->FATAL);
         }
 
         // assert that this is empty and does not contain old data
         ilFileUtils::delDir($tst_dir, true);
 
         return $tst_dir;
     }

Here is the call graph for this function:

◆ _getActiveIdOfUser()

static ilObjTest::_getActiveIdOfUser	(	$user_id = `""`,
		$test_id = `""`
	)

static

Definition at line 1740 of file class.ilObjTest.php.

References $DIC, $ilDB, and $user_id.

Referenced by ilLOUtils\getTestResultLinkForUser().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $ilUser = $DIC['ilUser'];
 
         if (!$user_id) {
             $user_id = $ilUser->id;
         }
         if (!$test_id) {
             return "";
         }
         $result = $ilDB->queryF(
             "SELECT tst_active.active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s",
             ['integer', 'integer'],
             [$user_id, $test_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return $row["active_id"];
         } else {
             return "";
         }
     }

Here is the caller graph for this function:

◆ _getAvailableTests()

static ilObjTest::_getAvailableTests ( $use_object_id = false )

static

Returns the available tests for the active user.

Returns: array The available tests public

Definition at line 4092 of file class.ilObjTest.php.

References $DIC, ilObject\$ref_id, ilUtil\_getObjectsByOperations(), ilObject\_lookupObjId(), and ilObject\_prepareCloneSelection().

                                                                      : array
     {
         global $DIC;
         $ilUser = $DIC['ilUser'];
 
         $result_array = [];
         $tests = array_slice(
             array_reverse(
                 ilUtil::_getObjectsByOperations("tst", "write", $ilUser->getId(), PHP_INT_MAX)
             ),
             0,
             10000
         );
 
         if (count($tests)) {
             $titles = ilObject::_prepareCloneSelection($tests, "tst");
             foreach ($tests as $ref_id) {
                 if ($use_object_id) {
                     $obj_id = ilObject::_lookupObjId($ref_id);
                     $result_array[$obj_id] = $titles[$ref_id];
                 } else {
                     $result_array[$ref_id] = $titles[$ref_id];
                 }
             }
         }
         return $result_array;
     }

Here is the call graph for this function:

◆ _getBestPass()

static ilObjTest::_getBestPass ( $active_id )

static

Retrieves the best pass of a given user for a given test.

Parameters

int $active_id

Returns: int|mixed

Definition at line 4836 of file class.ilObjTest.php.

References $DIC, $ilDB, and null.

Referenced by _getResultPass().

                                                    : ?int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT * FROM tst_pass_result WHERE active_fi = %s",
             ['integer'],
             [$active_id]
         );
 
         if (!$result->numRows()) {
             return null;
         }
 
         $bestrow = null;
         $bestfactor = 0.0;
         while ($row = $ilDB->fetchAssoc($result)) {
             if ($row["maxpoints"] > 0.0) {
                 $factor = (float) ($row["points"] / $row["maxpoints"]);
             } else {
                 $factor = 0.0;
             }
             if ($factor === 0.0 && $bestfactor === 0.0
                 || $factor > $bestfactor) {
                 $bestrow = $row;
                 $bestfactor = $factor;
             }
         }
 
         if (is_array($bestrow)) {
             return $bestrow["pass"];
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ _getCompleteWorkingTimeOfParticipants()

& ilObjTest::_getCompleteWorkingTimeOfParticipants ( $test_id )

Returns the complete working time in seconds for all test participants.

Parameters

integer $test_id The database ID of the test

Returns: array An array containing the working time in seconds for all test participants public

Definition at line 2040 of file class.ilObjTest.php.

Referenced by getCompleteWorkingTimeOfParticipants().

                                                                     : array
     {
         $result = $this->db->queryF(
             "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.test_fi = %s AND tst_active.active_id = tst_times.active_fi ORDER BY tst_times.active_fi, tst_times.started",
             ['integer'],
             [$test_id]
         );
         $time = 0;
         $times = [];
         while ($row = $this->db->fetchAssoc($result)) {
             if (!array_key_exists($row["active_fi"], $times)) {
                 $times[$row["active_fi"]] = 0;
             }
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             $times[$row["active_fi"]] += ($epoch_2 - $epoch_1);
         }
         return $times;
     }

Here is the caller graph for this function:

◆ _getCountSystem()

static ilObjTest::_getCountSystem ( $active_id )

static

Definition at line 766 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by assQuestion\adjustReachedPointsByScoringOptions().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT tst_tests.count_system FROM tst_tests, tst_active WHERE tst_active.active_id = %s AND tst_active.test_fi = tst_tests.test_id",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return $row["count_system"];
         }
         return false;
     }

Here is the caller graph for this function:

◆ _getLastAccess()

ilObjTest::_getLastAccess ( int $active_id )

Definition at line 5386 of file class.ilObjTest.php.

References $DIC, $ilDB, $res, and null.

                                                   : string
     {
         $result = $this->db->queryF(
             "SELECT finished FROM tst_times WHERE active_fi = %s ORDER BY finished DESC",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $this->db->fetchAssoc($result);
             return $row["finished"];
         }
         return "";
     }

◆ _getMaxPass()

static ilObjTest::_getMaxPass ( $active_id )

static

Retrieves the maximum pass of a given user for a given test in which the user answered at least one question.

Parameters

integer	$user_id	The user id
integer	$test_id	The test id

Returns: integer The pass of the user for the given test public

Definition at line 4813 of file class.ilObjTest.php.

References $DIC, $ilDB, and null.

Referenced by _getResultPass(), and ilTestParticipantList\lookupNrOfTries().

                                                   : ?int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT MAX(pass) maxpass FROM tst_pass_result WHERE active_fi = %s",
             ['integer'],
             [$active_id]
         );
 
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return $row["maxpass"];
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ _getObjectIDFromActiveID()

static ilObjTest::_getObjectIDFromActiveID ( $active_id )

static

Returns the ILIAS test object id for a given active id.

Parameters

integer $active_id The active id

Returns: mixed The ILIAS test object id or FALSE if the query was not successful public

Definition at line 4276 of file class.ilObjTest.php.

References $DIC, and $ilDB.

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $object_id = false;
         $result = $ilDB->queryF(
             "SELECT tst_tests.obj_fi FROM tst_tests, tst_active WHERE tst_tests.test_id = tst_active.test_fi AND tst_active.active_id = %s",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             $object_id = $row["obj_fi"];
         }
         return $object_id;
     }

◆ _getObjectIDFromTestID()

static ilObjTest::_getObjectIDFromTestID ( $test_id )

static

Returns the ILIAS test object id for a given test id.

Parameters

integer $test_id The test id

Returns: mixed The ILIAS test object id or FALSE if the query was not successful public

Definition at line 4252 of file class.ilObjTest.php.

References $DIC, and $ilDB.

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $object_id = false;
         $result = $ilDB->queryF(
             "SELECT obj_fi FROM tst_tests WHERE test_id = %s",
             ['integer'],
             [$test_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             $object_id = $row["obj_fi"];
         }
         return $object_id;
     }

◆ _getPass()

static ilObjTest::_getPass ( $active_id )

static

Retrieves the actual pass of a given user for a given test.

Parameters

integer	$user_id	The user id
integer	$test_id	The test id

Returns: integer The pass of the user for the given test public

Definition at line 4787 of file class.ilObjTest.php.

References $DIC, and $ilDB.

                                                : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT tries FROM tst_active WHERE active_id = %s",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return $row["tries"];
         } else {
             return 0;
         }
     }

Here is the caller graph for this function:

◆ _getPassScoring()

static ilObjTest::_getPassScoring ( int $active_id )

static

Gets the pass scoring type.

Definition at line 801 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by _getResultPass().

                                                           : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT tst_tests.pass_scoring FROM tst_tests, tst_active WHERE tst_tests.test_id = tst_active.test_fi AND tst_active.active_id = %s",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return (int) $row["pass_scoring"];
         }
         return 0;
     }

Here is the caller graph for this function:

◆ _getResultPass()

static ilObjTest::_getResultPass ( $active_id )

static

Retrieves the pass number that should be counted for a given user.

Parameters

integer	$user_id	The user id
integer	$test_id	The test id

Returns: integer The result pass of the user for the given test public

Definition at line 4881 of file class.ilObjTest.php.

References _getBestPass(), _getMaxPass(), _getPassScoring(), and null.

Referenced by ILIAS\Test\Questions\Presentation\Printer\addQuestionResultForTestUsersToTemplate(), ilTestArchiver\createUserResultsForArchive(), evalStatistical(), getAllTestResults(), getDetailedTestResults(), getPassed(), ilTestServiceGUI\getPassOverviewTableData(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\performDeletePass(), ilTestEvaluationGUI\printResults(), ilTestEvaluationGUI\showResults(), and updateTestResultCache().

                                                      : ?int
     {
         $counted_pass = null;
         if (ilObjTest::_getPassScoring($active_id) == self::SCORE_BEST_PASS) {
             $counted_pass = ilObjTest::_getBestPass($active_id);
         } else {
             $counted_pass = ilObjTest::_getMaxPass($active_id);
         }
         return $counted_pass;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getScoreCutting()

static ilObjTest::_getScoreCutting ( int $active_id )

static

Determines if the score of a question should be cut at 0 points or the score of the whole test.

Definition at line 820 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by assQuestion\adjustReachedPointsByScoringOptions().

                                                            : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT tst_tests.score_cutting FROM tst_tests, tst_active WHERE tst_active.active_id = %s AND tst_tests.test_id = tst_active.test_fi",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return (bool) $row["score_cutting"];
         }
         return false;
     }

Here is the caller graph for this function:

◆ _getSolvedQuestions()

static ilObjTest::_getSolvedQuestions	(	$active_id,
		$question_fi = `null`
	)

static

get solved questions

Returns: array of int containing all question ids which have been set solved for the given user and test

Definition at line 4611 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by ilTestPlayerAbstractGUI\buildEditableStateQuestionNavigationGUI(), ilTestPlayerAbstractGUI\buildReadOnlyStateQuestionNavigationGUI(), ilTestService\getQuestionSummaryData(), and ilTestSequence\getSequenceSummary().

                                                                                : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         if (is_numeric($question_fi)) {
             $result = $ilDB->queryF(
                 "SELECT question_fi, solved FROM tst_qst_solved WHERE active_fi = %s AND question_fi=%s",
                 ['integer', 'integer'],
                 [$active_id, $question_fi]
             );
         } else {
             $result = $ilDB->queryF(
                 "SELECT question_fi, solved FROM tst_qst_solved WHERE active_fi = %s",
                 ['integer'],
                 [$active_id]
             );
         }
         $result_array = [];
         while ($row = $ilDB->fetchAssoc($result)) {
             $result_array[$row["question_fi"]] = $row;
         }
         return $result_array;
     }

Here is the caller graph for this function:

◆ _getTestIDFromObjectID()

static ilObjTest::_getTestIDFromObjectID ( $object_id )

static

Returns the ILIAS test id for a given object id.

Parameters

integer $object_id The object id

Returns: mixed The ILIAS test id or FALSE if the query was not successful public

Definition at line 4300 of file class.ilObjTest.php.

References $DIC, $ilDB, and $test_id.

Referenced by ilLOUtils\getTestResultLinkForUser(), and ilTestAccess\isParticipantAllowed().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $test_id = false;
         $result = $ilDB->queryF(
             "SELECT test_id FROM tst_tests WHERE obj_fi = %s",
             ['integer'],
             [$object_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             $test_id = $row["test_id"];
         }
         return $test_id;
     }

Here is the caller graph for this function:

◆ _getUserIdFromActiveId()

static ilObjTest::_getUserIdFromActiveId ( int $active_id )

static

Deprecated:: : use ilTestParticipantData instead

Definition at line 5369 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by assQuestion\_setReachedPoints(), sendAdvancedNotification(), sendSimpleNotification(), and ILIAS\Test\ExportImport\CertificateExport\write().

                                                                  : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT user_fi FROM tst_active WHERE active_id = %s",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             return $row["user_fi"];
         } else {
             return -1;
         }
     }

Here is the caller graph for this function:

◆ _instanciateQuestion()

static ilObjTest::_instanciateQuestion ( $question_id )

static

Creates an instance of a question with a given question id.

Parameters

int $question_id The question id

Exceptions

InvalidArgumentException

Deprecated:: use assQuestion::_instanciateQuestion($question_id) instead

Definition at line 2715 of file class.ilObjTest.php.

References assQuestion\instantiateQuestion(), and null.

Referenced by ilCourseObjectiveQuestion\__read(), duplicateQuestionForTest(), getAllTestResults(), getDetailedTestResults(), ilCourseObjectiveQuestion\getMaxPointsByObjective(), ilCourseObjectiveQuestion\getMaxPointsByTest(), and ilCourseObjectiveQuestionAssignmentTableGUI\parse().

                                                              : ?assQuestion
     {
         if (strcmp((string) $question_id, "") !== 0) {
             return assQuestion::instantiateQuestion((int) $question_id);
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupAnonymity()

static ilObjTest::_lookupAnonymity ( $a_obj_id )

static

Definition at line 5548 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by ilObjTestAccess\_getParticipantData().

                                                       : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT anonymity FROM tst_tests WHERE obj_fi = %s",
             ['integer'],
             [$a_obj_id]
         );
         while ($row = $ilDB->fetchAssoc($result)) {
             return (int) $row['anonymity'];
         }
         return 0;
     }

Here is the caller graph for this function:

◆ _lookupAuthor()

static ilObjTest::_lookupAuthor ( $obj_id )

static

Gets the authors name of the ilObjTest object.

Returns: string The string containing the name of the test author public

See also: $author

Definition at line 4073 of file class.ilObjTest.php.

References $DIC.

Referenced by assQuestion\getInstances().

                                                  : string
     {
         global $DIC;
 
         $lo_metadata = $DIC->learningObjectMetadata();
 
         $path_to_authors = $lo_metadata->paths()->authors();
         $author_data = $lo_metadata->read($obj_id, 0, "tst", $path_to_authors)
                                     ->allData($path_to_authors);
 
         return $lo_metadata->dataHelper()->makePresentableAsList(',', ...$author_data);
     }

Here is the caller graph for this function:

◆ _lookupFinishedUserTests()

static ilObjTest::_lookupFinishedUserTests ( $a_user_id )

static

Gather all finished tests for user.

Parameters

int $a_user_id

Returns: array(test id => passed)

Definition at line 6658 of file class.ilObjTest.php.

References $DIC, and $ilDB.

                                                                : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT test_fi,MAX(pass) AS pass FROM tst_active" .
             " JOIN tst_pass_result ON (tst_pass_result.active_fi = tst_active.active_id)" .
             " WHERE user_fi=%s" .
             " GROUP BY test_fi",
             ['integer', 'integer'],
             [$a_user_id, 1]
         );
         $all = [];
         while ($row = $ilDB->fetchAssoc($result)) {
             $obj_id = self::_getObjectIDFromTestID($row["test_fi"]);
             $all[$obj_id] = (bool) $row["pass"];
         }
         return $all;
     }

◆ _lookupRandomTest()

static ilObjTest::_lookupRandomTest ( int $obj_id )

static

Deprecated:: There is no reason for this to be interesting for other objects

Definition at line 7554 of file class.ilObjTest.php.

References $DIC, $res, and null.

Referenced by ilLOSettings\isRandomTestType(), ilCourseObjectivesGUI\isRandomTestType(), and ilLOUtils\lookupRandomTest().

                                                          : bool
     {
         global $DIC;
 
         $query = 'SELECT question_set_type FROM tst_tests WHERE obj_fi = %s';
 
         $res = $DIC['ilDB']->queryF($query, ['integer'], [$obj_id]);
 
         $question_set_type = null;
 
         while ($row = $DIC['ilDB']->fetchAssoc($res)) {
             $question_set_type = $row['question_set_type'];
         }
 
         return $question_set_type === self::QUESTION_SET_TYPE_RANDOM;
     }

Here is the caller graph for this function:

◆ _lookupTestObjIdForQuestionId()

static ilObjTest::_lookupTestObjIdForQuestionId ( int $q_id )

static

Get test Object ID for question ID.

Definition at line 6304 of file class.ilObjTest.php.

References $DIC, $ilDB, and null.

Referenced by assQuestion\_setReachedPoints(), and ilObjMediaObject\getParentObjectIdForUsage().

                                                                    : ?int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             'SELECT t.obj_fi obj_id FROM tst_test_question q, tst_tests t WHERE q.test_fi = t.test_id AND q.question_fi = %s',
             ['integer'],
             [$q_id]
         );
         $rec = $ilDB->fetchAssoc($result);
         return $rec['obj_id'] ?? null;
     }

Here is the caller graph for this function:

◆ addConcludingRemarksToSettingsFromImport()

ilObjTest::addConcludingRemarksToSettingsFromImport	(	SettingsFinishing	$settings,
		array	$material,
		string	$importdir,
		array	$mappings
	)

private

Definition at line 3274 of file class.ilObjTest.php.

References ilSession\get(), ILIAS\Test\Settings\MainSettings\SettingsFinishing\getAlwaysSendMailNotification(), ilObject\getId(), ILIAS\Test\Settings\MainSettings\SettingsFinishing\getMailNotificationContentType(), ILIAS\Test\Settings\MainSettings\SettingsFinishing\getRedirectionMode(), ILIAS\Test\Settings\MainSettings\SettingsFinishing\getRedirectionUrl(), ILIAS\Test\Settings\MainSettings\SettingsFinishing\getShowAnswerOverview(), ILIAS\Test\Settings\TestSettings\getTestId(), null, replaceFilesInPageImports(), replaceMobsInPageImports(), retrieveMobsFromLegacyImports(), and ILIAS\Test\Settings\MainSettings\SettingsFinishing\withConcludingRemarksPageId().

Referenced by fromXML().

      : SettingsFinishing {
         $file_to_import = ilSession::get('path_to_import_file');
         $text = $material['text'];
         $mobs = $material['mobs'];
         if (str_starts_with($text, '<PageObject>')) {
             $text = $this->replaceMobsInPageImports(
                 $text,
                 $mappings['components/ILIAS/MediaObjects']['mob'] ?? []
             );
             $text = $this->replaceFilesInPageImports(
                 $text,
                 $mappings['components/ILIAS/File']['file'] ?? []
             );
             $page_object = new ilTestPage();
             $page_object->setParentId($this->getId());
             $page_object->setXMLContent($text);
             $new_page_id = $page_object->createPageWithNextId();
             return $settings->withConcludingRemarksPageId($new_page_id);
         }
 
         $text = $this->retrieveMobsFromLegacyImports($text, $mobs, $importdir);
 
         return new SettingsFinishing(
             $settings->getTestId(),
             $settings->getShowAnswerOverview(),
             strlen($text) > 0,
             $text,
             null,
             $settings->getRedirectionMode(),
             $settings->getRedirectionUrl(),
             $settings->getMailNotificationContentType(),
             $settings->getAlwaysSendMailNotification()
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addDefaults()

ilObjTest::addDefaults ( $a_name )

Adds the defaults of this test to the test defaults.

Parameters

string $a_name The name of the test defaults public

Definition at line 5674 of file class.ilObjTest.php.

     {
         $main_settings = $this->getMainSettings();
         $score_settings = $this->getScoreSettings();
         $testsettings = [
             'questionSetType' => $main_settings->getGeneralSettings()->getQuestionSetType(),
             'Anonymity' => (int) $main_settings->getGeneralSettings()->getAnonymity(),
 
             'activation_limited' => $this->isActivationLimited(),
             'activation_start_time' => $this->getActivationStartingTime(),
             'activation_end_time' => $this->getActivationEndingTime(),
             'activation_visibility' => $this->getActivationVisibility(),
 
             'IntroEnabled' => (int) $main_settings->getIntroductionSettings()->getIntroductionEnabled(),
             'ExamConditionsCheckboxEnabled' => (int) $main_settings->getIntroductionSettings()->getExamConditionsCheckboxEnabled(),
 
             'StartingTimeEnabled' => (int) $main_settings->getAccessSettings()->getStartTimeEnabled(),
             'StartingTime' => $main_settings->getAccessSettings()->getStartTime(),
             'EndingTimeEnabled' => (int) $main_settings->getAccessSettings()->getEndTimeEnabled(),
             'EndingTime' => $main_settings->getAccessSettings()->getEndTime(),
             'password_enabled' => (int) $main_settings->getAccessSettings()->getPasswordEnabled(),
             'password' => $main_settings->getAccessSettings()->getPassword(),
             'fixed_participants' => (int) $main_settings->getAccessSettings()->getFixedParticipants(),
 
             'NrOfTries' => $main_settings->getTestBehaviourSettings()->getNumberOfTries(),
             'BlockAfterPassed' => (int) $main_settings->getTestBehaviourSettings()->getBlockAfterPassedEnabled(),
             'pass_waiting' => $main_settings->getTestBehaviourSettings()->getPassWaiting(),
             'EnableProcessingTime' => (int) $main_settings->getTestBehaviourSettings()->getProcessingTimeEnabled(),
             'ProcessingTime' => $main_settings->getTestBehaviourSettings()->getProcessingTime(),
             'ResetProcessingTime' => $main_settings->getTestBehaviourSettings()->getResetProcessingTime(),
             'Kiosk' => $main_settings->getTestBehaviourSettings()->getKioskMode(),
             'examid_in_test_pass' => (int) $main_settings->getTestBehaviourSettings()->getExamIdInTestAttemptEnabled(),
 
             'TitleOutput' => $main_settings->getQuestionBehaviourSettings()->getQuestionTitleOutputMode(),
             'autosave' => (int) $main_settings->getQuestionBehaviourSettings()->getAutosaveEnabled(),
             'autosave_ival' => $main_settings->getQuestionBehaviourSettings()->getAutosaveInterval(),
             'Shuffle' => (int) $main_settings->getQuestionBehaviourSettings()->getShuffleQuestions(),
             'offer_question_hints' => (int) $main_settings->getQuestionBehaviourSettings()->getQuestionHintsEnabled(),
             'AnswerFeedbackPoints' => (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackPointsEnabled(),
             'AnswerFeedback' => (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackGenericEnabled(),
             'SpecificAnswerFeedback' => (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled(),
             'InstantFeedbackSolution' => (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSolutionEnabled(),
             'force_inst_fb' => (int) $main_settings->getQuestionBehaviourSettings()->getForceInstantFeedbackOnNextQuestion(),
             'follow_qst_answer_fixation' => (int) $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnNextQuestionEnabled(),
             'inst_fb_answer_fixation' => (int) $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled(),
 
             'use_previous_answers' => (int) $main_settings->getParticipantFunctionalitySettings()->getUsePreviousAnswerAllowed(),
             'ShowCancel' => (int) $main_settings->getParticipantFunctionalitySettings()->getSuspendTestAllowed(),
             'SequenceSettings' => (int) $main_settings->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd(),
             'ListOfQuestionsSettings' => $main_settings->getParticipantFunctionalitySettings()->getUsrPassOverviewMode(),
             'ShowMarker' => (int) $main_settings->getParticipantFunctionalitySettings()->getQuestionMarkingEnabled(),
 
             'enable_examview' => $main_settings->getFinishingSettings()->getShowAnswerOverview(),
             'ShowFinalStatement' => (int) $main_settings->getFinishingSettings()->getConcludingRemarksEnabled(),
             'redirection_mode' => $main_settings->getFinishingSettings()->getRedirectionMode(),
             'redirection_url' => $main_settings->getFinishingSettings()->getRedirectionUrl(),
             'mailnotification' => $main_settings->getFinishingSettings()->getMailNotificationContentType(),
             'mailnottype' => (int) $main_settings->getFinishingSettings()->getAlwaysSendMailNotification(),
 
             'skill_service' => (int) $main_settings->getAdditionalSettings()->getSkillsServiceEnabled(),
 
             'PassScoring' => $score_settings->getScoringSettings()->getPassScoring(),
             'ScoreCutting' => $score_settings->getScoringSettings()->getScoreCutting(),
             'CountSystem' => $score_settings->getScoringSettings()->getCountSystem(),
 
             'ScoreReporting' => $score_settings->getResultSummarySettings()->getScoreReporting()->value,
             'ReportingDate' => $score_settings->getResultSummarySettings()->getReportingDate(),
             'pass_deletion_allowed' => (int) $score_settings->getResultSummarySettings()->getPassDeletionAllowed(),
             'show_grading_status' => (int) $score_settings->getResultSummarySettings()->getShowGradingStatusEnabled(),
             'show_grading_mark' => (int) $score_settings->getResultSummarySettings()->getShowGradingMarkEnabled(),
 
             'ResultsPresentation' => $score_settings->getResultDetailsSettings()->getResultsPresentation(),
             'show_solution_list_comparison' => (int) $score_settings->getResultDetailsSettings()->getShowSolutionListComparison(),
             'examid_in_test_res' => (int) $score_settings->getResultDetailsSettings()->getShowExamIdInTestResults(),
 
             'highscore_enabled' => (int) $score_settings->getGamificationSettings()->getHighscoreEnabled(),
             'highscore_anon' => (int) $score_settings->getGamificationSettings()->getHighscoreAnon(),
             'highscore_achieved_ts' => $score_settings->getGamificationSettings()->getHighscoreAchievedTS(),
             'highscore_score' => $score_settings->getGamificationSettings()->getHighscoreScore(),
             'highscore_percentage' => $score_settings->getGamificationSettings()->getHighscorePercentage(),
             'highscore_hints' => $score_settings->getGamificationSettings()->getHighscoreHints(),
             'highscore_wtime' => $score_settings->getGamificationSettings()->getHighscoreWTime(),
             'highscore_own_table' => $score_settings->getGamificationSettings()->getHighscoreOwnTable(),
             'highscore_top_table' => $score_settings->getGamificationSettings()->getHighscoreTopTable(),
             'highscore_top_num' => $score_settings->getGamificationSettings()->getHighscoreTopNum(),
 
             'HideInfoTab' => (int) $main_settings->getAdditionalSettings()->getHideInfoTab(),
         ];
 
         $marks = array_map(
             fn(Mark $v): array => [
                 'short_name' => $v->getShortName(),
                 'official_name' => $v->getOfficialName(),
                 'minimum_level' => $v->getMinimumLevel(),
                 'passed' => $v->getPassed()
             ],
             $this->getMarkSchema()->getMarkSteps()
         );
 
         $next_id = $this->db->nextId('tst_test_defaults');
         $this->db->insert(
             'tst_test_defaults',
             [
                 'test_defaults_id' => ['integer', $next_id],
                 'name' => ['text', $a_name],
                 'user_fi' => ['integer', $this->user->getId()],
                 'defaults' => ['clob', serialize($testsettings)],
                 'marks' => ['clob', json_encode($marks)],
                 'tstamp' => ['integer', time()]
             ]
         );
     }

Here is the call graph for this function:

◆ addIntroductionToSettingsFromImport()

ilObjTest::addIntroductionToSettingsFromImport	(	SettingsIntroduction	$settings,
		array	$material,
		string	$importdir,
		array	$mappings
	)

private

Definition at line 3241 of file class.ilObjTest.php.

References ilObject\getId(), ILIAS\Test\Settings\TestSettings\getTestId(), replaceFilesInPageImports(), replaceMobsInPageImports(), retrieveMobsFromLegacyImports(), and ILIAS\Test\Settings\MainSettings\SettingsIntroduction\withIntroductionPageId().

Referenced by fromXML().

      : SettingsIntroduction {
         $text = $material['text'];
         $mobs = $material['mobs'];
         if (str_starts_with($text, '<PageObject>')) {
             $text = $this->replaceMobsInPageImports(
                 $text,
                 $mappings['components/ILIAS/MediaObjects']['mob'] ?? []
             );
             $text = $this->replaceFilesInPageImports(
                 $text,
                 $mappings['components/ILIAS/File']['file'] ?? []
             );
             $page_object = new ilTestPage();
             $page_object->setParentId($this->getId());
             $page_object->setXMLContent($text);
             $new_page_id = $page_object->createPageWithNextId();
             return $settings->withIntroductionPageId($new_page_id);
         }
 
         $text = $this->retrieveMobsFromLegacyImports($text, $mobs, $importdir);
 
         return new SettingsIntroduction(
             $settings->getTestId(),
             $text !== '',
             $text
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addQTIMaterial()

ilObjTest::addQTIMaterial	(	ilXmlWriter &	$xml_writer,
		?int	$page_id,
		string	$material = `''`
	)

Definition at line 5480 of file class.ilObjTest.php.

References ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilPCFileList\collectFileItems(), ilObject\getId(), IL_INST_ID, ILIAS\Repository\int(), isHTML(), null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by toXML().

                                                                                                   : void
     {
         $xml_writer->xmlStartTag('material');
         $attrs = [
             'texttype' => 'text/plain'
         ];
         $file_ids = [];
         $mobs = [];
         if ($page_id !== null) {
             $attrs['texttype'] = 'text/xml';
             $mobs = ilObjMediaObject::_getMobsOfObject('tst:pg', $page_id);
             $page_object = new ilTestPage($page_id);
             $page_object->buildDom();
             $page_object->insertInstIntoIDs((string) IL_INST_ID);
             $material = base64_encode($page_object->getXMLFromDom());
             $file_ids = ilPCFileList::collectFileItems($page_object, $page_object->getDomDoc());
             foreach ($file_ids as $file_id) {
                 $this->file_ids[] = (int) $file_id;
             };
             $mob_string = 'il_' . IL_INST_ID . '_mob_';
         } elseif ($this->isHTML($material)) {
             $attrs['texttype'] = 'text/xhtml';
             $mobs = ilObjMediaObject::_getMobsOfObject('tst:html', $this->getId());
             $mob_string = 'mm_';
         }
 
         $xml_writer->xmlElement('mattext', $attrs, $material);
         foreach ($mobs as $mob) {
             $mob_id_string = (string) $mob;
             $moblabel = 'il_' . IL_INST_ID . '_mob_' . $mob_id_string;
             if (strpos($material, $mob_string . $mob_id_string) !== false) {
                 if (ilObjMediaObject::_exists($mob)) {
                     $mob_obj = new ilObjMediaObject($mob);
                     $imgattrs = [
                         'label' => $moblabel,
                         'uri' => 'objects/' . 'il_' . IL_INST_ID . '_mob_' . $mob_id_string . '/' . $mob_obj->getTitle()
                     ];
                 }
                 $xml_writer->xmlElement('matimage', $imgattrs, null);
             }
         }
         $xml_writer->xmlEndTag('material');
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addToNewsOnOnline()

ilObjTest::addToNewsOnOnline	(	bool	$old_online_status,
		bool	$new_online_status
	)

Definition at line 7519 of file class.ilObjTest.php.

References ilNewsItem\deleteNewsOfContext(), ilNewsItem\getFirstNewsIdForContext(), ilObject\getId(), NEWS_NOTICE, NEWS_USERS, and ILIAS\Repository\user().

Referenced by fromXML().

      : void {
         if (!$old_online_status && $new_online_status) {
             $newsItem = new ilNewsItem();
             $newsItem->setContext($this->getId(), 'tst');
             $newsItem->setPriority(NEWS_NOTICE);
             $newsItem->setTitle('new_test_online');
             $newsItem->setContentIsLangVar(true);
             $newsItem->setContent('');
             $newsItem->setUserId($this->user->getId());
             $newsItem->setVisibility(NEWS_USERS);
             $newsItem->create();
             return;
         }
 
         if ($old_online_status && !$new_online_status) {
             ilNewsItem::deleteNewsOfContext($this->getId(), 'tst');
             return;
         }
 
         $newsId = ilNewsItem::getFirstNewsIdForContext($this->getId(), 'tst');
         if (!$new_online_status && $newsId > 0) {
             $newsItem = new ilNewsItem($newsId);
             $newsItem->setTitle('new_test_online');
             $newsItem->setContentIsLangVar(true);
             $newsItem->setContent('');
             $newsItem->update();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ adjustTestSequence()

ilObjTest::adjustTestSequence ( )

Definition at line 7205 of file class.ilObjTest.php.

References getShuffleQuestions(), and getTestId().

     {
         $query = "
                         SELECT COUNT(test_question_id) cnt
                         FROM tst_test_question
                         WHERE test_fi = %s
                         ORDER BY sequence
                 ";
 
         $questRes = $this->db->queryF($query, ['integer'], [$this->getTestId()]);
 
         $row = $this->db->fetchAssoc($questRes);
         $questCount = $row['cnt'];
 
         if ($this->getShuffleQuestions()) {
             $query = "
                                 SELECT tseq.*
                                 FROM tst_active tac
                                 INNER JOIN tst_sequence tseq
                                         ON tseq.active_fi = tac.active_id
                                 WHERE tac.test_fi = %s
                         ";
 
             $partRes = $this->db->queryF(
                 $query,
                 ['integer'],
                 [$this->getTestId()]
             );
 
             while ($row = $this->db->fetchAssoc($partRes)) {
                 $sequence = @unserialize($row['sequence']);
 
                 if (!$sequence) {
                     $sequence = [];
                 }
 
                 $sequence = array_filter($sequence, function ($value) use ($questCount) {
                     return $value <= $questCount;
                 });
 
                 $num_seq = count($sequence);
                 if ($questCount > $num_seq) {
                     $diff = $questCount - $num_seq;
                     for ($i = 1; $i <= $diff; $i++) {
                         $sequence[$num_seq + $i - 1] = $num_seq + $i;
                     }
                 }
 
                 $new_sequence = serialize($sequence);
 
                 $this->db->update('tst_sequence', [
                     'sequence' => ['clob', $new_sequence]
                 ], [
                     'active_fi' => ['integer', $row['active_fi']],
                     'pass' => ['integer', $row['pass']]
                 ]);
             }
         } else {
             $new_sequence = serialize($questCount > 0 ? range(1, $questCount) : []);
 
             $query = "
                                 SELECT tseq.*
                                 FROM tst_active tac
                                 INNER JOIN tst_sequence tseq
                                         ON tseq.active_fi = tac.active_id
                                 WHERE tac.test_fi = %s
                         ";
 
             $part_rest = $this->db->queryF(
                 $query,
                 ['integer'],
                 [$this->getTestId()]
             );
 
             while ($row = $this->db->fetchAssoc($part_rest)) {
                 $this->db->update('tst_sequence', [
                     'sequence' => ['clob', $new_sequence]
                 ], [
                     'active_fi' => ['integer', $row['active_fi']],
                     'pass' => ['integer', $row['pass']]
                 ]);
             }
         }
     }

Here is the call graph for this function:

◆ applyDefaults()

ilObjTest::applyDefaults ( array $test_defaults )

Definition at line 5787 of file class.ilObjTest.php.

                                                        : string
     {
         $testsettings = unserialize($test_defaults['defaults'], ['allowed_classes' => [DateTimeImmutable::class]]);
         $activation_starting_time = is_numeric($testsettings['activation_starting_time'] ?? false)
             ? (int) $testsettings['activation_starting_time']
             : null;
         $activation_ending_time = is_numeric($testsettings['activation_ending_time'] ?? false)
             ? (int) $testsettings['activation_ending_time']
             : null;
         $unserialized_marks = json_decode($test_defaults['marks'], true);
 
         $info = '';
         if (is_array($unserialized_marks)
             && is_array($unserialized_marks[0])) {
             $this->mark_schema = $this->getMarkSchema()->withMarkSteps(
                 array_map(
                     fn(array $v): Mark => new Mark(
                         $v['short_name'],
                         $v['official_name'],
                         $v['minimum_level'],
                         $v['passed']
                     ),
                     $unserialized_marks
                 )
             );
         } else {
             $info = 'old_mark_default_not_applied';
         }
 
 
         $this->storeActivationSettings(
             (bool) ($testsettings['is_activation_limited'] ?? false),
             $activation_starting_time,
             $activation_ending_time,
             (bool) ($testsettings['activation_visibility'] ?? false),
         );
 
         $main_settings = $this->getMainSettings();
         $main_settings = $main_settings
             ->withGeneralSettings(
                 $main_settings->getGeneralSettings()
                 ->withQuestionSetType($testsettings['questionSetType'])
                 ->withAnonymity((bool) $testsettings['Anonymity'])
             )
             ->withIntroductionSettings(
                 $main_settings->getIntroductionSettings()
                 ->withIntroductionEnabled((bool) $testsettings['IntroEnabled'])
                 ->withExamConditionsCheckboxEnabled((bool) ($testsettings['ExamConditionsCheckboxEnabled'] ?? false))
             )
             ->withAccessSettings(
                 $main_settings->getAccessSettings()
                 ->withStartTimeEnabled((bool) $testsettings['StartingTimeEnabled'])
                 ->withStartTime($this->convertTimeToDateTimeImmutableIfNecessary($testsettings['StartingTime']))
                 ->withEndTimeEnabled((bool) $testsettings['EndingTimeEnabled'])
                 ->withEndTime($this->convertTimeToDateTimeImmutableIfNecessary($testsettings['EndingTime']))
                 ->withPasswordEnabled((bool) $testsettings['password_enabled'])
                 ->withPassword($testsettings['password'])
                 ->withFixedParticipants((bool) $testsettings['fixed_participants'])
             )
             ->withTestBehaviourSettings(
                 $main_settings->getTestBehaviourSettings()
                 ->withNumberOfTries($testsettings['NrOfTries'])
                 ->withBlockAfterPassedEnabled((bool) $testsettings['BlockAfterPassed'])
                 ->withPassWaiting($testsettings['pass_waiting'])
                 ->withKioskMode($testsettings['Kiosk'])
                 ->withProcessingTimeEnabled((bool) $testsettings['EnableProcessingTime'])
                 ->withProcessingTime($testsettings['ProcessingTime'])
                 ->withResetProcessingTime((bool) $testsettings['ResetProcessingTime'])
                 ->withExamIdInTestAttemptEnabled((bool) ($testsettings['examid_in_test_pass'] ?? 0))
             )
             ->withQuestionBehaviourSettings(
                 $main_settings->getQuestionBehaviourSettings()
                 ->withQuestionTitleOutputMode($testsettings['TitleOutput'])
                 ->withAutosaveEnabled((bool) $testsettings['autosave'])
                 ->withAutosaveInterval($testsettings['autosave_ival'])
                 ->withShuffleQuestions((bool) $testsettings['Shuffle'])
                 ->withQuestionHintsEnabled((bool) $testsettings['offer_question_hints'])
                 ->withInstantFeedbackPointsEnabled((bool) $testsettings['AnswerFeedbackPoints'])
                 ->withInstantFeedbackGenericEnabled((bool) $testsettings['AnswerFeedback'])
                 ->withInstantFeedbackSpecificEnabled((bool) $testsettings['SpecificAnswerFeedback'])
                 ->withInstantFeedbackSolutionEnabled((bool) $testsettings['InstantFeedbackSolution'])
                 ->withForceInstantFeedbackOnNextQuestion((bool) $testsettings['force_inst_fb'])
                 ->withLockAnswerOnInstantFeedbackEnabled((bool) $testsettings['inst_fb_answer_fixation'])
                 ->withLockAnswerOnNextQuestionEnabled((bool) $testsettings['follow_qst_answer_fixation'])
             )
             ->withParticipantFunctionalitySettings(
                 $main_settings->getParticipantFunctionalitySettings()
                 ->withUsePreviousAnswerAllowed((bool) $testsettings['use_previous_answers'])
                 ->withSuspendTestAllowed((bool) $testsettings['ShowCancel'])
                 ->withPostponedQuestionsMoveToEnd((bool) $testsettings['SequenceSettings'])
                 ->withUsrPassOverviewMode((int) $testsettings['ListOfQuestionsSettings'])
                 ->withQuestionMarkingEnabled((bool) $testsettings['ShowMarker'])
             )
             ->withFinishingSettings(
                 $main_settings->getFinishingSettings()
                 ->withShowAnswerOverview((bool) $testsettings['enable_examview'])
                 ->withConcludingRemarksEnabled((bool) $testsettings['ShowFinalStatement'])
                 ->withRedirectionMode((int) $testsettings['redirection_mode'])
                 ->withRedirectionUrl($testsettings['redirection_url'])
                 ->withMailNotificationContentType((int) $testsettings['mailnotification'])
                 ->withAlwaysSendMailNotification((bool) $testsettings['mailnottype'])
             )
             ->withAdditionalSettings(
                 $main_settings->getAdditionalSettings()
                     ->withSkillsServiceEnabled((bool) $testsettings['skill_service'])
                     ->withHideInfoTab((bool) ($testsettings['HideInfoTab'] ?? false))
             );
 
         $this->getMainSettingsRepository()->store($main_settings);
 
         $score_reporting = ScoreReportingTypes::SCORE_REPORTING_DISABLED;
         if ($testsettings['ScoreReporting'] !== null) {
             $score_reporting = ScoreReportingTypes::tryFrom($testsettings['ScoreReporting'])
                 ?? ScoreReportingTypes::SCORE_REPORTING_DISABLED;
         }
 
         $reporting_date = $testsettings['ReportingDate'];
         if (is_string($reporting_date)) {
             $reporting_date = new DateTimeImmutable($testsettings['ReportingDate'], new DateTimeZone('UTC'));
         }
 
         $score_settings = $this->getScoreSettings();
         $score_settings = $score_settings
             ->withScoringSettings(
                 $score_settings->getScoringSettings()
                 ->withPassScoring($testsettings['PassScoring'])
                 ->withScoreCutting($testsettings['ScoreCutting'])
                 ->withCountSystem($testsettings['CountSystem'])
             )
             ->withResultSummarySettings(
                 $score_settings->getResultSummarySettings()
                 ->withPassDeletionAllowed((bool) $testsettings['pass_deletion_allowed'])
                 ->withShowGradingStatusEnabled((bool) $testsettings['show_grading_status'])
                 ->withShowGradingMarkEnabled((bool) $testsettings['show_grading_mark'])
                 ->withScoreReporting($score_reporting)
                 ->withReportingDate($reporting_date)
             )
             ->withResultDetailsSettings(
                 $score_settings->getResultDetailsSettings()
                 ->withResultsPresentation((int) $testsettings['ResultsPresentation'])
                 ->withShowSolutionListComparison((bool) ($testsettings['show_solution_list_comparison'] ?? 0))
                 ->withShowExamIdInTestResults((bool) $testsettings['examid_in_test_res'])
             )
             ->withGamificationSettings(
                 $score_settings->getGamificationSettings()
                 ->withHighscoreEnabled((bool) $testsettings['highscore_enabled'])
                 ->withHighscoreAnon((bool) $testsettings['highscore_anon'])
                 ->withHighscoreAchievedTS($testsettings['highscore_achieved_ts'])
                 ->withHighscoreScore((bool) $testsettings['highscore_score'])
                 ->withHighscorePercentage($testsettings['highscore_percentage'])
                 ->withHighscoreHints((bool) $testsettings['highscore_hints'])
                 ->withHighscoreWTime((bool) $testsettings['highscore_wtime'])
                 ->withHighscoreOwnTable((bool) $testsettings['highscore_own_table'])
                 ->withHighscoreTopTable((bool) $testsettings['highscore_top_table'])
                 ->withHighscoreTopNum($testsettings['highscore_top_num'])
             )
         ;
         $this->getScoreSettingsRepository()->store($score_settings);
         $this->saveToDb();
 
         return $info;
     }

Here is the call graph for this function:

◆ buildDateTimeImmutableFromPeriod()

ilObjTest::buildDateTimeImmutableFromPeriod ( ?string $period )

protected

Definition at line 3807 of file class.ilObjTest.php.

References null.

Referenced by fromXML().

                                                                         : ?DateTimeImmutable
     {
         if ($period === null) {
             return null;
         }
         if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $period, $matches)) {
             return new DateTimeImmutable(
                 sprintf(
                     "%02d-%02d-%02d %02d:%02d:%02d",
                     $matches[1],
                     $matches[2],
                     $matches[3],
                     $matches[4],
                     $matches[5],
                     $matches[6]
                 ),
                 new \DateTimeZone('UTC')
             );
         }
         return null;
     }

Here is the caller graph for this function:

◆ buildExamId()

static ilObjTest::buildExamId	(	$active_id,
		$pass,
		$test_obj_id = `null`
	)

static

Definition at line 6997 of file class.ilObjTest.php.

References $DIC, $ilSetting, and null.

Referenced by ilTestPlayerAbstractGUI\getTestPlayerTitle(), and updateTestPassResults().

                                                                               : string
     {
         global $DIC;
         $ilSetting = $DIC['ilSetting'];
 
         $inst_id = $ilSetting->get('inst_id', null);
 
         if ($test_obj_id === null) {
             $obj_id = self::_getObjectIDFromActiveID($active_id);
         } else {
             $obj_id = $test_obj_id;
         }
 
         $examId = 'I' . $inst_id . '_T' . $obj_id . '_A' . $active_id . '_P' . $pass;
 
         return $examId;
     }

Here is the caller graph for this function:

◆ buildIso8601PeriodForExportCompatibility()

ilObjTest::buildIso8601PeriodForExportCompatibility ( DateTimeImmutable $date_time )

protected

Definition at line 3802 of file class.ilObjTest.php.

Referenced by toXML().

                                                                                              : string
     {
         return $date_time->setTimezone(new DateTimeZone('UTC'))->format('\PY\Yn\Mj\D\TG\Hi\Ms\S');
     }

Here is the caller graph for this function:

◆ buildName()

ilObjTest::buildName	(	?int	$user_id,
		?string	$firstname,
		?string	$lastname
	)

Builds a user name for the output depending on test type and existence of the user.

Parameters

int	$user_id	The database ID of the user
string	$firstname	The first name of the user
string	$lastname	The last name of the user
string	$title	The title of the user

Returns: string The output name of the user public

Definition at line 2562 of file class.ilObjTest.php.

References ANONYMOUS_USER_ID, getAnonymity(), ILIAS\Repository\lng(), and null.

      : string {
         if ($user_id === null
             || $firstname . $lastname === '') {
             return $this->lng->txt('deleted_user');
         }
 
         if ($this->getAnonymity()) {
             return $this->lng->txt('anonymous');
         }
 
         if ($user_id == ANONYMOUS_USER_ID) {
             return $lastname;
         }
 
         return trim($lastname . ', ' . $firstname);
     }

Here is the call graph for this function:

◆ buildStatisticsAccessFilteredParticipantList()

ilObjTest::buildStatisticsAccessFilteredParticipantList ( )

Definition at line 2467 of file class.ilObjTest.php.

References getTestParticipants(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

                                                                   : ilTestParticipantList
     {
         $list = new ilTestParticipantList($this, $this->user, $this->lng, $this->db);
         $list->initializeFromDbRows($this->getTestParticipants());
 
         return $list->getAccessFilteredList(
             $this->participant_access_filter->getAccessStatisticsUserFilter($this->getRefId())
         );
     }

Here is the call graph for this function:

◆ canShowSolutionPrintview()

ilObjTest::canShowSolutionPrintview ( $user_id = null )

Deprecated:

Definition at line 5315 of file class.ilObjTest.php.

References getShowSolutionPrintview().

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

Here is the call graph for this function:

◆ canShowTestResults()

ilObjTest::canShowTestResults ( ilTestSession $test_session )

Definition at line 5058 of file class.ilObjTest.php.

References ilTestSession\getActiveId(), and ilTestSession\getLastFinishedPass().

Referenced by ilTestSession\reportableResultsAvailable().

                                                                    : bool
     {
         $passSelector = new ilTestPassesSelector($this->db, $this);
 
         $passSelector->setActiveId($test_session->getActiveId());
         $passSelector->setLastFinishedPass($test_session->getLastFinishedPass());
 
         return $passSelector->hasReportablePasses();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkQuestionParent()

ilObjTest::checkQuestionParent ( int $question_id )

Definition at line 5196 of file class.ilObjTest.php.

                                                          : bool
     {
         $row = $this->db->fetchAssoc($this->db->queryF(
             "SELECT COUNT(question_id) cnt FROM qpl_questions WHERE question_id = %s AND obj_fi = %s",
             ['integer', 'integer'],
             [$question_id, $this->getId()]
         ));
 
         return (bool) $row['cnt'];
     }

◆ cloneConcludingRemarks()

ilObjTest::cloneConcludingRemarks ( )

private

Definition at line 710 of file class.ilObjTest.php.

References clonePage(), getMainSettings(), and null.

Referenced by cloneObject().

                                              : ?int
     {
         $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
         if ($page_id === null) {
             return null;
         }
         return $this->clonePage($page_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneIntroduction()

ilObjTest::cloneIntroduction ( )

private

Definition at line 692 of file class.ilObjTest.php.

References clonePage(), getMainSettings(), and null.

Referenced by cloneObject().

                                         : ?int
     {
         $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
         if ($page_id === null) {
             return null;
         }
         return $this->clonePage($page_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneObject()

ilObjTest::cloneObject	(	int	$target_id,
		int	$copy_id = `0`,
		bool	$omit_tree = `false`
	)

Clone object.

public

Parameters

int	ref id of parent container
int	copy id

Returns: object new test object

Definition at line 4128 of file class.ilObjTest.php.

References cloneConcludingRemarks(), cloneIntroduction(), ilObject\cloneMetaData(), ilObject\getId(), getMainSettings(), getMainSettingsRepository(), getMarkSchema(), getScoreSettings(), getScoreSettingsRepository(), getTemplate(), getTestId(), loadFromDb(), and ILIAS\Repository\user().

                                                                                           : ?ilObject
     {
         $this->loadFromDb();
 
         $new_obj = parent::cloneObject($target_id, $copy_id, $omit_tree);
         $new_obj->setTmpCopyWizardCopyId($copy_id);
         $this->cloneMetaData($new_obj);
 
         $new_obj->saveToDb();
         $new_obj->addToNewsOnOnline(false, $new_obj->getObjectProperties()->getPropertyIsOnline()->getIsOnline());
         $this->getMainSettingsRepository()->store(
             $this->getMainSettings()->withTestId($new_obj->getTestId())
                 ->withIntroductionSettings(
                     $this->getMainSettings()->getIntroductionSettings()->withIntroductionPageId(
                         $this->cloneIntroduction()
                     )->withTestId($new_obj->getTestId())
                 )->withFinishingSettings(
                     $this->getMainSettings()->getFinishingSettings()->withConcludingRemarksPageId(
                         $this->cloneConcludingRemarks()
                     )->withTestId($new_obj->getTestId())
                 )
         );
         $this->getScoreSettingsRepository()->store(
             $this->getScoreSettings()->withTestId($new_obj->getTestId())
         );
         $this->marks_repository->storeMarkSchema(
             $this->getMarkSchema()->withTestId($new_obj->getTestId())
         );
 
         $new_obj->setTemplate($this->getTemplate());
 
         // clone certificate
         $pathFactory = new ilCertificatePathFactory();
         $templateRepository = new ilCertificateTemplateDatabaseRepository($this->db);
 
         $cloneAction = new ilCertificateCloneAction(
             $this->db,
             $pathFactory,
             $templateRepository,
             new ilCertificateObjectHelper()
         );
 
         $cloneAction->cloneCertificate($this, $new_obj);
 
         $this->question_set_config_factory->getQuestionSetConfig()->cloneQuestionSetRelatedData($new_obj);
         $new_obj->saveQuestionsToDb();
 
         $skillLevelThresholdList = new ilTestSkillLevelThresholdList($this->db);
         $skillLevelThresholdList->setTestId($this->getTestId());
         $skillLevelThresholdList->loadFromDb();
         $skillLevelThresholdList->cloneListForTest($new_obj->getTestId());
 
         $obj_settings = new ilLPObjSettings($this->getId());
         $obj_settings->cloneSettings($new_obj->getId());
 
         if ($new_obj->getTestLogger()->isLoggingEnabled()) {
             $new_obj->getTestLogger()->logTestAdministrationInteraction(
                 $new_obj->getTestLogger()->getInteractionFactory()->buildTestAdministrationInteraction(
                     $new_obj->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::NEW_TEST_CREATED,
                     []
                 )
             );
         }
 
         return $new_obj;
     }

Here is the call graph for this function:

◆ clonePage()

ilObjTest::clonePage ( int $source_page_id )

private

Definition at line 719 of file class.ilObjTest.php.

References ilObject\getId().

Referenced by cloneConcludingRemarks(), and cloneIntroduction().

                                                    : int
     {
         $page_object = new ilTestPage();
         $page_object->setParentId($this->getId());
         $new_page_id = $page_object->createPageWithNextId();
         (new ilTestPage($source_page_id))->copy($new_page_id);
         return $new_page_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ convertTimeToDateTimeImmutableIfNecessary()

ilObjTest::convertTimeToDateTimeImmutableIfNecessary ( DateTimeImmutable|int|null $date_time )

private

Definition at line 5950 of file class.ilObjTest.php.

References null.

Referenced by applyDefaults().

      : ?DateTimeImmutable {
         if ($date_time === null || $date_time instanceof DateTimeImmutable) {
             return $date_time;
         }
 
         return DateTimeImmutable::createFromFormat('U', (string) $date_time);
     }

Here is the caller graph for this function:

◆ copyQuestions()

ilObjTest::copyQuestions ( array $question_ids )

Parameters

array<int> $question_ids

Definition at line 561 of file class.ilObjTest.php.

References $id, ilObject\$title, ilObject\getId(), getQuestionTitles(), and insertQuestion().

                                                       : void
     {
         $copy_count = 0;
         $question_titles = $this->getQuestionTitles();
 
         foreach ($question_ids as $id) {
             $question = assQuestion::instantiateQuestionGUI($id);
             if ($question) {
                 $title = $question->getObject()->getTitle();
                 $i = 2;
                 while (in_array($title . ' (' . $i . ')', $question_titles)) {
                     $i++;
                 }
 
                 $title .= ' (' . $i . ')';
 
                 $question_titles[] = $title;
 
                 $new_id = $question->getObject()->duplicate(false, $title);
 
                 $clone = assQuestion::instantiateQuestionGUI($new_id);
                 $question = $clone->getObject();
                 $question->setObjId($this->getId());
                 $clone->setObject($question);
                 $clone->getObject()->saveToDb();
 
                 $this->insertQuestion($new_id, true);
 
                 $copy_count++;
             }
         }
     }

Here is the call graph for this function:

◆ create()

ilObjTest::create ( )

Definition at line 239 of file class.ilObjTest.php.

References $id, and ilObject\createMetaData().

                             : int
     {
         $id = parent::create();
         $this->createMetaData();
         return $id;
     }

Here is the call graph for this function:

◆ createExportDirectory()

ilObjTest::createExportDirectory ( )

creates data directory for export files (data_dir/tst_data/tst_<id>/export, depending on data directory that is set in ILIAS setup/ini)

Definition at line 342 of file class.ilObjTest.php.

References ilFileUtils\getDataDir(), ilObject\getId(), and ilFileUtils\makeDir().

                                            : void
     {
         $tst_data_dir = ilFileUtils::getDataDir() . "/tst_data";
         ilFileUtils::makeDir($tst_data_dir);
         if (!is_writable($tst_data_dir)) {
             $this->ilias->raiseError("Test Data Directory (" . $tst_data_dir
                 . ") not writeable.", $this->ilias->error_obj->MESSAGE);
         }
 
         // create learning module directory (data_dir/lm_data/lm_<id>)
         $tst_dir = $tst_data_dir . "/tst_" . $this->getId();
         ilFileUtils::makeDir($tst_dir);
         if (!@is_dir($tst_dir)) {
             $this->ilias->raiseError("Creation of Test Directory failed.", $this->ilias->error_obj->MESSAGE);
         }
         // create Export subdirectory (data_dir/lm_data/lm_<id>/Export)
         $export_dir = $tst_dir . "/export";
         ilFileUtils::makeDir($export_dir);
         if (!@is_dir($export_dir)) {
             $this->ilias->raiseError("Creation of Export Directory failed.", $this->ilias->error_obj->MESSAGE);
         }
     }

Here is the call graph for this function:

◆ createQuestionGUI()

ilObjTest::createQuestionGUI	(	$question_type,
		$question_id = `-1`
	)

Creates a question GUI instance of a given question type.

Parameters

integer	$question_type	The question type of the question
integer	$question_id	The question id of the question, if available

Returns: assQuestionGUI $questionGUI The question GUI instance public

Definition at line 2689 of file class.ilObjTest.php.

References getQuestionType(), and null.

Referenced by ILIAS\Test\Results\Data\Factory\buildAttemptResults().

                                                                         : ?assQuestionGUI
     {
         if ((!$question_type) and ($question_id > 0)) {
             $question_type = $this->getQuestionType($question_id);
         }
 
         if (!strlen($question_type)) {
             return null;
         }
 
         if ($question_id > 0) {
             $question_gui = assQuestion::instantiateQuestionGUI($question_id);
         } else {
             $question_type_gui = $question_type . 'GUI';
             $question_gui = new $question_type_gui();
         }
 
         return $question_gui;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createTestSequence()

& ilObjTest::createTestSequence	(	$active_id,
		$pass,
		$shuffle
	)

Definition at line 6234 of file class.ilObjTest.php.

References isRandomTest().

     {
         $this->test_sequence = new ilTestSequence($active_id, $pass, $this->isRandomTest(), $this->questionrepository);
     }

Here is the call graph for this function:

◆ delete()

ilObjTest::delete ( )

Definition at line 266 of file class.ilObjTest.php.

References ilObject\$title, ilObject\deleteMetaData(), deleteTest(), ilObject\getId(), ilObject\getRefId(), ILIAS\Repository\logger(), ILIAS\Test\Logging\TEST_DELETED, and ILIAS\Repository\user().

                             : bool
     {
         // always call parent delete function first!!
         if (!parent::delete()) {
             return false;
         }
 
         // delet meta data
         $this->deleteMetaData();
 
         //put here your module specific stuff
         $this->deleteTest();
 
         $qsaImportFails = new ilAssQuestionSkillAssignmentImportFails($this->getId());
         $qsaImportFails->deleteRegisteredImportFails();
         $sltImportFails = new ilTestSkillLevelThresholdImportFails($this->getId());
         $sltImportFails->deleteRegisteredImportFails();
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::TEST_DELETED,
                     [
                         AdditionalInformationGenerator::KEY_TEST_TITLE => $test_title = $this->title
                     ]
                 )
             );
         }
 
         return true;
     }

Here is the call graph for this function:

◆ deleteDefaults()

ilObjTest::deleteDefaults ( $test_default_id )

Definition at line 5659 of file class.ilObjTest.php.

     {
         $this->db->manipulateF(
             "DELETE FROM tst_test_defaults WHERE test_defaults_id = %s",
             ['integer'],
             [$test_default_id]
         );
     }

◆ deleteTest()

ilObjTest::deleteTest ( )

Definition at line 300 of file class.ilObjTest.php.

References ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilFileUtils\delDir(), ilFileUtils\getDataDir(), ilObject\getId(), getTestId(), ILIAS\Repository\lng(), and removeTestResults().

Referenced by delete().

                                 : void
     {
         $participantData = new ilTestParticipantData($this->db, $this->lng);
         $participantData->load($this->getTestId());
         $this->removeTestResults($participantData);
 
         $this->db->manipulateF(
             "DELETE FROM tst_mark WHERE test_fi = %s",
             ['integer'],
             [$this->getTestId()]
         );
 
         $this->db->manipulateF(
             "DELETE FROM tst_tests WHERE test_id = %s",
             ['integer'],
             [$this->getTestId()]
         );
 
         $tst_data_dir = ilFileUtils::getDataDir() . "/tst_data";
         $directory = $tst_data_dir . "/tst_" . $this->getId();
         if (is_dir($directory)) {
             ilFileUtils::delDir($directory);
         }
         $mobs = ilObjMediaObject::_getMobsOfObject("tst:html", $this->getId());
         // remaining usages are not in text anymore -> delete them
         // and media objects (note: delete method of ilObjMediaObject
         // checks whether object is used in another context; if yes,
         // the object is not deleted!)
         foreach ($mobs as $mob) {
             ilObjMediaObject::_removeUsage($mob, "tst:html", $this->getId());
             if (ilObjMediaObject::_exists($mob)) {
                 $mob_obj = new ilObjMediaObject($mob);
                 $mob_obj->delete();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deliverPDFfromFO()

ilObjTest::deliverPDFfromFO	(	$fo,
		$title = `null`
	)

Delivers a PDF file from a XSL-FO string.

Parameters

string $fo The XSL-FO string public

PhpUndefinedFieldInspection

Definition at line 6045 of file class.ilObjTest.php.

References Vendor\Package\$e, $filename, ilObject\$title, ilUtil\deliverData(), ilRpcClientFactory\factory(), ilFileUtils\getASCIIFilename(), ilObject\getTitle(), ilFileUtils\ilTempnam(), and ILIAS\Repository\logger().

Referenced by deliverPDFfromHTML().

                                                         : bool
     {
         $fo_file = ilFileUtils::ilTempnam() . ".fo";
         $fp = fopen($fo_file, "w");
         fwrite($fp, $fo);
         fclose($fp);
 
         try {
             $pdf_base64 = ilRpcClientFactory::factory('RPCTransformationHandler')->ilFO2PDF($fo);
             $filename = (strlen($title)) ? $title : $this->getTitle();
             ilUtil::deliverData(
                 $pdf_base64->scalar,
                 ilFileUtils::getASCIIFilename($filename) . ".pdf",
                 "application/pdf"
             );
             return true;
         } catch (Exception $e) {
             $this->logger->info(__METHOD__ . ': ' . $e->getMessage());
             return false;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deliverPDFfromHTML()

ilObjTest::deliverPDFfromHTML	(	$content,
		$title = `null`
	)

Delivers a PDF file from XHTML.

Parameters

string $html The XHTML string public

Definition at line 6009 of file class.ilObjTest.php.

References ilObject\$title, deliverPDFfromFO(), ilUtil\getStyleSheetLocation(), ilObject\getTitle(), ilLegacyFormElementsUtil\prepareFormOutput(), and processPrintoutput2FO().

     {
         $content = preg_replace("/href=\".*?\"/", "", $content);
         $printbody = new ilTemplate("tpl.il_as_tst_print_body.html", true, true, "components/ILIAS/Test");
         $printbody->setVariable("TITLE", ilLegacyFormElementsUtil::prepareFormOutput($this->getTitle()));
         $printbody->setVariable("ADM_CONTENT", $content);
         $printbody->setCurrentBlock("css_file");
         $printbody->setVariable("CSS_FILE", ilUtil::getStyleSheetLocation("filesystem", "delos.css"));
         $printbody->parseCurrentBlock();
         $printoutput = $printbody->get();
         $html = str_replace("href=\"./", "href=\"" . ILIAS_HTTP_PATH . "/", $printoutput);
         $html = preg_replace("/<div id=\"dontprint\">.*?<\\/div>/ims", "", $html);
         if (extension_loaded("tidy")) {
             $config = [
                 "indent" => false,
                 "output-xml" => true,
                 "numeric-entities" => true
             ];
             $tidy = new tidy();
             $tidy->parseString($html, $config, 'utf8');
             $tidy->cleanRepair();
             $html = tidy_get_output($tidy);
             $html = preg_replace("/^.*?(<html)/", "\\1", $html);
         } else {
             $html = str_replace("&nbsp;", "&#160;", $html);
             $html = str_replace("&otimes;", "X", $html);
         }
         $html = preg_replace("/src=\".\\//ims", "src=\"" . ILIAS_HTTP_PATH . "/", $html);
         $this->deliverPDFfromFO($this->processPrintoutput2FO($html), $title);
     }

Here is the call graph for this function:

◆ doCreateMetaData()

ilObjTest::doCreateMetaData ( )

protected

Definition at line 4045 of file class.ilObjTest.php.

References saveAuthorToMetadata().

                                          : void
     {
         $this->saveAuthorToMetadata();
     }

Here is the call graph for this function:

◆ duplicateQuestionForTest()

ilObjTest::duplicateQuestionForTest ( $question_id )

Takes a question and creates a copy of the question for use in the test.

Parameters

integer $question_id The database id of the question

Returns: integer The database id of the copied question

Definition at line 1351 of file class.ilObjTest.php.

References _instanciateQuestion(), and ilObject\getId().

Referenced by insertQuestion().

                                                           : int
     {
         $question = ilObjTest::_instanciateQuestion($question_id);
         $duplicate_id = $question->duplicate(true, '', '', -1, $this->getId());
         return $duplicate_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ endingTimeReached()

ilObjTest::endingTimeReached ( )

Returns true if the ending time of a test is reached An ending time is not available for self assessment tests.

Returns: boolean true if the ending time is reached, otherwise false public

Definition at line 2798 of file class.ilObjTest.php.

References getEndingTime(), and isEndingTimeEnabled().

Referenced by isExecutable().

                                        : bool
     {
         if ($this->isEndingTimeEnabled() && $this->getEndingTime() != 0) {
             $now = time();
             if ($now > $this->getEndingTime()) {
                 return true;
             }
         }
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ evalStatistical()

ilObjTest::evalStatistical ( $active_id )

Returns the statistical evaluation of the test for a specified user.

Definition at line 2149 of file class.ilObjTest.php.

References _getResultPass(), getMarkSchema(), getTestResult(), and null.

                                                : array
     {
         $pass = ilObjTest::_getResultPass($active_id);
         $test_result = &$this->getTestResult($active_id, $pass);
         $result = $this->db->queryF(
             "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.active_id = %s AND tst_active.active_id = tst_times.active_fi",
             ['integer'],
             [$active_id]
         );
         $times = [];
         $first_visit = 0;
         $last_visit = 0;
         while ($row = $this->db->fetchObject($result)) {
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             if (!$first_visit) {
                 $first_visit = $epoch_1;
             }
             if ($epoch_1 < $first_visit) {
                 $first_visit = $epoch_1;
             }
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->finished, $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             if (!$last_visit) {
                 $last_visit = $epoch_2;
             }
             if ($epoch_2 > $last_visit) {
                 $last_visit = $epoch_2;
             }
             $times[$row->active_fi] += ($epoch_2 - $epoch_1);
         }
         $max_time = 0;
         foreach ($times as $key => $value) {
             $max_time += $value;
         }
         if ((!$test_result["test"]["total_reached_points"]) or (!$test_result["test"]["total_max_points"])) {
             $percentage = 0.0;
         } else {
             $percentage = ($test_result["test"]["total_reached_points"] / $test_result["test"]["total_max_points"]) * 100.0;
             if ($percentage < 0) {
                 $percentage = 0.0;
             }
         }
         $mark_obj = $this->getMarkSchema()->getMatchingMark($percentage);
         $first_date = getdate($first_visit);
         $last_date = getdate($last_visit);
         $qworkedthrough = 0;
         foreach ($test_result as $key => $value) {
             if (preg_match("/\d+/", $key)) {
                 $qworkedthrough += $value["workedthrough"];
             }
         }
         if (!$qworkedthrough) {
             $atimeofwork = 0;
         } else {
             $atimeofwork = $max_time / $qworkedthrough;
         }
 
         $result_mark = "";
         $passed = "";
 
         if ($mark_obj !== null) {
             $result_mark = $mark_obj->getShortName();
 
             if ($mark_obj->getPassed()) {
                 $passed = 1;
             } else {
                 $passed = 0;
             }
         }
         $percent_worked_through = 0;
         if (count($this->questions)) {
             $percent_worked_through = $qworkedthrough / count($this->questions);
         }
         $result_array = [
             "qworkedthrough" => $qworkedthrough,
             "qmax" => count($this->questions),
             "pworkedthrough" => $percent_worked_through,
             "timeofwork" => $max_time,
             "atimeofwork" => $atimeofwork,
             "firstvisit" => $first_date,
             "lastvisit" => $last_date,
             "resultspoints" => $test_result["test"]["total_reached_points"],
             "maxpoints" => $test_result["test"]["total_max_points"],
             "resultsmarks" => $result_mark,
             "passed" => $passed,
             "distancemedian" => "0"
         ];
         foreach ($test_result as $key => $value) {
             if (preg_match("/\d+/", $key)) {
                 $result_array[$key] = $value;
             }
         }
         return $result_array;
     }

Here is the call graph for this function:

◆ evalTotalParticipantsArray()

ilObjTest::evalTotalParticipantsArray ( string $name_sort_order = 'asc' )

Definition at line 2356 of file class.ilObjTest.php.

References ANONYMOUS_USER_ID, getAnonymity(), getTestId(), and ILIAS\Repository\lng().

Referenced by getTotalPointsPassedArray().

                                                                                : array
     {
         $result = $this->db->queryF(
             'SELECT tst_active.user_fi, tst_active.active_id, usr_data.login, '
             . 'usr_data.firstname, usr_data.lastname, usr_data.title FROM tst_active '
             . 'LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id '
             . 'WHERE tst_active.test_fi = %s '
             . 'ORDER BY usr_data.lastname ' . strtoupper($name_sort_order),
             ['integer'],
             [$this->getTestId()]
         );
         $persons_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             if ($this->getAnonymity()) {
                 $persons_array[$row['active_id']] = ['name' => $this->lng->txt("anonymous")];
             } else {
                 if (strlen($row['firstname'] . $row['lastname'] . $row["title"]) == 0) {
                     $persons_array[$row['active_id']] = ['name' => $this->lng->txt('deleted_user')];
                 } else {
                     if ($row['user_fi'] == ANONYMOUS_USER_ID) {
                         $persons_array[$row['active_id']] = ['name' => $row['lastname']];
                     } else {
                         $persons_array[$row['active_id']] = [
                             'name' => trim($row['lastname'] . ', ' . $row['firstname']
                                 . ' ' . $row['title']),
                             'login' => $row['login']
                         ];
                     }
                 }
             }
         }
         return $persons_array;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ evalTotalPersons()

ilObjTest::evalTotalPersons ( )

Returns the number of persons who started the test.

Returns: integer The number of persons who started the test public

Definition at line 1973 of file class.ilObjTest.php.

References getTestId().

Referenced by marksEditable(), participantDataExist(), and saveToDb().

                                       : int
     {
         $result = $this->db->queryF(
             'SELECT COUNT(active_id) total FROM tst_active WHERE test_fi = %s',
             ['integer'],
             [$this->getTestId()]
         );
         $row = $this->db->fetchAssoc($result);
         return $row['total'];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ evalTotalPersonsArray()

ilObjTest::evalTotalPersonsArray ( string $name_sort_order = 'asc' )

Definition at line 2326 of file class.ilObjTest.php.

References ANONYMOUS_USER_ID, getAccessFilteredParticipantList(), getAnonymity(), getTestId(), and ILIAS\Repository\lng().

                                                                           : array
     {
         $result = $this->db->queryF(
             "SELECT tst_active.user_fi, tst_active.active_id, usr_data.firstname, usr_data.lastname, usr_data.title FROM tst_active LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id WHERE tst_active.test_fi = %s ORDER BY usr_data.lastname " . strtoupper($name_sort_order),
             ['integer'],
             [$this->getTestId()]
         );
         $persons_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             if ($this->getAccessFilteredParticipantList() && !$this->getAccessFilteredParticipantList()->isActiveIdInList($row["active_id"])) {
                 continue;
             }
 
             if ($this->getAnonymity()) {
                 $persons_array[$row["active_id"]] = $this->lng->txt("anonymous");
             } else {
                 if (strlen($row["firstname"] . $row["lastname"] . $row["title"]) == 0) {
                     $persons_array[$row["active_id"]] = $this->lng->txt("deleted_user");
                 } else {
                     if ($row["user_fi"] == ANONYMOUS_USER_ID) {
                         $persons_array[$row["active_id"]] = $row["lastname"];
                     } else {
                         $persons_array[$row["active_id"]] = trim($row["lastname"] . ", " . $row["firstname"] . " " . $row["title"]);
                     }
                 }
             }
         }
         return $persons_array;
     }

Here is the call graph for this function:

◆ evalTotalStartedAverageTime()

ilObjTest::evalTotalStartedAverageTime ( ?array $active_ids_to_filter = null )

Definition at line 2583 of file class.ilObjTest.php.

References getTestId(), and null.

Referenced by getAggregatedResultsData(), and ILIAS\Test\Results\Data\Factory\getOverviewDataForTest().

                                                                                     : int
     {
         $query = "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.test_fi = %s AND tst_active.active_id = tst_times.active_fi";
 
         if ($active_ids_to_filter !== null && $active_ids_to_filter !== []) {
             $query .= " AND " . $this->db->in('active_id', $active_ids_to_filter, false, 'integer');
         }
 
         $result = $this->db->queryF($query, ['integer'], [$this->getTestId()]);
         $times = [];
         while ($row = $this->db->fetchObject($result)) {
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->finished, $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             if (isset($times[$row->active_fi])) {
                 $times[$row->active_fi] += ($epoch_2 - $epoch_1);
             } else {
                 $times[$row->active_fi] = ($epoch_2 - $epoch_1);
             }
         }
         $max_time = 0;
         $counter = 0;
         foreach ($times as $value) {
             $max_time += $value;
             $counter++;
         }
         if ($counter === 0) {
             return 0;
         }
         return (int) round($max_time / $counter);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportFileItems()

ilObjTest::exportFileItems	(		$target_dir,
		&	$expLog
	)

export files of file itmes

Definition at line 3957 of file class.ilObjTest.php.

References IL_INST_ID, and ilFileUtils\makeDir().

Referenced by exportPagesXML().

     {
         foreach ($this->file_ids as $file_id) {
             $expLog->write(date("[y-m-d H:i:s] ") . "File Item " . $file_id);
             $file_dir = $target_dir . '/objects/il_' . IL_INST_ID . '_file_' . $file_id;
             ilFileUtils::makeDir($file_dir);
             $file_obj = new ilObjFile((int) $file_id, false);
             $source_file = $file_obj->getFile($file_obj->getVersion());
             if (!is_file($source_file)) {
                 $source_file = $file_obj->getFile();
             }
             if (is_file($source_file)) {
                 copy($source_file, $file_dir . '/' . $file_obj->getFileName());
             }
             unset($file_obj);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportPagesXML()

ilObjTest::exportPagesXML	(	&	$a_xml_writer,
			$a_inst,
			$a_target_dir,
		&	$expLog
	)

export pages of test to xml (see ilias_co.dtd)

Parameters

object $a_xml_writer ilXmlWriter object that receives the xml data

Definition at line 3835 of file class.ilObjTest.php.

References exportFileItems(), exportXMLMediaObjects(), and exportXMLPageObjects().

                                                                                     : void
     {
         $this->mob_ids = [];
 
         // PageObjects
         $expLog->write(date("[y-m-d H:i:s] ") . "Start Export Page Objects");
         $this->bench->start("ContentObjectExport", "exportPageObjects");
         $this->exportXMLPageObjects($a_xml_writer, $a_inst, $expLog);
         $this->bench->stop("ContentObjectExport", "exportPageObjects");
         $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export Page Objects");
 
         // MediaObjects
         $expLog->write(date("[y-m-d H:i:s] ") . "Start Export Media Objects");
         $this->bench->start("ContentObjectExport", "exportMediaObjects");
         $this->exportXMLMediaObjects($a_xml_writer, $a_inst, $a_target_dir, $expLog);
         $this->bench->stop("ContentObjectExport", "exportMediaObjects");
         $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export Media Objects");
 
         // FileItems
         $expLog->write(date("[y-m-d H:i:s] ") . "Start Export File Items");
         $this->bench->start("ContentObjectExport", "exportFileItems");
         $this->exportFileItems($a_target_dir, $expLog);
         $this->bench->stop("ContentObjectExport", "exportFileItems");
         $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export File Items");
     }

Here is the call graph for this function:

◆ exportXMLMediaObjects()

ilObjTest::exportXMLMediaObjects	(	&	$a_xml_writer,
			$a_inst,
			$a_target_dir,
		&	$expLog
	)

export media objects to xml (see ilias_co.dtd)

Definition at line 3933 of file class.ilObjTest.php.

References ilObjMediaObject\_exists(), ilFileUtils\createDirectory(), and IL_INST_ID.

Referenced by exportPagesXML().

     {
         foreach ($this->mob_ids as $mob_id) {
             $expLog->write(date("[y-m-d H:i:s] ") . "Media Object " . $mob_id);
             if (ilObjMediaObject::_exists((int) $mob_id)) {
                 $target_dir = $a_target_dir . DIRECTORY_SEPARATOR . 'objects'
                     . DIRECTORY_SEPARATOR . 'il_' . IL_INST_ID . '_mob_' . $mob_id;
                 ilFileUtils::createDirectory($target_dir);
                 $media_obj = new ilObjMediaObject((int) $mob_id);
                 $media_obj->exportXML($a_xml_writer, (int) $a_inst);
                 foreach ($media_obj->getMediaItems() as $item) {
                     $stream = $item->getLocationStream();
                     file_put_contents($target_dir . DIRECTORY_SEPARATOR . $item->getLocation(), $stream);
                     $stream->close();
                 }
                 unset($media_obj);
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportXMLPageObjects()

ilObjTest::exportXMLPageObjects	(	&	$a_xml_writer,
			$inst,
		&	$expLog
	)

export page objects to xml (see ilias_co.dtd)

Parameters

object $a_xml_writer ilXmlWriter object that receives the xml data

Definition at line 3882 of file class.ilObjTest.php.

References ilPCFileList\collectFileItems().

Referenced by exportPagesXML().

     {
         foreach ($this->questions as $question_id) {
             $this->bench->start("ContentObjectExport", "exportPageObject");
             $expLog->write(date("[y-m-d H:i:s] ") . "Page Object " . $question_id);
 
             $attrs = [];
             $a_xml_writer->xmlStartTag("PageObject", $attrs);
 
 
             // export xml to writer object
             $this->bench->start("ContentObjectExport", "exportPageObject_XML");
             $page_object = new ilAssQuestionPage($question_id);
             $page_object->buildDom();
             $page_object->insertInstIntoIDs((string) $inst);
             $mob_ids = $page_object->collectMediaObjects(false);
             $file_ids = ilPCFileList::collectFileItems($page_object, $page_object->getDomDoc());
             $xml = $page_object->getXMLFromDom(false, false, false, "", true);
             $xml = str_replace("&", "&amp;", $xml);
             $a_xml_writer->appendXML($xml);
             $page_object->freeDom();
             unset($page_object);
 
             $this->bench->stop("ContentObjectExport", "exportPageObject_XML");
 
             // collect media objects
             $this->bench->start("ContentObjectExport", "exportPageObject_CollectMedia");
             //$mob_ids = $page_obj->getMediaObjectIDs();
             foreach ($mob_ids as $mob_id) {
                 $this->mob_ids[$mob_id] = $mob_id;
             }
             $this->bench->stop("ContentObjectExport", "exportPageObject_CollectMedia");
 
             // collect all file items
             $this->bench->start("ContentObjectExport", "exportPageObject_CollectFileItems");
             //$file_ids = $page_obj->getFileItemIds();
             foreach ($file_ids as $file_id) {
                 $this->file_ids[$file_id] = $file_id;
             }
             $this->bench->stop("ContentObjectExport", "exportPageObject_CollectFileItems");
 
             $a_xml_writer->xmlEndTag("PageObject");
             //unset($page_obj);
 
             $this->bench->stop("ContentObjectExport", "exportPageObject");
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fromXML()

ilObjTest::fromXML	(	ilQTIAssessment	$assessment,
		array	$mappings
	)

Receives parameters from a QTI parser and creates a valid ILIAS test object.

Parameters

ilQTIAssessment $assessment

Definition at line 2894 of file class.ilObjTest.php.

                                                                          : void
     {
         if (($importdir = ilSession::get('path_to_container_import_file')) === null) {
             $importdir = $this->buildImportDirectoryFromImportFile(ilSession::get('path_to_import_file'));
         }
         ilSession::clear('path_to_container_import_file');
         ilSession::clear('import_mob_xhtml');
 
         $this->saveToDb(true);
 
         $main_settings = $this->getMainSettings();
         $general_settings = $main_settings->getGeneralSettings();
         $introduction_settings = $main_settings->getIntroductionSettings();
         $access_settings = $main_settings->getAccessSettings();
         $test_behaviour_settings = $main_settings->getTestBehaviourSettings();
         $question_behaviour_settings = $main_settings->getQuestionBehaviourSettings();
         $participant_functionality_settings = $main_settings->getParticipantFunctionalitySettings();
         $finishing_settings = $main_settings->getFinishingSettings();
         $additional_settings = $main_settings->getAdditionalSettings();
 
         $introduction_settings = $introduction_settings->withIntroductionEnabled(false);
         foreach ($assessment->objectives as $objectives) {
             foreach ($objectives->materials as $material) {
                 $introduction_settings = $this->addIntroductionToSettingsFromImport(
                     $introduction_settings,
                     $this->qtiMaterialToArray($material),
                     $importdir,
                     $mappings
                 );
             }
         }
 
         if ($assessment->getPresentationMaterial()
             && $assessment->getPresentationMaterial()->getFlowMat(0)
             && $assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)) {
             $finishing_settings = $this->addConcludingRemarksToSettingsFromImport(
                 $finishing_settings,
                 $this->qtiMaterialToArray(
                     $assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)
                 ),
                 $importdir,
                 $mappings
             );
         }
 
         $score_settings = $this->getScoreSettings();
         $scoring_settings = $score_settings->getScoringSettings();
         $gamification_settings = $score_settings->getGamificationSettings();
         $result_summary_settings = $score_settings->getResultSummarySettings();
         $result_details_settings = $score_settings->getResultDetailsSettings();
 
         $mark_steps = [];
         foreach ($assessment->qtimetadata as $metadata) {
             switch ($metadata["label"]) {
                 case "solution_details":
                     $result_details_settings = $result_details_settings->withShowPassDetails((bool) $metadata["entry"]);
                     break;
                 case "show_solution_list_comparison":
                     $result_details_settings = $result_details_settings->withShowSolutionListComparison((bool) $metadata["entry"]);
                     break;
                 case "print_bs_with_res":
                     $result_details_settings = $result_details_settings->withShowSolutionListComparison((bool) $metadata["entry"]);
                     break;
                 case "author":
                     $this->saveAuthorToMetadata($metadata["entry"]);
                     break;
                 case "nr_of_tries":
                     $test_behaviour_settings = $test_behaviour_settings->withNumberOfTries((int) $metadata["entry"]);
                     break;
                 case 'block_after_passed':
                     $test_behaviour_settings = $test_behaviour_settings->withBlockAfterPassedEnabled((bool) $metadata['entry']);
                     break;
                 case "pass_waiting":
                     $test_behaviour_settings = $test_behaviour_settings->withPassWaiting($metadata["entry"]);
                     break;
                 case "kiosk":
                     $test_behaviour_settings = $test_behaviour_settings->withKioskMode((int) $metadata["entry"]);
                     break;
                 case 'show_introduction':
                     $introduction_settings = $introduction_settings->withIntroductionEnabled((bool) $metadata['entry']);
                     // no break
                 case "showfinalstatement":
                 case 'show_concluding_remarks':
                     $finishing_settings = $finishing_settings->withConcludingRemarksEnabled((bool) $metadata["entry"]);
                     break;
                 case "highscore_enabled":
                     $gamification_settings = $gamification_settings->withHighscoreEnabled((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_anon":
                     $gamification_settings = $gamification_settings->withHighscoreAnon((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_achieved_ts":
                     $gamification_settings = $gamification_settings->withHighscoreAchievedTS((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_score":
                     $gamification_settings = $gamification_settings->withHighscoreScore((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_percentage":
                     $gamification_settings = $gamification_settings->withHighscorePercentage((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_hints":
                     $gamification_settings = $gamification_settings->withHighscoreHints((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_wtime":
                     $gamification_settings = $gamification_settings->withHighscoreWTime((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_own_table":
                     $gamification_settings = $gamification_settings->withHighscoreOwnTable((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_top_table":
                     $gamification_settings = $gamification_settings->withHighscoreTopTable((bool) $metadata["entry"]);
                     break;
 
                 case "highscore_top_num":
                     $gamification_settings = $gamification_settings->withHighscoreTopNum((int) $metadata["entry"]);
                     break;
                 case "use_previous_answers":
                     $participant_functionality_settings = $participant_functionality_settings->withUsePreviousAnswerAllowed((bool) $metadata["entry"]);
                     break;
                 case "title_output":
                     $question_behaviour_settings = $question_behaviour_settings->withQuestionTitleOutputMode((int) $metadata["entry"]);
                     break;
                 case "question_set_type":
                     $general_settings = $general_settings->withQuestionSetType($metadata["entry"]);
                     break;
                 case "anonymity":
                     $general_settings = $general_settings->withAnonymity((bool) $metadata["entry"]);
                     break;
                 case "results_presentation":
                     $result_details_settings = $result_details_settings->withResultsPresentation((int) $metadata["entry"]);
                     break;
                 case "reset_processing_time":
                     $test_behaviour_settings = $test_behaviour_settings->withResetProcessingTime((bool) $metadata["entry"]);
                     break;
                 case "answer_feedback_points":
                     $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackPointsEnabled((bool) $metadata["entry"]);
                     break;
                 case "answer_feedback":
                     $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackGenericEnabled((bool) $metadata["entry"]);
                     break;
                 case 'instant_feedback_specific':
                     $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackSpecificEnabled((bool) $metadata['entry']);
                     break;
                 case "instant_verification":
                     $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackSolutionEnabled((bool) $metadata["entry"]);
                     break;
                 case "force_instant_feedback":
                     $question_behaviour_settings = $question_behaviour_settings->withForceInstantFeedbackOnNextQuestion((bool) $metadata["entry"]);
                     break;
                 case "follow_qst_answer_fixation":
                     $question_behaviour_settings = $question_behaviour_settings->withLockAnswerOnNextQuestionEnabled((bool) $metadata["entry"]);
                     break;
                 case "instant_feedback_answer_fixation":
                     $question_behaviour_settings = $question_behaviour_settings->withLockAnswerOnInstantFeedbackEnabled((bool) $metadata["entry"]);
                     break;
                 case "show_cancel":
                 case "suspend_test_allowed":
                     $participant_functionality_settings = $participant_functionality_settings->withSuspendTestAllowed((bool) $metadata["entry"]);
                     break;
                 case "sequence_settings":
                     $participant_functionality_settings = $participant_functionality_settings->withPostponedQuestionsMoveToEnd((bool) $metadata["entry"]);
                     break;
                 case "show_marker":
                     $participant_functionality_settings = $participant_functionality_settings->withQuestionMarkingEnabled((bool) $metadata["entry"]);
                     break;
                 case "fixed_participants":
                     $access_settings = $access_settings->withFixedParticipants((bool) $metadata["entry"]);
                     break;
                 case "score_reporting":
                     if ($metadata['entry'] !== null) {
                         $result_summary_settings = $result_summary_settings->withScoreReporting(
                             ScoreReportingTypes::tryFrom((int) $metadata['entry']) ?? ScoreReportingTypes::SCORE_REPORTING_DISABLED
                         );
                     }
                     break;
                 case "shuffle_questions":
                     $question_behaviour_settings = $question_behaviour_settings->withShuffleQuestions((bool) $metadata["entry"]);
                     break;
                 case "count_system":
                     $scoring_settings = $scoring_settings->withCountSystem((int) $metadata["entry"]);
                     break;
                 case "mailnotification":
                     $finishing_settings = $finishing_settings->withMailNotificationContentType((int) $metadata["entry"]);
                     break;
                 case "mailnottype":
                     $finishing_settings = $finishing_settings->withAlwaysSendMailNotification((bool) $metadata["entry"]);
                     break;
                 case "exportsettings":
                     $result_details_settings = $result_details_settings->withExportSettings((int) $metadata["entry"]);
                     break;
                 case "score_cutting":
                     $scoring_settings = $scoring_settings->withScoreCutting((int) $metadata["entry"]);
                     break;
                 case "password":
                     $access_settings = $access_settings->withPasswordEnabled(
                         $metadata["entry"] !== null && $metadata["entry"] !== ''
                     )->withPassword($metadata["entry"]);
                     break;
                 case 'ip_range_from':
                     if ($metadata['entry'] !== '') {
                         $access_settings = $access_settings->withIpRangeFrom($metadata['entry']);
                     }
                     break;
                 case 'ip_range_to':
                     if ($metadata['entry'] !== '') {
                         $access_settings = $access_settings->withIpRangeTo($metadata['entry']);
                     }
                     break;
                 case "pass_scoring":
                     $scoring_settings = $scoring_settings->withPassScoring((int) $metadata["entry"]);
                     break;
                 case 'pass_deletion_allowed':
                     $result_summary_settings = $result_summary_settings->withPassDeletionAllowed((bool) $metadata["entry"]);
                     break;
                 case "usr_pass_overview_mode":
                     $participant_functionality_settings = $participant_functionality_settings->withUsrPassOverviewMode((int) $metadata["entry"]);
                     break;
                 case "question_list":
                     $participant_functionality_settings = $participant_functionality_settings->withQuestionListEnabled((bool) $metadata["entry"]);
                     break;
 
                 case "reporting_date":
                     $reporting_date = $this->buildDateTimeImmutableFromPeriod($metadata['entry']);
                     if ($reporting_date !== null) {
                         $result_summary_settings = $result_summary_settings->withReportingDate($reporting_date);
                     }
                     break;
                 case 'enable_processing_time':
                     $test_behaviour_settings = $test_behaviour_settings->withProcessingTimeEnabled((bool) $metadata['entry']);
                     break;
                 case "processing_time":
                     $test_behaviour_settings = $test_behaviour_settings->withProcessingTime($metadata['entry']);
                     break;
                 case "starting_time":
                     $starting_time = $this->buildDateTimeImmutableFromPeriod($metadata['entry']);
                     if ($starting_time !== null) {
                         $access_settings = $access_settings->withStartTime($starting_time)
                             ->withStartTimeEnabled(true);
                     }
                     break;
                 case "ending_time":
                     $ending_time = $this->buildDateTimeImmutableFromPeriod($metadata['entry']);
                     if ($ending_time !== null) {
                         $access_settings = $access_settings->withEndTime($ending_time)
                             ->withStartTimeEnabled(true);
                     }
                     break;
                 case "enable_examview":
                     $finishing_settings = $finishing_settings->withShowAnswerOverview((bool) $metadata["entry"]);
                     break;
                 case 'redirection_mode':
                     $finishing_settings = $finishing_settings->withRedirectionMode((int) $metadata['entry']);
                     break;
                 case 'redirection_url':
                     $finishing_settings = $finishing_settings->withRedirectionUrl($metadata['entry']);
                     break;
                 case 'examid_in_test_pass':
                     $test_behaviour_settings = $test_behaviour_settings->withExamIdInTestAttemptEnabled((bool) $metadata['entry']);
                     break;
                 case 'examid_in_test_res':
                     $result_details_settings = $result_details_settings->withShowExamIdInTestResults((bool) $metadata["entry"]);
                     break;
                 case 'skill_service':
                     $additional_settings = $additional_settings->withSkillsServiceEnabled((bool) $metadata['entry']);
                     break;
                 case 'show_grading_status':
                     $result_summary_settings = $result_summary_settings->withShowGradingStatusEnabled((bool) $metadata["entry"]);
                     break;
                 case 'show_grading_mark':
                     $result_summary_settings = $result_summary_settings->withShowGradingMarkEnabled((bool) $metadata["entry"]);
                     break;
                 case 'activation_limited':
                     $this->setActivationLimited((bool) $metadata['entry']);
                     break;
                 case 'activation_start_time':
                     $this->setActivationStartingTime($metadata['entry'] !== 'null' ? (int) $metadata['entry'] : null);
                     break;
                 case 'activation_end_time':
                     $this->setActivationEndingTime($metadata['entry'] !== 'null' ? (int) $metadata['entry'] : null);
                     break;
                 case 'activation_visibility':
                     $this->setActivationVisibility($metadata['entry']);
                     break;
                 case 'autosave':
                     $question_behaviour_settings = $question_behaviour_settings->withAutosaveEnabled((bool) $metadata['entry']);
                     break;
                 case 'autosave_ival':
                     $question_behaviour_settings = $question_behaviour_settings->withAutosaveInterval((int) $metadata['entry']);
                     break;
                 case 'offer_question_hints':
                     $question_behaviour_settings = $question_behaviour_settings->withQuestionHintsEnabled((bool) $metadata['entry']);
                     break;
                 case 'show_summary':
                     $participant_functionality_settings = $participant_functionality_settings->withQuestionListEnabled(($metadata['entry'] & 1) > 0)
                         ->withUsrPassOverviewMode((int) $metadata['entry']);
             }
             if (preg_match("/mark_step_\d+/", $metadata["label"])) {
                 $xmlmark = $metadata["entry"];
                 preg_match("/<short>(.*?)<\/short>/", $xmlmark, $matches);
                 $mark_short = $matches[1];
                 preg_match("/<official>(.*?)<\/official>/", $xmlmark, $matches);
                 $mark_official = $matches[1];
                 preg_match("/<percentage>(.*?)<\/percentage>/", $xmlmark, $matches);
                 $mark_percentage = (float) $matches[1];
                 preg_match("/<passed>(.*?)<\/passed>/", $xmlmark, $matches);
                 $mark_passed = (bool) $matches[1];
                 $mark_steps[] = new Mark($mark_short, $mark_official, $mark_percentage, $mark_passed);
             }
         }
         $this->mark_schema = $this->getMarkSchema()->withMarkSteps($mark_steps);
         $this->saveToDb();
         $this->getObjectProperties()->storePropertyTitleAndDescription(
             $this->getObjectProperties()->getPropertyTitleAndDescription()
                 ->withTitle($assessment->getTitle())
                 ->withDescription($assessment->getComment())
         );
         $this->addToNewsOnOnline(false, $this->getObjectProperties()->getPropertyIsOnline()->getIsOnline());
         $main_settings = $main_settings
             ->withGeneralSettings($general_settings)
             ->withIntroductionSettings($introduction_settings)
             ->withAccessSettings($access_settings)
             ->withParticipantFunctionalitySettings($participant_functionality_settings)
             ->withTestBehaviourSettings($test_behaviour_settings)
             ->withQuestionBehaviourSettings($question_behaviour_settings)
             ->withFinishingSettings($finishing_settings)
             ->withAdditionalSettings($additional_settings);
         $this->getMainSettingsRepository()->store($main_settings);
         $this->main_settings = $main_settings;
 
         $score_settings = $score_settings
                 ->withGamificationSettings($gamification_settings)
                 ->withScoringSettings($scoring_settings)
                 ->withResultDetailsSettings($result_details_settings)
                 ->withResultSummarySettings($result_summary_settings);
         $this->getScoreSettingsRepository()->store($score_settings);
         $this->score_settings = $score_settings;
         $this->loadFromDb();
     }

Here is the call graph for this function:

◆ getAccessFilteredParticipantList()

ilObjTest::getAccessFilteredParticipantList ( )

Definition at line 2457 of file class.ilObjTest.php.

References $access_filtered_participant_list.

Referenced by evalTotalPersonsArray(), and getParticipantsForTestAndQuestion().

                                                       : ?ilTestParticipantList
     {
         return $this->access_filtered_participant_list;
     }

Here is the caller graph for this function:

◆ getActivationEndingTime()

ilObjTest::getActivationEndingTime ( )

Definition at line 6917 of file class.ilObjTest.php.

References $activation_ending_time.

Referenced by addDefaults(), saveToDb(), and toXML().

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

Here is the caller graph for this function:

◆ getActivationStartingTime()

ilObjTest::getActivationStartingTime ( )

Definition at line 6912 of file class.ilObjTest.php.

References $activation_starting_time.

Referenced by addDefaults(), saveToDb(), and toXML().

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

Here is the caller graph for this function:

◆ getActivationVisibility()

ilObjTest::getActivationVisibility ( )

Definition at line 6699 of file class.ilObjTest.php.

References $activation_visibility.

Referenced by addDefaults(), saveToDb(), and toXML().

                                              : bool
     {
         return $this->activation_visibility;
     }

Here is the caller graph for this function:

◆ getActiveIdOfUser()

ilObjTest::getActiveIdOfUser	(	$user_id = `""`,
		$anonymous_id = `""`
	)

Gets the active id of a given user.

Parameters

integer	$user_id	The database id of the user
string	$anonymous_id	The anonymous id if the test is an anonymized test

Returns: integer The active ID public

Definition at line 1699 of file class.ilObjTest.php.

References $user_id, ANONYMOUS_USER_ID, ilSession\get(), getTestId(), null, and ILIAS\Repository\user().

Referenced by getAllQuestions(), getExistingQuestions(), isExecutable(), loadQuestions(), ilCourseObjectiveResult\resetTestForUser(), and setQuestionSetSolved().

                                                                         : ?int
     {
         if (!$user_id) {
             $user_id = $this->user->getId();
         }
 
         $tst_access_code = ilSession::get('tst_access_code');
         if (is_array($tst_access_code) &&
             $this->user->getId() === ANONYMOUS_USER_ID &&
             isset($tst_access_code[$this->getTestId()]) &&
             $tst_access_code[$this->getTestId()] !== '') {
             $result = $this->db->queryF(
                 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s',
                 ['integer', 'integer', 'text'],
                 [$user_id, $this->test_id, $tst_access_code[$this->getTestId()]]
             );
         } elseif ((string) $anonymous_id !== '') {
             $result = $this->db->queryF(
                 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s',
                 ['integer', 'integer', 'text'],
                 [$user_id, $this->test_id, $anonymous_id]
             );
         } else {
             if ((int) $user_id === ANONYMOUS_USER_ID) {
                 return null;
             }
             $result = $this->db->queryF(
                 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s',
                 ['integer', 'integer'],
                 [$user_id, $this->test_id]
             );
         }
 
         if ($result->numRows()) {
             $row = $this->db->fetchAssoc($result);
             return (int) $row['active_id'];
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveParticipantList()

ilObjTest::getActiveParticipantList ( )

Definition at line 4371 of file class.ilObjTest.php.

References getTestParticipants(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

                                               : ilTestParticipantList
     {
         $participant_list = new ilTestParticipantList($this, $this->user, $this->lng, $this->db);
         $participant_list->initializeFromDbRows($this->getTestParticipants());
 
         return $participant_list;
     }

Here is the call graph for this function:

◆ getAggregatedResultsData()

ilObjTest::getAggregatedResultsData ( )

Definition at line 6398 of file class.ilObjTest.php.

References $data, $results, evalTotalStartedAverageTime(), getCompleteEvaluationData(), ILIAS\Repository\lng(), and secondsToHoursMinutesSecondsString().

                                               : array
     {
         $data = $this->getCompleteEvaluationData();
         $found_participants = $data->getParticipants();
         $results = ['overview' => [], 'questions' => []];
         if ($found_participants !== []) {
             $results['overview']['tst_stat_result_mark_median'] = $data->getStatistics()->getEvaluationDataOfMedianUser()?->getMark()?->getShortName() ?? '';
             $results['overview']['tst_stat_result_rank_median'] = $data->getStatistics()->rankMedian();
             $results['overview']['tst_stat_result_total_participants'] = $data->getStatistics()->count();
             $results['overview']['tst_stat_result_median'] = $data->getStatistics()->median();
             $results['overview']['tst_eval_total_persons'] = count($found_participants);
             $total_finished = $data->getTotalFinishedParticipants();
             $results['overview']['tst_eval_total_finished'] = $total_finished;
             $results['overview']['tst_eval_total_finished_average_time'] =
                 $this->secondsToHoursMinutesSecondsString(
                     $this->evalTotalStartedAverageTime($data->getParticipantIds())
                 );
             $total_passed = 0;
             $total_passed_reached = 0;
             $total_passed_max = 0;
             $total_passed_time = 0;
             foreach ($found_participants as $userdata) {
                 if ($userdata->getMark()?->getPassed()) {
                     $total_passed++;
                     $total_passed_reached += $userdata->getReached();
                     $total_passed_max += $userdata->getMaxpoints();
                     $total_passed_time += $userdata->getTimeOnTask();
                 }
             }
             $average_passed_reached = $total_passed ? $total_passed_reached / $total_passed : 0;
             $average_passed_max = $total_passed ? $total_passed_max / $total_passed : 0;
             $average_passed_time = $total_passed ? $total_passed_time / $total_passed : 0;
             $results['overview']['tst_eval_total_passed'] = $total_passed;
             $results['overview']['tst_eval_total_passed_average_points'] = sprintf('%2.2f', $average_passed_reached)
                 . ' ' . strtolower('of') . ' ' . sprintf('%2.2f', $average_passed_max);
             $results['overview']['tst_eval_total_passed_average_time'] =
                 $this->secondsToHoursMinutesSecondsString($average_passed_time);
         }
 
         foreach ($data->getQuestionTitles() as $question_id => $question_title) {
             $answered = 0;
             $reached = 0;
             $max = 0;
             foreach ($found_participants as $userdata) {
                 for ($i = 0; $i <= $userdata->getLastPass(); $i++) {
                     if (is_object($userdata->getPass($i))) {
                         $question = $userdata->getPass($i)->getAnsweredQuestionByQuestionId($question_id);
                         if (is_array($question)) {
                             $answered++;
                             $reached += $question['reached'];
                             $max += $question['points'];
                         }
                     }
                 }
             }
             $percent = $max ? $reached / $max * 100.0 : 0;
             $results['questions'][$question_id] = [
                 $question_title,
                 sprintf('%.2f', $answered ? $reached / $answered : 0) . ' ' . strtolower($this->lng->txt('of')) . ' ' . sprintf('%.2f', $answered ? $max / $answered : 0),
                 sprintf('%.2f', $percent) . '%',
                 $answered,
                 sprintf('%.2f', $answered ? $reached / $answered : 0),
                 sprintf('%.2f', $answered ? $max / $answered : 0),
                 $percent / 100.0
             ];
         }
         return $results;
     }

Here is the call graph for this function:

◆ getAllQuestions()

ilObjTest::getAllQuestions ( $pass = null )

Returns all questions of a test in test order.

Returns: array An array containing the id's as keys and the database row objects as values public

Definition at line 1659 of file class.ilObjTest.php.

References getActiveIdOfUser(), isRandomTest(), loadQuestions(), null, and ILIAS\Repository\user().

                                                  : array
     {
         if ($this->isRandomTest()) {
             $active_id = $this->getActiveIdOfUser($this->user->getId());
             if ($active_id === null) {
                 return [];
             }
             $this->loadQuestions($active_id, $pass);
             if (count($this->questions) === 0) {
                 return [];
             }
             if (is_null($pass)) {
                 $pass = self::_getPass($active_id);
             }
             $result = $this->db->queryF(
                 "SELECT qpl_questions.* FROM qpl_questions, tst_test_rnd_qst WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id AND tst_test_rnd_qst.active_fi = %s AND tst_test_rnd_qst.pass = %s AND " . $this->db->in('qpl_questions.question_id', $this->questions, false, 'integer'),
                 ['integer','integer'],
                 [$active_id, $pass]
             );
         } else {
             if (count($this->questions) === 0) {
                 return [];
             }
             $result = $this->db->query("SELECT qpl_questions.* FROM qpl_questions, tst_test_question WHERE tst_test_question.question_fi = qpl_questions.question_id AND " . $this->db->in('qpl_questions.question_id', $this->questions, false, 'integer'));
         }
         $result_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $result_array[$row["question_id"]] = $row;
         }
         return $result_array;
     }

Here is the call graph for this function:

◆ getAllTestResults()

ilObjTest::getAllTestResults ( $participants )

returns all test results for all participants

Parameters

array $partipants array of user ids

Returns: array of fields, see code for column titles

Definition at line 4711 of file class.ilObjTest.php.

References $results, _getResultPass(), _instanciateQuestion(), getAnonymity(), getMarkSchema(), ILIAS\Repository\lng(), and null.

                                                     : array
     {
         $results = [];
         $row = [
             "user_id" => $this->lng->txt("user_id"),
             "matriculation" => $this->lng->txt("matriculation"),
             "lastname" => $this->lng->txt("lastname"),
             "firstname" => $this->lng->txt("firstname"),
             "login" => $this->lng->txt("login"),
             "reached_points" => $this->lng->txt("tst_reached_points"),
             "max_points" => $this->lng->txt("tst_maximum_points"),
             "percent_value" => $this->lng->txt("tst_percent_solved"),
             "mark" => $this->lng->txt("tst_mark"),
             "passed" => $this->lng->txt("tst_mark_passed"),
         ];
         $results[] = $row;
         if (count($participants)) {
             foreach ($participants as $active_id => $user_rec) {
                 $mark = '';
                 $row = [];
                 $reached_points = 0;
                 $max_points = 0;
                 $pass = ilObjTest::_getResultPass($active_id);
                 // abort if no valid pass can be found
                 if (!is_int($pass)) {
                     continue;
                 }
                 foreach ($this->questions as $value) {
                     $question = ilObjTest::_instanciateQuestion($value);
                     if (is_object($question)) {
                         $max_points += $question->getMaximumPoints();
                         $reached_points += $question->getReachedPoints($active_id, $pass);
                     }
                 }
                 if ($max_points > 0) {
                     $percentvalue = $reached_points / $max_points;
                     if ($percentvalue < 0) {
                         $percentvalue = 0.0;
                     }
                 } else {
                     $percentvalue = 0;
                 }
                 $mark_obj = $this->getMarkSchema()->getMatchingMark($percentvalue * 100);
                 $passed = "";
                 if ($mark_obj !== null) {
                     $mark = $mark_obj->getOfficialName();
                 }
                 if ($this->getAnonymity()) {
                     $user_rec['firstname'] = "";
                     $user_rec['lastname'] = $this->lng->txt("anonymous");
                 }
                 $results[] = [
                     "user_id" => $user_rec['usr_id'],
                     "matriculation" => $user_rec['matriculation'],
                     "lastname" => $user_rec['lastname'],
                     "firstname" => $user_rec['firstname'],
                     "login" => $user_rec['login'],
                     "reached_points" => $reached_points,
                     "max_points" => $max_points,
                     "percent_value" => $percentvalue,
                     "mark" => $mark,
                     "passed" => $user_rec['passed'] ? '1' : '0',
                 ];
             }
         }
         return $results;
     }

Here is the call graph for this function:

◆ getAnonymity()

ilObjTest::getAnonymity ( )

Definition at line 5542 of file class.ilObjTest.php.

References getMainSettings().

Referenced by buildName(), evalTotalParticipantsArray(), evalTotalPersonsArray(), getAllTestResults(), getDetailedTestResults(), getInvitedUsers(), getParticipants(), ilTestArchiver\getResultsOfUserOutput(), getTestParticipants(), getUserData(), isHighscoreAnon(), and userLookupFullName().

                                   : bool
     {
         return $this->getMainSettings()->getGeneralSettings()->getAnonymity();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAnsweredQuestionCount()

ilObjTest::getAnsweredQuestionCount	(	$active_id,
		$pass = `null`
	)

Retrieves the number of answered questions for a given user in a given test.

Parameters

integer	$user_id	The user id
integer	$test_id	The test id
integer	$pass	The pass of the test (optional)

Returns: integer The number of answered questions public

Definition at line 4901 of file class.ilObjTest.php.

References isRandomTest(), and loadQuestions().

                                                                       : int
     {
         if ($this->isRandomTest()) {
             $this->loadQuestions($active_id, $pass);
         }
         $workedthrough = 0;
         foreach ($this->questions as $value) {
             if ($this->questionrepository->lookupResultRecordExist($active_id, $value, $pass)) {
                 $workedthrough += 1;
             }
         }
         return $workedthrough;
     }

Here is the call graph for this function:

◆ getAnswerFeedbackPoints()

ilObjTest::getAnswerFeedbackPoints ( )

Definition at line 746 of file class.ilObjTest.php.

References getMainSettings().

                                              : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackPointsEnabled();
     }

Here is the call graph for this function:

◆ getAuthor()

ilObjTest::getAuthor ( )

Gets the authors name of the ilObjTest object.

Returns: string The string containing the name of the test author public

See also: $author

Definition at line 4057 of file class.ilObjTest.php.

References ilObject\getId(), and ilObject\getType().

Referenced by toXML().

                                : string
     {
         $path_to_authors = $this->lo_metadata->paths()->authors();
         $author_data = $this->lo_metadata->read($this->getId(), 0, $this->getType(), $path_to_authors)
                                          ->allData($path_to_authors);
 
         return $this->lo_metadata->dataHelper()->makePresentableAsList(', ', ...$author_data);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAutosave()

ilObjTest::getAutosave ( )

Definition at line 6887 of file class.ilObjTest.php.

References getMainSettings().

Referenced by ILIAS\Test\Results\Data\Factory\buildAttemptResults().

                                  : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getAutosaveEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAvailableDefaults()

ilObjTest::getAvailableDefaults ( )

Returns the available test defaults for the active user.

Returns: array An array containing the defaults public

Definition at line 5630 of file class.ilObjTest.php.

References ILIAS\Repository\user().

                                           : array
     {
         $result = $this->db->queryF(
             "SELECT * FROM tst_test_defaults WHERE user_fi = %s ORDER BY name ASC",
             ['integer'],
             [$this->user->getId()]
         );
         $defaults = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $defaults[$row["test_defaults_id"]] = $row;
         }
         return $defaults;
     }

Here is the call graph for this function:

◆ getAvailableQuestionpools()

ilObjTest::getAvailableQuestionpools	(	bool	$use_object_id = `false`,
		?bool	$equal_points = `false`,
		bool	$could_be_offline = `false`,
		bool	$show_path = `false`,
		bool	$with_questioncount = `false`,
		string	$permission = `'read'`
	)

Returns the available question pools for the active user.

Returns: array The available question pools public

Definition at line 2636 of file class.ilObjTest.php.

References ilObjQuestionPool\_getAvailableQuestionpools().

      : array {
         return ilObjQuestionPool::_getAvailableQuestionpools(
             $use_object_id,
             $equal_points ?? false,
             $could_be_offline,
             $show_path,
             $with_questioncount,
             $permission
         );
     }

Here is the call graph for this function:

◆ getAvailableQuestions()

ilObjTest::getAvailableQuestions	(	$arr_filter,
		$completeonly = `0`
	)

Calculates the available questions for a test.

public

Definition at line 2814 of file class.ilObjTest.php.

References XapiProxy\$plugin, ilObjQuestionPool\_getAvailableQuestionpools(), ilAssQuestionType\completeMissingPluginName(), getExistingQuestions(), and ILIAS\Repository\lng().

                                                                          : array
     {
         $available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools(true, false, false, false, false));
         $available = "";
         if (count($available_pools)) {
             $available = " AND " . $this->db->in('qpl_questions.obj_fi', $available_pools, false, 'integer');
         } else {
             return [];
         }
         if ($completeonly) {
             $available .= " AND qpl_questions.complete = " . $this->db->quote("1", 'text');
         }
 
         $where = "";
         if (is_array($arr_filter)) {
             if (array_key_exists('title', $arr_filter) && strlen($arr_filter['title'])) {
                 $where .= " AND " . $this->db->like('qpl_questions.title', 'text', "%%" . $arr_filter['title'] . "%%");
             }
             if (array_key_exists('description', $arr_filter) && strlen($arr_filter['description'])) {
                 $where .= " AND " . $this->db->like('qpl_questions.description', 'text', "%%" . $arr_filter['description'] . "%%");
             }
             if (array_key_exists('author', $arr_filter) && strlen($arr_filter['author'])) {
                 $where .= " AND " . $this->db->like('qpl_questions.author', 'text', "%%" . $arr_filter['author'] . "%%");
             }
             if (array_key_exists('type', $arr_filter) && strlen($arr_filter['type'])) {
                 $where .= " AND qpl_qst_type.type_tag = " . $this->db->quote($arr_filter['type'], 'text');
             }
             if (array_key_exists('qpl', $arr_filter) && strlen($arr_filter['qpl'])) {
                 $where .= " AND " . $this->db->like('object_data.title', 'text', "%%" . $arr_filter['qpl'] . "%%");
             }
         }
 
         $original_ids = &$this->getExistingQuestions();
         $original_clause = " qpl_questions.original_id IS NULL";
         if (count($original_ids)) {
             $original_clause = " qpl_questions.original_id IS NULL AND " . $this->db->in('qpl_questions.question_id', $original_ids, true, 'integer');
         }
 
         $query_result = $this->db->query("
                         SELECT          qpl_questions.*, qpl_questions.tstamp,
                                                 qpl_qst_type.type_tag, qpl_qst_type.plugin, qpl_qst_type.plugin_name,
                                                 object_data.title parent_title
                         FROM            qpl_questions, qpl_qst_type, object_data
                         WHERE $original_clause $available
                         AND object_data.obj_id = qpl_questions.obj_fi
                         AND qpl_questions.tstamp > 0
                         AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id
                         $where
                 ");
         $rows = [];
 
         if ($query_result->numRows()) {
             while ($row = $this->db->fetchAssoc($query_result)) {
                 $row = ilAssQuestionType::completeMissingPluginName($row);
 
                 if (!$row['plugin']) {
                     $row[ 'ttype' ] = $this->lng->txt($row[ "type_tag" ]);
 
                     $rows[] = $row;
                     continue;
                 }
 
                 $plugin = $this->component_repository->getPluginByName($row['plugin_name']);
                 if (!$plugin->isActive()) {
                     continue;
                 }
 
                 $pl = $this->component_factory->getPlugin($plugin->getId());
                 $row[ 'ttype' ] = $pl->getQuestionTypeTranslation();
 
                 $rows[] = $row;
             }
         }
         return $rows;
     }

Here is the call graph for this function:

◆ getCompleteEvaluationData()

ilObjTest::getCompleteEvaluationData	(	$filterby = `''`,
		$filtertext = `''`
	)

Definition at line 2544 of file class.ilObjTest.php.

References $data, and getUnfilteredEvaluationData().

Referenced by getAggregatedResultsData(), and ILIAS\Test\Results\Data\Factory\retrieveResultData().

                                                                                : ilTestEvaluationData
     {
         $data = $this->getUnfilteredEvaluationData();
         $data->setFilter($filterby, $filtertext);
         return $data;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCompleteManualFeedback()

ilObjTest::getCompleteManualFeedback ( int $question_id )

Retrieves the manual feedback for a question in a test.

Parameters

integer $question_id Question ID

Returns: array The feedback text public

Definition at line 6123 of file class.ilObjTest.php.

References $DIC, $ilDB, and ilRTE\_replaceMediaObjectImageSrc().

                                                                : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $feedback = [];
         $result = $ilDB->queryF(
             "SELECT * FROM tst_manual_fb WHERE question_fi = %s",
             ['integer'],
             [$question_id]
         );
 
         while ($row = $ilDB->fetchAssoc($result)) {
             $active = $row['active_fi'];
             $pass = $row['pass'];
             $question = $row['question_fi'];
 
             $row['feedback'] = ilRTE::_replaceMediaObjectImageSrc($row['feedback'] ?? '', 1);
 
             $feedback[$active][$pass][$question] = $row;
         }
 
         return $feedback;
     }

Here is the call graph for this function:

◆ getCompleteWorkingTime()

ilObjTest::getCompleteWorkingTime ( $user_id )

Returns the complete working time in seconds a user worked on the test.

Returns: integer The working time in seconds public

Definition at line 1990 of file class.ilObjTest.php.

References $user_id, and getTestId().

                                                     : int
     {
         $result = $this->db->queryF(
             "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.test_fi = %s AND tst_active.active_id = tst_times.active_fi AND tst_active.user_fi = %s",
             ['integer','integer'],
             [$this->getTestId(), $user_id]
         );
         $time = 0;
         while ($row = $this->db->fetchAssoc($result)) {
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             $time += ($epoch_2 - $epoch_1);
         }
         return $time;
     }

Here is the call graph for this function:

◆ getCompleteWorkingTimeOfParticipant()

ilObjTest::getCompleteWorkingTimeOfParticipant ( $active_id )

Returns the complete working time in seconds for a test participant.

Returns: integer The working time in seconds for the test participant public

Definition at line 2082 of file class.ilObjTest.php.

References getTestId().

                                                                    : int
     {
         $result = $this->db->queryF(
             "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.test_fi = %s AND tst_active.active_id = tst_times.active_fi AND tst_active.active_id = %s ORDER BY tst_times.active_fi, tst_times.started",
             ['integer','integer'],
             [$this->getTestId(), $active_id]
         );
         $time = 0;
         while ($row = $this->db->fetchAssoc($result)) {
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             $time += ($epoch_2 - $epoch_1);
         }
         return $time;
     }

Here is the call graph for this function:

◆ getCompleteWorkingTimeOfParticipants()

& ilObjTest::getCompleteWorkingTimeOfParticipants ( )

Returns the complete working time in seconds for all test participants.

Returns: array An array containing the working time in seconds for all test participants public

Definition at line 2028 of file class.ilObjTest.php.

References _getCompleteWorkingTimeOfParticipants(), and getTestId().

                                                            : array
     {
         return $this->_getCompleteWorkingTimeOfParticipants($this->getTestId());
     }

Here is the call graph for this function:

◆ getConcludingRemarksPageId()

ilObjTest::getConcludingRemarksPageId ( )

Definition at line 6762 of file class.ilObjTest.php.

References ilObject\getId(), getMainSettings(), getMainSettingsRepository(), and null.

                                                 : int
     {
         $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
         if ($page_id !== null) {
             return $page_id;
         }
 
         $page_object = new ilTestPage();
         $page_object->setParentId($this->getId());
         $new_page_id = $page_object->createPageWithNextId();
         $settings = $this->getMainSettings()->getFinishingSettings()
             ->withConcludingRemarksPageId($new_page_id);
         $this->getMainSettingsRepository()->store(
             $this->getMainSettings()->withFinishingSettings($settings)
         );
         return $new_page_id;
     }

Here is the call graph for this function:

◆ getCountSystem()

ilObjTest::getCountSystem ( )

Definition at line 761 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                     : int
     {
         return $this->getScoreSettings()->getScoringSettings()->getCountSystem();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDetailedTestResults()

ilObjTest::getDetailedTestResults ( $participants )

returns all test results for all participants

Parameters

array $partipants array of user ids

Returns: array of fields, see code for column titles

Definition at line 6256 of file class.ilObjTest.php.

References $results, _getResultPass(), _instanciateQuestion(), getAnonymity(), and ILIAS\Repository\lng().

                                                          : array
     {
         $results = [];
         if (count($participants)) {
             foreach ($participants as $active_id => $user_rec) {
                 $row = [];
                 $reached_points = 0;
                 $max_points = 0;
                 $pass = ilObjTest::_getResultPass($active_id);
                 foreach ($this->questions as $value) {
                     $question = ilObjTest::_instanciateQuestion($value);
                     if (is_object($question)) {
                         $max_points += $question->getMaximumPoints();
                         $reached_points += $question->getReachedPoints($active_id, $pass);
                         if ($max_points > 0) {
                             $percentvalue = $reached_points / $max_points;
                             if ($percentvalue < 0) {
                                 $percentvalue = 0.0;
                             }
                         } else {
                             $percentvalue = 0;
                         }
                         if ($this->getAnonymity()) {
                             $user_rec['firstname'] = "";
                             $user_rec['lastname'] = $this->lng->txt("anonymous");
                         }
                         $results[] = [
                             "user_id" => $user_rec['usr_id'],
                             "matriculation" => $user_rec['matriculation'],
                             "lastname" => $user_rec['lastname'],
                             "firstname" => $user_rec['firstname'],
                             "login" => $user_rec['login'],
                             "question_id" => $question->getId(),
                             "question_title" => $question->getTitle(),
                             "reached_points" => $reached_points,
                             "max_points" => $max_points,
                             "passed" => $user_rec['passed'] ? '1' : '0',
                         ];
                     }
                 }
             }
         }
         return $results;
     }

Here is the call graph for this function:

◆ getEnableExamview()

ilObjTest::getEnableExamview ( )

Definition at line 6897 of file class.ilObjTest.php.

References getMainSettings().

                                        : bool
     {
         return $this->getMainSettings()->getFinishingSettings()->getShowAnswerOverview();
     }

Here is the call graph for this function:

◆ getEnableProcessingTime()

ilObjTest::getEnableProcessingTime ( )

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

References getMainSettings().

Referenced by isExecutable(), and isMaxProcessingTimeReached().

                                              : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTimeEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getEndingTime()

ilObjTest::getEndingTime ( )

Definition at line 966 of file class.ilObjTest.php.

References getMainSettings(), and null.

Referenced by endingTimeReached(), isExecutable(), and toXML().

                                    : int
     {
         $end_time = $this->getMainSettings()->getAccessSettings()->getEndTime();
         return $end_time !== null ? $end_time->getTimestamp() : 0;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExistingQuestions()

& ilObjTest::getExistingQuestions ( $pass = null )

Get the id's of the questions which are already part of the test.

Returns: array An array containing the already existing questions public

Definition at line 1524 of file class.ilObjTest.php.

References $data, getActiveIdOfUser(), getTestId(), isRandomTest(), null, and ILIAS\Repository\user().

Referenced by getAvailableQuestions().

                                                        : array
     {
         $existing_questions = [];
         $active_id = $this->getActiveIdOfUser($this->user->getId());
         if ($this->isRandomTest()) {
             if (is_null($pass)) {
                 $pass = 0;
             }
             $result = $this->db->queryF(
                 "SELECT qpl_questions.original_id FROM qpl_questions, tst_test_rnd_qst WHERE tst_test_rnd_qst.active_fi = %s AND tst_test_rnd_qst.question_fi = qpl_questions.question_id AND tst_test_rnd_qst.pass = %s",
                 ['integer','integer'],
                 [$active_id, $pass]
             );
         } else {
             $result = $this->db->queryF(
                 "SELECT qpl_questions.original_id FROM qpl_questions, tst_test_question WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id",
                 ['integer'],
                 [$this->getTestId()]
             );
         }
         while ($data = $this->db->fetchObject($result)) {
             if ($data->original_id === null) {
                 continue;
             }
 
             array_push($existing_questions, $data->original_id);
         }
         return $existing_questions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExportDirectory()

ilObjTest::getExportDirectory ( )

Definition at line 365 of file class.ilObjTest.php.

References ilFileUtils\getDataDir(), ilObject\getId(), and ILIAS\UI\examples\Symbol\Glyph\Sort\sort().

                                         : string
     {
         $export_dir = ilFileUtils::getDataDir() . "/tst_data" . "/tst_" . $this->getId() . "/export";
         return $export_dir;
     }

Here is the call graph for this function:

◆ getExportSettings()

ilObjTest::getExportSettings ( )

Definition at line 6566 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                        : int
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getExportSettings();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExtraTime()

ilObjTest::getExtraTime ( int $active_id )

private

Definition at line 6956 of file class.ilObjTest.php.

References getTestId().

Referenced by getProcessingTimeInSeconds().

                                                  : int
     {
         if ($active_id === 0) {
             return 0;
         }
         return $this->participant_repository
             ->getParticipantByActiveId($this->getTestId(), $active_id)
             ?->getExtraTime() ?? 0;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFinalStatement()

ilObjTest::getFinalStatement ( )

Definition at line 701 of file class.ilObjTest.php.

References getMainSettings(), and null.

Referenced by toXML().

                                        : string
     {
         $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
         if ($page_id !== null) {
             return (new ilTestPageGUI('tst', $page_id))->showPage();
         }
         return $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksText();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFixedParticipants()

ilObjTest::getFixedParticipants ( )

Definition at line 5574 of file class.ilObjTest.php.

References getMainSettings().

                                           : bool
     {
         return $this->getMainSettings()->getAccessSettings()->getFixedParticipants();
     }

Here is the call graph for this function:

◆ getFixedQuestionSetTotalPoints()

ilObjTest::getFixedQuestionSetTotalPoints ( )

Definition at line 5207 of file class.ilObjTest.php.

References getTestQuestions().

                                                     : float
     {
         $points = 0;
 
         foreach ($this->getTestQuestions() as $question_data) {
             $points += $question_data['points'];
         }
 
         return $points;
     }

Here is the call graph for this function:

◆ getGeneralQuestionPropertiesRepository()

ilObjTest::getGeneralQuestionPropertiesRepository ( )

Definition at line 7298 of file class.ilObjTest.php.

References $questionrepository.

                                                             : GeneralQuestionPropertiesRepository
     {
         return $this->questionrepository;
     }

◆ getGenericAnswerFeedback()

ilObjTest::getGenericAnswerFeedback ( )

Definition at line 751 of file class.ilObjTest.php.

References getMainSettings().

                                               : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackGenericEnabled();
     }

Here is the call graph for this function:

◆ getGlobalSettings()

ilObjTest::getGlobalSettings ( )

Definition at line 7303 of file class.ilObjTest.php.

Referenced by getTestParticipantsForManualScoring().

                                        : GlobalTestSettings
     {
         return $this->global_settings_repo->getGlobalSettings();
     }

Here is the caller graph for this function:

◆ getGroupData()

ilObjTest::getGroupData ( $ids )

Definition at line 4561 of file class.ilObjTest.php.

References ilObject\$ref_id, ilObject\_lookupDescription(), ilObject\_lookupObjId(), and ilObject\_lookupTitle().

                                       : array
     {
         if (!is_array($ids) || count($ids) == 0) {
             return [];
         }
         $result = [];
         foreach ($ids as $ref_id) {
             $obj_id = ilObject::_lookupObjId($ref_id);
             $result[$ref_id] = ["ref_id" => $ref_id, "title" => ilObject::_lookupTitle($obj_id), "description" => ilObject::_lookupDescription($obj_id)];
         }
         return $result;
     }

Here is the call graph for this function:

◆ getHighscoreAchievedTS()

ilObjTest::getHighscoreAchievedTS ( )

Returns if date and time of the scores achievement should be displayed.

Definition at line 6815 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                             : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreAchievedTS();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreAnon()

ilObjTest::getHighscoreAnon ( )

Gets if the highscores should be anonymized per setting.

Note: This method will retrieve the setting as set by the user. If you want to figure out, if the highscore is to be shown anonymized or not, with consideration of the global anon switch you should

See also: isHighscoreAnon().

Returns: bool True, if setting is to anonymize highscores.

Definition at line 6794 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by isHighscoreAnon(), and toXML().

                                       : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreAnon();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreEnabled()

ilObjTest::getHighscoreEnabled ( )

Definition at line 6780 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                          : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreHints()

ilObjTest::getHighscoreHints ( )

Gets, if the column with the number of requested hints should be shown.

Definition at line 6839 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                        : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreHints();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreMode()

ilObjTest::getHighscoreMode ( )

Definition at line 6877 of file class.ilObjTest.php.

References getScoreSettings().

                                       : int
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighScoreMode();
     }

Here is the call graph for this function:

◆ getHighscoreOwnTable()

ilObjTest::getHighscoreOwnTable ( )

Gets if the own rankings table should be shown.

Definition at line 6855 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                           : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreOwnTable();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscorePercentage()

ilObjTest::getHighscorePercentage ( )

Gets if the percentage column should be shown.

Definition at line 6831 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                             : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscorePercentage();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreScore()

ilObjTest::getHighscoreScore ( )

Gets if the score column should be shown.

Definition at line 6823 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                        : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreScore();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreTopNum()

ilObjTest::getHighscoreTopNum ( int $a_retval = 10 )

Gets the number of entries which are to be shown in the top-rankings table.

Returns: integer Number of entries to be shown in the top-rankings table.

Definition at line 6872 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by ILIAS\Test\Results\Toplist\TestTopListRepository\getGeneralToplist(), ILIAS\Test\Results\Toplist\TestTopListRepository\getUserToplistByPercentage(), ILIAS\Test\Results\Toplist\TestTopListRepository\getUserToplistByWorkingtime(), and toXML().

                                                           : int
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreTopNum();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreTopTable()

ilObjTest::getHighscoreTopTable ( )

Gets, if the top-rankings table should be shown.

Definition at line 6863 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                           : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreTopTable();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHighscoreWTime()

ilObjTest::getHighscoreWTime ( )

Gets if the column with the workingtime should be shown.

Definition at line 6847 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                        : bool
     {
         return $this->getScoreSettings()->getGamificationSettings()->getHighscoreWTime();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHtmlQuestionContentPurifier()

ilObjTest::getHtmlQuestionContentPurifier ( )

protected

Returns: ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

Definition at line 7293 of file class.ilObjTest.php.

References ilHtmlPurifierFactory\getInstanceByType().

                                                        : ilHtmlPurifierInterface
     {
         return ilHtmlPurifierFactory::getInstanceByType('qpl_usersolution');
     }

Here is the call graph for this function:

◆ getImagePath()

ilObjTest::getImagePath ( )

Returns the image path for web accessable images of a test The image path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_TEST/images.

public

Definition at line 2660 of file class.ilObjTest.php.

References CLIENT_WEB_DIR, and ilObject\getId().

                                   : string
     {
         return CLIENT_WEB_DIR . "/assessment/" . $this->getId() . "/images/";
     }

Here is the call graph for this function:

◆ getImagePathWeb()

ilObjTest::getImagePathWeb ( )

Returns the web image path for web accessable images of a test The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_TEST/images.

public

Definition at line 2671 of file class.ilObjTest.php.

References CLIENT_WEB_DIR, ilObject\getId(), and ilFileUtils\removeTrailingPathSeparators().

     {
         $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/" . $this->getId() . "/images/";
         return str_replace(
             ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
             ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
             $webdir
         );
     }

Here is the call graph for this function:

◆ getImportMapping()

ilObjTest::getImportMapping ( )

get array of (two) new created questions for import id

Definition at line 3979 of file class.ilObjTest.php.

                                       : array
     {
         return [];
     }

◆ getInstantFeedbackSolution()

ilObjTest::getInstantFeedbackSolution ( )

Definition at line 756 of file class.ilObjTest.php.

References getMainSettings().

Referenced by toXML().

                                                 : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackSolutionEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIntroduction()

ilObjTest::getIntroduction ( )

Definition at line 682 of file class.ilObjTest.php.

References getMainSettings(), and null.

Referenced by toXML().

                                      : string
     {
         $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
         if ($page_id !== null) {
             return (new ilTestPageGUI('tst', $page_id))->showPage();
         }
 
         return $this->getMainSettings()->getIntroductionSettings()->getIntroductionText();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIntroductionPageId()

ilObjTest::getIntroductionPageId ( )

Definition at line 6744 of file class.ilObjTest.php.

References ilObject\getId(), getMainSettings(), getMainSettingsRepository(), and null.

                                            : int
     {
         $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
         if ($page_id !== null) {
             return $page_id;
         }
 
         $page_object = new ilTestPage();
         $page_object->setParentId($this->getId());
         $new_page_id = $page_object->createPageWithNextId();
         $settings = $this->getMainSettings()->getIntroductionSettings()
             ->withIntroductionPageId($new_page_id);
         $this->getMainSettingsRepository()->store(
             $this->getMainSettings()->withIntroductionSettings($settings)
         );
         return $new_page_id;
     }

Here is the call graph for this function:

◆ getInvitedUsers()

& ilObjTest::getInvitedUsers	(	int	$user_id = `0`,
			$order = `"login, lastname, firstname"`
	)

Returns a list of all invited users in a test.

Returns: array array of invited users public

Definition at line 4385 of file class.ilObjTest.php.

References $user_id, getAnonymity(), getTestId(), and ILIAS\Repository\lng().

                                                                                              : array
     {
         $result_array = [];
 
         if ($this->getAnonymity()) {
             if ($user_id !== 0) {
                 $result = $this->db->queryF(
                     "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, " .
                     "tst_active.submitted test_finished, matriculation, COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes  FROM usr_data, tst_invited_user " .
                     "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
                     "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
                     "ORDER BY $order",
                     ['text', 'text', 'text', 'integer', 'integer'],
                     ['', $this->lng->txt('anonymous'), '', $this->getTestId(), $user_id]
                 );
             } else {
                 $result = $this->db->queryF(
                     "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, " .
                     "tst_active.submitted test_finished, matriculation, COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes  FROM usr_data, tst_invited_user " .
                     "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
                     "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
                     "ORDER BY $order",
                     ['text', 'text', 'text', 'integer'],
                     ['', $this->lng->txt('anonymous'), '', $this->getTestId()]
                 );
             }
         } else {
             if ($user_id !== 0) {
                 $result = $this->db->queryF(
                     "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, " .
                     "tst_active.submitted test_finished, matriculation, COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes  FROM usr_data, tst_invited_user " .
                     "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
                     "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
                     "ORDER BY $order",
                     ['integer', 'integer'],
                     [$this->getTestId(), $user_id]
                 );
             } else {
                 $result = $this->db->queryF(
                     "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, " .
                     "tst_active.submitted test_finished, matriculation, COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes  FROM usr_data, tst_invited_user " .
                     "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
                     "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
                     "ORDER BY $order",
                     ['integer'],
                     [$this->getTestId()]
                 );
             }
         }
         $result_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $result_array[$row['usr_id']] = $row;
         }
         return $result_array;
     }

Here is the call graph for this function:

◆ getJavaScriptOutput()

ilObjTest::getJavaScriptOutput ( )

Returns if Javascript should be chosen for drag & drop actions for the active user.

Returns: boolean TRUE if Javascript should be chosen, FALSE otherwise public

Definition at line 6229 of file class.ilObjTest.php.

                                          : bool
     {
         return true;
     }

◆ getKioskMode()

ilObjTest::getKioskMode ( )

Definition at line 861 of file class.ilObjTest.php.

References getMainSettings().

                                   : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getKioskModeEnabled();
     }

Here is the call graph for this function:

◆ getListOfQuestions()

ilObjTest::getListOfQuestions ( )

Definition at line 5272 of file class.ilObjTest.php.

References getMainSettings().

                                         : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getQuestionListEnabled();
     }

Here is the call graph for this function:

◆ getListOfQuestionsDescription()

ilObjTest::getListOfQuestionsDescription ( )

Definition at line 5292 of file class.ilObjTest.php.

References getMainSettings().

                                                    : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShowDescriptionInQuestionList();
     }

Here is the call graph for this function:

◆ getListOfQuestionsEnd()

ilObjTest::getListOfQuestionsEnd ( )

Definition at line 5287 of file class.ilObjTest.php.

References getMainSettings().

                                            : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShownQuestionListAtEnd();
     }

Here is the call graph for this function:

◆ getListOfQuestionsSettings()

ilObjTest::getListOfQuestionsSettings ( )

Returns the settings for the list of questions options in the test properties This could contain one of the following values: 0 = No list of questions offered 1 = A list of questions is offered 3 = A list of questions is offered and the list of questions is shown as first page of the test 5 = A list of questions is offered and the list of questions is shown as last page of the test 7 = A list of questions is offered and the list of questions is shown as first and last page of the test.

Returns: integer

Definition at line 5267 of file class.ilObjTest.php.

References getMainSettings().

     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsrPassOverviewMode();
     }

Here is the call graph for this function:

◆ getListOfQuestionsStart()

ilObjTest::getListOfQuestionsStart ( )

Definition at line 5282 of file class.ilObjTest.php.

References getMainSettings().

                                              : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShownQuestionListAtBeginning();
     }

Here is the call graph for this function:

◆ getLocalDIC()

ilObjTest::getLocalDIC ( )

Definition at line 201 of file class.ilObjTest.php.

Referenced by ilTestServiceGUI\setContextResultPresentation().

                                  : TestDIC
     {
         return TestDIC::dic();
     }

Here is the caller graph for this function:

◆ getMailNotification()

ilObjTest::getMailNotification ( )

Definition at line 6485 of file class.ilObjTest.php.

References getMainSettings().

                                          : int
     {
         return $this->getMainSettings()->getFinishingSettings()->getMailNotificationContentType();
     }

Here is the call graph for this function:

◆ getMailNotificationType()

ilObjTest::getMailNotificationType ( )

Definition at line 6561 of file class.ilObjTest.php.

References getMainSettings().

                                              : bool
     {
         return $this->getMainSettings()->getFinishingSettings()->getAlwaysSendMailNotification();
     }

Here is the call graph for this function:

◆ getMainSettings()

ilObjTest::getMainSettings ( )

Definition at line 7308 of file class.ilObjTest.php.

References $main_settings, getMainSettingsRepository(), and getTestId().

Referenced by addDefaults(), applyDefaults(), cloneConcludingRemarks(), cloneIntroduction(), cloneObject(), fromXML(), getAnonymity(), getAnswerFeedbackPoints(), ILIAS\Test\Results\Presentation\Factory\getAttemptResultsSettings(), getAutosave(), getConcludingRemarksPageId(), getEnableExamview(), getEnableProcessingTime(), getEndingTime(), getFinalStatement(), getFixedParticipants(), getGenericAnswerFeedback(), getInstantFeedbackSolution(), getIntroduction(), getIntroductionPageId(), getKioskMode(), getListOfQuestions(), getListOfQuestionsDescription(), getListOfQuestionsEnd(), getListOfQuestionsSettings(), getListOfQuestionsStart(), getMailNotification(), getMailNotificationType(), getNrOfTries(), getPassword(), getProcessingTime(), getProcessingTimeForXML(), getProcessingTimeInSeconds(), getQuestionSetType(), getRedirectionMode(), getRedirectionUrl(), getResetProcessingTime(), getShowCancel(), getShowKioskModeParticipant(), getShowKioskModeTitle(), getShowMarker(), getShuffleQuestions(), getSpecificAnswerFeedback(), getStartingTime(), getTestParticipants(), getTitleOutput(), getUsePreviousAnswers(), getUsrPassOverviewEnabled(), isBlockPassesAfterPassedEnabled(), isEndingTimeEnabled(), isFollowupQuestionAnswerFixationEnabled(), isForceInstantFeedbackEnabled(), isInstantFeedbackAnswerFixationEnabled(), isNextPassAllowed(), isOfferingQuestionHintsEnabled(), isPasswordEnabled(), isPostponingEnabled(), isRedirectModeKiosk(), isRedirectModeNone(), isShowExamIdInTestPassEnabled(), isSkillServiceEnabled(), isSkillServiceToBeConsidered(), isStartingTimeEnabled(), setQuestionSetType(), and toXML().

                                      : MainSettings
     {
         if (!$this->main_settings) {
             $this->main_settings = $this->getMainSettingsRepository()
                 ->getFor($this->getTestId());
         }
         return $this->main_settings;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMainSettingsRepository()

ilObjTest::getMainSettingsRepository ( )

Definition at line 7317 of file class.ilObjTest.php.

References $main_settings_repo.

Referenced by applyDefaults(), cloneObject(), fromXML(), getConcludingRemarksPageId(), getIntroductionPageId(), and getMainSettings().

                                                : MainSettingsRepository
     {
         if (!$this->main_settings_repo) {
             $this->main_settings_repo = new MainSettingsDatabaseRepository($this->db);
         }
         return $this->main_settings_repo;
     }

Here is the caller graph for this function:

◆ getManualFeedback()

static ilObjTest::getManualFeedback	(	int	$active_id,
		int	$question_id,
		?int	$pass
	)

static

Retrieves the feedback comment for a question in a test if it is finalized.

Parameters

integer	$active_id	Active ID of the user
integer	$question_id	Question ID
integer	$pass	Pass number

Returns: string The feedback text public

Definition at line 6077 of file class.ilObjTest.php.

References ilTestService\isManScoringDone(), and null.

Referenced by assQuestionGUI\getGenericFeedbackOutput(), and assClozeTestGUI\getGenericFeedbackOutput().

                                                                                           : string
     {
         if ($pass === null) {
             return '';
         }
         $feedback = '';
         $row = self::getSingleManualFeedback((int) $active_id, (int) $question_id, (int) $pass);
 
         if ($row !== [] && ($row['finalized_evaluation'] || \ilTestService::isManScoringDone((int) $active_id))) {
             $feedback = $row['feedback'] ?? '';
         }
 
         return $feedback;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMarkSchema()

ilObjTest::getMarkSchema ( )

Definition at line 836 of file class.ilObjTest.php.

References $mark_schema, getTestId(), and null.

Referenced by ILIAS\Test\Scoring\Marks\MarkSchemaGUI\__construct(), addDefaults(), applyDefaults(), cloneObject(), evalStatistical(), fromXML(), getAllTestResults(), getTotalPointsPassedArray(), isComplete(), saveToDb(), toXML(), and updateTestResultCache().

                                    : MarkSchema
     {
         if ($this->mark_schema === null) {
             $this->mark_schema = $this->marks_repository->getMarkSchemaFor($this->getTestId());
         }
 
         return $this->mark_schema;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMaxPassOfTest()

ilObjTest::getMaxPassOfTest ( )

Definition at line 6966 of file class.ilObjTest.php.

References $data, $res, and getTestId().

                                       : int
     {
         $query = '
                         SELECT MAX(tst_pass_result.pass) + 1 max_res
                         FROM tst_pass_result
                         INNER JOIN tst_active ON tst_active.active_id = tst_pass_result.active_fi
                         WHERE test_fi = ' . $this->db->quote($this->getTestId(), 'integer') . '
                 ';
         $res = $this->db->query($query);
         $data = $this->db->fetchAssoc($res);
         return (int) $data['max_res'];
     }

Here is the call graph for this function:

◆ getNrOfResultsForPass()

ilObjTest::getNrOfResultsForPass	(	$active_id,
		$pass
	)

Calculates the number of user results for a specific test pass.

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

                                                             : int
     {
         $result = $this->db->queryF(
             "SELECT test_result_id FROM tst_test_result WHERE active_fi = %s AND pass = %s",
             ['integer','integer'],
             [$active_id, $pass]
         );
         return $result->numRows();
     }

◆ getNrOfTries()

ilObjTest::getNrOfTries ( )

Definition at line 851 of file class.ilObjTest.php.

References getMainSettings().

Referenced by hasNrOfTriesRestriction(), isExecutable(), isNrOfTriesReached(), and saveToDb().

                                   : int
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getNumberOfTries();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParticipants()

ilObjTest::getParticipants ( )

Returns all persons who started the test.

Returns: array The active ids, names and logins of the persons who started the test

Definition at line 2289 of file class.ilObjTest.php.

References ANONYMOUS_USER_ID, getAnonymity(), getTestId(), and ILIAS\Repository\lng().

                                      : array
     {
         $result = $this->db->queryF(
             "SELECT tst_active.active_id, usr_data.usr_id, usr_data.firstname, usr_data.lastname, usr_data.title, usr_data.login FROM tst_active LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id WHERE tst_active.test_fi = %s ORDER BY usr_data.lastname ASC",
             ['integer'],
             [$this->getTestId()]
         );
         $persons_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $name = $this->lng->txt("anonymous");
             $fullname = $this->lng->txt("anonymous");
             $login = "";
             if (!$this->getAnonymity()) {
                 if (strlen($row["firstname"] . $row["lastname"] . $row["title"]) == 0) {
                     $name = $this->lng->txt("deleted_user");
                     $fullname = $this->lng->txt("deleted_user");
                     $login = $this->lng->txt("unknown");
                 } else {
                     $login = $row["login"];
                     if ($row["usr_id"] == ANONYMOUS_USER_ID) {
                         $name = $this->lng->txt("anonymous");
                         $fullname = $this->lng->txt("anonymous");
                     } else {
                         $name = trim($row["lastname"] . ", " . $row["firstname"] . " " . $row["title"]);
                         $fullname = trim($row["title"] . " " . $row["firstname"] . " " . $row["lastname"]);
                     }
                 }
             }
             $persons_array[$row["active_id"]] = [
                 "name" => $name,
                 "fullname" => $fullname,
                 "login" => $login
             ];
         }
         return $persons_array;
     }

Here is the call graph for this function:

◆ getParticipantsForTestAndQuestion()

ilObjTest::getParticipantsForTestAndQuestion	(	$test_id,
		$question_id
	)

Creates an associated array with all active id's for a given test and original question id.

PhpAssignmentInConditionInspection

Definition at line 6366 of file class.ilObjTest.php.

References getAccessFilteredParticipantList().

                                                                              : array
     {
         $query = "
                         SELECT tst_test_result.active_fi, tst_test_result.question_fi, tst_test_result.pass
                         FROM tst_test_result
                         INNER JOIN tst_active ON tst_active.active_id = tst_test_result.active_fi AND tst_active.test_fi = %s
                         INNER JOIN qpl_questions ON qpl_questions.question_id = tst_test_result.question_fi
                         LEFT JOIN usr_data ON usr_data.usr_id = tst_active.user_fi
                         WHERE tst_test_result.question_fi = %s
                         ORDER BY usr_data.lastname ASC, usr_data.firstname ASC
                 ";
 
         $result = $this->db->queryF(
             $query,
             ['integer', 'integer'],
             [$test_id, $question_id]
         );
         $foundusers = [];
         while ($row = $this->db->fetchAssoc($result)) {
             if ($this->getAccessFilteredParticipantList() && !$this->getAccessFilteredParticipantList()->isActiveIdInList($row["active_fi"])) {
                 continue;
             }
 
             if (!array_key_exists($row["active_fi"], $foundusers)) {
                 $foundusers[$row["active_fi"]] = [];
             }
             array_push($foundusers[$row["active_fi"]], ["pass" => $row["pass"], "qid" => $row["question_fi"]]);
         }
         return $foundusers;
     }

Here is the call graph for this function:

◆ getPassed()

ilObjTest::getPassed ( $active_id )

Definition at line 6346 of file class.ilObjTest.php.

References _getResultPass(), and getTestResult().

     {
         $result = $this->db->queryF(
             "SELECT passed FROM tst_result_cache WHERE active_fi = %s",
             ['integer'],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $this->db->fetchAssoc($result);
             return $row['passed'];
         } else {
             $counted_pass = ilObjTest::_getResultPass($active_id);
             $result_array = &$this->getTestResult($active_id, $counted_pass);
             return $result_array["test"]["passed"];
         }
     }

Here is the call graph for this function:

◆ getPassScoring()

ilObjTest::getPassScoring ( )

Gets the pass scoring type.

Definition at line 793 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                     : int
     {
         return $this->getScoreSettings()->getScoringSettings()->getPassScoring();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPassword()

ilObjTest::getPassword ( )

Definition at line 997 of file class.ilObjTest.php.

References getMainSettings().

                                  : ?string
     {
         return $this->getMainSettings()->getAccessSettings()->getPassword();
     }

Here is the call graph for this function:

◆ getPotentialRandomTestQuestions()

ilObjTest::getPotentialRandomTestQuestions ( )

Returns: array

Definition at line 5221 of file class.ilObjTest.php.

References getTestId().

                                                      : array
     {
         $query = "
                         SELECT          questions.*,
                                                 questtypes.type_tag,
                                                 origquest.obj_fi orig_obj_fi
 
                         FROM            qpl_questions questions
 
                         INNER JOIN      qpl_qst_type questtypes
                         ON                      questtypes.question_type_id = questions.question_type_fi
 
                         INNER JOIN      tst_rnd_cpy tstquest
                         ON                      tstquest.qst_fi = questions.question_id
 
                         LEFT JOIN       qpl_questions origquest
                         ON                      origquest.question_id = questions.original_id
 
                         WHERE           tstquest.tst_fi = %s
                 ";
 
         $query_result = $this->db->queryF(
             $query,
             ['integer'],
             [$this->getTestId()]
         );
 
         return $this->db->fetchAll($query_result);
     }

Here is the call graph for this function:

◆ getProcessingTime()

ilObjTest::getProcessingTime ( )

Definition at line 906 of file class.ilObjTest.php.

References getMainSettings().

                                        : ?string
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTime();
     }

Here is the call graph for this function:

◆ getProcessingTimeForXML()

ilObjTest::getProcessingTimeForXML ( )

private

Definition at line 911 of file class.ilObjTest.php.

References getMainSettings(), and null.

Referenced by toXML().

                                               : string
     {
         $processing_time = $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTime();
         if ($processing_time === null
             || $processing_time === ''
             || !preg_match('/(\d{2}):(\d{2}):(\d{2})/is', $processing_time, $matches)
         ) {
             return '';
         }
 
         return sprintf(
             "P0Y0M0DT%dH%dM%dS",
             $matches[1],
             $matches[2],
             $matches[3]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getProcessingTimeInSeconds()

ilObjTest::getProcessingTimeInSeconds ( int $active_id = 0 )

Definition at line 929 of file class.ilObjTest.php.

References getExtraTime(), and getMainSettings().

Referenced by isMaxProcessingTimeReached().

                                                                   : int
     {
         $processing_time = $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTime() ?? '';
         if (preg_match("/(\d{2}):(\d{2}):(\d{2})/", (string) $processing_time, $matches)) {
             $extratime = $this->getExtraTime($active_id) * 60;
             return ($matches[1] * 3600) + ($matches[2] * 60) + $matches[3] + $extratime;
         } else {
             return 0;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionCount()

ilObjTest::getQuestionCount ( )

Definition at line 4197 of file class.ilObjTest.php.

References isRandomTest(), ILIAS\Repository\lng(), loadQuestions(), and ILIAS\Repository\logger().

Referenced by getQuestionCountWithoutReloading(), getQuestionsOfPass(), and getQuestionsOfTest().

                                       : int
     {
         $num = 0;
 
         if ($this->isRandomTest()) {
             $questionSetConfig = new ilTestRandomQuestionSetConfig(
                 $this->tree,
                 $this->db,
                 $this->lng,
                 $this->logger,
                 $this->component_repository,
                 $this,
                 $this->questionrepository
             );
 
             $questionSetConfig->loadFromDb();
 
             if ($questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
                 $sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList(
                     $this->db,
                     $this,
                     new ilTestRandomQuestionSetSourcePoolDefinitionFactory($this->db, $this)
                 );
 
                 $sourcePoolDefinitionList->loadDefinitions();
 
                 if (is_int($sourcePoolDefinitionList->getQuestionAmount())) {
                     $num = $sourcePoolDefinitionList->getQuestionAmount();
                 }
             } elseif (is_int($questionSetConfig->getQuestionAmountPerTest())) {
                 $num = $questionSetConfig->getQuestionAmountPerTest();
             }
         } else {
             $this->loadQuestions();
             $num = count($this->questions);
         }
 
         return $num;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionCountAndPointsForPassOfParticipant()

ilObjTest::getQuestionCountAndPointsForPassOfParticipant	(	int	$active_id,
		int	$pass
	)

Definition at line 2483 of file class.ilObjTest.php.

References $res, lookupQuestionSetTypeByActiveId(), QUESTION_SET_TYPE_FIXED, and QUESTION_SET_TYPE_RANDOM.

Referenced by updateTestPassResults().

                                                                                             : array
     {
         $question_set_type = $this->lookupQuestionSetTypeByActiveId($active_id);
 
         switch ($question_set_type) {
             case ilObjTest::QUESTION_SET_TYPE_RANDOM:
                 $res = $this->db->queryF(
                     "
                                                 SELECT          tst_test_rnd_qst.pass,
                                                                         COUNT(tst_test_rnd_qst.question_fi) qcount,
                                                                         SUM(qpl_questions.points) qsum
 
                                                 FROM            tst_test_rnd_qst,
                                                                         qpl_questions
 
                                                 WHERE           tst_test_rnd_qst.question_fi = qpl_questions.question_id
                                                 AND                     tst_test_rnd_qst.active_fi = %s
                                                 AND                     pass = %s
 
                                                 GROUP BY        tst_test_rnd_qst.active_fi,
                                                                         tst_test_rnd_qst.pass
                                         ",
                     ['integer', 'integer'],
                     [$active_id, $pass]
                 );
                 break;
 
             case ilObjTest::QUESTION_SET_TYPE_FIXED:
                 $res = $this->db->queryF(
                     "
                                                 SELECT          COUNT(tst_test_question.question_fi) qcount,
                                                                         SUM(qpl_questions.points) qsum
 
                                                 FROM            tst_test_question,
                                                                         qpl_questions,
                                                                         tst_active
 
                                                 WHERE           tst_test_question.question_fi = qpl_questions.question_id
                                                 AND                     tst_test_question.test_fi = tst_active.test_fi
                                                 AND                     tst_active.active_id = %s
 
                                                 GROUP BY        tst_test_question.test_fi
                                         ",
                     ['integer'],
                     [$active_id]
                 );
                 break;
 
             default:
                 throw new ilTestException("not supported question set type: $question_set_type");
         }
 
         $row = $this->db->fetchAssoc($res);
 
         if (is_array($row)) {
             return ["count" => $row["qcount"], "points" => $row["qsum"]];
         }
 
         return ["count" => 0, "points" => 0];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionCountWithoutReloading()

ilObjTest::getQuestionCountWithoutReloading ( )

Definition at line 4237 of file class.ilObjTest.php.

References getQuestionCount(), and isRandomTest().

                                                       : int
     {
         if ($this->isRandomTest()) {
             return $this->getQuestionCount();
         }
         return count($this->questions);
     }

Here is the call graph for this function:

◆ getQuestionDataset()

ilObjTest::getQuestionDataset ( $question_id )

Returns the dataset for a given question id.

Parameters

integer $question_id The database id of the question

Returns: object Question dataset public

See also: $questions

Definition at line 1507 of file class.ilObjTest.php.

Referenced by ilTestArchiver\handInParticipantUploadedResults().

                                                     : object
     {
         $result = $this->db->queryF(
             "SELECT qpl_questions.*, qpl_qst_type.type_tag FROM qpl_questions, qpl_qst_type WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
             ['integer'],
             [$question_id]
         );
         $row = $this->db->fetchObject($result);
         return $row;
     }

Here is the caller graph for this function:

◆ getQuestions()

ilObjTest::getQuestions ( )

Definition at line 6679 of file class.ilObjTest.php.

References $questions.

                                   : array
     {
         return $this->questions;
     }

◆ getQuestionSetConfig()

ilObjTest::getQuestionSetConfig ( )

Definition at line 216 of file class.ilObjTest.php.

Referenced by ILIAS\Test\Questions\Properties\DatabaseRepository\buildQuestionPropertiesForRandomTest().

                                           : ilTestQuestionSetConfig
     {
         return $this->question_set_config_factory->getQuestionSetConfig();
     }

Here is the caller graph for this function:

◆ getQuestionSetType()

ilObjTest::getQuestionSetType ( )

Definition at line 7034 of file class.ilObjTest.php.

References getMainSettings().

Referenced by getQuestionTitles(), getQuestionTitlesAndIndexes(), isFixedTest(), isRandomTest(), and saveToDb().

                                         : string
     {
         return $this->getMainSettings()->getGeneralSettings()->getQuestionSetType();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionSetTypeTranslation()

ilObjTest::getQuestionSetTypeTranslation	(	ilLanguage	$lng,
			$questionSetType
	)

Definition at line 7059 of file class.ilObjTest.php.

References QUESTION_SET_TYPE_FIXED, QUESTION_SET_TYPE_RANDOM, and ilLanguage\txt().

                                                                                     : string
     {
         switch ($questionSetType) {
             case ilObjTest::QUESTION_SET_TYPE_FIXED:
                 return $lng->txt('tst_question_set_type_fixed');
 
             case ilObjTest::QUESTION_SET_TYPE_RANDOM:
                 return $lng->txt('tst_question_set_type_random');
         }
 
         throw new ilTestException('invalid question set type value given: ' . $questionSetType);
     }

Here is the call graph for this function:

◆ getQuestionsOfPass()

ilObjTest::getQuestionsOfPass	(	int	$active_id,
		int	$pass
	)

Definition at line 2423 of file class.ilObjTest.php.

References getQuestionCount(), and isRandomTest().

Referenced by ilTestArchiver\handInParticipantUploadedResults().

                                                                  : array
     {
         if ($this->isRandomTest()) {
             $this->db->setLimit($this->getQuestionCount(), 0);
             $result = $this->db->queryF(
                 'SELECT tst_test_rnd_qst.sequence, tst_test_rnd_qst.question_fi, '
                 . 'qpl_questions.points '
                 . 'FROM tst_test_rnd_qst, qpl_questions '
                 . 'WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id '
                 . 'AND tst_test_rnd_qst.active_fi = %s AND tst_test_rnd_qst.pass = %s '
                 . 'ORDER BY tst_test_rnd_qst.sequence',
                 ['integer', 'integer'],
                 [$active_id, $pass]
             );
         } else {
             $result = $this->db->queryF(
                 'SELECT tst_test_question.sequence, tst_test_question.question_fi, '
                 . 'qpl_questions.points '
                 . 'FROM tst_test_question, tst_active, qpl_questions '
                 . 'WHERE tst_test_question.question_fi = qpl_questions.question_id '
                 . 'AND tst_active.active_id = %s AND tst_active.test_fi = tst_test_question.test_fi',
                 ['integer'],
                 [$active_id]
             );
         }
         $qpass = [];
         if ($result->numRows()) {
             while ($row = $this->db->fetchAssoc($result)) {
                 array_push($qpass, $row);
             }
         }
         return $qpass;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionsOfTest()

ilObjTest::getQuestionsOfTest ( int $active_id )

Definition at line 2390 of file class.ilObjTest.php.

References getQuestionCount(), and isRandomTest().

                                                       : array
     {
         if ($this->isRandomTest()) {
             $this->db->setLimit($this->getQuestionCount(), 0);
             $result = $this->db->queryF(
                 'SELECT tst_test_rnd_qst.sequence, tst_test_rnd_qst.question_fi, '
                 . 'tst_test_rnd_qst.pass, qpl_questions.points '
                 . 'FROM tst_test_rnd_qst, qpl_questions '
                 . 'WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id '
                 . 'AND tst_test_rnd_qst.active_fi = %s ORDER BY tst_test_rnd_qst.sequence',
                 ['integer'],
                 [$active_id]
             );
         } else {
             $result = $this->db->queryF(
                 'SELECT tst_test_question.sequence, tst_test_question.question_fi, '
                 . 'qpl_questions.points '
                 . 'FROM tst_test_question, tst_active, qpl_questions '
                 . 'WHERE tst_test_question.question_fi = qpl_questions.question_id '
                 . 'AND tst_active.active_id = %s AND tst_active.test_fi = tst_test_question.test_fi',
                 ['integer'],
                 [$active_id]
             );
         }
         $qtest = [];
         if ($result->numRows()) {
             while ($row = $this->db->fetchAssoc($result)) {
                 array_push($qtest, $row);
             }
         }
         return $qtest;
     }

Here is the call graph for this function:

◆ getQuestiontext()

ilObjTest::getQuestiontext ( $question_id )

Returns the question text for a given question.

Parameters

integer $question_id The question id

Returns: string The question text public

Definition at line 4354 of file class.ilObjTest.php.

References $res.

                                                  : string
     {
         $res = "";
         if ($question_id) {
             $result = $this->db->queryF(
                 "SELECT question_text FROM qpl_questions WHERE question_id = %s",
                 ['integer'],
                 [$question_id]
             );
             if ($result->numRows() == 1) {
                 $row = $this->db->fetchAssoc($result);
                 $res = $row["question_text"];
             }
         }
         return $res;
     }

◆ getQuestionTitle()

ilObjTest::getQuestionTitle	(	$title,
		$nr = `null`,
		$points = `null`
	)

Returns the title of a test question and checks if the title output is allowed.

If not, the localized text "question" will be returned.

Parameters

string	$title	The original title of the question
integer	$nr	The number of the question in the sequence

Returns: string The title for the question title output public

Definition at line 1465 of file class.ilObjTest.php.

References ilObject\$title, $txt, getTitleOutput(), and ILIAS\Repository\lng().

                                                                         : string
     {
         switch ($this->getTitleOutput()) {
             case '0':
             case '1':
                 return $title;
                 break;
             case '2':
                 if (isset($nr)) {
                     return $this->lng->txt("ass_question") . ' ' . $nr;
                 }
                 return $this->lng->txt("ass_question");
                 break;
             case 3:
                 if (isset($nr)) {
                     $txt = $this->lng->txt("ass_question") . ' ' . $nr;
                 } else {
                     $txt = $this->lng->txt("ass_question");
                 }
                 if ($points != '') {
                     $lngv = $this->lng->txt('points');
                     if ($points == 1) {
                         $lngv = $this->lng->txt('point');
                     }
                     $txt .= ' - ' . $points . ' ' . $lngv;
                 }
                 return $txt;
                 break;
 
         }
         return $this->lng->txt("ass_question");
     }

Here is the call graph for this function:

◆ getQuestionTitles()

ilObjTest::getQuestionTitles ( )

private

Definition at line 1411 of file class.ilObjTest.php.

References getQuestionSetType(), and getTestId().

Referenced by copyQuestions().

                                         : array
     {
         $titles = [];
         if ($this->getQuestionSetType() === self::QUESTION_SET_TYPE_FIXED) {
             $result = $this->db->queryF(
                 'SELECT qpl_questions.title FROM tst_test_question, qpl_questions '
                 . 'WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id '
                 . 'ORDER BY tst_test_question.sequence',
                 ['integer'],
                 [$this->getTestId()]
             );
             while ($row = $this->db->fetchAssoc($result)) {
                 array_push($titles, $row['title']);
             }
         }
         return $titles;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionTitlesAndIndexes()

ilObjTest::getQuestionTitlesAndIndexes ( )

Returns the titles of the test questions in question sequence.

Returns: array The question titles public

See also: $questions

Definition at line 1436 of file class.ilObjTest.php.

References getQuestionSetType(), and getTestId().

Referenced by hasQuestionsWithoutQuestionpool().

                                                  : array
     {
         $titles = [];
         if ($this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED) {
             $result = $this->db->queryF(
                 'SELECT qpl_questions.title, qpl_questions.question_id '
                 . 'FROM tst_test_question, qpl_questions '
                 . 'WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id '
                 . 'ORDER BY tst_test_question.sequence',
                 ['integer'],
                 [$this->getTestId()]
             );
             while ($row = $this->db->fetchAssoc($result)) {
                 $titles[$row['question_id']] = $row["title"];
             }
         }
         return $titles;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionType()

ilObjTest::getQuestionType ( $question_id )

Returns the question type of a question with a given id.

Parameters

integer $question_id The database id of the question

Returns: string The question type string private

Definition at line 1561 of file class.ilObjTest.php.

References $data.

Referenced by createQuestionGUI().

     {
         if ($question_id < 1) {
             return -1;
         }
         $result = $this->db->queryF(
             "SELECT type_tag FROM qpl_questions, qpl_qst_type WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
             ['integer'],
             [$question_id]
         );
         if ($result->numRows() == 1) {
             $data = $this->db->fetchObject($result);
             return $data->type_tag;
         } else {
             return "";
         }
     }

Here is the caller graph for this function:

◆ getRedirectionMode()

ilObjTest::getRedirectionMode ( )

Definition at line 972 of file class.ilObjTest.php.

References getMainSettings().

                                         : int
     {
         return $this->getMainSettings()->getFinishingSettings()->getRedirectionMode();
     }

Here is the call graph for this function:

◆ getRedirectionUrl()

ilObjTest::getRedirectionUrl ( )

Definition at line 987 of file class.ilObjTest.php.

References getMainSettings().

                                        : string
     {
         return $this->getMainSettings()->getFinishingSettings()->getRedirectionUrl() ?? '';
     }

Here is the call graph for this function:

◆ getResetProcessingTime()

ilObjTest::getResetProcessingTime ( )

Definition at line 945 of file class.ilObjTest.php.

References getMainSettings().

Referenced by getStartingTimeOfUser().

                                             : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getResetProcessingTime();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getResultsForActiveId()

ilObjTest::getResultsForActiveId ( int $active_id )

Definition at line 6526 of file class.ilObjTest.php.

References updateTestResultCache().

Referenced by ilTestArchiver\getResultsOfUserOutput(), and getTestResult().

                                                          : array
     {
         $query = "
                         SELECT          *
                         FROM            tst_result_cache
                         WHERE           active_fi = %s
                 ";
 
         $result = $this->db->queryF(
             $query,
             ['integer'],
             [$active_id]
         );
 
         if (!$result->numRows()) {
             $this->updateTestResultCache($active_id);
 
             $query = "
                                 SELECT          *
                                 FROM            tst_result_cache
                                 WHERE           active_fi = %s
                         ";
 
             $result = $this->db->queryF(
                 $query,
                 ['integer'],
                 [$active_id]
             );
         }
 
         $row = $this->db->fetchAssoc($result);
 
         return $row;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRoleData()

ilObjTest::getRoleData ( $ids )

Definition at line 4574 of file class.ilObjTest.php.

References ilObject\_lookupDescription(), and ilObject\_lookupTitle().

                                      : array
     {
         if (!is_array($ids) || count($ids) == 0) {
             return [];
         }
         $result = [];
         foreach ($ids as $obj_id) {
             $result[$obj_id] = ["obj_id" => $obj_id, "title" => ilObject::_lookupTitle($obj_id), "description" => ilObject::_lookupDescription($obj_id)];
         }
         return $result;
     }

Here is the call graph for this function:

◆ getScoreCutting()

ilObjTest::getScoreCutting ( )

Determines if the score of a question should be cut at 0 points or the score of the whole test.

Definition at line 785 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by getTestResult(), and toXML().

                                      : int
     {
         return $this->getScoreSettings()->getScoringSettings()->getScoreCutting();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getScoreSettings()

ilObjTest::getScoreSettings ( )

Definition at line 7325 of file class.ilObjTest.php.

References $score_settings, getScoreSettingsRepository(), and getTestId().

Referenced by addDefaults(), applyDefaults(), cloneObject(), fromXML(), ILIAS\Test\Results\Presentation\Factory\getAttemptResultsSettings(), getCountSystem(), getExportSettings(), getHighscoreAchievedTS(), getHighscoreAnon(), getHighscoreEnabled(), getHighscoreHints(), getHighscoreMode(), getHighscoreOwnTable(), getHighscorePercentage(), getHighscoreScore(), getHighscoreTopNum(), getHighscoreTopTable(), getHighscoreWTime(), getPassScoring(), getScoreCutting(), getShowPassDetails(), getShowSolutionAnswersOnly(), getShowSolutionFeedback(), getShowSolutionListComparison(), getShowSolutionListOwnAnswers(), getShowSolutionPrintview(), getShowSolutionSignature(), getShowSolutionSuggested(), isPassDeletionAllowed(), isScoreReportingEnabled(), isShowExamIdInTestResultsEnabled(), isShowGradingMarkEnabled(), isShowGradingStatusEnabled(), marksEditable(), and toXML().

                                       : ScoreSettings
     {
         if (!$this->score_settings) {
             $this->score_settings = $this->getScoreSettingsRepository()
                 ->getFor($this->getTestId());
         }
         return $this->score_settings;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getScoreSettingsRepository()

ilObjTest::getScoreSettingsRepository ( )

Definition at line 7334 of file class.ilObjTest.php.

References $score_settings_repo.

Referenced by applyDefaults(), cloneObject(), fromXML(), and getScoreSettings().

                                                 : ScoreSettingsRepository
     {
         if (!$this->score_settings_repo) {
             $this->score_settings_repo = new ScoreSettingsDatabaseRepository($this->db);
         }
         return $this->score_settings_repo;
     }

Here is the caller graph for this function:

◆ getShowCancel()

ilObjTest::getShowCancel ( )

Definition at line 5564 of file class.ilObjTest.php.

References getMainSettings().

                                    : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getSuspendTestAllowed();
     }

Here is the call graph for this function:

◆ getShowKioskModeParticipant()

ilObjTest::getShowKioskModeParticipant ( )

Definition at line 870 of file class.ilObjTest.php.

References getMainSettings().

                                                  : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getShowParticipantNameInKioskMode();
     }

Here is the call graph for this function:

◆ getShowKioskModeTitle()

ilObjTest::getShowKioskModeTitle ( )

Definition at line 866 of file class.ilObjTest.php.

References getMainSettings().

                                            : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getShowTitleInKioskMode();
     }

Here is the call graph for this function:

◆ getShowMarker()

ilObjTest::getShowMarker ( )

Definition at line 5569 of file class.ilObjTest.php.

References getMainSettings().

                                    : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getQuestionMarkingEnabled();
     }

Here is the call graph for this function:

◆ getShowPassDetails()

ilObjTest::getShowPassDetails ( )

Returns if the pass details should be shown when a test is not finished.

Definition at line 5300 of file class.ilObjTest.php.

References getScoreSettings().

                                         : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowPassDetails();
     }

Here is the call graph for this function:

◆ getShowSolutionAnswersOnly()

ilObjTest::getShowSolutionAnswersOnly ( )

Returns if the full solution (including ILIAS content) should be presented to the solution or not.

Definition at line 5331 of file class.ilObjTest.php.

References getScoreSettings().

                                                 : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionAnswersOnly();
     }

Here is the call graph for this function:

◆ getShowSolutionFeedback()

ilObjTest::getShowSolutionFeedback ( )

Returns if the feedback should be presented to the solution or not.

Definition at line 5323 of file class.ilObjTest.php.

References getScoreSettings().

                                              : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionFeedback();
     }

Here is the call graph for this function:

◆ getShowSolutionListComparison()

ilObjTest::getShowSolutionListComparison ( )

Returns: boolean TRUE if the results should be compared with the correct results in the list of answers, FALSE otherwise public

Definition at line 5356 of file class.ilObjTest.php.

References getScoreSettings().

                                                    : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionListComparison();
     }

Here is the call graph for this function:

◆ getShowSolutionListOwnAnswers()

ilObjTest::getShowSolutionListOwnAnswers ( )

Definition at line 5361 of file class.ilObjTest.php.

References getScoreSettings().

                                                    : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionListOwnAnswers();
     }

Here is the call graph for this function:

◆ getShowSolutionPrintview()

ilObjTest::getShowSolutionPrintview ( )

Returns if the solution printview should be presented to the user or not.

Definition at line 5308 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by canShowSolutionPrintview().

                                               : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionPrintview();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getShowSolutionSignature()

ilObjTest::getShowSolutionSignature ( )

Returns if the signature field should be shown in the test results.

Definition at line 5339 of file class.ilObjTest.php.

References getScoreSettings().

                                               : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionSignature();
     }

Here is the call graph for this function:

◆ getShowSolutionSuggested()

ilObjTest::getShowSolutionSuggested ( )

Returns: boolean TRUE if the suggested solutions should be shown, FALSE otherwise

Definition at line 5347 of file class.ilObjTest.php.

References getScoreSettings().

                                               : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowSolutionSuggested();
     }

Here is the call graph for this function:

◆ getShuffleQuestions()

ilObjTest::getShuffleQuestions ( )

Definition at line 5251 of file class.ilObjTest.php.

References getMainSettings().

Referenced by adjustTestSequence().

                                          : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getShuffleQuestions();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSingleManualFeedback()

static ilObjTest::getSingleManualFeedback	(	int	$active_id,
		int	$question_id,
		int	$pass
	)

static

Definition at line 6092 of file class.ilObjTest.php.

References $DIC, $ilDB, and ilRTE\_replaceMediaObjectImageSrc().

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByQuestionGUI\buildForm(), ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\buildManScoringParticipantForm(), and ILIAS\Test\Scoring\Manual\TestScoringByQuestionGUI\saveManScoringByQuestion().

                                                                                                : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $row = [];
         $result = $ilDB->queryF(
             "SELECT * FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s",
             ['integer', 'integer', 'integer'],
             [$active_id, $question_id, $pass]
         );
 
         if ($ilDB->numRows($result) === 1) {
             $row = $ilDB->fetchAssoc($result);
             $row['feedback'] = ilRTE::_replaceMediaObjectImageSrc($row['feedback'] ?? '', 1);
         } elseif ($ilDB->numRows($result) > 1) {
             $DIC->logger()->root()->warning(
                 "WARNING: Multiple feedback entries on tst_manual_fb for " .
                 "active_fi = $active_id , question_fi = $question_id and pass = $pass"
             );
         }
 
         return $row;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedback()

ilObjTest::getSpecificAnswerFeedback ( )

Definition at line 6882 of file class.ilObjTest.php.

References getMainSettings().

                                                : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled();
     }

Here is the call graph for this function:

◆ getStartingTime()

ilObjTest::getStartingTime ( )

Definition at line 955 of file class.ilObjTest.php.

References getMainSettings(), and null.

Referenced by isExecutable(), startingTimeReached(), and toXML().

                                      : int
     {
         $start_time = $this->getMainSettings()->getAccessSettings()->getStartTime();
         return $start_time !== null ? $start_time->getTimestamp() : 0;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getStartingTimeOfParticipants()

ilObjTest::getStartingTimeOfParticipants ( )

Note, this function should only be used if absolutely necessary, since it perform joins on tables that tend to grow huge and returns vast amount of data.

If possible, use getStartingTimeOfUser($active_id) instead

Returns: array

Definition at line 6928 of file class.ilObjTest.php.

References getTestId().

                                                    : array
     {
         $times = [];
         $result = $this->db->queryF(
             "SELECT tst_times.active_fi, tst_times.started FROM tst_times, tst_active WHERE tst_times.active_fi = tst_active.active_id AND tst_active.test_fi = %s ORDER BY tst_times.tstamp DESC",
             ['integer'],
             [$this->getTestId()]
         );
         while ($row = $this->db->fetchAssoc($result)) {
             $times[$row['active_fi']] = $row['started'];
         }
         return $times;
     }

Here is the call graph for this function:

◆ getStartingTimeOfUser()

ilObjTest::getStartingTimeOfUser	(	$active_id,
		$pass = `null`
	)

Returns the unix timestamp of the time a user started a test.

Parameters

integer $active_id The active id of the user

Returns: false|int The unix timestamp if the user started the test, FALSE otherwise public

Definition at line 5085 of file class.ilObjTest.php.

References getResetProcessingTime(), and null.

Referenced by isExecutable().

     {
         if ($active_id < 1) {
             return false;
         }
         if ($pass === null) {
             $pass = ($this->getResetProcessingTime()) ? self::_getPass($active_id) : 0;
         }
         $result = $this->db->queryF(
             "SELECT tst_times.started FROM tst_times WHERE tst_times.active_fi = %s AND tst_times.pass = %s ORDER BY tst_times.started",
             ['integer', 'integer'],
             [$active_id, $pass]
         );
         if ($result->numRows()) {
             $row = $this->db->fetchAssoc($result);
             if (preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches)) {
                 return mktime(
                     (int) $matches[4],
                     (int) $matches[5],
                     (int) $matches[6],
                     (int) $matches[2],
                     (int) $matches[3],
                     (int) $matches[1]
                 );
             } else {
                 return time();
             }
         } else {
             return time();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTemplate()

ilObjTest::getTemplate ( )

Definition at line 6576 of file class.ilObjTest.php.

References $template_id.

Referenced by cloneObject(), and saveToDb().

                                  : int
     {
         return $this->template_id;
     }

Here is the caller graph for this function:

◆ getTestDefaults()

ilObjTest::getTestDefaults ( $test_defaults_id )

Definition at line 5644 of file class.ilObjTest.php.

References null.

                                                       : ?array
     {
         $result = $this->db->queryF(
             "SELECT * FROM tst_test_defaults WHERE test_defaults_id = %s",
             ['integer'],
             [$test_defaults_id]
         );
         if ($result->numRows() == 1) {
             $row = $this->db->fetchAssoc($result);
             return $row;
         } else {
             return null;
         }
     }

◆ getTestId()

ilObjTest::getTestId ( )

Gets the database id of the additional test data.

Definition at line 731 of file class.ilObjTest.php.

References $test_id.

Referenced by adjustTestSequence(), ILIAS\Test\Questions\Properties\DatabaseRepository\buildQuestionPropertiesForRandomTest(), cloneObject(), ilTestRandomQuestionSetConfig\cloneQuestionSetRelatedData(), ilTestArchiver\createUserResultsForArchive(), deleteTest(), evalTotalParticipantsArray(), evalTotalPersons(), evalTotalPersonsArray(), evalTotalStartedAverageTime(), getActiveIdOfUser(), getCompleteWorkingTime(), getCompleteWorkingTimeOfParticipant(), getCompleteWorkingTimeOfParticipants(), getExistingQuestions(), getExtraTime(), getInvitedUsers(), getMainSettings(), getMarkSchema(), getMaxPassOfTest(), getParticipants(), getPotentialRandomTestQuestions(), getQuestionTitles(), getQuestionTitlesAndIndexes(), getScoreSettings(), getStartingTimeOfParticipants(), getTestParticipants(), getTestQuestions(), getTimeExtensionsOfParticipants(), ilTestImporter\importSkillLevelThresholds(), insertQuestion(), inviteUser(), isActiveTestSubmitted(), questionMoveDown(), questionMoveUp(), removeTestResults(), removeTestResultsByActiveIds(), removeTestResultsByUserIds(), removeTestResultsFromSoapLpAdministration(), saveCompleteStatus(), saveQuestionsToDb(), saveToDb(), and toXML().

                                : int
     {
         return $this->test_id;
     }

Here is the caller graph for this function:

◆ getTestLogger()

ilObjTest::getTestLogger ( )

Definition at line 206 of file class.ilObjTest.php.

References $logger.

                                    : TestLogger
     {
         return $this->logger;
     }

◆ getTestLogViewer()

ilObjTest::getTestLogViewer ( )

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

References $log_viewer.

                                       : TestLogViewer
     {
         return $this->log_viewer;
     }

◆ getTestObjIdsWithActiveForUserId()

static ilObjTest::getTestObjIdsWithActiveForUserId ( $userId )

static

Definition at line 7089 of file class.ilObjTest.php.

References $DIC, $ilDB, $res, and ILIAS\Repository\int().

                                                                     : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $query = "
                         SELECT obj_fi
                         FROM tst_active
                         INNER JOIN tst_tests
                         ON test_id = test_fi
                         WHERE user_fi = %s
                 ";
 
         $res = $ilDB->queryF($query, ['integer'], [$userId]);
 
         $objIds = [];
 
         while ($row = $ilDB->fetchAssoc($res)) {
             $objIds[] = (int) $row['obj_fi'];
         }
 
         return $objIds;
     }

Here is the call graph for this function:

◆ getTestParticipants()

ilObjTest::getTestParticipants ( )

Definition at line 4441 of file class.ilObjTest.php.

References $data, getAnonymity(), getGeneralSettings(), getMainSettings(), getTestId(), and ILIAS\Repository\lng().

Referenced by buildStatisticsAccessFilteredParticipantList(), getActiveParticipantList(), and getTestParticipantsForManualScoring().

                                          : array
     {
         if ($this->getMainSettings()->getGeneralSettings()->getAnonymity()) {
             $query = "
                                 SELECT  tst_active.active_id,
                                                 tst_active.tries,
                                                 tst_active.user_fi usr_id,
                                                 %s login,
                                                 %s lastname,
                                                 %s firstname,
                                                 tst_active.submitted test_finished,
                                                 usr_data.matriculation,
                                                 usr_data.active,
                                                 tst_active.lastindex,
                                                 COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes
                                 FROM tst_active
                                 LEFT JOIN usr_data
                                 ON tst_active.user_fi = usr_data.usr_id
                                 WHERE tst_active.test_fi = %s
                                 ORDER BY usr_data.lastname
                         ";
             $result = $this->db->queryF(
                 $query,
                 ['text', 'text', 'text', 'integer'],
                 ['', $this->lng->txt("anonymous"), "", $this->getTestId()]
             );
         } else {
             $query = "
                                 SELECT  tst_active.active_id,
                                                 tst_active.tries,
                                                 tst_active.user_fi usr_id,
                                                 usr_data.login,
                                                 usr_data.lastname,
                                                 usr_data.firstname,
                                                 tst_active.submitted test_finished,
                                                 usr_data.matriculation,
                                                 usr_data.active,
                                                 tst_active.lastindex,
                                                 COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes
                                 FROM tst_active
                                 LEFT JOIN usr_data
                                 ON tst_active.user_fi = usr_data.usr_id
                                 WHERE tst_active.test_fi = %s
                                 ORDER BY usr_data.lastname
                         ";
             $result = $this->db->queryF(
                 $query,
                 ['integer'],
                 [$this->getTestId()]
             );
         }
         $data = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $data[$row['active_id']] = $row;
         }
         foreach ($data as $index => $participant) {
             if (strlen(trim($participant["firstname"] . $participant["lastname"])) == 0) {
                 $data[$index]["lastname"] = $this->lng->txt("deleted_user");
             }
         }
         return $data;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTestParticipantsForManualScoring()

ilObjTest::getTestParticipantsForManualScoring ( $filter = null )

Definition at line 4504 of file class.ilObjTest.php.

References getGlobalSettings(), and getTestParticipants().

                                                                        : array
     {
         if (!$this->getGlobalSettings()->isManualScoringEnabled()) {
             return [];
         }
 
         $filtered_participants = [];
         foreach ($this->getTestParticipants() as $active_id => $participant) {
             if ($participant['tries'] > 0) {
                 switch ($filter) {
                     case 4:
                         if ($this->test_man_scoring_done_helper->isDone((int) $active_id)) {
                             $filtered_participants[$active_id] = $participant;
                         }
                         break;
                     case 5:
                         if (!$this->test_man_scoring_done_helper->isDone((int) $active_id)) {
                             $filtered_participants[$active_id] = $participant;
                         }
                         break;
                     default:
                         $filtered_participants[$active_id] = $participant;
                 }
             }
         }
         return $filtered_participants;
     }

Here is the call graph for this function:

◆ getTestQuestions()

ilObjTest::getTestQuestions ( )

Definition at line 5138 of file class.ilObjTest.php.

References $questions, getTestId(), null, and ILIAS\Repository\refinery().

Referenced by getFixedQuestionSetTotalPoints(), ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getRowIds(), isTestQuestion(), and removeQuestionWithResults().

                                       : array
     {
         $tags_trafo = $this->refinery->string()->stripTags();
 
         $query = "
                         SELECT          questions.*,
                                                 questtypes.type_tag,
                                                 tstquest.sequence,
                                                 origquest.obj_fi orig_obj_fi
 
                         FROM            qpl_questions questions
 
                         INNER JOIN      qpl_qst_type questtypes
                         ON                      questtypes.question_type_id = questions.question_type_fi
 
                         INNER JOIN      tst_test_question tstquest
                         ON                      tstquest.question_fi = questions.question_id
 
                         LEFT JOIN       qpl_questions origquest
                         ON                      origquest.question_id = questions.original_id
 
                         WHERE           tstquest.test_fi = %s
 
                         ORDER BY        tstquest.sequence
                 ";
 
         $query_result = $this->db->queryF(
             $query,
             ['integer'],
             [$this->getTestId()]
         );
 
         $questions = [];
 
         while ($row = $this->db->fetchAssoc($query_result)) {
             $row['title'] = $tags_trafo->transform($row['title']);
             $row['description'] = $tags_trafo->transform($row['description'] !== '' && $row['description'] !== null ? $row['description'] : '&nbsp;');
             $row['author'] = $tags_trafo->transform($row['author']);
 
             $questions[] = $row;
         }
 
         return $questions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTestResult()

ilObjTest::getTestResult	(	int	$active_id,
		?int	$pass = `null`,
		bool	$ordered_sequence = `false`,
		bool	$consider_hidden_questions = `true`,
		bool	$consider_optional_questions = `true`
	)

Calculates the results of a test for a given user and returns an array with all test results.

Returns: array An array containing the test results for the given user

Definition at line 1788 of file class.ilObjTest.php.

References $data, $results, $test_sequence, assQuestion\_getSuggestedSolutionOutput(), getResultsForActiveId(), getScoreCutting(), ILIAS\Repository\int(), null, and ilLegacyFormElementsUtil\prepareFormOutput().

Referenced by ILIAS\Test\Results\Data\Factory\buildAttemptResults(), evalStatistical(), getPassed(), ilTestArchiver\getResultsOfUserOutput(), and getTotalPointsPassedArray().

      : array {
         $results = $this->getResultsForActiveId($active_id);
 
         if ($pass === null) {
             $pass = (int) $results['pass'];
         }
 
         $test_sequence_factory = new ilTestSequenceFactory($this, $this->db, $this->questionrepository);
         $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $pass);
 
         $test_sequence->setConsiderHiddenQuestionsEnabled($consider_hidden_questions);
         $test_sequence->setConsiderOptionalQuestionsEnabled($consider_optional_questions);
 
         $test_sequence->loadFromDb();
         $test_sequence->loadQuestions();
 
         if ($ordered_sequence) {
             $sequence = $test_sequence->getOrderedSequenceQuestions();
         } else {
             $sequence = $test_sequence->getUserSequenceQuestions();
         }
 
         $arr_results = [];
 
         $query = "
             SELECT
                 tst_test_result.question_fi,
                 tst_test_result.points reached,
                 tst_test_result.hint_count requested_hints,
                 tst_test_result.hint_points hint_points,
                 tst_test_result.answered answered,
                 tst_manual_fb.finalized_evaluation finalized_evaluation
 
             FROM tst_test_result
 
             LEFT JOIN tst_solutions
             ON tst_solutions.active_fi = tst_test_result.active_fi
             AND tst_solutions.question_fi = tst_test_result.question_fi
 
             LEFT JOIN tst_manual_fb
             ON tst_test_result.active_fi = tst_manual_fb.active_fi
             AND tst_test_result.question_fi = tst_manual_fb.question_fi
 
             WHERE tst_test_result.active_fi = %s
             AND tst_test_result.pass = %s
         ";
 
         $solutionresult = $this->db->queryF(
             $query,
             ['integer', 'integer'],
             [$active_id, $pass]
         );
 
         while ($row = $this->db->fetchAssoc($solutionresult)) {
             $arr_results[ $row['question_fi'] ] = $row;
         }
 
         $num_worked_through = count($arr_results);
 
         $IN_question_ids = $this->db->in('qpl_questions.question_id', $sequence, false, 'integer');
 
         $query = "
                         SELECT          qpl_questions.*,
                                                 qpl_qst_type.type_tag,
                                                 qpl_sol_sug.question_fi has_sug_sol
 
                         FROM            qpl_qst_type,
                                                 qpl_questions
 
                         LEFT JOIN       qpl_sol_sug
                         ON                      qpl_sol_sug.question_fi = qpl_questions.question_id
 
                         WHERE           qpl_qst_type.question_type_id = qpl_questions.question_type_fi
                         AND                     $IN_question_ids
                 ";
 
         $result = $this->db->query($query);
         $unordered = [];
         $key = 1;
         while ($row = $this->db->fetchAssoc($result)) {
             if (!isset($arr_results[ $row['question_id'] ])) {
                 $percentvalue = 0.0;
             } else {
                 $percentvalue = (
                     $row['points'] ? $arr_results[$row['question_id']]['reached'] / $row['points'] : 0
                 );
             }
             if ($percentvalue < 0) {
                 $percentvalue = 0.0;
             }
 
             $data = [
                 "nr" => "$key",
                 "title" => ilLegacyFormElementsUtil::prepareFormOutput($row['title']),
                 "max" => round($row['points'], 2),
                 "reached" => round($arr_results[$row['question_id']]['reached'] ?? 0, 2),
                 'requested_hints' => $arr_results[$row['question_id']]['requested_hints'] ?? 0,
                 'hint_points' => $arr_results[$row['question_id']]['hint_points'] ?? 0,
                 "percent" => sprintf("%2.2f ", ($percentvalue) * 100) . "%",
                 "solution" => ($row['has_sug_sol']) ? assQuestion::_getSuggestedSolutionOutput($row['question_id']) : '',
                 "type" => $row["type_tag"],
                 "qid" => $row['question_id'],
                 "original_id" => $row["original_id"],
                 "workedthrough" => isset($arr_results[$row['question_id']]) ? 1 : 0,
                 'answered' => $arr_results[$row['question_id']]['answered'] ?? 0,
                 'finalized_evaluation' => $arr_results[$row['question_id']]['finalized_evaluation'] ?? 0,
             ];
 
             $unordered[ $row['question_id'] ] = $data;
             $key++;
         }
 
         $numQuestionsTotal = count($unordered);
 
         $pass_max = 0;
         $pass_reached = 0;
         $pass_requested_hints = 0;
         $pass_hint_points = 0;
 
         $found = [];
 
         foreach ($sequence as $qid) {
             // building pass point sums based on prepared data
             // for question that exists in users qst sequence
             $pass_max += round($unordered[$qid]['max'], 2);
             $pass_reached += round($unordered[$qid]['reached'], 2);
             $pass_requested_hints += $unordered[$qid]['requested_hints'];
             $pass_hint_points += $unordered[$qid]['hint_points'];
             $found[] = $unordered[$qid];
         }
 
         $unordered = null;
 
         if ($this->getScoreCutting() == 1) {
             if ($results['reached_points'] < 0) {
                 $results['reached_points'] = 0;
             }
 
             if ($pass_reached < 0) {
                 $pass_reached = 0;
             }
         }
 
         $found['pass']['total_max_points'] = $pass_max;
         $found['pass']['total_reached_points'] = $pass_reached;
         $found['pass']['total_requested_hints'] = $pass_requested_hints;
         $found['pass']['total_hint_points'] = $pass_hint_points;
         $found['pass']['percent'] = ($pass_max > 0) ? $pass_reached / $pass_max : 0;
         $found['pass']['num_workedthrough'] = $num_worked_through;
         $found['pass']['num_questions_total'] = $numQuestionsTotal;
 
         $found["test"]["total_max_points"] = $results['max_points'];
         $found["test"]["total_reached_points"] = $results['reached_points'];
         $found["test"]["total_requested_hints"] = $results['hint_count'];
         $found["test"]["total_hint_points"] = $results['hint_points'];
         $found["test"]["result_pass"] = $results['pass'];
         $found['test']['result_tstamp'] = $results['tstamp'];
 
         if ((!$found['pass']['total_reached_points']) or (!$found['pass']['total_max_points'])) {
             $percentage = 0.0;
         } else {
             $percentage = ($found['pass']['total_reached_points'] / $found['pass']['total_max_points']) * 100.0;
 
             if ($percentage < 0) {
                 $percentage = 0.0;
             }
         }
 
         $found["test"]["passed"] = $results['passed'];
 
         return $found;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTextAnswer()

ilObjTest::getTextAnswer	(	$active_id,
		$question_id,
		$pass = `null`
	)

Returns the text answer of a given user for a given question.

Parameters

integer	$active_id
integer	$question_id

Returns: string The answer text public

Definition at line 4325 of file class.ilObjTest.php.

References assQuestion\_getSolutionMaxPass(), and null.

Referenced by ilTestArchiver\handInParticipantUploadedResults().

                                                                          : string
     {
         if (($active_id) && ($question_id)) {
             if ($pass === null) {
                 $pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
             }
             if ($pass === null) {
                 return '';
             }
             $query = $this->db->queryF(
                 "SELECT value1 FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                 ['integer', 'integer', 'integer'],
                 [$active_id, $question_id, $pass]
             );
             $result = $this->db->fetchAll($query);
             if (count($result) == 1) {
                 return $result[0]["value1"];
             }
         }
         return '';
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTimeExtensionsOfParticipants()

ilObjTest::getTimeExtensionsOfParticipants ( )

Definition at line 6942 of file class.ilObjTest.php.

References getTestId().

                                                      : array
     {
         $times = [];
         $result = $this->db->queryF(
             "SELECT tst_addtime.active_fi, tst_addtime.additionaltime FROM tst_addtime, tst_active WHERE tst_addtime.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
             ['integer'],
             [$this->getTestId()]
         );
         while ($row = $this->db->fetchAssoc($result)) {
             $times[$row['active_fi']] = $row['additionaltime'];
         }
         return $times;
     }

Here is the call graph for this function:

◆ getTitleFilenameCompliant()

ilObjTest::getTitleFilenameCompliant ( )

returns the object title prepared to be used as a filename

Definition at line 224 of file class.ilObjTest.php.

References ilFileUtils\getASCIIFilename(), and ilObject\getTitle().

                                                : string
     {
         return ilFileUtils::getASCIIFilename($this->getTitle());
     }

Here is the call graph for this function:

◆ getTitleOutput()

ilObjTest::getTitleOutput ( )

Definition at line 880 of file class.ilObjTest.php.

References getMainSettings().

Referenced by getQuestionTitle().

                                     : int
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getQuestionTitleOutputMode();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTmpCopyWizardCopyId()

ilObjTest::getTmpCopyWizardCopyId ( )

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

References $tmpCopyWizardCopyId.

Referenced by ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), and ilTestRandomQuestionSetConfig\registerClonedSourcePoolDefinitionIdMapping().

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

Here is the caller graph for this function:

◆ getTotalPointsPassedArray()

ilObjTest::getTotalPointsPassedArray ( )

Returns an array with the total points of all users who passed the test This array could be used for statistics.

Returns: array The total point values public

Definition at line 2266 of file class.ilObjTest.php.

References evalTotalParticipantsArray(), getMarkSchema(), getTestResult(), and null.

                                                : array
     {
         $totalpoints_array = [];
         $all_users = $this->evalTotalParticipantsArray();
         foreach ($all_users as $active_id => $user_name) {
             $test_result = &$this->getTestResult($active_id);
             $reached = $test_result["test"]["total_reached_points"];
             $total = $test_result["test"]["total_max_points"];
             $percentage = $total != 0 ? $reached / $total : 0;
             $mark = $this->getMarkSchema()->getMatchingMark($percentage * 100.0);
 
             if ($mark !== null && $mark->getPassed()) {
                 array_push($totalpoints_array, $test_result["test"]["total_reached_points"]);
             }
         }
         return $totalpoints_array;
     }

Here is the call graph for this function:

◆ getUnfilteredEvaluationData()

ilObjTest::getUnfilteredEvaluationData ( )

Definition at line 2477 of file class.ilObjTest.php.

Referenced by getCompleteEvaluationData().

                                                  : ilTestEvaluationData
     {
         return (new ilTestEvaluationFactory($this->db, $this))
             ->getEvaluationData();
     }

Here is the caller graph for this function:

◆ getUsePreviousAnswers()

ilObjTest::getUsePreviousAnswers ( )

Definition at line 875 of file class.ilObjTest.php.

References getMainSettings().

                                            : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsePreviousAnswerAllowed();
     }

Here is the call graph for this function:

◆ getUserData()

ilObjTest::getUserData ( $ids )

Returns a data of all users specified by id list.

Returns: array The user data "usr_id, login, lastname, firstname, clientip" of the users with id as key public

Definition at line 4538 of file class.ilObjTest.php.

References getAnonymity(), and ILIAS\Repository\lng().

                                      : array
     {
         if (!is_array($ids) || count($ids) == 0) {
             return [];
         }
 
         if ($this->getAnonymity()) {
             $result = $this->db->queryF(
                 "SELECT usr_id, %s login, %s lastname, %s firstname, client_ip clientip FROM usr_data WHERE " . $this->db->in('usr_id', $ids, false, 'integer') . " ORDER BY login",
                 ['text', 'text', 'text'],
                 ["", $this->lng->txt("anonymous"), ""]
             );
         } else {
             $result = $this->db->query("SELECT usr_id, login, lastname, firstname, client_ip clientip FROM usr_data WHERE " . $this->db->in('usr_id', $ids, false, 'integer') . " ORDER BY login");
         }
 
         $result_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             $result_array[$row["usr_id"]] = $row;
         }
         return $result_array;
     }

Here is the call graph for this function:

◆ getUsrPassOverviewEnabled()

ilObjTest::getUsrPassOverviewEnabled ( )

Definition at line 5277 of file class.ilObjTest.php.

References getMainSettings().

                                                : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsrPassOverviewEnabled();
     }

Here is the call graph for this function:

◆ getVisitingTimeOfParticipant()

ilObjTest::getVisitingTimeOfParticipant ( int $active_id )

Definition at line 7571 of file class.ilObjTest.php.

                                                                 : array
     {
         return $this->participant_repository->getFirstAndLastVisitForActiveId($active_id);
     }

◆ getWorkedQuestions()

& ilObjTest::getWorkedQuestions	(	$active_id,
		$pass = `null`
	)

Gets the id's of all questions a user already worked through.

Returns: array The question id's of the questions already worked through public

Definition at line 1617 of file class.ilObjTest.php.

                                                                  : array
     {
         if (is_null($pass)) {
             $result = $this->db->queryF(
                 "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
                 ['integer','integer'],
                 [$active_id, 0]
             );
         } else {
             $result = $this->db->queryF(
                 "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
                 ['integer','integer'],
                 [$active_id, $pass]
             );
         }
         $result_array = [];
         while ($row = $this->db->fetchAssoc($result)) {
             array_push($result_array, $row["question_fi"]);
         }
         return $result_array;
     }

◆ getWorkingTimeOfParticipantForPass()

ilObjTest::getWorkingTimeOfParticipantForPass	(	int	$active_id,
		int	$pass
	)

Definition at line 2114 of file class.ilObjTest.php.

Referenced by updateTestPassResults().

                                                                                  : int
     {
         $result = $this->db->queryF(
             "SELECT * FROM tst_times WHERE active_fi = %s AND pass = %s ORDER BY started",
             ['integer','integer'],
             [$active_id, $pass]
         );
         $time = 0;
         while ($row = $this->db->fetchAssoc($result)) {
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
             $epoch_1 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
             $epoch_2 = mktime(
                 (int) $matches[4],
                 (int) $matches[5],
                 (int) $matches[6],
                 (int) $matches[2],
                 (int) $matches[3],
                 (int) $matches[1]
             );
             $time += ($epoch_2 - $epoch_1);
         }
         return $time;
     }

Here is the caller graph for this function:

◆ getXMLZip()

ilObjTest::getXMLZip ( )

Get zipped xml file for test.

Definition at line 6479 of file class.ilObjTest.php.

                                : string
     {
         return $this->export_factory->getExporter($this, 'xml')
             ->write();
     }

◆ hasAnyTestResult()

ilObjTest::hasAnyTestResult ( ilTestSession $test_session )

Definition at line 5068 of file class.ilObjTest.php.

References ilTestSession\getActiveId(), and ilTestSession\getLastFinishedPass().

                                                                  : bool
     {
         $passSelector = new ilTestPassesSelector($this->db, $this);
 
         $passSelector->setActiveId($test_session->getActiveId());
         $passSelector->setLastFinishedPass($test_session->getLastFinishedPass());
 
         return $passSelector->hasExistingPasses();
     }

Here is the call graph for this function:

◆ hasNrOfTriesRestriction()

ilObjTest::hasNrOfTriesRestriction ( )

returns if the numbers of tries have to be checked

Definition at line 4687 of file class.ilObjTest.php.

References getNrOfTries().

Referenced by isExecutable().

                                              : bool
     {
         return $this->getNrOfTries() != 0;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasQuestionsWithoutQuestionpool()

ilObjTest::hasQuestionsWithoutQuestionpool ( )

Definition at line 6629 of file class.ilObjTest.php.

References getQuestionTitlesAndIndexes().

                                                      : bool
     {
         $questions = $this->getQuestionTitlesAndIndexes();
 
         $IN_questions = $this->db->in('q1.question_id', array_keys($questions), false, 'integer');
 
         $query = "
                         SELECT          count(q1.question_id) cnt
 
                         FROM            qpl_questions q1
 
                         INNER JOIN      qpl_questions q2
                         ON                      q2.question_id = q1.original_id
 
                         WHERE           $IN_questions
                         AND                     q1.obj_fi = q2.obj_fi
                 ";
         $rset = $this->db->query($query);
         $row = $this->db->fetchAssoc($rset);
 
         return $row['cnt'] > 0;
     }

Here is the call graph for this function:

◆ insertManualFeedback()

ilObjTest::insertManualFeedback	(	int	$active_id,
		int	$question_id,
		int	$pass,
		?string	$feedback,
		bool	$finalized,
		array	$feedback_old
	)

private

Definition at line 6166 of file class.ilObjTest.php.

References ilObject\$user, ilRTE\_replaceMediaObjectImageSrc(), ilObject\getRefId(), ILIAS\Repository\logger(), null, and ILIAS\Repository\user().

Referenced by saveManualFeedback().

      : void {
         $next_id = $this->db->nextId('tst_manual_fb');
         $user = $this->user->getId();
         $finalized_time = time();
 
         $update_default = [
             'manual_feedback_id' => [ 'integer', $next_id],
             'active_fi' => [ 'integer', $active_id],
             'question_fi' => [ 'integer', $question_id],
             'pass' => [ 'integer', $pass],
             'feedback' => [ 'clob', $feedback ? ilRTE::_replaceMediaObjectImageSrc($feedback, 0) : null],
             'tstamp' => [ 'integer', time()]
         ];
 
         if ($feedback_old !== [] && (int) $feedback_old['finalized_evaluation'] === 1) {
             $user = $feedback_old['finalized_by_usr_id'];
             $finalized_time = $feedback_old['finalized_tstamp'];
         }
 
         if ($finalized === false) {
             $update_default['finalized_evaluation'] = ['integer', 0];
             $update_default['finalized_by_usr_id'] = ['integer', 0];
             $update_default['finalized_tstamp'] = ['integer', 0];
         } elseif ($finalized === true) {
             $update_default['finalized_evaluation'] = ['integer', 1];
             $update_default['finalized_by_usr_id'] = ['integer', $user];
             $update_default['finalized_tstamp'] = ['integer', $finalized_time];
         }
 
         $this->db->insert('tst_manual_fb', $update_default);
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logScoringInteraction(
                 $this->logger->getInteractionFactory()->buildScoringInteraction(
                     $this->getRefId(),
                     $question_id,
                     $this->user->getId(),
                     self::_getUserIdFromActiveId($active_id),
                     TestScoringInteractionTypes::QUESTION_GRADED,
                     [
                         AdditionalInformationGenerator::KEY_EVAL_FINALIZED => $this->logger
                             ->getAdditionalInformationGenerator()->getTrueFalseTagForBool($finalized),
                         AdditionalInformationGenerator::KEY_FEEDBACK => $feedback ? ilRTE::_replaceMediaObjectImageSrc($feedback, 0) : ''
                     ]
                 )
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertQuestion()

ilObjTest::insertQuestion	(	int	$question_id,
		bool	$link_only = `false`
	)

Definition at line 1358 of file class.ilObjTest.php.

References $data, duplicateQuestionForTest(), ilObject\getRefId(), getTestId(), assQuestion\instantiateQuestion(), loadQuestions(), ILIAS\Repository\logger(), saveCompleteStatus(), and ILIAS\Repository\user().

Referenced by copyQuestions().

                                                                              : int
     {
         if ($link_only) {
             $duplicate_id = $question_id;
         } else {
             $duplicate_id = $this->duplicateQuestionForTest($question_id);
         }
 
         // get maximum sequence index in test
         $result = $this->db->queryF(
             "SELECT MAX(sequence) seq FROM tst_test_question WHERE test_fi=%s",
             ['integer'],
             [$this->getTestId()]
         );
         $sequence = 1;
 
         if ($result->numRows() == 1) {
             $data = $this->db->fetchObject($result);
             $sequence = $data->seq + 1;
         }
 
         $next_id = $this->db->nextId('tst_test_question');
         $this->db->manipulateF(
             "INSERT INTO tst_test_question (test_question_id, test_fi, question_fi, sequence, tstamp) VALUES (%s, %s, %s, %s, %s)",
             ['integer', 'integer','integer','integer','integer'],
             [$next_id, $this->getTestId(), $duplicate_id, $sequence, time()]
         );
         // remove test_active entries, because test has changed
         $this->db->manipulateF(
             "DELETE FROM tst_active WHERE test_fi = %s",
             ['integer'],
             [$this->getTestId()]
         );
         $this->loadQuestions();
         $this->saveCompleteStatus($this->question_set_config_factory->getQuestionSetConfig());
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::QUESTION_ADDED,
                     [
                         AdditionalInformationGenerator::KEY_QUESTION_ID => $question_id
                     ] + (assQuestion::instantiateQuestion($question_id))
                             ->toLog($this->logger->getAdditionalInformationGenerator())
                 )
             );
         }
 
         return $duplicate_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ inviteUser()

ilObjTest::inviteUser	(	$user_id,
		$client_ip = `""`
	)

Invites a user to a test.

Parameters

integer $user_id The database id of the invited user public

Definition at line 4592 of file class.ilObjTest.php.

References $user_id, getTestId(), and null.

     {
         $this->db->manipulateF(
             "DELETE FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
             ['integer', 'integer'],
             [$this->getTestId(), $user_id]
         );
         $this->db->manipulateF(
             "INSERT INTO tst_invited_user (test_fi, user_fi, ip_range_from, ip_range_to, tstamp) VALUES (%s, %s, %s, %s, %s)",
             ['integer', 'integer', 'text', 'text', 'integer'],
             [$this->getTestId(), $user_id, (strlen($client_ip)) ? $client_ip : null, (strlen($client_ip)) ? $client_ip : null,time()]
         );
     }

Here is the call graph for this function:

◆ isActivationLimited()

ilObjTest::isActivationLimited ( )

Definition at line 6704 of file class.ilObjTest.php.

References $activation_limited.

Referenced by addDefaults(), saveToDb(), and toXML().

                                          : ?bool
     {
         return $this->activation_limited;
     }

Here is the caller graph for this function:

◆ isActiveTestSubmitted()

ilObjTest::isActiveTestSubmitted ( $user_id = null )

returns if the active for user_id has been submitted

Definition at line 4670 of file class.ilObjTest.php.

References $user_id, getTestId(), and ILIAS\Repository\user().

                                                           : bool
     {
         if (!is_numeric($user_id)) {
             $user_id = $this->user->getId();
         }
 
         $result = $this->db->queryF(
             "SELECT submitted FROM tst_active WHERE test_fi=%s AND user_fi=%s AND submitted=%s",
             ['integer', 'integer', 'integer'],
             [$this->getTestId(), $user_id, 1]
         );
         return $result->numRows() == 1;
     }

Here is the call graph for this function:

◆ isBlockPassesAfterPassedEnabled()

ilObjTest::isBlockPassesAfterPassedEnabled ( )

Definition at line 856 of file class.ilObjTest.php.

References getMainSettings().

Referenced by isExecutable().

                                                      : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getBlockAfterPassedEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isComplete()

ilObjTest::isComplete ( ilTestQuestionSetConfig $test_question_set_config )

final

Definition at line 425 of file class.ilObjTest.php.

References getMarkSchema(), ilTestQuestionSetConfig\isQuestionSetConfigured(), and null.

Referenced by saveCompleteStatus().

                                                                                        : bool
     {
         if ($this->getMarkSchema() === null
             || $this->getMarkSchema()->getMarkSteps() === []) {
             return false;
         }
 
         if (!$test_question_set_config->isQuestionSetConfigured()) {
             return false;
         }
 
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isEndingTimeEnabled()

ilObjTest::isEndingTimeEnabled ( )

Definition at line 961 of file class.ilObjTest.php.

References getMainSettings().

Referenced by endingTimeReached().

                                          : bool
     {
         return $this->getMainSettings()->getAccessSettings()->getEndTimeEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isExecutable()

ilObjTest::isExecutable	(	$test_session,
		$user_id,
		$allow_pass_increase = `false`
	)

Checks if the test is executable by the given user.

Parameters

	$test_session
integer	$user_id	The user id
bool	$allowPassIncrease

Returns: array Result array

Exceptions

ilDateTimeException

Definition at line 4971 of file class.ilObjTest.php.

References $user_id, ilObjTestAccess\_isPassed(), endingTimeReached(), ilDatePresentation\formatDate(), getActiveIdOfUser(), getEnableProcessingTime(), getEndingTime(), ilObject\getId(), getNrOfTries(), ilObject\getObjectProperties(), getStartingTime(), getStartingTimeOfUser(), hasNrOfTriesRestriction(), IL_CAL_UNIX, isBlockPassesAfterPassedEnabled(), isMaxProcessingTimeReached(), isNextPassAllowed(), ILIAS\Repository\lng(), and startingTimeReached().

                                                                                        : array
     {
         $result = [
             "executable" => true,
             "errormessage" => ""
         ];
 
         if (!$this->getObjectProperties()->getPropertyIsOnline()->getIsOnline()) {
             $result["executable"] = false;
             $result["errormessage"] = $this->lng->txt('autosave_failed') . ': ' . $this->lng->txt('offline');
             return $result;
         }
 
         if (!$this->startingTimeReached()) {
             $result["executable"] = false;
             $result["errormessage"] = sprintf($this->lng->txt("detail_starting_time_not_reached"), ilDatePresentation::formatDate(new ilDateTime($this->getStartingTime(), IL_CAL_UNIX)));
             return $result;
         }
         if ($this->endingTimeReached()) {
             $result["executable"] = false;
             $result["errormessage"] = sprintf($this->lng->txt("detail_ending_time_reached"), ilDatePresentation::formatDate(new ilDateTime($this->getEndingTime(), IL_CAL_UNIX)));
             return $result;
         }
 
         $active_id = $this->getActiveIdOfUser($user_id);
 
         if ($this->getEnableProcessingTime()
             && $active_id > 0
             && ($starting_time = $this->getStartingTimeOfUser($active_id)) !== false
             && $this->isMaxProcessingTimeReached($starting_time, $active_id)) {
             $result["executable"] = false;
             $result["errormessage"] = $this->lng->txt("detail_max_processing_time_reached");
             return $result;
         }
 
         $testPassesSelector = new ilTestPassesSelector($this->db, $this);
         $testPassesSelector->setActiveId($active_id);
         $testPassesSelector->setLastFinishedPass($test_session->getLastFinishedPass());
 
         if ($this->hasNrOfTriesRestriction() && ($active_id > 0)) {
             $closedPasses = $testPassesSelector->getClosedPasses();
 
             if (count($closedPasses) >= $this->getNrOfTries()) {
                 $result["executable"] = false;
                 $result["errormessage"] = $this->lng->txt("maximum_nr_of_tries_reached");
                 return $result;
             }
 
             if ($this->isBlockPassesAfterPassedEnabled() && !$testPassesSelector->openPassExists()) {
                 if (ilObjTestAccess::_isPassed($user_id, $this->getId())) {
                     $result['executable'] = false;
                     $result['errormessage'] = $this->lng->txt("tst_addit_passes_blocked_after_passed_msg");
                     return $result;
                 }
             }
         }
 
         $next_pass_allowed_timestamp = 0;
         if (!$this->isNextPassAllowed($testPassesSelector, $next_pass_allowed_timestamp)) {
             $date = ilDatePresentation::formatDate(new ilDateTime($next_pass_allowed_timestamp, IL_CAL_UNIX));
 
             $result['executable'] = false;
             $result['errormessage'] = sprintf($this->lng->txt('wait_for_next_pass_hint_msg'), $date);
             return $result;
         }
         return $result;
     }

Here is the call graph for this function:

◆ isFixedTest()

ilObjTest::isFixedTest ( )

Returns the fact wether this test is a fixed question set test or not.

Returns: boolean $isFixedTest

Definition at line 7044 of file class.ilObjTest.php.

References getQuestionSetType().

Referenced by ILIAS\Test\ExportImport\Factory\getExporter(), and ILIAS\Test\Questions\Properties\DatabaseRepository\getQuestionPropertiesForTest().

                                  : bool
     {
         return $this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isFollowupQuestionAnswerFixationEnabled()

ilObjTest::isFollowupQuestionAnswerFixationEnabled ( )

Definition at line 7165 of file class.ilObjTest.php.

References getMainSettings().

                                                              : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getLockAnswerOnNextQuestionEnabled();
     }

Here is the call graph for this function:

◆ isForceInstantFeedbackEnabled()

ilObjTest::isForceInstantFeedbackEnabled ( )

Definition at line 7175 of file class.ilObjTest.php.

References getMainSettings().

                                                    : ?bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getForceInstantFeedbackOnNextQuestion();
     }

Here is the call graph for this function:

◆ isHighscoreAnon()

ilObjTest::isHighscoreAnon ( )

Gets if the highscores should be displayed anonymized.

Note: This method considers the global anonymity switch. If you need access to the users setting,

See also: getHighscoreAnon()

Returns: boolean True, if output is anonymized.

Definition at line 6807 of file class.ilObjTest.php.

References getAnonymity(), and getHighscoreAnon().

                                      : bool
     {
         return $this->getAnonymity() == 1 || $this->getHighscoreAnon();
     }

Here is the call graph for this function:

◆ isHTML()

ilObjTest::isHTML ( $a_text )

Checks if a given string contains HTML or not.

Parameters

string $a_text Text which should be checked

Returns: boolean public

Definition at line 5433 of file class.ilObjTest.php.

Referenced by addQTIMaterial().

                                    : bool
     {
         if (preg_match("/<[^>]*?>/", $a_text)) {
             return true;
         } else {
             return false;
         }
     }

Here is the caller graph for this function:

◆ isInstantFeedbackAnswerFixationEnabled()

ilObjTest::isInstantFeedbackAnswerFixationEnabled ( )

Definition at line 7170 of file class.ilObjTest.php.

References getMainSettings().

                                                             : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled();
     }

Here is the call graph for this function:

◆ isMaxProcessingTimeReached()

ilObjTest::isMaxProcessingTimeReached	(	int	$starting_time,
		int	$active_id
	)

Returns whether the maximum processing time for a test is reached or not.

Returns: bool TRUE if the maxium processing time is reached, FALSE if the maximum processing time is not reached or no maximum processing time is given

Definition at line 5123 of file class.ilObjTest.php.

References getEnableProcessingTime(), and getProcessingTimeInSeconds().

Referenced by isExecutable().

                                                                                   : bool
     {
         if (!$this->getEnableProcessingTime()) {
             return false;
         }
 
         $processing_time = $this->getProcessingTimeInSeconds($active_id);
         $now = time();
         if ($now > ($starting_time + $processing_time)) {
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isNextPassAllowed()

ilObjTest::isNextPassAllowed	(	ilTestPassesSelector	$testPassesSelector,
		int &	$next_pass_allowed_timestamp
	)

Definition at line 5039 of file class.ilObjTest.php.

References ilTestPassesSelector\getLastFinishedPass(), ilTestPassesSelector\getLastFinishedPassTimestamp(), getMainSettings(), and null.

Referenced by isExecutable().

                                                                                                                   : bool
     {
         $waiting_between_passes = $this->getMainSettings()->getTestBehaviourSettings()->getPassWaiting();
         $last_finished_pass_timestamp = $testPassesSelector->getLastFinishedPassTimestamp();
 
         if (
             $this->getMainSettings()->getTestBehaviourSettings()->getPassWaitingEnabled()
             && ($waiting_between_passes !== '')
             && ($testPassesSelector->getLastFinishedPass() !== null)
             && ($last_finished_pass_timestamp !== null)
         ) {
             $time_values = explode(':', $waiting_between_passes);
             $next_pass_allowed_timestamp = strtotime('+ ' . $time_values[0] . ' Days + ' . $time_values[1] . ' Hours' . $time_values[2] . ' Minutes', $last_finished_pass_timestamp);
             return (time() > $next_pass_allowed_timestamp);
         }
 
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isNrOfTriesReached()

ilObjTest::isNrOfTriesReached ( $tries )

returns if number of tries are reached

Deprecated:: : tries field differs per situation, outside a pass it's the number of tries, inside a pass it's the current pass number.

Definition at line 4698 of file class.ilObjTest.php.

References getNrOfTries().

                                               : bool
     {
         return $tries >= $this->getNrOfTries();
     }

Here is the call graph for this function:

◆ isOfferingQuestionHintsEnabled()

ilObjTest::isOfferingQuestionHintsEnabled ( )

Definition at line 6689 of file class.ilObjTest.php.

References getMainSettings().

Referenced by ilTestArchiver\getResultsOfUserOutput().

                                                     : bool
     {
         return $this->getMainSettings()->getQuestionBehaviourSettings()->getQuestionHintsEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isOnline()

ilObjTest::isOnline ( )

Definition at line 6684 of file class.ilObjTest.php.

References $online.

                               : bool
     {
         return $this->online;
     }

◆ isParticipantsLastPassActive()

static ilObjTest::isParticipantsLastPassActive	(	int	$test_ref_id,
		int	$user_id
	)

static

Definition at line 7181 of file class.ilObjTest.php.

References $DIC, $ilDB, $test_sequence, and ilObjectFactory\getInstanceByRefId().

                                                                                        : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $ilUser = $DIC['ilUser'];
 
         $test_obj = ilObjectFactory::getInstanceByRefId($test_ref_id, false);
 
         $active_id = $test_obj->getActiveIdOfUser($user_id);
 
         $test_session_factory = new ilTestSessionFactory($test_obj, $ilDB, $ilUser);
 
         // Added temporarily bugfix smeyer
         $test_session_factory->reset();
 
         $test_sequence_factory = new ilTestSequenceFactory($test_obj, $ilDB, TestDIC::dic()['question.general_properties.repository']);
 
         $test_session = $test_session_factory->getSession($active_id);
         $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $test_session->getPass());
         $test_sequence->loadFromDb();
 
         return $test_sequence->hasSequence();
     }

Here is the call graph for this function:

◆ isPassDeletionAllowed()

ilObjTest::isPassDeletionAllowed ( )

Definition at line 6892 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                            : bool
     {
         return $this->getScoreSettings()->getResultSummarySettings()->getPassDeletionAllowed();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isPasswordEnabled()

ilObjTest::isPasswordEnabled ( )

Definition at line 992 of file class.ilObjTest.php.

References getMainSettings().

                                        : bool
     {
         return $this->getMainSettings()->getAccessSettings()->getPasswordEnabled();
     }

Here is the call graph for this function:

◆ isPluginActive()

ilObjTest::isPluginActive ( $a_pname )

Checks wheather or not a question plugin with a given name is active.

Parameters

string $a_pname The plugin name public

Definition at line 6324 of file class.ilObjTest.php.

References ilComponentInfo\TYPE_MODULES.

                                             : bool
     {
         if (!$this->component_repository->getComponentByTypeAndName(
             ilComponentInfo::TYPE_MODULES,
             'TestQuestionPool'
         )->getPluginSlotById('qst')->hasPluginName($a_pname)) {
             return false;
         }
 
         return $this->component_repository
             ->getComponentByTypeAndName(
                 ilComponentInfo::TYPE_MODULES,
                 'TestQuestionPool'
             )
             ->getPluginSlotById(
                 'qst'
             )
             ->getPluginByName(
                 $a_pname
             )->isActive();
     }

◆ isPostponingEnabled()

ilObjTest::isPostponingEnabled ( )

Definition at line 736 of file class.ilObjTest.php.

References getMainSettings().

                                          : bool
     {
         return $this->getMainSettings()->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd();
     }

Here is the call graph for this function:

◆ isPreviousSolutionReuseEnabled()

ilObjTest::isPreviousSolutionReuseEnabled ( $active_id )

Definition at line 885 of file class.ilObjTest.php.

References $res, and ILIAS\Repository\user().

                                                               : bool
     {
         $result = $this->db->queryF(
             "SELECT tst_tests.use_previous_answers FROM tst_tests, tst_active WHERE tst_tests.test_id = tst_active.test_fi AND tst_active.active_id = %s",
             ["integer"],
             [$active_id]
         );
         if ($result->numRows()) {
             $row = $this->db->fetchAssoc($result);
             $test_allows_reuse = $row["use_previous_answers"];
         }
 
         if ($test_allows_reuse === '1') {
             $res = $this->user->getPref("tst_use_previous_answers");
             if ($res === '1') {
                 return true;
             }
         }
         return false;
     }

Here is the call graph for this function:

◆ isRandomTest()

ilObjTest::isRandomTest ( )

Returns the fact wether this test is a random questions test or not.

Returns: boolean $isRandomTest

Definition at line 7054 of file class.ilObjTest.php.

References getQuestionSetType().

Referenced by createTestSequence(), getAllQuestions(), getAnsweredQuestionCount(), getExistingQuestions(), getQuestionCount(), getQuestionCountWithoutReloading(), ILIAS\Test\Questions\Properties\DatabaseRepository\getQuestionPropertiesForTest(), getQuestionsOfPass(), getQuestionsOfTest(), loadQuestions(), removeQuestionWithResults(), and removeTestResultsByActiveIds().

                                   : bool
     {
         return $this->getQuestionSetType() == self::QUESTION_SET_TYPE_RANDOM;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isRedirectModeKiosk()

ilObjTest::isRedirectModeKiosk ( )

Definition at line 977 of file class.ilObjTest.php.

References getMainSettings().

                                          : bool
     {
         return $this->getMainSettings()->getFinishingSettings()->getRedirectionMode() === self::REDIRECT_KIOSK;
     }

Here is the call graph for this function:

◆ isRedirectModeNone()

ilObjTest::isRedirectModeNone ( )

Definition at line 982 of file class.ilObjTest.php.

References getMainSettings().

                                         : bool
     {
         return $this->getMainSettings()->getFinishingSettings()->getRedirectionMode() === self::REDIRECT_NONE;
     }

Here is the call graph for this function:

◆ isScoreReportingEnabled()

ilObjTest::isScoreReportingEnabled ( )

Definition at line 741 of file class.ilObjTest.php.

References getScoreSettings().

                                              : bool
     {
         return $this->getScoreSettings()->getResultSummarySettings()->getScoreReporting()->isReportingEnabled();
     }

Here is the call graph for this function:

◆ isShowExamIdInTestPassEnabled()

ilObjTest::isShowExamIdInTestPassEnabled ( )

Definition at line 7015 of file class.ilObjTest.php.

References getMainSettings().

                                                    : bool
     {
         return $this->getMainSettings()->getTestBehaviourSettings()->getExamIdInTestAttemptEnabled();
     }

Here is the call graph for this function:

◆ isShowExamIdInTestResultsEnabled()

ilObjTest::isShowExamIdInTestResultsEnabled ( )

Definition at line 7020 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by ilTestArchiver\getResultsOfUserOutput().

                                                       : bool
     {
         return $this->getScoreSettings()->getResultDetailsSettings()->getShowExamIdInTestResults();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isShowGradingMarkEnabled()

ilObjTest::isShowGradingMarkEnabled ( )

Definition at line 7160 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                               : bool
     {
         return $this->getScoreSettings()->getResultSummarySettings()->getShowGradingMarkEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isShowGradingStatusEnabled()

ilObjTest::isShowGradingStatusEnabled ( )

Definition at line 7155 of file class.ilObjTest.php.

References getScoreSettings().

Referenced by toXML().

                                                 : bool
     {
         return $this->getScoreSettings()->getResultSummarySettings()->getShowGradingStatusEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isSkillManagementGloballyActivated()

static ilObjTest::isSkillManagementGloballyActivated ( )

static

Definition at line 7144 of file class.ilObjTest.php.

References null.

Referenced by ilTestSkillAdministrationGUI\isAccessDenied().

                                                                : ?bool
     {
         if (self::$isSkillManagementGloballyActivated === null) {
             $skmgSet = new ilSkillManagementSettings();
 
             self::$isSkillManagementGloballyActivated = $skmgSet->isActivated();
         }
 
         return self::$isSkillManagementGloballyActivated;
     }

Here is the caller graph for this function:

◆ isSkillServiceEnabled()

ilObjTest::isSkillServiceEnabled ( )

Definition at line 7113 of file class.ilObjTest.php.

References getMainSettings().

                                            : bool
     {
         return $this->getMainSettings()->getAdditionalSettings()->getSkillsServiceEnabled();
     }

Here is the call graph for this function:

◆ isSkillServiceToBeConsidered()

ilObjTest::isSkillServiceToBeConsidered ( )

Returns whether this test must consider skills, usually by providing appropriate extensions in the user interface components.

Skills must be considered if skill management is globally enabled and this object has the skill service enabled as well.

See also: isSkillServiceEnabled(); isSkillManagementGloballyActivated()

Returns: boolean whether this test takes skills into account.

Definition at line 7129 of file class.ilObjTest.php.

References getMainSettings().

                                                   : bool
     {
         if (!$this->getMainSettings()->getAdditionalSettings()->getSkillsServiceEnabled()) {
             return false;
         }
 
         if (!self::isSkillManagementGloballyActivated()) {
             return false;
         }
 
         return true;
     }

Here is the call graph for this function:

◆ isStartingTimeEnabled()

ilObjTest::isStartingTimeEnabled ( )

Definition at line 950 of file class.ilObjTest.php.

References getMainSettings().

Referenced by startingTimeReached().

                                            : bool
     {
         return $this->getMainSettings()->getAccessSettings()->getStartTimeEnabled();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isTestFinished()

ilObjTest::isTestFinished ( $active_id )

returns if the active for user_id has been submitted

Definition at line 4657 of file class.ilObjTest.php.

Referenced by isTestFinishedToViewResults().

                                               : bool
     {
         $result = $this->db->queryF(
             "SELECT submitted FROM tst_active WHERE active_id=%s AND submitted=%s",
             ['integer', 'integer'],
             [$active_id, 1]
         );
         return $result->numRows() == 1;
     }

Here is the caller graph for this function:

◆ isTestFinishedToViewResults()

ilObjTest::isTestFinishedToViewResults	(	$active_id,
		$currentpass
	)

Returns true if an active user completed a test pass and did not start a new pass.

Parameters

integer	$active_id	The active id of the user
integer	$currentpass	The current test pass of the user

Returns: boolean true if an active user completed a test pass and did not start a new pass, false otherwise public

Definition at line 1647 of file class.ilObjTest.php.

References isTestFinished(), and lookupPassResultsUpdateTimestamp().

                                                                          : bool
     {
         $num = ilObjTest::lookupPassResultsUpdateTimestamp($active_id, $currentpass);
         return ((($currentpass > 0) && ($num == 0)) || $this->isTestFinished($active_id)) ? true : false;
     }

Here is the call graph for this function:

◆ isTestQuestion()

ilObjTest::isTestQuestion ( int $question_id )

Definition at line 5183 of file class.ilObjTest.php.

References getTestQuestions().

                                                     : bool
     {
         foreach ($this->getTestQuestions() as $questionData) {
             if ($questionData['question_id'] != $question_id) {
                 continue;
             }
 
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

◆ loadFromDb()

ilObjTest::loadFromDb ( )

Definition at line 607 of file class.ilObjTest.php.

References $data, ilObject\getId(), ilObjectActivation\getItem(), loadQuestions(), setActivationEndingTime(), setActivationLimited(), setActivationStartingTime(), setActivationVisibility(), setTestId(), and ilObjectActivation\TIMINGS_ACTIVATION.

Referenced by cloneObject(), fromXML(), and read().

                                 : void
     {
         $result = $this->db->queryF(
             "SELECT test_id FROM tst_tests WHERE obj_fi = %s",
             ['integer'],
             [$this->getId()]
         );
         if ($result->numRows() === 1) {
             $data = $this->db->fetchObject($result);
             $this->setTestId($data->test_id);
             $this->loadQuestions();
         }
 
         // moved activation to ilObjectActivation
         if (isset($this->ref_id)) {
             $activation = ilObjectActivation::getItem($this->ref_id);
             switch ($activation["timing_type"]) {
                 case ilObjectActivation::TIMINGS_ACTIVATION:
                     $this->setActivationLimited(true);
                     $this->setActivationStartingTime($activation["timing_start"]);
                     $this->setActivationEndingTime($activation["timing_end"]);
                     $this->setActivationVisibility($activation["visible"]);
                     break;
 
                 default:
                     $this->setActivationLimited(false);
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadQuestions()

ilObjTest::loadQuestions	(	int	$active_id = `0`,
		?int	$pass = `null`
	)

Load the test question id's from the database.

Definition at line 642 of file class.ilObjTest.php.

References $data, getActiveIdOfUser(), isRandomTest(), and ILIAS\Repository\user().

Referenced by getAllQuestions(), getAnsweredQuestionCount(), getQuestionCount(), insertQuestion(), loadFromDb(), questionMoveDown(), questionMoveUp(), reindexFixedQuestionOrdering(), and setQuestionOrder().

                                                                         : void
     {
         $this->questions = [];
         if ($this->isRandomTest()) {
             if ($active_id === 0) {
                 $active_id = $this->getActiveIdOfUser($this->user->getId());
             }
             if (is_null($pass)) {
                 $pass = self::_getPass($active_id);
             }
             $result = $this->db->queryF(
                 'SELECT tst_test_rnd_qst.* '
                 . 'FROM tst_test_rnd_qst, qpl_questions '
                 . 'WHERE tst_test_rnd_qst.active_fi = %s '
                 . 'AND qpl_questions.question_id = tst_test_rnd_qst.question_fi '
                 . 'AND tst_test_rnd_qst.pass = %s '
                 . 'ORDER BY sequence',
                 ['integer', 'integer'],
                 [$active_id, $pass]
             );
         } else {
             $result = $this->db->queryF(
                 'SELECT tst_test_question.* '
                 . 'FROM tst_test_question, qpl_questions '
                 . 'WHERE tst_test_question.test_fi = %s '
                 . 'AND qpl_questions.question_id = tst_test_question.question_fi '
                 . 'ORDER BY sequence',
                 ['integer'],
                 [$this->test_id]
             );
         }
         $index = 1;
         if ($this->test_id !== -1) {
             //Omit loading of questions for non-id'ed test
             while ($data = $this->db->fetchAssoc($result)) {
                 $this->questions[$index++] = $data["question_fi"];
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupExamId()

static ilObjTest::lookupExamId	(	$active_id,
		$pass
	)

static

Definition at line 6979 of file class.ilObjTest.php.

References $DIC, $ilDB, and null.

Referenced by ilTestArchiver\getResultsOfUserOutput(), ilTestPlayerAbstractGUI\outQuestionSummaryCmd(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestServiceGUI\populateExamId(), ilTestPlayerAbstractGUI\prepareTestPage(), and ilTestSubmissionReviewGUI\show().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $exam_id_query = 'SELECT exam_id FROM tst_pass_result WHERE active_fi = %s AND pass = %s';
         $exam_id_result = $ilDB->queryF($exam_id_query, [ 'integer', 'integer' ], [ $active_id, $pass ]);
         if ($ilDB->numRows($exam_id_result) == 1) {
             $exam_id_row = $ilDB->fetchAssoc($exam_id_result);
 
             if ($exam_id_row['exam_id'] != null) {
                 return $exam_id_row['exam_id'];
             }
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ lookupPassResultsUpdateTimestamp()

static ilObjTest::lookupPassResultsUpdateTimestamp	(	$active_id,
		$pass
	)

static

Parameters

int	$active_id
int	$pass

Returns: int

Definition at line 4921 of file class.ilObjTest.php.

References $DIC, and $ilDB.

Referenced by ILIAS\Test\ExportImport\ResultsExportExcel\addResultsHeader(), ilTestService\getPassOverviewData(), and isTestFinishedToViewResults().

                                                                               : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         if (is_null($pass)) {
             $pass = 0;
         }
 
         $query = "
                         SELECT  tst_pass_result.tstamp pass_res_tstamp,
                                         tst_test_result.tstamp quest_res_tstamp
 
                         FROM tst_pass_result
 
                         LEFT JOIN tst_test_result
                         ON tst_test_result.active_fi = tst_pass_result.active_fi
                         AND tst_test_result.pass = tst_pass_result.pass
 
                         WHERE tst_pass_result.active_fi = %s
                         AND tst_pass_result.pass = %s
 
                         ORDER BY tst_test_result.tstamp DESC
                 ";
 
         $result = $ilDB->queryF(
             $query,
             ['integer', 'integer'],
             [$active_id, $pass]
         );
 
         while ($row = $ilDB->fetchAssoc($result)) {
             if ($row['quest_res_tstamp']) {
                 return $row['quest_res_tstamp'];
             }
 
             return $row['pass_res_tstamp'];
         }
 
         return 0;
     }

Here is the caller graph for this function:

◆ lookupQuestionSetTypeByActiveId()

ilObjTest::lookupQuestionSetTypeByActiveId ( int $active_id )

Definition at line 5579 of file class.ilObjTest.php.

References $res, and null.

Referenced by getQuestionCountAndPointsForPassOfParticipant().

                                                                    : ?string
     {
         $query = "
                         SELECT          tst_tests.question_set_type
                         FROM            tst_active
                         INNER JOIN      tst_tests
                         ON                      tst_active.test_fi = tst_tests.test_id
                         WHERE           tst_active.active_id = %s
                 ";
 
         $res = $this->db->queryF($query, ['integer'], [$active_id]);
 
         while ($row = $this->db->fetchAssoc($res)) {
             return $row['question_set_type'];
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ marksEditable()

ilObjTest::marksEditable ( )

Returns: {}

Definition at line 3998 of file class.ilObjTest.php.

References evalTotalPersons(), and getScoreSettings().

Referenced by ILIAS\Test\Scoring\Marks\MarkSchemaGUI\__construct().

                                    : bool
     {
         $total = $this->evalTotalPersons();
         $results_summary_settings = $this->getScoreSettings()->getResultSummarySettings();
         if ($total === 0
             || $results_summary_settings->getScoreReporting()->isReportingEnabled() === false) {
             return true;
         }
 
         if ($results_summary_settings->getScoreReporting() === ScoreReportingTypes::SCORE_REPORTING_DATE) {
             return $results_summary_settings->getReportingDate()
                 >= new DateTimeImmutable('now', new DateTimeZone('UTC'));
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ modifyExportIdentifier()

ilObjTest::modifyExportIdentifier	(	$a_tag,
		$a_param,
		$a_value
	)

Returns the installation id for a given identifier.

private

Definition at line 3866 of file class.ilObjTest.php.

References ilUtil\insertInstIntoID().

     {
         if ($a_tag == "Identifier" && $a_param == "Entry") {
             $a_value = ilUtil::insertInstIntoID($a_value);
         }
 
         return $a_value;
     }

Here is the call graph for this function:

◆ moveQuestions()

ilObjTest::moveQuestions	(	array	$move_questions,
		int	$target_index,
		int	$insert_mode
	)

Parameters

	array<int>	$move_questions
integer	$insert_mode	0, if insert before the target position, 1 if insert after the target position

Definition at line 2728 of file class.ilObjTest.php.

References $questions, ilObject\getRefId(), ILIAS\Repository\logger(), saveQuestionsToDb(), and ILIAS\Repository\user().

                                                                                              : void
     {
         $this->questions = array_values($this->questions);
         $array_pos = array_search($target_index, $this->questions);
         if ($insert_mode == 0) {
             $part1 = array_slice($this->questions, 0, $array_pos);
             $part2 = array_slice($this->questions, $array_pos);
         } elseif ($insert_mode == 1) {
             $part1 = array_slice($this->questions, 0, $array_pos + 1);
             $part2 = array_slice($this->questions, $array_pos + 1);
         }
         foreach ($move_questions as $question_id) {
             if (!(array_search($question_id, $part1) === false)) {
                 unset($part1[array_search($question_id, $part1)]);
             }
             if (!(array_search($question_id, $part2) === false)) {
                 unset($part2[array_search($question_id, $part2)]);
             }
         }
         $part1 = array_values($part1);
         $part2 = array_values($part2);
         $new_array = array_values(array_merge($part1, $move_questions, $part2));
         $this->questions = [];
         $counter = 1;
         foreach ($new_array as $question_id) {
             $this->questions[$counter] = $question_id;
             $counter++;
         }
         $this->saveQuestionsToDb();
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::QUESTION_MOVED,
                     [
                         AdditionalInformationGenerator::KEY_QUESTION_ORDER => $this->questions
                     ]
                 )
             );
         }
     }

Here is the call graph for this function:

◆ onMarkSchemaSaved()

ilObjTest::onMarkSchemaSaved ( )

Definition at line 3986 of file class.ilObjTest.php.

References participantDataExist(), recalculateScores(), and saveCompleteStatus().

                                        : void
     {
         $this->saveCompleteStatus($this->question_set_config_factory->getQuestionSetConfig());
 
         if ($this->participantDataExist()) {
             $this->recalculateScores(true);
         }
     }

Here is the call graph for this function:

◆ participantDataExist()

ilObjTest::participantDataExist ( )

Definition at line 7072 of file class.ilObjTest.php.

References $participantDataExist, evalTotalPersons(), and null.

Referenced by onMarkSchemaSaved().

                                           : bool
     {
         if ($this->participantDataExist === null) {
             $this->participantDataExist = (bool) $this->evalTotalPersons();
         }
 
         return $this->participantDataExist;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pcArrayShuffle()

ilObjTest::pcArrayShuffle ( $array )

Shuffles the values of a given array.

Parameters

array $array An array which should be shuffled public

Definition at line 1771 of file class.ilObjTest.php.

                                           : array
     {
         $keys = array_keys($array);
         shuffle($keys);
         $result = [];
         foreach ($keys as $key) {
             $result[$key] = $array[$key];
         }
         return $result;
     }

◆ prepareTextareaOutput()

ilObjTest::prepareTextareaOutput	(	$txt_output,
		$prepare_for_latex_output = `false`,
		$omitNl2BrWhenTextArea = `false`
	)

Prepares a string for a text area output in tests.

Parameters

string $txt_output String which should be prepared for output public

Definition at line 5530 of file class.ilObjTest.php.

References null, and ilLegacyFormElementsUtil\prepareTextareaOutput().

     {
         if ($txt_output == null) {
             $txt_output = '';
         }
         return ilLegacyFormElementsUtil::prepareTextareaOutput(
             $txt_output,
             $prepare_for_latex_output,
             $omitNl2BrWhenTextArea
         );
     }

Here is the call graph for this function:

◆ processPrintoutput2FO()

ilObjTest::processPrintoutput2FO ( $print_output )

Convert a print output to XSL-FO.

Parameters

string $print_output The print output

Returns: string XSL-FO code public

Definition at line 5967 of file class.ilObjTest.php.

References $params, null, and ILIAS\Repository\settings().

Referenced by deliverPDFfromHTML().

                                                         : string
     {
         if (extension_loaded("tidy")) {
             $config = [
                 "indent" => false,
                 "output-xml" => true,
                 "numeric-entities" => true
             ];
             $tidy = new tidy();
             $tidy->parseString($print_output, $config, 'utf8');
             $tidy->cleanRepair();
             $print_output = tidy_get_output($tidy);
             $print_output = preg_replace("/^.*?(<html)/", "\\1", $print_output);
         } else {
             $print_output = str_replace("&nbsp;", "&#160;", $print_output);
             $print_output = str_replace("&otimes;", "X", $print_output);
         }
         $xsl = file_get_contents("./components/ILIAS/Test/xml/question2fo.xsl");
 
         // additional font support
 
         $xsl = str_replace(
             'font-family="Helvetica, unifont"',
             'font-family="' . $this->settings->get('rpc_pdf_font', 'Helvetica, unifont') . '"',
             $xsl
         );
 
         $args = [ '/_xml' => $print_output, '/_xsl' => $xsl ];
         $xh = xslt_create();
         $params = [];
         $output = xslt_process($xh, "arg:/_xml", "arg:/_xsl", null, $args, $params);
         xslt_error($xh);
         xslt_free($xh);
         return $output;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ qtiMaterialToArray()

ilObjTest::qtiMaterialToArray ( $a_material )

Reads an QTI material tag and creates a text string.

Returns: string text or xhtml string public

Definition at line 5448 of file class.ilObjTest.php.

References ilSession\get(), and ILIAS\Repository\logger().

Referenced by fromXML().

                                                    : array
     {
         $result = '';
         $mobs = [];
         for ($i = 0; $i < $a_material->getMaterialCount(); $i++) {
             $material = $a_material->getMaterial($i);
             if ($material['type'] === 'mattext') {
                 $result .= $material['material']->getContent();
             }
             if ($material['type'] === 'matimage') {
                 $matimage = $material['material'];
                 if (preg_match('/(il_([0-9]+)_mob_([0-9]+))/', $matimage->getLabel(), $matches)) {
                     $mobs[] = [
                         'mob' => $matimage->getLabel(),
                         'uri' => $matimage->getUri()
                     ];
                 }
             }
         }
 
         $decoded_result = base64_decode($result);
         if (str_starts_with($decoded_result, '<PageObject>')) {
             $result = $decoded_result;
         }
 
         $this->logger->info(print_r(ilSession::get('import_mob_xhtml'), true));
         return [
             'text' => $result,
             'mobs' => $mobs
         ];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ questionMoveDown()

ilObjTest::questionMoveDown ( $question_id )

Moves a question down in order.

Parameters

integer $question_id The database id of the question to be moved down public

See also: $test_id

Definition at line 1313 of file class.ilObjTest.php.

References getTestId(), and loadQuestions().

     {
         $current_question_result = $this->db->queryF(
             "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
             ['integer','integer'],
             [$this->getTestId(), $question_id]
         );
         $current_question_data = $this->db->fetchObject($current_question_result);
         $next_question_result = $this->db->queryF(
             "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
             ['integer','integer'],
             [$this->getTestId(), $current_question_data->sequence + 1]
         );
         if ($this->db->numRows($next_question_result) === 1) {
             // OK, it's not the last question, so move it down
             $next_question_data = $this->db->fetchObject($next_question_result);
             // change next dataset
             $this->db->manipulateF(
                 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                 ['integer','integer'],
                 [$current_question_data->sequence, $next_question_data->test_question_id]
             );
             // move actual dataset down
             $this->db->manipulateF(
                 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                 ['integer','integer'],
                 [$current_question_data->sequence + 1, $current_question_data->test_question_id]
             );
         }
         $this->loadQuestions();
     }

Here is the call graph for this function:

◆ questionMoveUp()

ilObjTest::questionMoveUp ( $question_id )

Moves a question up in order.

Parameters

integer $question_id The database id of the question to be moved up public

See also: $test_id

Definition at line 1273 of file class.ilObjTest.php.

References $data, getTestId(), and loadQuestions().

     {
         // Move a question up in sequence
         $result = $this->db->queryF(
             "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
             ['integer', 'integer'],
             [$this->getTestId(), $question_id]
         );
         $data = $this->db->fetchObject($result);
         if ($data->sequence > 1) {
             // OK, it's not the top question, so move it up
             $result = $this->db->queryF(
                 "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
                 ['integer','integer'],
                 [$this->getTestId(), $data->sequence - 1]
             );
             $data_previous = $this->db->fetchObject($result);
             // change previous dataset
             $this->db->manipulateF(
                 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                 ['integer','integer'],
                 [$data->sequence, $data_previous->test_question_id]
             );
             // move actual dataset up
             $this->db->manipulateF(
                 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                 ['integer','integer'],
                 [$data->sequence - 1, $data->test_question_id]
             );
         }
         $this->loadQuestions();
     }

Here is the call graph for this function:

◆ read()

ilObjTest::read ( )

Definition at line 257 of file class.ilObjTest.php.

References loadFromDb(), and null.

                           : void
     {
         parent::read();
         $this->main_settings = null;
         $this->score_settings = null;
         $this->mark_schema = null;
         $this->loadFromDb();
     }

Here is the call graph for this function:

◆ recalculateScores()

ilObjTest::recalculateScores ( $preserve_manscoring = false )

Definition at line 7081 of file class.ilObjTest.php.

References ilLPStatusWrapper\_updateStatus(), ilObject\getId(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Referenced by onMarkSchemaSaved().

     {
         $scoring = new TestScoring($this, $this->user, $this->db, $this->lng);
         $scoring->setPreserveManualScores($preserve_manscoring);
         $scoring->recalculateSolutions();
         ilLPStatusWrapper::_updateStatus($this->getId(), $this->user->getId());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reindexFixedQuestionOrdering()

ilObjTest::reindexFixedQuestionOrdering ( )

Definition at line 6581 of file class.ilObjTest.php.

References loadQuestions().

Referenced by removeQuestions(), and removeQuestionWithResults().

                                                   : ilTestReindexedSequencePositionMap
     {
         $question_set_config = $this->question_set_config_factory->getQuestionSetConfig();
         $reindexed_sequence_position_map = $question_set_config->reindexQuestionOrdering();
 
         $this->loadQuestions();
 
         return $reindexed_sequence_position_map;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeQuestion()

ilObjTest::removeQuestion ( int $question_id )

Definition at line 1104 of file class.ilObjTest.php.

References Vendor\Package\$e, ilObject\getRefId(), ILIAS\Repository\logger(), and ILIAS\Repository\user().

Referenced by removeQuestions(), and removeQuestionWithResults().

                                                     : void
     {
         try {
             $question = self::_instanciateQuestion($question_id);
             $question_title = $question->getTitleForHTMLOutput();
             $question->delete($question_id);
             if ($this->logger->isLoggingEnabled()) {
                 $this->logger->logTestAdministrationInteraction(
                     $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                         $this->getRefId(),
                         $this->user->getId(),
                         TestAdministrationInteractionTypes::QUESTION_REMOVED,
                         [
                             AdditionalInformationGenerator::KEY_QUESTION_TITLE => $question_title
                         ]
                     )
                 );
             }
         } catch (InvalidArgumentException $e) {
             $this->logger->error($e->getMessage());
             $this->logger->error($e->getTraceAsString());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeQuestionFromSequences()

ilObjTest::removeQuestionFromSequences	(	int	$question_id,
		array	$active_ids,
		ilTestReindexedSequencePositionMap	$reindexed_sequence_position_map
	)

Parameters

array<int> $active_ids

Definition at line 1067 of file class.ilObjTest.php.

References $test_sequence.

Referenced by removeQuestionWithResults().

      : void {
         $test_sequence_factory = new ilTestSequenceFactory(
             $this,
             $this->db,
             $this->questionrepository
         );
 
         foreach ($active_ids as $active_id) {
             $passSelector = new ilTestPassesSelector($this->db, $this);
             $passSelector->setActiveId($active_id);
 
             foreach ($passSelector->getExistingPasses() as $pass) {
                 $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $pass);
                 $test_sequence->loadFromDb();
 
                 $test_sequence->removeQuestion($question_id, $reindexed_sequence_position_map);
                 $test_sequence->saveToDb();
             }
         }
     }

Here is the caller graph for this function:

◆ removeQuestions()

ilObjTest::removeQuestions ( array $question_ids )

Parameters

array<int> $question_ids

Definition at line 1095 of file class.ilObjTest.php.

References reindexFixedQuestionOrdering(), and removeQuestion().

                                                         : void
     {
         foreach ($question_ids as $question_id) {
             $this->removeQuestion((int) $question_id);
         }
 
         $this->reindexFixedQuestionOrdering();
     }

Here is the call graph for this function:

◆ removeQuestionsWithResults()

ilObjTest::removeQuestionsWithResults ( array $question_ids )

Definition at line 1002 of file class.ilObjTest.php.

References ILIAS\Repository\lng(), removeQuestionWithResults(), and ILIAS\Repository\user().

                                                                    : void
     {
         $scoring = new TestScoring(
             $this,
             $this->user,
             $this->db,
             $this->lng
         );
 
         array_walk(
             $question_ids,
             fn(int $v, int $k) => $this->removeQuestionWithResults($v, $scoring)
         );
     }

Here is the call graph for this function:

◆ removeQuestionWithResults()

ilObjTest::removeQuestionWithResults	(	int	$question_id,
		TestScoring	$scoring
	)

private

Definition at line 1017 of file class.ilObjTest.php.

References ilObject\$object_properties, ilLPStatusWrapper\_refreshStatus(), ilObject\getId(), ilObject\getObjectProperties(), ilObjectProperties\getPropertyIsOnline(), ilObject\getRefId(), getTestQuestions(), assQuestion\instantiateQuestion(), isRandomTest(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), reindexFixedQuestionOrdering(), ILIAS\Test\Scoring\Manual\TestScoring\removeAllQuestionResults(), removeQuestion(), removeQuestionFromSequences(), ilObjectProperties\storePropertyIsOnline(), ILIAS\Test\Scoring\Manual\TestScoring\updatePassAndTestResults(), and ILIAS\Repository\user().

Referenced by removeQuestionsWithResults().

                                                                                       : void
     {
         $question = \assQuestion::instantiateQuestion($question_id);
 
         $participant_data = new ilTestParticipantData($this->db, $this->lng);
         $participant_data->load($this->test_id);
 
         $question->removeAllExistingSolutions();
         $scoring->removeAllQuestionResults($question_id);
 
         $this->removeQuestion($question_id);
         if (!$this->isRandomTest()) {
             $this->removeQuestionFromSequences(
                 $question_id,
                 $participant_data->getActiveIds(),
                 $this->reindexFixedQuestionOrdering()
             );
         }
 
         $scoring->updatePassAndTestResults($participant_data->getActiveIds());
         ilLPStatusWrapper::_refreshStatus($this->getId(), $participant_data->getUserIds());
         $question->delete($question_id);
 
         if ($this->getTestQuestions() === []) {
             $object_properties = $this->getObjectProperties();
             $object_properties->storePropertyIsOnline(
                 $object_properties->getPropertyIsOnline()->withOffline()
             );
         }
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::QUESTION_REMOVED_IN_CORRECTIONS,
                     [
                         AdditionalInformationGenerator::KEY_QUESTION_TITLE => $question->getTitleForHTMLOutput(),
                         AdditionalInformationGenerator::KEY_QUESTION_TEXT => $question->getQuestion(),
                         AdditionalInformationGenerator::KEY_QUESTION_ID => $question->getId(),
                         AdditionalInformationGenerator::KEY_QUESTION_TYPE => $question->getQuestionType()
                     ]
                 )
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTestActives()

ilObjTest::removeTestActives ( array $active_ids )

Parameters

array<int> $active_ids

Definition at line 1260 of file class.ilObjTest.php.

Referenced by removeTestResults(), removeTestResultsFromSoapLpAdministration(), and ilCourseObjectiveResult\resetTestForUser().

                                                         : void
     {
         $IN_activeIds = $this->db->in('active_id', $active_ids, false, 'integer');
         $this->db->manipulate("DELETE FROM tst_active WHERE $IN_activeIds");
     }

Here is the caller graph for this function:

◆ removeTestResults()

ilObjTest::removeTestResults ( ilTestParticipantData $participant_data )

Definition at line 1161 of file class.ilObjTest.php.

References ilTestParticipantData\getActiveIds(), ilTestParticipantData\getAnonymousActiveIds(), ilObject\getId(), ilObjectLP\getInstance(), ilObject\getRefId(), getTestId(), ilTestParticipantData\getUserIdByActiveId(), ilTestParticipantData\getUserIds(), ILIAS\Repository\logger(), removeTestActives(), removeTestResultsByActiveIds(), and ILIAS\Repository\user().

Referenced by deleteTest().

                                                                               : void
     {
         if ($participant_data->getAnonymousActiveIds() !== []) {
             $this->removeTestResultsByActiveIds($participant_data->getAnonymousActiveIds());
 
             $user_ids = array_map(
                 static fn($active_id) => $participant_data->getUserIdByActiveId($active_id),
                 $participant_data->getAnonymousActiveIds(),
             );
             $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $user_ids);
         }
 
         if ($participant_data->getUserIds() !== []) {
             /* @var ilTestLP $testLP */
             $test_lp = ilObjectLP::getInstance($this->getId());
             if ($test_lp instanceof ilTestLP) {
                 $test_lp->setTestObject($this);
                 $test_lp->resetLPDataForUserIds($participant_data->getUserIds(), false);
             }
 
             $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $participant_data->getUserIds());
         }
 
         if ($participant_data->getActiveIds() !== []) {
             $this->removeTestActives($participant_data->getActiveIds());
 
             $user_ids = array_map(
                 static fn($active_id) => $participant_data->getUserIdByActiveId($active_id),
                 $participant_data->getActiveIds(),
             );
             $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $user_ids);
         }
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::PARTICIPANT_DATA_REMOVED,
                     [
                         AdditionalInformationGenerator::KEY_USERS => $participant_data->getUserIds(),
                         AdditionalInformationGenerator::KEY_ANON_IDS => $participant_data->getAnonymousActiveIds()
                     ]
                 )
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTestResultsByActiveIds()

ilObjTest::removeTestResultsByActiveIds ( array $active_ids )

private

Definition at line 1227 of file class.ilObjTest.php.

References CLIENT_WEB_DIR, ilFileUtils\delDir(), ilAssQuestionHintTracking\deleteRequestsByActiveIds(), getTestId(), isRandomTest(), and PassPresentedVariablesRepo\TABLE_NAME.

Referenced by removeTestResults(), and removeTestResultsByUserIds().

                                                                     : void
     {
         $in_active_ids = $this->db->in('active_fi', $active_ids, false, 'integer');
 
         $this->db->manipulate("DELETE FROM tst_solutions WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_qst_solved WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_test_result WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_pass_result WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_result_cache WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_sequence WHERE {$in_active_ids}");
         $this->db->manipulate("DELETE FROM tst_times WHERE {$in_active_ids}");
         $this->db->manipulate(
             'DELETE FROM ' . PassPresentedVariablesRepo::TABLE_NAME
             . ' WHERE ' . $this->db->in('active_id', $active_ids, false, 'integer')
         );
 
         if ($this->isRandomTest()) {
             $this->db->manipulate("DELETE FROM tst_test_rnd_qst WHERE {$in_active_ids}");
         }
 
         foreach ($active_ids as $active_id) {
             // remove file uploads
             if (is_dir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id")) {
                 ilFileUtils::delDir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id");
             }
         }
 
         ilAssQuestionHintTracking::deleteRequestsByActiveIds($active_ids);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTestResultsByUserIds()

ilObjTest::removeTestResultsByUserIds ( array $user_ids )

Definition at line 1209 of file class.ilObjTest.php.

References getTestId(), ILIAS\Repository\lng(), and removeTestResultsByActiveIds().

Referenced by removeTestResultsFromSoapLpAdministration().

                                                                : void
     {
         $participantData = new ilTestParticipantData($this->db, $this->lng);
         $participantData->setUserIdsFilter($user_ids);
         $participantData->load($this->getTestId());
 
         $in_user_ids = $this->db->in('usr_id', $participantData->getUserIds(), false, 'integer');
         $this->db->manipulateF(
             "DELETE FROM usr_pref WHERE {$in_user_ids} AND keyword = %s",
             ['text'],
             ['tst_password_' . $this->getTestId()]
         );
 
         if ($participantData->getActiveIds() !== []) {
             $this->removeTestResultsByActiveIds($participantData->getActiveIds());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTestResultsFromSoapLpAdministration()

ilObjTest::removeTestResultsFromSoapLpAdministration ( array $user_ids )

at the time beeing ilObjTest::removeTestResults needs to call the LP service for deletion
ilTestLP calls ilObjTest::removeTestResultsByUserIds

this method should only be used from non refactored soap context i think

Parameters

$userIds

Definition at line 1136 of file class.ilObjTest.php.

References ilObject\getRefId(), getTestId(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), removeTestActives(), removeTestResultsByUserIds(), and ILIAS\Repository\user().

     {
         $this->removeTestResultsByUserIds($user_ids);
 
         $participantData = new ilTestParticipantData($this->db, $this->lng);
         $participantData->setUserIdsFilter($user_ids);
         $participantData->load($this->getTestId());
 
         $this->removeTestActives($participantData->getActiveIds());
 
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::PARTICIPANT_DATA_REMOVED,
                     [
                         AdditionalInformationGenerator::KEY_USERS => $participantData->getUserIds()
                     ]
                 )
             );
         }
     }

Here is the call graph for this function:

◆ replaceFilesInPageImports()

ilObjTest::replaceFilesInPageImports	(	string	$text,
		array	$mappings
	)

private

Definition at line 3327 of file class.ilObjTest.php.

Referenced by addConcludingRemarksToSettingsFromImport(), and addIntroductionToSettingsFromImport().

                                                                              : string
     {
         preg_match_all('/il_(\d+)_file_(\d+)/', $text, $matches);
         foreach ($matches[0] as $index => $match) {
             if (empty($mappings[$matches[2][$index]])) {
                 continue;
             }
             $text = str_replace($match, "il__file_{$mappings[$matches[2][$index]]}", $text);
         }
         return $text;
     }

Here is the caller graph for this function:

◆ replaceMobsInPageImports()

ilObjTest::replaceMobsInPageImports	(	string	$text,
		array	$mappings
	)

private

Definition at line 3314 of file class.ilObjTest.php.

References ilObjMediaObject\_saveUsage(), and ilObject\getId().

Referenced by addConcludingRemarksToSettingsFromImport(), and addIntroductionToSettingsFromImport().

                                                                             : string
     {
         preg_match_all('/il_(\d+)_mob_(\d+)/', $text, $matches);
         foreach ($matches[0] as $index => $match) {
             if (empty($mappings[$matches[2][$index]])) {
                 continue;
             }
             $text = str_replace($match, "il__mob_{$mappings[$matches[2][$index]]}", $text);
             ilObjMediaObject::_saveUsage((int) $mappings[$matches[2][$index]], 'tst', $this->getId());
         }
         return $text;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ retrieveMobsFromLegacyImports()

ilObjTest::retrieveMobsFromLegacyImports	(	string	$text,
		array	$mobs,
		string	$importdir
	)

private

Definition at line 3339 of file class.ilObjTest.php.

References ilRTE\_replaceMediaObjectImageSrc(), ilObjMediaObject\_saveTempFileAsMediaObject(), ilObjMediaObject\_saveUsage(), ilObject\getId(), and IL_INST_ID.

Referenced by addConcludingRemarksToSettingsFromImport(), and addIntroductionToSettingsFromImport().

                                                                                                 : string
     {
         foreach ($mobs as $mob) {
             $importfile = $importdir . DIRECTORY_SEPARATOR . $mob['uri'];
             if (file_exists($importfile)) {
                 $media_object = ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, false);
                 ilObjMediaObject::_saveUsage($media_object->getId(), 'tst:html', $this->getId());
                 $text = ilRTE::_replaceMediaObjectImageSrc(
                     str_replace(
                         'src="' . $mob['mob'] . '"',
                         'src="' . 'il_' . IL_INST_ID . '_mob_' . $media_object->getId() . '"',
                         $text
                     ),
                     1
                 );
             }
         }
         return $text;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAuthorToMetadata()

ilObjTest::saveAuthorToMetadata ( $author = "" )

Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be called for conversion of "old" tests where the author hasn't been stored in the lifecycle metadata.

Parameters

string $a_author A string containing the name of the test author private

See also: $author

Definition at line 4024 of file class.ilObjTest.php.

References ilObject\getId(), ilObject\getType(), and ILIAS\Repository\user().

Referenced by doCreateMetaData(), and fromXML().

     {
         $path_to_lifecycle = $this->lo_metadata->paths()->custom()->withNextStep('lifeCycle')->get();
         $path_to_authors = $this->lo_metadata->paths()->authors();
 
         $reader = $this->lo_metadata->read($this->getId(), 0, $this->getType(), $path_to_lifecycle);
         if (!is_null($reader->allData($path_to_lifecycle)->current())) {
             return;
         }
 
         if ($author === '') {
             $author = $this->user->getFullname();
         }
         $this->lo_metadata->manipulate($this->getId(), 0, $this->getType())
                           ->prepareCreateOrUpdate($path_to_authors, $author)
                           ->execute();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveCompleteStatus()

ilObjTest::saveCompleteStatus ( ilTestQuestionSetConfig $test_question_set_config )

Definition at line 439 of file class.ilObjTest.php.

References getTestId(), and isComplete().

Referenced by insertQuestion(), and onMarkSchemaSaved().

                                                                                          : void
     {
         $complete = 0;
         if ($this->isComplete($test_question_set_config)) {
             $complete = 1;
         }
         if ($this->getTestId() > 0) {
             $this->db->manipulateF(
                 'UPDATE tst_tests SET complete = %s WHERE test_id = %s',
                 ['text', 'integer'],
                 [$complete, $this->test_id]
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveManualFeedback()

ilObjTest::saveManualFeedback	(	int	$active_id,
		int	$question_id,
		int	$pass,
		?string	$feedback,
		bool	$finalized = `false`
	)

Definition at line 6148 of file class.ilObjTest.php.

References insertManualFeedback().

      : void {
         $feedback_old = self::getSingleManualFeedback($active_id, $question_id, $pass);
         $this->db->manipulateF(
             'DELETE FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s',
             ['integer', 'integer', 'integer'],
             [$active_id, $question_id, $pass]
         );
 
         $this->insertManualFeedback($active_id, $question_id, $pass, $feedback, $finalized, $feedback_old);
 
     }

Here is the call graph for this function:

◆ saveQuestionsToDb()

ilObjTest::saveQuestionsToDb ( )

Definition at line 539 of file class.ilObjTest.php.

References getTestId().

Referenced by moveQuestions(), and saveToDb().

                                        : void
     {
         $this->db->manipulateF(
             'DELETE FROM tst_test_question WHERE test_fi = %s',
             ['integer'],
             [$this->getTestId()]
         );
         foreach ($this->questions as $key => $value) {
             $next_id = $this->db->nextId('tst_test_question');
             $this->db->insert('tst_test_question', [
                 'test_question_id' => ['integer', $next_id],
                 'test_fi' => ['integer', $this->getTestId()],
                 'question_fi' => ['integer', $value],
                 'sequence' => ['integer', $key],
                 'tstamp' => ['integer', time()]
             ]);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

ilObjTest::saveToDb ( bool $properties_only = false )

Definition at line 454 of file class.ilObjTest.php.

References evalTotalPersons(), getActivationEndingTime(), getActivationStartingTime(), getActivationVisibility(), ilObject\getId(), getMarkSchema(), getNrOfTries(), getQuestionSetType(), getTemplate(), getTestId(), isActivationLimited(), null, saveQuestionsToDb(), and storeActivationSettings().

Referenced by applyDefaults(), and fromXML().

                                                            : void
     {
         if ($this->test_id === -1) {
             // Create new dataset
             $next_id = $this->db->nextId('tst_tests');
 
             $this->db->insert(
                 'tst_tests',
                 [
                     'test_id' => ['integer', $next_id],
                     'obj_fi' => ['integer', $this->getId()],
                     'created' => ['integer', time()],
                     'tstamp' => ['integer', time()],
                     'template_id' => ['integer', $this->getTemplate()]
                 ]
             );
 
             $this->test_id = $next_id;
         } else {
             if ($this->evalTotalPersons() > 0) {
                 // reset the finished status of participants if the nr of test passes did change
                 if ($this->getNrOfTries() > 0) {
                     // set all unfinished tests with nr of passes >= allowed passes finished
                     $aresult = $this->db->queryF(
                         "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries >= %s AND submitted = %s",
                         ['integer', 'integer', 'integer'],
                         [$this->getTestId(), $this->getNrOfTries(), 0]
                     );
                     while ($row = $this->db->fetchAssoc($aresult)) {
                         $this->db->manipulateF(
                             "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                             ['integer', 'timestamp', 'integer'],
                             [1, date('Y-m-d H:i:s'), $row["active_id"]]
                         );
                     }
 
                     // set all finished tests with nr of passes < allowed passes not finished
                     $aresult = $this->db->queryF(
                         "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries < %s AND submitted = %s",
                         ['integer', 'integer', 'integer'],
                         [$this->getTestId(), $this->getNrOfTries() - 1, 1]
                     );
                     while ($row = $this->db->fetchAssoc($aresult)) {
                         $this->db->manipulateF(
                             "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                             ['integer', 'timestamp', 'integer'],
                             [0, null, $row["active_id"]]
                         );
                     }
                 } else {
                     // set all finished tests with nr of passes >= allowed passes not finished
                     $aresult = $this->db->queryF(
                         "SELECT active_id FROM tst_active WHERE test_fi = %s AND submitted = %s",
                         ['integer', 'integer'],
                         [$this->getTestId(), 1]
                     );
                     while ($row = $this->db->fetchAssoc($aresult)) {
                         $this->db->manipulateF(
                             "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                             ['integer', 'timestamp', 'integer'],
                             [0, null, $row["active_id"]]
                         );
                     }
                 }
             }
         }
 
         $this->storeActivationSettings(
             $this->isActivationLimited(),
             $this->getActivationStartingTime(),
             $this->getActivationEndingTime(),
             $this->getActivationVisibility(),
         );
 
         if ($properties_only) {
             return;
         }
 
         if ($this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED) {
             $this->saveQuestionsToDb();
         }
 
         $this->marks_repository->storeMarkSchema($this->getMarkSchema());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ secondsToHoursMinutesSecondsString()

ilObjTest::secondsToHoursMinutesSecondsString ( int $seconds )

protected

Definition at line 6467 of file class.ilObjTest.php.

Referenced by getAggregatedResultsData().

                                                                        : string
     {
         $diff_hours = floor($seconds / 3600);
         $seconds -= $diff_hours * 3600;
         $diff_minutes = floor($seconds / 60);
         $seconds -= $diff_minutes * 60;
         return sprintf('%02d:%02d:%02d', $diff_hours, $diff_minutes, $seconds);
     }

Here is the caller graph for this function:

◆ sendAdvancedNotification()

ilObjTest::sendAdvancedNotification ( int $active_id )

Definition at line 6498 of file class.ilObjTest.php.

References $path, _getUserIdFromActiveId(), ANONYMOUS_USER_ID, ilObject\getOwner(), ilObject\getTitle(), and userLookupFullName().

                                                             : void
     {
         $mail = new ilTestMailNotification();
         $owner_id = $this->getOwner();
         $usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
 
         $path = $this->export_factory->getExporter(
             $this,
             ExportImportTypes::SCORED_ATTEMPT
         )->withFilterByActiveId($active_id)
             ->withResultsPage()
             ->withUserPages()
             ->write();
 
         $delivered_file_name = 'result_' . $active_id . '.xlsx';
         $fd = new ilFileDataMail(ANONYMOUS_USER_ID);
         $fd->copyAttachmentFile($path, $delivered_file_name);
         $file_names[] = $delivered_file_name;
 
         $mail->sendAdvancedNotification($owner_id, $this->getTitle(), $usr_data, $file_names);
 
         if (count($file_names)) {
             $fd->unlinkFiles($file_names);
             unset($fd);
             @unlink($path);
         }
     }

Here is the call graph for this function:

◆ sendSimpleNotification()

ilObjTest::sendSimpleNotification ( $active_id )

Definition at line 6490 of file class.ilObjTest.php.

References _getUserIdFromActiveId(), ilObject\getOwner(), ilObject\getTitle(), and userLookupFullName().

     {
         $mail = new ilTestMailNotification();
         $owner_id = $this->getOwner();
         $usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
         $mail->sendSimpleNotification($owner_id, $this->getTitle(), $usr_data);
     }

Here is the call graph for this function:

◆ setAccessFilteredParticipantList()

ilObjTest::setAccessFilteredParticipantList ( ilTestParticipantList $access_filtered_participant_list )

Definition at line 2462 of file class.ilObjTest.php.

References $access_filtered_participant_list.

                                                                                                              : void
     {
         $this->access_filtered_participant_list = $access_filtered_participant_list;
     }

◆ setActivationEndingTime()

ilObjTest::setActivationEndingTime ( ?int $ending_time = null )

Definition at line 6907 of file class.ilObjTest.php.

Referenced by fromXML(), and loadFromDb().

     {
         $this->activation_ending_time = $ending_time;
     }

Here is the caller graph for this function:

◆ setActivationLimited()

ilObjTest::setActivationLimited ( $a_value )

Definition at line 6709 of file class.ilObjTest.php.

Referenced by fromXML(), loadFromDb(), and storeActivationSettings().

     {
         $this->activation_limited = (bool) $a_value;
     }

Here is the caller graph for this function:

◆ setActivationStartingTime()

ilObjTest::setActivationStartingTime ( ?int $starting_time = null )

Definition at line 6902 of file class.ilObjTest.php.

Referenced by fromXML(), loadFromDb(), and storeActivationSettings().

     {
         $this->activation_starting_time = $starting_time;
     }

Here is the caller graph for this function:

◆ setActivationVisibility()

ilObjTest::setActivationVisibility ( $a_value )

Definition at line 6694 of file class.ilObjTest.php.

Referenced by fromXML(), loadFromDb(), and storeActivationSettings().

     {
         $this->activation_visibility = (bool) $a_value;
     }

Here is the caller graph for this function:

◆ setQuestionOrder()

ilObjTest::setQuestionOrder ( array $order )

Definition at line 6591 of file class.ilObjTest.php.

References $id, ilObject\getRefId(), loadQuestions(), ILIAS\Repository\logger(), and ILIAS\Repository\user().

     {
         asort($order);
 
         $i = 0;
 
         foreach (array_keys($order) as $id) {
             $i++;
 
             $query = "
                                 UPDATE          tst_test_question
                                 SET                     sequence = %s
                                 WHERE           question_fi = %s
                         ";
 
             $this->db->manipulateF(
                 $query,
                 ['integer', 'integer'],
                 [$i, $id]
             );
         }
 
         if ($this->logger->isLoggingEnabled()) {
             $this->logger->logTestAdministrationInteraction(
                 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
                     $this->getRefId(),
                     $this->user->getId(),
                     TestAdministrationInteractionTypes::QUESTION_MOVED,
                     [
                         AdditionalInformationGenerator::KEY_QUESTION_ORDER => $order
                     ]
                 )
             );
         }
 
         $this->loadQuestions();
     }

Here is the call graph for this function:

◆ setQuestionSetSolved()

ilObjTest::setQuestionSetSolved	(	$value,
		$question_id,
		$user_id
	)

sets question solved state to value for given user_id

Definition at line 4639 of file class.ilObjTest.php.

References $user_id, and getActiveIdOfUser().

     {
         $active_id = $this->getActiveIdOfUser($user_id);
         $this->db->manipulateF(
             "DELETE FROM tst_qst_solved WHERE active_fi = %s AND question_fi = %s",
             ['integer', 'integer'],
             [$active_id, $question_id]
         );
         $this->db->manipulateF(
             "INSERT INTO tst_qst_solved (solved, question_fi, active_fi) VALUES (%s, %s, %s)",
             ['integer', 'integer', 'integer'],
             [$value, $question_id, $active_id]
         );
     }

Here is the call graph for this function:

◆ setQuestionSetType()

ilObjTest::setQuestionSetType ( string $question_set_type )

Definition at line 7026 of file class.ilObjTest.php.

References getGeneralSettings(), and getMainSettings().

     {
         $this->main_settings = $this->getMainSettings()->withGeneralSettings(
             $this->getMainSettings()->getGeneralSettings()
                 ->withQuestionSetType($question_set_type)
         );
     }

Here is the call graph for this function:

◆ setTemplate()

ilObjTest::setTemplate ( int $template_id )

Definition at line 6571 of file class.ilObjTest.php.

References $template_id.

     {
         $this->template_id = $template_id;
     }

◆ setTestId()

ilObjTest::setTestId ( $a_id )

Sets the test ID.

Parameters

integer $a_id Test ID

Definition at line 6244 of file class.ilObjTest.php.

Referenced by loadFromDb().

     {
         $this->test_id = $a_id;
     }

Here is the caller graph for this function:

◆ setTmpCopyWizardCopyId()

ilObjTest::setTmpCopyWizardCopyId ( int $tmpCopyWizardCopyId )

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

References $tmpCopyWizardCopyId.

                                                                     : void
     {
         $this->tmpCopyWizardCopyId = $tmpCopyWizardCopyId;
     }

◆ startingTimeReached()

ilObjTest::startingTimeReached ( )

Returns true if the starting time of a test is reached A starting time is not available for self assessment tests.

Returns: boolean true if the starting time is reached, otherwise false public

Definition at line 2780 of file class.ilObjTest.php.

References getStartingTime(), and isStartingTimeEnabled().

Referenced by isExecutable().

                                          : bool
     {
         if ($this->isStartingTimeEnabled() && $this->getStartingTime() != 0) {
             $now = time();
             if ($now < $this->getStartingTime()) {
                 return false;
             }
         }
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startWorkingTime()

ilObjTest::startWorkingTime	(	$active_id,
		$pass
	)

Write the initial entry for the tests working time to the database.

Parameters

integer $user_id The database id of the user working with the test public

Definition at line 1585 of file class.ilObjTest.php.

     {
         $next_id = $this->db->nextId('tst_times');
         $affectedRows = $this->db->manipulateF(
             "INSERT INTO tst_times (times_id, active_fi, started, finished, pass, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
             ['integer', 'integer', 'timestamp', 'timestamp', 'integer', 'integer'],
             [$next_id, $active_id, date("Y-m-d H:i:s"), date("Y-m-d H:i:s"), $pass, time()]
         );
         return $next_id;
     }

◆ storeActivationSettings()

ilObjTest::storeActivationSettings	(	?bool	$is_activation_limited = `false`,
		?int	$activation_starting_time = `null`,
		?int	$activation_ending_time = `null`,
		bool	$activation_visibility = `false`
	)

Definition at line 6714 of file class.ilObjTest.php.

References setActivationLimited(), setActivationStartingTime(), setActivationVisibility(), ilObjectActivation\TIMINGS_ACTIVATION, and ilObjectActivation\TIMINGS_DEACTIVATED.

Referenced by applyDefaults(), and saveToDb().

      : void {
         if (!$this->ref_id) {
             return;
         }
 
         $item = new ilObjectActivation();
         $is_activation_limited ??= false;
 
         if (!$is_activation_limited) {
             $item->setTimingType(ilObjectActivation::TIMINGS_DEACTIVATED);
         } else {
             $item->setTimingType(ilObjectActivation::TIMINGS_ACTIVATION);
             $item->setTimingStart($activation_starting_time);
             $item->setTimingEnd($activation_ending_time);
             $item->toggleVisible($activation_visibility);
         }
 
         $item->update($this->ref_id);
 
         $this->setActivationLimited($is_activation_limited);
         $this->setActivationStartingTime($activation_starting_time);
         $this->setActivationStartingTime($activation_ending_time);
         $this->setActivationVisibility($activation_visibility);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ storeMarkSchema()

ilObjTest::storeMarkSchema ( MarkSchema $mark_schema )

Definition at line 845 of file class.ilObjTest.php.

References null.

                                                             : void
     {
         $this->marks_repository->storeMarkSchema($mark_schema);
         $this->mark_schema = null;
     }

◆ toXML()

ilObjTest::toXML ( )

Returns a QTI xml representation of the test.

Returns: string The QTI xml representation of the test

Definition at line 3364 of file class.ilObjTest.php.

                            : string
     {
         $main_settings = $this->getMainSettings();
         $a_xml_writer = new ilXmlWriter();
         // set xml header
         $a_xml_writer->xmlHeader();
         $a_xml_writer->xmlSetDtdDef("<!DOCTYPE questestinterop SYSTEM \"ims_qtiasiv1p2p1.dtd\">");
         $a_xml_writer->xmlStartTag("questestinterop");
 
         $attrs = [
             "ident" => "il_" . IL_INST_ID . "_tst_" . $this->getTestId(),
             "title" => $this->getTitle()
         ];
         $a_xml_writer->xmlStartTag("assessment", $attrs);
         $a_xml_writer->xmlElement("qticomment", null, $this->getDescription());
 
         if ($main_settings->getTestBehaviourSettings()->getProcessingTimeEnabled()) {
             $a_xml_writer->xmlElement(
                 "duration",
                 null,
                 $this->getProcessingTimeForXML()
             );
         }
 
         $a_xml_writer->xmlStartTag("qtimetadata");
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "ILIAS_VERSION");
         $a_xml_writer->xmlElement("fieldentry", null, ILIAS_VERSION);
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "anonymity");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getGeneralSettings()->getAnonymity()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "question_set_type");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getGeneralSettings()->getQuestionSetType());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "sequence_settings");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "author");
         $a_xml_writer->xmlElement("fieldentry", null, $this->getAuthor());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "reset_processing_time");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getResetProcessingTime());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "count_system");
         $a_xml_writer->xmlElement("fieldentry", null, $this->getCountSystem());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "score_cutting");
         $a_xml_writer->xmlElement("fieldentry", null, $this->getScoreCutting());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "password");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getPassword() ?? '');
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "ip_range_from");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getIpRangeFrom());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "ip_range_to");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getIpRangeTo());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "pass_scoring");
         $a_xml_writer->xmlElement("fieldentry", null, $this->getPassScoring());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag('qtimetadatafield');
         $a_xml_writer->xmlElement('fieldlabel', null, 'pass_deletion_allowed');
         $a_xml_writer->xmlElement('fieldentry', null, (int) $this->isPassDeletionAllowed());
         $a_xml_writer->xmlEndTag('qtimetadatafield');
 
         if ($this->getScoreSettings()->getResultSummarySettings()->getReportingDate() !== null) {
             $a_xml_writer->xmlStartTag("qtimetadatafield");
             $a_xml_writer->xmlElement("fieldlabel", null, "reporting_date");
             $a_xml_writer->xmlElement(
                 "fieldentry",
                 null,
                 $this->buildIso8601PeriodForExportCompatibility(
                     $this->getScoreSettings()->getResultSummarySettings()->getReportingDate(),
                 ),
             );
             $a_xml_writer->xmlEndTag("qtimetadatafield");
         }
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "nr_of_tries");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getTestBehaviourSettings()->getNumberOfTries()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag('qtimetadatafield');
         $a_xml_writer->xmlElement('fieldlabel', null, 'block_after_passed');
         $a_xml_writer->xmlElement('fieldentry', null, (int) $main_settings->getTestBehaviourSettings()->getBlockAfterPassedEnabled());
         $a_xml_writer->xmlEndTag('qtimetadatafield');
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "pass_waiting");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getPassWaiting());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "kiosk");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getTestBehaviourSettings()->getKioskMode()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag('qtimetadatafield');
         $a_xml_writer->xmlElement("fieldlabel", null, "redirection_mode");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getRedirectionMode());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag('qtimetadatafield');
         $a_xml_writer->xmlElement("fieldlabel", null, "redirection_url");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getRedirectionUrl());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "use_previous_answers");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getParticipantFunctionalitySettings()->getUsePreviousAnswerAllowed());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "title_output");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getQuestionBehaviourSettings()->getQuestionTitleOutputMode()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "results_presentation");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getScoreSettings()->getResultDetailsSettings()->getResultsPresentation()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_pass");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getTestBehaviourSettings()->getExamIdInTestAttemptEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_res");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getScoreSettings()->getResultDetailsSettings()->getShowExamIdInTestResults()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "usr_pass_overview_mode");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $main_settings->getParticipantFunctionalitySettings()->getUsrPassOverviewMode()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "score_reporting");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getScoreSettings()->getResultSummarySettings()->getScoreReporting()->value));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_solution_list_comparison");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->score_settings->getResultDetailsSettings()->getShowSolutionListComparison());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "instant_verification");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSolutionEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackGenericEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_specific");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback_points");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackPointsEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "follow_qst_answer_fixation");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnNextQuestionEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "force_instant_feedback");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getForceInstantFeedbackOnNextQuestion());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $highscore_metadata = [
             'highscore_enabled' => ['value' => $this->getHighscoreEnabled()],
             'highscore_anon' => ['value' => $this->getHighscoreAnon()],
             'highscore_achieved_ts' => ['value' => $this->getHighscoreAchievedTS()],
             'highscore_score' => ['value' => $this->getHighscoreScore()],
             'highscore_percentage' => ['value' => $this->getHighscorePercentage()],
             'highscore_hints' => ['value' => $this->getHighscoreHints()],
             'highscore_wtime' => ['value' => $this->getHighscoreWTime()],
             'highscore_own_table' => ['value' => $this->getHighscoreOwnTable()],
             'highscore_top_table' => ['value' => $this->getHighscoreTopTable()],
             'highscore_top_num' => ['value' => $this->getHighscoreTopNum()],
         ];
         foreach ($highscore_metadata as $label => $data) {
             $a_xml_writer->xmlStartTag("qtimetadatafield");
             $a_xml_writer->xmlElement("fieldlabel", null, $label);
             $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $data['value']));
             $a_xml_writer->xmlEndTag("qtimetadatafield");
         }
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "suspend_test_allowed");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getParticipantFunctionalitySettings()->getSuspendTestAllowed()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_marker");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getParticipantFunctionalitySettings()->getQuestionMarkingEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "fixed_participants");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getAccessSettings()->getFixedParticipants()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_introduction");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getIntroductionSettings()->getIntroductionEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_concluding_remarks");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getFinishingSettings()->getConcludingRemarksEnabled()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "mailnotification");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getMailNotificationContentType());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "mailnottype");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getFinishingSettings()->getAlwaysSendMailNotification());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "exportsettings");
         $a_xml_writer->xmlElement("fieldentry", null, $this->getExportSettings());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "shuffle_questions");
         $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (int) $main_settings->getQuestionBehaviourSettings()->getShuffleQuestions()));
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "processing_time");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getProcessingTime());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "enable_examview");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getFinishingSettings()->getShowAnswerOverview());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "skill_service");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getAdditionalSettings()->getSkillsServiceEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         if ($this->getInstantFeedbackSolution() == 1) {
             $attrs = [
                 "solutionswitch" => "Yes"
             ];
         } else {
             $attrs = null;
         }
         $a_xml_writer->xmlElement("assessmentcontrol", $attrs, null);
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_grading_status");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isShowGradingStatusEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "show_grading_mark");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isShowGradingMarkEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         if ($this->getStartingTime() > 0) {
             $a_xml_writer->xmlStartTag("qtimetadatafield");
             $a_xml_writer->xmlElement("fieldlabel", null, "starting_time");
             $a_xml_writer->xmlElement(
                 "fieldentry",
                 null,
                 $this->buildIso8601PeriodForExportCompatibility(
                     (new DateTimeImmutable())->setTimestamp($this->getStartingTime()),
                 ),
             );
             $a_xml_writer->xmlEndTag("qtimetadatafield");
         }
 
         if ($this->getEndingTime() > 0) {
             $a_xml_writer->xmlStartTag("qtimetadatafield");
             $a_xml_writer->xmlElement("fieldlabel", null, "ending_time");
             $a_xml_writer->xmlElement(
                 "fieldentry",
                 null,
                 $this->buildIso8601PeriodForExportCompatibility(
                     (new DateTimeImmutable())->setTimestamp($this->getEndingTime()),
                 ),
             );
             $a_xml_writer->xmlEndTag("qtimetadatafield");
         }
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "activation_limited");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isActivationLimited());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "activation_start_time");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getActivationStartingTime());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "activation_end_time");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getActivationEndingTime());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "activation_visibility");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getActivationVisibility());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "autosave");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getAutosaveEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "autosave_ival");
         $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getAutosaveInterval());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "offer_question_hints");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getQuestionHintsEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_specific");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         $a_xml_writer->xmlStartTag("qtimetadatafield");
         $a_xml_writer->xmlElement("fieldlabel", null, "enable_processing_time");
         $a_xml_writer->xmlElement("fieldentry", null, (int) $main_settings->getTestBehaviourSettings()->getProcessingTimeEnabled());
         $a_xml_writer->xmlEndTag("qtimetadatafield");
 
         foreach ($this->getMarkSchema()->getMarkSteps() as $index => $mark) {
             $a_xml_writer->xmlStartTag("qtimetadatafield");
             $a_xml_writer->xmlElement("fieldlabel", null, "mark_step_$index");
             $a_xml_writer->xmlElement("fieldentry", null, sprintf(
                 "<short>%s</short><official>%s</official><percentage>%.2f</percentage><passed>%d</passed>",
                 $mark->getShortName(),
                 $mark->getOfficialName(),
                 $mark->getMinimumLevel(),
                 $mark->getPassed()
             ));
             $a_xml_writer->xmlEndTag("qtimetadatafield");
         }
         $a_xml_writer->xmlEndTag("qtimetadata");
 
         $page_id = $main_settings->getIntroductionSettings()->getIntroductionPageId();
         $introduction = $page_id !== null
             ? (new ilTestPage($page_id))->getXMLContent()
             : ilRTE::_replaceMediaObjectImageSrc($this->getIntroduction(), 0);
 
         $a_xml_writer->xmlStartTag("objectives");
         $this->addQTIMaterial($a_xml_writer, $page_id, $introduction);
         $a_xml_writer->xmlEndTag("objectives");
 
         if ($this->getInstantFeedbackSolution() == 1) {
             $attrs = [
                 "solutionswitch" => "Yes"
             ];
         } else {
             $attrs = null;
         }
         $a_xml_writer->xmlElement("assessmentcontrol", $attrs, null);
 
         if (strlen($this->getFinalStatement())) {
             $page_id = $main_settings->getFinishingSettings()->getConcludingRemarksPageId();
             $concluding_remarks = $page_id !== null
                 ? (new ilTestPage($page_id))->getXMLContent()
                 : ilRTE::_replaceMediaObjectImageSrc($this->getFinalStatement());
             // add qti presentation_material
             $a_xml_writer->xmlStartTag("presentation_material");
             $a_xml_writer->xmlStartTag("flow_mat");
             $this->addQTIMaterial($a_xml_writer, $page_id, $concluding_remarks);
             $a_xml_writer->xmlEndTag("flow_mat");
             $a_xml_writer->xmlEndTag("presentation_material");
         }
 
         $attrs = [
             "ident" => "1"
         ];
         $a_xml_writer->xmlElement("section", $attrs, null);
         $a_xml_writer->xmlEndTag("assessment");
         $a_xml_writer->xmlEndTag("questestinterop");
 
         $xml = $a_xml_writer->xmlDumpMem(false);
         return $xml;
     }

Here is the call graph for this function:

◆ update()

ilObjTest::update ( )

Definition at line 246 of file class.ilObjTest.php.

References ilObject\updateMetaData().

                             : bool
     {
         if (!parent::update()) {
             return false;
         }
 
         // put here object specific stuff
         $this->updateMetaData();
         return true;
     }

Here is the call graph for this function:

◆ updateTestPassResults()

ilObjTest::updateTestPassResults	(	int	$active_id,
		int	$pass,
		?ilAssQuestionProcessLocker	$process_locker = `null`,
		?int	$test_obj_id = `null`
	)

Definition at line 7435 of file class.ilObjTest.php.

References $data, buildExamId(), getQuestionCountAndPointsForPassOfParticipant(), getWorkingTimeOfParticipantForPass(), null, and updateTestResultCache().

      : array {
         $data = $this->getQuestionCountAndPointsForPassOfParticipant($active_id, $pass);
         $time = $this->getWorkingTimeOfParticipantForPass($active_id, $pass);
 
         $result = $this->db->queryF(
             '
                         SELECT          SUM(points) reachedpoints,
                                                 SUM(hint_count) hint_count,
                                                 SUM(hint_points) hint_points,
                                                 COUNT(DISTINCT(question_fi)) answeredquestions
                         FROM            tst_test_result
                         WHERE           active_fi = %s
                         AND                     pass = %s
                         ',
             ['integer','integer'],
             [$active_id, $pass]
         );
 
         if ($result->numRows() > 0) {
             $row = $this->db->fetchAssoc($result);
 
             if ($row['reachedpoints'] === null
                 || $row['reachedpoints'] < 0.0) {
                 $row['reachedpoints'] = 0.0;
             }
             if ($row['hint_count'] === null) {
                 $row['hint_count'] = 0;
             }
             if ($row['hint_points'] === null) {
                 $row['hint_points'] = 0.0;
             }
 
             $exam_identifier = ilObjTest::buildExamId($active_id, $pass, $test_obj_id);
 
             $update_pass_result_callback = function () use ($data, $active_id, $pass, $row, $time, $exam_identifier) {
                 $this->db->replace(
                     'tst_pass_result',
                     [
                         'active_fi' => ['integer', $active_id],
                         'pass' => ['integer', $pass]
                     ],
                     [
                         'points' => ['float', $row['reachedpoints']],
                         'maxpoints' => ['float', $data['points']],
                         'questioncount' => ['integer', $data['count']],
                         'answeredquestions' => ['integer', $row['answeredquestions']],
                         'workingtime' => ['integer', $time],
                         'tstamp' => ['integer', time()],
                         'hint_count' => ['integer', $row['hint_count']],
                         'hint_points' => ['float', $row['hint_points']],
                         'exam_id' => ['text', $exam_identifier]
                     ]
                 );
             };
 
             if (is_object($process_locker) && $process_locker instanceof ilAssQuestionProcessLocker) {
                 $process_locker->executeUserPassResultUpdateLockOperation($update_pass_result_callback);
             } else {
                 $update_pass_result_callback();
             }
         }
 
         $this->updateTestResultCache($active_id, $process_locker);
 
         return [
             'active_fi' => $active_id,
             'pass' => $pass,
             'points' => $row['reachedpoints'],
             'maxpoints' => $data['points'],
             'questioncount' => $data['count'],
             'answeredquestions' => $row['answeredquestions'],
             'workingtime' => $time,
             'tstamp' => time(),
             'hint_count' => $row['hint_count'],
             'hint_points' => $row['hint_points'],
             'exam_id' => $exam_identifier
         ];
     }

Here is the call graph for this function:

◆ updateTestResultCache()

ilObjTest::updateTestResultCache	(	int	$active_id,
		?ilAssQuestionProcessLocker	$process_locker = `null`
	)

Definition at line 7342 of file class.ilObjTest.php.

References $res, _getResultPass(), getMarkSchema(), ILIAS\Repository\int(), and null.

Referenced by getResultsForActiveId(), and updateTestPassResults().

                                                                                                              : void
     {
         $pass = ilObjTest::_getResultPass($active_id);
 
         if ($pass !== null) {
             $query = '
                 SELECT          tst_pass_result.*,
                             tst_active.last_finished_pass
                 FROM            tst_pass_result
                 INNER JOIN  tst_active
                 on          tst_pass_result.active_fi = tst_active.active_id
                 WHERE           active_fi = %s
                 AND                     pass = %s
             ';
 
             $result = $this->db->queryF(
                 $query,
                 ['integer','integer'],
                 [$active_id, $pass]
             );
 
             $test_pass_result_row = $this->db->fetchAssoc($result);
 
             if (!is_array($test_pass_result_row)) {
                 $test_pass_result_row = [];
             }
             $max = (float) ($test_pass_result_row['maxpoints'] ?? 0);
             $reached = (float) ($test_pass_result_row['points'] ?? 0);
             $percentage = ($max <= 0.0 || $reached <= 0.0) ? 0 : ($reached / $max) * 100.0;
 
             $mark = $this->getMarkSchema()->getMatchingMark($percentage);
             $is_passed = $pass <= $test_pass_result_row['last_finished_pass'] && $mark->getPassed();
 
             $hint_count = $test_pass_result_row['hint_count'] ?? 0;
             $hint_points = $test_pass_result_row['hint_points'] ?? 0.0;
 
             $user_test_result_update_callback = function () use ($active_id, $pass, $max, $reached, $is_passed, $hint_count, $hint_points, $mark) {
                 $passed_once_before = 0;
                 $query = 'SELECT passed_once FROM tst_result_cache WHERE active_fi = %s';
                 $res = $this->db->queryF($query, ['integer'], [$active_id]);
                 while ($passed_once_result_row = $this->db->fetchAssoc($res)) {
                     $passed_once_before = (int) $passed_once_result_row['passed_once'];
                 }
 
                 $passed_once = (int) ($is_passed || $passed_once_before);
 
                 $this->db->manipulateF(
                     'DELETE FROM tst_result_cache WHERE active_fi = %s',
                     ['integer'],
                     [$active_id]
                 );
 
                 if ($reached < 0.0) {
                     $reached = 0.0;
                 }
 
                 $mark_short_name = $mark->getShortName();
                 if ($mark_short_name === '') {
                     $mark_short_name = ' ';
                 }
 
                 $mark_official_name = $mark->getOfficialName();
                 if ($mark_official_name === '') {
                     $mark_official_name = ' ';
                 }
 
                 $this->db->insert(
                     'tst_result_cache',
                     [
                         'active_fi' => ['integer', $active_id],
                         'pass' => ['integer', $pass ?? 0],
                         'max_points' => ['float', $max],
                         'reached_points' => ['float', $reached],
                         'mark_short' => ['text', $mark_short_name],
                         'mark_official' => ['text', $mark_official_name],
                         'passed_once' => ['integer', $passed_once],
                         'passed' => ['integer', (int) $is_passed],
                         'failed' => ['integer', (int) !$is_passed],
                         'tstamp' => ['integer', time()],
                         'hint_count' => ['integer', $hint_count],
                         'hint_points' => ['float', $hint_points]
                     ]
                 );
             };
 
             if (is_object($process_locker)) {
                 $process_locker->executeUserTestResultUpdateLockOperation($user_test_result_update_callback);
             } else {
                 $user_test_result_update_callback();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateWorkingTime()

ilObjTest::updateWorkingTime ( $times_id )

Update the working time of a test when a question is answered.

Parameters

integer $times_id The database id of a working time entry public

Definition at line 1602 of file class.ilObjTest.php.

     {
         $affectedRows = $this->db->manipulateF(
             "UPDATE tst_times SET finished = %s, tstamp = %s WHERE times_id = %s",
             ['timestamp', 'integer', 'integer'],
             [date('Y-m-d H:i:s'), time(), $times_id]
         );
     }

◆ userLookupFullName()

ilObjTest::userLookupFullName	(	$user_id,
		$overwrite_anonymity = `false`,
		$sorted_order = `false`,
		$suffix = `""`
	)

Returns the full name of a test user according to the anonymity status.

Parameters

int	$user_id	The database ID of the user
boolean	$overwrite_anonymity	Indicates if the anonymity status should be ignored

Returns: string The full name of the user or UNKNOWN if the anonymity status is affected public

Deprecated:: : use ilTestParticipantData instead

Definition at line 5608 of file class.ilObjTest.php.

References $user_id, ilObjUser\_lookupName(), getAnonymity(), and ILIAS\Repository\lng().

Referenced by sendAdvancedNotification(), and sendSimpleNotification().

                                                                                                                    : string
     {
         if ($this->getAnonymity() && !$overwrite_anonymity) {
             return $this->lng->txt("anonymous") . $suffix;
         } else {
             $uname = ilObjUser::_lookupName($user_id);
             if (strlen($uname["firstname"] . $uname["lastname"]) == 0) {
                 $uname["firstname"] = $this->lng->txt("deleted_user");
             }
             if ($sorted_order) {
                 return trim($uname["lastname"] . ", " . $uname["firstname"]) . $suffix;
             } else {
                 return trim($uname["firstname"] . " " . $uname["lastname"]) . $suffix;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

int ilObjTest::$invitation = self::INVITATION_OFF

Definition at line 88 of file class.ilObjTest.php.

◆ $isSkillManagementGloballyActivated

ilObjTest::$isSkillManagementGloballyActivated = null

staticprivate

Definition at line 7142 of file class.ilObjTest.php.

ilTestParticipantAccessFilterFactory ilObjTest::$participant_access_filter

protected

Definition at line 129 of file class.ilObjTest.php.

◆ $participant_repository

ParticipantRepository ilObjTest::$participant_repository

protected

Definition at line 148 of file class.ilObjTest.php.

◆ $participantDataExist

ilObjTest::$participantDataExist = null

private

holds the fact wether participant data exists or not DO NOT USE TIS PROPERTY DRIRECTLY ALWAYS USE ilObjTest::paricipantDataExist() since this method initialises this property

Definition at line 120 of file class.ilObjTest.php.

Referenced by participantDataExist().

◆ $print_best_solution_with_result

bool ilObjTest::$print_best_solution_with_result = true

protected

Definition at line 109 of file class.ilObjTest.php.

◆ $question_set_config_factory

ilTestQuestionSetConfigFactory ilObjTest::$question_set_config_factory

protected

Definition at line 139 of file class.ilObjTest.php.

◆ $questionrepository

GeneralQuestionPropertiesRepository ilObjTest::$questionrepository

protected

Definition at line 83 of file class.ilObjTest.php.

Referenced by getGeneralQuestionPropertiesRepository().

◆ $questions

array ilObjTest::$questions = []

Definition at line 95 of file class.ilObjTest.php.

Referenced by getQuestions(), getTestQuestions(), and moveQuestions().

ilSetting ilObjTest::$settings

protected

Definition at line 127 of file class.ilObjTest.php.

◆ $template_id

int ilObjTest::$template_id = 0

private

Definition at line 107 of file class.ilObjTest.php.

Referenced by getTemplate(), and setTemplate().

◆ $test_id

int ilObjTest::$test_id = -1

Definition at line 87 of file class.ilObjTest.php.

Referenced by _getTestIDFromObjectID(), and getTestId().

◆ $test_man_scoring_done_helper

TestManScoringDoneHelper ilObjTest::$test_man_scoring_done_helper

private

Definition at line 124 of file class.ilObjTest.php.

◆ $test_sequence

ilObjTest::$test_sequence = false

contains the test sequence data

Definition at line 105 of file class.ilObjTest.php.

Referenced by getTestResult(), isParticipantsLastPassActive(), and removeQuestionFromSequences().

◆ $testrequest

RequestDataCollector ilObjTest::$testrequest

private

Definition at line 84 of file class.ilObjTest.php.

◆ $tmpCopyWizardCopyId

int ilObjTest::$tmpCopyWizardCopyId = null

private

Definition at line 122 of file class.ilObjTest.php.

Referenced by getTmpCopyWizardCopyId(), and setTmpCopyWizardCopyId().

◆ INVITATION_OFF

const ilObjTest::INVITATION_OFF = 0

Definition at line 70 of file class.ilObjTest.php.

◆ INVITATION_ON

const ilObjTest::INVITATION_ON = 1

Definition at line 71 of file class.ilObjTest.php.

◆ QUESTION_SET_TYPE_FIXED

const ilObjTest::QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET'

Definition at line 68 of file class.ilObjTest.php.

Referenced by ilObjTestGUI\applyDefaultsObject(), ilObjTestGUI\executeAfterQuestionCreationTasks(), ilLOTestAssignmentTableGUI\fillRow(), SettingsGeneralTest\getAndWithQuestionSetTypeDataProvider(), getQuestionCountAndPointsForPassOfParticipant(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), ilObjTestGUI\importFile(), ilLOTestAssignmentForm\initForm(), ilLOTestAssignmentTableGUI\parse(), ILIAS\Test\Settings\MainSettings\SettingsMainGUI\populateConfirmationModal(), and ILIAS\Test\Settings\MainSettings\SettingsGeneral\toForm().

◆ QUESTION_SET_TYPE_RANDOM

const ilObjTest::QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET'

Definition at line 69 of file class.ilObjTest.php.

Referenced by ilObjTestGUI\applyDefaultsObject(), ilLOTestAssignmentTableGUI\fillRow(), SettingsGeneralTest\getAndWithQuestionSetTypeDataProvider(), getQuestionCountAndPointsForPassOfParticipant(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), ilLOTestAssignmentForm\initForm(), and ILIAS\Test\Settings\MainSettings\SettingsGeneral\toForm().

◆ REDIRECT_ALWAYS

const ilObjTest::REDIRECT_ALWAYS = 1

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

Referenced by ILIAS\Test\Settings\MainSettings\SettingsFinishing\getRedirectionInputs().

◆ REDIRECT_KIOSK

const ilObjTest::REDIRECT_KIOSK = 2

Definition at line 77 of file class.ilObjTest.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsFinishing\getRedirectionInputs().

◆ REDIRECT_NONE

const ilObjTest::REDIRECT_NONE = 0

Definition at line 75 of file class.ilObjTest.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsFinishing\getRedirectionInputs().

◆ SCORE_BEST_PASS

const ilObjTest::SCORE_BEST_PASS = 1

Definition at line 73 of file class.ilObjTest.php.

Referenced by ILIAS\Test\ExportImport\ResultsExportExcel\addResultsHeader(), ilLPStatusTestPassed\determineStatus(), and ilObjTestGUI\forwardToInfoScreen().

◆ SCORE_LAST_PASS

const ilObjTest::SCORE_LAST_PASS = 0

Definition at line 72 of file class.ilObjTest.php.

Referenced by ilLPStatusTestPassed\determineStatus(), ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\fetchPassParameter(), and ilTestServiceGUI\isGradingMessageRequired().

The documentation for this class was generated from the following file:

components/ILIAS/Test/classes/class.ilObjTest.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ _createImportDirectory()

◆ _getActiveIdOfUser()

◆ _getAvailableTests()

◆ _getBestPass()

◆ _getCompleteWorkingTimeOfParticipants()

◆ _getCountSystem()

◆ _getLastAccess()

◆ _getMaxPass()

◆ _getObjectIDFromActiveID()

◆ _getObjectIDFromTestID()

◆ _getPass()

◆ _getPassScoring()

◆ _getResultPass()

◆ _getScoreCutting()

◆ _getSolvedQuestions()

◆ _getTestIDFromObjectID()

◆ _getUserIdFromActiveId()

◆ _instanciateQuestion()

◆ _lookupAnonymity()

◆ _lookupAuthor()

◆ _lookupFinishedUserTests()

◆ _lookupRandomTest()

◆ _lookupTestObjIdForQuestionId()

◆ addConcludingRemarksToSettingsFromImport()

◆ addDefaults()

◆ addIntroductionToSettingsFromImport()

◆ addQTIMaterial()

◆ addToNewsOnOnline()

◆ adjustTestSequence()

◆ applyDefaults()

◆ buildDateTimeImmutableFromPeriod()

◆ buildExamId()

◆ buildIso8601PeriodForExportCompatibility()

◆ buildName()

◆ buildStatisticsAccessFilteredParticipantList()

◆ canShowSolutionPrintview()

◆ canShowTestResults()

◆ checkQuestionParent()

◆ cloneConcludingRemarks()

◆ cloneIntroduction()

◆ cloneObject()

◆ clonePage()

◆ convertTimeToDateTimeImmutableIfNecessary()

◆ copyQuestions()

◆ create()

◆ createExportDirectory()

◆ createQuestionGUI()

◆ createTestSequence()

◆ delete()

◆ deleteDefaults()

◆ deleteTest()

◆ deliverPDFfromFO()

◆ deliverPDFfromHTML()

◆ doCreateMetaData()

◆ duplicateQuestionForTest()

◆ endingTimeReached()

◆ evalStatistical()

◆ evalTotalParticipantsArray()

◆ evalTotalPersons()

◆ evalTotalPersonsArray()

◆ evalTotalStartedAverageTime()

◆ exportFileItems()

◆ exportPagesXML()

◆ exportXMLMediaObjects()

◆ exportXMLPageObjects()

◆ fromXML()

◆ getAccessFilteredParticipantList()

◆ getActivationEndingTime()

◆ getActivationStartingTime()

◆ getActivationVisibility()