Inheritance diagram for ilObjTest:

Collaboration diagram for ilObjTest:

Public Member Functions

__construct ($a_id=0, bool $a_call_by_reference=true)

Constructor. More...

getTitleFilenameCompliant ()

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

getTmpCopyWizardCopyId ()

setTmpCopyWizardCopyId (int $tmpCopyWizardCopyId)

create ()

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

update ()

read ()

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...

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 ()

getImportDirectory ()

hasSingleChoiceQuestions ()

isSingleChoiceTest ()

isSingleChoiceTestWithoutShuffle ()

isComplete (ilTestQuestionSetConfig $testQuestionSetConfig)

_isComplete ($obj_id)

saveCompleteStatus (ilTestQuestionSetConfig $testQuestionSetConfig)

getAllRTEContent ()

Returns the content of all RTE enabled text areas in the test. More...

cleanupMediaobjectUsage ()

Cleans up the media objects for all text fields in a test which are using an RTE field. More...

saveToDb (bool $properties_only=false)

saveQuestionsToDb ()

randomSelectQuestions (int $nr_of_questions, int $questionpool, $use_obj_id=0, $qpls="", $pass=null)

Returns a random selection of questions. More...

getNrOfResultsForPass ($active_id, $pass)

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

hasRandomQuestionsForPass (int $active_id, int $pass)

Checkes wheather a random test has already created questions for a given pass or not. More...

loadFromDb ()

loadQuestions ($active_id="", $pass=null)

Load the test question id's from the database. More...

isIntroductionEnabled ()

setIntroductionEnabled ($introductionEnabled)

getIntroduction ()

setIntroduction (string $introduction)

setFinalStatement (string $a_statement)

setShowInfo ($a_info=1)

Set whether the complete information page is shown or the required data only. More...

setForceJS ($a_js=1)

Set whether JavaScript should be forced for tests. More...

setCustomStyle ($a_customStyle=null)

Set the custom style. More...

getCustomStyle ()

setShowFinalStatement ($show=0)

Sets whether the final statement should be shown or not. More...

getFinalStatement ()

getShowInfo ()

Gets whether the complete information page is shown or the required data only. More...

getForceJS ()

Gets whether JavaScript should be forced for tests. More...

getShowFinalStatement ()

Returns whether the final statement should be shown or not. More...

getTestId ()

Gets the database id of the additional test data. More...

getECTSOutput ()

setECTSOutput ($a_ects_output)

getECTSFX ()

setECTSFX ($a_ects_fx)

getECTSGrades ()

setECTSGrades (array $a_ects_grades)

getSequenceSettings ()

SEQUENCE SETTING = POSTPONING ENABLED !! More...

setSequenceSettings ($sequence_settings=0)

SEQUENCE SETTING = POSTPONING ENABLED !! More...

isPostponingEnabled ()

setPostponingEnabled ($postponingEnabled)

setInstantFeedbackSolution ($instant_feedback=0)

Sets the instant feedback for the solution. More...

setAnswerFeedback ($answer_feedback=0)

Sets the generic feedback for the test @deprecate Use setGenericAnswerFeedback instead. More...

setGenericAnswerFeedback (int $generic_answer_feedback=0)

setAnswerFeedbackPoints ($answer_feedback_points=0)

Sets the answer specific feedback of reached points for the test. More...

setReportingDate ($reporting_date)

Sets the reporting date of the ilObjTest object when the score reporting is available. More...

getScoreReporting ()

isScoreReportingEnabled ()

getInstantFeedbackSolution ()

Returns 1 if the correct solution will be shown after answering a question. More...

getAnswerFeedback ()

Returns 1 if generic answer feedback is activated. More...

getGenericAnswerFeedback ()

Returns 1 if generic answer feedback is to be shown. More...

getAnswerFeedbackPoints ()

Returns 1 if answer specific feedback as reached points is activated. More...

getCountSystem ()

Gets the count system for the calculation of points. More...

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...

getReportingDate ()

Gets the reporting date of the ilObjTest object. More...

getNrOfTries ()

Returns the nr of tries for the test. More...

isBlockPassesAfterPassedEnabled ()

setBlockPassesAfterPassedEnabled ($blockPassesAfterPassedEnabled)

getKiosk ()

Returns the kiosk mode. More...

setKiosk ($kiosk=0)

Sets the kiosk mode for the test. More...

getKioskMode ()

Returns the kiosk mode. More...

setKioskMode ($a_kiosk=false)

Sets the kiosk mode for the test. More...

getShowKioskModeTitle ()

Returns the status of the kiosk mode title. More...

setShowKioskModeTitle ($a_title=false)

Set to true, if the full test title should be shown in kiosk mode. More...

getShowKioskModeParticipant ()

Returns the status of the kiosk mode participant. More...

setShowKioskModeParticipant ($a_participant=false)

Set to true, if the participant's name should be shown in kiosk mode. More...

getUsePreviousAnswers ()

Returns if the previous answers should be shown for a learner. More...

getTitleOutput ()

Returns the value of the title_output status. More...

_getTitleOutput ($active_id)

Returns the value of the title_output status. More...

isPreviousSolutionReuseEnabled ($active_id)

getProcessingTime ()

Returns the processing time for the test. More...

getProcessingTimeAsArray ()

getProcessingTimeAsMinutes ()

getProcessingTimeInSeconds ($active_id="")

Returns the processing time for the test in seconds. More...

getSecondsUntilEndingTime ()

Returns the seconds left from the actual time until the ending time. More...

getEnableProcessingTime ()

Returns the state of the processing time (enabled/disabled) More...

getResetProcessingTime ()

Returns wheather the processing time should be reset or not. More...

isStartingTimeEnabled ()

setStartingTimeEnabled ($starting_time_enabled)

getStartingTime ()

Returns the starting time of the test. More...

setStartingTime ($starting_time=null)

Sets the starting time in database timestamp format for the test. More...

isEndingTimeEnabled ()

setEndingTimeEnabled ($ending_time_enabled)

getEndingTime ()

Returns the ending time of the test. More...

setEndingTime ($ending_time=null)

Sets the ending time in database timestamp format for the test. More...

setNrOfTries ($nr_of_tries=0)

Sets the nr of tries for the test. More...

setUsePreviousAnswers ($use_previous_answers=1)

Sets the status of the visibility of previous learner answers. More...

setRedirectionMode ($redirection_mode=0)

getRedirectionMode ()

setRedirectionUrl ($redirection_url=null)

getRedirectionUrl ()

setTitleOutput ($title_output=0)

Sets the status of the title output. More...

setProcessingTime ($processing_time="00:00:00")

Sets the processing time for the test. More...

setProcessingTimeByMinutes ($minutes)

setEnableProcessingTime ($enable=0)

Sets the processing time enabled or disabled. More...

setResetProcessingTime ($reset=0)

Sets wheather the processing time should be reset or not. More...

isPasswordEnabled ()

setPasswordEnabled ($passwordEnabled)

getPassword ()

setPassword ($a_password=null)

Sets the password for test access. More...

getPassWaiting ()

setPassWaiting ($pass_waiting)

isPassWaitingEnabled ()

removeQuestionFromSequences ($questionId, $activeIds, ilTestReindexedSequencePositionMap $reindexedSequencePositionMap)

removeQuestions (array $removeQuestionIds)

removeQuestion (int $question_id)

removeTestResultsFromSoapLpAdministration ($userIds)

removeTestResults (ilTestParticipantData $participantData)

removeTestResultsByUserIds ($userIds)

removeTestResultsByActiveIds ($activeIds)

removeTestActives ($activeIds)

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 (ilTestQuestionSetConfig $testQuestionSetConfig, $question_id, $linkOnly=false)

Insert a question in the list of questions. More...

& getQuestionTitles ()

Returns the titles of the test questions in question sequence. More...

& getQuestionTitlesAndIndexes ()

Returns the titles of the test questions in question sequence. More...

getQuestionTitle ($title, $nr=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 ( $active_id, $pass=null, bool $ordered_sequence=false, bool $considerHiddenQuestions=true, bool $considerOptionalQuestions=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...

getVisitTimeOfParticipant ($active_id)

Returns the first and last visit of a participant. More...

_getVisitTimeOfParticipant ($test_id, $active_id)

Returns the first and last visit of a participant. More...

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 ($name_sort_order="asc")

Returns all persons who started the test. More...

evalTotalParticipantsArray ($name_sort_order="asc")

Returns all participants who started the test. More...

& getQuestionsOfTest ($active_id)

Retrieves all the assigned questions for all test passes of a test participant. More...

& getQuestionsOfPass ($active_id, $pass)

Retrieves all the assigned questions for a test participant in a given test pass. More...

getAccessFilteredParticipantList ()

setAccessFilteredParticipantList ($accessFilteredParticipantList)

buildStatisticsAccessFilteredParticipantList ()

& getCompleteEvaluationData ($withStatistics=true, $filterby="", $filtertext="")

& evalResultsOverview ()

Creates an associated array with the results of all participants of a test. More...

& _evalResultsOverview ($test_id)

Creates an associated array with the results of all participants of a test. More...

& evalResultsOverviewOfParticipant ($active_id)

Creates an associated array with the results for a given participant of a test. More...

buildName ($user_id, $firstname, $lastname, $title)

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

_buildName ($is_anonymous, $user_id, $firstname, $lastname, $title)

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

evalTotalStartedAverageTime ($activeIdsFilter=null)

Returns the average processing time for all started tests. More...

getAvailableQuestionpools ($use_object_id=false, $equal_points=false, $could_be_offline=false, $show_path=false, $with_questioncount=false, $permission="read")

Returns the available question pools for the active user. More...

getEstimatedWorkingTime ()

Returns the estimated working time for the test calculated from the working time of the contained questions. 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 ($move_questions, $target_index, $insert_mode)

Move questions to another position. More...

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 ($arrFilter, $completeonly=0)

Calculates the available questions for a test. More...

fromXML (ilQTIAssessment $assessment)

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...

exportXMLMetaData (&$a_xml_writer)

export content objects meta data 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, $a_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...

canEditEctsGrades ()

{} More...

canShowEctsGrades ()

{} More...

getECTSGrade ($passed_array, $reached_points, $max_points)

{Returns the ECTS grade for a number of reached points.

Parameters

array	$passed_array	An array with the points of all users who passed the test
double	$reached_points	The points reached in the test
double	$max_points	The maximum number of points for the test

Returns: string The ECTS grade short description

} More...

checkMarks ()

{

Returns: boolean|string True or an error string which can be used for display purposes

} More...

getMarkSchema ()

{

Returns: ASS_MarkSchema

} More...

getMarkSchemaForeignId ()

{

Returns: int

} More...

canEditMarks ()

setAuthor (string $author="")

Sets the authors name of the ilObjTest object. More...

saveAuthorToMetadata (string $a_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...

getQuestionCount ()

getQuestionCountWithoutReloading ()

logAction ($logtext="", $question_id="")

Logs an action into the Test&Assessment log. More...

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...

getInvitedParticipantList ()

getActiveParticipantList ()

& getInvitedUsers ($user_id="", $order="login, lastname, firstname")

Returns a list of all invited users in a test. More...

& getTestParticipants ()

Returns a list of all participants in a test. More...

getTestParticipantsForManualScoring ($filter=null)

getUserData ($ids)

Returns a data of all users specified by id list. More...

getGroupData ($ids)

getRoleData ($ids)

inviteGroup ($group_id)

Invites all users of a group to a test. More...

inviteRole ($role_id)

Invites all users of a role to a test. More...

disinviteUser ($user_id)

Disinvites a user from a test. More...

inviteUser ($user_id, $client_ip="")

Invites a user to a test. More...

setClientIP ($user_id, $client_ip)

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, $prepareForCSV=true)

returns all test results for all participants More...

& processCSVRow ($row, $quoteAll=false, $separator=";")

Processes an array as a CSV row and converts the array values to correct CSV values. More...

getAnsweredQuestionCount ($active_id, $pass=null)

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

isExecutable ($testSession, $user_id, $allowPassIncrease=false)

Checks if the test is executable by the given user. More...

canShowTestResults (ilTestSession $testSession)

hasAnyTestResult (ilTestSession $testSession)

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 ($questionId)

checkQuestionParent ($questionId)

getFixedQuestionSetTotalPoints ()

getShuffleQuestions ()

Returns the status of the shuffle_questions variable. More...

setShuffleQuestions ($a_shuffle)

Sets the status of the shuffle_questions variable. More...

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...

setListOfQuestionsSettings ($a_value=0)

Sets 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 ()

Returns if the list of questions should be presented to the user or not. More...

setListOfQuestions ($a_value=true)

Sets if the the list of questions should be presented to the user or not. More...

getListOfQuestionsStart ()

Returns if the list of questions should be presented as the first page of the test. More...

setListOfQuestionsStart ($a_value=true)

Sets if the the list of questions as the start page of the test. More...

getListOfQuestionsEnd ()

Returns if the list of questions should be presented as the last page of the test. More...

setListOfQuestionsEnd ($a_value=true)

Sets if the the list of questions as the end page of the test. More...

getListOfQuestionsDescription ()

Returns TRUE if the list of questions should be presented with the question descriptions. More...

setListOfQuestionsDescription ($a_value=true)

Sets the show_summary attribute to TRUE if the list of questions should be presented with the question descriptions. More...

getResultsPresentation ()

Returns the combined results presentation value. More...

getShowPassDetails ()

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

getShowSolutionDetails ()

Returns if the solution details should be presented to the user or not. 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 ($user_id=null)

setShowSolutionPrintview (int $a_printview=1)

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

isLimitUsersEnabled ()

setLimitUsersEnabled (bool $limitUsersEnabled)

getAllowedUsers ()

setAllowedUsers ($a_allowed_users)

getAllowedUsersTimeGap ()

setAllowedUsersTimeGap ($a_allowed_users_time_gap)

checkMaximumAllowedUsers ()

_getLastAccess ($active_id)

isHTML ($a_text)

Checks if a given string contains HTML or not. More...

QTIMaterialToString ($a_material)

Reads an QTI material tag an creates a text string. More...

addQTIMaterial (&$a_xml_writer, $a_material='')

Creates a QTI material tag from a plain text or xhtml text. More...

prepareTextareaOutput ($txt_output, $prepare_for_latex_output=false, $omitNl2BrWhenTextArea=false)

Prepares a string for a text area output in tests. More...

getAnonymity ()

Returns the anonymity status of the test. More...

setAnonymity ($a_value=0)

Sets the anonymity status of the test. More...

getShowCancel ()

Returns wheather the cancel test button is shown or not. More...

setShowCancel ($a_value=1)

Sets the cancel test button status. More...

getShowMarker ()

Returns wheather the marker button is shown or not. More...

setShowMarker ($a_value=1)

Sets the marker button status. More...

getFixedParticipants ()

Returns the fixed participants status. More...

setFixedParticipants ($a_value=1)

Sets the fixed participants status. More...

_lookupRandomTestFromActiveId ($active_id)

Returns the random status of a test with a given object id. More...

userLookupFullName ($user_id, $overwrite_anonymity=false, $sorted_order=false, $suffix="")

Returns the full name of a test user according to the anonymity status. More...

getStartTestLabel ($active_id)

Returns the "Start the Test" label for the Info page. More...

getTestDefaults ($test_defaults_id)

Returns the test defaults for a given id. More...

deleteDefaults ($test_default_id)

Deletes the defaults for a test. More...

addDefaults ($a_name)

Adds the defaults of this test to the test defaults. More...

applyDefaults ($test_defaults)

Applies given test defaults to this test. More...

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...

saveManualFeedback (int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized=false, bool $is_single_feedback=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)

getAggregatedResultsData ()

Returns the aggregated test results. More...

getXMLZip ()

Get zipped xml file for test. More...

getMailNotification ()

setMailNotification ($a_notification)

sendSimpleNotification ($active_id)

getEvaluationAdditionalFields ()

Gets additional user fields that should be shown in the user evaluation. More...

sendAdvancedNotification ($active_id)

getResultsForActiveId ($active_id)

getMailNotificationType ()

setMailNotificationType ($a_type)

getExportSettings ()

setExportSettings ($a_settings)

getExportSettingsSingleChoiceShort ()

setExportSettingsSingleChoiceShort ($a_settings)

getEnabledViewMode ()

setEnabledViewMode ($mode)

setTemplate ($template_id)

getTemplate ()

isAnyInstantFeedbackOptionEnabled ()

getInstantFeedbackOptionsAsArray ()

setInstantFeedbackOptionsByArray ($options)

reindexFixedQuestionOrdering ()

setQuestionOrderAndObligations ($orders, $obligations)

moveQuestionAfter ($question_to_move, $question_before)

hasQuestionsWithoutQuestionpool ()

getQuestions ()

isOnline ()

setOnline ($a_online=true)

getOldOnlineStatus ()

setOldOnlineStatus ($oldOnlineStatus)

isBestSolutionPrintedWithResult ()

isOfferingQuestionHintsEnabled ()

returns the fact wether offering hints is enabled or not More...

setOfferingQuestionHintsEnabled ($offeringQuestionHintsEnabled)

sets offering question hints enabled/disabled More...

setActivationVisibility ($a_value)

getActivationVisibility ()

isActivationLimited ()

setActivationLimited ($a_value)

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 ()

setSpecificAnswerFeedback ($specific_answer_feedback)

getSpecificAnswerFeedback ()

setObligationsEnabled ($obligationsEnabled=true)

sets obligations enabled/disabled More...

areObligationsEnabled ()

returns the fact wether obligations are enabled or not More...

setAutosave ($autosave)

getAutosave ()

setAutosaveIval ($autosave_ival)

getAutosaveIval ()

isPassDeletionAllowed ()

setShowExamviewHtml ($show_examview_html)

getShowExamviewHtml ()

setShowExamviewPdf ($show_examview_pdf)

getShowExamviewPdf ()

setEnableExamview ($enable_examview)

getEnableExamview ()

setActivationStartingTime ($starting_time=null)

setActivationEndingTime ($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 ()

getExtraTime ($active_id)

addExtraTime ($active_id, $minutes)

setEnableArchiving ($enable_archiving)

getEnableArchiving ()

setShowExamIdInTestPassEnabled ($show_exam_id_in_test_pass_enabled)

isShowExamIdInTestPassEnabled ()

isShowExamIdInTestResultsEnabled ()

setSignSubmission ($sign_submission)

getSignSubmission ()

setCharSelectorAvailability ($availability)

getCharSelectorAvailability ()

setCharSelectorDefinition ($definition='')

getCharSelectorDefinition ()

setQuestionSetType ($questionSetType)

setter for question set type More...

getQuestionSetType ()

getter for question set type More...

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...

isDynamicTest ()

Returns the fact wether this test is a dynamic question set test or not. More...

getQuestionSetTypeTranslation (ilLanguage $lng, $questionSetType)

participantDataExist ()

recalculateScores ($preserve_manscoring=false)

setSkillServiceEnabled ($skillServiceEnabled)

isSkillServiceEnabled ()

getResultFilterTaxIds ()

isSkillServiceToBeConsidered ()

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

setShowGradingStatusEnabled ($showGradingStatusEnabled)

isShowGradingStatusEnabled ()

setShowGradingMarkEnabled ($showGradingMarkEnabled)

isShowGradingMarkEnabled ()

setFollowupQuestionAnswerFixationEnabled ($followupQuestionAnswerFixationEnabled)

isFollowupQuestionAnswerFixationEnabled ()

setInstantFeedbackAnswerFixationEnabled ($instantFeedbackAnswerFixationEnabled)

isInstantFeedbackAnswerFixationEnabled ()

isForceInstantFeedbackEnabled ()

setForceInstantFeedbackEnabled ($forceInstantFeedbackEnabled)

isTestFinalBroken ()

setTestFinalBroken ($testFinalBroken)

adjustTestSequence ()

getScoreSettings ()

getScoreSettingsRepository ()

Public Member Functions inherited from ilObject

__construct (int $id=0, bool $reference=true)

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 $desc)

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...

Public Member Functions inherited from ilMarkSchemaAware

getMarkSchema ()

checkMarks ()

canEditMarks ()

getMarkSchemaForeignId ()

onMarkSchemaSaved ()

Public Member Functions inherited from ilEctsGradesEnabled

setECTSGrades (array $grades)

getECTSGrades ()

setECTSFX ($ects_fx)

getECTSFX ()

setECTSOutput ($status)

getECTSOutput ()

saveECTSStatus ()

canEditEctsGrades ()

canShowEctsGrades ()

getECTSGrade ($passed_array, $reached_points, $max_points)

Returns the ECTS grade for a number of reached points. More...

Static Public Member Functions

static _setImportDirectory ($a_import_dir=null)

static _getImportDirectory ()

Get the import directory location of the test. More...

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)

Gets the count system for the calculation of points. More...

static _getPassScoring ($active_id)

Gets the pass scoring type. More...

static _getScoreCutting ($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 _getWorkingTimeOfParticipantForPass ($active_id, $pass)

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

static _getQuestionCountAndPointsForPassOfParticipant ($active_id, $pass)

static _instanciateQuestion ($question_id)

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

static _getECTSGrade ($points_passed, $reached_points, $max_points, $a, $b, $c, $d, $e, $fx)

{Returns the ECTS grade for a number of reached points.

Parameters

double	$reached_points	The points reached in the test
double	$max_points	The maximum number of points for the test

Returns: string The ECTS grade short description

} 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 ($active_id)

static lookupLastTestPassAccess ($activeId, $passIndex)

static _lookupAnonymity ($a_obj_id)

Returns the anonymity status of a test with a given object id. More...

static lookupQuestionSetTypeByActiveId ($active_id)

returns the question set type of test relating to passed active id More...

static _getTestDefaults ($test_defaults_id)

static getManualFeedback ($active_id, $question_id, $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 getCompleteManualFeedback (int $question_id)

Retrieves the manual feedback for a question in a test. More...

static _lookupTestObjIdForQuestionId ($a_q_id)

Get test Object ID for question ID. More...

static _lookupFinishedUserTests ($a_user_id)

Gather all finished tests for user. More...

static isQuestionObligationPossible ($questionId)

checks wether the obligation for question with given id is possible or not More...

static isQuestionObligatory ($question_id)

checks wether the question with given id is marked as obligatory or not More...

static allObligationsAnswered ($test_id, $active_id, $pass)

checks wether all questions marked as obligatory were answered within the test pass with given testId, activeId and pass index More...

static hasObligations ($test_id)

returns the fact wether the test with given test id contains questions markes as obligatory or not More...

static lookupExamId ($active_id, $pass)

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

static lookupQuestionSetType ($objId)

lookup-er for question set type More...

static _lookupRandomTest ($a_obj_id)

Returns the fact wether the test with passed obj id is a random questions test or not. More...

static getTestObjIdsWithActiveForUserId ($userId)

static isSkillManagementGloballyActivated ()

static ensureParticipantsLastActivePassFinished ($testObjId, $userId, $a_force_new_run=false)

static isParticipantsLastPassActive ($testRefId, $userId)

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 _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)

static _getECTSGrade ($points_passed, $reached_points, $max_points, $a, $b, $c, $d, $e, $fx)

Returns the ECTS grade for a number of reached points. More...

Data Fields
const	DEFAULT_PROCESSING_TIME_MINUTES = 90

const	QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET'

const	QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET'

int	$test_id

int	$invitation = INVITATION_OFF

string	$author

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

array	$questions

	$mark_schema
	Defines the mark schema ASS_MarkSchema ? More...

int	$sequence_settings

int	$instant_verification

int	$answer_feedback_points

	$reporting_date

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

int	$nr_of_tries

int	$use_previous_answers

int	$title_output

	$processing_time

	$enable_processing_time

int	$reset_processing_time

bool	$shuffle_questions

	$show_summary

int	$anonymity

int	$show_cancel

int	$show_marker

int	$fixed_participants

int	$answer_feedback

	$testSession
	contains the test session data More...

	$testSequence
	contains the test sequence data More...

const	SCORE_REPORTING_DISABLED = 0

const	SCORE_REPORTING_FINISHED = 1

const	SCORE_REPORTING_IMMIDIATLY = 2

const	SCORE_REPORTING_DATE = 3

const	SCORE_REPORTING_AFTER_PASSED = 4

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
	isNewRandomTest ()
	Checks wheather the test is a new random test (using tst_rnd_cpy) or an old one. More...

	buildIso8601PeriodFromUnixtimeForExportCompatibility ($unix_timestamp)

	doCreateMetaData ()
	@inheritDoc More...

	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
int	$_kiosk

bool	$introductionEnabled

string	$introduction

bool	$blockPassesAfterPassedEnabled = false

	$starting_time_enabled
	bool? More...

string	$starting_time

	$ending_time_enabled
	bool? More...

string	$ending_time

	$ects_output = false

float	$ects_fx = null
	Contains the percentage of maximum points a failed user needs to get the FX ECTS grade. More...

array	$ects_grades = array()

	$enabled_view_mode

	$passwordEnabled
	bool? More...

string	$password

	$limitUsersEnabled
	bool? More...

	$allowedUsers

	$allowedUsersTimeGap

	$mailnotification

int	$mailnottype

int	$exportsettings

	$oldOnlineStatus = null

bool	$print_best_solution_with_result = true

	$activation_visibility

	$activation_starting_time

	$activation_ending_time

bool	$autosave

int	$autosave_ival

bool	$enable_examview

bool	$show_examview_html

bool	$show_examview_pdf

bool	$enable_archiving

bool	$show_exam_id_in_test_pass_enabled

bool	$show_exam_id_in_test_results_enabled

bool	$sign_submission

	$char_selector_availability

string	$char_selector_definition

bool	$showGradingStatusEnabled

bool	$showGradingMarkEnabled

bool	$followupQuestionAnswerFixationEnabled

bool	$instantFeedbackAnswerFixationEnabled

	$forceInstantFeedbackEnabled

bool	$testFinalBroken

	$pass_waiting = "00:000:00:00:00"

ilDBInterface	$db

ilObjTestScoreSettings	$score_settings = null

ScoreSettingsRepository	$score_settings_repo = null

	$accessFilteredParticipantList

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

int	$id

bool	$referenced

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 = ""

bool	$offline = false

string	$desc = ""

string	$long_desc = ""

int	$owner = 0

string	$create_date = ""

string	$last_update = ""

string	$import_id = ""

bool	$register = false

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

	logManualFeedback ($active_id, $question_id, $feedback)
	Creates a log for the manual feedback. More...

Private Attributes
const	QUESTION_SET_TYPE_DYNAMIC = 'DYNAMIC_QUEST_SET'

string	$questionSetType = self::QUESTION_SET_TYPE_FIXED

bool	$skillServiceEnabled = false

array	$resultFilterTaxIds = array()

int	$specific_answer_feedback = null

bool	$activation_limited = null

array	$mob_ids

array	$file_ids

bool	$online

Refinery	$refinery

ILIAS Test InternalRequestService	$testrequest

	$_showfinalstatement

string	$_finalstatement

bool	$_showinfo

bool	$_forcejs = true

	$_customStyle
	Name of a custom style sheet for the test string? More...

	$template_id

bool	$offeringQuestionHintsEnabled = null

bool	$obligationsEnabled = null

	$passDeletionAllowed = null

	$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	$redirection_mode = 0

string	$redirection_url = null

int	$tmpCopyWizardCopyId

Static Private Attributes
static	$isSkillManagementGloballyActivated = null

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilObjTest::__construct	(		$a_id = `0`,
		bool	$a_call_by_reference = `true`
	)

Constructor.

Parameters

$a_id	int\|string Reference_id or object_id.
$a_call_by_reference	bool Treat the id as reference_id (true) or object_id (false).

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

    {
        global $DIC;
        $this->db = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
        $lng = $DIC['lng'];
        $this->refinery = $DIC['refinery'];
        $this->type = "tst";
        $this->testrequest = $DIC->test()->internal()->request();
 
        $lng->loadLanguageModule("assessment");
        $this->mark_schema = new ASS_MarkSchema();
        $this->mark_schema->createSimpleSchema(
            $lng->txt("failed_short"),
            $lng->txt("failed_official"),
            0,
            0,
            $lng->txt("passed_short"),
            $lng->txt("passed_official"),
            50,
            1
        );
 
        $this->score_settings = null;
        $this->test_id = -1;
        $this->author = $ilUser->fullname;
        $this->introductionEnabled = false;
        $this->introduction = "";
        $this->questions = array();
        $this->sequence_settings = TEST_FIXED_SEQUENCE;
        $this->instant_verification = 0;
        $this->answer_feedback_points = 0;
        $this->reporting_date = "";
        $this->nr_of_tries = 0;
        $this->_kiosk = 0;
        $this->use_previous_answers = 1;
        $this->title_output = 0;
        $this->starting_time = "";
        $this->ending_time = "";
        $this->processing_time = "";
        $this->enable_processing_time = "0";
        $this->reset_processing_time = 0;
        $this->ects_output = false;
        $this->ects_fx = null;
        $this->shuffle_questions = false;
        $this->mailnottype = 0;
        $this->show_summary = 8;
        $this->answer_feedback = 0;
        $this->password = "";
        $this->allowedUsers = "";
        $this->_showfinalstatement = false;
        $this->_finalstatement = "";
        $this->_showinfo = true;
        $this->_forcejs = true;
        $this->_customStyle = "";
        $this->allowedUsersTimeGap = "";
        $this->anonymity = 0;
        $this->show_cancel = 0;
        $this->show_marker = 0;
        $this->fixed_participants = 0;
        $this->testSession = false;
        $this->testSequence = false;
        $this->mailnotification = 0;
 
        $this->ects_grades = array(
            'A' => 90,
            'B' => 65,
            'C' => 35,
            'D' => 10,
            'E' => 0
        );
 
        $this->autosave = false;
        $this->autosave_ival = 30000;
 
        $this->enable_examview = false;
        $this->show_examview_html = false;
        $this->show_examview_pdf = false;
        $this->enable_archiving = false;
 
        $this->template_id = '';
        $this->redirection_mode = 0;
        $this->redirection_url = null;
        $this->show_exam_id_in_test_pass_enabled = false;
        $this->sign_submission = false;
        $this->char_selector_availability = 0;
        $this->char_selector_definition = null;
 
        $this->showGradingStatusEnabled = true;
        $this->showGradingMarkEnabled = true;
 
        $this->followupQuestionAnswerFixationEnabled = false;
        $this->instantFeedbackAnswerFixationEnabled = false;
 
        $this->testFinalBroken = false;
 
        $this->tmpCopyWizardCopyId = null;
 
        parent::__construct($a_id, $a_call_by_reference);
    }

References $DIC, $ilUser, ilObject\$lng, ILIAS\GlobalScreen\Provider\__construct(), ilLanguage\loadLanguageModule(), ILIAS\Repository\refinery(), TEST_FIXED_SEQUENCE, and ilLanguage\txt().

Here is the call graph for this function:

Member Function Documentation

◆ _buildName()

ilObjTest::_buildName	(	$is_anonymous,
		$user_id,
		$firstname,
		$lastname,
		$title
	)

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

Parameters

boolean	$is_anonymous	Indicates if it is an anonymized test or not
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 @access public

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

                                                                                      : string
    {
        global $DIC;
        $lng = $DIC['lng'];
        $name = "";
        if (strlen($firstname . $lastname . $title) == 0) {
            $name = $lng->txt("deleted_user");
        } else {
            if ($user_id == ANONYMOUS_USER_ID) {
                $name = $lastname;
            } else {
                $name = trim($lastname . ", " . $firstname . " " . $title);
            }
            if ($is_anonymous) {
                $name = $lng->txt("anonymous");
            }
        }
        return $name;
    }

References $DIC, $lng, $name, and ANONYMOUS_USER_ID.

◆ _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 582 of file class.ilObjTest.php.

                                                   : 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;
    }

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

Referenced by ilObjTestGUI\uploadTst().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _evalResultsOverview()

& ilObjTest::_evalResultsOverview ( $test_id )

Creates an associated array with the results of all participants of a test.

Returns: array An associated array containing the results @access public

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

                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT usr_data.usr_id, usr_data.firstname, usr_data.lastname, usr_data.title, usr_data.login, " .
            "tst_test_result.*, qpl_questions.original_id, qpl_questions.title questiontitle, " .
            "qpl_questions.points maxpoints " .
            "FROM tst_test_result, qpl_questions, tst_active " .
            "LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id " .
            "WHERE tst_active.active_id = tst_test_result.active_fi " .
            "AND qpl_questions.question_id = tst_test_result.question_fi " .
            "AND tst_active.test_fi = %s " .
            "ORDER BY tst_active.active_id, tst_test_result.pass, tst_test_result.tstamp",
            array('integer'),
            array($test_id)
        );
        $overview = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            if (!array_key_exists($row["active_fi"], $overview)) {
                $overview[$row["active_fi"]] = array();
                $overview[$row["active_fi"]]["firstname"] = $row["firstname"];
                $overview[$row["active_fi"]]["lastname"] = $row["lastname"];
                $overview[$row["active_fi"]]["title"] = $row["title"];
                $overview[$row["active_fi"]]["login"] = $row["login"];
                $overview[$row["active_fi"]]["usr_id"] = $row["usr_id"];
                $overview[$row["active_fi"]]["started"] = $row["started"];
                $overview[$row["active_fi"]]["finished"] = $row["finished"];
            }
            if (!array_key_exists($row["pass"], $overview[$row["active_fi"]])) {
                $overview[$row["active_fi"]][$row["pass"]] = array();
                $overview[$row["active_fi"]][$row["pass"]]["reached"] = 0;
                $overview[$row["active_fi"]][$row["pass"]]["maxpoints"] = $row["maxpoints"];
            }
            array_push($overview[$row["active_fi"]][$row["pass"]], $row);
            $overview[$row["active_fi"]][$row["pass"]]["reached"] += $row["points"];
        }
        return $overview;
    }

References $DIC, and $ilDB.

◆ _getActiveIdOfUser()

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

static

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

    {
        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",
            array('integer', 'integer'),
            array($user_id, $test_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            return $row["active_id"];
        } else {
            return "";
        }
    }

References $DIC, $ilDB, and $ilUser.

Referenced by ilLOUtils\getTestResultLinkForUser().

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 @access public

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

                                                                     : array
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $result_array = 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;
    }

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

Referenced by ilObjAssessmentFolderGUI\exportLogObject(), ilObjAssessmentFolderGUI\getLogDataOutputForm(), and ilObjAssessmentFolderGUI\logAdminObject().

Here is the call graph for this function:

Here is the caller 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 7274 of file class.ilObjTest.php.

                                                   : ?int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT * FROM tst_pass_result WHERE active_fi = %s",
            array('integer'),
            array($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;
    }

References $DIC, and $ilDB.

Referenced by _getResultPass().

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 @access public

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

                                                                    : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->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",
            array('integer'),
            array($test_id)
        );
        $time = 0;
        $times = array();
        while ($row = $ilDB->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($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
            $epoch_2 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            $times[$row["active_fi"]] += ($epoch_2 - $epoch_1);
        }
        return $times;
    }

References $DIC, and $ilDB.

◆ _getCountSystem()

static ilObjTest::_getCountSystem ( $active_id )

static

Gets the count system for the calculation of points.

Returns: integer The count system for the calculation of points @access public

See also: $count_system

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

    {
        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",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            return $row["count_system"];
        }
        return false;
    }

References $DIC, and $ilDB.

Referenced by assQuestion\adjustReachedPointsByScoringOptions().

Here is the caller graph for this function:

◆ _getECTSGrade()

static ilObjTest::_getECTSGrade	(	$points_passed,
		$reached_points,
		$max_points,
		$a,
		$b,
		$c,
		$d,
		$e,
		$fx
	)

static

{Returns the ECTS grade for a number of reached points.

Parameters

double	$reached_points	The points reached in the test
double	$max_points	The maximum number of points for the test

Returns: string The ECTS grade short description

}

Implements ilEctsGradesEnabled.

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

                                                                                                               : string
    {
        // calculate the median
        $passed_statistics = new ilStatistics();
        $passed_statistics->setData($points_passed);
        $ects_percentiles = array(
            "A" => $passed_statistics->quantile($a),
            "B" => $passed_statistics->quantile($b),
            "C" => $passed_statistics->quantile($c),
            "D" => $passed_statistics->quantile($d),
            "E" => $passed_statistics->quantile($e)
        );
        if (count($points_passed) && ($reached_points >= $ects_percentiles["A"])) {
            return "A";
        } elseif (count($points_passed) && ($reached_points >= $ects_percentiles["B"])) {
            return "B";
        } elseif (count($points_passed) && ($reached_points >= $ects_percentiles["C"])) {
            return "C";
        } elseif (count($points_passed) && ($reached_points >= $ects_percentiles["D"])) {
            return "D";
        } elseif (count($points_passed) && ($reached_points >= $ects_percentiles["E"])) {
            return "E";
        } elseif (strcmp($fx, "") != 0) {
            if ($max_points > 0) {
                $percentage = ($reached_points / $max_points) * 100.0;
                if ($percentage < 0) {
                    $percentage = 0.0;
                }
            } else {
                $percentage = 0.0;
            }
            if ($percentage >= $fx) {
                return "FX";
            } else {
                return "F";
            }
        } else {
            return "F";
        }
    }

References Vendor\Package\$a, Vendor\Package\$b, $c, $d, and Vendor\Package\$e.

◆ _getImportDirectory()

static ilObjTest::_getImportDirectory ( )

static

Get the import directory location of the test.

Returns: mixed|null The location of the import directory or false if the directory doesn't exist

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

    {
        if (strlen(ilSession::get('tst_import_dir'))) {
            return ilSession::get('tst_import_dir');
        }
        return null;
    }

References ilSession\get().

Referenced by assFormulaQuestionImport\fromXML(), fromXML(), getImportDirectory(), assQuestionImport\getTstImportArchivDirectory(), ilObjTestGUI\importVerifiedFileObject(), and ilObjTestGUI\uploadTst().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getLastAccess()

ilObjTest::_getLastAccess ( $active_id )

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

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

References $DIC, and $ilDB.

◆ _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 @access public

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

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

References $DIC, and $ilDB.

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

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 @access public

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

    {
        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",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            $object_id = $row["obj_fi"];
        }
        return $object_id;
    }

References $DIC, and $ilDB.

Referenced by assFileUpload\handleSubmission(), and assQuestion\logAction().

Here is the caller graph for this function:

◆ _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 @access public

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

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

References $DIC, and $ilDB.

◆ _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 @access public

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

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

References $DIC, and $ilDB.

Here is the caller graph for this function:

◆ _getPassScoring()

static ilObjTest::_getPassScoring ( $active_id )

static

Gets the pass scoring type.

Returns: integer The pass scoring type @access public

See also: $pass_scoring

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

                                                      : 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",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            return $row["pass_scoring"];
        }
        return 0;
    }

References $DIC, and $ilDB.

Referenced by _getResultPass().

Here is the caller graph for this function:

◆ _getQuestionCountAndPointsForPassOfParticipant()

static ilObjTest::_getQuestionCountAndPointsForPassOfParticipant	(	$active_id,
		$pass
	)

static

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

                                                                                            : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $questionSetType = ilObjTest::lookupQuestionSetTypeByActiveId($active_id);
 
        switch ($questionSetType) {
            case ilObjTest::QUESTION_SET_TYPE_DYNAMIC:
 
                $res = $ilDB->queryF(
                    "
                                                SELECT          COUNT(qpl_questions.question_id) qcount,
                                                                        SUM(qpl_questions.points) qsum
                                                FROM            tst_active
                                                INNER JOIN      tst_tests
                                                ON                      tst_tests.test_id = tst_active.test_fi
                                                INNER JOIN      tst_dyn_quest_set_cfg
                                                ON          tst_dyn_quest_set_cfg.test_fi = tst_tests.test_id
                                                INNER JOIN  qpl_questions
                                                ON          qpl_questions.obj_fi = tst_dyn_quest_set_cfg.source_qpl_fi
                                                AND         qpl_questions.original_id IS NULL
                                                AND         qpl_questions.complete = %s
                                                WHERE           tst_active.active_id = %s
                                        ",
                    array('integer', 'integer'),
                    array(1, $active_id)
                );
 
                break;
 
            case ilObjTest::QUESTION_SET_TYPE_RANDOM:
 
                $res = $ilDB->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
                                        ",
                    array('integer', 'integer'),
                    array($active_id, $pass)
                );
 
                break;
 
            case ilObjTest::QUESTION_SET_TYPE_FIXED:
 
                $res = $ilDB->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
                                        ",
                    array('integer'),
                    array($active_id)
                );
 
                break;
 
            default:
 
                throw new ilTestException("not supported question set type: $questionSetType");
        }
 
        $row = $ilDB->fetchAssoc($res);
 
        if (is_array($row)) {
            return array("count" => $row["qcount"], "points" => $row["qsum"]);
        }
 
        return array("count" => 0, "points" => 0);
    }

References $DIC, $ilDB, $res, lookupQuestionSetTypeByActiveId(), QUESTION_SET_TYPE_DYNAMIC, QUESTION_SET_TYPE_FIXED, and QUESTION_SET_TYPE_RANDOM.

Referenced by ilTestEvaluationData\generateOverview().

Here is the call graph for this function:

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 @access public

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

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

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

Referenced by assQuestion\_updateTestResultCache(), evalStatistical(), getAllTestResults(), getDetailedTestResults(), getPassed(), ilCertificateTestObjectHelper\getResultPass(), and ilTestEvaluationGUI\outParticipantsResultsOverview().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getScoreCutting()

static ilObjTest::_getScoreCutting ( $active_id )

static

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

Returns: boolean The score cutting type. 0 for question cutting, 1 for test cutting @access public

See also: $score_cutting

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

                                                       : 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",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            return $row["score_cutting"];
        }
        return false;
    }

References $DIC, and $ilDB.

Referenced by assQuestion\adjustReachedPointsByScoringOptions().

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 6992 of file class.ilObjTest.php.

                                                                               : 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",
                array('integer', 'integer'),
                array($active_id, $question_fi)
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT question_fi, solved FROM tst_qst_solved WHERE active_fi = %s",
                array('integer'),
                array($active_id)
            );
        }
        $result_array = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            $result_array[$row["question_fi"]] = $row;
        }
        return $result_array;
    }

References $DIC, and $ilDB.

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

Here is the caller graph for this function:

◆ _getTestDefaults()

static ilObjTest::_getTestDefaults ( $test_defaults_id )

static

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

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

References $DIC, and $ilDB.

◆ _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 @access public

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

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

References $DIC, and $ilDB.

Referenced by ilLOUtils\getTestResultLinkForUser().

Here is the caller graph for this function:

◆ _getTitleOutput()

ilObjTest::_getTitleOutput ( $active_id )

Returns the value of the title_output status.

Parameters

integer $active_id The active id of a user

Returns: integer 0 for full title, 1 for title without points, 2 for no title @access public

See also: $title_output

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

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

References $DIC, and $ilDB.

◆ _getUserIdFromActiveId()

static ilObjTest::_getUserIdFromActiveId ( $active_id )

static

Deprecated:: : use ilTestParticipantData instead

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

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

References $DIC, and $ilDB.

Referenced by assQuestion\_setReachedPoints(), sendAdvancedNotification(), and sendSimpleNotification().

Here is the caller graph for this function:

◆ _getVisitTimeOfParticipant()

ilObjTest::_getVisitTimeOfParticipant	(	$test_id,
		$active_id
	)

Returns the first and last visit of a participant.

Parameters

integer	$test_id	The database ID of the test
integer	$active_id	The active ID of the participant

Returns: array The first and last visit of a participant @access public

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

                                                                    : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->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.started",
            array('integer','integer'),
            array($test_id, $active_id)
        );
        $firstvisit = 0;
        $lastvisit = 0;
        while ($row = $ilDB->fetchAssoc($result)) {
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
            $epoch_1 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            if ($firstvisit == 0 || $epoch_1 < $firstvisit) {
                $firstvisit = $epoch_1;
            }
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
            $epoch_2 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            if ($epoch_2 > $lastvisit) {
                $lastvisit = $epoch_2;
            }
        }
        return array("firstvisit" => $firstvisit, "lastvisit" => $lastvisit);
    }

References $DIC, and $ilDB.

Referenced by getVisitTimeOfParticipant().

Here is the caller graph for this function:

◆ _getWorkingTimeOfParticipantForPass()

static ilObjTest::_getWorkingTimeOfParticipantForPass	(	$active_id,
		$pass
	)

static

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

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

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

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

References $DIC, and $ilDB.

◆ _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 4693 of file class.ilObjTest.php.

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

References assQuestion\instantiateQuestion().

Referenced by ilCourseObjectiveQuestion\__read(), duplicateQuestionForTest(), ilTestExport\exportToExcel(), getAllTestResults(), getDetailedTestResults(), getEstimatedWorkingTime(), ilCourseObjectiveQuestion\getMaxPointsByObjective(), ilCourseObjectiveQuestion\getMaxPointsByTest(), ilTestSequence\getSequenceSummary(), ilTestSequenceDynamicQuestionSet\getSequenceSummary(), and ilCourseObjectiveQuestionAssignmentTableGUI\parse().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _isComplete()

ilObjTest::_isComplete ( $obj_id )

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

                                        : bool
    {
        global $DIC;
        $tree = $DIC['tree'];
        $ilDB = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
 
        $test = new ilObjTest($obj_id, false);
        $test->loadFromDb();
 
        $testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory($tree, $ilDB, $component_repository, $test);
 
        return $test->isComplete($testQuestionSetConfigFactory->getQuestionSetConfig());
    }

References $DIC, $ilDB, and ilObject\$tree.

◆ _lookupAnonymity()

static ilObjTest::_lookupAnonymity ( $a_obj_id )

static

Returns the anonymity status of a test with a given object id.

Parameters

int $a_obj_id The object id of the test object

Returns: integer The value for the anonymity status (0 = personalized, 1 = anonymized) @access public

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

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

References $DIC, and $ilDB.

Referenced by ilObjTestAccess\_getParticipantData(), and ilTestLP\isAnonymized().

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 @access public

See also: $author

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

                                                 : string
    {
        $author = array();
        $md = new ilMD($obj_id, 0, "tst");
        $md_life = $md->getLifecycle();
        if ($md_life) {
            $ids = $md_life->getContributeIds();
            foreach ($ids as $id) {
                $md_cont = $md_life->getContribute($id);
                if (strcmp($md_cont->getRole(), "Author") == 0) {
                    $entids = $md_cont->getEntityIds();
                    foreach ($entids as $entid) {
                        $md_ent = $md_cont->getEntity($entid);
                        array_push($author, $md_ent->getEntity());
                    }
                }
            }
        }
        return join(",", $author);
    }

References $id.

Referenced by assQuestion\getInstances().

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 9927 of file class.ilObjTest.php.

                                                               : 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",
            array('integer', 'integer'),
            array($a_user_id, 1)
        );
        $all = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            $obj_id = self::_getObjectIDFromTestID($row["test_fi"]);
            $all[$obj_id] = (bool) $row["pass"];
        }
        return $all;
    }

References $DIC, and $ilDB.

◆ _lookupRandomTest()

static ilObjTest::_lookupRandomTest ( $a_obj_id )

static

Returns the fact wether the test with passed obj id is a random questions test or not.

Parameters

integer $a_obj_id

Returns: boolean $isRandomTest

Deprecated:

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

                                                       : bool
    {
        return self::lookupQuestionSetType($a_obj_id) == self::QUESTION_SET_TYPE_RANDOM;
    }

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

Here is the caller graph for this function:

◆ _lookupRandomTestFromActiveId()

ilObjTest::_lookupRandomTestFromActiveId ( $active_id )

Returns the random status of a test with a given object id.

Parameters

int $a_obj_id The object id of the test object

Returns: integer The value for the anonymity status (0 = no random, 1 = random) @access public

Deprecated:

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

                                                             : int
    {
        throw new Exception(__METHOD__ . ' is deprecated ... use ilObjTest::lookupQuestionSetTypeByActiveId() instead!');
 
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT tst_tests.random_test FROM tst_tests, tst_active WHERE tst_active.active_id = %s AND tst_active.test_fi = tst_tests.test_id",
            array('integer'),
            array($active_id)
        );
        while ($row = $ilDB->fetchAssoc($result)) {
            return $row['random_test'];
        }
        return 0;
    }

References $DIC, and $ilDB.

◆ _lookupTestObjIdForQuestionId()

static ilObjTest::_lookupTestObjIdForQuestionId ( $a_q_id )

static

Get test Object ID for question ID.

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

    {
        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",
            array('integer'),
            array($a_q_id)
        );
        $rec = $ilDB->fetchAssoc($result);
        return $rec["obj_id"] ?? null;
    }

References $DIC, and $ilDB.

◆ _setImportDirectory()

static ilObjTest::_setImportDirectory ( $a_import_dir = null )

static

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

                                                                    : void
    {
        if (strlen($a_import_dir)) {
            ilSession::set('tst_import_dir', $a_import_dir);
        } else {
            ilSession::clear('tst_import_dir');
        }
    }

References ilSession\clear(), and ilSession\set().

Referenced by ilObjTestGUI\importVerifiedFileObject(), ilTestImporter\importXmlRepresentation(), ilObjQuestionPoolGUI\uploadQplObject(), and ilObjTestGUI\uploadTst().

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 @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
        $testsettings = array(
            "TitleOutput" => $this->getTitleOutput(),
            "PassScoring" => $this->getPassScoring(),
            "IntroEnabled" => $this->isIntroductionEnabled(),
            "Introduction" => $this->getIntroduction(),
            "FinalStatement" => $this->getFinalStatement(),
            "ShowInfo" => $this->getShowInfo(),
            "ForceJS" => $this->getForceJS(),
            "CustomStyle" => $this->getCustomStyle(),
            "ShowFinalStatement" => $this->getShowFinalStatement(),
            "SequenceSettings" => $this->getSequenceSettings(),
            "ScoreReporting" => $this->getScoreReporting(),
            "ScoreCutting" => $this->getScoreCutting(),
            'SpecificAnswerFeedback' => $this->getSpecificAnswerFeedback(),
            'PrintBsWithRes' => (int) $this->isBestSolutionPrintedWithResult(),
            "InstantFeedbackSolution" => $this->getInstantFeedbackSolution(),
            "AnswerFeedback" => $this->getAnswerFeedback(),
            "AnswerFeedbackPoints" => $this->getAnswerFeedbackPoints(),
            "ResultsPresentation" => $this->getResultsPresentation(),
            "Anonymity" => $this->getAnonymity(),
            "ShowCancel" => $this->getShowCancel(),
            "ShowMarker" => $this->getShowMarker(),
            "ReportingDate" => $this->getReportingDate(),
            "NrOfTries" => $this->getNrOfTries(),
            'BlockAfterPassed' => (int) $this->isBlockPassesAfterPassedEnabled(),
            "Shuffle" => $this->getShuffleQuestions(),
            "Kiosk" => $this->getKiosk(),
            "UsePreviousAnswers" => $this->getUsePreviousAnswers(),
            "ProcessingTime" => $this->getProcessingTime(),
            "EnableProcessingTime" => $this->getEnableProcessingTime(),
            "ResetProcessingTime" => $this->getResetProcessingTime(),
            "StartingTimeEnabled" => $this->isStartingTimeEnabled(),
            "StartingTime" => $this->getStartingTime(),
            "EndingTimeEnabled" => $this->isEndingTimeEnabled(),
            "EndingTime" => $this->getEndingTime(),
            "ECTSOutput" => $this->getECTSOutput(),
            "ECTSFX" => $this->getECTSFX(),
            "ECTSGrades" => $this->getECTSGrades(),
            "questionSetType" => $this->getQuestionSetType(),
            "CountSystem" => $this->getCountSystem(),
            "mailnotification" => $this->getMailNotification(),
            "mailnottype" => $this->getMailNotificationType(),
            "exportsettings" => $this->getExportSettings(),
            "ListOfQuestionsSettings" => $this->getListOfQuestionsSettings(),
            'obligations_enabled' => (int) $this->areObligationsEnabled(),
            'offer_question_hints' => (int) $this->isOfferingQuestionHintsEnabled(),
            'pass_deletion_allowed' => (int) $this->isPassDeletionAllowed(),
            'enable_examview' => $this->getEnableExamview(),
            'show_examview_html' => $this->getShowExamviewHtml(),
            'show_examview_pdf' => $this->getShowExamviewPdf(),
            'char_selector_availability' => $this->getCharSelectorAvailability(),
            'char_selector_definition' => $this->getCharSelectorDefinition(),
            'skill_service' => (int) $this->isSkillServiceEnabled(),
            'result_tax_filters' => $this->getResultFilterTaxIds(),
            'show_grading_status' => (int) $this->isShowGradingStatusEnabled(),
            'show_grading_mark' => (int) $this->isShowGradingMarkEnabled(),
 
            'follow_qst_answer_fixation' => $this->isFollowupQuestionAnswerFixationEnabled(),
            'inst_fb_answer_fixation' => $this->isInstantFeedbackAnswerFixationEnabled(),
            'force_inst_fb' => $this->isForceInstantFeedbackEnabled(),
            'redirection_mode' => $this->getRedirectionMode(),
            'redirection_url' => $this->getRedirectionUrl(),
            'sign_submission' => $this->getSignSubmission(),
            'autosave' => (int) $this->getAutosave(),
            'autosave_ival' => $this->getAutosaveIval(),
            'examid_in_test_pass' => (int) $this->isShowExamIdInTestPassEnabled(),
            'examid_in_test_res' => (int) $this->isShowExamIdInTestResultsEnabled(),
 
            'enable_archiving' => (int) $this->getEnableArchiving(),
            'password_enabled' => (int) $this->isPasswordEnabled(),
            'password' => (string) $this->getPassword(),
            'fixed_participants' => $this->getFixedParticipants(),
            'limit_users_enabled' => $this->isLimitUsersEnabled(),
            'allowedusers' => $this->getAllowedUsers(),
            'alloweduserstimegap' => $this->getAllowedUsersTimeGap(),
            'activation_limited' => $this->isActivationLimited(),
            'activation_start_time' => $this->getActivationStartingTime(),
            'activation_end_time' => $this->getActivationEndingTime(),
            'activation_visibility' => $this->getActivationVisibility(),
            'highscore_enabled' => $this->getHighscoreEnabled(),
            'highscore_anon' => $this->getHighscoreAnon(),
            'highscore_achieved_ts' => $this->getHighscoreAchievedTS(),
            'highscore_score' => $this->getHighscoreScore(),
            'highscore_percentage' => $this->getHighscorePercentage(),
            'highscore_hints' => $this->getHighscoreHints(),
            'highscore_wtime' => $this->getHighscoreWTime(),
            'highscore_own_table' => $this->getHighscoreOwnTable(),
            'highscore_top_table' => $this->getHighscoreTopTable(),
            'highscore_top_num' => $this->getHighscoreTopNum(),
            'use_previous_answers' => (string) $this->getUsePreviousAnswers(),
            'pass_waiting' => $this->getPassWaiting()
        );
 
        $next_id = $ilDB->nextId('tst_test_defaults');
        $ilDB->insert(
            'tst_test_defaults',
            array(
                'test_defaults_id' => array('integer', $next_id),
                'name' => array('text', $a_name),
                'user_fi' => array('integer', $ilUser->getId()),
                'defaults' => array('clob', serialize($testsettings)),
                'marks' => array('clob', serialize($this->mark_schema)),
                'tstamp' => array('integer', time())
            )
        );
    }

References $DIC, $ilDB, and $ilUser.

◆ addExtraTime()

ilObjTest::addExtraTime	(	$active_id,
		$minutes
	)

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

    {
        $participantData = new ilTestParticipantData($this->db, $this->lng);
 
        $participantData->setParticipantAccessFilter(
            ilTestParticipantAccessFilter::getManageParticipantsUserFilter($this->getRefId())
        );
 
        if ($active_id) {
            $participantData->setActiveIdsFilter(array($active_id));
        }
 
        $participantData->load($this->getTestId());
 
        foreach ($participantData->getActiveIds() as $active_fi) {
            $result = $this->db->queryF(
                "SELECT active_fi FROM tst_addtime WHERE active_fi = %s",
                array('integer'),
                array($active_fi)
            );
 
            if ($result->numRows() > 0) {
                $this->db->manipulateF(
                    "DELETE FROM tst_addtime WHERE active_fi = %s",
                    array('integer'),
                    array($active_fi)
                );
            }
 
            $this->db->manipulateF(
                "UPDATE tst_active SET tries = %s, submitted = %s, submittimestamp = %s WHERE active_id = %s",
                array('integer','integer','timestamp','integer'),
                array(0, 0, null, $active_fi)
            );
 
            $this->db->manipulateF(
                "INSERT INTO tst_addtime (active_fi, additionaltime, tstamp) VALUES (%s, %s, %s)",
                array('integer','integer','integer'),
                array($active_fi, $minutes, time())
            );
 
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction(sprintf($this->lng->txtlng("assessment", "log_added_extratime", ilObjAssessmentFolder::_getLogLanguage()), $minutes, $active_id));
            }
        }
    }

References ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilTestParticipantAccessFilter\getManageParticipantsUserFilter(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ addQTIMaterial()

ilObjTest::addQTIMaterial	(	&	$a_xml_writer,
			$a_material = `''`
	)

Creates a QTI material tag from a plain text or xhtml text.

Parameters

object	$a_xml_writer	Reference to the ILIAS XML writer
string	$a_material	plain text or html text containing the material

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

    {
        $a_xml_writer->xmlStartTag("material");
        $txt = $a_material;
        $attrs = array(
            "texttype" => "text/plain"
        );
        if ($this->isHTML($a_material)) {
            $attrs["texttype"] = "text/xhtml";
            $txt = ilRTE::_replaceMediaObjectImageSrc($a_material, 0);
        }
 
        $a_xml_writer->xmlElement("mattext", $attrs, $txt);
 
        $mobs = ilObjMediaObject::_getMobsOfObject("tst:html", $this->getId());
        foreach ($mobs as $mob) {
            $moblabel = "il_" . IL_INST_ID . "_mob_" . $mob;
            if (strpos($a_material, "mm_$mob") !== false) {
                if (ilObjMediaObject::_exists($mob)) {
                    $mob_obj = new ilObjMediaObject($mob);
                    $imgattrs = array(
                        "label" => $moblabel,
                        "uri" => "objects/" . "il_" . IL_INST_ID . "_mob_" . $mob . "/" . $mob_obj->getTitle()
                    );
                }
                $a_xml_writer->xmlElement("matimage", $imgattrs, null);
            }
        }
        $a_xml_writer->xmlEndTag("material");
    }

References $mobs, $txt, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilRTE\_replaceMediaObjectImageSrc(), ILIAS\Survey\Mode\getId(), and IL_INST_ID.

Here is the call graph for this function:

◆ adjustTestSequence()

ilObjTest::adjustTestSequence ( )

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $query = "
                        SELECT COUNT(test_question_id) cnt
                        FROM tst_test_question
                        WHERE test_fi = %s
                        ORDER BY sequence
                ";
 
        $questRes = $ilDB->queryF($query, array('integer'), array($this->getTestId()));
 
        $row = $ilDB->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 = $ilDB->queryF(
                $query,
                array('integer'),
                array($this->getTestId())
            );
 
            while ($row = $ilDB->fetchAssoc($partRes)) {
                $sequence = @unserialize($row['sequence']);
 
                if (!$sequence) {
                    $sequence = array();
                }
 
                $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);
 
                $ilDB->update('tst_sequence', array(
                    'sequence' => array('clob', $new_sequence)
                ), array(
                    'active_fi' => array('integer', $row['active_fi']),
                    'pass' => array('integer', $row['pass'])
                ));
            }
        } else {
            $new_sequence = serialize($questCount > 0 ? range(1, $questCount) : array());
 
            $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 = $ilDB->queryF(
                $query,
                array('integer'),
                array($this->getTestId())
            );
 
            while ($row = $ilDB->fetchAssoc($part_rest)) {
                $ilDB->update('tst_sequence', array(
                    'sequence' => array('clob', $new_sequence)
                ), array(
                    'active_fi' => array('integer', $row['active_fi']),
                    'pass' => array('integer', $row['pass'])
                ));
            }
        }
    }

References $DIC, $i, $ilDB, and $query.

◆ allObligationsAnswered()

static ilObjTest::allObligationsAnswered	(	$test_id,
		$active_id,
		$pass
	)

static

checks wether all questions marked as obligatory were answered within the test pass with given testId, activeId and pass index

@access public @global ilDBInterface $ilDB

Parameters

integer	$test_id
integer	$active_id
integer	$pass

Returns: boolean $allObligationsAnswered

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

                                                                              : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $rset = $ilDB->queryF(
            'SELECT obligations_answered FROM tst_pass_result WHERE active_fi = %s AND pass = %s',
            array('integer', 'integer'),
            array($active_id, $pass)
        );
 
        if ($row = $ilDB->fetchAssoc($rset)) {
            return (bool) $row['obligations_answered'];
        }
 
        return !self::hasObligations($test_id);
    }

References $DIC, and $ilDB.

Referenced by ilTestPlayerAbstractGUI\finishTestCmd(), ilTestPlayerAbstractGUI\getFinishTestCommand(), and ilTestPlayerAbstractGUI\outQuestionSummaryCmd().

Here is the caller graph for this function:

◆ applyDefaults()

ilObjTest::applyDefaults ( $test_defaults )

Applies given test defaults to this test.

Parameters

array $test_default The test defaults database id.

Returns: boolean TRUE if the application succeeds, FALSE otherwise

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

                                                 : bool
    {
        $testsettings = unserialize($test_defaults["defaults"]);
        $this->mark_schema = unserialize($test_defaults["marks"]);
 
        if (array_key_exists('TitleOutput', $testsettings)) {
            $this->setTitleOutput($testsettings['TitleOutput']);
        }
 
        if (array_key_exists('IntroEnabled', $testsettings)) {
            $this->setIntroductionEnabled($testsettings['IntroEnabled']);
        }
 
        if (array_key_exists('Introduction', $testsettings)) {
            $this->setIntroduction($testsettings['Introduction'] ?? '');
        }
 
        if (array_key_exists('FinalStatement', $testsettings)) {
            $this->setFinalStatement($testsettings['FinalStatement'] ?? '');
        }
 
        if (array_key_exists('ShowInfo', $testsettings)) {
            $this->setShowInfo($testsettings['ShowInfo']);
        }
 
        if (array_key_exists('ForceJS', $testsettings)) {
            $this->setForceJS($testsettings['ForceJS']);
        }
 
        if (array_key_exists('CustomStyle', $testsettings)) {
            $this->setCustomStyle($testsettings['CustomStyle']);
        }
 
        if (array_key_exists('ShowFinalStatement', $testsettings)) {
            $this->setShowFinalStatement($testsettings['ShowFinalStatement']);
        }
 
        if (array_key_exists('SequenceSettings', $testsettings)) {
            $this->setSequenceSettings($testsettings['SequenceSettings']);
        }
 
        if (array_key_exists('SpecificAnswerFeedback', $testsettings)) {
            $this->setSpecificAnswerFeedback($testsettings['SpecificAnswerFeedback']);
        }
 
        if (array_key_exists('InstantFeedbackSolution', $testsettings)) {
            $this->setInstantFeedbackSolution($testsettings['InstantFeedbackSolution']);
        }
 
        if (array_key_exists('AnswerFeedback', $testsettings)) {
            $this->setAnswerFeedback($testsettings['AnswerFeedback']);
        }
 
        if (array_key_exists('AnswerFeedbackPoints', $testsettings)) {
            $this->setAnswerFeedbackPoints($testsettings['AnswerFeedbackPoints']);
        }
 
        if (array_key_exists('Anonymity', $testsettings)) {
            $this->setAnonymity($testsettings['Anonymity']);
        }
 
        if (array_key_exists('ShowCancel', $testsettings)) {
            $this->setShowCancel($testsettings['ShowCancel']);
        }
 
        if (array_key_exists('Shuffle', $testsettings)) {
            $this->setShuffleQuestions($testsettings['Shuffle']);
        }
 
        if (array_key_exists('ShowMarker', $testsettings)) {
            $this->setShowMarker($testsettings['ShowMarker']);
        }
 
        if (array_key_exists('ReportingDate', $testsettings)) {
            $this->setReportingDate($testsettings['ReportingDate']);
        }
 
        if (array_key_exists('NrOfTries', $testsettings)) {
            $this->setNrOfTries($testsettings['NrOfTries']);
        }
 
        if (array_key_exists('BlockAfterPassed', $testsettings)) {
            $this->setBlockPassesAfterPassedEnabled($testsettings['BlockAfterPassed']);
        }
 
        if (array_key_exists('UsePreviousAnswers', $testsettings)) {
            $this->setUsePreviousAnswers($testsettings['UsePreviousAnswers']);
        }
 
        if (array_key_exists('redirection_mode', $testsettings)) {
            $this->setRedirectionMode($testsettings['redirection_mode']);
        }
 
        if (array_key_exists('redirection_url', $testsettings)) {
            $this->setRedirectionUrl($testsettings['redirection_url']);
        }
 
        if (array_key_exists('ProcessingTime', $testsettings)) {
            $this->setProcessingTime($testsettings['ProcessingTime']);
        }
 
        if (array_key_exists('ResetProcessingTime', $testsettings)) {
            $this->setResetProcessingTime($testsettings['ResetProcessingTime']);
        }
 
        if (array_key_exists('EnableProcessingTime', $testsettings)) {
            $this->setEnableProcessingTime($testsettings['EnableProcessingTime']);
        }
 
        if (array_key_exists('StartingTimeEnabled', $testsettings)) {
            $this->setStartingTimeEnabled($testsettings['StartingTimeEnabled']);
        }
 
        if (array_key_exists('StartingTime', $testsettings)) {
            $this->setStartingTime($testsettings['StartingTime']);
        }
 
        if (array_key_exists('Kiosk', $testsettings)) {
            $this->setKiosk($testsettings['Kiosk']);
        }
 
        if (array_key_exists('EndingTimeEnabled', $testsettings)) {
            $this->setEndingTimeEnabled($testsettings['EndingTimeEnabled']);
        }
 
        if (array_key_exists('EndingTime', $testsettings)) {
            $this->setEndingTime($testsettings['EndingTime']);
        }
 
        if (array_key_exists('ECTSOutput', $testsettings)) {
            $this->setECTSOutput($testsettings['ECTSOutput']);
        }
 
        if (array_key_exists('ECTSFX', $testsettings)) {
            $this->setECTSFX($testsettings['ECTSFX']);
        }
 
        if (array_key_exists('ECTSGrades', $testsettings)) {
            $this->setECTSGrades($testsettings['ECTSGrades']);
        }
 
        if (isset($testsettings["isRandomTest"])) {
            if ($testsettings["isRandomTest"]) {
                $this->setQuestionSetType(self::QUESTION_SET_TYPE_RANDOM);
            } else {
                $this->setQuestionSetType(self::QUESTION_SET_TYPE_FIXED);
            }
        } elseif (isset($testsettings["questionSetType"])) {
            $this->setQuestionSetType($testsettings["questionSetType"]);
        }
 
        if (array_key_exists('mailnotification', $testsettings)) {
            $this->setMailNotification($testsettings['mailnotification']);
        }
 
        if (array_key_exists('mailnottype', $testsettings)) {
            $this->setMailNotificationType($testsettings['mailnottype']);
        }
 
        if (array_key_exists('exportsettings', $testsettings)) {
            $this->setExportSettings($testsettings['exportsettings']);
        }
 
        if (array_key_exists('ListOfQuestionsSettings', $testsettings)) {
            $this->setListOfQuestionsSettings($testsettings['ListOfQuestionsSettings']);
        }
 
        if (array_key_exists('obligations_enabled', $testsettings)) {
            $this->setObligationsEnabled($testsettings['obligations_enabled']);
        }
 
        if (array_key_exists('offer_question_hints', $testsettings)) {
            $this->setOfferingQuestionHintsEnabled($testsettings['offer_question_hints']);
        }
 
        if (isset($testsettings['examid_in_kiosk'])) {
            $this->setShowExamIdInTestPassEnabled($testsettings['examid_in_kiosk']);
        } else {
            $this->setShowExamIdInTestPassEnabled($testsettings['examid_in_test_pass']);
        }
 
        if (array_key_exists('enable_examview', $testsettings)) {
            $this->setEnableExamview($testsettings['enable_examview']);
        }
 
        if (array_key_exists('show_examview_html', $testsettings)) {
            $this->setShowExamviewHtml($testsettings['show_examview_html']);
        }
 
        if (array_key_exists('show_examview_pdf', $testsettings)) {
            $this->setShowExamviewPdf($testsettings['show_examview_pdf']);
        }
 
        if (array_key_exists('enable_archiving', $testsettings)) {
            $this->setEnableArchiving($testsettings['enable_archiving']);
        }
 
        if (array_key_exists('sign_submission', $testsettings)) {
            $this->setSignSubmission($testsettings['sign_submission']);
        }
 
        if (array_key_exists('char_selector_availability', $testsettings)) {
            $this->setCharSelectorAvailability($testsettings['char_selector_availability']);
        }
 
        if (array_key_exists('char_selector_definition', $testsettings)) {
            $this->setCharSelectorDefinition($testsettings['char_selector_definition']);
        }
 
        if (array_key_exists('skill_service', $testsettings)) {
            $this->setSkillServiceEnabled((bool) $testsettings['skill_service']);
        }
 
        if (array_key_exists('show_grading_status', $testsettings)) {
            $this->setShowGradingStatusEnabled((bool) $testsettings['show_grading_status']);
        }
 
        if (array_key_exists('show_grading_mark', $testsettings)) {
            $this->setShowGradingMarkEnabled((bool) $testsettings['show_grading_mark']);
        }
 
        if (array_key_exists('follow_qst_answer_fixation', $testsettings)) {
            $this->setFollowupQuestionAnswerFixationEnabled($testsettings['follow_qst_answer_fixation']);
        }
 
        if (array_key_exists('inst_fb_answer_fixation', $testsettings)) {
            $this->setInstantFeedbackAnswerFixationEnabled($testsettings['inst_fb_answer_fixation']);
        }
 
        if (array_key_exists('force_inst_fb', $testsettings)) {
            $this->setForceInstantFeedbackEnabled($testsettings['force_inst_fb']);
        }
 
        if (array_key_exists('redirection_mode', $testsettings)) {
            $this->setRedirectionMode($testsettings['redirection_mode']);
        }
 
        if (array_key_exists('redirection_url', $testsettings)) {
            $this->setRedirectionUrl($testsettings['redirection_url']);
        }
 
        if (array_key_exists('autosave', $testsettings)) {
            $this->setAutosave($testsettings['autosave']);
        }
 
        if (array_key_exists('autosave_ival', $testsettings)) {
            $this->setAutosaveIval($testsettings['autosave_ival']);
        }
 
        if (array_key_exists('password_enabled', $testsettings)) {
            $this->setPasswordEnabled($testsettings['password_enabled']);
        }
 
        if (array_key_exists('password', $testsettings)) {
            $this->setPassword($testsettings['password']);
        }
 
        if (array_key_exists('fixed_participants', $testsettings)) {
            $this->setFixedParticipants($testsettings['fixed_participants']);
        }
 
        if (array_key_exists('limit_users_enabled', $testsettings)) {
            $this->setLimitUsersEnabled($testsettings['limit_users_enabled']);
        }
 
        if (array_key_exists('allowedusers', $testsettings)) {
            $this->setAllowedUsers($testsettings['allowedusers']);
        }
 
        if (array_key_exists('alloweduserstimegap', $testsettings)) {
            $this->setAllowedUsersTimeGap($testsettings['alloweduserstimegap']);
        }
 
        if (array_key_exists('use_previous_answers', $testsettings)) {
            $this->setUsePreviousAnswers($testsettings['use_previous_answers']);
        }
 
        if (array_key_exists('activation_limited', $testsettings)) {
            $this->setActivationLimited($testsettings['activation_limited']);
        }
 
        if (array_key_exists('activation_start_time', $testsettings)) {
            $this->setActivationStartingTime($testsettings['activation_start_time']);
        }
 
        if (array_key_exists('activation_end_time', $testsettings)) {
            $this->setActivationEndingTime($testsettings['activation_end_time']);
        }
 
        if (array_key_exists('activation_visibility', $testsettings)) {
            $this->setActivationVisibility($testsettings['activation_visibility']);
        }
 
        if (array_key_exists('pass_waiting', $testsettings)) {
            $this->setPassWaiting($testsettings['pass_waiting']);
        }
 
        $settings = $this->getScoreSettings();
        $exam_id_in_results = false;
        if (array_key_exists('show_exam_id', $testsettings)) {
            $exam_id_in_results = (bool) $testsettings['show_exam_id'];
        } elseif (array_key_exists('examid_in_test_res', $testsettings)) {
            $exam_id_in_results = (bool) $testsettings['examid_in_test_res'];
        }
 
        $settings = $settings
            ->withScoringSettings(
                $settings->getScoringSettings()
                ->withPassScoring((bool) $testsettings["PassScoring"])
                ->withScoreCutting((bool) $testsettings['ScoreCutting'])
                ->withCountSystem((bool) $testsettings["CountSystem"])
            )
            ->withResultSummarySettings(
                $settings->getResultSummarySettings()
                ->withPassDeletionAllowed($testsettings['pass_deletion_allowed'])
            )
            ->withResultDetailsSettings(
                $settings->getResultDetailsSettings()
                ->withPrintBestSolutionWithResult((bool) $testsettings['PrintBsWithRes'])
                ->withShowExamIdInTestResults($exam_id_in_results)
                ->withTaxonomyFilterIds((array) $testsettings['result_tax_filters'])
            )
            ->withGamificationSettings(
                $settings->getGamificationSettings()
                ->withHighscoreEnabled($testsettings['highscore_enabled'])
                ->withHighscoreAnon($testsettings['highscore_anon'])
                ->withHighscoreAchievedTS($testsettings['highscore_achieved_ts'])
                ->withHighscoreScore($testsettings['highscore_score'])
                ->withHighscorePercentage($testsettings['highscore_percentage'])
                ->withHighscoreHints($testsettings['highscore_hints'])
                ->withHighscoreWTime($testsettings['highscore_wtime'])
                ->withHighscoreOwnTable($testsettings['highscore_own_table'])
                ->withHighscoreTopTable($testsettings['highscore_top_table'])
                ->withHighscoreTopNum($testsettings['highscore_top_num'])
            )
        ;
        $this->getScoreSettingsRepository()->store($settings);
        $this->saveToDb();
 
        return true;
    }

References ILIAS\LTI\ToolProvider\$settings.

◆ areObligationsEnabled()

ilObjTest::areObligationsEnabled ( )

returns the fact wether obligations are enabled or not

Returns: boolean

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

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

Referenced by saveToDb().

Here is the caller graph for this function:

◆ buildExamId()

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

static

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

                                                                              : 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;
    }

References $DIC, and $ilSetting.

Referenced by ilTestPlayerAbstractGUI\getKioskHead().

Here is the caller graph for this function:

◆ buildIso8601PeriodFromUnixtimeForExportCompatibility()

ilObjTest::buildIso8601PeriodFromUnixtimeForExportCompatibility ( $unix_timestamp )

protected

Parameters

$unix_timestamp

Returns: string

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

                                                                                            : string
    {
        $date_time_unix = new ilDateTime($unix_timestamp, IL_CAL_UNIX);
        $date_time = $date_time_unix->get(IL_CAL_DATETIME);
        preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $date_time, $matches);
        $iso8601_period = sprintf("P%dY%dM%dDT%dH%dM%dS", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]);
        return $iso8601_period;
    }

References IL_CAL_DATETIME, and IL_CAL_UNIX.

◆ buildName()

ilObjTest::buildName	(	$user_id,
		$firstname,
		$lastname,
		$title
	)

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 @access public

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

                                                                      : string
    {
        $name = "";
        if (strlen($firstname . $lastname . $title) == 0) {
            $name = $this->lng->txt("deleted_user");
        } else {
            if ($user_id == ANONYMOUS_USER_ID) {
                $name = $lastname;
            } else {
                $name = trim($lastname . ", " . $firstname . " " . $title);
            }
            if ($this->getAnonymity()) {
                $name = $this->lng->txt("anonymous");
            }
        }
        return $name;
    }

References $name, ANONYMOUS_USER_ID, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ buildStatisticsAccessFilteredParticipantList()

ilObjTest::buildStatisticsAccessFilteredParticipantList ( )

Returns: ilTestParticipantList

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

                                                                  : ilTestParticipantList
    {
        $list = new ilTestParticipantList($this);
        $list->initializeFromDbRows($this->getTestParticipants());
 
        $list = $list->getAccessFilteredList(
            ilTestParticipantAccessFilter::getAccessStatisticsUserFilter($this->getRefId())
        );
 
        return $list;
    }

References ilTestParticipantAccessFilter\getAccessStatisticsUserFilter().

Here is the call graph for this function:

◆ canEditEctsGrades()

ilObjTest::canEditEctsGrades ( )

{}

Implements ilEctsGradesEnabled.

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

                                       : bool
    {
        return $this->canShowEctsGrades() && $this->canEditMarks();
    }

◆ canEditMarks()

ilObjTest::canEditMarks ( )

Returns: {}

Implements ilMarkSchemaAware.

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

                                  : bool
    {
        $total = $this->evalTotalPersons();
        if ($total > 0) {
            $reporting_date = $this->getScoreSettings()->getResultSummarySettings()->getReportingDate();
            if ($reporting_date !== null) {
                return $reporting_date <= new DateTimeImmutable('now', new DateTimeZone('UTC'));
            }
            return false;
        } else {
            return true;
        }
    }

◆ canShowEctsGrades()

ilObjTest::canShowEctsGrades ( )

{}

Implements ilEctsGradesEnabled.

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

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

◆ canShowSolutionPrintview()

ilObjTest::canShowSolutionPrintview ( $user_id = null )

Deprecated:

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

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

◆ canShowTestResults()

ilObjTest::canShowTestResults ( ilTestSession $testSession )

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

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

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

Referenced by ilTestSession\reportableResultsAvailable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkMarks()

ilObjTest::checkMarks ( )

{

Returns: boolean|string True or an error string which can be used for display purposes

}

Implements ilMarkSchemaAware.

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

    {
        return $this->mark_schema->checkMarks();
    }

◆ checkMaximumAllowedUsers()

ilObjTest::checkMaximumAllowedUsers ( )

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

                                              : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $nr_of_users = $this->getAllowedUsers();
        $time_gap = ($this->getAllowedUsersTimeGap()) ? $this->getAllowedUsersTimeGap() : 60;
        if (($nr_of_users > 0) && ($time_gap > 0)) {
            $now = time();
            $time_border = $now - $time_gap;
            $str_time_border = date("YmdHis", $time_border);
            $query = "
                                SELECT DISTINCT tst_times.active_fi
                                FROM tst_times
                                INNER JOIN tst_active
                                ON tst_times.active_fi = tst_active.active_id
                                AND (
                                        tst_times.pass > tst_active.last_finished_pass OR tst_active.last_finished_pass IS NULL
                                )
                                WHERE tst_times.tstamp > %s
                                AND tst_active.test_fi = %s
                        ";
            $result = $ilDB->queryF($query, array('integer', 'integer'), array($time_border, $this->getTestId()));
            if ($result->numRows() >= $nr_of_users) {
                if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                    $this->logAction($this->lng->txtlng("assessment", "log_could_not_enter_test_due_to_simultaneous_users", ilObjAssessmentFolder::_getLogLanguage()));
                }
                return false;
            } else {
                return true;
            }
        }
        return true;
    }

References $DIC, $ilDB, $query, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ checkQuestionParent()

ilObjTest::checkQuestionParent ( $questionId )

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

                                                    : bool
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $row = $DIC->database()->fetchAssoc($DIC->database()->queryF(
            "SELECT COUNT(question_id) cnt FROM qpl_questions WHERE question_id = %s AND obj_fi = %s",
            array('integer', 'integer'),
            array($questionId, $this->getId())
        ));
 
        return (bool) $row['cnt'];
    }

References $DIC, and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ cleanupMediaobjectUsage()

ilObjTest::cleanupMediaobjectUsage ( )

Cleans up the media objects for all text fields in a test which are using an RTE field.

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

                                             : void
    {
        $completecontent = "";
        foreach ($this->getAllRTEContent() as $content) {
            $completecontent .= $content;
        }
        ilRTE::_cleanupMediaObjectUsage(
            $completecontent,
            $this->getType() . ":html",
            $this->getId()
        );
    }

References ilRTE\_cleanupMediaObjectUsage(), getAllRTEContent(), ilObject\getId(), and ilObject\getType().

Referenced by saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ create()

ilObjTest::create ( )

note: title, description and type should be set when this function is called

Reimplemented from ilObject.

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

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

References ilObject\$id, ilObject\createMetaData(), and ilObject\setOfflineStatus().

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 491 of file class.ilObjTest.php.

                                           : 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);
        }
    }

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

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 @access public

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

                                                                        : ?assQuestionGUI
    {
        if ((!$question_type) and ($question_id > 0)) {
            $question_type = $this->getQuestionType($question_id);
        }
 
        if (!strlen($question_type)) {
            return null;
        }
 
        assQuestion::_includeClass($question_type, 1);
 
        $question_type_gui = $question_type . 'GUI';
        $question = new $question_type_gui();
 
        if ($question_id > 0) {
            $question->object->loadFromDb($question_id);
 
            global $DIC;
            $ilCtrl = $DIC['ilCtrl'];
            $ilDB = $DIC['ilDB'];
            $ilUser = $DIC['ilUser'];
            $lng = $DIC['lng'];
 
            $feedbackObjectClassname = assQuestion::getFeedbackClassNameByQuestionType($question_type);
            $question->object->feedbackOBJ = new $feedbackObjectClassname($question->object, $ilCtrl, $ilDB, $lng);
 
            $assSettings = new ilSetting('assessment');
            $processLockerFactory = new ilAssQuestionProcessLockerFactory($assSettings, $ilDB);
            $processLockerFactory->setQuestionId($question->object->getId());
            $processLockerFactory->setUserId($ilUser->getId());
            $processLockerFactory->setAssessmentLogEnabled(ilObjAssessmentFolder::_enabledAssessmentLogging());
            $question->object->setProcessLocker($processLockerFactory->getLocker());
        }
 
        return $question;
    }

References $DIC, $ilDB, $ilUser, $lng, ilObjAssessmentFolder\_enabledAssessmentLogging(), assQuestion\_includeClass(), and assQuestion\getFeedbackClassNameByQuestionType().

Here is the call graph for this function:

◆ createTestSequence()

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

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

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

◆ delete()

ilObjTest::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!!

Returns: bool true if object was removed completely; false if only a references was removed

Reimplemented from ilObject.

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

                            : 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();
 
        return true;
    }

References ilObject\deleteMetaData(), deleteTest(), and ilObject\getId().

Here is the call graph for this function:

◆ deleteDefaults()

ilObjTest::deleteDefaults ( $test_default_id )

Deletes the defaults for a test.

Parameters

integer $test_default_id The database ID of the test defaults @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $affectedRows = $ilDB->manipulateF(
            "DELETE FROM tst_test_defaults WHERE test_defaults_id = %s",
            array('integer'),
            array($test_default_id)
        );
    }

References $DIC, and $ilDB.

◆ deleteTest()

ilObjTest::deleteTest ( )

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

                                : void
    {
        global $DIC;
        $tree = $DIC['tree'];
        $ilDB = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
        $lng = $DIC['lng'];
 
        $participantData = new ilTestParticipantData($ilDB, $lng);
        $participantData->load($this->getTestId());
        $this->removeTestResults($participantData);
 
        $ilDB->manipulateF(
            "DELETE FROM tst_mark WHERE test_fi = %s",
            array('integer'),
            array($this->getTestId())
        );
 
        $ilDB->manipulateF(
            "DELETE FROM tst_tests WHERE test_id = %s",
            array('integer'),
            array($this->getTestId())
        );
 
        $testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory($tree, $ilDB, $component_repository, $this);
        $testQuestionSetConfigFactory->getQuestionSetConfig()->removeQuestionSetRelatedData();
 
        $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();
            }
        }
    }

References $DIC, $ilDB, ilObject\$lng, $mobs, ilObject\$tree, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilFileUtils\delDir(), ilFileUtils\getDataDir(), ilObject\getId(), getTestId(), and removeTestResults().

Referenced by 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 @access public

@noinspection PhpUndefinedFieldInspection

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

                                                        : bool
    {
        global $DIC;
        $ilLog = $DIC['ilLog'];
 
        $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) {
            $ilLog->write(__METHOD__ . ': ' . $e->getMessage());
            return false;
        }
    }

References $DIC, Vendor\Package\$e, $filename, ilUtil\deliverData(), ilRpcClientFactory\factory(), ilFileUtils\getASCIIFilename(), and ilFileUtils\ilTempnam().

Here is the call graph for this function:

◆ deliverPDFfromHTML()

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

Delivers a PDF file from XHTML.

Parameters

string $html The XHTML string @access public

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

    {
        $content = preg_replace("/href=\".*?\"/", "", $content);
        $printbody = new ilTemplate("tpl.il_as_tst_print_body.html", true, true, "Modules/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 = array(
                "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);
    }

References $config, ilUtil\getStyleSheetLocation(), and ilLegacyFormElementsUtil\prepareFormOutput().

Here is the call graph for this function:

◆ disinviteUser()

ilObjTest::disinviteUser ( $user_id )

Disinvites a user from a test.

Parameters

integer $user_id The database id of the disinvited user @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $affectedRows = $ilDB->manipulateF(
            "DELETE FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
            array('integer', 'integer'),
            array($this->getTestId(), $user_id)
        );
    }

References $DIC, and $ilDB.

◆ doCreateMetaData()

ilObjTest::doCreateMetaData ( )

protected

@inheritDoc

Reimplemented from ilObject.

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

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

◆ 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 2812 of file class.ilObjTest.php.

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

References _instanciateQuestion(), and ILIAS\Survey\Mode\getId().

Here is the call 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 @access public

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

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

◆ ensureParticipantsLastActivePassFinished()

static ilObjTest::ensureParticipantsLastActivePassFinished	(	$testObjId,
		$userId,
		$a_force_new_run = `false`
	)

static

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

                                                                                                                  : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $refinery = $DIC['refinery'];
        $component_repository = $DIC['component.repository'];
 
        /* @var ilObjTest $testOBJ */
 
        $testOBJ = ilObjectFactory::getInstanceByRefId($testObjId, false);
 
        $activeId = $testOBJ->getActiveIdOfUser($userId);
 
        $testSessionFactory = new ilTestSessionFactory($testOBJ);
 
        $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $component_repository, $testOBJ);
 
        $testSession = $testSessionFactory->getSession($activeId);
        $testSequence = $testSequenceFactory->getSequenceByActiveIdAndPass($activeId, $testSession->getPass());
        $testSequence->loadFromDb();
 
        // begin-patch lok changed smeyer
        if ($a_force_new_run) {
            if ($testSequence->hasSequence()) {
                $testSession->increasePass();
            }
            $testSession->setLastSequence(0);
            $testSession->saveToDb();
        }
        // end-patch lok
    }

References $DIC, $ilDB, $lng, ILIAS\Repository\$refinery, and ilObjectFactory\getInstanceByRefId().

Here is the call graph for this function:

◆ evalResultsOverview()

& ilObjTest::evalResultsOverview ( )

Creates an associated array with the results of all participants of a test.

Returns: array An associated array containing the results @access public

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

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

◆ evalResultsOverviewOfParticipant()

& ilObjTest::evalResultsOverviewOfParticipant ( $active_id )

Creates an associated array with the results for a given participant of a test.

Parameters

integer $active_id The active id of the participant

Returns: array An associated array containing the results @access public

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

                                                                 : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT usr_data.usr_id, usr_data.firstname, usr_data.lastname, usr_data.title, usr_data.login, " .
            "tst_test_result.*, qpl_questions.original_id, qpl_questions.title questiontitle, " .
            "qpl_questions.points maxpoints " .
            "FROM tst_test_result, qpl_questions, tst_active " .
            "LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id " .
            "WHERE tst_active.active_id = tst_test_result.active_fi " .
            "AND qpl_questions.question_id = tst_test_result.question_fi " .
            "AND tst_active.test_fi = %s AND tst_active.active_id = %s" .
            "ORDER BY tst_active.active_id, tst_test_result.pass, tst_test_result.tstamp",
            array('integer', 'integer'),
            array($this->getTestId(), $active_id)
        );
        $overview = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            if (!array_key_exists($row["active_fi"], $overview)) {
                $overview[$row["active_fi"]] = array();
                $overview[$row["active_fi"]]["firstname"] = $row["firstname"];
                $overview[$row["active_fi"]]["lastname"] = $row["lastname"];
                $overview[$row["active_fi"]]["title"] = $row["title"];
                $overview[$row["active_fi"]]["login"] = $row["login"];
                $overview[$row["active_fi"]]["usr_id"] = $row["usr_id"];
                $overview[$row["active_fi"]]["started"] = $row["started"];
                $overview[$row["active_fi"]]["finished"] = $row["finished"];
            }
            if (!array_key_exists($row["pass"], $overview[$row["active_fi"]])) {
                $overview[$row["active_fi"]][$row["pass"]] = array();
                $overview[$row["active_fi"]][$row["pass"]]["reached"] = 0;
                $overview[$row["active_fi"]][$row["pass"]]["maxpoints"] = $row["maxpoints"];
            }
            array_push($overview[$row["active_fi"]][$row["pass"]], $row);
            $overview[$row["active_fi"]][$row["pass"]]["reached"] += $row["points"];
        }
        return $overview;
    }

References $DIC, and $ilDB.

◆ evalStatistical()

ilObjTest::evalStatistical ( $active_id )

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

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

                                               : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        //              $ilBench = $DIC['ilBench'];
        $pass = ilObjTest::_getResultPass($active_id);
        $test_result = &$this->getTestResult($active_id, $pass);
        $result = $ilDB->queryF(
            "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.active_id = %s AND tst_active.active_id = tst_times.active_fi",
            array('integer'),
            array($active_id)
        );
        $times = array();
        $first_visit = 0;
        $last_visit = 0;
        while ($row = $ilDB->fetchObject($result)) {
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
            $epoch_1 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $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($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $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->mark_schema->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;
        }
 
        $obligationsAnswered = $test_result["test"]["obligations_answered"];
 
        $result_mark = "";
        $passed = "";
 
        if ($mark_obj) {
            $result_mark = $mark_obj->getShortName();
 
            if ($mark_obj->getPassed() && $obligationsAnswered) {
                $passed = 1;
            } else {
                $passed = 0;
            }
        }
        $percent_worked_through = 0;
        if (count($this->questions)) {
            $percent_worked_through = $qworkedthrough / count($this->questions);
        }
        $result_array = 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;
    }

References $DIC, $ilDB, ILIAS\LTI\ToolProvider\$key, and _getResultPass().

Here is the call graph for this function:

◆ evalTotalParticipantsArray()

ilObjTest::evalTotalParticipantsArray ( $name_sort_order = "asc" )

Returns all participants who started the test.

Returns: array The active user id's and names of the persons who started the test

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

                                                                        : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->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),
            array('integer'),
            array($this->getTestId())
        );
        $persons_array = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            if ($this->getAnonymity()) {
                $persons_array[$row["active_id"]] = array("name" => $this->lng->txt("anonymous"));
            } else {
                if (strlen($row["firstname"] . $row["lastname"] . $row["title"]) == 0) {
                    $persons_array[$row["active_id"]] = array("name" => $this->lng->txt("deleted_user"));
                } else {
                    if ($row["user_fi"] == ANONYMOUS_USER_ID) {
                        $persons_array[$row["active_id"]] = array("name" => $row["lastname"]);
                    } else {
                        $persons_array[$row["active_id"]] = array("name" => trim($row["lastname"] . ", " . $row["firstname"] . " " . $row["title"]), "login" => $row["login"]);
                    }
                }
            }
        }
        return $persons_array;
    }

References $DIC, $ilDB, ANONYMOUS_USER_ID, and ILIAS\Repository\lng().

Here is the call 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 @access public

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

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

References $DIC, and $ilDB.

Referenced by saveToDb().

Here is the caller graph for this function:

◆ evalTotalPersonsArray()

ilObjTest::evalTotalPersonsArray ( $name_sort_order = "asc" )

Returns all persons who started the test.

Returns: array The user id's and names of the persons who started the test @access public

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

                                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->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),
            array('integer'),
            array($this->getTestId())
        );
        $persons_array = array();
        while ($row = $ilDB->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;
    }

References $DIC, $ilDB, ANONYMOUS_USER_ID, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ evalTotalStartedAverageTime()

ilObjTest::evalTotalStartedAverageTime ( $activeIdsFilter = null )

Returns the average processing time for all started tests.

Returns: integer The average processing time for all started tests @access public

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

                                                                        : int
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $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 (is_array($activeIdsFilter) && count($activeIdsFilter)) {
            $query .= " AND " . $DIC->database()->in('active_id', $activeIdsFilter, false, 'integer');
        }
 
        $result = $DIC->database()->queryF($query, array('integer'), array($this->getTestId()));
        $times = array();
        while ($row = $DIC->database()->fetchObject($result)) {
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
            $epoch_1 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->finished, $matches);
            $epoch_2 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $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 $key => $value) {
            $max_time += $value;
            $counter++;
        }
        if ($counter) {
            $average_time = round($max_time / $counter);
        } else {
            $average_time = 0;
        }
        return $average_time;
    }

References $DIC, ILIAS\LTI\ToolProvider\$key, and $query.

◆ exportFileItems()

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

export files of file itmes

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

    {
        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($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);
        }
    }

References IL_INST_ID, and ilFileUtils\makeDir().

Here is the call 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 5815 of file class.ilObjTest.php.

    {
        global $DIC;
        $ilBench = $DIC['ilBench'];
 
        $this->mob_ids = array();
        $this->file_ids = array();
 
        // MetaData
        $this->exportXMLMetaData($a_xml_writer);
 
        // PageObjects
        $expLog->write(date("[y-m-d H:i:s] ") . "Start Export Page Objects");
        $ilBench->start("ContentObjectExport", "exportPageObjects");
        $this->exportXMLPageObjects($a_xml_writer, $a_inst, $expLog);
        $ilBench->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");
        $ilBench->start("ContentObjectExport", "exportMediaObjects");
        $this->exportXMLMediaObjects($a_xml_writer, $a_inst, $a_target_dir, $expLog);
        $ilBench->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");
        $ilBench->start("ContentObjectExport", "exportFileItems");
        $this->exportFileItems($a_target_dir, $expLog);
        $ilBench->stop("ContentObjectExport", "exportFileItems");
        $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export File Items");
    }

References $DIC.

◆ exportXMLMediaObjects()

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

export media objects to xml (see ilias_co.dtd)

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

    {
        foreach ($this->mob_ids as $mob_id) {
            $expLog->write(date("[y-m-d H:i:s] ") . "Media Object " . $mob_id);
            if (ilObjMediaObject::_exists($mob_id)) {
                $media_obj = new ilObjMediaObject($mob_id);
                $media_obj->exportXML($a_xml_writer, $a_inst);
                $media_obj->exportFiles($a_target_dir);
                unset($media_obj);
            }
        }
    }

References ilObjMediaObject\_exists().

Here is the call graph for this function:

◆ exportXMLMetaData()

ilObjTest::exportXMLMetaData ( & $a_xml_writer )

export content objects meta data to xml (see ilias_co.dtd)

Parameters

object $a_xml_writer ilXmlWriter object that receives the xml data

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

    {
        $md2xml = new ilMD2XML($this->getId(), 0, $this->getType());
        $md2xml->setExportMode(true);
        $md2xml->startExport();
        $a_xml_writer->appendXML($md2xml->getXML());
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ exportXMLPageObjects()

ilObjTest::exportXMLPageObjects	(	&	$a_xml_writer,
			$a_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 5883 of file class.ilObjTest.php.

    {
        global $DIC;
        $ilBench = $DIC['ilBench'];
 
        foreach ($this->questions as $question_id) {
            $ilBench->start("ContentObjectExport", "exportPageObject");
            $expLog->write(date("[y-m-d H:i:s] ") . "Page Object " . $question_id);
 
            $attrs = array();
            $a_xml_writer->xmlStartTag("PageObject", $attrs);
 
 
            // export xml to writer object
            $ilBench->start("ContentObjectExport", "exportPageObject_XML");
            $page_object = new ilAssQuestionPage($question_id);
            $page_object->buildDom();
            $page_object->insertInstIntoIDs($a_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);
 
            $ilBench->stop("ContentObjectExport", "exportPageObject_XML");
 
            // collect media objects
            $ilBench->start("ContentObjectExport", "exportPageObject_CollectMedia");
            //$mob_ids = $page_obj->getMediaObjectIDs();
            foreach ($mob_ids as $mob_id) {
                $this->mob_ids[$mob_id] = $mob_id;
            }
            $ilBench->stop("ContentObjectExport", "exportPageObject_CollectMedia");
 
            // collect all file items
            $ilBench->start("ContentObjectExport", "exportPageObject_CollectFileItems");
            //$file_ids = $page_obj->getFileItemIds();
            foreach ($file_ids as $file_id) {
                $this->file_ids[$file_id] = $file_id;
            }
            $ilBench->stop("ContentObjectExport", "exportPageObject_CollectFileItems");
 
            $a_xml_writer->xmlEndTag("PageObject");
            //unset($page_obj);
 
            $ilBench->stop("ContentObjectExport", "exportPageObject");
        }
    }

References $DIC, $xml, and ilPCFileList\collectFileItems().

Here is the call graph for this function:

◆ fromXML()

ilObjTest::fromXML ( ilQTIAssessment $assessment )

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

Parameters

ilQTIAssessment $assessment

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

    {
        ilSession::clear('import_mob_xhtml');
 
        $this->setDescription($assessment->getComment());
        $this->setTitle($assessment->getTitle());
 
        $this->setIntroductionEnabled(false);
        foreach ($assessment->objectives as $objectives) {
            foreach ($objectives->materials as $material) {
                $intro = $this->QTIMaterialToString($material);
                $this->setIntroduction($intro);
                $this->setIntroductionEnabled(strlen($intro) > 0);
            }
        }
 
        if (
            $assessment->getPresentationMaterial() &&
            $assessment->getPresentationMaterial()->getFlowMat(0) &&
            $assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)
        ) {
            $this->setFinalStatement($this->QTIMaterialToString($assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)));
        }
 
        foreach ($assessment->assessmentcontrol as $assessmentcontrol) {
            switch ($assessmentcontrol->getSolutionswitch()) {
                case "Yes":
                    $this->setInstantFeedbackSolution(1);
                    break;
                default:
                    $this->setInstantFeedbackSolution(0);
                    break;
            }
        }
 
        $this->setStartingTimeEnabled(false);
        $this->setEndingTimeEnabled(false);
        $this->setPasswordEnabled(false);
        $this->setLimitUsersEnabled(false);
 
        $this->saveToDb();
        $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();
        foreach ($assessment->qtimetadata as $metadata) {
            switch ($metadata["label"]) {
                case "test_type":
                    // for old tests with a test type
                    $type = $metadata["entry"];
                    switch ($type) {
                        case 1:
                            // assessment
                            $this->setAnonymity(1);
                            break;
                        case 2:
                            // self assessment
                            break;
                        case 4:
                            // online exam
                            $this->setFixedParticipants(1);
                            $this->setListOfQuestionsSettings(7);
                            break;
                        case 5:
                            // varying random test
                            break;
                    }
                    break;
                case "sequence_settings":
                    $this->setSequenceSettings((int) $metadata["entry"]);
                    break;
                case "solution_details":
                    $result_details_settings = $result_details_settings->withShowSolutionDetails((bool) $metadata["entry"]);
                    break;
                case "print_bs_with_res":
                    $result_details_settings = $result_details_settings->withPrintBestSolutionWithResult((bool) $metadata["entry"]);
                    break;
                case "author":
                    $this->setAuthor($metadata["entry"]);
                    break;
                case "nr_of_tries":
                    $this->setNrOfTries($metadata["entry"]);
                    break;
                case 'block_after_passed':
                    $this->setBlockPassesAfterPassedEnabled((bool) $metadata['entry']);
                    break;
                case "pass_waiting":
                    $this->setPassWaiting($metadata["entry"]);
                    break;
                case "kiosk":
                    $this->setKiosk($metadata["entry"]);
                    break;
                case "showfinalstatement":
                    $this->setShowFinalStatement($metadata["entry"]);
                    break;
                case "showinfo":
                    $this->setShowInfo($metadata["entry"]);
                    break;
                case "forcejs":
                    $this->setForceJS($metadata["entry"]);
                    break;
                case "customstyle":
                    $this->setCustomStyle($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 "hide_previous_results":
                    if ($metadata["entry"] == 0) {
                        $this->setUsePreviousAnswers(1);
                    } else {
                        $this->setUsePreviousAnswers(0);
                    }
                    break;
                case "use_previous_answers":
                    $this->setUsePreviousAnswers($metadata["entry"]);
                    break;
                case "answer_feedback":
                    $this->setAnswerFeedback($metadata["entry"]);
                    break;
                case "title_output":
                case "hide_title_points":
                    $this->setTitleOutput($metadata["entry"]);
                    break;
                case "question_set_type":
                    $this->setQuestionSetType($metadata["entry"]);
                    break;
                case "random_test":
                    if ($metadata["entry"]) {
                        $this->setQuestionSetType(self::QUESTION_SET_TYPE_RANDOM);
                    } else {
                        $this->setQuestionSetType(self::QUESTION_SET_TYPE_FIXED);
                    }
                    break;
                case "results_presentation":
                    $result_details_settings = $result_details_settings->withResultsPresentation((int) $metadata["entry"]);
                    break;
                case "reset_processing_time":
                    $this->setResetProcessingTime($metadata["entry"]);
                    break;
                case "instant_verification":
                    $this->setInstantFeedbackSolution($metadata["entry"]);
                    break;
                case "follow_qst_answer_fixation":
                    $this->setFollowupQuestionAnswerFixationEnabled((bool) $metadata["entry"]);
                    break;
                case "instant_feedback_answer_fixation":
                    $this->setInstantFeedbackAnswerFixationEnabled((bool) $metadata["entry"]);
                    break;
                case "force_instant_feedback":
                    $this->setForceInstantFeedbackEnabled((bool) $metadata["entry"]);
                    break;
                case "answer_feedback_points":
                    $this->setAnswerFeedbackPoints($metadata["entry"]);
                    break;
                case "anonymity":
                    $this->setAnonymity($metadata["entry"]);
                    break;
                case "show_cancel":
                    $this->setShowCancel($metadata["entry"]);
                    break;
                case "show_marker":
                    $this->setShowMarker($metadata["entry"]);
                    break;
                case "fixed_participants":
                    $this->setFixedParticipants($metadata["entry"]);
                    break;
                case "score_reporting":
                    $result_summary_settings = $result_summary_settings->withScoreReporting((int) $metadata["entry"]);
                    break;
                case "shuffle_questions":
                    $this->setShuffleQuestions($metadata["entry"]);
                    break;
                case "count_system":
                    $scoring_settings = $scoring_settings->withCountSystem((int) $metadata["entry"]);
                    break;
                case "mailnotification":
                    $this->setMailNotification($metadata["entry"]);
                    break;
                case "mailnottype":
                    $this->setMailNotificationType($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":
                    $this->setPassword($metadata["entry"]);
                    $this->setPasswordEnabled(strlen($metadata["entry"]) > 0);
                    break;
                case "allowedUsers":
                    $this->setAllowedUsers($metadata["entry"]);
                    $this->setLimitUsersEnabled((int) $metadata["entry"] > 0);
                    break;
                case "allowedUsersTimeGap":
                    $this->setAllowedUsersTimeGap($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 "show_summary":
                    $this->setListOfQuestionsSettings($metadata["entry"]);
                    break;
                case "reporting_date":
                    $iso8601period = $metadata["entry"];
                    if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches)) {
                        $this->setReportingDate(sprintf("%02d%02d%02d%02d%02d%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]));
                    }
                    break;
                case 'enable_processing_time':
                    $this->setEnableProcessingTime($metadata['entry']);
                    break;
                case "processing_time":
                    $this->setProcessingTime($metadata['entry']);
                    break;
                case "starting_time":
                    $iso8601period = $metadata["entry"];
                    if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches)) {
                        $date_time = new ilDateTime(sprintf("%02d-%02d-%02d %02d:%02d:%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]), IL_CAL_DATETIME);
                        $this->setStartingTime($date_time->get(IL_CAL_UNIX));
                        $this->setStartingTimeEnabled(true);
                    }
                    break;
                case "ending_time":
                    $iso8601period = $metadata["entry"];
                    if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches)) {
                        $date_time = new ilDateTime(sprintf("%02d-%02d-%02d %02d:%02d:%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]), IL_CAL_DATETIME);
                        $this->setEndingTime($date_time->get(IL_CAL_UNIX));
                        $this->setEndingTimeEnabled(true);
                    }
                    break;
                case "enable_examview":
                    $this->setEnableExamview($metadata["entry"]);
                    break;
                case 'show_examview_html':
                    $this->setShowExamviewHtml($metadata['entry']);
                    break;
                case 'show_examview_pdf':
                    $this->setShowExamviewPdf($metadata['entry']);
                    break;
                case 'redirection_mode':
                    $this->setRedirectionMode($metadata['entry']);
                    break;
                case 'redirection_url':
                    $this->setRedirectionUrl($metadata['entry']);
                    break;
                case 'examid_in_kiosk':
                case 'examid_in_test_pass':
                    $this->setShowExamIdInTestPassEnabled($metadata['entry']);
                    break;
                case 'show_exam_id':
                case 'examid_in_test_res':
                    $result_details_settings = $result_details_settings->withShowExamIdInTestResults((bool) $metadata["entry"]);
                    break;
                case 'enable_archiving':
                    $this->setEnableArchiving($metadata['entry']);
                    break;
                case 'sign_submission':
                    $this->setSignSubmission($metadata['entry']);
                    break;
                case 'char_selector_availability':
                    $this->setCharSelectorAvailability($metadata['entry']);
                    break;
                case 'char_selector_definition':
                    $this->setCharSelectorDefinition($metadata['entry']);
                    break;
                case 'skill_service':
                    $this->setSkillServiceEnabled((bool) $metadata['entry']);
                    break;
                case 'result_tax_filters':
                    $tax_ids = strlen($metadata['entry']) ? unserialize($metadata['entry']) : [];
                    $result_details_settings = $result_details_settings->withTaxonomyFilterIds($tax_ids);
                    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($metadata['entry']);
                    break;
                case 'activation_start_time':
                    $this->setActivationStartingTime($metadata['entry']);
                    break;
                case 'activation_end_time':
                    $this->setActivationEndingTime($metadata['entry']);
                    break;
                case 'activation_visibility':
                    $this->setActivationVisibility($metadata['entry']);
                    break;
                case 'autosave':
                    $this->setAutosave($metadata['entry']);
                    break;
                case 'autosave_ival':
                    $this->setAutosaveIval($metadata['entry']);
                    break;
                case 'offer_question_hints':
                    $this->setOfferingQuestionHintsEnabled($metadata['entry']);
                    break;
                case 'instant_feedback_specific':
                    $this->setSpecificAnswerFeedback($metadata['entry']);
                    break;
                case 'obligations_enabled':
                    $this->setObligationsEnabled($metadata['entry']);
                    break;
            }
            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 = $matches[1];
                preg_match("/<passed>(.*?)<\/passed>/", $xmlmark, $matches);
                $mark_passed = $matches[1];
                $this->mark_schema->addMarkStep($mark_short, $mark_official, $mark_percentage, $mark_passed);
            }
        }
 
        $this->saveToDb();
        $result_summary_settings = $result_summary_settings->withShowPassDetails($result_details_settings->getShowPassDetails());
        $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();
 
        // handle the import of media objects in XHTML code
        if (is_array(ilSession::get("import_mob_xhtml"))) {
            foreach (ilSession::get("import_mob_xhtml") as $mob) {
                $importfile = ilObjTest::_getImportDirectory() . '/' . ilSession::get('tst_import_subdir') . '/' . $mob["uri"];
                if (file_exists($importfile)) {
                    $media_object = ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, false);
                    ilObjMediaObject::_saveUsage($media_object->getId(), "tst:html", $this->getId());
                    $this->setIntroduction(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getIntroduction()), 1));
                    $this->setFinalStatement(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getFinalStatement()), 1));
                } else {
                    global $DIC;
                    $ilLog = $DIC['ilLog'];
                    $ilLog->write("Error: Could not open XHTML mob file for test introduction during test import. File $importfile does not exist!");
                }
            }
            $this->saveToDb();
        }
    }

References $DIC, $objectives, $type, _getImportDirectory(), ilRTE\_replaceMediaObjectImageSrc(), ilObjMediaObject\_saveTempFileAsMediaObject(), ilObjMediaObject\_saveUsage(), ilSession\clear(), ilSession\get(), ilQTIAssessment\getComment(), ilObjTestScoreSettings\getGamificationSettings(), ilQTIAssessment\getPresentationMaterial(), ilObjTestScoreSettings\getResultDetailsSettings(), ilObjTestScoreSettings\getResultSummarySettings(), ilObjTestScoreSettings\getScoringSettings(), ilQTIAssessment\getTitle(), IL_CAL_DATETIME, IL_CAL_UNIX, IL_INST_ID, and ilObjTestScoreSettings\withGamificationSettings().

Here is the call graph for this function:

◆ getAccessFilteredParticipantList()

ilObjTest::getAccessFilteredParticipantList ( )

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

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

◆ getActivationEndingTime()

ilObjTest::getActivationEndingTime ( )

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

    {
        return (strlen($this->activation_ending_time)) ? $this->activation_ending_time : null;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getActivationStartingTime()

ilObjTest::getActivationStartingTime ( )

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

    {
        return (strlen($this->activation_starting_time)) ? $this->activation_starting_time : null;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getActivationVisibility()

ilObjTest::getActivationVisibility ( )

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

    {
        return $this->activation_visibility;
    }

Referenced by saveToDb().

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 @access public

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

                                                                        : ?int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
 
        if (!$user_id) {
            $user_id = $ilUser->getId();
        }
 
        $tst_access_code = ilSession::get('tst_access_code');
        if (is_array($tst_access_code) &&
            $ilUser->getId() === ANONYMOUS_USER_ID &&
            isset($tst_access_code[$this->getTestId()]) &&
            $tst_access_code[$this->getTestId()] !== '') {
            $result = $ilDB->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 = $ilDB->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 ($ilUser->getId() === ANONYMOUS_USER_ID) {
                return null;
            }
            $result = $ilDB->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 = $ilDB->fetchAssoc($result);
            return (int) $row['active_id'];
        }
 
        return 0;
    }

References $DIC, $ilDB, $ilUser, ANONYMOUS_USER_ID, and ilSession\get().

Referenced by ilCourseObjectiveResult\resetTestForUser().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveParticipantList()

ilObjTest::getActiveParticipantList ( )

Returns: ilTestParticipantList

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

                                              : ilTestParticipantList
    {
        $participantList = new ilTestParticipantList($this);
        $participantList->initializeFromDbRows($this->getTestParticipants());
 
        return $participantList;
    }

◆ getAggregatedResultsData()

ilObjTest::getAggregatedResultsData ( )

Returns the aggregated test results.

@access public

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

                                              : array
    {
        $data = &$this->getCompleteEvaluationData();
        $foundParticipants = $data->getParticipants();
        $results = array("overview" => array(), "questions" => array());
        if (count($foundParticipants)) {
            $results["overview"][$this->lng->txt("tst_eval_total_persons")] = count($foundParticipants);
            $total_finished = $data->getTotalFinishedParticipants();
            $results["overview"][$this->lng->txt("tst_eval_total_finished")] = $total_finished;
            $average_time = $this->evalTotalStartedAverageTime($data->getParticipantIds());
            $diff_seconds = $average_time;
            $diff_hours = floor($diff_seconds / 3600);
            $diff_seconds -= $diff_hours * 3600;
            $diff_minutes = floor($diff_seconds / 60);
            $diff_seconds -= $diff_minutes * 60;
            $results["overview"][$this->lng->txt("tst_eval_total_finished_average_time")] = sprintf("%02d:%02d:%02d", $diff_hours, $diff_minutes, $diff_seconds);
            $total_passed = 0;
            $total_passed_reached = 0;
            $total_passed_max = 0;
            $total_passed_time = 0;
            foreach ($foundParticipants as $userdata) {
                if ($userdata->getPassed()) {
                    $total_passed++;
                    $total_passed_reached += $userdata->getReached();
                    $total_passed_max += $userdata->getMaxpoints();
                    $total_passed_time += $userdata->getTimeOfWork();
                }
            }
            $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"][$this->lng->txt("tst_eval_total_passed")] = $total_passed;
            $results["overview"][$this->lng->txt("tst_eval_total_passed_average_points")] = sprintf("%2.2f", $average_passed_reached) . " " . strtolower($this->lng->txt("of")) . " " . sprintf("%2.2f", $average_passed_max);
            $average_time = $average_passed_time;
            $diff_seconds = $average_time;
            $diff_hours = floor($diff_seconds / 3600);
            $diff_seconds -= $diff_hours * 3600;
            $diff_minutes = floor($diff_seconds / 60);
            $diff_seconds -= $diff_minutes * 60;
            $results["overview"][$this->lng->txt("tst_eval_total_passed_average_time")] = sprintf("%02d:%02d:%02d", $diff_hours, $diff_minutes, $diff_seconds);
        }
 
        foreach ($data->getQuestionTitles() as $question_id => $question_title) {
            $answered = 0;
            $reached = 0;
            $max = 0;
            foreach ($foundParticipants 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] = array(
                $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;
    }

References $data, $i, $results, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getAllowedUsers()

ilObjTest::getAllowedUsers ( )

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

    {
        return ($this->allowedUsers) ? $this->allowedUsers : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getAllowedUsersTimeGap()

ilObjTest::getAllowedUsersTimeGap ( )

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

    {
        return ($this->allowedUsersTimeGap) ? $this->allowedUsersTimeGap : 0;
    }

Referenced by saveToDb().

Here is the caller 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 @access public

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

                                                  : array
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $result_array = array();
        if ($this->isRandomTest()) {
            $active_id = $this->getActiveIdOfUser($ilUser->getId());
            $this->loadQuestions($active_id, $pass);
            if (count($this->questions) == 0) {
                return $result_array;
            }
            if (is_null($pass)) {
                $pass = self::_getPass($active_id);
            }
            $result = $ilDB->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 " . $ilDB->in('qpl_questions.question_id', $this->questions, false, 'integer'),
                array('integer','integer'),
                array($active_id, $pass)
            );
        } else {
            if (count($this->questions) == 0) {
                return $result_array;
            }
            $result = $ilDB->query("SELECT qpl_questions.* FROM qpl_questions, tst_test_question WHERE tst_test_question.question_fi = qpl_questions.question_id AND " . $ilDB->in('qpl_questions.question_id', $this->questions, false, 'integer'));
        }
        while ($row = $ilDB->fetchAssoc($result)) {
            $result_array[$row["question_id"]] = $row;
        }
        return $result_array;
    }

References $DIC, $ilDB, and $ilUser.

◆ getAllRTEContent()

ilObjTest::getAllRTEContent ( )

Returns the content of all RTE enabled text areas in the test.

Returns: string[]

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

                                      : array
    {
        $result = array();
        array_push($result, $this->getIntroduction());
        array_push($result, $this->getFinalStatement());
        return $result;
    }

References getFinalStatement(), and getIntroduction().

Referenced by cleanupMediaobjectUsage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAllTestResults()

ilObjTest::getAllTestResults	(	$participants,
		$prepareForCSV = `true`
	)

returns all test results for all participants

Parameters

array	$partipants	array of user ids
	boolean	if true, the result will be prepared for csv output (see processCSVRow)

Returns: array of fields, see code for column titles

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

                                                                           : array
    {
        $results = array();
        $row = array(
            "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"),
            "ects" => $this->lng->txt("ects_grade"),
            "passed" => $this->lng->txt("tst_mark_passed"),
        );
        $results[] = $row;
        if (count($participants)) {
            if ($this->getECTSOutput()) {
                $passed_array = &$this->getTotalPointsPassedArray();
            }
            foreach ($participants as $active_id => $user_rec) {
                $mark = $ects_mark = '';
                $row = array();
                $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->mark_schema->getMatchingMark($percentvalue * 100);
                $passed = "";
                if ($mark_obj) {
                    $mark = $mark_obj->getOfficialName();
                    if ($this->getECTSOutput()) {
                        $ects_mark = $this->getECTSGrade($passed_array, $reached_points, $max_points);
                    }
                }
                if ($this->getAnonymity()) {
                    $user_rec['firstname'] = "";
                    $user_rec['lastname'] = $this->lng->txt("anonymous");
                }
                $row = array(
                    "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,
                    "ects" => $ects_mark,
                    "passed" => $user_rec['passed'] ? '1' : '0',
                );
                $results[] = $prepareForCSV ? $this->processCSVRow($row, true) : $row;
            }
        }
        return $results;
    }

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

Here is the call graph for this function:

◆ getAnonymity()

ilObjTest::getAnonymity ( )

Returns the anonymity status of the test.

Returns: integer The value for the anonymity status (0 = personalized, 1 = anonymized) @access public

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

                                  : int
    {
        return ($this->anonymity) ? 1 : 0;
    }

Referenced by saveToDb().

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 @access public

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

                                                                      : int
    {
        if ($this->isDynamicTest()) {
            global $DIC;
            $tree = $DIC['tree'];
            $ilDB = $DIC['ilDB'];
            $lng = $DIC['lng'];
            $refinery = $DIC['refinery'];
            $component_repository = $DIC['component.repository'];
 
            $testSessionFactory = new ilTestSessionFactory($this);
            $testSession = $testSessionFactory->getSession($active_id);
 
            $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $component_repository, $this);
            $testSequence = $testSequenceFactory->getSequenceByTestSession($testSession);
 
            $dynamicQuestionSetConfig = new ilObjTestDynamicQuestionSetConfig($tree, $ilDB, $component_repository, $this);
            $dynamicQuestionSetConfig->loadFromDb();
 
            $testSequence->loadFromDb($dynamicQuestionSetConfig);
            $testSequence->loadQuestions($dynamicQuestionSetConfig, new ilTestDynamicQuestionSetFilterSelection());
 
            return $testSequence->getTrackedQuestionCount();
        }
 
        if ($this->isRandomTest()) {
            $this->loadQuestions($active_id, $pass);
        }
        $workedthrough = 0;
        foreach ($this->questions as $value) {
            if (assQuestion::_isWorkedThrough($active_id, $value, $pass)) {
                $workedthrough += 1;
            }
        }
        return $workedthrough;
    }

References $DIC, $ilDB, $lng, ILIAS\Repository\$refinery, and assQuestion\_isWorkedThrough().

Here is the call graph for this function:

◆ getAnswerFeedback()

ilObjTest::getAnswerFeedback ( )

Returns 1 if generic answer feedback is activated.

Deprecated:: Use getGenericAnswerFeedback instead.

Returns: integer The status of the answer specific feedback @access public

See also: $answer_feedback

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

                                       : int
    {
        return ($this->answer_feedback) ? $this->answer_feedback : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getAnswerFeedbackPoints()

ilObjTest::getAnswerFeedbackPoints ( )

Returns 1 if answer specific feedback as reached points is activated.

Returns: integer The status of the answer specific feedback as reached points @access public

See also: $answer_feedback_points

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

                                             : int
    {
        return ($this->answer_feedback_points) ? $this->answer_feedback_points : 0;
    }

Referenced by saveToDb().

Here is the caller 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 @access public

See also: $author

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

                               : string
    {
        $author = array();
        $md = new ilMD($this->getId(), 0, $this->getType());
        $md_life = $md->getLifecycle();
        if ($md_life) {
            $ids = $md_life->getContributeIds();
            foreach ($ids as $id) {
                $md_cont = $md_life->getContribute($id);
                if (strcmp($md_cont->getRole(), "Author") == 0) {
                    $entids = $md_cont->getEntityIds();
                    foreach ($entids as $entid) {
                        $md_ent = $md_cont->getEntity($entid);
                        array_push($author, $md_ent->getEntity());
                    }
                }
            }
        }
        return join(",", $author);
    }

References $id, and ILIAS\Survey\Mode\getId().

Referenced by saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAutosave()

ilObjTest::getAutosave ( )

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

                                 : bool
    {
        return $this->autosave;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getAutosaveIval()

ilObjTest::getAutosaveIval ( )

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

                                     : int
    {
        return $this->autosave_ival;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getAvailableQuestionpools()

ilObjTest::getAvailableQuestionpools	(	$use_object_id = `false`,
		$equal_points = `false`,
		$could_be_offline = `false`,
		$show_path = `false`,
		$with_questioncount = `false`,
		$permission = `"read"`
	)

Returns the available question pools for the active user.

Returns: array The available question pools @access public

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

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

References ilObjQuestionPool\_getAvailableQuestionpools().

Here is the call graph for this function:

◆ getAvailableQuestions()

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

Calculates the available questions for a test.

@access public

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

                                                                        : array
    {
        global $DIC;
        $component_repository = $DIC['component.repository'];
        $component_factory = $DIC['component.factory'];
        $lng = $DIC['lng'];
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools($use_object_id = true, $equal_points = false, $could_be_offline = false, $showPath = false, $with_questioncount = false));
        $available = "";
        if (count($available_pools)) {
            $available = " AND " . $ilDB->in('qpl_questions.obj_fi', $available_pools, false, 'integer');
        } else {
            return array();
        }
        if ($completeonly) {
            $available .= " AND qpl_questions.complete = " . $ilDB->quote("1", 'text');
        }
 
        $where = "";
        if (is_array($arrFilter)) {
            if (array_key_exists('title', $arrFilter) && strlen($arrFilter['title'])) {
                $where .= " AND " . $ilDB->like('qpl_questions.title', 'text', "%%" . $arrFilter['title'] . "%%");
            }
            if (array_key_exists('description', $arrFilter) && strlen($arrFilter['description'])) {
                $where .= " AND " . $ilDB->like('qpl_questions.description', 'text', "%%" . $arrFilter['description'] . "%%");
            }
            if (array_key_exists('author', $arrFilter) && strlen($arrFilter['author'])) {
                $where .= " AND " . $ilDB->like('qpl_questions.author', 'text', "%%" . $arrFilter['author'] . "%%");
            }
            if (array_key_exists('type', $arrFilter) && strlen($arrFilter['type'])) {
                $where .= " AND qpl_qst_type.type_tag = " . $ilDB->quote($arrFilter['type'], 'text');
            }
            if (array_key_exists('qpl', $arrFilter) && strlen($arrFilter['qpl'])) {
                $where .= " AND " . $ilDB->like('object_data.title', 'text', "%%" . $arrFilter['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 " . $ilDB->in('qpl_questions.question_id', $original_ids, true, 'integer');
        }
 
        $query_result = $ilDB->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 = array();
 
        if ($query_result->numRows()) {
            while ($row = $ilDB->fetchAssoc($query_result)) {
                $row = ilAssQuestionType::completeMissingPluginName($row);
 
                if (!$row['plugin']) {
                    $row[ 'ttype' ] = $lng->txt($row[ "type_tag" ]);
 
                    $rows[] = $row;
                    continue;
                }
 
                $plugin = $component_repository->getPluginByName($row['plugin_name']);
                if (!$plugin->isActive()) {
                    continue;
                }
 
                $pl = $component_factory->getPlugin($plugin->getId());
                $row[ 'ttype' ] = $pl->getQuestionTypeTranslation();
 
                $rows[] = $row;
            }
        }
        return $rows;
    }

References $DIC, $ilDB, $ilUser, $lng, XapiProxy\$plugin, $rows, ilObjQuestionPool\_getAvailableQuestionpools(), and ilAssQuestionType\completeMissingPluginName().

Here is the call graph for this function:

◆ getCharSelectorAvailability()

ilObjTest::getCharSelectorAvailability ( )

Returns: int availability of the special character selector

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

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

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getCharSelectorDefinition()

ilObjTest::getCharSelectorDefinition ( )

Returns: string definition of the special character selector

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

                                               : ?string
    {
        return $this->char_selector_definition;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getCompleteEvaluationData()

& ilObjTest::getCompleteEvaluationData	(	$withStatistics = `true`,
		$filterby = `""`,
		$filtertext = `""`
	)

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

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

References $data.

◆ getCompleteManualFeedback()

static ilObjTest::getCompleteManualFeedback ( int $question_id )

static

Retrieves the manual feedback for a question in a test.

Parameters

integer $question_id Question ID

Returns: array The feedback text @access public

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

                                                                      : array
    {
        global $DIC;
 
        $ilDB = $DIC->database();
        $feedback = array();
        $result = $ilDB->queryF(
            "SELECT * FROM tst_manual_fb WHERE question_fi = %s",
            array('integer'),
            array($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;
    }

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

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 @access public

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

                                                    : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->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",
            array('integer','integer'),
            array($this->getTestId(), $user_id)
        );
        $time = 0;
        while ($row = $ilDB->fetchAssoc($result)) {
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
            $epoch_1 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
            $epoch_2 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            $time += ($epoch_2 - $epoch_1);
        }
        return $time;
    }

References $DIC, and $ilDB.

◆ 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 @access public

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

                                                                   : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->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",
            array('integer','integer'),
            array($this->getTestId(), $active_id)
        );
        $time = 0;
        while ($row = $ilDB->fetchAssoc($result)) {
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
            $epoch_1 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
            $epoch_2 = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
            $time += ($epoch_2 - $epoch_1);
        }
        return $time;
    }

References $DIC, and $ilDB.

◆ 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 @access public

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

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

◆ getCountSystem()

ilObjTest::getCountSystem ( )

Gets the count system for the calculation of points.

Returns: integer The count system for the calculation of points @access public

See also: $count_system

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

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

◆ getCustomStyle()

ilObjTest::getCustomStyle ( )

Returns: string|null The custom style, NULL if empty

See also: $_customStyle

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

                                    : ?string
    {
        return (strlen($this->_customStyle)) ? $this->_customStyle : null;
    }

Referenced by saveToDb().

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
	boolean	if true, the result will be prepared for csv output (see processCSVRow)

Returns: array of fields, see code for column titles

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

                                                         : array
    {
        $results = array();
        if (count($participants)) {
            foreach ($participants as $active_id => $user_rec) {
                $row = array();
                $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");
                        }
                        $row = array(
                            "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',
                        );
                        $results[] = $row;
                    }
                }
            }
        }
        return $results;
    }

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

Here is the call graph for this function:

◆ getECTSFX()

ilObjTest::getECTSFX ( )

Implements ilEctsGradesEnabled.

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

                               : ?float
    {
        return $this->ects_fx;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getECTSGrade()

ilObjTest::getECTSGrade	(	$passed_array,
		$reached_points,
		$max_points
	)

{Returns the ECTS grade for a number of reached points.

Parameters

array	$passed_array	An array with the points of all users who passed the test
double	$reached_points	The points reached in the test
double	$max_points	The maximum number of points for the test

Returns: string The ECTS grade short description

}

Implements ilEctsGradesEnabled.

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

                                                                             : string
    {
        return self::_getECTSGrade($passed_array, $reached_points, $max_points, $this->ects_grades["A"], $this->ects_grades["B"], $this->ects_grades["C"], $this->ects_grades["D"], $this->ects_grades["E"], $this->ects_fx);
    }

◆ getECTSGrades()

ilObjTest::getECTSGrades ( )

Implements ilEctsGradesEnabled.

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

                                   : array
    {
        return $this->ects_grades;
    }

◆ getECTSOutput()

ilObjTest::getECTSOutput ( )

Implements ilEctsGradesEnabled.

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

                                   : int
    {
        return ($this->ects_output) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEnableArchiving()

ilObjTest::getEnableArchiving ( )

Returns: boolean

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

                                        : bool
    {
        return $this->enable_archiving;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEnabledViewMode()

ilObjTest::getEnabledViewMode ( )

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

    {
        return $this->enabled_view_mode;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEnableExamview()

ilObjTest::getEnableExamview ( )

Returns: boolean

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

                                       : bool
    {
        return $this->enable_examview;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEnableProcessingTime()

ilObjTest::getEnableProcessingTime ( )

Returns the state of the processing time (enabled/disabled)

Returns: integer The processing time state (0 for disabled, 1 for enabled) @access public

See also: $processing_time

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

    {
        return ($this->enable_processing_time) ? $this->enable_processing_time : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEndingTime()

ilObjTest::getEndingTime ( )

Returns the ending time of the test.

Returns: string The ending time of the test @access public

See also: $ending_time

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

    {
        return ($this->ending_time != 0) ? $this->ending_time : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getEstimatedWorkingTime()

ilObjTest::getEstimatedWorkingTime ( )

Returns the estimated working time for the test calculated from the working time of the contained questions.

Returns: array An associative array containing the working time. array["h"] = hours, array["m"] = minutes, array["s"] = seconds @access public

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

                                             : array
    {
        $time_in_seconds = 0;
        foreach ($this->questions as $question_id) {
            $question = ilObjTest::_instanciateQuestion($question_id);
            $est_time = $question->getEstimatedWorkingTime();
            $time_in_seconds += $est_time["h"] * 3600 + $est_time["m"] * 60 + $est_time["s"];
        }
        $hours = (int) ($time_in_seconds / 3600)        ;
        $time_in_seconds = $time_in_seconds - ($hours * 3600);
        $minutes = (int) ($time_in_seconds / 60);
        $time_in_seconds = $time_in_seconds - ($minutes * 60);
        $result = array("hh" => $hours, "mm" => $minutes, "ss" => $time_in_seconds);
        return $result;
    }

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

Here is the call graph for this function:

◆ getEvaluationAdditionalFields()

ilObjTest::getEvaluationAdditionalFields ( )

Gets additional user fields that should be shown in the user evaluation.

Returns: array An array containing the database fields that should be shown in the evaluation

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

                                                   : array
    {
        $table_gui = new ilEvaluationAllTableGUI(new ilObjTestGUI($this->getRefId()), 'outEvaluation', $this->getAnonymity());
        return $table_gui->getSelectedColumns();
    }

◆ 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 @access public

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

                                                       : array
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $existing_questions = array();
        $active_id = $this->getActiveIdOfUser($ilUser->getId());
        if ($this->isRandomTest()) {
            if (is_null($pass)) {
                $pass = 0;
            }
            $result = $ilDB->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",
                array('integer','integer'),
                array($active_id, $pass)
            );
        } else {
            $result = $ilDB->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",
                array('integer'),
                array($this->getTestId())
            );
        }
        while ($data = $ilDB->fetchObject($result)) {
            if ($data->original_id === null) {
                continue;
            }
 
            array_push($existing_questions, $data->original_id);
        }
        return $existing_questions;
    }

References $data, $DIC, $ilDB, and $ilUser.

◆ getExportDirectory()

ilObjTest::getExportDirectory ( )

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

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

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

Here is the call graph for this function:

◆ getExportSettings()

ilObjTest::getExportSettings ( )

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

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

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getExportSettingsSingleChoiceShort()

ilObjTest::getExportSettingsSingleChoiceShort ( )

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

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

◆ getExtraTime()

ilObjTest::getExtraTime ( $active_id )

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT additionaltime FROM tst_addtime WHERE active_fi = %s",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows() > 0) {
            $row = $ilDB->fetchAssoc($result);
            return $row['additionaltime'];
        }
        return 0;
    }

References $DIC, and $ilDB.

◆ getFinalStatement()

ilObjTest::getFinalStatement ( )

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

                                       : string
    {
        return $this->_finalstatement;
    }

Referenced by getAllRTEContent(), and saveToDb().

Here is the caller graph for this function:

◆ getFixedParticipants()

ilObjTest::getFixedParticipants ( )

Returns the fixed participants status.

Returns: integer The value for the fixed participants status (0 = don't allow, 1 = allow) @access public

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

                                          : int
    {
        return ($this->fixed_participants) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getFixedQuestionSetTotalPoints()

ilObjTest::getFixedQuestionSetTotalPoints ( )

Returns: float

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

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

◆ getForceJS()

ilObjTest::getForceJS ( )

Gets whether JavaScript should be forced for tests.

Returns: integer 1 to force JavaScript, 0 otherwise @access public

See also: $_forcejs

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

                                : int
    {
        return ($this->_forcejs) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getGenericAnswerFeedback()

ilObjTest::getGenericAnswerFeedback ( )

Returns 1 if generic answer feedback is to be shown.

Returns: integer 1, if answer specific feedback is to be shown. @access public

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

                                              : int
    {
        return ($this->answer_feedback) ? $this->answer_feedback : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getGroupData()

ilObjTest::getGroupData ( $ids )

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

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

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

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 10056 of file class.ilObjTest.php.

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

◆ 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 10035 of file class.ilObjTest.php.

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

◆ getHighscoreEnabled()

ilObjTest::getHighscoreEnabled ( )

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

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

◆ getHighscoreHints()

ilObjTest::getHighscoreHints ( )

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

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

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

◆ getHighscoreMode()

ilObjTest::getHighscoreMode ( )

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

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

◆ getHighscoreOwnTable()

ilObjTest::getHighscoreOwnTable ( )

Gets if the own rankings table should be shown.

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

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

◆ getHighscorePercentage()

ilObjTest::getHighscorePercentage ( )

Gets if the percentage column should be shown.

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

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

◆ getHighscoreScore()

ilObjTest::getHighscoreScore ( )

Gets if the score column should be shown.

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

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

◆ 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 10113 of file class.ilObjTest.php.

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

◆ getHighscoreTopTable()

ilObjTest::getHighscoreTopTable ( )

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

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

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

◆ getHighscoreWTime()

ilObjTest::getHighscoreWTime ( )

Gets if the column with the workingtime should be shown.

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

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

◆ getHtmlQuestionContentPurifier()

ilObjTest::getHtmlQuestionContentPurifier ( )

protected

Returns: ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

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

References ilHtmlPurifierFactory\getInstanceByType().

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.

@access public

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

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

References CLIENT_WEB_DIR, and ILIAS\Survey\Mode\getId().

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.

@access public

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

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

References CLIENT_WEB_DIR, ILIAS\Survey\Mode\getId(), and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

◆ getImportDirectory()

ilObjTest::getImportDirectory ( )

Returns: mixed|null

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

    {
        return ilObjTest::_getImportDirectory();
    }

References _getImportDirectory().

Here is the call graph for this function:

◆ getImportMapping()

ilObjTest::getImportMapping ( )

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

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

                                      : array
    {
        return array();
    }

◆ getInstantFeedbackOptionsAsArray()

ilObjTest::getInstantFeedbackOptionsAsArray ( )

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

                                                      : array
    {
        $values = array();
 
        if ($this->getSpecificAnswerFeedback()) {
            $values[] = 'instant_feedback_specific';
        }
        if ($this->getGenericAnswerFeedback()) {
            $values[] = 'instant_feedback_generic';
        }
        if ($this->getAnswerFeedbackPoints()) {
            $values[] = 'instant_feedback_points';
        }
        if ($this->getInstantFeedbackSolution()) {
            $values[] = 'instant_feedback_solution';
        }
 
        return $values;
    }

◆ getInstantFeedbackSolution()

ilObjTest::getInstantFeedbackSolution ( )

Returns 1 if the correct solution will be shown after answering a question.

Returns: integer The status of the solution instant feedback @access public

See also: $instant_verification

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

                                                : int
    {
        return ($this->instant_verification) ? $this->instant_verification : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getIntroduction()

ilObjTest::getIntroduction ( )

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

                                     : string
    {
        return $this->introduction;
    }

Referenced by getAllRTEContent(), and saveToDb().

Here is the caller graph for this function:

◆ getInvitedParticipantList()

ilObjTest::getInvitedParticipantList ( )

Returns: ilTestParticipantList

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

                                               : ilTestParticipantList
    {
        $participantList = new ilTestParticipantList($this);
        $participantList->initializeFromDbRows($this->getInvitedUsers());
 
        return $participantList;
    }

◆ getInvitedUsers()

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

Returns a list of all invited users in a test.

Returns: array array of invited users @access public

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

                                                                                          : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result_array = array();
 
        if ($this->getAnonymity()) {
            if (is_numeric($user_id)) {
                $result = $ilDB->queryF(
                    "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, tst_invited_user.clientip, " .
                    "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",
                    array('text', 'text', 'text', 'integer', 'integer'),
                    array("", $this->lng->txt("anonymous"), "", $this->getTestId(), $user_id)
                );
            } else {
                $result = $ilDB->queryF(
                    "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, tst_invited_user.clientip, " .
                    "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",
                    array('text', 'text', 'text', 'integer'),
                    array("", $this->lng->txt("anonymous"), "", $this->getTestId())
                );
            }
        } else {
            if (is_numeric($user_id)) {
                $result = $ilDB->queryF(
                    "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, tst_invited_user.clientip, " .
                    "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",
                    array('integer', 'integer'),
                    array($this->getTestId(), $user_id)
                );
            } else {
                $result = $ilDB->queryF(
                    "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, tst_invited_user.clientip, " .
                    "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",
                    array('integer'),
                    array($this->getTestId())
                );
            }
        }
        $result_array = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            $result_array[$row['usr_id']] = $row;
        }
        return $result_array;
    }

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

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 @access public

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

                                         : bool
    {
        return true;
    }

◆ getKiosk()

ilObjTest::getKiosk ( )

Returns the kiosk mode.

Returns: integer Kiosk mode @access public

See also: $_kiosk

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

                              : int
    {
        return ($this->_kiosk) ? $this->_kiosk : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getKioskMode()

ilObjTest::getKioskMode ( )

Returns the kiosk mode.

Returns: boolean Kiosk mode @access public

See also: $_kiosk

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

                                  : bool
    {
        if (($this->_kiosk & 1) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getListOfQuestions()

ilObjTest::getListOfQuestions ( )

Returns if the list of questions should be presented to the user or not.

Returns: boolean TRUE if the list of questions should be presented, FALSE otherwise @access public

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

                                        : bool
    {
        if (($this->show_summary & 1) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getListOfQuestionsDescription()

ilObjTest::getListOfQuestionsDescription ( )

Returns TRUE if the list of questions should be presented with the question descriptions.

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

                                                   : bool
    {
        if (($this->show_summary & 8) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getListOfQuestionsEnd()

ilObjTest::getListOfQuestionsEnd ( )

Returns if the list of questions should be presented as the last page of the test.

Returns: boolean TRUE if the list of questions is shown as last page of the test, FALSE otherwise @access public

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

                                           : bool
    {
        if (($this->show_summary & 4) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ 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 TRUE if the list of questions should be presented, FALSE otherwise @access public

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

    {
        return ($this->show_summary) ? $this->show_summary : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getListOfQuestionsStart()

ilObjTest::getListOfQuestionsStart ( )

Returns if the list of questions should be presented as the first page of the test.

Returns: boolean TRUE if the list of questions is shown as first page of the test, FALSE otherwise @access public

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

                                             : bool
    {
        if (($this->show_summary & 2) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getMailNotification()

ilObjTest::getMailNotification ( )

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

                                         : int
    {
        return $this->mailnotification;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getMailNotificationType()

ilObjTest::getMailNotificationType ( )

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

                                             : int
    {
        if ($this->mailnottype == 1) {
            return $this->mailnottype;
        } else {
            return 0;
        }
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getManualFeedback()

static ilObjTest::getManualFeedback	(	$active_id,
		$question_id,
		$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 @access public

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

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

References ilTestService\isManScoringDone().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMarkSchema()

ilObjTest::getMarkSchema ( )

{

Returns: ASS_MarkSchema

}

Implements ilMarkSchemaAware.

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

                                   : ASS_MarkSchema
    {
        return $this->mark_schema;
    }

◆ getMarkSchemaForeignId()

ilObjTest::getMarkSchemaForeignId ( )

{

Returns: int

}

Implements ilMarkSchemaAware.

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

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

◆ getNrOfResultsForPass()

ilObjTest::getNrOfResultsForPass	(	$active_id,
		$pass
	)

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

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

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

References $DIC, and $ilDB.

◆ getNrOfTries()

ilObjTest::getNrOfTries ( )

Returns the nr of tries for the test.

Returns: integer The maximum number of tries @access public

See also: $nr_of_tries

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

                                  : int
    {
        return ($this->nr_of_tries) ? $this->nr_of_tries : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getOldOnlineStatus()

ilObjTest::getOldOnlineStatus ( )

Returns: null

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

    {
        return $this->oldOnlineStatus;
    }

Referenced by saveToDb().

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 3801 of file class.ilObjTest.php.

                                      : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->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",
            array('integer'),
            array($this->getTestId())
        );
        $persons_array = array();
        while ($row = $ilDB->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"]] = array(
                "name" => $name,
                "fullname" => $fullname,
                "login" => $login
            );
        }
        return $persons_array;
    }

References $DIC, $ilDB, $name, ANONYMOUS_USER_ID, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getPassed()

ilObjTest::getPassed ( $active_id )

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT passed FROM tst_result_cache WHERE active_fi = %s",
            array('integer'),
            array($active_id)
        );
        if ($result->numRows()) {
            $row = $ilDB->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"];
        }
    }

References $DIC, $ilDB, and _getResultPass().

Here is the call graph for this function:

◆ getPassScoring()

ilObjTest::getPassScoring ( )

Gets the pass scoring type.

Returns: integer The pass scoring type @access public

See also: $pass_scoring

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

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

◆ getPassWaiting()

ilObjTest::getPassWaiting ( )

Returns: string

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

                                    : string
    {
        return $this->pass_waiting ?? '';
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getPassword()

ilObjTest::getPassword ( )

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

                                 : ?string
    {
        return (strlen($this->password)) ? $this->password : null;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getProcessingTime()

ilObjTest::getProcessingTime ( )

Returns the processing time for the test.

Returns: string The processing time for the test @access public

See also: $processing_time

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

    {
        return (strlen($this->processing_time)) ? $this->processing_time : null;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getProcessingTimeAsArray()

ilObjTest::getProcessingTimeAsArray ( )

See also: $processing_time

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

                                              : array
    {
        if (strlen($this->processing_time)) {
            if (preg_match("/(\d{2}):(\d{2}):(\d{2})/is", $this->processing_time, $matches)) {
                if ((int) $matches[1] + (int) $matches[2] + (int) $matches[3] == 0) {
                    return $this->getEstimatedWorkingTime();
                } else {
                    return array(
                        'hh' => $matches[1],
                        'mm' => $matches[2],
                        'ss' => $matches[3],
                    );
                }
            }
        }
        return $this->getEstimatedWorkingTime();
    }

◆ getProcessingTimeAsMinutes()

ilObjTest::getProcessingTimeAsMinutes ( )

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

    {
        if (strlen($this->processing_time)) {
            if (preg_match("/(\d{2}):(\d{2}):(\d{2})/is", $this->processing_time, $matches)) {
                return ($matches[1] * 60) + $matches[2];
            }
        }
 
        return self::DEFAULT_PROCESSING_TIME_MINUTES;
    }

◆ getProcessingTimeInSeconds()

ilObjTest::getProcessingTimeInSeconds ( $active_id = "" )

Returns the processing time for the test in seconds.

Returns: integer The processing time for the test in seconds @access public

See also: $processing_time

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

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

◆ getQuestionCount()

ilObjTest::getQuestionCount ( )

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

                                      : int
    {
        $num = 0;
 
        if ($this->isRandomTest()) {
            global $DIC;
            $tree = $DIC['tree'];
            $ilDB = $DIC['ilDB'];
            $component_repository = $DIC['component.repository'];
 
            $questionSetConfig = new ilTestRandomQuestionSetConfig(
                $tree,
                $ilDB,
                $component_repository,
                $this
            );
 
            $questionSetConfig->loadFromDb();
 
            if ($questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
                $sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList(
                    $ilDB,
                    $this,
                    new ilTestRandomQuestionSetSourcePoolDefinitionFactory($ilDB, $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;
    }

References $DIC, and $ilDB.

◆ getQuestionCountWithoutReloading()

ilObjTest::getQuestionCountWithoutReloading ( )

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

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

◆ 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 @access public

See also: $questions

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

                                                    : object
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->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",
            array('integer'),
            array($question_id)
        );
        $row = $ilDB->fetchObject($result);
        return $row;
    }

References $DIC, and $ilDB.

◆ getQuestions()

ilObjTest::getQuestions ( )

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

                                  : array
    {
        return $this->questions;
    }

◆ getQuestionSetType()

ilObjTest::getQuestionSetType ( )

getter for question set type

Returns: string $questionSetType

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

                                        : string
    {
        return $this->questionSetType;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getQuestionSetTypeTranslation()

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

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

                                                                                    : 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);
    }

References $lng, QUESTION_SET_TYPE_FIXED, and QUESTION_SET_TYPE_RANDOM.

◆ getQuestionsOfPass()

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

Retrieves all the assigned questions for a test participant in a given test pass.

Returns: array An associated array containing the questions @access public

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

                                                          : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        if ($this->isRandomTest()) {
            $ilDB->setLimit($this->getQuestionCount(), 0);
            $result = $ilDB->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",
                array('integer', 'integer'),
                array($active_id, $pass)
            );
        } else {
            $result = $ilDB->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",
                array('integer'),
                array($active_id)
            );
        }
        $qpass = array();
        if ($result->numRows()) {
            while ($row = $ilDB->fetchAssoc($result)) {
                array_push($qpass, $row);
            }
        }
        return $qpass;
    }

References $DIC, and $ilDB.

◆ getQuestionsOfTest()

& ilObjTest::getQuestionsOfTest ( $active_id )

Retrieves all the assigned questions for all test passes of a test participant.

Returns: array An associated array containing the questions @access public

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

                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        if ($this->isRandomTest()) {
            $ilDB->setLimit($this->getQuestionCount(), 0);
            $result = $ilDB->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",
                array('integer'),
                array($active_id)
            );
        } else {
            $result = $ilDB->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",
                array('integer'),
                array($active_id)
            );
        }
        $qtest = array();
        if ($result->numRows()) {
            while ($row = $ilDB->fetchAssoc($result)) {
                array_push($qtest, $row);
            }
        }
        return $qtest;
    }

References $DIC, and $ilDB.

◆ 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 @access public

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

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

References $DIC, $ilDB, and $res.

◆ getQuestionTitle()

ilObjTest::getQuestionTitle	(	$title,
		$nr = `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 @access public

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

                                                        : string
    {
        if ($this->getTitleOutput() !== 2) {
            return $title;
        }
 
        if ($this->getTitleOutput() === 2 && isset($nr)) {
            return $this->lng->txt("ass_question") . ' ' . $nr;
        }
 
        return $this->lng->txt("ass_question");
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getQuestionTitles()

& ilObjTest::getQuestionTitles ( )

Returns the titles of the test questions in question sequence.

Returns: array The question titles @access public

See also: $questions

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

                                        : array
    {
        $titles = array();
        if ($this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED) {
            global $DIC;
            $ilDB = $DIC['ilDB'];
            $result = $ilDB->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",
                array('integer'),
                array($this->getTestId())
            );
            while ($row = $ilDB->fetchAssoc($result)) {
                array_push($titles, $row["title"]);
            }
        }
        return $titles;
    }

References $DIC, and $ilDB.

◆ getQuestionTitlesAndIndexes()

& ilObjTest::getQuestionTitlesAndIndexes ( )

Returns the titles of the test questions in question sequence.

Returns: array The question titles @access public

See also: $questions

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

                                                  : array
    {
        $titles = array();
        if ($this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED) {
            global $DIC;
            $ilDB = $DIC['ilDB'];
            $result = $ilDB->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",
                array('integer'),
                array($this->getTestId())
            );
            while ($row = $ilDB->fetchAssoc($result)) {
                $titles[$row['question_id']] = $row["title"];
            }
        }
        return $titles;
    }

References $DIC, and $ilDB.

◆ 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 @access private

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if ($question_id < 1) {
            return -1;
        }
        $result = $ilDB->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",
            array('integer'),
            array($question_id)
        );
        if ($result->numRows() == 1) {
            $data = $ilDB->fetchObject($result);
            return $data->type_tag;
        } else {
            return "";
        }
    }

References $data, $DIC, and $ilDB.

◆ getRedirectionMode()

ilObjTest::getRedirectionMode ( )

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

                                        : int
    {
        return $this->redirection_mode;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getRedirectionUrl()

ilObjTest::getRedirectionUrl ( )

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

                                       : ?string
    {
        return $this->redirection_url;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getReportingDate()

ilObjTest::getReportingDate ( )

Gets the reporting date of the ilObjTest object.

Returns: DateTimeImmutable|null The reporting date of the test or null (=FALSE) if no reporting date is set @access public

See also: $reporting_date @depracated Use Score Settings instead

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

                                      : ?DateTimeImmutable
    {
        return $this->getScoreSettings()->getResultSummarySettings()->getReportingDate();
    }

◆ getResetProcessingTime()

ilObjTest::getResetProcessingTime ( )

Returns wheather the processing time should be reset or not.

Returns: integer 0 for no reset, 1 for a reset @access public

See also: $reset_processing_time

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

                                            : int
    {
        return ($this->reset_processing_time) ? $this->reset_processing_time : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getResultFilterTaxIds()

ilObjTest::getResultFilterTaxIds ( )

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

                                           : array
    {
        if ($this->getTestId() != -1) {
            return $this->getScoreSettings()->getResultDetailsSettings()->getTaxonomyFilterIds();
        }
        return [];
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getResultsForActiveId()

ilObjTest::getResultsForActiveId ( $active_id )

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

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

References $DIC, $ilDB, $query, and assQuestion\_updateTestResultCache().

Here is the call graph for this function:

◆ getResultsPresentation()

ilObjTest::getResultsPresentation ( )

Returns the combined results presentation value.

Returns: integer The combined results presentation value @access public

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

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

◆ getRoleData()

ilObjTest::getRoleData ( $ids )

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

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

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

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.

Returns: integer The score cutting type. 0 for question cutting, 1 for test cutting @access public

See also: $score_cutting

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

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

◆ getScoreReporting()

ilObjTest::getScoreReporting ( )

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

                                       : int
    {
        if ($this->getTestId() !== -1) {
            return $this->getScoreSettings()->getResultSummarySettings()->getScoreReporting();
        }
        return 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getScoreSettings()

ilObjTest::getScoreSettings ( )

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

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

◆ getScoreSettingsRepository()

ilObjTest::getScoreSettingsRepository ( )

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

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

◆ getSecondsUntilEndingTime()

ilObjTest::getSecondsUntilEndingTime ( )

Returns the seconds left from the actual time until the ending time.

Returns: integer The seconds left until the ending time is reached @access public

See also: $ending_time

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

    {
        if ($this->getEndingTime() != 0) {
            $ending = $this->getEndingTime();
            $now = time();
            return $ending - $now;
        } else {
            return 0;
        }
    }

◆ getSequenceSettings()

ilObjTest::getSequenceSettings ( )

SEQUENCE SETTING = POSTPONING ENABLED !!

Returns: integer The POSTPONING ENABLED status

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

                                         : int
    {
        return ($this->sequence_settings) ? $this->sequence_settings : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowCancel()

ilObjTest::getShowCancel ( )

Returns wheather the cancel test button is shown or not.

Returns: integer The value for the show cancel status (0 = don't show, 1 = show) @access public

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

                                   : int
    {
        return ($this->show_cancel) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowExamviewHtml()

ilObjTest::getShowExamviewHtml ( )

Returns: boolean

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

                                         : bool
    {
        return $this->show_examview_html;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowExamviewPdf()

ilObjTest::getShowExamviewPdf ( )

Returns: boolean

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

                                        : bool
    {
        return $this->show_examview_pdf;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowFinalStatement()

ilObjTest::getShowFinalStatement ( )

Returns whether the final statement should be shown or not.

Returns: integer 0 if false, 1 if true @access public

See also: $_showfinalstatement

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

                                           : int
    {
        return ($this->_showfinalstatement) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowInfo()

ilObjTest::getShowInfo ( )

Gets whether the complete information page is shown or the required data only.

Returns: integer 1 for the complete information, 0 otherwise @access public

See also: $_showinfo

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

                                 : int
    {
        return ($this->_showinfo) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowKioskModeParticipant()

ilObjTest::getShowKioskModeParticipant ( )

Returns the status of the kiosk mode participant.

Returns: boolean Kiosk mode participant @access public

See also: $_kiosk

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

                                                 : bool
    {
        if (($this->_kiosk & 4) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getShowKioskModeTitle()

ilObjTest::getShowKioskModeTitle ( )

Returns the status of the kiosk mode title.

Returns: boolean Kiosk mode title @access public

See also: $_kiosk

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

                                           : bool
    {
        if (($this->_kiosk & 2) > 0) {
            return true;
        } else {
            return false;
        }
    }

◆ getShowMarker()

ilObjTest::getShowMarker ( )

Returns wheather the marker button is shown or not.

Returns: integer The value for the marker status (0 = don't show, 1 = show) @access public

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

                                   : int
    {
        return ($this->show_marker) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getShowPassDetails()

ilObjTest::getShowPassDetails ( )

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

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

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

◆ getShowSolutionAnswersOnly()

ilObjTest::getShowSolutionAnswersOnly ( )

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

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

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

◆ getShowSolutionDetails()

ilObjTest::getShowSolutionDetails ( )

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

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

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

◆ getShowSolutionFeedback()

ilObjTest::getShowSolutionFeedback ( )

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

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

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

◆ getShowSolutionListComparison()

ilObjTest::getShowSolutionListComparison ( )

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

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

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

◆ getShowSolutionListOwnAnswers()

ilObjTest::getShowSolutionListOwnAnswers ( $user_id = null )

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

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

◆ getShowSolutionPrintview()

ilObjTest::getShowSolutionPrintview ( )

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

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

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

◆ getShowSolutionSignature()

ilObjTest::getShowSolutionSignature ( )

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

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

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

◆ getShowSolutionSuggested()

ilObjTest::getShowSolutionSuggested ( )

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

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

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

◆ getShuffleQuestions()

ilObjTest::getShuffleQuestions ( )

Returns the status of the shuffle_questions variable.

Returns: integer 0 if the test questions are not shuffled, 1 if the test questions are shuffled @access public

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

                                         : int
    {
        return ($this->shuffle_questions) ? 1 : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getSignSubmission()

ilObjTest::getSignSubmission ( )

Returns: boolean

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

                                       : bool
    {
        return $this->sign_submission;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getSingleManualFeedback()

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

static

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

                                                                                               : array
    {
        global $DIC;
 
        $ilDB = $DIC->database();
        $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;
    }

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

Referenced by ilTestScoringByQuestionsGUI\appendFormToModal(), ilTestScoringGUI\buildManScoringParticipantForm(), and ilTestServiceGUI\getPassListOfAnswersWithScoring().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedback()

ilObjTest::getSpecificAnswerFeedback ( )

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

                                               : int
    {
        switch ($this->specific_answer_feedback) {
            case 1:
                return 1;
            default:
                return 0;
        }
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getStartingTime()

ilObjTest::getStartingTime ( )

Returns the starting time of the test.

Returns: string The starting time of the test @access public

See also: $starting_time

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

    {
        return ($this->starting_time != 0) ? $this->starting_time : 0;
    }

Referenced by saveToDb().

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 10361 of file class.ilObjTest.php.

                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $times = array();
        $result = $ilDB->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",
            array('integer'),
            array($this->getTestId())
        );
        while ($row = $ilDB->fetchAssoc($result)) {
            $times[$row['active_fi']] = $row['started'];
        }
        return $times;
    }

References $DIC, and $ilDB.

◆ 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 @access public

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

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

References $ilDB.

◆ getStartTestLabel()

ilObjTest::getStartTestLabel ( $active_id )

Returns the "Start the Test" label for the Info page.

Parameters

int $active_id The active id of the current user

Returns: string The "Start the Test" label @access public

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

                                                 : string
    {
        if ($this->getNrOfTries() == 1) {
            return $this->lng->txt("tst_start_test");
        }
        $active_pass = self::_getPass($active_id);
        $res = $this->getNrOfResultsForPass($active_id, $active_pass);
        if ($res == 0) {
            if ($active_pass == 0) {
                return $this->lng->txt("tst_start_test");
            } else {
                return $this->lng->txt("tst_start_new_test_pass");
            }
        } else {
            return $this->lng->txt("tst_resume_test");
        }
    }

References $res, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getTemplate()

ilObjTest::getTemplate ( )

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

                                 : string
    {
        return $this->template_id;
    }

Referenced by ilTestSettingsGUI\__construct(), and saveToDb().

Here is the caller graph for this function:

◆ getTestDefaults()

ilObjTest::getTestDefaults ( $test_defaults_id )

Returns the test defaults for a given id.

Parameters

integer $test_defaults_id The database id of a test defaults dataset

Returns: array An array containing the test defaults @access public

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

                                                      : ?array
    {
        return self::_getTestDefaults($test_defaults_id);
    }

◆ getTestId()

ilObjTest::getTestId ( )

Gets the database id of the additional test data.

Returns: integer The database id of the additional test data @access public

See also: $test_id

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

                               : int
    {
        return $this->test_id;
    }

Referenced by ilTestCorrectionsGUI\__construct(), ilObjTestDynamicQuestionSetConfig\cloneQuestionSetRelatedData(), ilTestRandomQuestionSetConfig\cloneQuestionSetRelatedData(), deleteTest(), hasSingleChoiceQuestions(), ilTestImporter\importSkillLevelThresholds(), isNewRandomTest(), isSingleChoiceTest(), isSingleChoiceTestWithoutShuffle(), saveCompleteStatus(), saveQuestionsToDb(), and saveToDb().

Here is the caller graph for this function:

◆ getTestObjIdsWithActiveForUserId()

static ilObjTest::getTestObjIdsWithActiveForUserId ( $userId )

static

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

                                                                    : 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, array('integer'), array($userId));
 
        $objIds = array();
 
        while ($row = $ilDB->fetchAssoc($res)) {
            $objIds[] = (int) $row['obj_fi'];
        }
 
        return $objIds;
    }

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

Here is the call graph for this function:

◆ getTestParticipants()

& ilObjTest::getTestParticipants ( )

Returns a list of all participants in a test.

Returns: array The data of the participants @access public

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

                                          : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if ($this->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 = $ilDB->queryF(
                $query,
                array('text', 'text', 'text', 'integer'),
                array("", $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 = $ilDB->queryF(
                $query,
                array('integer'),
                array($this->getTestId())
            );
        }
        $data = array();
        while ($row = $ilDB->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;
    }

References $data, $DIC, $ilDB, $index, $query, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getTestParticipantsForManualScoring()

ilObjTest::getTestParticipantsForManualScoring ( $filter = null )

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

                                                                       : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $scoring = ilObjAssessmentFolder::_getManualScoring();
        if (count($scoring) == 0) {
            return array();
        }
 
        $participants = &$this->getTestParticipants();
        $filtered_participants = array();
        foreach ($participants as $active_id => $participant) {
            $qstType_IN_manScoreableQstTypes = $ilDB->in('qpl_questions.question_type_fi', $scoring, false, 'integer');
 
            $queryString = "
                                SELECT          tst_test_result.manual
 
                                FROM            tst_test_result
 
                                INNER JOIN      qpl_questions
                                ON                      tst_test_result.question_fi = qpl_questions.question_id
 
                                WHERE           tst_test_result.active_fi = %s
                                AND                     $qstType_IN_manScoreableQstTypes
                        ";
 
            $result = $ilDB->queryF(
                $queryString,
                array("integer"),
                array($active_id)
            );
 
            $count = $result->numRows();
 
            if ($count > 0) {
                switch ($filter) {
                    case 1: // only active users
                        if ($participant['active']) {
                            $filtered_participants[$active_id] = $participant;
                        }
                        break;
                    case 2: // only inactive users
                        if (!$participant['active']) {
                            $filtered_participants[$active_id] = $participant;
                        }
                        break;
                    case 3: // all users
                        $filtered_participants[$active_id] = $participant;
                        break;
                    case 4:
                        $assessmentSetting = new ilSetting("assessment");
                        $manscoring_done = $assessmentSetting->get("manscoring_done_" . $active_id);
                        if ($manscoring_done) {
                            $filtered_participants[$active_id] = $participant;
                        }
                        break;
                    case 5:
                        $assessmentSetting = new ilSetting("assessment");
                        $manscoring_done = $assessmentSetting->get("manscoring_done_" . $active_id);
                        if (!$manscoring_done) {
                            $filtered_participants[$active_id] = $participant;
                        }
                        break;
                    case 6:
                        // partially scored participants
                        $found = 0;
                        while ($row = $ilDB->fetchAssoc($result)) {
                            if ($row["manual"]) {
                                $found++;
                            }
                        }
                        if (($found > 0) && ($found < $count)) {
                            $filtered_participants[$active_id] = $participant;
                        }
                        break;
                    default:
                        $filtered_participants[$active_id] = $participant;
                        break;
                }
            }
        }
        return $filtered_participants;
    }

References $DIC, $ilDB, and ilObjAssessmentFolder\_getManualScoring().

Here is the call graph for this function:

◆ getTestQuestions()

& ilObjTest::getTestQuestions ( )

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

                                       : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $tags_trafo = $this->refinery->string()->stripTags();
 
        $query = "
                        SELECT          questions.*,
                                                questtypes.type_tag,
                                                tstquest.sequence,
                                                tstquest.obligatory,
                                                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 = $ilDB->queryF(
            $query,
            array('integer'),
            array($this->getTestId())
        );
 
        $questions = array();
 
        while ($row = $ilDB->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']);
            $row['obligationPossible'] = self::isQuestionObligationPossible($row['question_id']);
 
            $questions[] = $row;
        }
 
        return $questions;
    }

References $DIC, $ilDB, $query, and ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ getTestResult()

& ilObjTest::getTestResult	(		$active_id,
			$pass = `null`,
		bool	$ordered_sequence = `false`,
		bool	$considerHiddenQuestions = `true`,
		bool	$considerOptionalQuestions = `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 3260 of file class.ilObjTest.php.

     : array {
        global $DIC;
        $tree = $DIC['tree'];
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $refinery = $DIC['refinery'];
        $component_repository = $DIC['component.repository'];
 
        $results = $this->getResultsForActiveId($active_id);
 
        if ($pass === null) {
            $pass = $results['pass'];
        }
 
        $testSessionFactory = new ilTestSessionFactory($this);
        $testSession = $testSessionFactory->getSession($active_id);
 
        $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $component_repository, $this);
        $testSequence = $testSequenceFactory->getSequenceByActiveIdAndPass($active_id, $pass);
 
        if ($this->isDynamicTest()) {
            $dynamicQuestionSetConfig = new ilObjTestDynamicQuestionSetConfig($tree, $ilDB, $component_repository, $this);
            $dynamicQuestionSetConfig->loadFromDb();
 
            $testSequence->loadFromDb($dynamicQuestionSetConfig);
            $testSequence->loadQuestions($dynamicQuestionSetConfig, new ilTestDynamicQuestionSetFilterSelection());
 
            $sequence = $testSequence->getUserSequenceQuestions();
        } else {
            $testSequence->setConsiderHiddenQuestionsEnabled($considerHiddenQuestions);
            $testSequence->setConsiderOptionalQuestionsEnabled($considerOptionalQuestions);
 
            $testSequence->loadFromDb();
            $testSequence->loadQuestions();
 
            if ($ordered_sequence) {
                $sequence = $testSequence->getOrderedSequenceQuestions();
            } else {
                $sequence = $testSequence->getUserSequenceQuestions();
            }
        }
 
        $arrResults = [];
 
        $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
 
                        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
 
                        WHERE           tst_test_result.active_fi = %s
                        AND                     tst_test_result.pass = %s
                ";
 
        $solutionresult = $ilDB->queryF(
            $query,
            array('integer', 'integer'),
            array($active_id, $pass)
        );
 
        while ($row = $ilDB->fetchAssoc($solutionresult)) {
            $arrResults[ $row['question_fi'] ] = $row;
        }
 
        $numWorkedThrough = count($arrResults);
 
        $IN_question_ids = $ilDB->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 = $ilDB->query($query);
 
        $unordered = [];
 
        $key = 1;
 
        $obligationsAnswered = true;
 
        while ($row = $ilDB->fetchAssoc($result)) {
            if (!isset($arrResults[ $row['question_id'] ])) {
                $percentvalue = 0.0;
            } else {
                $percentvalue = (
                    $row['points'] ? $arrResults[$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($arrResults[$row['question_id']]['reached'] ?? 0, 2),
                'requested_hints' => $arrResults[$row['question_id']]['requested_hints'] ?? 0,
                'hint_points' => $arrResults[$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($arrResults[$row['question_id']]) ? 1 : 0,
                'answered' => $arrResults[$row['question_id']]['answered'] ?? 0
            ];
 
            if (!isset($arrResults[ $row['question_id'] ]['answered']) || !$arrResults[ $row['question_id'] ]['answered']) {
                $obligationsAnswered = false;
            }
 
            $unordered[ $row['question_id'] ] = $data;
 
            $key++;
        }
 
        $numQuestionsTotal = count($unordered);
 
        $pass_max = 0;
        $pass_reached = 0;
        $pass_requested_hints = 0;
        $pass_hint_points = 0;
        $key = 1;
 
        $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'];
 
            // pickup prepared data for question
            // that exists in users qst sequence
            $unordered[$qid]['nr'] = $key;
            array_push($found, $unordered[$qid]);
 
            // increment key counter
            $key++;
        }
 
        $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']['obligationsAnswered'] = $obligationsAnswered;
        $found['pass']['num_workedthrough'] = $numWorkedThrough;
        $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'];
        $found['test']['obligations_answered'] = $results['obligations_answered'];
 
        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;
    }

Referenced by ilTestSequence\hideCorrectAnsweredQuestions().

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	$user_id	The user id
integer	$question_id	The question id

Returns: string The answer text @access public

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

                                                                         : string
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if (!$active_id || !$question_id) {
            if ($pass === null) {
                $pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
            }
            if ($pass === null) {
                return '';
            }
            $result = $ilDB->queryF(
                "SELECT value1 FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                array('integer', 'integer', 'integer'),
                array($active_id, $question_id, $pass)
            );
            if ($result->numRows() == 1) {
                $row = $ilDB->fetchAssoc($result);
                return $row["value1"];
            }
        }
        return '';
    }

References $DIC, $ilDB, and assQuestion\_getSolutionMaxPass().

Here is the call graph for this function:

◆ getTimeExtensionsOfParticipants()

ilObjTest::getTimeExtensionsOfParticipants ( )

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

                                                     : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $times = array();
        $result = $ilDB->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",
            array('integer'),
            array($this->getTestId())
        );
        while ($row = $ilDB->fetchAssoc($result)) {
            $times[$row['active_fi']] = $row['additionaltime'];
        }
        return $times;
    }

References $DIC, and $ilDB.

◆ getTitleFilenameCompliant()

ilObjTest::getTitleFilenameCompliant ( )

returns the object title prepared to be used as a filename

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

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

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

Here is the call graph for this function:

◆ getTitleOutput()

ilObjTest::getTitleOutput ( )

Returns the value of the title_output status.

Returns: integer 0 for full title, 1 for title without points, 2 for no title @access public

See also: $title_output

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

                                    : int
    {
        return ($this->title_output) ? $this->title_output : 0;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ getTmpCopyWizardCopyId()

ilObjTest::getTmpCopyWizardCopyId ( )

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

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

References $tmpCopyWizardCopyId.

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

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 @access public

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

                                                : array
    {
        $totalpoints_array = 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->mark_schema->getMatchingMark($percentage * 100.0);
 
            $obligationsAnswered = $test_result["test"]["obligations_answered"];
 
            if ($mark) {
                if ($mark->getPassed() && $obligationsAnswered) {
                    array_push($totalpoints_array, $test_result["test"]["total_reached_points"]);
                }
            }
        }
        return $totalpoints_array;
    }

◆ getUsePreviousAnswers()

ilObjTest::getUsePreviousAnswers ( )

Returns if the previous answers should be shown for a learner.

Returns: integer 1 if the previous answers should be shown, 0 otherwise @access public

See also: $use_previous_answers

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

                                           : int
    {
        return ($this->use_previous_answers) ? $this->use_previous_answers : 0;
    }

Referenced by saveToDb().

Here is the caller 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 @access public

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

                                     : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if (!is_array($ids) || count($ids) == 0) {
            return array();
        }
 
        if ($this->getAnonymity()) {
            $result = $ilDB->queryF(
                "SELECT usr_id, %s login, %s lastname, %s firstname, client_ip clientip FROM usr_data WHERE " . $ilDB->in('usr_id', $ids, false, 'integer') . " ORDER BY login",
                array('text', 'text', 'text'),
                array("", $this->lng->txt("anonymous"), "")
            );
        } else {
            $result = $ilDB->query("SELECT usr_id, login, lastname, firstname, client_ip clientip FROM usr_data WHERE " . $ilDB->in('usr_id', $ids, false, 'integer') . " ORDER BY login");
        }
 
        $result_array = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            $result_array[$row["usr_id"]] = $row;
        }
        return $result_array;
    }

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

Here is the call graph for this function:

◆ getVisitTimeOfParticipant()

ilObjTest::getVisitTimeOfParticipant ( $active_id )

Returns the first and last visit of a participant.

Parameters

integer $active_id The active ID of the participant

Returns: array The first and last visit of a participant @access public

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

                                                         : array
    {
        return ilObjTest::_getVisitTimeOfParticipant($this->getTestId(), $active_id);
    }

References _getVisitTimeOfParticipant().

Here is the call graph for this function:

◆ 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 @access public

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

                                                                 : array
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        if (is_null($pass)) {
            $result = $ilDB->queryF(
                "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
                array('integer','integer'),
                array($active_id, 0)
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
                array('integer','integer'),
                array($active_id, $pass)
            );
        }
        $result_array = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            array_push($result_array, $row["question_fi"]);
        }
        return $result_array;
    }

References $DIC, $ilDB, and $ilUser.

◆ getXMLZip()

ilObjTest::getXMLZip ( )

Get zipped xml file for test.

Reimplemented from ilObject.

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

                               : string
    {
        $expFactory = new ilTestExportFactory($this);
        $test_exp = $expFactory->getExporter('xml');
        return $test_exp->buildExportFile();
    }

◆ hasAnyTestResult()

ilObjTest::hasAnyTestResult ( ilTestSession $testSession )

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

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

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

Here is the call graph for this function:

◆ hasNrOfTriesRestriction()

ilObjTest::hasNrOfTriesRestriction ( )

returns if the numbers of tries have to be checked

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

                                             : bool
    {
        return $this->getNrOfTries() != 0;
    }

◆ hasObligations()

static ilObjTest::hasObligations ( $test_id )

static

returns the fact wether the test with given test id contains questions markes as obligatory or not

@global ilDBInterface $ilDB

Parameters

integer $test_id

Returns: boolean $hasObligations

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

                                                   : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $rset = $ilDB->queryF(
            'SELECT count(*) cnt FROM tst_test_question WHERE test_fi = %s AND obligatory = 1',
            array('integer'),
            array($test_id)
        );
 
        $row = $ilDB->fetchAssoc($rset);
 
        return (bool) $row['cnt'] > 0;
    }

References $DIC, and $ilDB.

◆ hasQuestionsWithoutQuestionpool()

ilObjTest::hasQuestionsWithoutQuestionpool ( )

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

                                                     : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $questions = $this->getQuestionTitlesAndIndexes();
 
        $IN_questions = $ilDB->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 = $ilDB->query($query);
 
        $row = $ilDB->fetchAssoc($rset);
 
        return $row['cnt'] > 0;
    }

References $DIC, $ilDB, and $query.

◆ hasRandomQuestionsForPass()

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

Checkes wheather a random test has already created questions for a given pass or not.

Deprecated:: : still in use?

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

                                                                        : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->queryF(
            "SELECT test_random_question_id FROM tst_test_rnd_qst WHERE active_fi = %s AND pass = %s",
            array('integer','integer'),
            array($active_id, $pass)
        );
        return ($result->numRows() > 0) ? true : false;
    }

References $DIC, $ilDB, and true.

◆ hasSingleChoiceQuestions()

ilObjTest::hasSingleChoiceQuestions ( )

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

                                              : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT DISTINCT(qpl_qst_type.type_tag) foundtypes FROM qpl_questions, tst_test_result, qpl_qst_type, tst_active WHERE tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_result.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
            array('integer'),
            array($this->getTestId())
        );
        $hasSC = false;
        while ($row = $ilDB->fetchAssoc($result)) {
            if (strcmp($row['foundtypes'], 'assSingleChoice') == 0) {
                $hasSC = true;
            }
        }
        return $hasSC;
    }

References $DIC, $ilDB, and getTestId().

Referenced by isSingleChoiceTestWithoutShuffle().

Here is the call graph for this function:

Here is the caller 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 9260 of file class.ilObjTest.php.

     : void {
        global $DIC;
 
        $ilDB = $DIC->database();
        $ilUser = $DIC->user();
        $next_id = $ilDB->nextId('tst_manual_fb');
        $user = $ilUser->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];
        }
 
        $ilDB->insert('tst_manual_fb', $update_default);
    }

◆ insertQuestion()

ilObjTest::insertQuestion	(	ilTestQuestionSetConfig	$testQuestionSetConfig,
			$question_id,
			$linkOnly = `false`
	)

Insert a question in the list of questions.

Parameters

ilTestQuestionSetConfig	$testQuestionSetConfig
integer	$question_id	The database id of the inserted question
boolean	$linkOnly

Returns: integer $duplicate_id

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

                                                                                                                   : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        if ($linkOnly) {
            $duplicate_id = $question_id;
        } else {
            $duplicate_id = $this->duplicateQuestionForTest($question_id);
        }
 
        // get maximum sequence index in test
        $result = $ilDB->queryF(
            "SELECT MAX(sequence) seq FROM tst_test_question WHERE test_fi=%s",
            array('integer'),
            array($this->getTestId())
        );
        $sequence = 1;
 
        if ($result->numRows() == 1) {
            $data = $ilDB->fetchObject($result);
            $sequence = $data->seq + 1;
        }
 
        $next_id = $ilDB->nextId('tst_test_question');
        $affectedRows = $ilDB->manipulateF(
            "INSERT INTO tst_test_question (test_question_id, test_fi, question_fi, sequence, tstamp) VALUES (%s, %s, %s, %s, %s)",
            array('integer', 'integer','integer','integer','integer'),
            array($next_id, $this->getTestId(), $duplicate_id, $sequence, time())
        );
        if ($affectedRows == 1) {
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction($this->lng->txtlng("assessment", "log_question_added", ilObjAssessmentFolder::_getLogLanguage()) . ": " . $sequence, $duplicate_id);
            }
        }
        // remove test_active entries, because test has changed
        $affectedRows = $ilDB->manipulateF(
            "DELETE FROM tst_active WHERE test_fi = %s",
            array('integer'),
            array($this->getTestId())
        );
        $this->loadQuestions();
        $this->saveCompleteStatus($testQuestionSetConfig);
        return $duplicate_id;
    }

References $data, $DIC, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ inviteGroup()

ilObjTest::inviteGroup ( $group_id )

Invites all users of a group to a test.

Parameters

integer $group_id The database id of the invited group @access public

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

    {
        $group = new ilObjGroup($group_id);
        $members = $group->getGroupMemberIds();
        foreach ($members as $user_id) {
            $this->inviteUser($user_id, ilObjUser::_lookupClientIP($user_id));
        }
    }

References ilObjUser\_lookupClientIP().

Here is the call graph for this function:

◆ inviteRole()

ilObjTest::inviteRole ( $role_id )

Invites all users of a role to a test.

Parameters

integer $group_id The database id of the invited group @access public

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

    {
        global $DIC;
        $rbacreview = $DIC['rbacreview'];
        $members = $rbacreview->assignedUsers($role_id);
        foreach ($members as $user_id) {
            $this->inviteUser($user_id, ilObjUser::_lookupClientIP($user_id));
        }
    }

References $DIC, and ilObjUser\_lookupClientIP().

Here is the call 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 @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $ilDB->manipulateF(
            "DELETE FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
            array('integer', 'integer'),
            array($this->getTestId(), $user_id)
        );
        $ilDB->manipulateF(
            "INSERT INTO tst_invited_user (test_fi, user_fi, clientip, tstamp) VALUES (%s, %s, %s, %s)",
            array('integer', 'integer', 'text', 'integer'),
            array($this->getTestId(), $user_id, (strlen($client_ip)) ? $client_ip : null, time())
        );
    }

References $DIC, and $ilDB.

◆ isActivationLimited()

ilObjTest::isActivationLimited ( )

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

                                         : ?bool
    {
        return $this->activation_limited;
    }

Referenced by saveToDb().

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 7057 of file class.ilObjTest.php.

                                                          : bool
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        if (!is_numeric($user_id)) {
            $user_id = $ilUser->getId();
        }
 
        $result = $ilDB->queryF(
            "SELECT submitted FROM tst_active WHERE test_fi=%s AND user_fi=%s AND submitted=%s",
            array('integer', 'integer', 'integer'),
            array($this->getTestId(), $user_id, 1)
        );
        return $result->numRows() == 1;
    }

References $DIC, $ilDB, and $ilUser.

◆ isAnyInstantFeedbackOptionEnabled()

ilObjTest::isAnyInstantFeedbackOptionEnabled ( )

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

                                                       : bool
    {
        return (
            $this->getSpecificAnswerFeedback() || $this->getGenericAnswerFeedback() ||
            $this->getAnswerFeedbackPoints() || $this->getInstantFeedbackSolution()
        );
    }

◆ isBestSolutionPrintedWithResult()

ilObjTest::isBestSolutionPrintedWithResult ( )

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

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

◆ isBlockPassesAfterPassedEnabled()

ilObjTest::isBlockPassesAfterPassedEnabled ( )

Returns: bool

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

                                                     : bool
    {
        return $this->blockPassesAfterPassedEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isComplete()

ilObjTest::isComplete ( ilTestQuestionSetConfig $testQuestionSetConfig )

final

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

                                                                                    : bool
    {
        if (!count($this->mark_schema->mark_steps)) {
            return false;
        }
 
        if (!$testQuestionSetConfig->isQuestionSetConfigured()) {
            return false;
        }
 
        return true;
    }

References ilTestQuestionSetConfig\isQuestionSetConfigured().

Referenced by saveCompleteStatus(), and saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isDynamicTest()

ilObjTest::isDynamicTest ( )

Returns the fact wether this test is a dynamic question set test or not.

Deprecated:: 9 This is only kept in, to avoid crashing dynamic question tests with an ugly error.

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

                                   : bool
    {
        return $this->getQuestionSetType() == self::QUESTION_SET_TYPE_DYNAMIC;
    }

◆ isEndingTimeEnabled()

ilObjTest::isEndingTimeEnabled ( )

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

                                         : ?bool
    {
        return $this->ending_time_enabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isExecutable()

ilObjTest::isExecutable	(	$testSession,
		$user_id,
		$allowPassIncrease = `false`
	)

Checks if the test is executable by the given user.

Parameters

	$testSession
integer	$user_id	The user id
bool	$allowPassIncrease

Returns: array Result array

Exceptions

ilDateTimeException

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

                                                                                    : array
    {
        $result = array(
            "executable" => true,
            "errormessage" => ""
        );
        if ($this->isDynamicTest()) {
            $result["executable"] = false;
            $result["errormessage"] = ($this->lng->txt("ctm_cannot_be_started"));
            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()) {
            if ($active_id > 0) {
                $starting_time = $this->getStartingTimeOfUser($active_id);
                if ($starting_time !== false) {
                    if ($this->isMaxProcessingTimeReached($starting_time, $active_id)) {
                        if ($allowPassIncrease && $this->getResetProcessingTime() && (($this->getNrOfTries() == 0) || ($this->getNrOfTries() > (self::_getPass($active_id) + 1)))) {
                            // a test pass was quitted because the maximum processing time was reached, but the time
                            // will be resetted for future passes, so if there are more passes allowed, the participant may
                            // start the test again.
                            // This code block is only called when $allowPassIncrease is TRUE which only happens when
                            // the test info page is opened. Otherwise this will lead to unexpected results!
                            $testSession->increasePass();
                            $testSession->setLastSequence(0);
                            $testSession->saveToDb();
                        } else {
                            $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($testSession->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;
                }
            }
        }
        if ($this->isPassWaitingEnabled() && $testPassesSelector->getLastFinishedPass() !== null) {
            $lastPass = $testPassesSelector->getLastFinishedPassTimestamp();
            if ($lastPass && strlen($this->getPassWaiting())) {
                $pass_waiting_string = $this->getPassWaiting();
                $time_values = explode(":", $pass_waiting_string);
                $next_pass_allowed = strtotime('+ ' . $time_values[0] . ' Months + ' . $time_values[1] . ' Days + ' . $time_values[2] . ' Hours' . $time_values[3] . ' Minutes', $lastPass);
 
                if (time() < $next_pass_allowed) {
                    $date = ilDatePresentation::formatDate(new ilDateTime($next_pass_allowed, IL_CAL_UNIX));
 
                    $result["executable"] = false;
                    $result["errormessage"] = sprintf($this->lng->txt('wait_for_next_pass_hint_msg'), $date);
                    return $result;
                }
            }
        }
        return $result;
    }

References ilObjTestAccess\_isPassed(), ilDatePresentation\formatDate(), ILIAS\Survey\Mode\getId(), IL_CAL_UNIX, and ILIAS\Repository\lng().

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 10647 of file class.ilObjTest.php.

                                 : bool
    {
        return $this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED;
    }

◆ isFollowupQuestionAnswerFixationEnabled()

ilObjTest::isFollowupQuestionAnswerFixationEnabled ( )

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

                                                             : bool
    {
        return $this->followupQuestionAnswerFixationEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isForceInstantFeedbackEnabled()

ilObjTest::isForceInstantFeedbackEnabled ( )

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

                                                   : ?bool
    {
        return $this->forceInstantFeedbackEnabled;
    }

Referenced by saveToDb().

Here is the caller 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 10048 of file class.ilObjTest.php.

                                     : bool
    {
        return $this->getAnonymity() == 1 || $this->getHighscoreAnon();
    }

◆ 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 @access public

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

                                   : bool
    {
        if (preg_match("/<[^>]*?>/", $a_text)) {
            return true;
        } else {
            return false;
        }
    }

◆ isInstantFeedbackAnswerFixationEnabled()

ilObjTest::isInstantFeedbackAnswerFixationEnabled ( )

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

                                                            : bool
    {
        return $this->instantFeedbackAnswerFixationEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isIntroductionEnabled()

ilObjTest::isIntroductionEnabled ( )

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

                                           : bool
    {
        return $this->introductionEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isLimitUsersEnabled()

ilObjTest::isLimitUsersEnabled ( )

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

                                         : ?bool
    {
        return $this->limitUsersEnabled;
    }

Referenced by saveToDb().

Here is the caller 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 7581 of file class.ilObjTest.php.

                                                                                  : bool
    {
        if ($this->getEnableProcessingTime()) {
            $processing_time = $this->getProcessingTimeInSeconds($active_id);
            $now = time();
            if ($now > ($starting_time + $processing_time)) {
                return true;
            } else {
                return false;
            }
        } else {
            return false;
        }
    }

◆ isNewRandomTest()

ilObjTest::isNewRandomTest ( )

protected

Checks wheather the test is a new random test (using tst_rnd_cpy) or an old one.

Deprecated:: --> old school random test

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

                                        : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->queryF(
            'SELECT copy_id FROM tst_rnd_cpy WHERE tst_fi = %s',
            array('integer'),
            array($this->getTestId())
        );
        return $result->numRows() > 0;
    }

References $DIC, $ilDB, and getTestId().

Here is the call 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 7089 of file class.ilObjTest.php.

                                              : bool
    {
        return $tries >= $this->getNrOfTries();
    }

◆ isOfferingQuestionHintsEnabled()

ilObjTest::isOfferingQuestionHintsEnabled ( )

returns the fact wether offering hints is enabled or not

Returns: boolean

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

                                                    : bool
    {
        return $this->offeringQuestionHintsEnabled ?: false;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isOnline()

ilObjTest::isOnline ( )

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

                              : bool
    {
        return $this->online;
    }

◆ isParticipantsLastPassActive()

static ilObjTest::isParticipantsLastPassActive	(	$testRefId,
		$userId
	)

static

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

                                                                            : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $refinery = $DIC['refinery'];
        $component_repository = $DIC['component.repository'];
 
        /* @var ilObjTest $testOBJ */
 
        $testOBJ = ilObjectFactory::getInstanceByRefId($testRefId, false);
 
 
        $activeId = $testOBJ->getActiveIdOfUser($userId);
 
        $testSessionFactory = new ilTestSessionFactory($testOBJ);
        // Added temporarily bugfix smeyer
        $testSessionFactory->reset();
 
        $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $component_repository, $testOBJ);
 
        $testSession = $testSessionFactory->getSession($activeId);
        $testSequence = $testSequenceFactory->getSequenceByActiveIdAndPass($activeId, $testSession->getPass());
        $testSequence->loadFromDb();
 
        return $testSequence->hasSequence();
    }

References $DIC, $ilDB, $lng, ILIAS\Repository\$refinery, and ilObjectFactory\getInstanceByRefId().

Referenced by ilContainerObjectiveGUI\updateResult().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isPassDeletionAllowed()

ilObjTest::isPassDeletionAllowed ( )

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

                                           : bool
    {
        return $this->getScoreSettings()->getResultSummarySettings()->getPassDeletionAllowed();
    }

◆ isPassWaitingEnabled()

ilObjTest::isPassWaitingEnabled ( )

Returns: bool

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

                                          : bool
    {
        if (array_sum(explode(':', $this->getPassWaiting())) > 0) {
            return true;
        }
        return false;
    }

◆ isPasswordEnabled()

ilObjTest::isPasswordEnabled ( )

Returns: boolean

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

                                       : ?bool
    {
        return $this->passwordEnabled;
    }

Referenced by saveToDb().

Here is the caller 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 @access public

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

                                            : bool
    {
        global $DIC;
        $component_repository = $DIC['component.repository'];
 
        if (!$component_repository->getComponentByTypeAndName(
            ilComponentInfo::TYPE_MODULES,
            'TestQuestionPool'
        )->getPluginSlotById('qst')->hasPluginName($a_pname)) {
            return false;
        }
 
        return $component_repository
            ->getComponentByTypeAndName(
                ilComponentInfo::TYPE_MODULES,
                'TestQuestionPool'
            )
            ->getPluginSlotById(
                'qst'
            )
            ->getPluginByName(
                $a_pname
            )->isActive();
    }

References $DIC, and ilComponentInfo\TYPE_MODULES.

◆ isPostponingEnabled()

ilObjTest::isPostponingEnabled ( )

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

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

◆ isPreviousSolutionReuseEnabled()

ilObjTest::isPreviousSolutionReuseEnabled ( $active_id )

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

                                                              : 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",
            array("integer"),
            array($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;
    }

References $res, and ILIAS\Repository\user().

Here is the call graph for this function:

◆ isQuestionObligationPossible()

static ilObjTest::isQuestionObligationPossible ( $questionId )

static

checks wether the obligation for question with given id is possible or not

Parameters

integer $questionId

Returns: boolean $obligationPossible

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

                                                                    : bool
    {
        $classConcreteQuestion = assQuestion::_getQuestionType($questionId);
 
        assQuestion::_includeClass($classConcreteQuestion, 0);
 
        // static binder is not at work yet (in PHP < 5.3)
        //$obligationPossible = $classConcreteQuestion::isObligationPossible();
        $obligationPossible = call_user_func(array($classConcreteQuestion, 'isObligationPossible'), $questionId);
 
        return $obligationPossible;
    }

References assQuestion\_getQuestionType(), and assQuestion\_includeClass().

Referenced by ilObjTestGUI\saveOrderAndObligationsObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isQuestionObligatory()

static ilObjTest::isQuestionObligatory ( $question_id )

static

checks wether the question with given id is marked as obligatory or not

Parameters

integer $questionId

Returns: boolean $obligatory

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

                                                             : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $rset = $ilDB->queryF('SELECT obligatory FROM tst_test_question WHERE question_fi = %s', array('integer'), array($question_id));
 
        if ($row = $ilDB->fetchAssoc($rset)) {
            return (bool) $row['obligatory'];
        }
 
        return false;
    }

References $DIC, and $ilDB.

Referenced by assQuestion\calculateResultsFromSolution(), ilTestSequence\getSequenceSummary(), ilTestSequenceDynamicQuestionSet\getSequenceSummary(), and ilTestOutputGUI\showQuestionCmd().

Here is the caller 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 10657 of file class.ilObjTest.php.

                                  : bool
    {
        return $this->getQuestionSetType() == self::QUESTION_SET_TYPE_RANDOM;
    }

◆ isScoreReportingEnabled()

ilObjTest::isScoreReportingEnabled ( )

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

                                             : bool
    {
        switch ($this->getScoreReporting()) {
            case self::SCORE_REPORTING_FINISHED:
            case self::SCORE_REPORTING_IMMIDIATLY:
            case self::SCORE_REPORTING_DATE:
            case self::SCORE_REPORTING_AFTER_PASSED:
 
                return true;
 
            case self::SCORE_REPORTING_DISABLED:
            default:
 
                return false;
        }
    }

◆ isShowExamIdInTestPassEnabled()

ilObjTest::isShowExamIdInTestPassEnabled ( )

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

                                                   : bool
    {
        return $this->show_exam_id_in_test_pass_enabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isShowExamIdInTestResultsEnabled()

ilObjTest::isShowExamIdInTestResultsEnabled ( )

Returns: boolean

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

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

◆ isShowGradingMarkEnabled()

ilObjTest::isShowGradingMarkEnabled ( )

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

                                              : bool
    {
        return $this->showGradingMarkEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isShowGradingStatusEnabled()

ilObjTest::isShowGradingStatusEnabled ( )

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

                                                : bool
    {
        return $this->showGradingStatusEnabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isSingleChoiceTest()

ilObjTest::isSingleChoiceTest ( )

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

                                        : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT DISTINCT(qpl_qst_type.type_tag) foundtypes FROM qpl_questions, tst_test_result, qpl_qst_type, tst_active WHERE tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_result.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
            array('integer'),
            array($this->getTestId())
        );
        if ($result->numRows() == 1) {
            $row = $ilDB->fetchAssoc($result);
            if (strcmp($row['foundtypes'], 'assSingleChoice') == 0) {
                return true;
            } else {
                return false;
            }
        }
        return false;
    }

References $DIC, $ilDB, and getTestId().

Here is the call graph for this function:

◆ isSingleChoiceTestWithoutShuffle()

ilObjTest::isSingleChoiceTestWithoutShuffle ( )

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

                                                      : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if (!$this->hasSingleChoiceQuestions()) {
            return false;
        }
 
        $result = $ilDB->queryF(
            "
                                SELECT  DISTINCT(qpl_qst_sc.shuffle) foundshuffles
                                FROM    qpl_questions,
                                                qpl_qst_sc,
                                                tst_test_result,
                                                qpl_qst_type,
                                                tst_active
                                WHERE   tst_test_result.question_fi = qpl_questions.question_id
                                AND             qpl_questions.question_type_fi = qpl_qst_type.question_type_id
                                AND             tst_test_result.active_fi = tst_active.active_id
                                AND             qpl_questions.question_id = qpl_qst_sc.question_fi
                                AND             tst_active.test_fi = %s
                                AND             qpl_qst_type.type_tag = %s
                        ",
            array('integer', 'text'),
            array($this->getTestId(), 'assSingleChoice')
        );
        if ($result->numRows() == 1) {
            $row = $ilDB->fetchAssoc($result);
            return ($row['foundshuffles'] == 0);
        }
        return false;
    }

References $DIC, $ilDB, getTestId(), and hasSingleChoiceQuestions().

Here is the call graph for this function:

◆ isSkillManagementGloballyActivated()

static ilObjTest::isSkillManagementGloballyActivated ( )

static

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

                                                               : ?bool
    {
        if (self::$isSkillManagementGloballyActivated === null) {
            $skmgSet = new ilSkillManagementSettings();
 
            self::$isSkillManagementGloballyActivated = $skmgSet->isActivated();
        }
 
        return self::$isSkillManagementGloballyActivated;
    }

Referenced by ilObjTestSettingsGeneralGUI\buildForm(), ilTestSkillAdministrationGUI\isAccessDenied(), ilObjTestSettingsGeneralGUI\isSkillServiceSettingToBeAdjusted(), and ilObjTestSettingsGeneralGUI\performSaveForm().

Here is the caller graph for this function:

◆ isSkillServiceEnabled()

ilObjTest::isSkillServiceEnabled ( )

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

                                           : bool
    {
        return $this->skillServiceEnabled;
    }

Referenced by saveToDb().

Here is the caller 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 10767 of file class.ilObjTest.php.

                                                  : bool
    {
        if (!$this->isSkillServiceEnabled()) {
            return false;
        }
 
        if (!self::isSkillManagementGloballyActivated()) {
            return false;
        }
 
        return true;
    }

◆ isStartingTimeEnabled()

ilObjTest::isStartingTimeEnabled ( )

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

                                           : ?bool
    {
        return $this->starting_time_enabled;
    }

Referenced by saveToDb().

Here is the caller graph for this function:

◆ isTestFinalBroken()

ilObjTest::isTestFinalBroken ( )

Returns: boolean

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

                                       : bool
    {
        return $this->testFinalBroken;
    }

Referenced by saveToDb().

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 7041 of file class.ilObjTest.php.

                                              : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT submitted FROM tst_active WHERE active_id=%s AND submitted=%s",
            array('integer', 'integer'),
            array($active_id, 1)
        );
        return $result->numRows() == 1;
    }

References $DIC, and $ilDB.

◆ 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 @access public

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

                                                                         : bool
    {
        $num = ilObjTest::lookupPassResultsUpdateTimestamp($active_id, $currentpass);
        return ((($currentpass > 0) && ($num == 0)) || $this->isTestFinished($active_id)) ? true : false;
    }

References lookupPassResultsUpdateTimestamp(), and true.

Here is the call graph for this function:

◆ isTestQuestion()

ilObjTest::isTestQuestion ( $questionId )

Parameters

int $questionId

Returns: bool

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

                                               : bool
    {
        foreach ($this->getTestQuestions() as $questionData) {
            if ($questionData['question_id'] != $questionId) {
                continue;
            }
 
            return true;
        }
 
        return false;
    }

◆ loadFromDb()

ilObjTest::loadFromDb ( )

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

                                : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT * FROM tst_tests WHERE obj_fi = %s",
            array('integer'),
            array($this->getId())
        );
        if ($result->numRows() == 1) {
            $data = $ilDB->fetchObject($result);
            $this->setTestId($data->test_id);
 
            if ($data->author) {
                if (strlen($this->getAuthor()) == 0) {
                    $this->saveAuthorToMetadata($data->author);
                }
                $this->setAuthor($data->author);
            }
 
            $this->setIntroductionEnabled($data->intro_enabled);
            $this->setIntroduction(ilRTE::_replaceMediaObjectImageSrc((string) $data->introduction, 1));
            $this->setShowInfo($data->showinfo);
            $this->setFinalStatement(ilRTE::_replaceMediaObjectImageSrc((string) $data->finalstatement, 1));
            $this->setForceJS($data->forcejs);
            $this->setCustomStyle($data->customstyle);
            $this->setShowFinalStatement($data->showfinalstatement);
            $this->setSequenceSettings($data->sequence_settings);
            $this->setInstantFeedbackSolution($data->instant_verification);
            $this->setAnswerFeedbackPoints($data->answer_feedback_points);
            $this->setAnswerFeedback($data->answer_feedback);
            $this->setAnonymity($data->anonymity);
            $this->setShowCancel($data->show_cancel);
            $this->setShowMarker($data->show_marker);
            $this->setFixedParticipants($data->fixed_participants);
            $this->setNrOfTries($data->nr_of_tries);
            $this->setBlockPassesAfterPassedEnabled((bool) $data->block_after_passed);
            $this->setKiosk($data->kiosk);
            $this->setUsePreviousAnswers($data->use_previous_answers);
            $this->setRedirectionMode($data->redirection_mode);
            $this->setRedirectionUrl($data->redirection_url);
            $this->setTitleOutput($data->title_output);
            $this->setProcessingTime($data->processing_time);
            $this->setEnableProcessingTime($data->enable_processing_time);
            $this->setResetProcessingTime($data->reset_processing_time);
            $this->setReportingDate($data->reporting_date);
            $this->setShuffleQuestions($data->shuffle_questions);
            $this->setStartingTimeEnabled($data->starting_time_enabled);
            $this->setStartingTime($data->starting_time);
            $this->setEndingTimeEnabled($data->ending_time_enabled);
            $this->setEndingTime($data->ending_time);
            $this->setListOfQuestionsSettings($data->show_summary);
            $this->setECTSOutput($data->ects_output);
            $this->setECTSGrades(
                array(
                    "A" => $data->ects_a,
                    "B" => $data->ects_b,
                    "C" => $data->ects_c,
                    "D" => $data->ects_d,
                    "E" => $data->ects_e
                )
            );
            $this->setECTSFX($data->ects_fx);
            $this->mark_schema->flush();
            $this->mark_schema->loadFromDb($this->getTestId());
            $this->setMailNotification($data->mailnotification);
            $this->setMailNotificationType($data->mailnottype);
            $this->setPasswordEnabled($data->password_enabled);
            $this->setPassword($data->password);
            $this->setLimitUsersEnabled($data->limit_users_enabled);
            $this->setAllowedUsers($data->allowedusers);
            $this->setAllowedUsersTimeGap($data->alloweduserstimegap);
            $this->setObligationsEnabled($data->obligations_enabled);
            $this->setOfferingQuestionHintsEnabled($data->offer_question_hints);
            $this->setEnabledViewMode($data->enabled_view_mode);
            $this->setTemplate($data->template_id);
            $this->setOldOnlineStatus(!$this->getOfflineStatus());
            $this->setSpecificAnswerFeedback((int) $data->specific_feedback);
            $this->setAutosave((bool) $data->autosave);
            $this->setAutosaveIval((int) $data->autosave_ival);
            $this->setEnableExamview((bool) $data->enable_examview);
            $this->setShowExamviewHtml((bool) $data->show_examview_html);
            $this->setShowExamviewPdf((bool) $data->show_examview_pdf);
            $this->setEnableArchiving((bool) $data->enable_archiving);
            $this->setShowExamIdInTestPassEnabled((bool) $data->examid_in_test_pass);
            $this->setSignSubmission((bool) $data->sign_submission);
            $this->setQuestionSetType($data->question_set_type);
            $this->setCharSelectorAvailability((int) $data->char_selector_availability);
            $this->setCharSelectorDefinition($data->char_selector_definition);
            $this->setSkillServiceEnabled((bool) $data->skill_service);
            $this->setShowGradingStatusEnabled((bool) $data->show_grading_status);
            $this->setShowGradingMarkEnabled((bool) $data->show_grading_mark);
            $this->setFollowupQuestionAnswerFixationEnabled((bool) $data->follow_qst_answer_fixation);
            $this->setInstantFeedbackAnswerFixationEnabled((bool) $data->inst_fb_answer_fixation);
            $this->setForceInstantFeedbackEnabled((bool) $data->force_inst_fb);
            $this->setTestFinalBroken((bool) $data->broken);
            $this->setPassWaiting($data->pass_waiting);
            $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;
            }
        }
    }

References $data, $DIC, $ilDB, ilRTE\_replaceMediaObjectImageSrc(), ILIAS\Survey\Mode\getId(), ilObjectActivation\getItem(), and ilObjectActivation\TIMINGS_ACTIVATION.

Referenced by read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadQuestions()

ilObjTest::loadQuestions	(	$active_id = `""`,
		$pass = `null`
	)

Load the test question id's from the database.

Parameters

int | null | string $active_id

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

                                                                : void
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $tags_trafo = $this->refinery->string()->stripTags();
 
        $this->questions = array();
        if ($this->isRandomTest()) {
            if (strcmp($active_id, "") == 0) {
                $active_id = $this->getActiveIdOfUser($ilUser->getId());
            }
            if (is_null($pass)) {
                $pass = self::_getPass($active_id);
            }
            $result = $ilDB->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",
                array('integer', 'integer'),
                array($active_id, $pass)
            );
            // The following is a fix for random tests prior to ILIAS 3.8. If someone started a random test in ILIAS < 3.8, there
            // is only one test pass (pass = 0) in tst_test_rnd_qst while with ILIAS 3.8 there are questions for every test pass.
            // To prevent problems with tests started in an older version and continued in ILIAS 3.8, the first pass should be taken if
            // no questions are present for a newer pass.
            if ($result->numRows() == 0) {
                $result = $ilDB->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 = 0 ORDER BY sequence",
                    array('integer'),
                    array($active_id)
                );
            }
        } else {
            $result = $ilDB->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",
                array('integer'),
                array($this->test_id)
            );
        }
        $index = 1;
        if ($this->test_id !== -1) {
            //Omit loading of questions for non-id'ed test
            while ($data = $ilDB->fetchAssoc($result)) {
                $this->questions[$index++] = $data["question_fi"];
            }
        }
    }

References $data, $DIC, $ilDB, $ilUser, $index, and ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ logAction()

ilObjTest::logAction	(	$logtext = `""`,
		$question_id = `""`
	)

Logs an action into the Test&Assessment log.

Parameters

string	$logtext	The log text
integer	$question_id	If given, saves the question id to the database @access public

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

    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
 
        $original_id = "";
        if (strcmp($question_id, "") != 0) {
            $original_id = assQuestion::_getOriginalId($question_id);
        }
        ilObjAssessmentFolder::_addLog($ilUser->getId(), $this->getId(), $logtext, $question_id, $original_id, true, $this->getRefId());
    }

References $DIC, $ilUser, ilObjAssessmentFolder\_addLog(), and assQuestion\_getOriginalId().

Referenced by saveQuestionsToDb(), and saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ logManualFeedback()

ilObjTest::logManualFeedback	(	$active_id,
		$question_id,
		$feedback
	)

private

Creates a log for the manual feedback.

Parameters

integer	$active_id	Active ID of the user
integer	$question_id	Question ID
string	$feedback	The feedback text

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

    {
        global $DIC;
 
        $ilUser = $DIC->user();
        $lng = $DIC->language();
        $username = ilObjTestAccess::_getParticipantData($active_id);
 
        $this->logAction(
            sprintf(
                $lng->txtlng('assessment', 'log_manual_feedback', ilObjAssessmentFolder::_getLogLanguage()),
                $ilUser->getFullname() . ' (' . $ilUser->getLogin() . ')',
                $username,
                assQuestion::_getQuestionTitle($question_id),
                $feedback
            )
        );
    }

References $DIC, $ilUser, $lng, ilObjAssessmentFolder\_getLogLanguage(), ilObjTestAccess\_getParticipantData(), and assQuestion\_getQuestionTitle().

Here is the call graph for this function:

◆ lookupExamId()

static ilObjTest::lookupExamId	(	$active_id,
		$pass
	)

static

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

    {
        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, array( 'integer', 'integer' ), array( $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;
    }

References $DIC, and $ilDB.

Referenced by ilTestServiceGUI\getResultsOfUserOutput(), ilTestPlayerAbstractGUI\outQuestionSummaryCmd(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestServiceGUI\populateExamId(), ilTestPlayerAbstractGUI\prepareTestPage(), and ilTestSubmissionReviewGUI\show().

Here is the caller graph for this function:

◆ lookupLastTestPassAccess()

static ilObjTest::lookupLastTestPassAccess	(	$activeId,
		$passIndex
	)

static

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

    {
        global $DIC; /* @var \ILIAS\DI\Container $DIC */
 
        $query = "
            SELECT MAX(tst_times.tstamp) as last_pass_access
            FROM tst_times
            WHERE active_fi = %s
            AND pass = %s
        ";
 
        $res = $DIC->database()->queryF(
            $query,
            array('integer', 'integer'),
            array($activeId, $passIndex)
        );
 
        while ($row = $DIC->database()->fetchAssoc($res)) {
            return $row['last_pass_access'];
        }
 
        return null;
    }

References $DIC, $query, and $res.

Referenced by ilTestServiceGUI\getPassOverviewTableData(), ilTestServiceGUI\getResultsOfUserOutput(), ilTestParticipantList\getScoringsTableRows(), ilTestEvaluationGUI\outParticipantsPassDetails(), and ilTestEvaluationGUI\outUserPassDetails().

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 7382 of file class.ilObjTest.php.

                                                                              : 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,
            array('integer', 'integer'),
            array($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;
    }

References $DIC, $ilDB, and $query.

Referenced by ilTestEvaluationGUI\detailedEvaluation(), ilTestExport\exportToCSV(), ilTestExport\exportToExcel(), ilTestService\getPassOverviewData(), and isTestFinishedToViewResults().

Here is the caller graph for this function:

◆ lookupQuestionSetType()

static ilObjTest::lookupQuestionSetType ( $objId )

static

lookup-er for question set type

@global ilDBInterface $ilDB

Parameters

integer $objId

Returns: string $questionSetType

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

                                                        : ?string
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT question_set_type FROM tst_tests WHERE obj_fi = %s";
 
        $res = $ilDB->queryF($query, array('integer'), array($objId));
 
        $questionSetType = null;
 
        while ($row = $ilDB->fetchAssoc($res)) {
            $questionSetType = $row['question_set_type'];
        }
 
        return $questionSetType;
    }

References $DIC, $ilDB, $objId, $query, and $res.

◆ lookupQuestionSetTypeByActiveId()

static ilObjTest::lookupQuestionSetTypeByActiveId ( $active_id )

static

returns the question set type of test relating to passed active id

Parameters

integer $activeId

Returns: string $questionSetType

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

                                                                      : ?string
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $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 = $ilDB->queryF($query, array('integer'), array($active_id));
 
        while ($row = $ilDB->fetchAssoc($res)) {
            return $row['question_set_type'];
        }
 
        return null;
    }

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

Referenced by _getQuestionCountAndPointsForPassOfParticipant().

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.

@access private

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

    {
        if ($a_tag == "Identifier" && $a_param == "Entry") {
            $a_value = ilUtil::insertInstIntoID($a_value);
        }
 
        return $a_value;
    }

References ilUtil\insertInstIntoID().

Here is the call graph for this function:

◆ moveQuestionAfter()

ilObjTest::moveQuestionAfter	(	$question_to_move,
		$question_before
	)

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        if ($question_before) {
            $query = 'SELECT sequence, test_fi FROM tst_test_question WHERE question_fi = %s';
            $types = array('integer');
            $values = array($question_before);
            $rset = $ilDB->queryF($query, $types, $values);
        }
 
        if (!$question_before || ($rset && !($row = $ilDB->fetchAssoc($rset)))) {
            $row = array(
            'sequence' => 0,
            'test_fi' => $this->getTestId(),
        );
        }
 
        $update = 'UPDATE tst_test_question SET sequence = sequence + 1 WHERE sequence > %s AND test_fi = %s';
        $types = array('integer', 'integer');
        $values = array($row['sequence'], $row['test_fi']);
        $ilDB->manipulateF($update, $types, $values);
 
        $update = 'UPDATE tst_test_question SET sequence = %s WHERE question_fi = %s';
        $types = array('integer', 'integer');
        $values = array($row['sequence'] + 1, $question_to_move);
        $ilDB->manipulateF($update, $types, $values);
 
        $this->reindexFixedQuestionOrdering();
    }

References $DIC, $ilDB, $query, and $update.

◆ moveQuestions()

ilObjTest::moveQuestions	(	$move_questions,
		$target_index,
		$insert_mode
	)

Move questions to another position.

Parameters

array	$move_questions	An array with the question id's of the questions to move
integer	$target_index	The question id of the target position
integer	$insert_mode	0, if insert before the target position, 1 if insert after the target position @access public

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

    {
        $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 = array();
        $counter = 1;
        foreach ($new_array as $question_id) {
            $this->questions[$counter] = $question_id;
            $counter++;
        }
        $this->saveQuestionsToDb();
    }

◆ participantDataExist()

ilObjTest::participantDataExist ( )

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

                                          : bool
    {
        if ($this->participantDataExist === null) {
            $this->participantDataExist = (bool) $this->evalTotalPersons();
        }
 
        return $this->participantDataExist;
    }

◆ pcArrayShuffle()

ilObjTest::pcArrayShuffle ( $array )

Shuffles the values of a given array.

Parameters

array $array An array which should be shuffled @access public

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

                                          : array
    {
        $keys = array_keys($array);
        shuffle($keys);
        $result = array();
        foreach ($keys as $key) {
            $result[$key] = $array[$key];
        }
        return $result;
    }

References ILIAS\LTI\ToolProvider\$key, and $keys.

◆ 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 @access public

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

    {
        if ($txt_output == null) {
            $txt_output = '';
        }
        return ilLegacyFormElementsUtil::prepareTextareaOutput(
            $txt_output,
            $prepare_for_latex_output,
            $omitNl2BrWhenTextArea
        );
    }

References ilLegacyFormElementsUtil\prepareTextareaOutput().

Here is the call graph for this function:

◆ processCSVRow()

& ilObjTest::processCSVRow	(	$row,
		$quoteAll = `false`,
		$separator = `";"`
	)

Processes an array as a CSV row and converts the array values to correct CSV values.

The "converted" array is returned

Parameters

array	$row	The array containing the values for a CSV row
string	$quoteAll	Indicates to quote every value (=TRUE) or only values containing quotes and separators (=FALSE, default)
string	$separator	The value separator in the CSV row (used for quoting) (; = default)

Returns: array The converted array ready for CSV use @access public

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

                                                                             : array
    {
        $resultarray = array();
        foreach ($row as $rowindex => $entry) {
            $surround = false;
            if ($quoteAll) {
                $surround = true;
            }
            if (strpos($entry, "\"") !== false) {
                $entry = str_replace("\"", "\"\"", $entry);
                $surround = true;
            }
            if (strpos($entry, $separator) !== false) {
                $surround = true;
            }
            // replace all CR LF with LF (for Excel for Windows compatibility
            $entry = str_replace(chr(13) . chr(10), chr(10), $entry);
 
            if ($surround) {
                $entry = "\"" . $entry . "\"";
            }
 
            $resultarray[$rowindex] = $entry;
        }
        return $resultarray;
    }

◆ processPrintoutput2FO()

ilObjTest::processPrintoutput2FO ( $print_output )

Convert a print output to XSL-FO.

Parameters

string $print_output The print output

Returns: string XSL-FO code @access public

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

                                                        : string
    {
        if (extension_loaded("tidy")) {
            $config = array(
                "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("./Modules/Test/xml/question2fo.xsl");
 
        // additional font support
        global $DIC;
        $xsl = str_replace(
            'font-family="Helvetica, unifont"',
            'font-family="' . $DIC['ilSetting']->get('rpc_pdf_font', 'Helvetica, unifont') . '"',
            $xsl
        );
 
        $args = array( '/_xml' => $print_output, '/_xsl' => $xsl );
        $xh = xslt_create();
        $params = array();
        $output = xslt_process($xh, "arg:/_xml", "arg:/_xsl", null, $args, $params);
        xslt_error($xh);
        xslt_free($xh);
        return $output;
    }

References $config, $DIC, $params, xslt_create(), xslt_error(), and xslt_free().

Here is the call graph for this function:

◆ QTIMaterialToString()

ilObjTest::QTIMaterialToString ( $a_material )

Reads an QTI material tag an creates a text string.

Returns: string text or xhtml string @access public

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

                                                    : string
    {
        $result = "";
        for ($i = 0; $i < $a_material->getMaterialCount(); $i++) {
            $material = $a_material->getMaterial($i);
            if (strcmp($material["type"], "mattext") == 0) {
                $result .= $material["material"]->getContent();
            }
            if (strcmp($material["type"], "matimage") == 0) {
                $matimage = $material["material"];
                if (preg_match("/(il_([0-9]+)_mob_([0-9]+))/", $matimage->getLabel(), $matches)) {
                    // import an mediaobject which was inserted using tiny mce
                    if (!is_array(ilSession::get("import_mob_xhtml"))) {
                        ilSession::set("import_mob_xhtml", array());
                    }
                    $import_mob_xhtml = ilSession::get("import_mob_xhtml");
                    array_push($import_mob_xhtml, array("mob" => $matimage->getLabel(), "uri" => $matimage->getUri()));
                }
            }
        }
        global $DIC;
        $ilLog = $DIC['ilLog'];
        $ilLog->write(print_r(ilSession::get("import_mob_xhtml"), true));
        return $result;
    }

References $DIC, $i, ilSession\get(), and ilSession\set().

Here is the call 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 @access public

See also: $test_id

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        // Move a question down in sequence
        $result = $ilDB->queryF(
            "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
            array('integer','integer'),
            array($this->getTestId(), $question_id)
        );
        $data = $ilDB->fetchObject($result);
        $result = $ilDB->queryF(
            "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
            array('integer','integer'),
            array($this->getTestId(), $data->sequence + 1)
        );
        if ($result->numRows() == 1) {
            // OK, it's not the last question, so move it down
            $data_next = $ilDB->fetchObject($result);
            // change next dataset
            $ilDB->manipulateF(
                "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                array('integer','integer'),
                array($data->sequence, $data_next->test_question_id)
            );
            // move actual dataset down
            $ilDB->manipulateF(
                "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                array('integer','integer'),
                array($data->sequence + 1, $data->test_question_id)
            );
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($data->sequence) . " => " . ($data->sequence + 1), $question_id);
            }
        }
        $this->loadQuestions();
    }

References $data, $DIC, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), and ILIAS\Repository\lng().

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 @access public

See also: $test_id

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        // Move a question up in sequence
        $result = $ilDB->queryF(
            "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
            array('integer', 'integer'),
            array($this->getTestId(), $question_id)
        );
        $data = $ilDB->fetchObject($result);
        if ($data->sequence > 1) {
            // OK, it's not the top question, so move it up
            $result = $ilDB->queryF(
                "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
                array('integer','integer'),
                array($this->getTestId(), $data->sequence - 1)
            );
            $data_previous = $ilDB->fetchObject($result);
            // change previous dataset
            $ilDB->manipulateF(
                "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                array('integer','integer'),
                array($data->sequence, $data_previous->test_question_id)
            );
            // move actual dataset up
            $ilDB->manipulateF(
                "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
                array('integer','integer'),
                array($data->sequence - 1, $data->test_question_id)
            );
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($data->sequence) . " => " . ($data->sequence - 1), $question_id);
            }
        }
        $this->loadQuestions();
    }

References $data, $DIC, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ randomSelectQuestions()

ilObjTest::randomSelectQuestions	(	int	$nr_of_questions,
		int	$questionpool,
			$use_obj_id = `0`,
			$qpls = `""`,
			$pass = `null`
	)

Returns a random selection of questions.

Parameters

bool \| int	$use_obj_id	Use the object id instead of the reference id when set to true
array \| string	$qpls	An array of questionpool id's if the random questions should only be chose from the contained questionpools

Deprecated:: --> old school random test

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

     : array {
        global $DIC;
        $rbacsystem = $DIC['rbacsystem'];
        $ilDB = $DIC['ilDB'];
 
        // retrieve object id instead of ref id if necessary
        if (($questionpool != 0) && (!$use_obj_id)) {
            $questionpool = ilObject::_lookupObjId($questionpool);
        }
 
        // get original ids of all existing questions in the test
        $result = $ilDB->queryF(
            "SELECT qpl_questions.original_id FROM qpl_questions, tst_test_question WHERE qpl_questions.question_id = tst_test_question.question_fi AND qpl_questions.tstamp > 0 AND tst_test_question.test_fi = %s",
            array("integer"),
            array($this->getTestId())
        );
        $original_ids = array();
        $paramtypes = array();
        $paramvalues = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            array_push($original_ids, $row['original_id']);
        }
 
        $available = "";
        // get a list of all available questionpools
        if (($questionpool == 0) && (!is_array($qpls))) {
            $available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools($use_object_id = true, $equal_points = false, $could_be_offline = false, $showPath = false, $with_questioncount = false, "read", ilObject::_lookupOwner($this->getId())));
            if (count($available_pools)) {
                $available = " AND " . $ilDB->in('obj_fi', $available_pools, false, 'integer');
            } else {
                return array();
            }
        }
 
        $constraint_qpls = "";
        $result_array = array();
        if ($questionpool == 0) {
            if (is_array($qpls)) {
                if (count($qpls) > 0) {
                    $constraint_qpls = " AND " . $ilDB->in('obj_fi', $qpls, false, 'integer');
                }
            }
        }
 
        $original_clause = "";
        if (count($original_ids)) {
            $original_clause = " AND " . $ilDB->in('question_id', $original_ids, true, 'integer');
        }
 
        if ($questionpool == 0) {
            $result = $ilDB->queryF(
                "SELECT question_id FROM qpl_questions WHERE original_id IS NULL $available $constraint_qpls AND owner > %s AND complete = %s $original_clause",
                array('integer', 'text'),
                array(0, "1")
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT question_id FROM qpl_questions WHERE original_id IS NULL AND obj_fi = %s AND owner > %s AND complete = %s $original_clause",
                array('integer','integer', 'text'),
                array($questionpool, 0, "1")
            );
        }
        $found_ids = array();
        while ($row = $ilDB->fetchAssoc($result)) {
            array_push($found_ids, $row['question_id']);
        }
        $nr_of_questions = ($nr_of_questions > count($found_ids)) ? count($found_ids) : $nr_of_questions;
        if ($nr_of_questions == 0) {
            return array();
        }
        $rand_keys = array_rand($found_ids, $nr_of_questions);
        $result = array();
        if (is_array($rand_keys)) {
            foreach ($rand_keys as $key) {
                $result[$found_ids[$key]] = $found_ids[$key];
            }
        } else {
            $result[$found_ids[$rand_keys]] = $found_ids[$rand_keys];
        }
        return $result;
    }

References ilObject\_lookupObjId().

Here is the call graph for this function:

◆ read()

ilObjTest::read ( )

Reimplemented from ilObject.

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

                          : void
    {
        parent::read();
        $this->loadFromDb();
    }

References loadFromDb().

Here is the call graph for this function:

◆ recalculateScores()

ilObjTest::recalculateScores ( $preserve_manscoring = false )

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

    {
        $scoring = new ilTestScoring($this);
        $scoring->setPreserveManualScores($preserve_manscoring);
        $scoring->recalculateSolutions();
        ilLPStatusWrapper::_updateStatus($this->getId(), $this->user->getId());
    }

References ilLPStatusWrapper\_updateStatus(), ILIAS\Survey\Mode\getId(), and ILIAS\Repository\user().

Here is the call graph for this function:

◆ reindexFixedQuestionOrdering()

ilObjTest::reindexFixedQuestionOrdering ( )

Returns: ilTestReindexedSequencePositionMap

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

                                                  : ilTestReindexedSequencePositionMap
    {
        global $DIC;
        $tree = $DIC['tree'];
        $db = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
 
        $qscFactory = new ilTestQuestionSetConfigFactory($tree, $db, $component_repository, $this);
        $questionSetConfig = $qscFactory->getQuestionSetConfig();
 
        /* @var ilTestFixedQuestionSetConfig $questionSetConfig */
        $reindexedSequencePositionMap = $questionSetConfig->reindexQuestionOrdering();
 
        $this->loadQuestions();
 
        return $reindexedSequencePositionMap;
    }

References $DIC.

◆ removeQuestion()

ilObjTest::removeQuestion ( int $question_id )

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

                                                    : void
    {
        try {
            $question = self::_instanciateQuestion($question_id);
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction(
                    $this->lng->txtlng("assessment", "log_question_removed", ilObjAssessmentFolder::_getLogLanguage()),
                    $question_id
                );
            }
            $question->delete($question_id);
        } catch (InvalidArgumentException $e) {
            $this->log->error($e->getMessage());
            $this->log->error($e->getTraceAsString());
        }
    }

References Vendor\Package\$e, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ removeQuestionFromSequences()

ilObjTest::removeQuestionFromSequences	(		$questionId,
			$activeIds,
		ilTestReindexedSequencePositionMap	$reindexedSequencePositionMap
	)

Parameters

int	$questionId
array	$activeIds
ilTestReindexedSequencePositionMap	$reindexedSequencePositionMap

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

                                                                                                                                          : void
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $testSequenceFactory = new ilTestSequenceFactory(
            $DIC->database(),
            $DIC->language(),
            $DIC['refinery'],
            $DIC['component.repository'],
            $this
        );
 
        foreach ($activeIds as $activeId) {
            $passSelector = new ilTestPassesSelector($DIC->database(), $this);
            $passSelector->setActiveId($activeId);
 
            foreach ($passSelector->getExistingPasses() as $pass) {
                $testSequence = $testSequenceFactory->getSequenceByActiveIdAndPass($activeId, $pass);
                $testSequence->loadFromDb();
 
                $testSequence->removeQuestion($questionId, $reindexedSequencePositionMap);
                $testSequence->saveToDb();
            }
        }
    }

References $DIC.

◆ removeQuestions()

ilObjTest::removeQuestions ( array $removeQuestionIds )

Parameters

int[] $removeQuestionIds

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

                                                             : void
    {
        foreach ($removeQuestionIds as $value) {
            $this->removeQuestion((int) $value);
        }
 
        $this->reindexFixedQuestionOrdering();
    }

◆ removeTestActives()

ilObjTest::removeTestActives ( $activeIds )

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $IN_activeIds = $ilDB->in('active_id', $activeIds, false, 'integer');
        $ilDB->manipulate("DELETE FROM tst_active WHERE $IN_activeIds");
    }

References $DIC, and $ilDB.

Referenced by ilCourseObjectiveResult\resetTestForUser().

Here is the caller graph for this function:

◆ removeTestResults()

ilObjTest::removeTestResults ( ilTestParticipantData $participantData )

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

    {
        if (count($participantData->getAnonymousActiveIds())) {
            $this->removeTestResultsByActiveIds($participantData->getAnonymousActiveIds());
        }
 
        if (count($participantData->getUserIds())) {
            /* @var ilTestLP $testLP */
            $testLP = ilObjectLP::getInstance($this->getId());
            $testLP->setTestObject($this);
            $testLP->resetLPDataForUserIds($participantData->getUserIds(), false);
        }
 
        if (count($participantData->getActiveIds())) {
            $this->removeTestActives($participantData->getActiveIds());
        }
    }

References ilTestParticipantData\getActiveIds(), ilTestParticipantData\getAnonymousActiveIds(), ILIAS\Survey\Mode\getId(), ilObjectLP\getInstance(), and ilTestParticipantData\getUserIds().

Referenced by deleteTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTestResultsByActiveIds()

ilObjTest::removeTestResultsByActiveIds ( $activeIds )

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

    {
        $ilDB = $this->db;
 
        $IN_activeIds = $ilDB->in('active_fi', $activeIds, false, 'integer');
 
        $ilDB->manipulate("DELETE FROM tst_solutions WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_qst_solved WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_test_result WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_pass_result WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_result_cache WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_sequence WHERE $IN_activeIds");
        $ilDB->manipulate("DELETE FROM tst_times WHERE $IN_activeIds");
 
        if ($this->isRandomTest()) {
            $ilDB->manipulate("DELETE FROM tst_test_rnd_qst WHERE $IN_activeIds");
        } elseif ($this->isDynamicTest()) {
            $ilDB->manipulate("DELETE FROM tst_seq_qst_tracking WHERE $IN_activeIds");
            $ilDB->manipulate("DELETE FROM tst_seq_qst_answstatus WHERE $IN_activeIds");
            $ilDB->manipulate("DELETE FROM tst_seq_qst_postponed WHERE $IN_activeIds");
            $ilDB->manipulate("DELETE FROM tst_seq_qst_checked WHERE $IN_activeIds");
        }
 
        foreach ($activeIds 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");
            }
 
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction(sprintf($this->lng->txtlng("assessment", "log_selected_user_data_removed", ilObjAssessmentFolder::_getLogLanguage()), $this->userLookupFullName($this->_getUserIdFromActiveId($active_id))));
            }
        }
 
        ilAssQuestionHintTracking::deleteRequestsByActiveIds($activeIds);
    }

References $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), CLIENT_WEB_DIR, ilFileUtils\delDir(), ilAssQuestionHintTracking\deleteRequestsByActiveIds(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ removeTestResultsByUserIds()

ilObjTest::removeTestResultsByUserIds ( $userIds )

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

    {
        $ilDB = $this->db;
        $lng = $this->lng;
 
        $participantData = new ilTestParticipantData($ilDB, $lng);
        $participantData->setUserIdsFilter($userIds);
        $participantData->load($this->getTestId());
 
        $IN_userIds = $ilDB->in('usr_id', $participantData->getUserIds(), false, 'integer');
        $ilDB->manipulateF(
            "DELETE FROM usr_pref WHERE $IN_userIds AND keyword = %s",
            array('text'),
            array("tst_password_" . $this->getTestId())
        );
 
        if (count($participantData->getActiveIds())) {
            $this->removeTestResultsByActiveIds($participantData->getActiveIds());
        }
    }

References $ilDB, and $lng.

◆ removeTestResultsFromSoapLpAdministration()

ilObjTest::removeTestResultsFromSoapLpAdministration ( $userIds )

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 2614 of file class.ilObjTest.php.

    {
        $this->removeTestResultsByUserIds($userIds);
 
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
 
        $participantData = new ilTestParticipantData($ilDB, $lng);
        $participantData->setUserIdsFilter($userIds);
        $participantData->load($this->getTestId());
 
        $this->removeTestActives($participantData->getActiveIds());
    }

References $DIC, $ilDB, and $lng.

◆ saveAuthorToMetadata()

ilObjTest::saveAuthorToMetadata ( string $a_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 @access private

See also: $author

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

    {
        $md = new ilMD($this->getId(), 0, $this->getType());
        $md_life = $md->getLifecycle();
        if (!$md_life) {
            if (strlen($a_author) == 0) {
                global $DIC;
                $ilUser = $DIC['ilUser'];
                $a_author = $ilUser->getFullname();
            }
 
            $md_life = $md->addLifecycle();
            $md_life->save();
            $con = $md_life->addContribute();
            $con->setRole("Author");
            $con->save();
            $ent = $con->addEntity();
            $ent->setEntity($a_author);
            $ent->save();
        }
    }

References $DIC, $ilUser, and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ saveCompleteStatus()

ilObjTest::saveCompleteStatus ( ilTestQuestionSetConfig $testQuestionSetConfig )

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

                                                                                      : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $complete = 0;
        if ($this->isComplete($testQuestionSetConfig)) {
            $complete = 1;
        }
        if ($this->getTestId() > 0) {
            $ilDB->manipulateF(
                "UPDATE tst_tests SET complete = %s WHERE test_id = %s",
                array('text', 'integer'),
                array($complete, $this->test_id)
            );
        }
    }

References $DIC, $ilDB, getTestId(), and isComplete().

Here is the call graph for this function:

◆ saveManualFeedback()

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

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

     : bool {
        global $DIC;
 
        $feedback_old = self::getSingleManualFeedback($active_id, $question_id, $pass);
 
        $finalized_record = (int) ($feedback_old['finalized_evaluation'] ?? 0);
        if ($finalized_record === 0 || ($is_single_feedback && $finalized_record === 1)) {
            $DIC->database()->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);
 
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logManualFeedback($active_id, $question_id, $feedback);
            }
        }
 
        return true;
    }

◆ saveQuestionsToDb()

ilObjTest::saveQuestionsToDb ( )

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

                                       : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $oldquestions = array();
        if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
            $result = $ilDB->queryF(
                "SELECT question_fi FROM tst_test_question WHERE test_fi = %s ORDER BY sequence",
                array('integer'),
                array($this->getTestId())
            );
            if ($result->numRows() > 0) {
                while ($row = $ilDB->fetchAssoc($result)) {
                    array_push($oldquestions, $row["question_fi"]);
                }
            }
        }
        // workaround for lost obligations
        // this method is called if a question is removed
        $currentQuestionsObligationsQuery = 'SELECT question_fi, obligatory FROM tst_test_question WHERE test_fi = %s';
        $rset = $ilDB->queryF($currentQuestionsObligationsQuery, array('integer'), array($this->getTestId()));
        while ($row = $ilDB->fetchAssoc($rset)) {
            $obligatoryQuestionState[$row['question_fi']] = $row['obligatory'];
        }
        // delete existing category relations
        $affectedRows = $ilDB->manipulateF(
            "DELETE FROM tst_test_question WHERE test_fi = %s",
            array('integer'),
            array($this->getTestId())
        );
        // create new category relations
        foreach ($this->questions as $key => $value) {
            // workaround for import witout obligations information
            if (!isset($obligatoryQuestionState[$value]) || is_null($obligatoryQuestionState[$value])) {
                $obligatoryQuestionState[$value] = 0;
            }
 
            // insert question
            $next_id = $ilDB->nextId('tst_test_question');
            $ilDB->insert('tst_test_question', array(
                'test_question_id' => array('integer', $next_id),
                'test_fi' => array('integer', $this->getTestId()),
                'question_fi' => array('integer', $value),
                'sequence' => array('integer', $key),
                'obligatory' => array('integer', $obligatoryQuestionState[$value]),
                'tstamp' => array('integer', time())
            ));
        }
        if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
            $result = $ilDB->queryF(
                "SELECT question_fi FROM tst_test_question WHERE test_fi = %s ORDER BY sequence",
                array('integer'),
                array($this->getTestId())
            );
            $newquestions = array();
            if ($result->numRows() > 0) {
                while ($row = $ilDB->fetchAssoc($result)) {
                    array_push($newquestions, $row["question_fi"]);
                }
            }
            foreach ($oldquestions as $index => $question_id) {
                if (strcmp($newquestions[$index], $question_id) != 0) {
                    $pos = array_search($question_id, $newquestions);
                    if ($pos === false) {
                        $this->logAction($this->lng->txtlng("assessment", "log_question_removed", ilObjAssessmentFolder::_getLogLanguage()), $question_id);
                    } else {
                        $this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($index + 1) . " => " . ($pos + 1), $question_id);
                    }
                }
            }
            foreach ($newquestions as $index => $question_id) {
                if (array_search($question_id, $oldquestions) === false) {
                    $this->logAction($this->lng->txtlng("assessment", "log_question_added", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($index + 1), $question_id);
                }
            }
        }
    }

References $DIC, $ilDB, $index, ILIAS\LTI\ToolProvider\$key, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getTestId(), ILIAS\Repository\lng(), and logAction().

Referenced by saveToDb().

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 780 of file class.ilObjTest.php.

                                                           : void
    {
        global $DIC;
        $tree = $DIC['tree'];
        $ilDB = $DIC['ilDB'];
        $component_repository = $DIC['component.repository'];
 
        // moved online_status to ilObjectActivation (see below)
 
        // cleanup RTE images
        $this->cleanupMediaobjectUsage();
 
        $testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory($tree, $ilDB, $component_repository, $this);
        $testQuestionSetConfig = $testQuestionSetConfigFactory->getQuestionSetConfig();
 
        if ($this->test_id == -1) {
            // Create new dataset
            $next_id = $ilDB->nextId('tst_tests');
 
            $ilDB->insert('tst_tests', array(
                'test_id' => array('integer', $next_id),
                'obj_fi' => array('integer', $this->getId()),
                'author' => array('text', $this->getAuthor()),
                'intro_enabled' => array('integer', (int) $this->isIntroductionEnabled()),
                'introduction' => array('text', ilRTE::_replaceMediaObjectImageSrc((string) $this->getIntroduction(), 0)),
                'finalstatement' => array('text', ilRTE::_replaceMediaObjectImageSrc((string) $this->getFinalStatement(), 0)),
                'showinfo' => array('integer', $this->getShowInfo()),
                'forcejs' => array('integer', $this->getForceJS()),
                'customstyle' => array('text', $this->getCustomStyle()),
                'showfinalstatement' => array('integer', $this->getShowFinalStatement()),
                'sequence_settings' => array('integer', $this->getSequenceSettings()),
                'score_reporting' => array('integer', $this->getScoreReporting()),
                'instant_verification' => array('text', $this->getInstantFeedbackSolution()),
                'answer_feedback_points' => array('text', $this->getAnswerFeedbackPoints()),
                'answer_feedback' => array('text', $this->getAnswerFeedback()),
                'anonymity' => array('text', $this->getAnonymity()),
                'show_cancel' => array('text', $this->getShowCancel()),
                'show_marker' => array('integer', $this->getShowMarker()),
                'fixed_participants' => array('text', $this->getFixedParticipants()),
                'nr_of_tries' => array('integer', $this->getNrOfTries()),
                'block_after_passed' => array('integer', (int) $this->isBlockPassesAfterPassedEnabled()),
                'kiosk' => array('integer', $this->getKiosk()),
                'use_previous_answers' => array('text', $this->getUsePreviousAnswers()),
                'title_output' => array('text', $this->getTitleOutput()),
                'processing_time' => array('text', $this->getProcessingTime()),
                'enable_processing_time' => array('text', $this->getEnableProcessingTime()),
                'reset_processing_time' => array('integer', $this->getResetProcessingTime()),
                'starting_time_enabled' => array('integer', $this->isStartingTimeEnabled()),
                'starting_time' => array('integer', $this->getStartingTime()),
                'ending_time_enabled' => array('integer', $this->isEndingTimeEnabled()),
                'ending_time' => array('integer', $this->getEndingTime()),
                'complete' => array('text', $this->isComplete($testQuestionSetConfig)),
                'ects_output' => array('text', $this->getECTSOutput()),
                'ects_a' => array('float', strlen($this->ects_grades["A"]) ? $this->ects_grades["A"] : 90),// defaults as per db definition
                'ects_b' => array('float', strlen($this->ects_grades["B"]) ? $this->ects_grades["B"] : 65),
                'ects_c' => array('float', strlen($this->ects_grades["C"]) ? $this->ects_grades["C"] : 35),
                'ects_d' => array('float', strlen($this->ects_grades["D"]) ? $this->ects_grades["D"] : 10),
                'ects_e' => array('float', strlen($this->ects_grades["E"]) ? $this->ects_grades["E"] : 0),
                'ects_fx' => array('float', $this->getECTSFX()),
                'shuffle_questions' => array('text', $this->getShuffleQuestions()),
                'show_summary' => array('integer', $this->getListOfQuestionsSettings()),
                'password_enabled' => array('integer', (int) $this->isPasswordEnabled()),
                'password' => array('text', $this->getPassword()),
                'limit_users_enabled' => array('integer', (int) $this->isLimitUsersEnabled()),
                'allowedusers' => array('integer', $this->getAllowedUsers()),
                'alloweduserstimegap' => array('integer', $this->getAllowedUsersTimeGap()),
                'mailnottype' => array('integer', $this->getMailNotificationType()),
                'mailnotification' => array('integer', $this->getMailNotification()),
                'created' => array('integer', time()),
                'tstamp' => array('integer', time()),
                'enabled_view_mode' => array('text', $this->getEnabledViewMode()),
                'template_id' => array('integer', $this->getTemplate()),
                'obligations_enabled' => array('integer', (int) $this->areObligationsEnabled()),
                'offer_question_hints' => array('integer', (int) $this->isOfferingQuestionHintsEnabled()),
                'specific_feedback' => array('integer', $this->getSpecificAnswerFeedback()),
                'autosave' => array('integer', (int) $this->getAutosave()),
                'autosave_ival' => array('integer', $this->getAutosaveIval()),
                'enable_examview' => array('integer', (int) $this->getEnableExamview()),
                'show_examview_html' => array('integer', (int) $this->getShowExamviewHtml()),
                'show_examview_pdf' => array('integer', (int) $this->getShowExamviewPdf()),
                'redirection_mode' => array('integer', $this->getRedirectionMode()),
                'redirection_url' => array('text', (string) $this->getRedirectionUrl()),
                'enable_archiving' => array('integer', (int) $this->getEnableArchiving()),
                'examid_in_test_pass' => array('integer', (int) $this->isShowExamIdInTestPassEnabled()),
                'sign_submission' => array('integer', (int) $this->getSignSubmission()),
                'question_set_type' => array('text', $this->getQuestionSetType()),
                'char_selector_availability' => array('integer', $this->getCharSelectorAvailability()),
                'char_selector_definition' => array('text', (string) $this->getCharSelectorDefinition()),
                'skill_service' => array('integer', (int) $this->isSkillServiceEnabled()),
                'result_tax_filters' => array('text', serialize($this->getResultFilterTaxIds())),
                'follow_qst_answer_fixation' => array('integer', (int) $this->isFollowupQuestionAnswerFixationEnabled()),
                'inst_fb_answer_fixation' => array('integer', (int) $this->isInstantFeedbackAnswerFixationEnabled()),
                'force_inst_fb' => array('integer', (int) $this->isForceInstantFeedbackEnabled()),
                'broken' => array('integer', (int) $this->isTestFinalBroken()),
                'pass_waiting' => array('text', $this->getPassWaiting())
            ));
 
            $this->test_id = $next_id;
 
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $this->logAction($this->lng->txtlng("assessment", "log_create_new_test", ilObjAssessmentFolder::_getLogLanguage()));
            }
        } else {
            // Modify existing dataset
            $oldrow = array();
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $result = $ilDB->queryF(
                    "SELECT * FROM tst_tests WHERE test_id = %s",
                    array('integer'),
                    array($this->test_id)
                );
                if ($result->numRows() == 1) {
                    $oldrow = $ilDB->fetchAssoc($result);
                }
            }
 
            $ilDB->update(
                'tst_tests',
                array(
                    'author' => array('text', $this->getAuthor()),
                    'intro_enabled' => array('integer', (int) $this->isIntroductionEnabled()),
                    'introduction' => array('text', ilRTE::_replaceMediaObjectImageSrc((string) $this->getIntroduction(), 0)),
                    'finalstatement' => array('text', ilRTE::_replaceMediaObjectImageSrc((string) $this->getFinalStatement(), 0)),
                    'showinfo' => array('integer', $this->getShowInfo()),
                    'forcejs' => array('integer', $this->getForceJS()),
                    'customstyle' => array('text', $this->getCustomStyle()),
                    'showfinalstatement' => array('integer', $this->getShowFinalStatement()),
                    'sequence_settings' => array('integer', $this->getSequenceSettings()),
                    'score_reporting' => array('integer', $this->getScoreReporting()),
                    'instant_verification' => array('text', $this->getInstantFeedbackSolution()),
                    'answer_feedback_points' => array('text', $this->getAnswerFeedbackPoints()),
                    'answer_feedback' => array('text', $this->getGenericAnswerFeedback()),
                    'anonymity' => array('text', $this->getAnonymity()),
                    'show_cancel' => array('text', $this->getShowCancel()),
                    'show_marker' => array('integer', $this->getShowMarker()),
                    'fixed_participants' => array('text', $this->getFixedParticipants()),
                    'nr_of_tries' => array('integer', $this->getNrOfTries()),
                    'block_after_passed' => array('integer', (int) $this->isBlockPassesAfterPassedEnabled()),
                    'kiosk' => array('integer', $this->getKiosk()),
                    'use_previous_answers' => array('text', $this->getUsePreviousAnswers()),
                    'title_output' => array('text', $this->getTitleOutput()),
                    'processing_time' => array('text', $this->getProcessingTime()),
                    'enable_processing_time' => array('text', $this->getEnableProcessingTime()),
                    'reset_processing_time' => array('integer', $this->getResetProcessingTime()),
                    'starting_time_enabled' => array('integer', $this->isStartingTimeEnabled()),
                    'starting_time' => array('integer', $this->getStartingTime()),
                    'ending_time_enabled' => array('integer', $this->isEndingTimeEnabled()),
                    'ending_time' => array('integer', $this->getEndingTime()),
                    'complete' => array('text', $this->isComplete($testQuestionSetConfig)),
                    'ects_output' => array('text', $this->getECTSOutput()),
                    'ects_a' => array('float', strlen($this->ects_grades["A"]) ? $this->ects_grades["A"] : null),
                    'ects_b' => array('float', strlen($this->ects_grades["B"]) ? $this->ects_grades["B"] : null),
                    'ects_c' => array('float', strlen($this->ects_grades["C"]) ? $this->ects_grades["C"] : null),
                    'ects_d' => array('float', strlen($this->ects_grades["D"]) ? $this->ects_grades["D"] : null),
                    'ects_e' => array('float', strlen($this->ects_grades["E"]) ? $this->ects_grades["E"] : null),
                    'ects_fx' => array('float', $this->getECTSFX()),
                    'shuffle_questions' => array('text', $this->getShuffleQuestions()),
                    'show_summary' => array('integer', $this->getListOfQuestionsSettings()),
                    'password_enabled' => array('integer', (int) $this->isPasswordEnabled()),
                    'password' => array('text', $this->getPassword()),
                    'limit_users_enabled' => array('integer', (int) $this->isLimitUsersEnabled()),
                    'allowedusers' => array('integer', $this->getAllowedUsers()),
                    'alloweduserstimegap' => array('integer', $this->getAllowedUsersTimeGap()),
                    'mailnottype' => array('integer', $this->getMailNotificationType()),
                    'exportsettings' => array('integer', $this->getExportSettings()),
                    'mailnotification' => array('integer', $this->getMailNotification()),
                    'tstamp' => array('integer', time()),
                    'enabled_view_mode' => array('text', $this->getEnabledViewMode()),
                    'template_id' => array('integer', $this->getTemplate()),
                    'obligations_enabled' => array('integer', (int) $this->areObligationsEnabled()),
                    'offer_question_hints' => array('integer', (int) $this->isOfferingQuestionHintsEnabled()),
                    'specific_feedback' => array('integer', $this->getSpecificAnswerFeedback()),
                    'autosave' => array('integer', (int) $this->getAutosave()),
                    'autosave_ival' => array('integer', $this->getAutosaveIval()),
                    'enable_examview' => array('integer', (int) $this->getEnableExamview()),
                    'show_examview_html' => array('integer', (int) $this->getShowExamviewHtml()),
                    'show_examview_pdf' => array('integer', (int) $this->getShowExamviewPdf()),
                    'redirection_mode' => array('integer', $this->getRedirectionMode()),
                    'redirection_url' => array('text', (string) $this->getRedirectionUrl()),
                    'enable_archiving' => array('integer', (int) $this->getEnableArchiving()),
                    'examid_in_test_pass' => array('integer', (int) $this->isShowExamIdInTestPassEnabled()),
                    'sign_submission' => array('integer', (int) $this->getSignSubmission()),
                    'question_set_type' => array('text', $this->getQuestionSetType()),
                    'char_selector_availability' => array('integer', $this->getCharSelectorAvailability()),
                    'char_selector_definition' => array('text', (string) $this->getCharSelectorDefinition()),
                    'skill_service' => array('integer', (int) $this->isSkillServiceEnabled()),
                    'result_tax_filters' => array('text', serialize($this->getResultFilterTaxIds())),
                    'show_grading_status' => array('integer', (int) $this->isShowGradingStatusEnabled()),
                    'show_grading_mark' => array('integer', (int) $this->isShowGradingMarkEnabled()),
                    'follow_qst_answer_fixation' => array('integer', (int) $this->isFollowupQuestionAnswerFixationEnabled()),
                    'inst_fb_answer_fixation' => array('integer', (int) $this->isInstantFeedbackAnswerFixationEnabled()),
                    'force_inst_fb' => array('integer', (int) $this->isForceInstantFeedbackEnabled()),
                    'broken' => array('integer', (int) $this->isTestFinalBroken()),
                    'pass_waiting' => array('text', $this->getPassWaiting())
                    ),
                array(
                        'test_id' => array('integer', $this->getTestId())
                    )
            );
 
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                $logresult = $ilDB->queryF(
                    "SELECT * FROM tst_tests WHERE test_id = %s",
                    array('integer'),
                    array($this->getTestId())
                );
                $newrow = array();
                if ($logresult->numRows() == 1) {
                    $newrow = $ilDB->fetchAssoc($logresult);
                }
                $changed_fields = array();
                foreach ($oldrow as $key => $value) {
                    if (strcmp($oldrow[$key], $newrow[$key]) != 0) {
                        array_push($changed_fields, "$key: " . $oldrow[$key] . " => " . $newrow[$key]);
                    }
                }
                $changes = join(", ", $changed_fields);
                if (count($changed_fields) > 0) {
                    $this->logAction($this->lng->txtlng("assessment", "log_modified_test", ilObjAssessmentFolder::_getLogLanguage()) . " [" . $changes . "]");
                }
            }
            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 = $ilDB->queryF(
                        "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries >= %s AND submitted = %s",
                        array('integer', 'integer', 'integer'),
                        array($this->getTestId(), $this->getNrOfTries(), 0)
                    );
                    while ($row = $ilDB->fetchAssoc($aresult)) {
                        $ilDB->manipulateF(
                            "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                            array('integer', 'timestamp', 'integer'),
                            array(1, date('Y-m-d H:i:s'), $row["active_id"])
                        );
                    }
 
                    // set all finished tests with nr of passes < allowed passes not finished
                    $aresult = $ilDB->queryF(
                        "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries < %s AND submitted = %s",
                        array('integer', 'integer', 'integer'),
                        array($this->getTestId(), $this->getNrOfTries() - 1, 1)
                    );
                    while ($row = $ilDB->fetchAssoc($aresult)) {
                        $ilDB->manipulateF(
                            "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                            array('integer', 'timestamp', 'integer'),
                            array(0, null, $row["active_id"])
                        );
                    }
                } else {
                    // set all finished tests with nr of passes >= allowed passes not finished
                    $aresult = $ilDB->queryF(
                        "SELECT active_id FROM tst_active WHERE test_fi = %s AND submitted = %s",
                        array('integer', 'integer'),
                        array($this->getTestId(), 1)
                    );
                    while ($row = $ilDB->fetchAssoc($aresult)) {
                        $ilDB->manipulateF(
                            "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
                            array('integer', 'timestamp', 'integer'),
                            array(0, null, $row["active_id"])
                        );
                    }
                }
            }
        }
 
        if (!$this->getOldOnlineStatus() && !$this->getOfflineStatus()) {
            global $DIC;
            $ilUser = $DIC['ilUser'];
            $newsItem = new ilNewsItem();
            $newsItem->setContext($this->getId(), 'tst');
            $newsItem->setPriority(NEWS_NOTICE);
            $newsItem->setTitle('new_test_online');
            $newsItem->setContentIsLangVar(true);
            $newsItem->setContent('');
            $newsItem->setUserId($ilUser->getId());
            $newsItem->setVisibility(NEWS_USERS);
            $newsItem->create();
        } elseif ($this->getOldOnlineStatus() && !$this->getOfflineStatus()) {
            ilNewsItem::deleteNewsOfContext($this->getId(), 'tst');
        } elseif (!$this->getOfflineStatus()) {
            $newsId = ilNewsItem::getFirstNewsIdForContext($this->getId(), 'tst');
            if ($newsId > 0) {
                $newsItem = new ilNewsItem($newsId);
                $newsItem->setTitle('new_test_online');
                $newsItem->setContentIsLangVar(true);
                $newsItem->setContent('');
                $newsItem->update();
            }
        }
 
        // moved activation to ilObjectActivation
        if ($this->ref_id) {
            ilObjectActivation::getItem($this->ref_id);
 
            $item = new ilObjectActivation();
            if (!$this->isActivationLimited()) {
                $item->setTimingType(ilObjectActivation::TIMINGS_DEACTIVATED);
            } else {
                $item->setTimingType(ilObjectActivation::TIMINGS_ACTIVATION);
                $item->setTimingStart($this->getActivationStartingTime());
                $item->setTimingEnd($this->getActivationEndingTime());
                $item->toggleVisible($this->getActivationVisibility());
            }
 
            $item->update($this->ref_id);
        }
 
        if (!$properties_only) {
            if ($this->getQuestionSetType() == self::QUESTION_SET_TYPE_FIXED) {
                $this->saveQuestionsToDb();
            }
 
            $this->mark_schema->saveToDb($this->test_id);
        }
    }

References $DIC, $ilDB, $ilUser, ILIAS\LTI\ToolProvider\$key, ilObject\$tree, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilRTE\_replaceMediaObjectImageSrc(), areObligationsEnabled(), cleanupMediaobjectUsage(), ilNewsItem\deleteNewsOfContext(), evalTotalPersons(), getActivationEndingTime(), getActivationStartingTime(), getActivationVisibility(), getAllowedUsers(), getAllowedUsersTimeGap(), getAnonymity(), getAnswerFeedback(), getAnswerFeedbackPoints(), getAuthor(), getAutosave(), getAutosaveIval(), getCharSelectorAvailability(), getCharSelectorDefinition(), getCustomStyle(), getECTSFX(), getECTSOutput(), getEnableArchiving(), getEnabledViewMode(), getEnableExamview(), getEnableProcessingTime(), getEndingTime(), getExportSettings(), getFinalStatement(), ilNewsItem\getFirstNewsIdForContext(), getFixedParticipants(), getForceJS(), getGenericAnswerFeedback(), ilObject\getId(), getInstantFeedbackSolution(), getIntroduction(), ilObjectActivation\getItem(), getKiosk(), getListOfQuestionsSettings(), getMailNotification(), getMailNotificationType(), getNrOfTries(), ilObject\getOfflineStatus(), getOldOnlineStatus(), getPassWaiting(), getPassword(), getProcessingTime(), getQuestionSetType(), getRedirectionMode(), getRedirectionUrl(), getResetProcessingTime(), getResultFilterTaxIds(), getScoreReporting(), getSequenceSettings(), getShowCancel(), getShowExamviewHtml(), getShowExamviewPdf(), getShowFinalStatement(), getShowInfo(), getShowMarker(), getShuffleQuestions(), getSignSubmission(), getSpecificAnswerFeedback(), getStartingTime(), getTemplate(), getTestId(), getTitleOutput(), getUsePreviousAnswers(), isActivationLimited(), isBlockPassesAfterPassedEnabled(), isComplete(), isEndingTimeEnabled(), isFollowupQuestionAnswerFixationEnabled(), isForceInstantFeedbackEnabled(), isInstantFeedbackAnswerFixationEnabled(), isIntroductionEnabled(), isLimitUsersEnabled(), isOfferingQuestionHintsEnabled(), isPasswordEnabled(), isShowExamIdInTestPassEnabled(), isShowGradingMarkEnabled(), isShowGradingStatusEnabled(), isSkillServiceEnabled(), isStartingTimeEnabled(), isTestFinalBroken(), ILIAS\Repository\lng(), logAction(), NEWS_NOTICE, NEWS_USERS, saveQuestionsToDb(), ilObjectActivation\TIMINGS_ACTIVATION, and ilObjectActivation\TIMINGS_DEACTIVATED.

Here is the call graph for this function:

◆ sendAdvancedNotification()

ilObjTest::sendAdvancedNotification ( $active_id )

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

    {
        $mail = new ilTestMailNotification();
        $owner_id = $this->getOwner();
        $usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
 
        $participantList = new ilTestParticipantList($this);
        $participantList->initializeFromDbRows($this->getTestParticipants());
 
        $expFactory = new ilTestExportFactory($this);
        $exportObj = $expFactory->getExporter('results');
        $exportObj->setForcedAccessFilteredParticipantList($participantList);
        $file = $exportObj->exportToExcel($deliver = false, 'active_id', $active_id, $passedonly = false);
        $fd = new ilFileDataMail(ANONYMOUS_USER_ID);
        $fd->copyAttachmentFile($file, "result_" . $active_id . ".xlsx");
        $file_names[] = "result_" . $active_id . ".xlsx";
 
        $mail->sendAdvancedNotification($owner_id, $this->getTitle(), $usr_data, $file_names);
 
        if (count($file_names)) {
            $fd->unlinkFiles($file_names);
            unset($fd);
            @unlink($file);
        }
    }

References _getUserIdFromActiveId(), and ANONYMOUS_USER_ID.

Here is the call graph for this function:

◆ sendSimpleNotification()

ilObjTest::sendSimpleNotification ( $active_id )

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

    {
        $mail = new ilTestMailNotification();
        $owner_id = $this->getOwner();
        $usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
        $mail->sendSimpleNotification($owner_id, $this->getTitle(), $usr_data);
    }

References _getUserIdFromActiveId().

Here is the call graph for this function:

◆ setAccessFilteredParticipantList()

ilObjTest::setAccessFilteredParticipantList ( $accessFilteredParticipantList )

Parameters

ilTestParticipantList $accessFilteredParticipantList

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

                                                                                    : void
    {
        $this->accessFilteredParticipantList = $accessFilteredParticipantList;
    }

◆ setActivationEndingTime()

ilObjTest::setActivationEndingTime ( $ending_time = null )

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

    {
        $this->activation_ending_time = $ending_time;
    }

◆ setActivationLimited()

ilObjTest::setActivationLimited ( $a_value )

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

    {
        $this->activation_limited = (bool) $a_value;
    }

◆ setActivationStartingTime()

ilObjTest::setActivationStartingTime ( $starting_time = null )

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

    {
        $this->activation_starting_time = $starting_time;
    }

◆ setActivationVisibility()

ilObjTest::setActivationVisibility ( $a_value )

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

    {
        $this->activation_visibility = (bool) $a_value;
    }

◆ setAllowedUsers()

ilObjTest::setAllowedUsers ( $a_allowed_users )

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

    {
        $this->allowedUsers = $a_allowed_users;
    }

◆ setAllowedUsersTimeGap()

ilObjTest::setAllowedUsersTimeGap ( $a_allowed_users_time_gap )

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

    {
        $this->allowedUsersTimeGap = $a_allowed_users_time_gap;
    }

◆ setAnonymity()

ilObjTest::setAnonymity ( $a_value = 0 )

Sets the anonymity status of the test.

Parameters

integer $a_value The value for the anonymity status (0 = personalized, 1 = anonymized) @access public

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

    {
        switch ($a_value) {
            case 1:
                $this->anonymity = 1;
                break;
            default:
                $this->anonymity = 0;
                break;
        }
    }

◆ setAnswerFeedback()

ilObjTest::setAnswerFeedback ( $answer_feedback = 0 )

Sets the generic feedback for the test @deprecate Use setGenericAnswerFeedback instead.

Parameters

int | string $answer_feedback If 1, answer specific feedback will be shown after answering a question

See also: $answer_feedback

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

                                                           : void
    {
        switch ($answer_feedback) {
            case 1:
                $this->answer_feedback = 1;
                break;
            default:
                $this->answer_feedback = 0;
                break;
        }
    }

◆ setAnswerFeedbackPoints()

ilObjTest::setAnswerFeedbackPoints ( $answer_feedback_points = 0 )

Sets the answer specific feedback of reached points for the test.

Parameters

int | string $answer_feedback_points If 1, answer specific feedback will show the reached points after answering a question

See also: $answer_feedback_points

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

                                                                        : void
    {
        switch ($answer_feedback_points) {
            case 1:
                $this->answer_feedback_points = 1;
                break;
            default:
                $this->answer_feedback_points = 0;
                break;
        }
    }

◆ setAuthor()

ilObjTest::setAuthor ( string $author = "" )

Sets the authors name of the ilObjTest object.

Parameters

string $author A string containing the name of the test author @access public

See also: $author

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

    {
        $this->author = $author;
    }

◆ setAutosave()

ilObjTest::setAutosave ( $autosave )

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

    {
        $this->autosave = $autosave;
    }

◆ setAutosaveIval()

ilObjTest::setAutosaveIval ( $autosave_ival )

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

    {
        $this->autosave_ival = $autosave_ival;
    }

◆ setBlockPassesAfterPassedEnabled()

ilObjTest::setBlockPassesAfterPassedEnabled ( $blockPassesAfterPassedEnabled )

Parameters

bool $blockPassesAfterPassedEnabled

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

    {
        $this->blockPassesAfterPassedEnabled = $blockPassesAfterPassedEnabled;
    }

◆ setCharSelectorAvailability()

ilObjTest::setCharSelectorAvailability ( $availability )

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

    {
        $this->char_selector_availability = (int) $availability;
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

◆ setCharSelectorDefinition()

ilObjTest::setCharSelectorDefinition ( $definition = '' )

Parameters

string definition of the special character selector

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

    {
        $this->char_selector_definition = $definition;
    }

◆ setClientIP()

ilObjTest::setClientIP	(	$user_id,
		$client_ip
	)

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $affectedRows = $ilDB->manipulateF(
            "UPDATE tst_invited_user SET clientip = %s, tstamp = %s WHERE test_fi=%s and user_fi=%s",
            array('text', 'integer', 'integer', 'integer'),
            array((strlen($client_ip)) ? $client_ip : null, time(), $this->getTestId(), $user_id)
        );
    }

References $DIC, and $ilDB.

◆ setCustomStyle()

ilObjTest::setCustomStyle ( $a_customStyle = null )

Set the custom style.

Parameters

string $a_customStyle The custom style @access public

See also: $_customStyle

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

    {
        $this->_customStyle = $a_customStyle;
    }

◆ setECTSFX()

ilObjTest::setECTSFX ( $ects_fx )

Parameters

float | null $ects_fx

Implements ilEctsGradesEnabled.

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

                                         : void
    {
        $this->ects_fx = (float) str_replace(",", ".", $a_ects_fx);
    }

◆ setECTSGrades()

ilObjTest::setECTSGrades ( array $a_ects_grades )

Implements ilEctsGradesEnabled.

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

                                                       : void
    {
        $this->ects_grades = $a_ects_grades;
    }

◆ setECTSOutput()

ilObjTest::setECTSOutput ( $status )

Parameters

int | bool $status

Implements ilEctsGradesEnabled.

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

                                                 : void
    {
        $this->ects_output = $a_ects_output ? 1 : 0;
    }

◆ setEnableArchiving()

ilObjTest::setEnableArchiving ( $enable_archiving )

Parameters

boolean $enable_archiving

Returns: $this

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

                                                         : ilObjTest
    {
        $this->enable_archiving = $enable_archiving;
        return $this;
    }

◆ setEnabledViewMode()

ilObjTest::setEnabledViewMode ( $mode )

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

    {
        $this->enabled_view_mode = $mode;
    }

◆ setEnableExamview()

ilObjTest::setEnableExamview ( $enable_examview )

Parameters

boolean $enable_examview

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

                                                       : void
    {
        $this->enable_examview = $enable_examview;
    }

◆ setEnableProcessingTime()

ilObjTest::setEnableProcessingTime ( $enable = 0 )

Sets the processing time enabled or disabled.

Parameters

integer $enable 0 to disable the processing time, 1 to enable the processing time @access public

See also: $processing_time

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

    {
        if ($enable) {
            $this->enable_processing_time = "1";
        } else {
            $this->enable_processing_time = "0";
        }
    }

◆ setEndingTime()

ilObjTest::setEndingTime ( $ending_time = null )

Sets the ending time in database timestamp format for the test.

Parameters

string $ending_time The ending time for the test. Empty string for no ending time. @access public

See also: $ending_time

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

    {
        $this->ending_time = $ending_time;
    }

◆ setEndingTimeEnabled()

ilObjTest::setEndingTimeEnabled ( $ending_time_enabled )

Parameters

boolean $ending_time_enabled

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

    {
        $this->ending_time_enabled = $ending_time_enabled;
    }

◆ setExportSettings()

ilObjTest::setExportSettings ( $a_settings )

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

    {
        if ($a_settings) {
            $this->exportsettings = $a_settings;
        } else {
            $this->exportsettings = 0;
        }
    }

◆ setExportSettingsSingleChoiceShort()

ilObjTest::setExportSettingsSingleChoiceShort ( $a_settings )

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

    {
        if ($a_settings) {
            $this->exportsettings = $this->exportsettings | 1;
        } else {
            if ($this->getExportSettingsSingleChoiceShort()) {
                $this->exportsettings = $this->exportsettings ^ 1;
            }
        }
    }

◆ setFinalStatement()

ilObjTest::setFinalStatement ( string $a_statement )

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

                                                          : void
    {
        $this->_finalstatement = $a_statement;
    }

◆ setFixedParticipants()

ilObjTest::setFixedParticipants ( $a_value = 1 )

Sets the fixed participants status.

Parameters

integer $a_value The value for the fixed participants status (0 = don't allow, 1 = allow) @access public

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

    {
        switch ($a_value) {
            case 1:
                $this->fixed_participants = 1;
                break;
            default:
                $this->fixed_participants = 0;
                break;
        }
    }

◆ setFollowupQuestionAnswerFixationEnabled()

ilObjTest::setFollowupQuestionAnswerFixationEnabled ( $followupQuestionAnswerFixationEnabled )

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

    {
        $this->followupQuestionAnswerFixationEnabled = $followupQuestionAnswerFixationEnabled;
    }

◆ setForceInstantFeedbackEnabled()

ilObjTest::setForceInstantFeedbackEnabled ( $forceInstantFeedbackEnabled )

Parameters

boolean $forceInstantFeedbackEnabled

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

                                                                                : void
    {
        $this->forceInstantFeedbackEnabled = $forceInstantFeedbackEnabled;
    }

◆ setForceJS()

ilObjTest::setForceJS ( $a_js = 1 )

Set whether JavaScript should be forced for tests.

Parameters

integer $a_js 1 to force JavaScript, 0 otherwise @access public

See also: $_forcejs

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

    {
        $this->_forcejs = ($a_js) ? 1 : 0;
    }

◆ setGenericAnswerFeedback()

ilObjTest::setGenericAnswerFeedback ( int $generic_answer_feedback = 0 )

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

                                                                              : void
    {
        switch ($generic_answer_feedback) {
            case 1:
                $this->answer_feedback = 1;
                break;
            default:
                $this->answer_feedback = 0;
                break;
        }
    }

◆ setInstantFeedbackAnswerFixationEnabled()

ilObjTest::setInstantFeedbackAnswerFixationEnabled ( $instantFeedbackAnswerFixationEnabled )

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

    {
        $this->instantFeedbackAnswerFixationEnabled = $instantFeedbackAnswerFixationEnabled;
    }

◆ setInstantFeedbackOptionsByArray()

ilObjTest::setInstantFeedbackOptionsByArray ( $options )

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

    {
        if (is_array($options)) {
            $this->setGenericAnswerFeedback(in_array('instant_feedback_generic', $options) ? 1 : 0);
            $this->setSpecificAnswerFeedback(in_array('instant_feedback_specific', $options) ? 1 : 0);
            $this->setAnswerFeedbackPoints(in_array('instant_feedback_points', $options) ? 1 : 0);
            $this->setInstantFeedbackSolution(in_array('instant_feedback_solution', $options) ? 1 : 0);
        } else {
            $this->setGenericAnswerFeedback(0);
            $this->setSpecificAnswerFeedback(0);
            $this->setAnswerFeedbackPoints(0);
            $this->setInstantFeedbackSolution(0);
        }
    }

◆ setInstantFeedbackSolution()

ilObjTest::setInstantFeedbackSolution ( $instant_feedback = 0 )

Sets the instant feedback for the solution.

Parameters

int | string $instant_feedback If 1, the solution will be shown after answering a question

See also: $instant_verification

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

                                                                     : void
    {
        switch ($instant_feedback) {
            case 1:
                $this->instant_verification = 1;
                break;
            default:
                $this->instant_verification = 0;
                break;
        }
    }

◆ setIntroduction()

ilObjTest::setIntroduction ( string $introduction )

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

                                                         : void
    {
        $this->introduction = $this->getHtmlQuestionContentPurifier()->purify($introduction);
    }

◆ setIntroductionEnabled()

ilObjTest::setIntroductionEnabled ( $introductionEnabled )

Parameters

bool | string $introductionEnabled

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

                                                                : void
    {
        $this->introductionEnabled = $introductionEnabled;
    }

◆ setKiosk()

ilObjTest::setKiosk ( $kiosk = 0 )

Sets the kiosk mode for the test.

Parameters

integer $kiosk The value for the kiosk mode. @access public

See also: $_kiosk

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

    {
        $this->_kiosk = $kiosk;
    }

◆ setKioskMode()

ilObjTest::setKioskMode ( $a_kiosk = false )

Sets the kiosk mode for the test.

Parameters

boolean $kiosk The value for the kiosk mode @access public

See also: $_kiosk

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

    {
        if ($a_kiosk) {
            $this->_kiosk = $this->_kiosk | 1;
        } else {
            if ($this->getKioskMode()) {
                $this->_kiosk = $this->_kiosk ^ 1;
            }
        }
    }

◆ setLimitUsersEnabled()

ilObjTest::setLimitUsersEnabled ( bool $limitUsersEnabled )

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

                                                                 : void
    {
        $this->limitUsersEnabled = $limitUsersEnabled;
    }

◆ setListOfQuestions()

ilObjTest::setListOfQuestions ( $a_value = true )

Sets if the the list of questions should be presented to the user or not.

Parameters

boolean $a_value TRUE if the list of questions should be presented, FALSE otherwise @access public

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

    {
        if ($a_value) {
            $this->show_summary = 1;
        } else {
            $this->show_summary = 0;
        }
    }

◆ setListOfQuestionsDescription()

ilObjTest::setListOfQuestionsDescription ( $a_value = true )

Sets the show_summary attribute to TRUE if the list of questions should be presented with the question descriptions.

Parameters

boolean $a_value TRUE if the list of questions should be shown with question descriptions, FALSE otherwise @access public

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

    {
        if ($a_value && $this->getListOfQuestions()) {
            $this->show_summary = $this->show_summary | 8;
        }
        if (!$a_value && $this->getListOfQuestions()) {
            if ($this->getListOfQuestionsDescription()) {
                $this->show_summary = $this->show_summary ^ 8;
            }
        }
    }

◆ setListOfQuestionsEnd()

ilObjTest::setListOfQuestionsEnd ( $a_value = true )

Sets if the the list of questions as the end page of the test.

Parameters

boolean $a_value TRUE if the list of questions should be the end page, FALSE otherwise @access public

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

    {
        if ($a_value && $this->getListOfQuestions()) {
            $this->show_summary = $this->show_summary | 4;
        }
        if (!$a_value && $this->getListOfQuestions()) {
            if ($this->getListOfQuestionsEnd()) {
                $this->show_summary = $this->show_summary ^ 4;
            }
        }
    }

◆ setListOfQuestionsSettings()

ilObjTest::setListOfQuestionsSettings ( $a_value = 0 )

Sets 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.

Parameters

integer $a_value 0, 1, 3, 5 or 7 @access public

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

    {
        $this->show_summary = $a_value;
    }

◆ setListOfQuestionsStart()

ilObjTest::setListOfQuestionsStart ( $a_value = true )

Sets if the the list of questions as the start page of the test.

Parameters

boolean $a_value TRUE if the list of questions should be the start page, FALSE otherwise @access public

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

    {
        if ($a_value && $this->getListOfQuestions()) {
            $this->show_summary = $this->show_summary | 2;
        }
        if (!$a_value && $this->getListOfQuestions()) {
            if ($this->getListOfQuestionsStart()) {
                $this->show_summary = $this->show_summary ^ 2;
            }
        }
    }

◆ setMailNotification()

ilObjTest::setMailNotification ( $a_notification )

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

    {
        $this->mailnotification = $a_notification;
    }

◆ setMailNotificationType()

ilObjTest::setMailNotificationType ( $a_type )

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

    {
        if ($a_type == 1) {
            $this->mailnottype = 1;
        } else {
            $this->mailnottype = 0;
        }
    }

◆ setNrOfTries()

ilObjTest::setNrOfTries ( $nr_of_tries = 0 )

Sets the nr of tries for the test.

Parameters

integer $nr_of_tries The maximum number of tries for the test. 0 for infinite tries. @access public

See also: $nr_of_tries

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

    {
        $this->nr_of_tries = $nr_of_tries;
    }

◆ setObligationsEnabled()

ilObjTest::setObligationsEnabled ( $obligationsEnabled = true )

sets obligations enabled/disabled

Parameters

boolean $obligationsEnabled

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

    {
        $this->obligationsEnabled = (bool) $obligationsEnabled;
    }

◆ setOfferingQuestionHintsEnabled()

ilObjTest::setOfferingQuestionHintsEnabled ( $offeringQuestionHintsEnabled )

sets offering question hints enabled/disabled

Parameters

boolean $offeringQuestionHintsEnabled

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

    {
        $this->offeringQuestionHintsEnabled = (bool) $offeringQuestionHintsEnabled;
    }

◆ setOldOnlineStatus()

ilObjTest::setOldOnlineStatus ( $oldOnlineStatus )

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

                                                        : void
    {
        $this->oldOnlineStatus = $oldOnlineStatus;
    }

◆ setOnline()

ilObjTest::setOnline ( $a_online = true )

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

    {
        $this->online = (bool) $a_online;
    }

Referenced by ilTestImporter\importQuestionSkillAssignments().

Here is the caller graph for this function:

◆ setPassWaiting()

ilObjTest::setPassWaiting ( $pass_waiting )

Parameters

string $pass_waiting mm:ddd:hh:ii:ss

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

    {
        $this->pass_waiting = $pass_waiting;
    }

◆ setPassword()

ilObjTest::setPassword ( $a_password = null )

Sets the password for test access.

Parameters

string $a_password The password for test access @access public

See also: $password

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

                                                   : void
    {
        $this->password = $a_password;
    }

◆ setPasswordEnabled()

ilObjTest::setPasswordEnabled ( $passwordEnabled )

Parameters

boolean $passwordEnabled

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

    {
        $this->passwordEnabled = $passwordEnabled;
    }

◆ setPostponingEnabled()

ilObjTest::setPostponingEnabled ( $postponingEnabled )

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

                                                            : void
    {
        $this->setSequenceSettings((int) $postponingEnabled);
    }

◆ setProcessingTime()

ilObjTest::setProcessingTime ( $processing_time = "00:00:00" )

Sets the processing time for the test.

Parameters

string $processing_time The maximum processing time for the test given in hh:mm:ss @access public

See also: $processing_time

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

                                                            :00:00")
    {
        $this->processing_time = $processing_time;
    }

◆ setProcessingTimeByMinutes()

ilObjTest::setProcessingTimeByMinutes ( $minutes )

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

    {
        $this->processing_time = sprintf("%02d:%02d:00", floor($minutes / 60), $minutes % 60);
    }

◆ setQuestionOrderAndObligations()

ilObjTest::setQuestionOrderAndObligations	(	$orders,
		$obligations
	)

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        asort($orders);
 
        $i = 0;
 
        foreach ($orders as $id => $position) {
            $i++;
 
            $obligatory = (
                isset($obligations[$id]) && $obligations[$id] ? 1 : 0
            );
 
            $query = "
                                UPDATE          tst_test_question
                                SET                     sequence = %s,
                                                        obligatory = %s
                                WHERE           question_fi = %s
                        ";
 
            $ilDB->manipulateF(
                $query,
                array('integer', 'integer', 'integer'),
                array($i, $obligatory, $id)
            );
        }
 
        $this->loadQuestions();
    }

References $DIC, $i, $id, $ilDB, and $query.

◆ setQuestionSetSolved()

ilObjTest::setQuestionSetSolved	(	$value,
		$question_id,
		$user_id
	)

sets question solved state to value for given user_id

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $active_id = $this->getActiveIdOfUser($user_id);
        $ilDB->manipulateF(
            "DELETE FROM tst_qst_solved WHERE active_fi = %s AND question_fi = %s",
            array('integer', 'integer'),
            array($active_id, $question_id)
        );
        $ilDB->manipulateF(
            "INSERT INTO tst_qst_solved (solved, question_fi, active_fi) VALUES (%s, %s, %s)",
            array('integer', 'integer', 'integer'),
            array($value, $question_id, $active_id)
        );
    }

References $DIC, and $ilDB.

◆ setQuestionSetType()

ilObjTest::setQuestionSetType ( $questionSetType )

setter for question set type

Parameters

string $questionSetType

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

    {
        $this->questionSetType = $questionSetType;
    }

◆ setRedirectionMode()

ilObjTest::setRedirectionMode ( $redirection_mode = 0 )

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

    {
        $this->redirection_mode = $redirection_mode;
    }

◆ setRedirectionUrl()

ilObjTest::setRedirectionUrl ( $redirection_url = null )

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

    {
        $this->redirection_url = $redirection_url;
    }

◆ setReportingDate()

ilObjTest::setReportingDate ( $reporting_date )

Sets the reporting date of the ilObjTest object when the score reporting is available.

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

                                                     : void
    {
        if (!$reporting_date) {
            $this->reporting_date = '';
            $this->setECTSOutput(false);
        } else {
            $this->reporting_date = $reporting_date;
        }
    }

◆ setResetProcessingTime()

ilObjTest::setResetProcessingTime ( $reset = 0 )

Sets wheather the processing time should be reset or not.

Parameters

integer $reset 1 to reset the processing time, 0 otherwise @access public

See also: $processing_time

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

    {
        if ($reset) {
            $this->reset_processing_time = 1;
        } else {
            $this->reset_processing_time = 0;
        }
    }

◆ setSequenceSettings()

ilObjTest::setSequenceSettings ( $sequence_settings = 0 )

SEQUENCE SETTING = POSTPONING ENABLED !!

Parameters

int | string $sequence_settings The POSTPONING ENABLED status

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

                                                               : void
    {
        $this->sequence_settings = $sequence_settings;
    }

◆ setShowCancel()

ilObjTest::setShowCancel ( $a_value = 1 )

Sets the cancel test button status.

Parameters

integer $a_value The value for the cancel test status (0 = don't show, 1 = show) @access public

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

    {
        switch ($a_value) {
            case 1:
                $this->show_cancel = 1;
                break;
            default:
                $this->show_cancel = 0;
                break;
        }
    }

◆ setShowExamIdInTestPassEnabled()

ilObjTest::setShowExamIdInTestPassEnabled ( $show_exam_id_in_test_pass_enabled )

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

    {
        $this->show_exam_id_in_test_pass_enabled = $show_exam_id_in_test_pass_enabled;
    }

◆ setShowExamviewHtml()

ilObjTest::setShowExamviewHtml ( $show_examview_html )

Parameters

boolean $show_examview_html

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

                                                            : void
    {
        $this->show_examview_html = $show_examview_html;
    }

◆ setShowExamviewPdf()

ilObjTest::setShowExamviewPdf ( $show_examview_pdf )

Parameters

boolean $show_examview_pdf

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

                                                          : void
    {
        $this->show_examview_pdf = $show_examview_pdf;
    }

◆ setShowFinalStatement()

ilObjTest::setShowFinalStatement ( $show = 0 )

Sets whether the final statement should be shown or not.

Parameters

integer $show 1 if TRUE or 0 if FALSE @access public

See also: $_finalstatement

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

    {
        $this->_showfinalstatement = ($show) ? 1 : 0;
    }

◆ setShowGradingMarkEnabled()

ilObjTest::setShowGradingMarkEnabled ( $showGradingMarkEnabled )

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

    {
        $this->showGradingMarkEnabled = $showGradingMarkEnabled;
    }

◆ setShowGradingStatusEnabled()

ilObjTest::setShowGradingStatusEnabled ( $showGradingStatusEnabled )

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

    {
        $this->showGradingStatusEnabled = $showGradingStatusEnabled;
    }

◆ setShowInfo()

ilObjTest::setShowInfo ( $a_info = 1 )

Set whether the complete information page is shown or the required data only.

Parameters

integer $a_info 1 for the complete information, 0 otherwise @access public

See also: $_showinfo

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

    {
        $this->_showinfo = ($a_info) ? 1 : 0;
    }

◆ setShowKioskModeParticipant()

ilObjTest::setShowKioskModeParticipant ( $a_participant = false )

Set to true, if the participant's name should be shown in kiosk mode.

Parameters

boolean $a_title TRUE if the participant's name should be shown in kiosk mode, FALSE otherwise @access public

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

    {
        if ($a_participant) {
            $this->_kiosk = $this->_kiosk | 4;
        } else {
            if ($this->getShowKioskModeParticipant()) {
                $this->_kiosk = $this->_kiosk ^ 4;
            }
        }
    }

◆ setShowKioskModeTitle()

ilObjTest::setShowKioskModeTitle ( $a_title = false )

Set to true, if the full test title should be shown in kiosk mode.

Parameters

boolean $a_title TRUE if the test title should be shown in kiosk mode, FALSE otherwise @access public

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

    {
        if ($a_title) {
            $this->_kiosk = $this->_kiosk | 2;
        } else {
            if ($this->getShowKioskModeTitle()) {
                $this->_kiosk = $this->_kiosk ^ 2;
            }
        }
    }

◆ setShowMarker()

ilObjTest::setShowMarker ( $a_value = 1 )

Sets the marker button status.

Parameters

integer $a_value The value for the marker status (0 = don't show, 1 = show) @access public

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

    {
        switch ($a_value) {
            case 1:
                $this->show_marker = 1;
                break;
            default:
                $this->show_marker = 0;
                break;
        }
    }

◆ setShowSolutionPrintview()

ilObjTest::setShowSolutionPrintview ( int $a_printview = 1 )

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

Parameters

boolean $a_details TRUE if the solution printview should be presented, FALSE otherwise @access public

Deprecated:

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

                                                                  : void
    {
        $this->getScoreSettings()->getResultDetailsSettings()->withShowSolutionPrintview($a_printview === 1);
    }

◆ setShuffleQuestions()

ilObjTest::setShuffleQuestions ( $a_shuffle )

Sets the status of the shuffle_questions variable.

Parameters

boolean $a_shuffle 0 if the test questions are not shuffled, 1 if the test questions are shuffled @access public

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

    {
        $this->shuffle_questions = ($a_shuffle) ? 1 : 0;
    }

◆ setSignSubmission()

ilObjTest::setSignSubmission ( $sign_submission )

Parameters

boolean $sign_submission

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

    {
        $this->sign_submission = $sign_submission;
    }

◆ setSkillServiceEnabled()

ilObjTest::setSkillServiceEnabled ( $skillServiceEnabled )

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

    {
        $this->skillServiceEnabled = $skillServiceEnabled;
    }

◆ setSpecificAnswerFeedback()

ilObjTest::setSpecificAnswerFeedback ( $specific_answer_feedback )

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

    {
        switch ($specific_answer_feedback) {
            case 1:
                $this->specific_answer_feedback = 1;
                break;
            default:
                $this->specific_answer_feedback = 0;
                break;
        }
    }

◆ setStartingTime()

ilObjTest::setStartingTime ( $starting_time = null )

Sets the starting time in database timestamp format for the test.

Parameters

string $starting_time The starting time for the test. Empty string for no starting time. @access public

See also: $starting_time

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

    {
        $this->starting_time = $starting_time;
    }

◆ setStartingTimeEnabled()

ilObjTest::setStartingTimeEnabled ( $starting_time_enabled )

Parameters

boolean $starting_time_enabled

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

    {
        $this->starting_time_enabled = $starting_time_enabled;
    }

◆ setTemplate()

ilObjTest::setTemplate ( $template_id )

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

    {
        $this->template_id = (int) $template_id;
    }

References ILIAS\Repository\int().

Referenced by ilLOEditorGUI\applySettingsTemplate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTestFinalBroken()

ilObjTest::setTestFinalBroken ( $testFinalBroken )

Parameters

boolean $testFinalBroken

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

    {
        $this->testFinalBroken = $testFinalBroken;
    }

◆ setTestId()

ilObjTest::setTestId ( $a_id )

Sets the test ID.

Parameters

integer $a_id Test ID

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

    {
        $this->test_id = $a_id;
    }

◆ setTitleOutput()

ilObjTest::setTitleOutput ( $title_output = 0 )

Sets the status of the title output.

Parameters

integer $title_output 0 for full title, 1 for title without points, 2 for no title @access public

See also: $title_output

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

    {
        switch ($title_output) {
            case 1:
                $this->title_output = 1;
                break;
            case 2:
                $this->title_output = 2;
                break;
            default:
                $this->title_output = 0;
                break;
        }
    }

◆ setTmpCopyWizardCopyId()

ilObjTest::setTmpCopyWizardCopyId ( int $tmpCopyWizardCopyId )

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

                                                                    : void
    {
        $this->tmpCopyWizardCopyId = $tmpCopyWizardCopyId;
    }

References $tmpCopyWizardCopyId.

◆ setUsePreviousAnswers()

ilObjTest::setUsePreviousAnswers ( $use_previous_answers = 1 )

Sets the status of the visibility of previous learner answers.

Parameters

integer $use_previous_answers 1 if the previous answers should be shown @access public

See also: $use_previous_answers

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

    {
        if ($use_previous_answers) {
            $this->use_previous_answers = 1;
        } else {
            $this->use_previous_answers = 0;
        }
    }

◆ 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 @access public

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

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

◆ 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 @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $next_id = $ilDB->nextId('tst_times');
        $affectedRows = $ilDB->manipulateF(
            "INSERT INTO tst_times (times_id, active_fi, started, finished, pass, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
            array('integer', 'integer', 'timestamp', 'timestamp', 'integer', 'integer'),
            array($next_id, $active_id, date("Y-m-d H:i:s"), date("Y-m-d H:i:s"), $pass, time())
        );
        return $next_id;
    }

References $DIC, and $ilDB.

◆ toXML()

ilObjTest::toXML ( )

Returns a QTI xml representation of the test.

Returns: string The QTI xml representation of the test

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

                           : string
    {
        $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 = array(
            "ident" => "il_" . IL_INST_ID . "_tst_" . $this->getTestId(),
            "title" => $this->getTitle()
        );
        $a_xml_writer->xmlStartTag("assessment", $attrs);
        // add qti comment
        $a_xml_writer->xmlElement("qticomment", null, $this->getDescription());
 
        // add qti duration
        if ($this->enable_processing_time) {
            preg_match("/(\d+):(\d+):(\d+)/", $this->processing_time, $matches);
            $a_xml_writer->xmlElement("duration", null, sprintf("P0Y0M0DT%dH%dM%dS", $matches[1], $matches[2], $matches[3]));
        }
 
        // add the rest of the preferences in qtimetadata tags, because there is no correspondent definition in QTI
        $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");
 
        // anonymity
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "anonymity");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getAnonymity()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // question set type (fixed, random, dynamic, ...)
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "question_set_type");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getQuestionSetType());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // sequence settings
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "sequence_settings");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getSequenceSettings());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // author
        $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");
 
        // reset processing time
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "reset_processing_time");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getResetProcessingTime());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // count system
        $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");
 
        // multiple choice scoring
        $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");
 
        // multiple choice scoring
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "password");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getPassword());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // allowed users
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "allowedUsers");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getAllowedUsers());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // allowed users time gap
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "allowedUsersTimeGap");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getAllowedUsersTimeGap());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // pass scoring
        $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');
 
        // score reporting date
        if ($this->getReportingDate()) {
            $a_xml_writer->xmlStartTag("qtimetadatafield");
            $a_xml_writer->xmlElement("fieldlabel", null, "reporting_date");
            preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->reporting_date, $matches);
            $a_xml_writer->xmlElement("fieldentry", null, sprintf("P%dY%dM%dDT%dH%dM%dS", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]));
            $a_xml_writer->xmlEndTag("qtimetadatafield");
        }
        // number of tries
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "nr_of_tries");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getNrOfTries()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // number of tries
        $a_xml_writer->xmlStartTag('qtimetadatafield');
        $a_xml_writer->xmlElement('fieldlabel', null, 'block_after_passed');
        $a_xml_writer->xmlElement('fieldentry', null, (int) $this->isBlockPassesAfterPassedEnabled());
        $a_xml_writer->xmlEndTag('qtimetadatafield');
 
        // pass_waiting
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "pass_waiting");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getPassWaiting());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // kiosk
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "kiosk");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getKiosk()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
 
        //redirection_mode
        $a_xml_writer->xmlStartTag('qtimetadatafield');
        $a_xml_writer->xmlElement("fieldlabel", null, "redirection_mode");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getRedirectionMode());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //redirection_url
        $a_xml_writer->xmlStartTag('qtimetadatafield');
        $a_xml_writer->xmlElement("fieldlabel", null, "redirection_url");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getRedirectionUrl());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // use previous answers
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "use_previous_answers");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getUsePreviousAnswers());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // hide title points
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "title_output");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getTitleOutput()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // results presentation
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "results_presentation");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getResultsPresentation()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // examid in test pass
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_pass");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->isShowExamIdInTestPassEnabled()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // examid in kiosk
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_res");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->isShowExamIdInTestResultsEnabled()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // solution details
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "show_summary");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getListOfQuestionsSettings()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // solution details
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "score_reporting");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getScoreReporting()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "solution_details");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getShowSolutionDetails());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "print_bs_with_res");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getShowSolutionDetails() ? (int) $this->isBestSolutionPrintedWithResult() : 0);
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // solution details
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "instant_verification");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getInstantFeedbackSolution()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // answer specific feedback
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getAnswerFeedback()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // answer specific feedback of reached points
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback_points");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getAnswerFeedbackPoints()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // followup question previous answer freezing
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "follow_qst_answer_fixation");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isFollowupQuestionAnswerFixationEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // instant response answer freezing
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isInstantFeedbackAnswerFixationEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // instant response forced
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "force_instant_feedback");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isForceInstantFeedbackEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
 
        // highscore
        $highscore_metadata = array(
            'highscore_enabled' => array('value' => $this->getHighscoreEnabled()),
            'highscore_anon' => array('value' => $this->getHighscoreAnon()),
            'highscore_achieved_ts' => array('value' => $this->getHighscoreAchievedTS()),
            'highscore_score' => array('value' => $this->getHighscoreScore()),
            'highscore_percentage' => array('value' => $this->getHighscorePercentage()),
            'highscore_hints' => array('value' => $this->getHighscoreHints()),
            'highscore_wtime' => array('value' => $this->getHighscoreWTime()),
            'highscore_own_table' => array('value' => $this->getHighscoreOwnTable()),
            'highscore_top_table' => array('value' => $this->getHighscoreTopTable()),
            'highscore_top_num' => array('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");
        }
 
        // show cancel
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "show_cancel");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getShowCancel()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show marker
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "show_marker");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getShowMarker()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // fixed participants
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "fixed_participants");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getFixedParticipants()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show final statement
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "showfinalstatement");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (($this->getShowFinalStatement()) ? "1" : "0")));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show introduction only
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "showinfo");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (($this->getShowInfo()) ? "1" : "0")));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // mail notification
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "mailnotification");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getMailNotification());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // mail notification type
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "mailnottype");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getMailNotificationType());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // export settings
        $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");
 
        // force JavaScript
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "forcejs");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", (($this->getForceJS()) ? "1" : "0")));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // custom style
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "customstyle");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getCustomStyle());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // shuffle questions
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "shuffle_questions");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getShuffleQuestions()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // processing time
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "processing_time");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getProcessingTime());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // enable_examview
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "enable_examview");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getEnableExamview());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show_examview_html
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "show_examview_html");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getShowExamviewHtml());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show_examview_pdf
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "show_examview_pdf");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getShowExamviewPdf());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // enable_archiving
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "enable_archiving");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getEnableArchiving());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // sign_submission
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "sign_submission");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getSignSubmission());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // char_selector_availability
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "char_selector_availability");
        $a_xml_writer->xmlElement("fieldentry", null, sprintf("%d", $this->getCharSelectorAvailability()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // char_selector_definition
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "char_selector_definition");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getCharSelectorDefinition());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // skill_service
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "skill_service");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isSkillServiceEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // result_tax_filters
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "result_tax_filters");
        $a_xml_writer->xmlElement("fieldentry", null, serialize($this->getResultFilterTaxIds()));
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // show_grading_status
        $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");
 
        // show_grading_mark
        $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");
 
 
        // starting time
        if ($this->getStartingTime()) {
            $a_xml_writer->xmlStartTag("qtimetadatafield");
            $a_xml_writer->xmlElement("fieldlabel", null, "starting_time");
            $backward_compatibility_format = $this->buildIso8601PeriodFromUnixtimeForExportCompatibility($this->starting_time);
            $a_xml_writer->xmlElement("fieldentry", null, $backward_compatibility_format);
            $a_xml_writer->xmlEndTag("qtimetadatafield");
        }
        // ending time
        if ($this->getEndingTime()) {
            $a_xml_writer->xmlStartTag("qtimetadatafield");
            $a_xml_writer->xmlElement("fieldlabel", null, "ending_time");
            $backward_compatibility_format = $this->buildIso8601PeriodFromUnixtimeForExportCompatibility($this->ending_time);
            $a_xml_writer->xmlElement("fieldentry", null, $backward_compatibility_format);
            $a_xml_writer->xmlEndTag("qtimetadatafield");
        }
 
 
        //activation_limited
        $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");
 
        //activation_start_time
        $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");
 
        //activation_end_time
        $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");
 
        //activation_visibility
        $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");
 
        // autosave
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "autosave");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getAutosave());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        // autosave_ival
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "autosave_ival");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getAutosaveIval());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //offer_question_hints
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "offer_question_hints");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isOfferingQuestionHintsEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //instant_feedback_specific
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_specific");
        $a_xml_writer->xmlElement("fieldentry", null, $this->getSpecificAnswerFeedback());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //instant_feedback_answer_fixation
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->isInstantFeedbackAnswerFixationEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //obligations_enabled
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "obligations_enabled");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->areObligationsEnabled());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        //enable_processing_time
        $a_xml_writer->xmlStartTag("qtimetadatafield");
        $a_xml_writer->xmlElement("fieldlabel", null, "enable_processing_time");
        $a_xml_writer->xmlElement("fieldentry", null, (int) $this->getEnableProcessingTime());
        $a_xml_writer->xmlEndTag("qtimetadatafield");
 
        foreach ($this->mark_schema->mark_steps as $index => $mark) {
            // mark steps
            $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");
 
        // add qti objectives
        $a_xml_writer->xmlStartTag("objectives");
        $this->addQTIMaterial($a_xml_writer, $this->getIntroduction());
        $a_xml_writer->xmlEndTag("objectives");
 
        // add qti assessmentcontrol
        if ($this->getInstantFeedbackSolution() == 1) {
            $attrs = array(
                "solutionswitch" => "Yes"
            );
        } else {
            $attrs = null;
        }
        $a_xml_writer->xmlElement("assessmentcontrol", $attrs, null);
 
        if (strlen($this->getFinalStatement())) {
            // add qti presentation_material
            $a_xml_writer->xmlStartTag("presentation_material");
            $a_xml_writer->xmlStartTag("flow_mat");
            $this->addQTIMaterial($a_xml_writer, $this->getFinalStatement());
            $a_xml_writer->xmlEndTag("flow_mat");
            $a_xml_writer->xmlEndTag("presentation_material");
        }
 
        $attrs = array(
            "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;
    }

References $data, $index, $xml, IL_INST_ID, and ILIAS_VERSION.

◆ update()

ilObjTest::update ( )

Reimplemented from ilObject.

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

                            : bool
    {
        if (!parent::update()) {
            return false;
        }
 
        // put here object specific stuff
        $this->updateMetaData();
        return true;
    }

References ilObject\updateMetaData().

Here is the call 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 @access public

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $affectedRows = $ilDB->manipulateF(
            "UPDATE tst_times SET finished = %s, tstamp = %s WHERE times_id = %s",
            array('timestamp', 'integer', 'integer'),
            array(date('Y-m-d H:i:s'), time(), $times_id)
        );
    }

References $DIC, and $ilDB.

◆ 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 @access public

Deprecated:: : use ilTestParticipantData instead

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

                                                                                                                   : 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;
            }
        }
    }

References ilObjUser\_lookupName(), and ILIAS\Repository\lng().

Here is the call graph for this function:

Field Documentation

◆ $_customStyle

ilObjTest::$_customStyle

ilObjTest::$allowedUsersTimeGap

protected

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

◆ $anonymity

int ilObjTest::$anonymity

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

◆ $answer_feedback

int ilObjTest::$answer_feedback

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

◆ $answer_feedback_points

int ilObjTest::$answer_feedback_points

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

ilDBInterface ilObjTest::$db

protected

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

◆ $ects_fx

float ilObjTest::$ects_fx = null

protected

Contains the percentage of maximum points a failed user needs to get the FX ECTS grade.

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

◆ $ects_grades

array ilObjTest::$ects_grades = array()

protected

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

◆ $ects_output

ilObjTest::$ects_output = false

protected

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

◆ $enable_archiving

bool ilObjTest::$enable_archiving

protected

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

◆ $enable_examview

bool ilObjTest::$enable_examview

protected

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

◆ $enable_processing_time

ilObjTest::$enable_processing_time

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

◆ $enabled_view_mode

ilObjTest::$enabled_view_mode

protected

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

◆ $ending_time

string ilObjTest::$ending_time

protected

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

◆ $ending_time_enabled

ilObjTest::$ending_time_enabled

protected

bool?

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

◆ $evaluation_data

◆ $introductionEnabled

bool ilObjTest::$introductionEnabled

protected

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

◆ $invitation

int ilObjTest::$invitation = INVITATION_OFF

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

◆ $isSkillManagementGloballyActivated

ilObjTest::$isSkillManagementGloballyActivated = null

staticprivate

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

◆ $limitUsersEnabled

ilObjTest::$limitUsersEnabled

int ilObjTest::$nr_of_tries

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

◆ $obligationsEnabled

bool ilObjTest::$obligationsEnabled = null

private

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

◆ $offeringQuestionHintsEnabled

bool ilObjTest::$offeringQuestionHintsEnabled = null

private

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

◆ $oldOnlineStatus

ilObjTest::$oldOnlineStatus = null

protected

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

◆ $online

bool ilObjTest::$online

private

Definition at line 50 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 225 of file class.ilObjTest.php.

◆ $pass_waiting

ilObjTest::$pass_waiting = "00:000:00:00:00"

protected

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

◆ $passDeletionAllowed

ilObjTest::$passDeletionAllowed = null

private

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

◆ $password

string ilObjTest::$password

protected

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

◆ $passwordEnabled

ilObjTest::$passwordEnabled

protected

bool?

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

◆ $print_best_solution_with_result

bool ilObjTest::$print_best_solution_with_result = true

protected

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

◆ $processing_time

ilObjTest::$processing_time

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

◆ $questions

array ilObjTest::$questions

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

◆ $questionSetType

string ilObjTest::$questionSetType = self::QUESTION_SET_TYPE_FIXED

private

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

◆ $redirection_mode

int ilObjTest::$redirection_mode = 0

private

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

◆ $redirection_url

string ilObjTest::$redirection_url = null

private

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

◆ $refinery

Refinery ilObjTest::$refinery

private

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

◆ $reporting_date

ilObjTest::$reporting_date

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

◆ $reset_processing_time

int ilObjTest::$reset_processing_time

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

◆ $resultFilterTaxIds

array ilObjTest::$resultFilterTaxIds = array()

private

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

◆ $score_settings

ilObjTestScoreSettings ilObjTest::$score_settings = null

protected

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

◆ $score_settings_repo

ScoreSettingsRepository ilObjTest::$score_settings_repo = null

protected

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

◆ $sequence_settings

int ilObjTest::$sequence_settings

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

◆ $show_cancel

int ilObjTest::$show_cancel

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

◆ $show_exam_id_in_test_pass_enabled

bool ilObjTest::$show_exam_id_in_test_pass_enabled

protected

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

◆ $show_exam_id_in_test_results_enabled

bool ilObjTest::$show_exam_id_in_test_results_enabled

protected

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

◆ $show_examview_html

bool ilObjTest::$show_examview_html

protected

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

◆ $show_examview_pdf

bool ilObjTest::$show_examview_pdf

protected

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

◆ $show_marker

int ilObjTest::$show_marker

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

◆ $show_summary

ilObjTest::$show_summary

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

◆ $showGradingMarkEnabled

bool ilObjTest::$showGradingMarkEnabled

protected

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

◆ $showGradingStatusEnabled

bool ilObjTest::$showGradingStatusEnabled

protected

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

◆ $shuffle_questions

bool ilObjTest::$shuffle_questions

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

◆ $sign_submission

bool ilObjTest::$sign_submission

protected

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

◆ $skillServiceEnabled

bool ilObjTest::$skillServiceEnabled = false

private

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

◆ $specific_answer_feedback

int ilObjTest::$specific_answer_feedback = null

private

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

◆ $starting_time

string ilObjTest::$starting_time

protected

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

◆ $starting_time_enabled

ilObjTest::$starting_time_enabled

protected

bool?

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

◆ $template_id

ilObjTest::$template_id

private

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

◆ $test_id

int ilObjTest::$test_id

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

◆ $testFinalBroken

bool ilObjTest::$testFinalBroken

protected

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

◆ $testrequest

ILIAS Test InternalRequestService ilObjTest::$testrequest

private

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

◆ $testSequence

ilObjTest::$testSequence

contains the test sequence data

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

◆ $testSession

ilObjTest::$testSession

contains the test session data

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

◆ $title_output

int ilObjTest::$title_output

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

◆ $tmpCopyWizardCopyId

int ilObjTest::$tmpCopyWizardCopyId

private

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

Referenced by getTmpCopyWizardCopyId(), and setTmpCopyWizardCopyId().

◆ $use_previous_answers

int ilObjTest::$use_previous_answers

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

◆ DEFAULT_PROCESSING_TIME_MINUTES

const ilObjTest::DEFAULT_PROCESSING_TIME_MINUTES = 90

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

◆ QUESTION_SET_TYPE_DYNAMIC

const ilObjTest::QUESTION_SET_TYPE_DYNAMIC = 'DYNAMIC_QUEST_SET'

private

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

Referenced by _getQuestionCountAndPointsForPassOfParticipant().

◆ QUESTION_SET_TYPE_FIXED

const ilObjTest::QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET'

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

Referenced by _getQuestionCountAndPointsForPassOfParticipant(), ilObjTestSettingsGeneralGUI\addGeneralProperties(), ilTestSettingsTemplateConfig\addGeneralPropertySettings(), ilObjTestGUI\applyDefaultsObject(), ilLOTestAssignmentTableGUI\fillRow(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), ilLOTestAssignmentForm\initForm(), ilObjTestSettingsGeneralGUI\saveFormCmd(), ilTestExportFactoryTest\testGetExporter(), ilTestPlayerFactoryTest\testGetPlayerGUI(), and ilObjTestGUI\uploadTst().

◆ QUESTION_SET_TYPE_RANDOM

const ilObjTest::QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET'

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

Referenced by _getQuestionCountAndPointsForPassOfParticipant(), ilObjTestSettingsGeneralGUI\addGeneralProperties(), ilTestSettingsTemplateConfig\addGeneralPropertySettings(), ilObjTestGUI\applyDefaultsObject(), ilLOTestAssignmentTableGUI\fillRow(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), ilLOTestAssignmentForm\initForm(), ilTestExportFactoryTest\testGetExporter(), and ilTestPlayerFactoryTest\testGetPlayerGUI().

◆ SCORE_REPORTING_AFTER_PASSED

const ilObjTest::SCORE_REPORTING_AFTER_PASSED = 4

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

Referenced by ilObjTestGUI\infoScreen(), ilTestPassesSelector\isReportablePass(), and ilTestResultsGUI\showNoResultsReportingMessage().

◆ SCORE_REPORTING_DATE

const ilObjTest::SCORE_REPORTING_DATE = 3

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

Referenced by ilObjTestGUI\infoScreen(), ilTestPassesSelector\isReportablePass(), and ilTestResultsGUI\showNoResultsReportingMessage().

◆ SCORE_REPORTING_DISABLED

const ilObjTest::SCORE_REPORTING_DISABLED = 0

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

◆ SCORE_REPORTING_FINISHED

const ilObjTest::SCORE_REPORTING_FINISHED = 1

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

Referenced by ilObjTestGUI\infoScreen(), ilTestPassesSelector\isReportablePass(), and ilTestResultsGUI\showNoResultsReportingMessage().

◆ SCORE_REPORTING_IMMIDIATLY

const ilObjTest::SCORE_REPORTING_IMMIDIATLY = 2

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

Referenced by ilObjTestGUI\infoScreen(), and ilTestPassesSelector\isReportablePass().

The documentation for this class was generated from the following file:

Modules/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

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _buildName()

◆ _createImportDirectory()

◆ _evalResultsOverview()

◆ _getActiveIdOfUser()

◆ _getAvailableTests()

◆ _getBestPass()

◆ _getCompleteWorkingTimeOfParticipants()

◆ _getCountSystem()

◆ _getECTSGrade()

◆ _getImportDirectory()

◆ _getLastAccess()

◆ _getMaxPass()

◆ _getObjectIDFromActiveID()

◆ _getObjectIDFromTestID()

◆ _getPass()

◆ _getPassScoring()

◆ _getQuestionCountAndPointsForPassOfParticipant()

◆ _getResultPass()

◆ _getScoreCutting()

◆ _getSolvedQuestions()

◆ _getTestDefaults()

◆ _getTestIDFromObjectID()

◆ _getTitleOutput()

◆ _getUserIdFromActiveId()

◆ _getVisitTimeOfParticipant()

◆ _getWorkingTimeOfParticipantForPass()

◆ _instanciateQuestion()

◆ _isComplete()

◆ _lookupAnonymity()

◆ _lookupAuthor()

◆ _lookupFinishedUserTests()

◆ _lookupRandomTest()

◆ _lookupRandomTestFromActiveId()

◆ _lookupTestObjIdForQuestionId()

◆ _setImportDirectory()

◆ addDefaults()

◆ addExtraTime()

◆ addQTIMaterial()

◆ adjustTestSequence()

◆ allObligationsAnswered()

◆ applyDefaults()

◆ areObligationsEnabled()

◆ buildExamId()

◆ buildIso8601PeriodFromUnixtimeForExportCompatibility()

◆ buildName()

◆ buildStatisticsAccessFilteredParticipantList()

◆ canEditEctsGrades()

◆ canEditMarks()

◆ canShowEctsGrades()

◆ canShowSolutionPrintview()

◆ canShowTestResults()

◆ checkMarks()

◆ checkMaximumAllowedUsers()

◆ checkQuestionParent()

◆ cleanupMediaobjectUsage()

◆ create()

◆ createExportDirectory()

◆ createQuestionGUI()

◆ createTestSequence()

◆ delete()

◆ deleteDefaults()

◆ deleteTest()

◆ deliverPDFfromFO()

◆ deliverPDFfromHTML()

◆ disinviteUser()

◆ doCreateMetaData()

◆ duplicateQuestionForTest()

◆ endingTimeReached()