Public Member Functions |
Static Public Member Functions |
Data Fields |
Protected Member Functions |
Protected Attributes |
Private Member Functions |
Static Private Member Functions |
Private Attributes |
Static Private Attributes
ilObjTest Class Reference
Inheritance diagram for ilObjTest:
Collaboration diagram for ilObjTest:
Public Member Functions | |
| getLocalDIC () | |
| getTestLogger () | |
| getTestLogViewer () | |
| getQuestionSetConfig () | |
| getTitleFilenameCompliant () | |
| returns the object title prepared to be used as a filename More... | |
| getTmpCopyWizardCopyId () | |
| setTmpCopyWizardCopyId (int $tmpCopyWizardCopyId) | |
| create () | |
| 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 () | |
| isComplete (ilTestQuestionSetConfig $test_question_set_config) | |
| saveCompleteStatus (ilTestQuestionSetConfig $test_question_set_config) | |
| saveToDb (bool $properties_only=false) | |
| saveQuestionsToDb () | |
| copyQuestions (array $question_ids) | |
| getNrOfResultsForPass ($active_id, $pass) | |
| Calculates the number of user results for a specific test pass. More... | |
| loadFromDb () | |
| loadQuestions (int $active_id=0, ?int $pass=null) | |
| Load the test question id's from the database. More... | |
| getIntroduction () | |
| getFinalStatement () | |
| getTestId () | |
| Gets the database id of the additional test data. More... | |
| isPostponingEnabled () | |
| isScoreReportingEnabled () | |
| getAnswerFeedbackPoints () | |
| getGenericAnswerFeedback () | |
| getInstantFeedbackSolution () | |
| getCountSystem () | |
| getScoreCutting () | |
| Determines if the score of a question should be cut at 0 points or the score of the whole test. More... | |
| getPassScoring () | |
| Gets the pass scoring type. More... | |
| getMarkSchema () | |
| storeMarkSchema (MarkSchema $mark_schema) | |
| getNrOfTries () | |
| isBlockPassesAfterPassedEnabled () | |
| getKioskMode () | |
| getShowKioskModeTitle () | |
| getShowKioskModeParticipant () | |
| getUsePreviousAnswers () | |
| getTitleOutput () | |
| isPreviousSolutionReuseEnabled () | |
| getProcessingTime () | |
| getProcessingTimeInSeconds (int $active_id=0) | |
| getEnableProcessingTime () | |
| getResetProcessingTime () | |
| isStartingTimeEnabled () | |
| getStartingTime () | |
| isEndingTimeEnabled () | |
| getEndingTime () | |
| isPasswordEnabled () | |
| getPassword () | |
| removeQuestionsWithResults (array $question_ids) | |
| removeQuestionFromSequences (int $question_id, array $active_ids, ilTestReindexedSequencePositionMap $reindexed_sequence_position_map) | |
| removeQuestions (array $question_ids) | |
| removeQuestion (int $question_id) | |
| removeTestResultsFromSoapLpAdministration (array $user_ids) | |
| removeTestResults (ilTestParticipantData $participant_data) | |
| removeTestResultsByUserIds (array $user_ids) | |
| removeTestActives (array $active_ids) | |
| questionMoveUp ($question_id) | |
| Moves a question up in order. More... | |
| questionMoveDown ($question_id) | |
| Moves a question down in order. More... | |
| duplicateQuestionForTest ($question_id) | |
| Takes a question and creates a copy of the question for use in the test. More... | |
| insertQuestion (int $question_id, bool $link_only=false) | |
| getQuestionTitlesAndIndexes () | |
| Returns the titles of the test questions in question sequence. More... | |
| getQuestionTitle ($title, $nr=null, $points=null) | |
| Returns the title of a test question and checks if the title output is allowed. More... | |
| getQuestionDataset ($question_id) | |
| Returns the dataset for a given question id. More... | |
| & | getExistingQuestions ($pass=null) |
| Get the id's of the questions which are already part of the test. More... | |
| getQuestionType ($question_id) | |
| Returns the question type of a question with a given id. More... | |
| startWorkingTime ($active_id, $pass) | |
| Write the initial entry for the tests working time to the database. More... | |
| updateWorkingTime ($times_id) | |
| Update the working time of a test when a question is answered. More... | |
| & | getWorkedQuestions ($active_id, $pass=null) |
| Gets the id's of all questions a user already worked through. More... | |
| isTestFinishedToViewResults ($active_id, $currentpass) | |
| Returns true if an active user completed a test pass and did not start a new pass. More... | |
| getAllQuestions ($pass=null) | |
| Returns all questions of a test in test order. More... | |
| getActiveIdOfUser ($user_id="", $anonymous_id="") | |
| Gets the active id of a given user. More... | |
| pcArrayShuffle ($array) | |
| Shuffles the values of a given array. More... | |
| getTestResult (int $active_id, ?int $attempt=null, bool $ordered_sequence=false, bool $consider_hidden_questions=true, bool $consider_optional_questions=true) | |
| Calculates the results of a test for a given user and returns an array with all test results. More... | |
| evalTotalPersons () | |
| Returns the number of persons who started the test. More... | |
| getCompleteWorkingTime ($user_id) | |
| Returns the complete working time in seconds a user worked on the test. More... | |
| & | getCompleteWorkingTimeOfParticipants () |
| Returns the complete working time in seconds for all test participants. More... | |
| & | _getCompleteWorkingTimeOfParticipants ($test_id) |
| Returns the complete working time in seconds for all test participants. More... | |
| getCompleteWorkingTimeOfParticipant ($active_id) | |
| Returns the complete working time in seconds for a test participant. More... | |
| getWorkingTimeOfParticipantForPass (int $active_id, int $pass) | |
| @depracated 11, will be removed in 12, use TestResultManager::fetchWorkingTime instead 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 (string $name_sort_order='asc') | |
| evalTotalParticipantsArray (string $name_sort_order='asc') | |
| getQuestionsOfTest (int $active_id) | |
| getQuestionsOfPass (int $active_id, int $pass) | |
| getAccessFilteredParticipantList () | |
| setAccessFilteredParticipantList (ilTestParticipantList $access_filtered_participant_list) | |
| buildStatisticsAccessFilteredParticipantList () | |
| getAnonOnlyParticipantIds () | |
| return int[] More... | |
| getUnfilteredEvaluationData () | |
| getQuestionCountAndPointsForPassOfParticipant (int $active_id, int $pass) | |
| getCompleteEvaluationData ($filterby='', $filtertext='') | |
| buildName (?int $user_id, ?string $firstname, ?string $lastname) | |
| Builds a user name for the output depending on test type and existence of the user. More... | |
| evalTotalStartedAverageTime (?array $active_ids_to_filter=null) | |
| getAvailableQuestionpools (bool $use_object_id=false, ?bool $equal_points=false, bool $could_be_offline=false, bool $show_path=false, bool $with_questioncount=false, string $permission='read') | |
| Returns the available question pools for the active user. More... | |
| getImagePath () | |
| Returns the image path for web accessable images of a test The image path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_TEST/images. More... | |
| getImagePathWeb () | |
| Returns the web image path for web accessable images of a test The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_TEST/images. More... | |
| createQuestionGUI ($question_type, $question_id=-1) | |
| Creates a question GUI instance of a given question type. More... | |
| moveQuestions (array $move_questions, int $target_index, int $insert_mode) | |
| startingTimeReached () | |
| Returns true if the starting time of a test is reached A starting time is not available for self assessment tests. More... | |
| endingTimeReached () | |
| Returns true if the ending time of a test is reached An ending time is not available for self assessment tests. More... | |
| getAvailableQuestions ($arr_filter, $completeonly=0) | |
| Calculates the available questions for a test. More... | |
| fromXML (ilQTIAssessment $assessment, array $mappings) | |
| Receives parameters from a QTI parser and creates a valid ILIAS test object. More... | |
| toXML () | |
| Returns a QTI xml representation of the test. More... | |
| exportPagesXML (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog) | |
| export pages of test to xml (see ilias_co.dtd) More... | |
| modifyExportIdentifier ($a_tag, $a_param, $a_value) | |
| Returns the installation id for a given identifier. More... | |
| exportXMLPageObjects (&$a_xml_writer, $inst, &$expLog) | |
| export page objects to xml (see ilias_co.dtd) More... | |
| exportXMLMediaObjects (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog) | |
| export media objects to xml (see ilias_co.dtd) More... | |
| exportFileItems ($target_dir, &$expLog) | |
| export files of file itmes More... | |
| getImportMapping () | |
| get array of (two) new created questions for import id More... | |
| onMarkSchemaSaved () | |
| marksEditable () | |
| saveAuthorToMetadata ($author="") | |
| Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be called for conversion of "old" tests where the author hasn't been stored in the lifecycle metadata. More... | |
| getAuthor () | |
| Gets the authors name of the ilObjTest object. More... | |
| cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false) | |
| Clone object. More... | |
| getQuestionCount () | |
| getQuestionCountWithoutReloading () | |
| getTextAnswer ($active_id, $question_id, $pass=null) | |
| Returns the text answer of a given user for a given question. More... | |
| getQuestiontext ($question_id) | |
| Returns the question text for a given question. More... | |
| getActiveParticipantList () | |
| & | getInvitedUsers (int $user_id=0, $order="login, lastname, firstname") |
| Returns a list of all invited users in a test. More... | |
| getTestParticipants () | |
| getTestParticipantsForManualScoring ($filter=null) | |
| getUserData ($ids) | |
| Returns a data of all users specified by id list. More... | |
| getGroupData ($ids) | |
| getRoleData ($ids) | |
| inviteUser ($user_id, $client_ip="") | |
| Invites a user to a test. More... | |
| setQuestionSetSolved ($value, $question_id, $user_id) | |
| sets question solved state to value for given user_id More... | |
| isTestFinished ($active_id) | |
| returns if the active for user_id has been submitted More... | |
| isActiveTestSubmitted ($user_id=null) | |
| returns if the active for user_id has been submitted More... | |
| hasNrOfTriesRestriction () | |
| returns if the numbers of tries have to be checked More... | |
| isNrOfTriesReached ($tries) | |
| returns if number of tries are reached More... | |
| getAllTestResults ($participants) | |
| returns all test results for all participants More... | |
| getAnsweredQuestionCount ($active_id, $pass=null) | |
| Retrieves the number of answered questions for a given user in a given test. More... | |
| isExecutable ($test_session, $user_id, $allow_pass_increase=false) | |
| Checks if the test is executable by the given user. More... | |
| isNextPassAllowed (ilTestPassesSelector $testPassesSelector, int &$next_pass_allowed_timestamp) | |
| canShowTestResults (ilTestSession $test_session) | |
| hasAnyTestResult (ilTestSession $test_session) | |
| getStartingTimeOfUser ($active_id, $pass=null) | |
| Returns the unix timestamp of the time a user started a test. More... | |
| isMaxProcessingTimeReached (int $starting_time, int $active_id) | |
| Returns whether the maximum processing time for a test is reached or not. More... | |
| getTestQuestions () | |
| isTestQuestion (int $question_id) | |
| checkQuestionParent (int $question_id) | |
| getFixedQuestionSetTotalPoints () | |
| getPotentialRandomTestQuestions () | |
| getShuffleQuestions () | |
| getListOfQuestionsSettings () | |
| Returns the settings for the list of questions options in the test properties This could contain one of the following values: 0 = No list of questions offered 1 = A list of questions is offered 3 = A list of questions is offered and the list of questions is shown as first page of the test 5 = A list of questions is offered and the list of questions is shown as last page of the test 7 = A list of questions is offered and the list of questions is shown as first and last page of the test. More... | |
| getListOfQuestions () | |
| getUsrPassOverviewEnabled () | |
| getListOfQuestionsStart () | |
| getListOfQuestionsEnd () | |
| getListOfQuestionsDescription () | |
| getShowPassDetails () | |
| Returns if the pass details should be shown when a test is not finished. More... | |
| getShowSolutionPrintview () | |
| Returns if the solution printview should be presented to the user or not. More... | |
| canShowSolutionPrintview ($user_id=null) | |
| getShowSolutionFeedback () | |
| Returns if the feedback should be presented to the solution or not. More... | |
| getShowSolutionAnswersOnly () | |
| Returns if the full solution (including ILIAS content) should be presented to the solution or not. More... | |
| getShowSolutionSignature () | |
| Returns if the signature field should be shown in the test results. More... | |
| getShowSolutionSuggested () | |
| getShowSolutionListComparison () | |
| getShowSolutionListOwnAnswers () | |
| _getLastAccess (int $active_id) | |
| isHTML ($a_text) | |
| Checks if a given string contains HTML or not. More... | |
| qtiMaterialToArray ($a_material) | |
| Reads an QTI material tag and creates a text string. More... | |
| addQTIMaterial (ilXmlWriter &$xml_writer, ?int $page_id, string $material='') | |
| prepareTextareaOutput ($txt_output, $prepare_for_latex_output=false, $omitNl2BrWhenTextArea=false) | |
| Prepares a string for a text area output in tests. More... | |
| getAnonymity () | |
| getShowCancel () | |
| getShowMarker () | |
| getFixedParticipants () | |
| lookupQuestionSetTypeByActiveId (int $active_id) | |
| userLookupFullName ($user_id, $overwrite_anonymity=false, $sorted_order=false, $suffix="") | |
| Returns the full name of a test user according to the anonymity status. More... | |
| processPrintoutput2FO ($print_output) | |
| Convert a print output to XSL-FO. More... | |
| deliverPDFfromHTML ($content, $title=null) | |
| Delivers a PDF file from XHTML. More... | |
| deliverPDFfromFO ($fo, $title=null) | |
| Delivers a PDF file from a XSL-FO string. More... | |
| getCompleteManualFeedback (int $question_id) | |
| Retrieves the manual feedback for a question in a test. More... | |
| saveManualFeedback (int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized=false) | |
| getJavaScriptOutput () | |
| Returns if Javascript should be chosen for drag & drop actions for the active user. More... | |
| & | createTestSequence ($active_id, $pass, $shuffle) |
| setTestId ($a_id) | |
| Sets the test ID. More... | |
| getDetailedTestResults ($participants) | |
| returns all test results for all participants More... | |
| isPluginActive ($a_pname) | |
| Checks wheather or not a question plugin with a given name is active. More... | |
| getParticipantsForTestAndQuestion ($test_id, $question_id) | |
| Creates an associated array with all active id's for a given test and original question id. More... | |
| getAggregatedResultsData () | |
| getXMLZip () | |
| Get zipped xml file for test. More... | |
| getExportSettings () | |
| setTemplate (int $template_id) | |
| getTemplate () | |
| reindexFixedQuestionOrdering () | |
| setQuestionOrder (array $order) | |
| hasQuestionsWithoutQuestionpool () | |
| getQuestions () | |
| isOnline () | |
| getIntroductionPageId () | |
| getConcludingRemarksPageId () | |
| getHighscoreEnabled () | |
| getHighscoreAnon () | |
| Gets if the highscores should be anonymized per setting. More... | |
| isHighscoreAnon () | |
| Gets if the highscores should be displayed anonymized. More... | |
| getHighscoreAchievedTS () | |
| Returns if date and time of the scores achievement should be displayed. More... | |
| getHighscoreScore () | |
| Gets if the score column should be shown. More... | |
| getHighscorePercentage () | |
| Gets if the percentage column should be shown. More... | |
| getHighscoreWTime () | |
| Gets if the column with the workingtime should be shown. More... | |
| getHighscoreOwnTable () | |
| Gets if the own rankings table should be shown. More... | |
| getHighscoreTopTable () | |
| Gets, if the top-rankings table should be shown. More... | |
| getHighscoreTopNum (int $a_retval=10) | |
| Gets the number of entries which are to be shown in the top-rankings table. More... | |
| getHighscoreMode () | |
| getSpecificAnswerFeedback () | |
| getAutosave () | |
| isPassDeletionAllowed () | |
| getEnableExamview () | |
| getStartingTimeOfParticipants () | |
| Note, this function should only be used if absolutely necessary, since it perform joins on tables that tend to grow huge and returns vast amount of data. More... | |
| getTimeExtensionsOfParticipants () | |
| getMaxPassOfTest () | |
| isShowExamIdInTestPassEnabled () | |
| isShowExamIdInTestResultsEnabled () | |
| setQuestionSetType (string $question_set_type) | |
| getQuestionSetType () | |
| isFixedTest () | |
| Returns the fact wether this test is a fixed question set test or not. More... | |
| isRandomTest () | |
| Returns the fact wether this test is a random questions test or not. More... | |
| getQuestionSetTypeTranslation (ilLanguage $lng, $questionSetType) | |
| participantDataExist () | |
| recalculateScores ($preserve_manscoring=false) | |
| isSkillServiceEnabled () | |
| isSkillServiceToBeConsidered () | |
| Returns whether this test must consider skills, usually by providing appropriate extensions in the user interface components. More... | |
| isShowGradingStatusEnabled () | |
| isShowGradingMarkEnabled () | |
| isFollowupQuestionAnswerFixationEnabled () | |
| isInstantFeedbackAnswerFixationEnabled () | |
| isForceInstantFeedbackEnabled () | |
| adjustTestSequence () | |
| getGeneralQuestionPropertiesRepository () | |
| getGlobalSettings () | |
| getMainSettings () | |
| getMainSettingsRepository () | |
| getScoreSettings () | |
| getScoreSettingsRepository () | |
| addToNewsOnOnline (bool $old_online_status, bool $new_online_status) | |
| getVisitingTimeOfParticipant (int $active_id) | |
| Public Member Functions inherited from ilObject | |
| getObjectProperties () | |
| flushObjectProperties () | |
| withReferences () | |
| determines whether objects are referenced or not (got ref ids or not) More... | |
| processAutoRating () | |
| read () | |
| getId () | |
| setId (int $id) | |
| setRefId (int $ref_id) | |
| getRefId () | |
| getType () | |
| setType (string $type) | |
| getPresentationTitle () | |
| get presentation title Normally same as title Overwritten for sessions More... | |
| getTitle () | |
| getUntranslatedTitle () | |
| Get untranslated object title WebDAV needs to access the untranslated title of an object. More... | |
| setTitle (string $title) | |
| getDescription () | |
| setDescription (string $description) | |
| getLongDescription () | |
| get object long description (stored in object_description) More... | |
| getImportId () | |
| setImportId (string $import_id) | |
| setOfflineStatus (bool $status) | |
| getOfflineStatus () | |
| supportsOfflineHandling () | |
| getOwner () | |
| getOwnerName () | |
| get full name of object owner More... | |
| setOwner (int $usr_id) | |
| getCreateDate () | |
| Get create date in YYYY-MM-DD HH-MM-SS format. More... | |
| getLastUpdateDate () | |
| Get last update date in YYYY-MM-DD HH-MM-SS format. More... | |
| create () | |
| note: title, description and type should be set when this function is called More... | |
| update () | |
| MDUpdateListener (string $element) | |
| Metadata update listener. More... | |
| createMetaData () | |
| updateMetaData () | |
| deleteMetaData () | |
| updateOwner () | |
| update owner of object in db More... | |
| putInTree (int $parent_ref_id) | |
| maybe this method should be in tree object!? More... | |
| setPermissions (int $parent_ref_id) | |
| setParentRolePermissions (int $parent_ref_id) | |
| Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More... | |
| createReference () | |
| creates reference for object More... | |
| countReferences () | |
| delete () | |
| delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More... | |
| initDefaultRoles () | |
| init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type. More... | |
| applyDidacticTemplate (int $tpl_id) | |
| getXMLZip () | |
| getHTMLDirectory () | |
| appendCopyInfo (int $target_id, int $copy_id, int $new_obj_id) | |
| Prepend Copy info if object with same name exists in that container. More... | |
| cloneDependencies (int $target_id, int $copy_id) | |
| Clone object dependencies. More... | |
| cloneMetaData (ilObject $target_obj) | |
| Copy meta data. More... | |
| selfOrParentWithRatingEnabled () | |
| getPossibleSubObjects (bool $filter=true) | |
| get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More... | |
Static Public Member Functions | |
| static | _createImportDirectory () |
| creates data directory for import files (data_dir/tst_data/tst_<id>/import, depending on data directory that is set in ILIAS setup/ini) More... | |
| static | _getCountSystem (int $active_id) |
| static | _getPassScoring (int $active_id) |
| static | _getScoreCutting (int $active_id) |
| static | _getActiveIdOfUser ($user_id="", $test_id="") |
| static | _instanciateQuestion ($question_id) |
| Creates an instance of a question with a given question id. More... | |
| static | _lookupAuthor ($obj_id) |
| Gets the authors name of the ilObjTest object. More... | |
| static | _getAvailableTests ($use_object_id=false) |
| Returns the available tests for the active user. More... | |
| static | _getObjectIDFromTestID ($test_id) |
| Returns the ILIAS test object id for a given test id. More... | |
| static | _getObjectIDFromActiveID ($active_id) |
| Returns the ILIAS test object id for a given active id. More... | |
| static | _getTestIDFromObjectID ($object_id) |
| Returns the ILIAS test id for a given object id. More... | |
| static | _getSolvedQuestions ($active_id, $question_fi=null) |
| get solved questions More... | |
| static | _getPass ($active_id) |
| Retrieves the actual pass of a given user for a given test. More... | |
| static | _getMaxPass ($active_id) |
| Retrieves the maximum pass of a given user for a given test in which the user answered at least one question. More... | |
| static | _getBestPass ($active_id) |
| Retrieves the best pass of a given user for a given test. More... | |
| static | _getResultPass ($active_id) |
| Retrieves the pass number that should be counted for a given user. More... | |
| static | lookupPassResultsUpdateTimestamp ($active_id, $pass) |
| static | _getUserIdFromActiveId (int $active_id) |
| static | getManualFeedback (int $active_id, int $question_id, ?int $pass) |
| Retrieves the feedback comment for a question in a test if it is finalized. More... | |
| static | getSingleManualFeedback (int $active_id, int $question_id, int $pass) |
| static | _lookupTestObjIdForQuestionId (int $q_id) |
| Get test Object ID for question ID. More... | |
| static | _lookupFinishedUserTests ($a_user_id) |
| Gather all finished tests for user. More... | |
| static | lookupExamId ($active_id, $pass) |
| static | buildExamId ($active_id, $pass, $test_obj_id=null) |
| static | getTestObjIdsWithActiveForUserId ($userId) |
| static | isSkillManagementGloballyActivated () |
| static | isParticipantsLastPassActive (int $test_ref_id, int $user_id) |
| static | _lookupRandomTest (int $obj_id) |
| Static Public Member Functions inherited from ilObject | |
| static | _lookupObjIdByImportId (string $import_id) |
| Get (latest) object id for an import id. More... | |
| static | _lookupImportId (int $obj_id) |
| static | _lookupOwnerName (int $owner_id) |
| Lookup owner name for owner id. More... | |
| static | _getIdForImportId (string $import_id) |
| static | _getAllReferences (int $id) |
| get all reference ids for object ID More... | |
| static | _lookupTitle (int $obj_id) |
| static | lookupOfflineStatus (int $obj_id) |
| Lookup offline status using objectDataCache. More... | |
| static | _lookupOwner (int $obj_id) |
| Lookup owner user ID for object ID. More... | |
| static | _getIdsForTitle (string $title, string $type='', bool $partial_match=false) |
| static | _lookupDescription (int $obj_id) |
| static | _lookupLastUpdate (int $obj_id, bool $formatted=false) |
| static | _getLastUpdateOfObjects (array $obj_ids) |
| static | _lookupObjId (int $ref_id) |
| static | _setDeletedDate (int $ref_id, int $deleted_by) |
| static | setDeletedDates (array $ref_ids, int $user_id) |
| static | _resetDeletedDate (int $ref_id) |
| static | _lookupDeletedDate (int $ref_id) |
| static | _writeTitle (int $obj_id, string $title) |
| write title to db (static) More... | |
| static | _writeDescription (int $obj_id, string $desc) |
| write description to db (static) More... | |
| static | _writeImportId (int $obj_id, string $import_id) |
| write import id to db (static) More... | |
| static | _lookupType (int $id, bool $reference=false) |
| static | _isInTrash (int $ref_id) |
| static | _hasUntrashedReference (int $obj_id) |
| checks whether an object has at least one reference that is not in trash More... | |
| static | _lookupObjectId (int $ref_id) |
| static | _getObjectsDataForType (string $type, bool $omit_trash=false) |
| get all objects of a certain type More... | |
| static | _exists (int $id, bool $reference=false, ?string $type=null) |
| checks if an object exists in object_data More... | |
| static | _getObjectsByType (string $obj_type="", ?int $owner=null) |
| static | _prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true) |
| Prepare copy wizard object selection. More... | |
| static | getIconForType (string $type) |
| static | _getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false) |
| Get icon for repository item. More... | |
| static | collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0) |
| Collect deletion dependencies. More... | |
| static | getDeletionDependencies (int $obj_id) |
| Get deletion dependencies. More... | |
| static | getLongDescriptions (array $obj_ids) |
| static | getAllOwnedRepositoryObjects (int $user_id) |
| static | fixMissingTitles ($type, array &$obj_title_map) |
| Try to fix missing object titles. More... | |
| static | _lookupCreationDate (int $obj_id) |
| static | _getObjectTypeIdByTitle (string $type, ?\ilDBInterface $ilDB=null) |
Data Fields | |
| const | QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET' |
| const | QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET' |
| const | INVITATION_OFF = 0 |
| const | INVITATION_ON = 1 |
| const | SCORE_LAST_PASS = 0 |
| const | SCORE_BEST_PASS = 1 |
| int | $test_id = -1 |
| int | $invitation = self::INVITATION_OFF |
| string | $author |
| $metadata | |
| A reference to an IMS compatible matadata set. More... | |
| array | $questions = [] |
| $evaluation_data | |
| Contains the evaluation data settings the tutor defines for the user. More... | |
| $test_sequence = false | |
| contains the test sequence data More... | |
| Data Fields inherited from ilObject | |
| const | TITLE_LENGTH = 255 |
| const | DESC_LENGTH = 128 |
| const | LONG_DESC_LENGTH = 4000 |
| const | TABLE_OBJECT_DATA = "object_data" |
| array | $objectList |
| string | $untranslatedTitle |
Protected Member Functions | |
| buildIso8601PeriodForExportCompatibility (DateTimeImmutable $date_time) | |
| buildDateTimeImmutableFromPeriod (?string $period) | |
| doCreateMetaData () | |
| @inheritDoc More... | |
| secondsToHoursMinutesSecondsString (int $seconds) | |
| getHtmlQuestionContentPurifier () | |
| Protected Member Functions inherited from ilObject | |
| doMDUpdateListener (string $a_element) | |
| beforeMDUpdateListener (string $a_element) | |
| doCreateMetaData () | |
| beforeCreateMetaData () | |
| doUpdateMetaData () | |
| beforeUpdateMetaData () | |
| doDeleteMetaData () | |
| beforeDeleteMetaData () | |
| handleAutoRating () | |
| hasAutoRating () | |
Private Member Functions | |
| cloneIntroduction () | |
| cloneConcludingRemarks () | |
| clonePage (int $source_page_id) | |
| getProcessingTimeForXML () | |
| removeQuestionWithResults (int $question_id, TestScoring $scoring) | |
| removeTestResultsByActiveIds (array $active_ids) | |
| getQuestionTitles () | |
| addIntroductionToSettingsFromImport (SettingsIntroduction $settings, array $material, array $mappings) | |
| addConcludingRemarksToSettingsFromImport (SettingsFinishing $settings, array $material, array $mappings) | |
| replaceMobsInPageImports (string $text, array $mappings) | |
| replaceFilesInPageImports (string $text, array $mappings) | |
| convertTimeToDateTimeImmutableIfNecessary (DateTimeImmutable|int|null $date_time) | |
| insertManualFeedback (int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized, array $feedback_old) | |
| getExtraTime (int $active_id) | |
Static Private Member Functions | |
| static | _getScoreSettingsByActiveId (int $active_id) |
Private Attributes | |
| bool | $activation_limited = null |
| array | $mob_ids |
| array | $file_ids = [] |
| bool | $online |
| RequestDataCollector | $testrequest |
| MarksRepository | $marks_repository |
| MarkSchema | $mark_schema = null |
| int | $template_id = 0 |
| $participantDataExist = null | |
| holds the fact wether participant data exists or not DO NOT USE TIS PROPERTY DRIRECTLY ALWAYS USE ilObjTest::paricipantDataExist() since this method initialises this property More... | |
| int | $tmpCopyWizardCopyId = null |
| TestManScoringDoneHelper | $test_man_scoring_done_helper |
| ilComponentRepository | $component_repository |
| ilComponentFactory | $component_factory |
| Filesystem | $filesystem_web |
Static Private Attributes | |
| static | $isSkillManagementGloballyActivated = null |
Detailed Description
Definition at line 63 of file class.ilObjTest.php.
Member Function Documentation
◆ _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 407 of file class.ilObjTest.php.
407 : string
408 {
409 global $DIC;
412 ilFileUtils::makeDir($tst_data_dir);
413
414 if (!is_writable($tst_data_dir)) {
417 }
418
419 // create test directory (data_dir/tst_data/tst_import)
420 $tst_dir = $tst_data_dir . "/tst_import";
421 ilFileUtils::makeDir($tst_dir);
422 if (!@is_dir($tst_dir)) {
424 }
425
426 // assert that this is empty and does not contain old data
428
429 return $tst_dir;
430 }
raiseError(string $a_msg, int $a_err_obj)
wrapper for downward compability
Definition: class.ilias.php:145
static makeDir(string $a_dir)
creates a new directory and inherits all filesystem permissions of the parent directory You may pass ...
Definition: class.ilFileUtils.php:322
static delDir(string $a_dir, bool $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
Definition: class.ilFileUtils.php:484
References $DIC, ilObject\$ilias, ilFileUtils\delDir(), ilFileUtils\getDataDir(), ilFileUtils\makeDir(), and ILIAS\raiseError().
Here is the call graph for this function:
◆ _getActiveIdOfUser()
|
static |
Definition at line 1669 of file class.ilObjTest.php.
1670 {
1671 global $DIC;
1674
1676 $user_id = $ilUser->id;
1677 }
1679 return "";
1680 }
1681 $result = $ilDB->queryF(
1682 "SELECT tst_active.active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s",
1683 ['integer', 'integer'],
1685 );
1686 if ($result->numRows()) {
1687 $row = $ilDB->fetchAssoc($result);
1688 return $row["active_id"];
1689 } else {
1690 return "";
1691 }
1692 }
References $DIC, $ilDB, and $user_id.
Referenced by ilLOUtils\getTestResultLinkForUser().
Here is the caller graph for this function:
◆ _getAvailableTests()
|
static |
Returns the available tests for the active user.
- Returns
- array The available tests @access public
Definition at line 3882 of file class.ilObjTest.php.
3882 : array
3883 {
3884 global $DIC;
3886
3887 $result_array = [];
3888 $tests = array_slice(
3889 array_reverse(
3891 ),
3892 0,
3893 10000
3894 );
3895
3896 if (count($tests)) {
3899 if ($use_object_id) {
3901 $result_array[$obj_id] = $titles[$ref_id];
3902 } else {
3904 }
3905 }
3906 }
3907 return $result_array;
3908 }
static _prepareCloneSelection(array $ref_ids, string $new_type, bool $show_path=true)
Prepare copy wizard object selection.
Definition: class.ilObject.php:1531
static _getObjectsByOperations( $a_obj_type, string $a_operation, int $a_usr_id=0, int $limit=0)
Get all objects of a specific type and check access This function is not recursive,...
Definition: class.ilUtil.php:1055
References $DIC, $ref_id, ilUtil\_getObjectsByOperations(), ilObject\_lookupObjId(), and ilObject\_prepareCloneSelection().
Here is the call graph for this function:
◆ _getBestPass()
|
static |
Retrieves the best pass of a given user for a given test.
- Parameters
-
int $active_id
- Returns
- int|mixed
Definition at line 4627 of file class.ilObjTest.php.
4627 : ?int
4628 {
4629 global $DIC;
4631
4632 $result = $ilDB->queryF(
4633 "SELECT * FROM tst_pass_result WHERE active_fi = %s",
4634 ['integer'],
4635 [$active_id]
4636 );
4637
4638 if (!$result->numRows()) {
4639 return null;
4640 }
4641
4642 $bestrow = null;
4643 $bestfactor = 0.0;
4645 if ($row["maxpoints"] > 0.0) {
4646 $factor = (float) ($row["points"] / $row["maxpoints"]);
4647 } else {
4648 $factor = 0.0;
4649 }
4650 if ($factor === 0.0 && $bestfactor === 0.0
4651 || $factor > $bestfactor) {
4652 $bestrow = $row;
4653 $bestfactor = $factor;
4654 }
4655 }
4656
4657 if (is_array($bestrow)) {
4658 return $bestrow["pass"];
4659 }
4660
4661 return null;
4662 }
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 1930 of file class.ilObjTest.php.
1930 : array
1931 {
1932 $result = $this->db->queryF(
1933 "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",
1934 ['integer'],
1935 [$test_id]
1936 );
1937 $time = 0;
1938 $times = [];
1939 while ($row = $this->db->fetchAssoc($result)) {
1940 if (!array_key_exists($row["active_fi"], $times)) {
1941 $times[$row["active_fi"]] = 0;
1942 }
1943 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
1944 $epoch_1 = mktime(
1945 (int) $matches[4],
1946 (int) $matches[5],
1947 (int) $matches[6],
1948 (int) $matches[2],
1949 (int) $matches[3],
1950 (int) $matches[1]
1951 );
1952 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
1953 $epoch_2 = mktime(
1954 (int) $matches[4],
1955 (int) $matches[5],
1956 (int) $matches[6],
1957 (int) $matches[2],
1958 (int) $matches[3],
1959 (int) $matches[1]
1960 );
1961 $times[$row["active_fi"]] += ($epoch_2 - $epoch_1);
1962 }
1963 return $times;
1964 }
◆ _getCountSystem()
|
static |
- Deprecated:
- Use ScoreSettingsRepository or \ilObjTest::getCountSystem instead
Definition at line 764 of file class.ilObjTest.php.
764 : int
765 {
767 }
static _getScoreSettingsByActiveId(int $active_id)
Definition: class.ilObjTest.php:754
References _getScoreSettingsByActiveId().
Referenced by assQuestion\adjustReachedPointsByScoringOptions().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _getLastAccess()
| ilObjTest::_getLastAccess | ( | int | $active_id | ) |
Definition at line 5177 of file class.ilObjTest.php.
5177 : string
5178 {
5179 $result = $this->db->queryF(
5180 "SELECT finished FROM tst_times WHERE active_fi = %s ORDER BY finished DESC",
5181 ['integer'],
5182 [$active_id]
5183 );
5184 if ($result->numRows()) {
5185 $row = $this->db->fetchAssoc($result);
5186 return $row["finished"];
5187 }
5188 return "";
5189 }
◆ _getMaxPass()
|
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 4604 of file class.ilObjTest.php.
4604 : ?int
4605 {
4606 global $DIC;
4608 $result = $ilDB->queryF(
4609 "SELECT MAX(pass) maxpass FROM tst_pass_result WHERE active_fi = %s",
4610 ['integer'],
4611 [$active_id]
4612 );
4613
4614 if ($result->numRows()) {
4615 $row = $ilDB->fetchAssoc($result);
4616 return $row["maxpass"];
4617 }
4618
4619 return null;
4620 }
Referenced by _getResultPass(), and ilTestParticipantList\lookupNrOfTries().
Here is the caller graph for this function:
◆ _getObjectIDFromActiveID()
|
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 4067 of file class.ilObjTest.php.
4068 {
4069 global $DIC;
4071 $object_id = false;
4072 $result = $ilDB->queryF(
4073 "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",
4074 ['integer'],
4075 [$active_id]
4076 );
4077 if ($result->numRows()) {
4078 $row = $ilDB->fetchAssoc($result);
4079 $object_id = $row["obj_fi"];
4080 }
4081 return $object_id;
4082 }
Referenced by _getScoreSettingsByActiveId().
Here is the caller graph for this function:
◆ _getObjectIDFromTestID()
|
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 4043 of file class.ilObjTest.php.
4044 {
4045 global $DIC;
4047 $object_id = false;
4048 $result = $ilDB->queryF(
4049 "SELECT obj_fi FROM tst_tests WHERE test_id = %s",
4050 ['integer'],
4051 [$test_id]
4052 );
4053 if ($result->numRows()) {
4054 $row = $ilDB->fetchAssoc($result);
4055 $object_id = $row["obj_fi"];
4056 }
4057 return $object_id;
4058 }
Referenced by ilSoapTestAdministration\getTestUserData().
Here is the caller graph for this function:
◆ _getPass()
|
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 4578 of file class.ilObjTest.php.
4578 : int
4579 {
4580 global $DIC;
4582 $result = $ilDB->queryF(
4583 "SELECT tries FROM tst_active WHERE active_id = %s",
4584 ['integer'],
4585 [$active_id]
4586 );
4587 if ($result->numRows()) {
4588 $row = $ilDB->fetchAssoc($result);
4589 return $row["tries"];
4590 } else {
4591 return 0;
4592 }
4593 }
Referenced by ilTestService\getPassOverviewData(), assFormulaQuestionGUI\getTestOutput(), loadQuestions(), assQuestion\persistWorkingState(), ilTestPlayerAbstractGUI\populateInstantResponseBlocks(), ilTestPlayerAbstractGUI\save(), assClozeTest\saveWorkingData(), assErrorText\saveWorkingData(), assFileUpload\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assKprimChoice\saveWorkingData(), assLongMenu\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assNumeric\saveWorkingData(), assSingleChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), and assTextSubset\saveWorkingData().
Here is the caller graph for this function:
◆ _getPassScoring()
|
static |
- Deprecated:
- Use ScoreSettingsRepository or \ilObjTest::getPassScoring instead
Definition at line 788 of file class.ilObjTest.php.
788 : int
789 {
791 }
References _getScoreSettingsByActiveId().
Referenced by _getResultPass().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _getResultPass()
|
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 4672 of file class.ilObjTest.php.
4672 : ?int
4673 {
4674 $counted_pass = null;
4676 $counted_pass = ilObjTest::_getBestPass($active_id);
4677 } else {
4678 $counted_pass = ilObjTest::_getMaxPass($active_id);
4679 }
4680 return $counted_pass;
4681 }
static _getMaxPass($active_id)
Retrieves the maximum pass of a given user for a given test in which the user answered at least one q...
Definition: class.ilObjTest.php:4604
static _getBestPass($active_id)
Retrieves the best pass of a given user for a given test.
Definition: class.ilObjTest.php:4627
References _getBestPass(), _getMaxPass(), and _getPassScoring().
Referenced by ILIAS\Test\Questions\Presentation\Printer\addQuestionResultForTestUsersToTemplate(), evalStatistical(), ILIAS\Test\Scoring\Manual\PositionsFactory\get(), getAllTestResults(), getDetailedTestResults(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\performDeletePass(), ilTestEvaluationGUI\printResults(), and ilTestEvaluationGUI\showResults().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _getScoreCutting()
|
static |
- Deprecated:
- Use ScoreSettingsRepository or \ilObjTest::getScoreCutting instead
Definition at line 796 of file class.ilObjTest.php.
796 : bool
797 {
798 return (bool) self::_getScoreSettingsByActiveId($active_id)->getScoringSettings()->getScoreCutting();
799 }
References _getScoreSettingsByActiveId().
Referenced by assQuestion\adjustReachedPointsByScoringOptions().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _getScoreSettingsByActiveId()
|
staticprivate |
- Deprecated:
- This is only temporary
Definition at line 754 of file class.ilObjTest.php.
754 : ScoreSettings
755 {
756 return TestDIC::dic()['settings.scoring.repository']->getFor(
758 );
759 }
static _getObjectIDFromActiveID($active_id)
Returns the ILIAS test object id for a given active id.
Definition: class.ilObjTest.php:4067
static _getTestIDFromObjectID($object_id)
Returns the ILIAS test id for a given object id.
Definition: class.ilObjTest.php:4091
References _getObjectIDFromActiveID(), and _getTestIDFromObjectID().
Referenced by _getCountSystem(), _getPassScoring(), and _getScoreCutting().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _getSolvedQuestions()
|
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 4402 of file class.ilObjTest.php.
4402 : array
4403 {
4404 global $DIC;
4406 if (is_numeric($question_fi)) {
4407 $result = $ilDB->queryF(
4408 "SELECT question_fi, solved FROM tst_qst_solved WHERE active_fi = %s AND question_fi=%s",
4409 ['integer', 'integer'],
4410 [$active_id, $question_fi]
4411 );
4412 } else {
4413 $result = $ilDB->queryF(
4414 "SELECT question_fi, solved FROM tst_qst_solved WHERE active_fi = %s",
4415 ['integer'],
4416 [$active_id]
4417 );
4418 }
4419 $result_array = [];
4421 $result_array[$row["question_fi"]] = $row;
4422 }
4423 return $result_array;
4424 }
Referenced by ilTestPlayerAbstractGUI\buildEditableStateQuestionNavigationGUI(), ilTestPlayerAbstractGUI\buildReadOnlyStateQuestionNavigationGUI(), ilTestService\getQuestionSummaryData(), and ilTestSequence\getSequenceSummary().
Here is the caller graph for this function:
◆ _getTestIDFromObjectID()
|
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 4091 of file class.ilObjTest.php.
4092 {
4093 global $DIC;
4096 $result = $ilDB->queryF(
4097 "SELECT test_id FROM tst_tests WHERE obj_fi = %s",
4098 ['integer'],
4099 [$object_id]
4100 );
4101 if ($result->numRows()) {
4102 $row = $ilDB->fetchAssoc($result);
4104 }
4106 }
Referenced by _getScoreSettingsByActiveId(), _lookupRandomTest(), ilLOUtils\getTestResultLinkForUser(), and ilTestAccess\isParticipantAllowed().
Here is the caller graph for this function:
◆ _getUserIdFromActiveId()
|
static |
- Deprecated:
- : use ilTestParticipantData instead
Definition at line 5160 of file class.ilObjTest.php.
5160 : int
5161 {
5162 global $DIC;
5164 $result = $ilDB->queryF(
5165 "SELECT user_fi FROM tst_active WHERE active_id = %s",
5166 ['integer'],
5167 [$active_id]
5168 );
5169 if ($result->numRows()) {
5170 $row = $ilDB->fetchAssoc($result);
5171 return $row["user_fi"];
5172 } else {
5173 return -1;
5174 }
5175 }
Referenced by ILIAS\Test\ExportImport\CertificateExport\write().
Here is the caller graph for this function:
◆ _instanciateQuestion()
|
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 2596 of file class.ilObjTest.php.
2596 : ?assQuestion
2597 {
2598 if (strcmp((string) $question_id, "") !== 0) {
2600 }
2601
2602 return null;
2603 }
Definition: class.assQuestion.php:53
static instantiateQuestion(int $question_id)
Definition: class.assQuestion.php:1736
References assQuestion\instantiateQuestion().
Referenced by ilCourseObjectiveQuestion\__read(), duplicateQuestionForTest(), getAllTestResults(), getDetailedTestResults(), ilCourseObjectiveQuestion\getMaxPointsByObjective(), ilCourseObjectiveQuestion\getMaxPointsByTest(), and ilCourseObjectiveQuestionAssignmentTableGUI\parse().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _lookupAuthor()
|
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 3863 of file class.ilObjTest.php.
3863 : string
3864 {
3865 global $DIC;
3866
3868
3869 $path_to_authors = $lo_metadata->paths()->authors();
3871 ->allData($path_to_authors);
3872
3874 }
References $DIC.
Referenced by assQuestion\getInstances().
Here is the caller graph for this function:
◆ _lookupFinishedUserTests()
|
static |
Gather all finished tests for user.
- Parameters
-
int $a_user_id
- Returns
- array(test id => passed)
Definition at line 5996 of file class.ilObjTest.php.
5996 : array
5997 {
5998 global $DIC;
6000
6001 $result = $ilDB->queryF(
6002 "SELECT test_fi,MAX(pass) AS pass FROM tst_active" .
6003 " JOIN tst_pass_result ON (tst_pass_result.active_fi = tst_active.active_id)" .
6004 " WHERE user_fi=%s" .
6005 " GROUP BY test_fi",
6006 ['integer', 'integer'],
6007 [$a_user_id, 1]
6008 );
6009 $all = [];
6012 $all[$obj_id] = (bool) $row["pass"];
6013 }
6014 return $all;
6015 }
static _getObjectIDFromTestID($test_id)
Returns the ILIAS test object id for a given test id.
Definition: class.ilObjTest.php:4043
◆ _lookupRandomTest()
|
static |
- Deprecated:
- There is no reason for this to be interesting for other objects
Definition at line 6630 of file class.ilObjTest.php.
6630 : bool
6631 {
6632 return TestDIC::dic()['settings.main.repository']->getFor(
6633 ilObjTest::_getTestIDFromObjectID($obj_id),
6634 )->getGeneralSettings()->getQuestionSetType() === self::QUESTION_SET_TYPE_RANDOM;
6635 }
References _getTestIDFromObjectID().
Referenced by ilCourseObjectivesGUI\isRandomTestType(), ilLOSettings\isRandomTestType(), and ilLOUtils\lookupRandomTest().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ _lookupTestObjIdForQuestionId()
|
static |
Get test Object ID for question ID.
Definition at line 5740 of file class.ilObjTest.php.
5740 : ?int
5741 {
5742 global $DIC;
5744
5745 $result = $ilDB->queryF(
5746 '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',
5747 ['integer'],
5748 [$q_id]
5749 );
5750 $rec = $ilDB->fetchAssoc($result);
5751 return $rec['obj_id'] ?? null;
5752 }
Referenced by ilSoapTestAdministration\getQuestionSolution().
Here is the caller graph for this function:
◆ addConcludingRemarksToSettingsFromImport()
|
private |
Definition at line 3119 of file class.ilObjTest.php.
3123 : SettingsFinishing {
3124 if (!str_starts_with($material['text'], '<PageObject>')) {
3126 }
3127
3129 $this->replaceMobsInPageImports(
3130 $material['text'],
3131 $mappings['components/ILIAS/MediaObjects']['mob'] ?? []
3132 )
3133 );
3134
3136 $page_object->setParentId($this->getId());
3137 $page_object->setXMLContent($text);
3138 $new_page_id = $page_object->createPageWithNextId();
3140 }
replaceFilesInPageImports(string $text, array $mappings)
Definition: class.ilObjTest.php:3155
replaceMobsInPageImports(string $text, array $mappings)
Definition: class.ilObjTest.php:3142
@ilCtrl_Calls ilTestEditPageGUI: ilPageEditorGUI, ilEditClipboardGUI, ilMDEditorGUI @ilCtrl_Calls ilT...
Definition: class.ilTestPage.php:28
◆ addIntroductionToSettingsFromImport()
|
private |
Definition at line 3096 of file class.ilObjTest.php.
3100 : SettingsIntroduction {
3101 if (!str_starts_with($material['text'], '<PageObject>')) {
3103 }
3104
3106 $this->replaceMobsInPageImports(
3107 $material['text'],
3108 $mappings['components/ILIAS/MediaObjects']['mob'] ?? []
3109 )
3110 );
3111
3113 $page_object->setParentId($this->getId());
3114 $page_object->setXMLContent($text);
3115 $new_page_id = $page_object->createPageWithNextId();
3117 }
◆ addQTIMaterial()
| ilObjTest::addQTIMaterial | ( | ilXmlWriter & | $xml_writer, |
| ?int | $page_id, | ||
| string | $material = '' |
||
| ) |
Definition at line 5270 of file class.ilObjTest.php.
5270 : void
5271 {
5273 $attrs = [
5274 'texttype' => 'text/plain'
5275 ];
5276 $file_ids = [];
5277 $mobs = [];
5278 if ($page_id !== null) {
5279 $attrs['texttype'] = 'text/xml';
5282 $page_object->buildDom();
5284 $material = base64_encode($page_object->getXMLFromDom());
5287 $this->file_ids[] = (int) $file_id;
5288 };
5290 } elseif ($this->isHTML($material)) {
5291 $attrs['texttype'] = 'text/xhtml';
5293 $mob_string = 'mm_';
5294 }
5295
5297 foreach ($mobs as $mob) {
5298 $mob_id_string = (string) $mob;
5300 if (strpos($material, $mob_string . $mob_id_string) !== false) {
5303 $imgattrs = [
5304 'label' => $moblabel,
5305 'uri' => 'objects/' . 'il_' . IL_INST_ID . '_mob_' . $mob_id_string . '/' . $mob_obj->getTitle()
5306 ];
5307 }
5309 }
5310 }
5312 }
Definition: class.ilObjMediaObject.php:37
static _exists(int $id, bool $reference=false, ?string $type=null)
checks if an object exists in object_data
Definition: class.ilObjMediaObject.php:69
static _getMobsOfObject(string $a_type, int $a_id, int|false $a_usage_hist_nr=0, string $a_lang="-")
Definition: class.ilObjMediaObject.php:813
static collectFileItems(ilPageObject $a_page, DOMDocument $a_domdoc)
Get all file items that are used within the page.
Definition: class.ilPCFileList.php:312
xmlElement(string $tag, $attrs=null, $data=null, $encode=true, $escape=true)
Writes a basic element (no children, just textual content)
Definition: class.ilXmlWriter.php:318
xmlStartTag(string $tag, ?array $attrs=null, bool $empty=false, bool $encode=true, bool $escape=true)
Writes a starttag.
Definition: class.ilXmlWriter.php:238
References ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilPCFileList\collectFileItems(), ILIAS\Survey\Mode\getId(), IL_INST_ID, ILIAS\Repository\int(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().
Here is the call graph for this function:
◆ addToNewsOnOnline()
| ilObjTest::addToNewsOnOnline | ( | bool | $old_online_status, |
| bool | $new_online_status | ||
| ) |
Definition at line 6595 of file class.ilObjTest.php.
6598 : void {
6599 if (!$old_online_status && $new_online_status) {
6602 $newsItem->setPriority(NEWS_NOTICE);
6603 $newsItem->setTitle('new_test_online');
6604 $newsItem->setContentIsLangVar(true);
6605 $newsItem->setContent('');
6606 $newsItem->setUserId($this->user->getId());
6607 $newsItem->setVisibility(NEWS_USERS);
6608 $newsItem->create();
6609 return;
6610 }
6611
6612 if ($old_online_status && !$new_online_status) {
6614 return;
6615 }
6616
6618 if (!$new_online_status && $newsId > 0) {
6620 $newsItem->setTitle('new_test_online');
6621 $newsItem->setContentIsLangVar(true);
6622 $newsItem->setContent('');
6623 $newsItem->update();
6624 }
6625 }
static getFirstNewsIdForContext(int $a_context_obj_id, string $a_context_obj_type, int $a_context_sub_obj_id=0, string $a_context_sub_obj_type="")
Get first new id of news set related to a certain context.
Definition: class.ilNewsItem.php:1726
static deleteNewsOfContext(int $a_context_obj_id, string $a_context_obj_type, int $a_context_sub_obj_id=0, string $a_context_sub_obj_type="")
Delete all news of a context.
Definition: class.ilNewsItem.php:1493
References ILIAS\Survey\Mode\getId(), NEWS_NOTICE, NEWS_USERS, and ILIAS\Repository\user().
Here is the call graph for this function:
◆ adjustTestSequence()
| ilObjTest::adjustTestSequence | ( | ) |
Definition at line 6464 of file class.ilObjTest.php.
6465 {
6466 $query = "
6467 SELECT COUNT(test_question_id) cnt
6468 FROM tst_test_question
6469 WHERE test_fi = %s
6470 ORDER BY sequence
6471 ";
6472
6474
6475 $row = $this->db->fetchAssoc($questRes);
6476 $questCount = $row['cnt'];
6477
6479 $query = "
6480 SELECT tseq.*
6481 FROM tst_active tac
6482 INNER JOIN tst_sequence tseq
6483 ON tseq.active_fi = tac.active_id
6484 WHERE tac.test_fi = %s
6485 ";
6486
6487 $partRes = $this->db->queryF(
6488 $query,
6489 ['integer'],
6490 [$this->getTestId()]
6491 );
6492
6493 while ($row = $this->db->fetchAssoc($partRes)) {
6494 $sequence = @unserialize($row['sequence']);
6495
6496 if (!$sequence) {
6497 $sequence = [];
6498 }
6499
6500 $sequence = array_filter($sequence, function ($value) use ($questCount) {
6501 return $value <= $questCount;
6502 });
6503
6504 $num_seq = count($sequence);
6505 if ($questCount > $num_seq) {
6506 $diff = $questCount - $num_seq;
6507 for ($i = 1; $i <= $diff; $i++) {
6508 $sequence[$num_seq + $i - 1] = $num_seq + $i;
6509 }
6510 }
6511
6512 $new_sequence = serialize($sequence);
6513
6514 $this->db->update('tst_sequence', [
6515 'sequence' => ['clob', $new_sequence]
6516 ], [
6517 'active_fi' => ['integer', $row['active_fi']],
6518 'pass' => ['integer', $row['pass']]
6519 ]);
6520 }
6521 } else {
6522 $new_sequence = serialize($questCount > 0 ? range(1, $questCount) : []);
6523
6524 $query = "
6525 SELECT tseq.*
6526 FROM tst_active tac
6527 INNER JOIN tst_sequence tseq
6528 ON tseq.active_fi = tac.active_id
6529 WHERE tac.test_fi = %s
6530 ";
6531
6532 $part_rest = $this->db->queryF(
6533 $query,
6534 ['integer'],
6535 [$this->getTestId()]
6536 );
6537
6538 while ($row = $this->db->fetchAssoc($part_rest)) {
6539 $this->db->update('tst_sequence', [
6540 'sequence' => ['clob', $new_sequence]
6541 ], [
6542 'active_fi' => ['integer', $row['active_fi']],
6543 'pass' => ['integer', $row['pass']]
6544 ]);
6545 }
6546 }
6547 }
◆ buildDateTimeImmutableFromPeriod()
|
protected |
Definition at line 3597 of file class.ilObjTest.php.
3597 : ?DateTimeImmutable
3598 {
3599 if ($period === null) {
3600 return null;
3601 }
3602 if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $period, $matches)) {
3603 return new DateTimeImmutable(
3604 sprintf(
3605 "%02d-%02d-%02d %02d:%02d:%02d",
3606 $matches[1],
3607 $matches[2],
3608 $matches[3],
3609 $matches[4],
3610 $matches[5],
3611 $matches[6]
3612 ),
3613 new \DateTimeZone('UTC')
3614 );
3615 }
3616 return null;
3617 }
◆ buildExamId()
|
static |
Definition at line 6252 of file class.ilObjTest.php.
6252 : string
6253 {
6254 global $DIC;
6256
6258
6259 if ($test_obj_id === null) {
6260 $obj_id = self::_getObjectIDFromActiveID($active_id);
6261 } else {
6262 $obj_id = $test_obj_id;
6263 }
6264
6265 $examId = 'I' . $inst_id . '_T' . $obj_id . '_A' . $active_id . '_P' . $pass;
6266
6267 return $examId;
6268 }
References $DIC, and $ilSetting.
Referenced by ILIAS\Test\Results\Data\Repository\buildTestAttemptResultObject(), ilTestPlayerAbstractGUI\getTestPlayerTitle(), and ILIAS\Test\Scoring\Manual\ConsecutiveScoringGUI\getUserRepresentation().
Here is the caller graph for this function:
◆ buildIso8601PeriodForExportCompatibility()
|
protected |
Definition at line 3592 of file class.ilObjTest.php.
3592 : string
3593 {
3594 return $date_time->setTimezone(new DateTimeZone('UTC'))->format('\PY\Yn\Mj\D\TG\Hi\Ms\S');
3595 }
◆ buildName()
| ilObjTest::buildName | ( | ?int | $user_id, |
| ?string | $firstname, | ||
| ?string | $lastname | ||
| ) |
Builds a user name for the output depending on test type and existence of the user.
- Parameters
-
int $user_id The database ID of the user string $firstname The first name of the user string $lastname The last name of the user string $title The title of the user
- Returns
- string The output name of the user @access public
Definition at line 2443 of file class.ilObjTest.php.
2447 : string {
2449 || $firstname . $lastname === '') {
2451 }
2452
2455 }
2456
2458 return $lastname;
2459 }
2460
2461 return trim($lastname . ', ' . $firstname);
2462 }
References ILIAS\Repository\lng().
Here is the call graph for this function:
◆ buildStatisticsAccessFilteredParticipantList()
| ilObjTest::buildStatisticsAccessFilteredParticipantList | ( | ) |
Definition at line 2333 of file class.ilObjTest.php.
2333 : ilTestParticipantList
2334 {
2336 $list->initializeFromDbRows($this->getTestParticipants());
2337
2338 return $list->getAccessFilteredList(
2339 $this->participant_access_filter->getAccessStatisticsUserFilter($this->getRefId())
2340 );
2341 }
References ILIAS\Repository\lng(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ canShowSolutionPrintview()
| ilObjTest::canShowSolutionPrintview | ( | $user_id = null | ) |
Definition at line 5106 of file class.ilObjTest.php.
5106 : bool
5107 {
5109 }
getShowSolutionPrintview()
Returns if the solution printview should be presented to the user or not.
Definition: class.ilObjTest.php:5099
◆ canShowTestResults()
| ilObjTest::canShowTestResults | ( | ilTestSession | $test_session | ) |
Definition at line 4849 of file class.ilObjTest.php.
4849 : bool
4850 {
4852
4853 $pass_selector->setActiveId($test_session->getActiveId());
4854 $pass_selector->setLastFinishedPass($test_session->getLastFinishedPass());
4855
4856 return $pass_selector->hasReportablePasses();
4857 }
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:
◆ checkQuestionParent()
| ilObjTest::checkQuestionParent | ( | int | $question_id | ) |
Definition at line 4987 of file class.ilObjTest.php.
4987 : bool
4988 {
4989 $row = $this->db->fetchAssoc($this->db->queryF(
4990 "SELECT COUNT(question_id) cnt FROM qpl_questions WHERE question_id = %s AND obj_fi = %s",
4991 ['integer', 'integer'],
4992 [$question_id, $this->getId()]
4993 ));
4994
4995 return (bool) $row['cnt'];
4996 }
◆ cloneConcludingRemarks()
|
private |
Definition at line 695 of file class.ilObjTest.php.
695 : ?int
696 {
697 $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
698 if ($page_id === null) {
699 return null;
700 }
702 }
References clonePage(), and getMainSettings().
Here is the call graph for this function:
◆ cloneIntroduction()
|
private |
Definition at line 678 of file class.ilObjTest.php.
678 : ?int
679 {
680 $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
681 if ($page_id === null) {
682 return null;
683 }
685 }
References clonePage(), and getMainSettings().
Here is the call graph for this function:
◆ cloneObject()
| ilObjTest::cloneObject | ( | int | $target_id, |
| int | $copy_id = 0, |
||
| bool | $omit_tree = false |
||
| ) |
Clone object.
@access public
- Parameters
-
int ref id of parent container int copy id
- Returns
- object new test object
Definition at line 3918 of file class.ilObjTest.php.
3918 : ?ilObject
3919 {
3920 $this->loadFromDb();
3921
3922 $new_obj = parent::cloneObject($target_id, $copy_id, $omit_tree);
3923 $new_obj->setTmpCopyWizardCopyId($copy_id);
3924 $this->cloneMetaData($new_obj);
3925
3926 $new_obj->saveToDb();
3927 $new_obj->addToNewsOnOnline(false, $new_obj->getObjectProperties()->getPropertyIsOnline()->getIsOnline());
3928
3929 $new_main_settings = $this->getMainSettings()
3930 ->withIntroductionSettings(
3931 $this->getMainSettings()->getIntroductionSettings()->withIntroductionPageId(
3932 $this->cloneIntroduction()
3933 )
3934 )->withFinishingSettings(
3935 $this->getMainSettings()->getFinishingSettings()->withConcludingRemarksPageId(
3936 $this->cloneConcludingRemarks()
3937 )
3938 );
3939
3940 $new_main_settings = $this->getMainSettingsRepository()->store($new_main_settings, $new_obj->getTestId());
3941 $this->getScoreSettingsRepository()->store(
3942 $this->getScoreSettings()->withId($new_main_settings->getId())
3943 );
3944 $this->marks_repository->storeMarkSchema(
3945 $this->getMarkSchema()->withTestId($new_obj->getTestId())
3946 );
3947
3948 $new_obj->setTemplate($this->getTemplate());
3949
3950 // clone certificate
3953
3955 $this->db,
3956 $pathFactory,
3957 $templateRepository,
3959 );
3960
3961 $cloneAction->cloneCertificate($this, $new_obj);
3962
3963 $this->question_set_config_factory->getQuestionSetConfig()->cloneQuestionSetRelatedData($new_obj);
3964 $new_obj->saveQuestionsToDb();
3965
3967 $skillLevelThresholdList->setTestId($this->getTestId());
3968 $skillLevelThresholdList->loadFromDb();
3969 $skillLevelThresholdList->cloneListForTest($new_obj->getTestId());
3970
3972 $obj_settings->cloneSettings($new_obj->getId());
3973
3974 if ($new_obj->getTestLogger()->isLoggingEnabled()) {
3975 $new_obj->getTestLogger()->logTestAdministrationInteraction(
3976 $new_obj->getTestLogger()->getInteractionFactory()->buildTestAdministrationInteraction(
3977 $new_obj->getRefId(),
3978 $this->user->getId(),
3979 TestAdministrationInteractionTypes::NEW_TEST_CREATED,
3980 []
3981 )
3982 );
3983 }
3984
3985 return $new_obj;
3986 }
Definition: class.ilLPObjSettings.php:27
getScoreSettingsRepository()
Definition: class.ilObjTest.php:6590
References ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ clonePage()
|
private |
Definition at line 704 of file class.ilObjTest.php.
704 : int
705 {
707 $page_object->setParentId($this->getId());
708 $new_page_id = $page_object->createPageWithNextId();
710 return $new_page_id;
711 }
References ilObject\getId().
Referenced by cloneConcludingRemarks(), and cloneIntroduction().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ convertTimeToDateTimeImmutableIfNecessary()
|
private |
Definition at line 5386 of file class.ilObjTest.php.
5388 : ?DateTimeImmutable {
5389 if ($date_time === null || $date_time instanceof DateTimeImmutable) {
5390 return $date_time;
5391 }
5392
5393 return DateTimeImmutable::createFromFormat('U', (string) $date_time);
5394 }
◆ copyQuestions()
| ilObjTest::copyQuestions | ( | array | $question_ids | ) |
- Parameters
-
array<int> $question_ids
Definition at line 566 of file class.ilObjTest.php.
566 : void
567 {
568 $copy_count = 0;
569 $question_titles = $this->getQuestionTitles();
570
572 $question = assQuestion::instantiateQuestionGUI($id);
573 if ($question) {
574 $title = $question->getObject()->getTitle();
575 $i = 2;
577 $i++;
578 }
579
581
582 $question_titles[] = $title;
583
585
586 $clone = assQuestion::instantiateQuestionGUI($new_id);
587 $question = $clone->getObject();
588 $question->setObjId($this->getId());
589 $clone->setObject($question);
590 $clone->getObject()->saveToDb();
591
593
594 $copy_count++;
595 }
596 }
597 }
insertQuestion(int $question_id, bool $link_only=false)
Definition: class.ilObjTest.php:1287
References $id, ilObject\$title, ilObject\getId(), getQuestionTitles(), and insertQuestion().
Here is the call 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 240 of file class.ilObjTest.php.
References $id, and ilObject\createMetaData().
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 349 of file class.ilObjTest.php.
349 : void
350 {
352 ilFileUtils::makeDir($tst_data_dir);
353 if (!is_writable($tst_data_dir)) {
356 }
357
358 // create learning module directory (data_dir/lm_data/lm_<id>)
360 ilFileUtils::makeDir($tst_dir);
361 if (!@is_dir($tst_dir)) {
362 $this->ilias->raiseError("Creation of Test Directory failed.", $this->ilias->error_obj->MESSAGE);
363 }
364 // create Export subdirectory (data_dir/lm_data/lm_<id>/Export)
365 $export_dir = $tst_dir . "/export";
366 ilFileUtils::makeDir($export_dir);
367 if (!@is_dir($export_dir)) {
368 $this->ilias->raiseError("Creation of Export Directory failed.", $this->ilias->error_obj->MESSAGE);
369 }
370 }
Class ilObjForumAdministration.
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 2570 of file class.ilObjTest.php.
2570 : ?assQuestionGUI
2571 {
2572 if ((!$question_type) and ($question_id > 0)) {
2573 $question_type = $this->getQuestionType($question_id);
2574 }
2575
2576 if (!strlen($question_type)) {
2577 return null;
2578 }
2579
2580 if ($question_id > 0) {
2581 $question_gui = assQuestion::instantiateQuestionGUI($question_id);
2582 } else {
2583 $question_type_gui = $question_type . 'GUI';
2584 $question_gui = new $question_type_gui();
2585 }
2586
2587 return $question_gui;
2588 }
Definition: class.assQuestionGUI.php:36
getQuestionType($question_id)
Returns the question type of a question with a given id.
Definition: class.ilObjTest.php:1490
Referenced by ILIAS\Test\Results\Data\Factory\buildAttemptResults().
Here is the caller graph for this function:
◆ createTestSequence()
| & ilObjTest::createTestSequence | ( | $active_id, | |
| $pass, | |||
| $shuffle | |||
| ) |
Definition at line 5670 of file class.ilObjTest.php.
5671 {
5672 $this->test_sequence = new ilTestSequence($active_id, $pass, $this->isRandomTest(), $this->questionrepository);
5673 }
isRandomTest()
Returns the fact wether this test is a random questions test or not.
Definition: class.ilObjTest.php:6309
◆ 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 267 of file class.ilObjTest.php.
267 : bool
268 {
269 // always call parent delete function first!!
270 if (!parent::delete()) {
271 return false;
272 }
273
274 // delet meta data
275 $this->deleteMetaData();
276
277 //put here your module specific stuff
278 $this->deleteTest();
279
281 $qsaImportFails->deleteRegisteredImportFails();
283 $sltImportFails->deleteRegisteredImportFails();
284
286 $this->logger->logTestAdministrationInteraction(
287 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
288 $this->getRefId(),
289 $this->user->getId(),
291 [
292 AdditionalInformationGenerator::KEY_TEST_TITLE => $test_title = $this->title
293 ]
294 )
295 );
296 }
297
298 return true;
299 }
References ilObject\deleteMetaData(), deleteTest(), ilObject\getId(), ILIAS\Repository\logger(), and ILIAS\Test\Logging\TEST_DELETED.
Here is the call graph for this function:
◆ deleteTest()
| ilObjTest::deleteTest | ( | ) |
Definition at line 301 of file class.ilObjTest.php.
301 : void
302 {
304 $participantData->load($this->getTestId());
305 $this->removeTestResults($participantData);
306
307 $this->db->manipulateF(
308 "DELETE FROM tst_mark WHERE test_fi = %s",
309 ['integer'],
310 [$this->getTestId()]
311 );
312
313 $this->db->manipulateF(
314 "DELETE FROM tst_tests WHERE test_id = %s",
315 ['integer'],
316 [$this->getTestId()]
317 );
318
319 $this->db->manipulateF(
320 "DELETE FROM tst_test_settings WHERE id = %s",
321 ['integer'],
323 );
324
327 if (is_dir($directory)) {
328 ilFileUtils::delDir($directory);
329 }
331 // remaining usages are not in text anymore -> delete them
332 // and media objects (note: delete method of ilObjMediaObject
333 // checks whether object is used in another context; if yes,
334 // the object is not deleted!)
335 foreach ($mobs as $mob) {
339 $mob_obj->delete();
340 }
341 }
342 }
static _removeUsage(int $a_mob_id, string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Remove usage of mob in another container.
Definition: class.ilObjMediaObject.php:880
removeTestResults(ilTestParticipantData $participant_data)
Definition: class.ilObjTest.php:1090
References ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilFileUtils\delDir(), ilFileUtils\getDataDir(), ilObject\getId(), getMainSettings(), getTestId(), ILIAS\Repository\lng(), 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 5481 of file class.ilObjTest.php.
5481 : bool
5482 {
5484 $fp = fopen($fo_file, "w");
5485 fwrite($fp, $fo);
5486 fclose($fp);
5487
5488 try {
5492 ilUtil::deliverData(
5493 $pdf_base64->scalar,
5495 "application/pdf"
5496 );
5497 return true;
5500 return false;
5501 }
5502 }
static getASCIIFilename(string $a_filename)
Definition: class.ilFileUtils.php:662
static ilTempnam(?string $a_temp_path=null)
Returns a unique and non existing Path for e temporary file or directory.
Definition: class.ilFileUtils.php:676
static factory(string $a_package, int $a_timeout=0)
Creates an ilRpcClient instance to our ilServer.
Definition: class.ilRpcClientFactory.php:33
static deliverData(string $a_data, string $a_filename, string $mime="application/octet-stream")
Definition: class.ilUtil.php:358
References Vendor\Package\$e, $filename, ilUtil\deliverData(), ilRpcClientFactory\factory(), ilFileUtils\getASCIIFilename(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), ilFileUtils\ilTempnam(), and ILIAS\Repository\logger().
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 5445 of file class.ilObjTest.php.
5446 {
5447 $content = preg_replace("/href=\".*?\"/", "", $content);
5448 $printbody = new ilTemplate("tpl.il_as_tst_print_body.html", true, true, "components/ILIAS/Test");
5449 $printbody->setVariable("TITLE", ilLegacyFormElementsUtil::prepareFormOutput($this->getTitle()));
5450 $printbody->setVariable("ADM_CONTENT", $content);
5451 $printbody->setCurrentBlock("css_file");
5453 $printbody->parseCurrentBlock();
5454 $printoutput = $printbody->get();
5455 $html = str_replace("href=\"./", "href=\"" . ILIAS_HTTP_PATH . "/", $printoutput);
5456 $html = preg_replace("/<div id=\"dontprint\">.*?<\\/div>/ims", "", $html);
5457 if (extension_loaded("tidy")) {
5458 $config = [
5459 "indent" => false,
5460 "output-xml" => true,
5462 ];
5463 $tidy = new tidy();
5464 $tidy->parseString($html, $config, 'utf8');
5465 $tidy->cleanRepair();
5466 $html = tidy_get_output($tidy);
5467 $html = preg_replace("/^.*?(<html)/", "\\1", $html);
5468 } else {
5469 $html = str_replace(" ", " ", $html);
5470 $html = str_replace("⊗", "X", $html);
5471 }
5472 $html = preg_replace("/src=\".\\//ims", "src=\"" . ILIAS_HTTP_PATH . "/", $html);
5474 }
static prepareFormOutput($a_str, bool $a_strip=false)
Definition: class.ilLegacyFormElementsUtil.php:37
processPrintoutput2FO($print_output)
Convert a print output to XSL-FO.
Definition: class.ilObjTest.php:5403
deliverPDFfromFO($fo, $title=null)
Delivers a PDF file from a XSL-FO string.
Definition: class.ilObjTest.php:5481
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:31
static getStyleSheetLocation(string $mode="output", string $a_css_name="")
get full style sheet file name (path inclusive) of current user
Definition: class.ilUtil.php:133
References ilUtil\getStyleSheetLocation(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), ilLegacyFormElementsUtil\prepareFormOutput(), and true.
Here is the call graph for this function:
◆ doCreateMetaData()
|
protected |
@inheritDoc
Reimplemented from ilObject.
Definition at line 3835 of file class.ilObjTest.php.
3835 : void
3836 {
3837 $this->saveAuthorToMetadata();
3838 }
saveAuthorToMetadata($author="")
Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be c...
Definition: class.ilObjTest.php:3814
◆ 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 1280 of file class.ilObjTest.php.
1280 : int
1281 {
1282 $question = ilObjTest::_instanciateQuestion($question_id);
1284 return $duplicate_id;
1285 }
static _instanciateQuestion($question_id)
Creates an instance of a question with a given question id.
Definition: class.ilObjTest.php:2596
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 2679 of file class.ilObjTest.php.
2679 : bool
2680 {
2682 $now = time();
2684 return true;
2685 }
2686 }
2687 return false;
2688 }
◆ evalStatistical()
| ilObjTest::evalStatistical | ( | $active_id | ) |
Returns the statistical evaluation of the test for a specified user.
Definition at line 2015 of file class.ilObjTest.php.
2015 : array
2016 {
2017 $pass = ilObjTest::_getResultPass($active_id);
2018 $test_result = &$this->getTestResult($active_id, $pass);
2019 $result = $this->db->queryF(
2020 "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.active_id = %s AND tst_active.active_id = tst_times.active_fi",
2021 ['integer'],
2022 [$active_id]
2023 );
2024 $times = [];
2025 $first_visit = 0;
2026 $last_visit = 0;
2027 while ($row = $this->db->fetchObject($result)) {
2028 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
2029 $epoch_1 = mktime(
2030 (int) $matches[4],
2031 (int) $matches[5],
2032 (int) $matches[6],
2033 (int) $matches[2],
2034 (int) $matches[3],
2035 (int) $matches[1]
2036 );
2037 if (!$first_visit) {
2038 $first_visit = $epoch_1;
2039 }
2040 if ($epoch_1 < $first_visit) {
2041 $first_visit = $epoch_1;
2042 }
2043 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->finished, $matches);
2044 $epoch_2 = mktime(
2045 (int) $matches[4],
2046 (int) $matches[5],
2047 (int) $matches[6],
2048 (int) $matches[2],
2049 (int) $matches[3],
2050 (int) $matches[1]
2051 );
2052 if (!$last_visit) {
2053 $last_visit = $epoch_2;
2054 }
2055 if ($epoch_2 > $last_visit) {
2056 $last_visit = $epoch_2;
2057 }
2058 $times[$row->active_fi] += ($epoch_2 - $epoch_1);
2059 }
2060 $max_time = 0;
2061 foreach ($times as $key => $value) {
2062 $max_time += $value;
2063 }
2064 if ((!$test_result["test"]["total_reached_points"]) or (!$test_result["test"]["total_max_points"])) {
2065 $percentage = 0.0;
2066 } else {
2067 $percentage = ($test_result["test"]["total_reached_points"] / $test_result["test"]["total_max_points"]) * 100.0;
2068 if ($percentage < 0) {
2069 $percentage = 0.0;
2070 }
2071 }
2072 $mark_obj = $this->getMarkSchema()->getMatchingMark($percentage);
2073 $first_date = getdate($first_visit);
2074 $last_date = getdate($last_visit);
2075 $qworkedthrough = 0;
2076 foreach ($test_result as $key => $value) {
2077 if (preg_match("/\d+/", $key)) {
2078 $qworkedthrough += $value["workedthrough"];
2079 }
2080 }
2081 if (!$qworkedthrough) {
2082 $atimeofwork = 0;
2083 } else {
2084 $atimeofwork = $max_time / $qworkedthrough;
2085 }
2086
2087 $result_mark = "";
2088 $passed = "";
2089
2090 if ($mark_obj !== null) {
2091 $result_mark = $mark_obj->getShortName();
2092
2093 if ($mark_obj->getPassed()) {
2094 $passed = 1;
2095 } else {
2096 $passed = 0;
2097 }
2098 }
2099 $percent_worked_through = 0;
2100 if (count($this->questions)) {
2101 $percent_worked_through = $qworkedthrough / count($this->questions);
2102 }
2103 $result_array = [
2104 "qworkedthrough" => $qworkedthrough,
2105 "qmax" => count($this->questions),
2106 "pworkedthrough" => $percent_worked_through,
2107 "timeofwork" => $max_time,
2108 "atimeofwork" => $atimeofwork,
2109 "firstvisit" => $first_date,
2110 "lastvisit" => $last_date,
2111 "resultspoints" => $test_result["test"]["total_reached_points"],
2112 "maxpoints" => $test_result["test"]["total_max_points"],
2113 "resultsmarks" => $result_mark,
2114 "passed" => $passed,
2115 "distancemedian" => "0"
2116 ];
2117 foreach ($test_result as $key => $value) {
2118 if (preg_match("/\d+/", $key)) {
2119 $result_array[$key] = $value;
2120 }
2121 }
2122 return $result_array;
2123 }
static _getResultPass($active_id)
Retrieves the pass number that should be counted for a given user.
Definition: class.ilObjTest.php:4672
getTestResult(int $active_id, ?int $attempt=null, bool $ordered_sequence=false, bool $consider_hidden_questions=true, bool $consider_optional_questions=true)
Calculates the results of a test for a given user and returns an array with all test results.
Definition: class.ilObjTest.php:1717
References _getResultPass().
Here is the call graph for this function:
◆ evalTotalParticipantsArray()
| ilObjTest::evalTotalParticipantsArray | ( | string | $name_sort_order = 'asc' | ) |
Definition at line 2222 of file class.ilObjTest.php.
2222 : array
2223 {
2224 $result = $this->db->queryF(
2225 'SELECT tst_active.user_fi, tst_active.active_id, usr_data.login, '
2226 . 'usr_data.firstname, usr_data.lastname, usr_data.title FROM tst_active '
2227 . 'LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id '
2228 . 'WHERE tst_active.test_fi = %s '
2229 . 'ORDER BY usr_data.lastname ' . strtoupper($name_sort_order),
2230 ['integer'],
2231 [$this->getTestId()]
2232 );
2233 $persons_array = [];
2234 while ($row = $this->db->fetchAssoc($result)) {
2237 } else {
2238 if (strlen($row['firstname'] . $row['lastname'] . $row["title"]) == 0) {
2240 } else {
2242 $persons_array[$row['active_id']] = ['name' => $row['lastname']];
2243 } else {
2244 $persons_array[$row['active_id']] = [
2245 'name' => trim($row['lastname'] . ', ' . $row['firstname']
2246 . ' ' . $row['title']),
2247 'login' => $row['login']
2248 ];
2249 }
2250 }
2251 }
2252 }
2253 return $persons_array;
2254 }
References 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 1863 of file class.ilObjTest.php.
1863 : int
1864 {
1865 $result = $this->db->queryF(
1866 'SELECT COUNT(active_id) total FROM tst_active WHERE test_fi = %s',
1867 ['integer'],
1868 [$this->getTestId()]
1869 );
1870 $row = $this->db->fetchAssoc($result);
1871 return $row['total'];
1872 }
Referenced by saveToDb().
Here is the caller graph for this function:
◆ evalTotalPersonsArray()
| ilObjTest::evalTotalPersonsArray | ( | string | $name_sort_order = 'asc' | ) |
Definition at line 2192 of file class.ilObjTest.php.
2192 : array
2193 {
2194 $result = $this->db->queryF(
2195 "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),
2196 ['integer'],
2197 [$this->getTestId()]
2198 );
2199 $persons_array = [];
2200 while ($row = $this->db->fetchAssoc($result)) {
2201 if ($this->getAccessFilteredParticipantList() && !$this->getAccessFilteredParticipantList()->isActiveIdInList($row["active_id"])) {
2202 continue;
2203 }
2204
2207 } else {
2208 if (strlen($row["firstname"] . $row["lastname"] . $row["title"]) == 0) {
2210 } else {
2212 $persons_array[$row["active_id"]] = $row["lastname"];
2213 } else {
2214 $persons_array[$row["active_id"]] = trim($row["lastname"] . ", " . $row["firstname"] . " " . $row["title"]);
2215 }
2216 }
2217 }
2218 }
2219 return $persons_array;
2220 }
getAccessFilteredParticipantList()
Definition: class.ilObjTest.php:2323
References ANONYMOUS_USER_ID, and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ evalTotalStartedAverageTime()
| ilObjTest::evalTotalStartedAverageTime | ( | ?array | $active_ids_to_filter = null | ) |
Definition at line 2464 of file class.ilObjTest.php.
2464 : int
2465 {
2466 $query = "SELECT tst_times.* FROM tst_active, tst_times WHERE tst_active.test_fi = %s AND tst_active.active_id = tst_times.active_fi";
2467
2468 if ($active_ids_to_filter !== null && $active_ids_to_filter !== []) {
2469 $query .= " AND " . $this->db->in('active_id', $active_ids_to_filter, false, 'integer');
2470 }
2471
2473 $times = [];
2474 while ($row = $this->db->fetchObject($result)) {
2475 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->started, $matches);
2476 $epoch_1 = mktime(
2477 (int) $matches[4],
2478 (int) $matches[5],
2479 (int) $matches[6],
2480 (int) $matches[2],
2481 (int) $matches[3],
2482 (int) $matches[1]
2483 );
2484 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row->finished, $matches);
2485 $epoch_2 = mktime(
2486 (int) $matches[4],
2487 (int) $matches[5],
2488 (int) $matches[6],
2489 (int) $matches[2],
2490 (int) $matches[3],
2491 (int) $matches[1]
2492 );
2493 if (isset($times[$row->active_fi])) {
2494 $times[$row->active_fi] += ($epoch_2 - $epoch_1);
2495 } else {
2496 $times[$row->active_fi] = ($epoch_2 - $epoch_1);
2497 }
2498 }
2499 $max_time = 0;
2500 $counter = 0;
2501 foreach ($times as $value) {
2502 $max_time += $value;
2503 $counter++;
2504 }
2506 return 0;
2507 }
2509 }
References $counter.
◆ exportFileItems()
| ilObjTest::exportFileItems | ( | $target_dir, | |
| & | $expLog | ||
| ) |
export files of file itmes
Definition at line 3747 of file class.ilObjTest.php.
3748 {
3749 foreach ($this->file_ids as $file_id) {
3750 $expLog->write(date("[y-m-d H:i:s] ") . "File Item " . $file_id);
3752 ilFileUtils::makeDir($file_dir);
3754 $source_file = $file_obj->getFile($file_obj->getVersion());
3755 if (!is_file($source_file)) {
3756 $source_file = $file_obj->getFile();
3757 }
3758 if (is_file($source_file)) {
3759 copy($source_file, $file_dir . '/' . $file_obj->getFileName());
3760 }
3761 unset($file_obj);
3762 }
3763 }
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 3625 of file class.ilObjTest.php.
3625 : void
3626 {
3627 $this->mob_ids = [];
3628
3629 // PageObjects
3630 $expLog->write(date("[y-m-d H:i:s] ") . "Start Export Page Objects");
3631 $this->bench->start("ContentObjectExport", "exportPageObjects");
3632 $this->exportXMLPageObjects($a_xml_writer, $a_inst, $expLog);
3633 $this->bench->stop("ContentObjectExport", "exportPageObjects");
3634 $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export Page Objects");
3635
3636 // MediaObjects
3637 $expLog->write(date("[y-m-d H:i:s] ") . "Start Export Media Objects");
3638 $this->bench->start("ContentObjectExport", "exportMediaObjects");
3639 $this->exportXMLMediaObjects($a_xml_writer, $a_inst, $a_target_dir, $expLog);
3640 $this->bench->stop("ContentObjectExport", "exportMediaObjects");
3641 $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export Media Objects");
3642
3643 // FileItems
3644 $expLog->write(date("[y-m-d H:i:s] ") . "Start Export File Items");
3645 $this->bench->start("ContentObjectExport", "exportFileItems");
3646 $this->exportFileItems($a_target_dir, $expLog);
3647 $this->bench->stop("ContentObjectExport", "exportFileItems");
3648 $expLog->write(date("[y-m-d H:i:s] ") . "Finished Export File Items");
3649 }
exportXMLPageObjects(&$a_xml_writer, $inst, &$expLog)
export page objects to xml (see ilias_co.dtd)
Definition: class.ilObjTest.php:3672
exportFileItems($target_dir, &$expLog)
export files of file itmes
Definition: class.ilObjTest.php:3747
exportXMLMediaObjects(&$a_xml_writer, $a_inst, $a_target_dir, &$expLog)
export media objects to xml (see ilias_co.dtd)
Definition: class.ilObjTest.php:3723
◆ exportXMLMediaObjects()
| ilObjTest::exportXMLMediaObjects | ( | & | $a_xml_writer, |
| $a_inst, | |||
| $a_target_dir, | |||
| & | $expLog | ||
| ) |
export media objects to xml (see ilias_co.dtd)
Definition at line 3723 of file class.ilObjTest.php.
3724 {
3725 foreach ($this->mob_ids as $mob_id) {
3726 $expLog->write(date("[y-m-d H:i:s] ") . "Media Object " . $mob_id);
3728 $target_dir = $a_target_dir . DIRECTORY_SEPARATOR . 'objects'
3730 ilFileUtils::createDirectory($target_dir);
3732 $media_obj->exportXML($a_xml_writer, (int) $a_inst);
3733 foreach ($media_obj->getMediaItems() as $item) {
3734 $stream = $item->getLocationStream();
3735 file_put_contents($target_dir . DIRECTORY_SEPARATOR . $item->getLocation(), $stream);
3736 $stream->close();
3737 }
3738 unset($media_obj);
3739 }
3740 }
3741 }
static createDirectory(string $a_dir, int $a_mod=0755)
create directory
Definition: class.ilFileUtils.php:644
References ilObjMediaObject\_exists(), ilFileUtils\createDirectory(), and IL_INST_ID.
Here is the call graph for this function:
◆ exportXMLPageObjects()
| ilObjTest::exportXMLPageObjects | ( | & | $a_xml_writer, |
| $inst, | |||
| & | $expLog | ||
| ) |
export page objects to xml (see ilias_co.dtd)
- Parameters
-
object $a_xml_writer ilXmlWriter object that receives the xml data
Definition at line 3672 of file class.ilObjTest.php.
3673 {
3674 foreach ($this->questions as $question_id) {
3675 $this->bench->start("ContentObjectExport", "exportPageObject");
3676 $expLog->write(date("[y-m-d H:i:s] ") . "Page Object " . $question_id);
3677
3678 $attrs = [];
3679 $a_xml_writer->xmlStartTag("PageObject", $attrs);
3680
3681
3682 // export xml to writer object
3683 $this->bench->start("ContentObjectExport", "exportPageObject_XML");
3685 $page_object->buildDom();
3686 $page_object->insertInstIntoIDs((string) $inst);
3689 $xml = $page_object->getXMLFromDom(false, false, false, "", true);
3690 $xml = str_replace("&", "&", $xml);
3691 $a_xml_writer->appendXML($xml);
3692 $page_object->freeDom();
3693 unset($page_object);
3694
3695 $this->bench->stop("ContentObjectExport", "exportPageObject_XML");
3696
3697 // collect media objects
3698 $this->bench->start("ContentObjectExport", "exportPageObject_CollectMedia");
3699 //$mob_ids = $page_obj->getMediaObjectIDs();
3701 $this->mob_ids[$mob_id] = $mob_id;
3702 }
3703 $this->bench->stop("ContentObjectExport", "exportPageObject_CollectMedia");
3704
3705 // collect all file items
3706 $this->bench->start("ContentObjectExport", "exportPageObject_CollectFileItems");
3707 //$file_ids = $page_obj->getFileItemIds();
3709 $this->file_ids[$file_id] = $file_id;
3710 }
3711 $this->bench->stop("ContentObjectExport", "exportPageObject_CollectFileItems");
3712
3713 $a_xml_writer->xmlEndTag("PageObject");
3714 //unset($page_obj);
3715
3716 $this->bench->stop("ContentObjectExport", "exportPageObject");
3717 }
3718 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAssQuestionPage.php:29
References ilPCFileList\collectFileItems().
Here is the call graph for this function:
◆ fromXML()
| ilObjTest::fromXML | ( | ilQTIAssessment | $assessment, |
| array | $mappings | ||
| ) |
Receives parameters from a QTI parser and creates a valid ILIAS test object.
- Parameters
-
ilQTIAssessment $assessment
Definition at line 2775 of file class.ilObjTest.php.
2775 : void
2776 {
2778
2788
2789 $introduction_settings = $introduction_settings->withIntroductionEnabled(false);
2792 $introduction_settings = $this->addIntroductionToSettingsFromImport(
2793 $introduction_settings,
2794 $this->qtiMaterialToArray($material),
2795 $mappings
2796 );
2797 }
2798 }
2799
2801 && $assessment->getPresentationMaterial()->getFlowMat(0)
2802 && $assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)) {
2803 $finishing_settings = $this->addConcludingRemarksToSettingsFromImport(
2804 $finishing_settings,
2805 $this->qtiMaterialToArray(
2806 $assessment->getPresentationMaterial()->getFlowMat(0)->getMaterial(0)
2807 ),
2808 $mappings
2809 );
2810 }
2811
2817
2818 $mark_steps = [];
2821 case "solution_details":
2822 $result_details_settings = $result_details_settings->withShowPassDetails((bool) $metadata["entry"]);
2823 break;
2824 case "show_solution_list_comparison":
2825 $result_details_settings = $result_details_settings->withShowSolutionListComparison((bool) $metadata["entry"]);
2826 break;
2827 case "print_bs_with_res":
2828 $result_details_settings = $result_details_settings->withShowSolutionListComparison((bool) $metadata["entry"]);
2829 break;
2830 case "author":
2832 break;
2833 case "nr_of_tries":
2834 $test_behaviour_settings = $test_behaviour_settings->withNumberOfTries((int) $metadata["entry"]);
2835 break;
2836 case 'block_after_passed':
2837 $test_behaviour_settings = $test_behaviour_settings->withBlockAfterPassedEnabled((bool) $metadata['entry']);
2838 break;
2839 case "pass_waiting":
2841 break;
2842 case "kiosk":
2844 break;
2845 case 'show_introduction':
2846 $introduction_settings = $introduction_settings->withIntroductionEnabled((bool) $metadata['entry']);
2847 break;
2848 case "showfinalstatement":
2849 case 'show_concluding_remarks':
2850 $finishing_settings = $finishing_settings->withConcludingRemarksEnabled((bool) $metadata["entry"]);
2851 break;
2852 case 'exam_conditions':
2853 $introduction_settings = $introduction_settings->withExamConditionsCheckboxEnabled($metadata['entry'] === '1');
2854 break;
2855 case "highscore_enabled":
2856 $gamification_settings = $gamification_settings->withHighscoreEnabled((bool) $metadata["entry"]);
2857 break;
2858 case "highscore_anon":
2860 break;
2861 case "highscore_achieved_ts":
2862 $gamification_settings = $gamification_settings->withHighscoreAchievedTS((bool) $metadata["entry"]);
2863 break;
2864 case "highscore_score":
2865 $gamification_settings = $gamification_settings->withHighscoreScore((bool) $metadata["entry"]);
2866 break;
2867 case "highscore_percentage":
2868 $gamification_settings = $gamification_settings->withHighscorePercentage((bool) $metadata["entry"]);
2869 break;
2870 case "highscore_wtime":
2871 $gamification_settings = $gamification_settings->withHighscoreWTime((bool) $metadata["entry"]);
2872 break;
2873 case "highscore_own_table":
2874 $gamification_settings = $gamification_settings->withHighscoreOwnTable((bool) $metadata["entry"]);
2875 break;
2876 case "highscore_top_table":
2877 $gamification_settings = $gamification_settings->withHighscoreTopTable((bool) $metadata["entry"]);
2878 break;
2879 case "highscore_top_num":
2880 $gamification_settings = $gamification_settings->withHighscoreTopNum((int) $metadata["entry"]);
2881 break;
2882 case "use_previous_answers":
2883 $participant_functionality_settings = $participant_functionality_settings->withUsePreviousAnswerAllowed((bool) $metadata["entry"]);
2884 break;
2885 case 'question_list_enabled':
2886 $participant_functionality_settings = $participant_functionality_settings->withQuestionListEnabled((bool) $metadata['entry']);
2887 // no break
2888 case "title_output":
2889 $question_behaviour_settings = $question_behaviour_settings->withQuestionTitleOutputMode((int) $metadata["entry"]);
2890 break;
2891 case "question_set_type":
2893 $this->questions = [];
2894 }
2896 break;
2897 case "anonymity":
2899 break;
2900 case "results_presentation":
2901 $result_details_settings = $result_details_settings->withResultsPresentation((int) $metadata["entry"]);
2902 break;
2903 case "reset_processing_time":
2904 $test_behaviour_settings = $test_behaviour_settings->withResetProcessingTime($metadata["entry"] === '1');
2905 break;
2906 case "answer_feedback_points":
2907 $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackPointsEnabled((bool) $metadata["entry"]);
2908 break;
2909 case "answer_feedback":
2910 $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackGenericEnabled((bool) $metadata["entry"]);
2911 break;
2912 case 'instant_feedback_specific':
2913 $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackSpecificEnabled((bool) $metadata['entry']);
2914 break;
2915 case "instant_verification":
2916 $question_behaviour_settings = $question_behaviour_settings->withInstantFeedbackSolutionEnabled((bool) $metadata["entry"]);
2917 break;
2918 case "force_instant_feedback":
2919 $question_behaviour_settings = $question_behaviour_settings->withForceInstantFeedbackOnNextQuestion((bool) $metadata["entry"]);
2920 break;
2921 case "follow_qst_answer_fixation":
2922 $question_behaviour_settings = $question_behaviour_settings->withLockAnswerOnNextQuestionEnabled((bool) $metadata["entry"]);
2923 break;
2924 case "instant_feedback_answer_fixation":
2925 $question_behaviour_settings = $question_behaviour_settings->withLockAnswerOnInstantFeedbackEnabled((bool) $metadata["entry"]);
2926 break;
2927 case "show_cancel":
2928 case "suspend_test_allowed":
2929 $participant_functionality_settings = $participant_functionality_settings->withSuspendTestAllowed((bool) $metadata["entry"]);
2930 break;
2931 case "sequence_settings":
2932 $participant_functionality_settings = $participant_functionality_settings->withPostponedQuestionsMoveToEnd((bool) $metadata["entry"]);
2933 break;
2934 case "show_marker":
2935 $participant_functionality_settings = $participant_functionality_settings->withQuestionMarkingEnabled((bool) $metadata["entry"]);
2936 break;
2937 case "fixed_participants":
2939 break;
2940 case "score_reporting":
2942 $result_summary_settings = $result_summary_settings->withScoreReporting(
2943 ScoreReportingTypes::tryFrom((int) $metadata['entry']) ?? ScoreReportingTypes::SCORE_REPORTING_DISABLED
2944 );
2945 }
2946 break;
2947 case "shuffle_questions":
2948 $question_behaviour_settings = $question_behaviour_settings->withShuffleQuestions((bool) $metadata["entry"]);
2949 break;
2950 case "count_system":
2952 break;
2953 case "exportsettings":
2954 $result_details_settings = $result_details_settings->withExportSettings((int) $metadata["entry"]);
2955 break;
2956 case "score_cutting":
2958 break;
2959 case "password":
2960 $access_settings = $access_settings->withPasswordEnabled(
2963 break;
2964 case 'ip_range_from':
2967 }
2968 break;
2969 case 'ip_range_to':
2972 }
2973 break;
2974 case "pass_scoring":
2976 break;
2977 case 'pass_deletion_allowed':
2978 $result_summary_settings = $result_summary_settings->withPassDeletionAllowed((bool) $metadata["entry"]);
2979 break;
2980 case "usr_pass_overview_mode":
2981 $participant_functionality_settings = $participant_functionality_settings->withUsrPassOverviewMode((int) $metadata["entry"]);
2982 break;
2983 case "question_list":
2984 $participant_functionality_settings = $participant_functionality_settings->withQuestionListEnabled((bool) $metadata["entry"]);
2985 break;
2986
2987 case "reporting_date":
2989 if ($reporting_date !== null) {
2990 $result_summary_settings = $result_summary_settings->withReportingDate($reporting_date);
2991 }
2992 break;
2993 case 'enable_processing_time':
2994 $test_behaviour_settings = $test_behaviour_settings->withProcessingTimeEnabled((bool) $metadata['entry']);
2995 break;
2996 case "processing_time":
2998 break;
2999 case "starting_time":
3001 if ($starting_time !== null) {
3002 $access_settings = $access_settings->withStartTime($starting_time)
3003 ->withStartTimeEnabled(true);
3004 }
3005 break;
3006 case "ending_time":
3008 if ($ending_time !== null) {
3009 $access_settings = $access_settings->withEndTime($ending_time)
3010 ->withStartTimeEnabled(true);
3011 }
3012 break;
3013 case "enable_examview":
3015 break;
3016 case 'redirection_mode':
3017 $finishing_settings = $finishing_settings->withRedirectionMode(
3019 );
3020 break;
3021 case 'redirection_url':
3023 break;
3024 case 'examid_in_test_pass':
3025 $test_behaviour_settings = $test_behaviour_settings->withExamIdInTestAttemptEnabled((bool) $metadata['entry']);
3026 break;
3027 case 'examid_in_test_res':
3028 $result_details_settings = $result_details_settings->withShowExamIdInTestResults((bool) $metadata["entry"]);
3029 break;
3030 case 'skill_service':
3031 $additional_settings = $additional_settings->withSkillsServiceEnabled((bool) $metadata['entry']);
3032 break;
3033 case 'show_grading_status':
3034 $result_summary_settings = $result_summary_settings->withShowGradingStatusEnabled((bool) $metadata["entry"]);
3035 break;
3036 case 'show_grading_mark':
3037 $result_summary_settings = $result_summary_settings->withShowGradingMarkEnabled((bool) $metadata["entry"]);
3038 break;
3039 case 'autosave':
3040 $question_behaviour_settings = $question_behaviour_settings->withAutosaveEnabled((bool) $metadata['entry']);
3041 break;
3042 case 'autosave_ival':
3043 $question_behaviour_settings = $question_behaviour_settings->withAutosaveInterval((int) $metadata['entry']);
3044 break;
3045 case 'show_summary':
3046 $participant_functionality_settings = $participant_functionality_settings->withQuestionListEnabled(($metadata['entry'] & 1) > 0)
3048
3049 // no break
3050 case 'hide_info_tab':
3052 }
3055 preg_match("/<short>(.*?)<\/short>/", $xmlmark, $matches);
3056 $mark_short = $matches[1];
3057 preg_match("/<official>(.*?)<\/official>/", $xmlmark, $matches);
3058 $mark_official = $matches[1];
3059 preg_match("/<percentage>(.*?)<\/percentage>/", $xmlmark, $matches);
3060 $mark_percentage = (float) $matches[1];
3061 preg_match("/<passed>(.*?)<\/passed>/", $xmlmark, $matches);
3062 $mark_passed = (bool) $matches[1];
3064 }
3065 }
3066 $this->mark_schema = $this->getMarkSchema()->withMarkSteps($mark_steps);
3067 $this->saveToDb();
3068 $this->getObjectProperties()->storePropertyTitleAndDescription(
3069 $this->getObjectProperties()->getPropertyTitleAndDescription()
3071 ->withDescription($assessment->getComment())
3072 );
3073 $this->addToNewsOnOnline(false, $this->getObjectProperties()->getPropertyIsOnline()->getIsOnline());
3075 ->withGeneralSettings($general_settings)
3076 ->withIntroductionSettings($introduction_settings)
3077 ->withAccessSettings($access_settings)
3078 ->withParticipantFunctionalitySettings($participant_functionality_settings)
3079 ->withTestBehaviourSettings($test_behaviour_settings)
3080 ->withQuestionBehaviourSettings($question_behaviour_settings)
3081 ->withFinishingSettings($finishing_settings)
3082 ->withAdditionalSettings($additional_settings);
3084 $this->main_settings = $main_settings;
3085
3087 ->withGamificationSettings($gamification_settings)
3088 ->withScoringSettings($scoring_settings)
3089 ->withResultDetailsSettings($result_details_settings)
3090 ->withResultSummarySettings($result_summary_settings);
3092 $this->score_settings = $score_settings;
3093 $this->loadFromDb();
3094 }
A class defining marks for assessment test objects.
Definition: Mark.php:37
withGeneralSettings(SettingsGeneral $settings)
Definition: MainSettings.php:58
getQuestionBehaviourSettings()
Definition: MainSettings.php:101
getTestBehaviourSettings()
Definition: MainSettings.php:89
getAccessSettings()
Definition: MainSettings.php:77
getGeneralSettings()
Definition: MainSettings.php:53
getFinishingSettings()
Definition: MainSettings.php:125
getParticipantFunctionalitySettings()
Definition: MainSettings.php:113
getAdditionalSettings()
Definition: MainSettings.php:137
getIntroductionSettings()
Definition: MainSettings.php:65
getResultDetailsSettings()
Definition: ScoreSettings.php:76
withGamificationSettings(SettingsGamification $settings)
Definition: ScoreSettings.php:93
getGamificationSettings()
Definition: ScoreSettings.php:88
getResultSummarySettings()
Definition: ScoreSettings.php:64
getScoringSettings()
Definition: ScoreSettings.php:52
addToNewsOnOnline(bool $old_online_status, bool $new_online_status)
Definition: class.ilObjTest.php:6595
buildDateTimeImmutableFromPeriod(?string $period)
Definition: class.ilObjTest.php:3597
addConcludingRemarksToSettingsFromImport(SettingsFinishing $settings, array $material, array $mappings)
Definition: class.ilObjTest.php:3119
qtiMaterialToArray($a_material)
Reads an QTI material tag and creates a text string.
Definition: class.ilObjTest.php:5239
addIntroductionToSettingsFromImport(SettingsIntroduction $settings, array $material, array $mappings)
Definition: class.ilObjTest.php:3096
getPresentationMaterial()
Definition: class.ilQTIAssessment.php:106
References $objectives, ILIAS\Test\Settings\MainSettings\MainSettings\getAccessSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getAdditionalSettings(), ilQTIAssessment\getComment(), ILIAS\Test\Settings\MainSettings\MainSettings\getFinishingSettings(), ILIAS\Test\Settings\ScoreReporting\ScoreSettings\getGamificationSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getGeneralSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getIntroductionSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getParticipantFunctionalitySettings(), ilQTIAssessment\getPresentationMaterial(), ILIAS\Test\Settings\MainSettings\MainSettings\getQuestionBehaviourSettings(), ILIAS\Test\Settings\ScoreReporting\ScoreSettings\getResultDetailsSettings(), ILIAS\Test\Settings\ScoreReporting\ScoreSettings\getResultSummarySettings(), ILIAS\Test\Settings\ScoreReporting\ScoreSettings\getScoringSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getTestBehaviourSettings(), ilQTIAssessment\getTitle(), ILIAS\Test\Settings\ScoreReporting\ScoreSettings\withGamificationSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\withGeneralSettings(), and ILIAS\GlobalScreen\Scope\Footer\Factory\withTitle().
Here is the call graph for this function:
◆ getAccessFilteredParticipantList()
| ilObjTest::getAccessFilteredParticipantList | ( | ) |
Definition at line 2323 of file class.ilObjTest.php.
2323 : ?ilTestParticipantList
2324 {
2326 }
ilTestParticipantList $access_filtered_participant_list
Definition: class.ilObjTest.php:143
◆ 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 1628 of file class.ilObjTest.php.
1628 : ?int
1629 {
1632 }
1633
1635 if (is_array($tst_access_code) &&
1637 isset($tst_access_code[$this->getTestId()]) &&
1639 $result = $this->db->queryF(
1640 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s',
1641 ['integer', 'integer', 'text'],
1643 );
1644 } elseif ((string) $anonymous_id !== '') {
1645 $result = $this->db->queryF(
1646 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s',
1647 ['integer', 'integer', 'text'],
1648 [$user_id, $this->test_id, $anonymous_id]
1649 );
1650 } else {
1652 return null;
1653 }
1654 $result = $this->db->queryF(
1655 'SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s',
1656 ['integer', 'integer'],
1657 [$user_id, $this->test_id]
1658 );
1659 }
1660
1661 if ($result->numRows()) {
1662 $row = $this->db->fetchAssoc($result);
1663 return (int) $row['active_id'];
1664 }
1665
1666 return null;
1667 }
References $user_id, ANONYMOUS_USER_ID, ilSession\get(), and ILIAS\Repository\user().
Referenced by loadQuestions(), and ilCourseObjectiveResult\resetTestForUser().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getActiveParticipantList()
| ilObjTest::getActiveParticipantList | ( | ) |
Definition at line 4162 of file class.ilObjTest.php.
4162 : ilTestParticipantList
4163 {
4165 $participant_list->initializeFromDbRows($this->getTestParticipants());
4166
4167 return $participant_list;
4168 }
References ILIAS\Repository\lng(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ getAggregatedResultsData()
| ilObjTest::getAggregatedResultsData | ( | ) |
Definition at line 5817 of file class.ilObjTest.php.
5817 : array
5818 {
5820 $found_participants = $data->getParticipants();
5822 if ($found_participants !== []) {
5823 $results['overview']['tst_stat_result_mark_median'] = $data->getStatistics()->getEvaluationDataOfMedianUser()?->getMark()?->getShortName() ?? '';
5828 $total_finished = $data->getTotalFinishedParticipants();
5831 $this->secondsToHoursMinutesSecondsString(
5833 );
5834 $total_passed = 0;
5835 $total_passed_reached = 0;
5836 $total_passed_max = 0;
5837 $total_passed_time = 0;
5838 foreach ($found_participants as $userdata) {
5839 if ($userdata->getMark()?->getPassed()) {
5840 $total_passed++;
5841 $total_passed_reached += $userdata->getReached();
5842 $total_passed_max += $userdata->getMaxpoints();
5843 $total_passed_time += $userdata->getTimeOnTask();
5844 }
5845 }
5846 $average_passed_reached = $total_passed ? $total_passed_reached / $total_passed : 0;
5847 $average_passed_max = $total_passed ? $total_passed_max / $total_passed : 0;
5848 $average_passed_time = $total_passed ? $total_passed_time / $total_passed : 0;
5850 $results['overview']['tst_eval_total_passed_average_points'] = sprintf('%2.2f', $average_passed_reached)
5851 . ' ' . strtolower('of') . ' ' . sprintf('%2.2f', $average_passed_max);
5854 }
5855
5857 $answered = 0;
5858 $reached = 0;
5859 $max = 0;
5860 foreach ($found_participants as $userdata) {
5861 for ($i = 0; $i <= $userdata->getLastPass(); $i++) {
5862 if (is_object($userdata->getPass($i))) {
5863 $question = $userdata->getPass($i)->getAnsweredQuestionByQuestionId($question_id);
5864 if (is_array($question)) {
5865 $answered++;
5866 $reached += $question['reached'];
5867 $max += $question['points'];
5868 }
5869 }
5870 }
5871 }
5872 $percent = $max ? $reached / $max * 100.0 : 0;
5874 $question_title,
5875 sprintf('%.2f', $answered ? $reached / $answered : 0) . ' ' . strtolower($this->lng->txt('of')) . ' ' . sprintf('%.2f', $answered ? $max / $answered : 0),
5876 sprintf('%.2f', $percent) . '%',
5877 $answered,
5878 sprintf('%.2f', $answered ? $reached / $answered : 0),
5879 sprintf('%.2f', $answered ? $max / $answered : 0),
5880 $percent / 100.0
5881 ];
5882 }
5884 }
evalTotalStartedAverageTime(?array $active_ids_to_filter=null)
Definition: class.ilObjTest.php:2464
getCompleteEvaluationData($filterby='', $filtertext='')
Definition: class.ilObjTest.php:2425
secondsToHoursMinutesSecondsString(int $seconds)
Definition: class.ilObjTest.php:5886
References $data, $results, and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getAllQuestions()
| ilObjTest::getAllQuestions | ( | $pass = null | ) |
Returns all questions of a test in test order.
- Returns
- array An array containing the id's as keys and the database row objects as values @access public
Definition at line 1588 of file class.ilObjTest.php.
1588 : array
1589 {
1592 if ($active_id === null) {
1593 return [];
1594 }
1595 $this->loadQuestions($active_id, $pass);
1596 if (count($this->questions) === 0) {
1597 return [];
1598 }
1599 if (is_null($pass)) {
1600 $pass = self::_getPass($active_id);
1601 }
1602 $result = $this->db->queryF(
1603 "SELECT qpl_questions.* FROM qpl_questions, tst_test_rnd_qst WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id AND tst_test_rnd_qst.active_fi = %s AND tst_test_rnd_qst.pass = %s AND " . $this->db->in('qpl_questions.question_id', $this->questions, false, 'integer'),
1604 ['integer','integer'],
1605 [$active_id, $pass]
1606 );
1607 } else {
1608 if (count($this->questions) === 0) {
1609 return [];
1610 }
1611 $result = $this->db->query("SELECT qpl_questions.* FROM qpl_questions, tst_test_question WHERE tst_test_question.question_fi = qpl_questions.question_id AND " . $this->db->in('qpl_questions.question_id', $this->questions, false, 'integer'));
1612 }
1613 $result_array = [];
1614 while ($row = $this->db->fetchAssoc($result)) {
1615 $result_array[$row["question_id"]] = $row;
1616 }
1617 return $result_array;
1618 }
loadQuestions(int $active_id=0, ?int $pass=null)
Load the test question id's from the database.
Definition: class.ilObjTest.php:630
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:4578
getActiveIdOfUser($user_id="", $anonymous_id="")
Gets the active id of a given user.
Definition: class.ilObjTest.php:1628
References ILIAS\Repository\user().
Here is the call graph for this function:
◆ getAllTestResults()
| ilObjTest::getAllTestResults | ( | $participants | ) |
returns all test results for all participants
- Parameters
-
array $partipants array of user ids
- Returns
- array of fields, see code for column titles
Definition at line 4502 of file class.ilObjTest.php.
4502 : array
4503 {
4504 $results = [];
4505 $row = [
4516 ];
4517 $results[] = $row;
4518 if (count($participants)) {
4519 foreach ($participants as $active_id => $user_rec) {
4520 $mark = '';
4521 $row = [];
4522 $reached_points = 0;
4523 $max_points = 0;
4524 $pass = ilObjTest::_getResultPass($active_id);
4525 // abort if no valid pass can be found
4526 if (!is_int($pass)) {
4527 continue;
4528 }
4529 foreach ($this->questions as $value) {
4530 $question = ilObjTest::_instanciateQuestion($value);
4531 if (is_object($question)) {
4532 $max_points += $question->getMaximumPoints();
4533 $reached_points += $question->getReachedPoints($active_id, $pass);
4534 }
4535 }
4536 if ($max_points > 0) {
4537 $percentvalue = $reached_points / $max_points;
4538 if ($percentvalue < 0) {
4539 $percentvalue = 0.0;
4540 }
4541 } else {
4542 $percentvalue = 0;
4543 }
4544 $mark_obj = $this->getMarkSchema()->getMatchingMark($percentvalue * 100);
4545 $passed = "";
4546 if ($mark_obj !== null) {
4547 $mark = $mark_obj->getOfficialName();
4548 }
4550 $user_rec['firstname'] = "";
4552 }
4553 $results[] = [
4554 "user_id" => $user_rec['usr_id'],
4555 "matriculation" => $user_rec['matriculation'],
4556 "lastname" => $user_rec['lastname'],
4557 "firstname" => $user_rec['firstname'],
4558 "login" => $user_rec['login'],
4559 "reached_points" => $reached_points,
4560 "max_points" => $max_points,
4561 "percent_value" => $percentvalue,
4562 "mark" => $mark,
4563 "passed" => $user_rec['passed'] ? '1' : '0',
4564 ];
4565 }
4566 }
4568 }
References $results, _getResultPass(), _instanciateQuestion(), and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getAnonOnlyParticipantIds()
| ilObjTest::getAnonOnlyParticipantIds | ( | ) |
return int[]
Definition at line 2346 of file class.ilObjTest.php.
2346 : array
2347 {
2349 $list->initializeFromDbRows($this->getTestParticipants());
2351 return $list->getAllUserIds();
2352 }
2353 return $list->getAccessFilteredList(
2354 $this->participant_access_filter->getAnonOnlyParticipantsUserFilter($this->getRefId())
2355 )->getAllUserIds();
2356 }
References ILIAS\Repository\lng(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ getAnonymity()
| ilObjTest::getAnonymity | ( | ) |
Definition at line 5332 of file class.ilObjTest.php.
5332 : bool
5333 {
5335 }
◆ 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 4692 of file class.ilObjTest.php.
4692 : int
4693 {
4695 $this->loadQuestions($active_id, $pass);
4696 }
4697 $workedthrough = 0;
4698 foreach ($this->questions as $value) {
4699 if ($this->questionrepository->lookupResultRecordExist($active_id, $value, $pass)) {
4700 $workedthrough += 1;
4701 }
4702 }
4703 return $workedthrough;
4704 }
◆ getAnswerFeedbackPoints()
| ilObjTest::getAnswerFeedbackPoints | ( | ) |
Definition at line 731 of file class.ilObjTest.php.
731 : bool
732 {
733 return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackPointsEnabled();
734 }
References getMainSettings().
Here is the call graph for this function:
◆ getAuthor()
| ilObjTest::getAuthor | ( | ) |
Gets the authors name of the ilObjTest object.
- Returns
- string The string containing the name of the test author @access public
- See also
- $author
Definition at line 3847 of file class.ilObjTest.php.
3847 : string
3848 {
3849 $path_to_authors = $this->lo_metadata->paths()->authors();
3851 ->allData($path_to_authors);
3852
3853 return $this->lo_metadata->dataHelper()->makePresentableAsList(', ', ...$author_data);
3854 }
References ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ getAutosave()
| ilObjTest::getAutosave | ( | ) |
Definition at line 6162 of file class.ilObjTest.php.
6162 : bool
6163 {
6165 }
Referenced by ILIAS\Test\Results\Data\Factory\buildAttemptResults().
Here is the caller graph for this function:
◆ getAvailableQuestionpools()
| ilObjTest::getAvailableQuestionpools | ( | bool | $use_object_id = false, |
| ?bool | $equal_points = false, |
||
| bool | $could_be_offline = false, |
||
| bool | $show_path = false, |
||
| bool | $with_questioncount = false, |
||
| string | $permission = 'read' |
||
| ) |
Returns the available question pools for the active user.
- Returns
- array The available question pools @access public
Definition at line 2517 of file class.ilObjTest.php.
2524 : array {
2526 $use_object_id,
2527 $equal_points ?? false,
2528 $could_be_offline,
2529 $show_path,
2530 $with_questioncount,
2531 $permission
2532 );
2533 }
static _getAvailableQuestionpools(bool $use_object_id=false, bool $equal_points=false, bool $could_be_offline=false, bool $showPath=false, bool $with_questioncount=false, string $permission='read', int $usr_id=0)
Returns the available question pools for the active user.
Definition: class.ilObjQuestionPool.php:919
◆ getAvailableQuestions()
| ilObjTest::getAvailableQuestions | ( | $arr_filter, | |
$completeonly = 0 |
|||
| ) |
Calculates the available questions for a test.
@access public
Definition at line 2695 of file class.ilObjTest.php.
2695 : array
2696 {
2697 $available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools(true, false, false, false, false));
2698 $available = "";
2699 if (count($available_pools)) {
2700 $available = " AND " . $this->db->in('qpl_questions.obj_fi', $available_pools, false, 'integer');
2701 } else {
2702 return [];
2703 }
2704 if ($completeonly) {
2705 $available .= " AND qpl_questions.complete = " . $this->db->quote("1", 'text');
2706 }
2707
2708 $where = "";
2709 if (is_array($arr_filter)) {
2710 if (array_key_exists('title', $arr_filter) && strlen($arr_filter['title'])) {
2711 $where .= " AND " . $this->db->like('qpl_questions.title', 'text', "%%" . $arr_filter['title'] . "%%");
2712 }
2713 if (array_key_exists('description', $arr_filter) && strlen($arr_filter['description'])) {
2714 $where .= " AND " . $this->db->like('qpl_questions.description', 'text', "%%" . $arr_filter['description'] . "%%");
2715 }
2716 if (array_key_exists('author', $arr_filter) && strlen($arr_filter['author'])) {
2717 $where .= " AND " . $this->db->like('qpl_questions.author', 'text', "%%" . $arr_filter['author'] . "%%");
2718 }
2719 if (array_key_exists('type', $arr_filter) && strlen($arr_filter['type'])) {
2720 $where .= " AND qpl_qst_type.type_tag = " . $this->db->quote($arr_filter['type'], 'text');
2721 }
2722 if (array_key_exists('qpl', $arr_filter) && strlen($arr_filter['qpl'])) {
2723 $where .= " AND " . $this->db->like('object_data.title', 'text', "%%" . $arr_filter['qpl'] . "%%");
2724 }
2725 }
2726
2727 $original_ids = &$this->getExistingQuestions();
2728 $original_clause = " qpl_questions.original_id IS NULL";
2729 if (count($original_ids)) {
2730 $original_clause = " qpl_questions.original_id IS NULL AND " . $this->db->in('qpl_questions.question_id', $original_ids, true, 'integer');
2731 }
2732
2733 $query_result = $this->db->query("
2734 SELECT qpl_questions.*, qpl_questions.tstamp,
2735 qpl_qst_type.type_tag, qpl_qst_type.plugin, qpl_qst_type.plugin_name,
2736 object_data.title parent_title
2737 FROM qpl_questions, qpl_qst_type, object_data
2738 WHERE $original_clause $available
2739 AND object_data.obj_id = qpl_questions.obj_fi
2740 AND qpl_questions.tstamp > 0
2741 AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id
2742 $where
2743 ");
2744 $rows = [];
2745
2746 if ($query_result->numRows()) {
2747 while ($row = $this->db->fetchAssoc($query_result)) {
2748 $row = ilAssQuestionType::completeMissingPluginName($row);
2749
2750 if (!$row['plugin']) {
2752
2753 $rows[] = $row;
2754 continue;
2755 }
2756
2759 continue;
2760 }
2761
2762 $pl = $this->component_factory->getPlugin($plugin->getId());
2763 $row[ 'ttype' ] = $pl->getQuestionTypeTranslation();
2764
2765 $rows[] = $row;
2766 }
2767 }
2768 return $rows;
2769 }
static completeMissingPluginName(array $question_type_data)
Definition: class.ilAssQuestionType.php:104
& getExistingQuestions($pass=null)
Get the id's of the questions which are already part of the test.
Definition: class.ilObjTest.php:1453
References XapiProxy\$plugin, ilObjQuestionPool\_getAvailableQuestionpools(), ilAssQuestionType\completeMissingPluginName(), and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getCompleteEvaluationData()
| ilObjTest::getCompleteEvaluationData | ( | $filterby = '', |
|
$filtertext = '' |
|||
| ) |
Definition at line 2425 of file class.ilObjTest.php.
2425 : ilTestEvaluationData
2426 {
2428 $data->setFilter($filterby, $filtertext);
2430 }
getUnfilteredEvaluationData()
Definition: class.ilObjTest.php:2358
References $data.
Referenced by ILIAS\Test\Results\Data\Factory\retrieveResultData().
Here is the caller graph for this function:
◆ getCompleteManualFeedback()
| ilObjTest::getCompleteManualFeedback | ( | int | $question_id | ) |
Retrieves the manual feedback for a question in a test.
- Parameters
-
integer $question_id Question ID
- Returns
- array The feedback text @access public
Definition at line 5559 of file class.ilObjTest.php.
5559 : array
5560 {
5561 global $DIC;
5563
5564 $feedback = [];
5565 $result = $ilDB->queryF(
5566 "SELECT * FROM tst_manual_fb WHERE question_fi = %s",
5567 ['integer'],
5568 [$question_id]
5569 );
5570
5572 $active = $row['active_fi'];
5573 $pass = $row['pass'];
5574 $question = $row['question_fi'];
5575
5577
5578 $feedback[$active][$pass][$question] = $row;
5579 }
5580
5581 return $feedback;
5582 }
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:228
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 1880 of file class.ilObjTest.php.
1880 : int
1881 {
1882 $result = $this->db->queryF(
1883 "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",
1884 ['integer','integer'],
1886 );
1887 $time = 0;
1888 while ($row = $this->db->fetchAssoc($result)) {
1889 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
1890 $epoch_1 = mktime(
1891 (int) $matches[4],
1892 (int) $matches[5],
1893 (int) $matches[6],
1894 (int) $matches[2],
1895 (int) $matches[3],
1896 (int) $matches[1]
1897 );
1898 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
1899 $epoch_2 = mktime(
1900 (int) $matches[4],
1901 (int) $matches[5],
1902 (int) $matches[6],
1903 (int) $matches[2],
1904 (int) $matches[3],
1905 (int) $matches[1]
1906 );
1907 $time += ($epoch_2 - $epoch_1);
1908 }
1909 return $time;
1910 }
References $user_id.
◆ 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 1972 of file class.ilObjTest.php.
1972 : int
1973 {
1974 $result = $this->db->queryF(
1975 "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",
1976 ['integer','integer'],
1977 [$this->getTestId(), $active_id]
1978 );
1979 $time = 0;
1980 while ($row = $this->db->fetchAssoc($result)) {
1981 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches);
1982 $epoch_1 = mktime(
1983 (int) $matches[4],
1984 (int) $matches[5],
1985 (int) $matches[6],
1986 (int) $matches[2],
1987 (int) $matches[3],
1988 (int) $matches[1]
1989 );
1990 preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["finished"], $matches);
1991 $epoch_2 = mktime(
1992 (int) $matches[4],
1993 (int) $matches[5],
1994 (int) $matches[6],
1995 (int) $matches[2],
1996 (int) $matches[3],
1997 (int) $matches[1]
1998 );
1999 $time += ($epoch_2 - $epoch_1);
2000 }
2001 return $time;
2002 }
◆ 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 1918 of file class.ilObjTest.php.
1918 : array
1919 {
1921 }
& _getCompleteWorkingTimeOfParticipants($test_id)
Returns the complete working time in seconds for all test participants.
Definition: class.ilObjTest.php:1930
◆ getConcludingRemarksPageId()
| ilObjTest::getConcludingRemarksPageId | ( | ) |
Definition at line 6045 of file class.ilObjTest.php.
6045 : int
6046 {
6047 $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
6048 if ($page_id !== null) {
6049 return $page_id;
6050 }
6051
6053 $page_object->setParentId($this->getId());
6054 $new_page_id = $page_object->createPageWithNextId();
6056 ->withConcludingRemarksPageId($new_page_id);
6057 $this->getMainSettingsRepository()->store(
6059 );
6060 return $new_page_id;
6061 }
References ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ getCountSystem()
| ilObjTest::getCountSystem | ( | ) |
Definition at line 746 of file class.ilObjTest.php.
References getScoreSettings().
Here is the call graph for this function:
◆ getDetailedTestResults()
| ilObjTest::getDetailedTestResults | ( | $participants | ) |
returns all test results for all participants
- Parameters
-
array $partipants array of user ids
- Returns
- array of fields, see code for column titles
Definition at line 5692 of file class.ilObjTest.php.
5692 : array
5693 {
5694 $results = [];
5695 if (count($participants)) {
5696 foreach ($participants as $active_id => $user_rec) {
5697 $row = [];
5698 $reached_points = 0;
5699 $max_points = 0;
5700 $pass = ilObjTest::_getResultPass($active_id);
5701 foreach ($this->questions as $value) {
5702 $question = ilObjTest::_instanciateQuestion($value);
5703 if (is_object($question)) {
5704 $max_points += $question->getMaximumPoints();
5705 $reached_points += $question->getReachedPoints($active_id, $pass);
5706 if ($max_points > 0) {
5707 $percentvalue = $reached_points / $max_points;
5708 if ($percentvalue < 0) {
5709 $percentvalue = 0.0;
5710 }
5711 } else {
5712 $percentvalue = 0;
5713 }
5715 $user_rec['firstname'] = "";
5717 }
5718 $results[] = [
5719 "user_id" => $user_rec['usr_id'],
5720 "matriculation" => $user_rec['matriculation'],
5721 "lastname" => $user_rec['lastname'],
5722 "firstname" => $user_rec['firstname'],
5723 "login" => $user_rec['login'],
5724 "question_id" => $question->getId(),
5725 "question_title" => $question->getTitle(),
5726 "reached_points" => $reached_points,
5727 "max_points" => $max_points,
5728 "passed" => $user_rec['passed'] ? '1' : '0',
5729 ];
5730 }
5731 }
5732 }
5733 }
5735 }
References $results, _getResultPass(), _instanciateQuestion(), and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getEnableExamview()
| ilObjTest::getEnableExamview | ( | ) |
Definition at line 6172 of file class.ilObjTest.php.
6172 : bool
6173 {
6175 }
◆ getEnableProcessingTime()
| ilObjTest::getEnableProcessingTime | ( | ) |
Definition at line 889 of file class.ilObjTest.php.
889 : bool
890 {
892 }
References getMainSettings().
Here is the call graph for this function:
◆ getEndingTime()
| ilObjTest::getEndingTime | ( | ) |
Definition at line 915 of file class.ilObjTest.php.
915 : int
916 {
917 $end_time = $this->getMainSettings()->getAccessSettings()->getEndTime();
918 return $end_time !== null ? $end_time->getTimestamp() : 0;
919 }
References getMainSettings().
Here is the call graph for this function:
◆ getExistingQuestions()
| & ilObjTest::getExistingQuestions | ( | $pass = null | ) |
Get the id's of the questions which are already part of the test.
- Returns
- array An array containing the already existing questions @access public
Definition at line 1453 of file class.ilObjTest.php.
1453 : array
1454 {
1455 $existing_questions = [];
1458 if (is_null($pass)) {
1459 $pass = 0;
1460 }
1461 $result = $this->db->queryF(
1462 "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",
1463 ['integer','integer'],
1464 [$active_id, $pass]
1465 );
1466 } else {
1467 $result = $this->db->queryF(
1468 "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",
1469 ['integer'],
1470 [$this->getTestId()]
1471 );
1472 }
1475 continue;
1476 }
1477
1478 array_push($existing_questions, $data->original_id);
1479 }
1480 return $existing_questions;
1481 }
References $data, and ILIAS\Repository\user().
Here is the call graph for this function:
◆ getExportDirectory()
| ilObjTest::getExportDirectory | ( | ) |
Definition at line 372 of file class.ilObjTest.php.
372 : string
373 {
375 return $export_dir;
376 }
References ilFileUtils\getDataDir(), and ilObject\getId().
Here is the call graph for this function:
◆ getExportSettings()
| ilObjTest::getExportSettings | ( | ) |
Definition at line 5904 of file class.ilObjTest.php.
5904 : int
5905 {
5907 }
◆ getExtraTime()
|
private |
Definition at line 6211 of file class.ilObjTest.php.
6211 : int
6212 {
6213 if ($active_id === 0) {
6214 return 0;
6215 }
6216 return $this->participant_repository
6217 ->getParticipantByActiveId($this->getTestId(), $active_id)
6218 ?->getExtraTime() ?? 0;
6219 }
Referenced by getProcessingTimeInSeconds().
Here is the caller graph for this function:
◆ getFinalStatement()
| ilObjTest::getFinalStatement | ( | ) |
Definition at line 687 of file class.ilObjTest.php.
687 : string
688 {
689 $page_id = $this->getMainSettings()->getFinishingSettings()->getConcludingRemarksPageId();
690 return $page_id !== null
692 : '';
693 }
@ilCtrl_Calls ilTestPageGUI: ilPageEditorGUI, ilEditClipboardGUI, ilMDEditorGUI @ilCtrl_Calls ilTestP...
Definition: class.ilTestPageGUI.php:28
References getMainSettings().
Here is the call graph for this function:
◆ getFixedParticipants()
| ilObjTest::getFixedParticipants | ( | ) |
Definition at line 5347 of file class.ilObjTest.php.
5347 : bool
5348 {
5350 }
◆ getFixedQuestionSetTotalPoints()
| ilObjTest::getFixedQuestionSetTotalPoints | ( | ) |
Definition at line 4998 of file class.ilObjTest.php.
4998 : float
4999 {
5000 $points = 0;
5001
5003 $points += $question_data['points'];
5004 }
5005
5006 return $points;
5007 }
◆ getGeneralQuestionPropertiesRepository()
| ilObjTest::getGeneralQuestionPropertiesRepository | ( | ) |
Definition at line 6557 of file class.ilObjTest.php.
6558 {
6560 }
Definition: GeneralQuestionPropertiesRepository.php:24
GeneralQuestionPropertiesRepository $questionrepository
Definition: class.ilObjTest.php:78
◆ getGenericAnswerFeedback()
| ilObjTest::getGenericAnswerFeedback | ( | ) |
Definition at line 736 of file class.ilObjTest.php.
736 : bool
737 {
738 return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackGenericEnabled();
739 }
References getMainSettings().
Here is the call graph for this function:
◆ getGlobalSettings()
| ilObjTest::getGlobalSettings | ( | ) |
Definition at line 6562 of file class.ilObjTest.php.
6562 : GlobalTestSettings
6563 {
6564 return $this->global_settings_repo->getGlobalSettings();
6565 }
◆ getGroupData()
| ilObjTest::getGroupData | ( | $ids | ) |
Definition at line 4352 of file class.ilObjTest.php.
4352 : array
4353 {
4354 if (!is_array($ids) || count($ids) == 0) {
4355 return [];
4356 }
4357 $result = [];
4360 $result[$ref_id] = ["ref_id" => $ref_id, "title" => ilObject::_lookupTitle($obj_id), "description" => ilObject::_lookupDescription($obj_id)];
4361 }
4362 return $result;
4363 }
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 6098 of file class.ilObjTest.php.
6098 : bool
6099 {
6101 }
◆ 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 6077 of file class.ilObjTest.php.
6077 : bool
6078 {
6080 }
◆ getHighscoreEnabled()
| ilObjTest::getHighscoreEnabled | ( | ) |
Definition at line 6063 of file class.ilObjTest.php.
6063 : bool
6064 {
6066 }
◆ getHighscoreMode()
| ilObjTest::getHighscoreMode | ( | ) |
Definition at line 6152 of file class.ilObjTest.php.
6152 : int
6153 {
6155 }
◆ getHighscoreOwnTable()
| ilObjTest::getHighscoreOwnTable | ( | ) |
Gets if the own rankings table should be shown.
Definition at line 6130 of file class.ilObjTest.php.
6130 : bool
6131 {
6133 }
◆ getHighscorePercentage()
| ilObjTest::getHighscorePercentage | ( | ) |
Gets if the percentage column should be shown.
Definition at line 6114 of file class.ilObjTest.php.
6114 : bool
6115 {
6117 }
◆ getHighscoreScore()
| ilObjTest::getHighscoreScore | ( | ) |
Gets if the score column should be shown.
Definition at line 6106 of file class.ilObjTest.php.
6106 : bool
6107 {
6109 }
◆ 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 6147 of file class.ilObjTest.php.
6147 : int
6148 {
6150 }
Referenced by ILIAS\Test\Results\Toplist\TestTopListRepository\getGeneralToplist(), ILIAS\Test\Results\Toplist\TestTopListRepository\getUserToplistByPercentage(), and ILIAS\Test\Results\Toplist\TestTopListRepository\getUserToplistByWorkingtime().
Here is the caller graph for this function:
◆ getHighscoreTopTable()
| ilObjTest::getHighscoreTopTable | ( | ) |
Gets, if the top-rankings table should be shown.
Definition at line 6138 of file class.ilObjTest.php.
6138 : bool
6139 {
6141 }
◆ getHighscoreWTime()
| ilObjTest::getHighscoreWTime | ( | ) |
Gets if the column with the workingtime should be shown.
Definition at line 6122 of file class.ilObjTest.php.
6122 : bool
6123 {
6125 }
◆ getHtmlQuestionContentPurifier()
|
protected |
- Returns
- ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier
Definition at line 6552 of file class.ilObjTest.php.
6552 : ilHtmlPurifierInterface
6553 {
6555 }
static getInstanceByType(string $type)
Definition: class.ilHtmlPurifierFactory.php:27
Interface for html sanitizing functionality.
Definition: interface.ilHtmlPurifierInterface.php:26
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 2541 of file class.ilObjTest.php.
2541 : string
2542 {
2544 }
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 2552 of file class.ilObjTest.php.
2553 {
2554 $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/" . $this->getId() . "/images/";
2555 return str_replace(
2556 ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
2557 ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
2558 $webdir
2559 );
2560 }
static removeTrailingPathSeparators(string $path)
Definition: class.ilFileUtils.php:796
References CLIENT_WEB_DIR, ILIAS\Survey\Mode\getId(), and ilFileUtils\removeTrailingPathSeparators().
Here is the call graph for this function:
◆ getImportMapping()
| ilObjTest::getImportMapping | ( | ) |
get array of (two) new created questions for import id
Definition at line 3769 of file class.ilObjTest.php.
3769 : array
3770 {
3771 return [];
3772 }
◆ getInstantFeedbackSolution()
| ilObjTest::getInstantFeedbackSolution | ( | ) |
Definition at line 741 of file class.ilObjTest.php.
741 : bool
742 {
743 return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackSolutionEnabled();
744 }
References getMainSettings().
Here is the call graph for this function:
◆ getIntroduction()
| ilObjTest::getIntroduction | ( | ) |
Definition at line 670 of file class.ilObjTest.php.
670 : string
671 {
672 $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
673 return $page_id !== null
675 : '';
676 }
References getMainSettings().
Here is the call graph for this function:
◆ getIntroductionPageId()
| ilObjTest::getIntroductionPageId | ( | ) |
Definition at line 6027 of file class.ilObjTest.php.
6027 : int
6028 {
6029 $page_id = $this->getMainSettings()->getIntroductionSettings()->getIntroductionPageId();
6030 if ($page_id !== null) {
6031 return $page_id;
6032 }
6033
6035 $page_object->setParentId($this->getId());
6036 $new_page_id = $page_object->createPageWithNextId();
6038 ->withIntroductionPageId($new_page_id);
6039 $this->getMainSettingsRepository()->store(
6041 );
6042 return $new_page_id;
6043 }
References ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ getInvitedUsers()
| & ilObjTest::getInvitedUsers | ( | int | $user_id = 0, |
$order = "login, lastname, firstname" |
|||
| ) |
Returns a list of all invited users in a test.
- Returns
- array array of invited users @access public
Definition at line 4176 of file class.ilObjTest.php.
4176 : array
4177 {
4178 $result_array = [];
4179
4182 $result = $this->db->queryF(
4183 "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, " .
4184 "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 " .
4185 "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
4186 "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
4187 "ORDER BY $order",
4188 ['text', 'text', 'text', 'integer', 'integer'],
4190 );
4191 } else {
4192 $result = $this->db->queryF(
4193 "SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, " .
4194 "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 " .
4195 "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
4196 "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
4197 "ORDER BY $order",
4198 ['text', 'text', 'text', 'integer'],
4200 );
4201 }
4202 } else {
4204 $result = $this->db->queryF(
4205 "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, " .
4206 "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 " .
4207 "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
4208 "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
4209 "ORDER BY $order",
4210 ['integer', 'integer'],
4212 );
4213 } else {
4214 $result = $this->db->queryF(
4215 "SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, " .
4216 "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 " .
4217 "LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
4218 "WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
4219 "ORDER BY $order",
4220 ['integer'],
4221 [$this->getTestId()]
4222 );
4223 }
4224 }
4225 $result_array = [];
4226 while ($row = $this->db->fetchAssoc($result)) {
4227 $result_array[$row['usr_id']] = $row;
4228 }
4229 return $result_array;
4230 }
References $user_id, 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 5665 of file class.ilObjTest.php.
5665 : bool
5666 {
5667 return true;
5668 }
◆ getKioskMode()
| ilObjTest::getKioskMode | ( | ) |
Definition at line 826 of file class.ilObjTest.php.
826 : bool
827 {
829 }
References getMainSettings().
Here is the call graph for this function:
◆ getListOfQuestions()
| ilObjTest::getListOfQuestions | ( | ) |
Definition at line 5063 of file class.ilObjTest.php.
5063 : bool
5064 {
5065 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getQuestionListEnabled();
5066 }
◆ getListOfQuestionsDescription()
| ilObjTest::getListOfQuestionsDescription | ( | ) |
Definition at line 5083 of file class.ilObjTest.php.
5083 : bool
5084 {
5085 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShowDescriptionInQuestionList();
5086 }
◆ getListOfQuestionsEnd()
| ilObjTest::getListOfQuestionsEnd | ( | ) |
Definition at line 5078 of file class.ilObjTest.php.
5078 : bool
5079 {
5080 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShownQuestionListAtEnd();
5081 }
◆ getListOfQuestionsSettings()
| ilObjTest::getListOfQuestionsSettings | ( | ) |
Returns the settings for the list of questions options in the test properties This could contain one of the following values: 0 = No list of questions offered 1 = A list of questions is offered 3 = A list of questions is offered and the list of questions is shown as first page of the test 5 = A list of questions is offered and the list of questions is shown as last page of the test 7 = A list of questions is offered and the list of questions is shown as first and last page of the test.
- Returns
- integer
Definition at line 5058 of file class.ilObjTest.php.
5059 {
5060 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsrPassOverviewMode();
5061 }
◆ getListOfQuestionsStart()
| ilObjTest::getListOfQuestionsStart | ( | ) |
Definition at line 5073 of file class.ilObjTest.php.
5073 : bool
5074 {
5075 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getShownQuestionListAtBeginning();
5076 }
◆ getLocalDIC()
| ilObjTest::getLocalDIC | ( | ) |
Definition at line 202 of file class.ilObjTest.php.
◆ getMainSettings()
| ilObjTest::getMainSettings | ( | ) |
Definition at line 6567 of file class.ilObjTest.php.
6567 : MainSettings
6568 {
6569 if (!$this->main_settings) {
6570 $this->main_settings = $this->getMainSettingsRepository()
6571 ->getFor($this->getTestId());
6572 }
6574 }
Referenced by cloneConcludingRemarks(), cloneIntroduction(), deleteTest(), getAnswerFeedbackPoints(), getEnableProcessingTime(), getEndingTime(), getFinalStatement(), getGenericAnswerFeedback(), getInstantFeedbackSolution(), getIntroduction(), getKioskMode(), getNrOfTries(), getPassword(), getProcessingTime(), getProcessingTimeForXML(), getProcessingTimeInSeconds(), getResetProcessingTime(), getShowKioskModeParticipant(), getShowKioskModeTitle(), getStartingTime(), getTitleOutput(), getUsePreviousAnswers(), isBlockPassesAfterPassedEnabled(), isEndingTimeEnabled(), isPasswordEnabled(), isPostponingEnabled(), and isStartingTimeEnabled().
Here is the caller graph for this function:
◆ getMainSettingsRepository()
| ilObjTest::getMainSettingsRepository | ( | ) |
Definition at line 6576 of file class.ilObjTest.php.
6576 : MainSettingsRepository
6577 {
6579 }
MainSettingsRepository $main_settings_repository
Definition: class.ilObjTest.php:128
Referenced by saveToDb().
Here is the caller graph for this function:
◆ getManualFeedback()
|
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 5513 of file class.ilObjTest.php.
5513 : string
5514 {
5515 if ($pass === null) {
5516 return '';
5517 }
5518 $feedback = '';
5520
5521 if ($row !== [] && ($row['finalized_evaluation'] || \ilTestService::isManScoringDone((int) $active_id))) {
5522 $feedback = $row['feedback'] ?? '';
5523 }
5524
5525 return $feedback;
5526 }
static getSingleManualFeedback(int $active_id, int $question_id, int $pass)
Definition: class.ilObjTest.php:5528
static isManScoringDone(int $active_id)
Definition: class.ilTestService.php:118
References ilTestService\isManScoringDone().
Referenced by assQuestionGUI\getGenericFeedbackOutput().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getMarkSchema()
| ilObjTest::getMarkSchema | ( | ) |
Definition at line 801 of file class.ilObjTest.php.
801 : MarkSchema
802 {
803 if ($this->mark_schema === null) {
804 $this->mark_schema = $this->marks_repository->getMarkSchemaFor($this->getTestId());
805 }
806
808 }
A class defining mark schemas for assessment test objects.
Definition: MarkSchema.php:37
References $mark_schema, and getTestId().
Referenced by ILIAS\Test\Scoring\Marks\MarkSchemaGUI\__construct(), isComplete(), and saveToDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getMaxPassOfTest()
| ilObjTest::getMaxPassOfTest | ( | ) |
Definition at line 6221 of file class.ilObjTest.php.
6221 : int
6222 {
6223 $query = '
6224 SELECT MAX(tst_pass_result.pass) + 1 max_res
6225 FROM tst_pass_result
6226 INNER JOIN tst_active ON tst_active.active_id = tst_pass_result.active_fi
6228 ';
6229 $res = $this->db->query($query);
6232 }
◆ getNrOfResultsForPass()
| ilObjTest::getNrOfResultsForPass | ( | $active_id, | |
| $pass | |||
| ) |
Calculates the number of user results for a specific test pass.
Definition at line 602 of file class.ilObjTest.php.
602 : int
603 {
604 $result = $this->db->queryF(
605 "SELECT test_result_id FROM tst_test_result WHERE active_fi = %s AND pass = %s",
606 ['integer','integer'],
607 [$active_id, $pass]
608 );
609 return $result->numRows();
610 }
◆ getNrOfTries()
| ilObjTest::getNrOfTries | ( | ) |
Definition at line 816 of file class.ilObjTest.php.
816 : int
817 {
819 }
References getMainSettings().
Referenced by saveToDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getParticipants()
| ilObjTest::getParticipants | ( | ) |
Returns all persons who started the test.
- Returns
- array The active ids, names and logins of the persons who started the test
Definition at line 2155 of file class.ilObjTest.php.
2155 : array
2156 {
2157 $result = $this->db->queryF(
2158 "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",
2159 ['integer'],
2160 [$this->getTestId()]
2161 );
2162 $persons_array = [];
2163 while ($row = $this->db->fetchAssoc($result)) {
2166 $login = "";
2168 if (strlen($row["firstname"] . $row["lastname"] . $row["title"]) == 0) {
2172 } else {
2173 $login = $row["login"];
2177 } else {
2178 $name = trim($row["lastname"] . ", " . $row["firstname"] . " " . $row["title"]);
2179 $fullname = trim($row["title"] . " " . $row["firstname"] . " " . $row["lastname"]);
2180 }
2181 }
2182 }
2183 $persons_array[$row["active_id"]] = [
2184 "name" => $name,
2185 "fullname" => $fullname,
2186 "login" => $login
2187 ];
2188 }
2189 return $persons_array;
2190 }
References ANONYMOUS_USER_ID, and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getParticipantsForTestAndQuestion()
| ilObjTest::getParticipantsForTestAndQuestion | ( | $test_id, | |
| $question_id | |||
| ) |
Creates an associated array with all active id's for a given test and original question id.
@noinspection PhpAssignmentInConditionInspection
Definition at line 5785 of file class.ilObjTest.php.
5785 : array
5786 {
5787 $query = "
5788 SELECT tst_test_result.active_fi, tst_test_result.question_fi, tst_test_result.pass
5789 FROM tst_test_result
5790 INNER JOIN tst_active ON tst_active.active_id = tst_test_result.active_fi AND tst_active.test_fi = %s
5791 INNER JOIN qpl_questions ON qpl_questions.question_id = tst_test_result.question_fi
5792 LEFT JOIN usr_data ON usr_data.usr_id = tst_active.user_fi
5793 WHERE tst_test_result.question_fi = %s
5794 ORDER BY usr_data.lastname ASC, usr_data.firstname ASC
5795 ";
5796
5797 $result = $this->db->queryF(
5798 $query,
5799 ['integer', 'integer'],
5800 [$test_id, $question_id]
5801 );
5802 $foundusers = [];
5804 while ($row = $this->db->fetchAssoc($result)) {
5805 if ($this->getAccessFilteredParticipantList() && !$this->getAccessFilteredParticipantList()->isActiveIdInList($row["active_fi"])) {
5806 continue;
5807 }
5808
5809 if (!array_key_exists($row["active_fi"], $foundusers)) {
5810 $foundusers[$row["active_fi"]] = [];
5811 }
5812 array_push($foundusers[$row["active_fi"]], ["pass" => $row["pass"], "qid" => $row["question_fi"]]);
5813 }
5814 return $foundusers;
5815 }
◆ getPassScoring()
| ilObjTest::getPassScoring | ( | ) |
Gets the pass scoring type.
Definition at line 780 of file class.ilObjTest.php.
References getScoreSettings().
Here is the call graph for this function:
◆ getPassword()
| ilObjTest::getPassword | ( | ) |
Definition at line 926 of file class.ilObjTest.php.
References getMainSettings().
Here is the call graph for this function:
◆ getPotentialRandomTestQuestions()
| ilObjTest::getPotentialRandomTestQuestions | ( | ) |
- Returns
- array
Definition at line 5012 of file class.ilObjTest.php.
5012 : array
5013 {
5014 $query = "
5015 SELECT questions.*,
5016 questtypes.type_tag,
5017 origquest.obj_fi orig_obj_fi
5018
5019 FROM qpl_questions questions
5020
5021 INNER JOIN qpl_qst_type questtypes
5022 ON questtypes.question_type_id = questions.question_type_fi
5023
5024 INNER JOIN tst_rnd_cpy tstquest
5025 ON tstquest.qst_fi = questions.question_id
5026
5027 LEFT JOIN qpl_questions origquest
5028 ON origquest.question_id = questions.original_id
5029
5030 WHERE tstquest.tst_fi = %s
5031 ";
5032
5033 $query_result = $this->db->queryF(
5034 $query,
5035 ['integer'],
5036 [$this->getTestId()]
5037 );
5038
5039 return $this->db->fetchAll($query_result);
5040 }
◆ getProcessingTime()
| ilObjTest::getProcessingTime | ( | ) |
Definition at line 855 of file class.ilObjTest.php.
855 : ?string
856 {
858 }
References getMainSettings().
Here is the call graph for this function:
◆ getProcessingTimeForXML()
|
private |
Definition at line 860 of file class.ilObjTest.php.
860 : string
861 {
862 $processing_time = $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTime();
863 if ($processing_time === null
864 || $processing_time === ''
865 || !preg_match('/(\d{2}):(\d{2}):(\d{2})/is', $processing_time, $matches)
866 ) {
867 return '';
868 }
869
870 return sprintf(
871 "P0Y0M0DT%dH%dM%dS",
872 $matches[1],
873 $matches[2],
874 $matches[3]
875 );
876 }
References getMainSettings().
Here is the call graph for this function:
◆ getProcessingTimeInSeconds()
| ilObjTest::getProcessingTimeInSeconds | ( | int | $active_id = 0 | ) |
Definition at line 878 of file class.ilObjTest.php.
878 : int
879 {
880 $processing_time = $this->getMainSettings()->getTestBehaviourSettings()->getProcessingTime() ?? '';
881 if (preg_match("/(\d{2}):(\d{2}):(\d{2})/", (string) $processing_time, $matches)) {
882 $extratime = $this->getExtraTime($active_id) * 60;
883 return ($matches[1] * 3600) + ($matches[2] * 60) + $matches[3] + $extratime;
884 } else {
885 return 0;
886 }
887 }
References getExtraTime(), and getMainSettings().
Here is the call graph for this function:
◆ getQuestionCount()
| ilObjTest::getQuestionCount | ( | ) |
Definition at line 3988 of file class.ilObjTest.php.
3988 : int
3989 {
3990 $num = 0;
3991
3994 $this->tree,
3995 $this->db,
3996 $this->lng,
3997 $this->logger,
3998 $this->component_repository,
3999 $this,
4000 $this->questionrepository
4001 );
4002
4003 $questionSetConfig->loadFromDb();
4004
4005 if ($questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
4007 $this->db,
4008 $this,
4010 );
4011
4012 $sourcePoolDefinitionList->loadDefinitions();
4013
4014 if (is_int($sourcePoolDefinitionList->getQuestionAmount())) {
4015 $num = $sourcePoolDefinitionList->getQuestionAmount();
4016 }
4017 } elseif (is_int($questionSetConfig->getQuestionAmountPerTest())) {
4018 $num = $questionSetConfig->getQuestionAmountPerTest();
4019 }
4020 } else {
4021 $this->loadQuestions();
4022 $num = count($this->questions);
4023 }
4024
4025 return $num;
4026 }
References ILIAS\Repository\lng(), and ILIAS\Repository\logger().
Here is the call graph for this function:
◆ getQuestionCountAndPointsForPassOfParticipant()
| ilObjTest::getQuestionCountAndPointsForPassOfParticipant | ( | int | $active_id, |
| int | $pass | ||
| ) |
Definition at line 2364 of file class.ilObjTest.php.
2364 : array
2365 {
2366 $question_set_type = $this->lookupQuestionSetTypeByActiveId($active_id);
2367
2368 switch ($question_set_type) {
2370 $res = $this->db->queryF(
2371 "
2372 SELECT tst_test_rnd_qst.pass,
2373 COUNT(tst_test_rnd_qst.question_fi) qcount,
2374 SUM(qpl_questions.points) qsum
2375
2376 FROM tst_test_rnd_qst,
2377 qpl_questions
2378
2379 WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id
2380 AND tst_test_rnd_qst.active_fi = %s
2381 AND pass = %s
2382
2383 GROUP BY tst_test_rnd_qst.active_fi,
2384 tst_test_rnd_qst.pass
2385 ",
2386 ['integer', 'integer'],
2387 [$active_id, $pass]
2388 );
2389 break;
2390
2392 $res = $this->db->queryF(
2393 "
2394 SELECT COUNT(tst_test_question.question_fi) qcount,
2395 SUM(qpl_questions.points) qsum
2396
2397 FROM tst_test_question,
2398 qpl_questions,
2399 tst_active
2400
2401 WHERE tst_test_question.question_fi = qpl_questions.question_id
2402 AND tst_test_question.test_fi = tst_active.test_fi
2403 AND tst_active.active_id = %s
2404
2405 GROUP BY tst_test_question.test_fi
2406 ",
2407 ['integer'],
2408 [$active_id]
2409 );
2410 break;
2411
2412 default:
2414 }
2415
2416 $row = $this->db->fetchAssoc($res);
2417
2418 if (is_array($row)) {
2419 return ["count" => $row["qcount"], "points" => $row["qsum"]];
2420 }
2421
2422 return ["count" => 0, "points" => 0];
2423 }
lookupQuestionSetTypeByActiveId(int $active_id)
Definition: class.ilObjTest.php:5352
Base Exception for all Exceptions relating to Modules/Test.
Definition: class.ilTestException.php:30
References $res, QUESTION_SET_TYPE_FIXED, and QUESTION_SET_TYPE_RANDOM.
◆ getQuestionCountWithoutReloading()
| ilObjTest::getQuestionCountWithoutReloading | ( | ) |
Definition at line 4028 of file class.ilObjTest.php.
4028 : int
4029 {
4032 }
4033 return count($this->questions);
4034 }
◆ 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 1436 of file class.ilObjTest.php.
1436 : object
1437 {
1438 $result = $this->db->queryF(
1439 "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",
1440 ['integer'],
1441 [$question_id]
1442 );
1443 $row = $this->db->fetchObject($result);
1444 return $row;
1445 }
Referenced by ilTestArchiver\handInParticipantUploadedResults().
Here is the caller graph for this function:
◆ getQuestions()
| ilObjTest::getQuestions | ( | ) |
Definition at line 6017 of file class.ilObjTest.php.
6017 : array
6018 {
6020 }
◆ getQuestionSetConfig()
| ilObjTest::getQuestionSetConfig | ( | ) |
Definition at line 217 of file class.ilObjTest.php.
217 : ilTestQuestionSetConfig
218 {
219 return $this->question_set_config_factory->getQuestionSetConfig();
220 }
Referenced by ILIAS\Test\Questions\Properties\DatabaseRepository\buildQuestionPropertiesForRandomTest().
Here is the caller graph for this function:
◆ getQuestionSetType()
| ilObjTest::getQuestionSetType | ( | ) |
Definition at line 6289 of file class.ilObjTest.php.
6289 : string
6290 {
6292 }
Referenced by saveToDb().
Here is the caller graph for this function:
◆ getQuestionSetTypeTranslation()
| ilObjTest::getQuestionSetTypeTranslation | ( | ilLanguage | $lng, |
| $questionSetType | |||
| ) |
Definition at line 6314 of file class.ilObjTest.php.
6314 : string
6315 {
6316 switch ($questionSetType) {
6319
6322 }
6323
6325 }
txt(string $a_topic, string $a_default_lang_fallback_mod="")
gets the text for a given topic if the topic is not in the list, the topic itself with "-" will be re...
Definition: class.ilLanguage.php:170
References $lng, QUESTION_SET_TYPE_FIXED, and QUESTION_SET_TYPE_RANDOM.
◆ getQuestionsOfPass()
| ilObjTest::getQuestionsOfPass | ( | int | $active_id, |
| int | $pass | ||
| ) |
Definition at line 2289 of file class.ilObjTest.php.
2289 : array
2290 {
2292 $this->db->setLimit($this->getQuestionCount(), 0);
2293 $result = $this->db->queryF(
2294 'SELECT tst_test_rnd_qst.sequence, tst_test_rnd_qst.question_fi, '
2295 . 'qpl_questions.points '
2296 . 'FROM tst_test_rnd_qst, qpl_questions '
2297 . 'WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id '
2298 . 'AND tst_test_rnd_qst.active_fi = %s AND tst_test_rnd_qst.pass = %s '
2299 . 'ORDER BY tst_test_rnd_qst.sequence',
2300 ['integer', 'integer'],
2301 [$active_id, $pass]
2302 );
2303 } else {
2304 $result = $this->db->queryF(
2305 'SELECT tst_test_question.sequence, tst_test_question.question_fi, '
2306 . 'qpl_questions.points '
2307 . 'FROM tst_test_question, tst_active, qpl_questions '
2308 . 'WHERE tst_test_question.question_fi = qpl_questions.question_id '
2309 . 'AND tst_active.active_id = %s AND tst_active.test_fi = tst_test_question.test_fi',
2310 ['integer'],
2311 [$active_id]
2312 );
2313 }
2314 $qpass = [];
2315 if ($result->numRows()) {
2316 while ($row = $this->db->fetchAssoc($result)) {
2317 array_push($qpass, $row);
2318 }
2319 }
2320 return $qpass;
2321 }
◆ getQuestionsOfTest()
| ilObjTest::getQuestionsOfTest | ( | int | $active_id | ) |
Definition at line 2256 of file class.ilObjTest.php.
2256 : array
2257 {
2259 $this->db->setLimit($this->getQuestionCount(), 0);
2260 $result = $this->db->queryF(
2261 'SELECT tst_test_rnd_qst.sequence, tst_test_rnd_qst.question_fi, '
2262 . 'tst_test_rnd_qst.pass, qpl_questions.points '
2263 . 'FROM tst_test_rnd_qst, qpl_questions '
2264 . 'WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id '
2265 . 'AND tst_test_rnd_qst.active_fi = %s ORDER BY tst_test_rnd_qst.sequence',
2266 ['integer'],
2267 [$active_id]
2268 );
2269 } else {
2270 $result = $this->db->queryF(
2271 'SELECT tst_test_question.sequence, tst_test_question.question_fi, '
2272 . 'qpl_questions.points '
2273 . 'FROM tst_test_question, tst_active, qpl_questions '
2274 . 'WHERE tst_test_question.question_fi = qpl_questions.question_id '
2275 . 'AND tst_active.active_id = %s AND tst_active.test_fi = tst_test_question.test_fi',
2276 ['integer'],
2277 [$active_id]
2278 );
2279 }
2280 $qtest = [];
2281 if ($result->numRows()) {
2282 while ($row = $this->db->fetchAssoc($result)) {
2283 array_push($qtest, $row);
2284 }
2285 }
2286 return $qtest;
2287 }
◆ 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 4145 of file class.ilObjTest.php.
4145 : string
4146 {
4148 if ($question_id) {
4149 $result = $this->db->queryF(
4150 "SELECT question_text FROM qpl_questions WHERE question_id = %s",
4151 ['integer'],
4152 [$question_id]
4153 );
4154 if ($result->numRows() == 1) {
4155 $row = $this->db->fetchAssoc($result);
4157 }
4158 }
4160 }
References $res.
◆ getQuestionTitle()
| ilObjTest::getQuestionTitle | ( | $title, | |
$nr = null, |
|||
$points = null |
|||
| ) |
Returns the title of a test question and checks if the title output is allowed.
If not, the localized text "question" will be returned.
- Parameters
-
string $title The original title of the question integer $nr The number of the question in the sequence
- Returns
- string The title for the question title output @access public
Definition at line 1394 of file class.ilObjTest.php.
1394 : string
1395 {
1397 case '0':
1398 case '1':
1400 break;
1401 case '2':
1402 if (isset($nr)) {
1404 }
1406 break;
1407 case 3:
1408 if (isset($nr)) {
1410 } else {
1412 }
1413 if ($points != '') {
1415 if ($points == 1) {
1417 }
1418 $txt .= ' - ' . $points . ' ' . $lngv;
1419 }
1420 return $txt;
1421 break;
1422
1423 }
1425 }
References ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getQuestionTitles()
|
private |
Definition at line 1340 of file class.ilObjTest.php.
1340 : array
1341 {
1342 $titles = [];
1344 $result = $this->db->queryF(
1345 'SELECT qpl_questions.title FROM tst_test_question, qpl_questions '
1346 . 'WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id '
1347 . 'ORDER BY tst_test_question.sequence',
1348 ['integer'],
1349 [$this->getTestId()]
1350 );
1351 while ($row = $this->db->fetchAssoc($result)) {
1352 array_push($titles, $row['title']);
1353 }
1354 }
1355 return $titles;
1356 }
Referenced by copyQuestions().
Here is the caller graph for this function:
◆ getQuestionTitlesAndIndexes()
| ilObjTest::getQuestionTitlesAndIndexes | ( | ) |
Returns the titles of the test questions in question sequence.
- Returns
- array The question titles @access public
- See also
- $questions
Definition at line 1365 of file class.ilObjTest.php.
1365 : array
1366 {
1367 $titles = [];
1369 $result = $this->db->queryF(
1370 'SELECT qpl_questions.title, qpl_questions.question_id '
1371 . 'FROM tst_test_question, qpl_questions '
1372 . 'WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id '
1373 . 'ORDER BY tst_test_question.sequence',
1374 ['integer'],
1375 [$this->getTestId()]
1376 );
1377 while ($row = $this->db->fetchAssoc($result)) {
1378 $titles[$row['question_id']] = $row["title"];
1379 }
1380 }
1381 return $titles;
1382 }
◆ 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 1490 of file class.ilObjTest.php.
1491 {
1492 if ($question_id < 1) {
1493 return -1;
1494 }
1495 $result = $this->db->queryF(
1496 "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",
1497 ['integer'],
1498 [$question_id]
1499 );
1500 if ($result->numRows() == 1) {
1501 $data = $this->db->fetchObject($result);
1503 } else {
1504 return "";
1505 }
1506 }
References $data.
◆ getResetProcessingTime()
| ilObjTest::getResetProcessingTime | ( | ) |
Definition at line 894 of file class.ilObjTest.php.
894 : bool
895 {
897 }
References getMainSettings().
Here is the call graph for this function:
◆ getRoleData()
| ilObjTest::getRoleData | ( | $ids | ) |
Definition at line 4365 of file class.ilObjTest.php.
4365 : array
4366 {
4367 if (!is_array($ids) || count($ids) == 0) {
4368 return [];
4369 }
4370 $result = [];
4371 foreach ($ids as $obj_id) {
4372 $result[$obj_id] = ["obj_id" => $obj_id, "title" => ilObject::_lookupTitle($obj_id), "description" => ilObject::_lookupDescription($obj_id)];
4373 }
4374 return $result;
4375 }
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.
Definition at line 772 of file class.ilObjTest.php.
772 : int
773 {
775 }
References getScoreSettings().
Here is the call graph for this function:
◆ getScoreSettings()
| ilObjTest::getScoreSettings | ( | ) |
Definition at line 6581 of file class.ilObjTest.php.
6581 : ScoreSettings
6582 {
6583 if (!$this->score_settings) {
6584 $this->score_settings = $this->getScoreSettingsRepository()
6585 ->getFor($this->getTestId());
6586 }
6588 }
Referenced by getCountSystem(), getPassScoring(), getScoreCutting(), and isScoreReportingEnabled().
Here is the caller graph for this function:
◆ getScoreSettingsRepository()
| ilObjTest::getScoreSettingsRepository | ( | ) |
Definition at line 6590 of file class.ilObjTest.php.
6590 : ScoreSettingsRepository
6591 {
6593 }
ScoreSettingsRepository $score_settings_repository
Definition: class.ilObjTest.php:130
◆ getShowCancel()
| ilObjTest::getShowCancel | ( | ) |
Definition at line 5337 of file class.ilObjTest.php.
5337 : bool
5338 {
5339 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getSuspendTestAllowed();
5340 }
◆ getShowKioskModeParticipant()
| ilObjTest::getShowKioskModeParticipant | ( | ) |
Definition at line 835 of file class.ilObjTest.php.
835 : bool
836 {
837 return $this->getMainSettings()->getTestBehaviourSettings()->getShowParticipantNameInKioskMode();
838 }
References getMainSettings().
Here is the call graph for this function:
◆ getShowKioskModeTitle()
| ilObjTest::getShowKioskModeTitle | ( | ) |
Definition at line 831 of file class.ilObjTest.php.
831 : bool
832 {
834 }
References getMainSettings().
Here is the call graph for this function:
◆ getShowMarker()
| ilObjTest::getShowMarker | ( | ) |
Definition at line 5342 of file class.ilObjTest.php.
5342 : bool
5343 {
5344 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getQuestionMarkingEnabled();
5345 }
◆ getShowPassDetails()
| ilObjTest::getShowPassDetails | ( | ) |
Returns if the pass details should be shown when a test is not finished.
Definition at line 5091 of file class.ilObjTest.php.
5091 : bool
5092 {
5094 }
◆ getShowSolutionAnswersOnly()
| ilObjTest::getShowSolutionAnswersOnly | ( | ) |
Returns if the full solution (including ILIAS content) should be presented to the solution or not.
Definition at line 5122 of file class.ilObjTest.php.
5122 : bool
5123 {
5125 }
◆ getShowSolutionFeedback()
| ilObjTest::getShowSolutionFeedback | ( | ) |
Returns if the feedback should be presented to the solution or not.
Definition at line 5114 of file class.ilObjTest.php.
5114 : bool
5115 {
5117 }
◆ 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 5147 of file class.ilObjTest.php.
5147 : bool
5148 {
5150 }
◆ getShowSolutionListOwnAnswers()
| ilObjTest::getShowSolutionListOwnAnswers | ( | ) |
Definition at line 5152 of file class.ilObjTest.php.
5152 : bool
5153 {
5155 }
◆ getShowSolutionPrintview()
| ilObjTest::getShowSolutionPrintview | ( | ) |
Returns if the solution printview should be presented to the user or not.
Definition at line 5099 of file class.ilObjTest.php.
5099 : bool
5100 {
5102 }
◆ getShowSolutionSignature()
| ilObjTest::getShowSolutionSignature | ( | ) |
Returns if the signature field should be shown in the test results.
Definition at line 5130 of file class.ilObjTest.php.
5130 : bool
5131 {
5133 }
◆ getShowSolutionSuggested()
| ilObjTest::getShowSolutionSuggested | ( | ) |
- Returns
- boolean TRUE if the suggested solutions should be shown, FALSE otherwise
Definition at line 5138 of file class.ilObjTest.php.
5138 : bool
5139 {
5141 }
◆ getShuffleQuestions()
| ilObjTest::getShuffleQuestions | ( | ) |
Definition at line 5042 of file class.ilObjTest.php.
5042 : bool
5043 {
5045 }
◆ getSingleManualFeedback()
|
static |
Definition at line 5528 of file class.ilObjTest.php.
5528 : array
5529 {
5530 global $DIC;
5532 $row = [];
5533 $result = $ilDB->queryF(
5534 "SELECT * FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s",
5535 ['integer', 'integer', 'integer'],
5536 [$active_id, $question_id, $pass]
5537 );
5538
5540 $row = $ilDB->fetchAssoc($result);
5542 } elseif ($ilDB->numRows($result) > 1) {
5543 $DIC->logger()->root()->warning(
5544 "WARNING: Multiple feedback entries on tst_manual_fb for " .
5545 "active_fi = $active_id , question_fi = $question_id and pass = $pass"
5546 );
5547 }
5548
5549 return $row;
5550 }
References $DIC, $ilDB, and ilRTE\_replaceMediaObjectImageSrc().
Referenced by ILIAS\Test\Scoring\Manual\ConsecutiveScoring\getSingleManualFeedback().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getSpecificAnswerFeedback()
| ilObjTest::getSpecificAnswerFeedback | ( | ) |
Definition at line 6157 of file class.ilObjTest.php.
6157 : bool
6158 {
6159 return $this->getMainSettings()->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled();
6160 }
◆ getStartingTime()
| ilObjTest::getStartingTime | ( | ) |
Definition at line 904 of file class.ilObjTest.php.
904 : int
905 {
906 $start_time = $this->getMainSettings()->getAccessSettings()->getStartTime();
907 return $start_time !== null ? $start_time->getTimestamp() : 0;
908 }
References getMainSettings().
Here is the call 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 6183 of file class.ilObjTest.php.
6183 : array
6184 {
6185 $times = [];
6186 $result = $this->db->queryF(
6187 "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",
6188 ['integer'],
6189 [$this->getTestId()]
6190 );
6191 while ($row = $this->db->fetchAssoc($result)) {
6192 $times[$row['active_fi']] = $row['started'];
6193 }
6194 return $times;
6195 }
◆ 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 4876 of file class.ilObjTest.php.
4877 {
4878 if ($active_id < 1) {
4879 return false;
4880 }
4881 if ($pass === null) {
4882 $pass = ($this->getResetProcessingTime()) ? self::_getPass($active_id) : 0;
4883 }
4884 $result = $this->db->queryF(
4885 "SELECT tst_times.started FROM tst_times WHERE tst_times.active_fi = %s AND tst_times.pass = %s ORDER BY tst_times.started",
4886 ['integer', 'integer'],
4887 [$active_id, $pass]
4888 );
4889 if ($result->numRows()) {
4890 $row = $this->db->fetchAssoc($result);
4891 if (preg_match("/(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})/", $row["started"], $matches)) {
4892 return mktime(
4893 (int) $matches[4],
4894 (int) $matches[5],
4895 (int) $matches[6],
4896 (int) $matches[2],
4897 (int) $matches[3],
4898 (int) $matches[1]
4899 );
4900 } else {
4901 return time();
4902 }
4903 } else {
4904 return time();
4905 }
4906 }
◆ getTemplate()
| ilObjTest::getTemplate | ( | ) |
Definition at line 5914 of file class.ilObjTest.php.
5914 : int
5915 {
5917 }
Referenced by saveToDb().
Here is the caller graph for this function:
◆ getTestId()
| ilObjTest::getTestId | ( | ) |
Gets the database id of the additional test data.
Definition at line 716 of file class.ilObjTest.php.
References $test_id.
Referenced by ILIAS\Test\Questions\Properties\DatabaseRepository\buildQuestionPropertiesForRandomTest(), ilTestRandomQuestionSetConfig\cloneQuestionSetRelatedData(), deleteTest(), getMarkSchema(), saveCompleteStatus(), saveQuestionsToDb(), and saveToDb().
Here is the caller graph for this function:
◆ getTestLogger()
| ilObjTest::getTestLogger | ( | ) |
Definition at line 207 of file class.ilObjTest.php.
References $logger.
◆ getTestLogViewer()
| ilObjTest::getTestLogViewer | ( | ) |
Definition at line 212 of file class.ilObjTest.php.
References $log_viewer.
◆ getTestObjIdsWithActiveForUserId()
|
static |
Definition at line 6348 of file class.ilObjTest.php.
6348 : array
6349 {
6350 global $DIC;
6352
6353 $query = "
6354 SELECT obj_fi
6355 FROM tst_active
6356 INNER JOIN tst_tests
6357 ON test_id = test_fi
6358 WHERE user_fi = %s
6359 ";
6360
6362
6363 $objIds = [];
6364
6367 }
6368
6369 return $objIds;
6370 }
References $DIC, $ilDB, $res, and ILIAS\Repository\int().
Here is the call graph for this function:
◆ getTestParticipants()
| ilObjTest::getTestParticipants | ( | ) |
Definition at line 4232 of file class.ilObjTest.php.
4232 : array
4233 {
4235 $query = "
4236 SELECT tst_active.active_id,
4237 tst_active.tries,
4238 tst_active.user_fi usr_id,
4239 %s login,
4240 %s lastname,
4241 %s firstname,
4242 tst_active.submitted test_finished,
4243 usr_data.matriculation,
4244 usr_data.active,
4245 tst_active.lastindex,
4246 COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes
4247 FROM tst_active
4248 LEFT JOIN usr_data
4249 ON tst_active.user_fi = usr_data.usr_id
4250 WHERE tst_active.test_fi = %s
4251 ORDER BY usr_data.lastname
4252 ";
4253 $result = $this->db->queryF(
4254 $query,
4255 ['text', 'text', 'text', 'integer'],
4257 );
4258 } else {
4259 $query = "
4260 SELECT tst_active.active_id,
4261 tst_active.tries,
4262 tst_active.user_fi usr_id,
4263 usr_data.login,
4264 usr_data.lastname,
4265 usr_data.firstname,
4266 tst_active.submitted test_finished,
4267 usr_data.matriculation,
4268 usr_data.active,
4269 tst_active.lastindex,
4270 COALESCE(tst_active.last_finished_pass, -1) <> tst_active.last_started_pass unfinished_passes
4271 FROM tst_active
4272 LEFT JOIN usr_data
4273 ON tst_active.user_fi = usr_data.usr_id
4274 WHERE tst_active.test_fi = %s
4275 ORDER BY usr_data.lastname
4276 ";
4277 $result = $this->db->queryF(
4278 $query,
4279 ['integer'],
4280 [$this->getTestId()]
4281 );
4282 }
4283 $data = [];
4284 while ($row = $this->db->fetchAssoc($result)) {
4286 }
4288 if (strlen(trim($participant["firstname"] . $participant["lastname"])) == 0) {
4290 }
4291 }
4293 }
getGeneralSettings()
References $data, getGeneralSettings(), and ILIAS\Repository\lng().
Here is the call graph for this function:
◆ getTestParticipantsForManualScoring()
| ilObjTest::getTestParticipantsForManualScoring | ( | $filter = null | ) |
Definition at line 4295 of file class.ilObjTest.php.
4295 : array
4296 {
4298 return [];
4299 }
4300
4301 $filtered_participants = [];
4303 if ($participant['tries'] > 0) {
4304 switch ($filter) {
4305 case 4:
4306 if ($this->test_man_scoring_done_helper->isDone((int) $active_id)) {
4307 $filtered_participants[$active_id] = $participant;
4308 }
4309 break;
4310 case 5:
4311 if (!$this->test_man_scoring_done_helper->isDone((int) $active_id)) {
4312 $filtered_participants[$active_id] = $participant;
4313 }
4314 break;
4315 default:
4316 $filtered_participants[$active_id] = $participant;
4317 }
4318 }
4319 }
4320 return $filtered_participants;
4321 }
◆ getTestQuestions()
| ilObjTest::getTestQuestions | ( | ) |
Definition at line 4929 of file class.ilObjTest.php.
4929 : array
4930 {
4931 $tags_trafo = $this->refinery->string()->stripTags();
4932
4933 $query = "
4934 SELECT questions.*,
4935 questtypes.type_tag,
4936 tstquest.sequence,
4937 origquest.obj_fi orig_obj_fi
4938
4939 FROM qpl_questions questions
4940
4941 INNER JOIN qpl_qst_type questtypes
4942 ON questtypes.question_type_id = questions.question_type_fi
4943
4944 INNER JOIN tst_test_question tstquest
4945 ON tstquest.question_fi = questions.question_id
4946
4947 LEFT JOIN qpl_questions origquest
4948 ON origquest.question_id = questions.original_id
4949
4950 WHERE tstquest.test_fi = %s
4951
4952 ORDER BY tstquest.sequence
4953 ";
4954
4955 $query_result = $this->db->queryF(
4956 $query,
4957 ['integer'],
4958 [$this->getTestId()]
4959 );
4960
4961 $questions = [];
4962
4963 while ($row = $this->db->fetchAssoc($query_result)) {
4964 $row['title'] = $tags_trafo->transform($row['title']);
4965 $row['description'] = $tags_trafo->transform($row['description'] !== '' && $row['description'] !== null ? $row['description'] : ' ');
4966 $row['author'] = $tags_trafo->transform($row['author']);
4967
4968 $questions[] = $row;
4969 }
4970
4972 }
References ILIAS\Repository\refinery().
Referenced by ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getRowIds(), and removeQuestionWithResults().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getTestResult()
| ilObjTest::getTestResult | ( | int | $active_id, |
| ?int | $attempt = null, |
||
| bool | $ordered_sequence = false, |
||
| bool | $consider_hidden_questions = true, |
||
| bool | $consider_optional_questions = true |
||
| ) |
Calculates the results of a test for a given user and returns an array with all test results.
- Returns
- array An array containing the test results for the given user
Definition at line 1717 of file class.ilObjTest.php.
1723 : array {
1724 $test_result = $this->test_result_repository->getTestResult($active_id);
1725
1726 if ($test_result === null) {
1727 $test_result = $this->test_result_repository->updateTestResultCache($active_id);
1728 }
1729
1730 if ($attempt === null) {
1731 $attempt = $test_result->getAttempt();
1732 }
1733
1734 $test_sequence_factory = new ilTestSequenceFactory($this, $this->db, $this->questionrepository);
1735 $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $attempt);
1736
1737 $test_sequence->setConsiderHiddenQuestionsEnabled($consider_hidden_questions);
1738 $test_sequence->setConsiderOptionalQuestionsEnabled($consider_optional_questions);
1739
1740 $test_sequence->loadFromDb();
1741 $test_sequence->loadQuestions();
1742
1743 if ($ordered_sequence) {
1744 $sequence = $test_sequence->getOrderedSequenceQuestions();
1745 } else {
1746 $sequence = $test_sequence->getUserSequenceQuestions();
1747 }
1748
1749 $arr_results = [];
1750
1751 $query = "
1752 SELECT
1753 tst_test_result.question_fi,
1754 tst_test_result.points reached,
1755 tst_test_result.answered answered,
1756 tst_manual_fb.finalized_evaluation finalized_evaluation
1757
1758 FROM tst_test_result
1759
1760 LEFT JOIN tst_solutions
1761 ON tst_solutions.active_fi = tst_test_result.active_fi
1762 AND tst_solutions.question_fi = tst_test_result.question_fi
1763
1764 LEFT JOIN tst_manual_fb
1765 ON tst_test_result.active_fi = tst_manual_fb.active_fi
1766 AND tst_test_result.question_fi = tst_manual_fb.question_fi
1767
1768 WHERE tst_test_result.active_fi = %s
1769 AND tst_test_result.pass = %s
1770 ";
1771
1772 $solutionresult = $this->db->queryF(
1773 $query,
1774 ['integer', 'integer'],
1775 [$active_id, $attempt]
1776 );
1777
1778 while ($row = $this->db->fetchAssoc($solutionresult)) {
1779 $arr_results[ $row['question_fi'] ] = $row;
1780 }
1781
1782 $result = $this->db->query(
1783 'SELECT qpl_questions.*, qpl_qst_type.type_tag, qpl_sol_sug.question_fi has_sug_sol' . PHP_EOL
1784 . 'FROM qpl_qst_type, qpl_questions' . PHP_EOL
1785 . 'LEFT JOIN qpl_sol_sug' . PHP_EOL
1786 . 'ON qpl_sol_sug.question_fi = qpl_questions.question_id' . PHP_EOL
1787 . 'WHERE qpl_qst_type.question_type_id = qpl_questions.question_type_fi' . PHP_EOL
1788 . 'AND ' . $this->db->in('qpl_questions.question_id', $sequence, false, 'integer')
1789 );
1790
1791 $unordered = [];
1792 $key = 1;
1793 while ($row = $this->db->fetchAssoc($result)) {
1794 if (!isset($arr_results[ $row['question_id'] ])) {
1795 $percentvalue = 0.0;
1796 } else {
1797 $percentvalue = (
1798 $row['points'] ? $arr_results[$row['question_id']]['reached'] / $row['points'] : 0
1799 );
1800 }
1801 if ($percentvalue < 0) {
1802 $percentvalue = 0.0;
1803 }
1804
1805 $data = [
1806 'nr' => $key,
1808 'max' => round($row['points'], 2),
1809 'reached' => round($arr_results[$row['question_id']]['reached'] ?? 0, 2),
1810 'percent' => sprintf('%2.2f ', ($percentvalue) * 100) . '%',
1811 'solution' => ($row['has_sug_sol']) ? assQuestion::_getSuggestedSolutionOutput($row['question_id']) : '',
1812 'type' => $row['type_tag'],
1813 'qid' => $row['question_id'],
1814 'original_id' => $row['original_id'],
1815 'workedthrough' => isset($arr_results[$row['question_id']]) ? 1 : 0,
1816 'answered' => $arr_results[$row['question_id']]['answered'] ?? 0,
1817 'finalized_evaluation' => $arr_results[$row['question_id']]['finalized_evaluation'] ?? 0,
1818 ];
1819
1821 $key++;
1822 }
1823
1824 $pass_max = 0;
1825 $pass_reached = 0;
1826
1827 $found = [];
1828 foreach ($sequence as $qid) {
1829 // building pass point sums based on prepared data
1830 // for question that exists in users qst sequence
1831 $pass_max += round($unordered[$qid]['max'], 2);
1832 $pass_reached += round($unordered[$qid]['reached'], 2);
1833 $found[] = $unordered[$qid];
1834 }
1835
1837 if ($pass_reached < 0) {
1838 $pass_reached = 0;
1839 }
1840 }
1841
1842 $found['pass']['total_max_points'] = $pass_max;
1843 $found['pass']['total_reached_points'] = $pass_reached;
1844 $found['pass']['percent'] = ($pass_max > 0) ? $pass_reached / $pass_max : 0;
1845 $found['pass']['num_workedthrough'] = count($arr_results);
1846 $found['pass']['num_questions_total'] = count($unordered);
1847
1848 $found['test']['total_max_points'] = $test_result->getMaxPoints();
1849 $found['test']['total_reached_points'] = $test_result->getReachedPoints();
1850 $found['test']['result_pass'] = $attempt;
1851 $found['test']['result_tstamp'] = $test_result->getTimestamp();
1852 $found['test']['passed'] = $test_result->isPassed();
1853
1854 return $found;
1855 }
static _getSuggestedSolutionOutput(int $question_id)
Definition: class.assQuestion.php:457
getScoreCutting()
Determines if the score of a question should be cut at 0 points or the score of the whole test.
Definition: class.ilObjTest.php:772
◆ getTextAnswer()
| ilObjTest::getTextAnswer | ( | $active_id, | |
| $question_id, | |||
$pass = null |
|||
| ) |
Returns the text answer of a given user for a given question.
- Parameters
-
integer $active_id integer $question_id
- Returns
- string The answer text @access public
Definition at line 4116 of file class.ilObjTest.php.
4116 : string
4117 {
4118 if (($active_id) && ($question_id)) {
4119 if ($pass === null) {
4120 $pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
4121 }
4122 if ($pass === null) {
4123 return '';
4124 }
4125 $query = $this->db->queryF(
4126 "SELECT value1 FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
4127 ['integer', 'integer', 'integer'],
4128 [$active_id, $question_id, $pass]
4129 );
4130 $result = $this->db->fetchAll($query);
4131 if (count($result) == 1) {
4132 return $result[0]["value1"];
4133 }
4134 }
4135 return '';
4136 }
static _getSolutionMaxPass(int $question_id, int $active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:1775
References assQuestion\_getSolutionMaxPass().
Referenced by ilTestArchiver\handInParticipantUploadedResults().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getTimeExtensionsOfParticipants()
| ilObjTest::getTimeExtensionsOfParticipants | ( | ) |
Definition at line 6197 of file class.ilObjTest.php.
6197 : array
6198 {
6199 $times = [];
6200 $result = $this->db->queryF(
6201 "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",
6202 ['integer'],
6203 [$this->getTestId()]
6204 );
6205 while ($row = $this->db->fetchAssoc($result)) {
6206 $times[$row['active_fi']] = $row['additionaltime'];
6207 }
6208 return $times;
6209 }
◆ getTitleFilenameCompliant()
| ilObjTest::getTitleFilenameCompliant | ( | ) |
returns the object title prepared to be used as a filename
Definition at line 225 of file class.ilObjTest.php.
References ilFileUtils\getASCIIFilename(), and ilObject\getTitle().
Here is the call graph for this function:
◆ getTitleOutput()
| ilObjTest::getTitleOutput | ( | ) |
Definition at line 845 of file class.ilObjTest.php.
845 : int
846 {
848 }
References getMainSettings().
Here is the call graph for this function:
◆ getTmpCopyWizardCopyId()
| ilObjTest::getTmpCopyWizardCopyId | ( | ) |
Definition at line 230 of file class.ilObjTest.php.
230 : ?int
231 {
233 }
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 2132 of file class.ilObjTest.php.
2132 : array
2133 {
2134 $totalpoints_array = [];
2135 $all_users = $this->evalTotalParticipantsArray();
2136 foreach ($all_users as $active_id => $user_name) {
2137 $test_result = &$this->getTestResult($active_id);
2138 $reached = $test_result["test"]["total_reached_points"];
2139 $total = $test_result["test"]["total_max_points"];
2140 $percentage = $total != 0 ? $reached / $total : 0;
2141 $mark = $this->getMarkSchema()->getMatchingMark($percentage * 100.0);
2142
2143 if ($mark !== null && $mark->getPassed()) {
2144 array_push($totalpoints_array, $test_result["test"]["total_reached_points"]);
2145 }
2146 }
2147 return $totalpoints_array;
2148 }
evalTotalParticipantsArray(string $name_sort_order='asc')
Definition: class.ilObjTest.php:2222
◆ getUnfilteredEvaluationData()
| ilObjTest::getUnfilteredEvaluationData | ( | ) |
Definition at line 2358 of file class.ilObjTest.php.
◆ getUsePreviousAnswers()
| ilObjTest::getUsePreviousAnswers | ( | ) |
Definition at line 840 of file class.ilObjTest.php.
840 : bool
841 {
842 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsePreviousAnswerAllowed();
843 }
References getMainSettings().
Referenced by isPreviousSolutionReuseEnabled().
Here is the call graph for this function:
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 4329 of file class.ilObjTest.php.
4329 : array
4330 {
4331 if (!is_array($ids) || count($ids) == 0) {
4332 return [];
4333 }
4334
4336 $result = $this->db->queryF(
4337 "SELECT usr_id, %s login, %s lastname, %s firstname, client_ip clientip FROM usr_data WHERE " . $this->db->in('usr_id', $ids, false, 'integer') . " ORDER BY login",
4338 ['text', 'text', 'text'],
4339 ["", $this->lng->txt("anonymous"), ""]
4340 );
4341 } else {
4342 $result = $this->db->query("SELECT usr_id, login, lastname, firstname, client_ip clientip FROM usr_data WHERE " . $this->db->in('usr_id', $ids, false, 'integer') . " ORDER BY login");
4343 }
4344
4345 $result_array = [];
4346 while ($row = $this->db->fetchAssoc($result)) {
4347 $result_array[$row["usr_id"]] = $row;
4348 }
4349 return $result_array;
4350 }
◆ getUsrPassOverviewEnabled()
| ilObjTest::getUsrPassOverviewEnabled | ( | ) |
Definition at line 5068 of file class.ilObjTest.php.
5068 : bool
5069 {
5070 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getUsrPassOverviewEnabled();
5071 }
◆ getVisitingTimeOfParticipant()
| ilObjTest::getVisitingTimeOfParticipant | ( | int | $active_id | ) |
Definition at line 6637 of file class.ilObjTest.php.
6637 : array
6638 {
6639 return $this->participant_repository->getFirstAndLastVisitForActiveId($active_id);
6640 }
◆ 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 1546 of file class.ilObjTest.php.
1546 : array
1547 {
1548 if (is_null($pass)) {
1549 $result = $this->db->queryF(
1550 "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
1551 ['integer','integer'],
1552 [$active_id, 0]
1553 );
1554 } else {
1555 $result = $this->db->queryF(
1556 "SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
1557 ['integer','integer'],
1558 [$active_id, $pass]
1559 );
1560 }
1561 $result_array = [];
1562 while ($row = $this->db->fetchAssoc($result)) {
1563 array_push($result_array, $row["question_fi"]);
1564 }
1565 return $result_array;
1566 }
◆ getWorkingTimeOfParticipantForPass()
| ilObjTest::getWorkingTimeOfParticipantForPass | ( | int | $active_id, |
| int | $pass | ||
| ) |
@depracated 11, will be removed in 12, use TestResultManager::fetchWorkingTime instead
Definition at line 2007 of file class.ilObjTest.php.
2007 : int
2008 {
2009 return $this->test_result_repository->fetchWorkingTime($active_id, $pass);
2010 }
◆ getXMLZip()
| ilObjTest::getXMLZip | ( | ) |
Get zipped xml file for test.
Reimplemented from ilObject.
Definition at line 5898 of file class.ilObjTest.php.
5898 : string
5899 {
5900 return $this->export_factory->getExporter($this, 'xml')
5901 ->write();
5902 }
◆ hasAnyTestResult()
| ilObjTest::hasAnyTestResult | ( | ilTestSession | $test_session | ) |
Definition at line 4859 of file class.ilObjTest.php.
4859 : bool
4860 {
4862
4863 $pass_selector->setActiveId($test_session->getActiveId());
4864 $pass_selector->setLastFinishedPass($test_session->getLastFinishedPass());
4865
4866 return $pass_selector->hasExistingPasses();
4867 }
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 4478 of file class.ilObjTest.php.
4478 : bool
4479 {
4481 }
◆ hasQuestionsWithoutQuestionpool()
| ilObjTest::hasQuestionsWithoutQuestionpool | ( | ) |
Definition at line 5967 of file class.ilObjTest.php.
5967 : bool
5968 {
5970
5972
5973 $query = "
5974 SELECT count(q1.question_id) cnt
5975
5976 FROM qpl_questions q1
5977
5978 INNER JOIN qpl_questions q2
5979 ON q2.question_id = q1.original_id
5980
5981 WHERE $IN_questions
5982 AND q1.obj_fi = q2.obj_fi
5983 ";
5984 $rset = $this->db->query($query);
5985 $row = $this->db->fetchAssoc($rset);
5986
5987 return $row['cnt'] > 0;
5988 }
getQuestionTitlesAndIndexes()
Returns the titles of the test questions in question sequence.
Definition: class.ilObjTest.php:1365
◆ insertManualFeedback()
|
private |
Definition at line 5602 of file class.ilObjTest.php.
5609 : void {
5610 $next_id = $this->db->nextId('tst_manual_fb');
5612 $finalized_time = time();
5613
5614 $update_default = [
5615 'manual_feedback_id' => [ 'integer', $next_id],
5616 'active_fi' => [ 'integer', $active_id],
5617 'question_fi' => [ 'integer', $question_id],
5618 'pass' => [ 'integer', $pass],
5620 'tstamp' => [ 'integer', time()]
5621 ];
5622
5623 if ($feedback_old !== [] && (int) $feedback_old['finalized_evaluation'] === 1) {
5625 $finalized_time = $feedback_old['finalized_tstamp'];
5626 }
5627
5628 if ($finalized === false) {
5629 $update_default['finalized_evaluation'] = ['integer', 0];
5630 $update_default['finalized_by_usr_id'] = ['integer', 0];
5631 $update_default['finalized_tstamp'] = ['integer', 0];
5632 } elseif ($finalized === true) {
5633 $update_default['finalized_evaluation'] = ['integer', 1];
5635 $update_default['finalized_tstamp'] = ['integer', $finalized_time];
5636 }
5637
5638 $this->db->insert('tst_manual_fb', $update_default);
5639
5641 $this->logger->logScoringInteraction(
5642 $this->logger->getInteractionFactory()->buildScoringInteraction(
5643 $this->getRefId(),
5644 $question_id,
5645 $this->user->getId(),
5646 self::_getUserIdFromActiveId($active_id),
5647 TestScoringInteractionTypes::QUESTION_GRADED,
5648 [
5649 AdditionalInformationGenerator::KEY_EVAL_FINALIZED => $this->logger
5650 ->getAdditionalInformationGenerator()->getTrueFalseTagForBool($finalized),
5651 AdditionalInformationGenerator::KEY_FEEDBACK => $feedback ? ilRTE::_replaceMediaObjectImageSrc($feedback, 0) : ''
5652 ]
5653 )
5654 );
5655 }
5656 }
◆ insertQuestion()
| ilObjTest::insertQuestion | ( | int | $question_id, |
| bool | $link_only = false |
||
| ) |
Definition at line 1287 of file class.ilObjTest.php.
1287 : int
1288 {
1289 if ($link_only) {
1290 $duplicate_id = $question_id;
1291 } else {
1292 $duplicate_id = $this->duplicateQuestionForTest($question_id);
1293 }
1294
1295 // get maximum sequence index in test
1296 $result = $this->db->queryF(
1297 "SELECT MAX(sequence) seq FROM tst_test_question WHERE test_fi=%s",
1298 ['integer'],
1299 [$this->getTestId()]
1300 );
1301 $sequence = 1;
1302
1303 if ($result->numRows() == 1) {
1304 $data = $this->db->fetchObject($result);
1305 $sequence = $data->seq + 1;
1306 }
1307
1308 $next_id = $this->db->nextId('tst_test_question');
1309 $this->db->manipulateF(
1310 "INSERT INTO tst_test_question (test_question_id, test_fi, question_fi, sequence, tstamp) VALUES (%s, %s, %s, %s, %s)",
1311 ['integer', 'integer','integer','integer','integer'],
1312 [$next_id, $this->getTestId(), $duplicate_id, $sequence, time()]
1313 );
1314 // remove test_active entries, because test has changed
1315 $this->db->manipulateF(
1316 "DELETE FROM tst_active WHERE test_fi = %s",
1317 ['integer'],
1318 [$this->getTestId()]
1319 );
1320 $this->loadQuestions();
1321 $this->saveCompleteStatus($this->question_set_config_factory->getQuestionSetConfig());
1322
1324 $this->logger->logTestAdministrationInteraction(
1325 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
1326 $this->getRefId(),
1327 $this->user->getId(),
1328 TestAdministrationInteractionTypes::QUESTION_ADDED,
1329 [
1330 AdditionalInformationGenerator::KEY_QUESTION_ID => $question_id
1331 ] + (assQuestion::instantiateQuestion($question_id))
1332 ->toLog($this->logger->getAdditionalInformationGenerator())
1333 )
1334 );
1335 }
1336
1337 return $duplicate_id;
1338 }
duplicateQuestionForTest($question_id)
Takes a question and creates a copy of the question for use in the test.
Definition: class.ilObjTest.php:1280
saveCompleteStatus(ilTestQuestionSetConfig $test_question_set_config)
Definition: class.ilObjTest.php:446
References $data, assQuestion\instantiateQuestion(), and ILIAS\Repository\logger().
Referenced by copyQuestions().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ inviteUser()
| ilObjTest::inviteUser | ( | $user_id, | |
$client_ip = "" |
|||
| ) |
Invites a user to a test.
- Parameters
-
integer $user_id The database id of the invited user @access public
Definition at line 4383 of file class.ilObjTest.php.
4384 {
4385 $this->db->manipulateF(
4386 "DELETE FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
4387 ['integer', 'integer'],
4389 );
4390 $this->db->manipulateF(
4391 "INSERT INTO tst_invited_user (test_fi, user_fi, ip_range_from, ip_range_to, tstamp) VALUES (%s, %s, %s, %s, %s)",
4392 ['integer', 'integer', 'text', 'text', 'integer'],
4393 [$this->getTestId(), $user_id, (strlen($client_ip)) ? $client_ip : null, (strlen($client_ip)) ? $client_ip : null,time()]
4394 );
4395 }
References $user_id.
◆ isActiveTestSubmitted()
| ilObjTest::isActiveTestSubmitted | ( | $user_id = null | ) |
returns if the active for user_id has been submitted
Definition at line 4461 of file class.ilObjTest.php.
4461 : bool
4462 {
4465 }
4466
4467 $result = $this->db->queryF(
4468 "SELECT submitted FROM tst_active WHERE test_fi=%s AND user_fi=%s AND submitted=%s",
4469 ['integer', 'integer', 'integer'],
4471 );
4472 return $result->numRows() == 1;
4473 }
References $user_id, and ILIAS\Repository\user().
Here is the call graph for this function:
◆ isBlockPassesAfterPassedEnabled()
| ilObjTest::isBlockPassesAfterPassedEnabled | ( | ) |
Definition at line 821 of file class.ilObjTest.php.
821 : bool
822 {
824 }
References getMainSettings().
Here is the call graph for this function:
◆ isComplete()
|
final |
Definition at line 432 of file class.ilObjTest.php.
432 : bool
433 {
435 || $this->getMarkSchema()->getMarkSteps() === []) {
436 return false;
437 }
438
440 return false;
441 }
442
443 return true;
444 }
isQuestionSetConfigured()
References getMarkSchema(), and ilTestQuestionSetConfig\isQuestionSetConfigured().
Referenced by saveCompleteStatus().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ isEndingTimeEnabled()
| ilObjTest::isEndingTimeEnabled | ( | ) |
Definition at line 910 of file class.ilObjTest.php.
910 : bool
911 {
913 }
References getMainSettings().
Here is the call graph for this function:
◆ isExecutable()
| ilObjTest::isExecutable | ( | $test_session, | |
| $user_id, | |||
$allow_pass_increase = false |
|||
| ) |
Checks if the test is executable by the given user.
- Parameters
-
$test_session integer $user_id The user id bool $allowPassIncrease
- Returns
- array Result array
- Exceptions
-
ilDateTimeException
Definition at line 4762 of file class.ilObjTest.php.
4762 : array
4763 {
4764 $result = [
4765 "executable" => true,
4766 "errormessage" => ""
4767 ];
4768
4770 $result["executable"] = false;
4771 $result["errormessage"] = $this->lng->txt('autosave_failed') . ': ' . $this->lng->txt('offline');
4772 return $result;
4773 }
4774
4776 $result["executable"] = false;
4777 $result["errormessage"] = sprintf($this->lng->txt("detail_starting_time_not_reached"), ilDatePresentation::formatDate(new ilDateTime($this->getStartingTime(), IL_CAL_UNIX)));
4778 return $result;
4779 }
4781 $result["executable"] = false;
4782 $result["errormessage"] = sprintf($this->lng->txt("detail_ending_time_reached"), ilDatePresentation::formatDate(new ilDateTime($this->getEndingTime(), IL_CAL_UNIX)));
4783 return $result;
4784 }
4785
4787
4789 && $active_id > 0
4791 && $this->isMaxProcessingTimeReached($starting_time, $active_id)) {
4792 $result["executable"] = false;
4794 return $result;
4795 }
4796
4798 $testPassesSelector->setActiveId($active_id);
4799 $testPassesSelector->setLastFinishedPass($test_session->getLastFinishedPass());
4800
4802 $closedPasses = $testPassesSelector->getClosedPasses();
4803
4805 $result["executable"] = false;
4807 return $result;
4808 }
4809
4812 $result['executable'] = false;
4814 return $result;
4815 }
4816 }
4817 }
4818
4819 $next_pass_allowed_timestamp = 0;
4821 $date = ilDatePresentation::formatDate(new ilDateTime($next_pass_allowed_timestamp, IL_CAL_UNIX));
4822
4823 $result['executable'] = false;
4825 return $result;
4826 }
4827 return $result;
4828 }
static formatDate(ilDateTime $date, bool $a_skip_day=false, bool $a_include_wd=false, bool $include_seconds=false, ?ilObjUser $user=null,)
Definition: class.ilDatePresentation.php:82
isNextPassAllowed(ilTestPassesSelector $testPassesSelector, int &$next_pass_allowed_timestamp)
Definition: class.ilObjTest.php:4830
endingTimeReached()
Returns true if the ending time of a test is reached An ending time is not available for self assessm...
Definition: class.ilObjTest.php:2679
getStartingTimeOfUser($active_id, $pass=null)
Returns the unix timestamp of the time a user started a test.
Definition: class.ilObjTest.php:4876
isMaxProcessingTimeReached(int $starting_time, int $active_id)
Returns whether the maximum processing time for a test is reached or not.
Definition: class.ilObjTest.php:4914
startingTimeReached()
Returns true if the starting time of a test is reached A starting time is not available for self asse...
Definition: class.ilObjTest.php:2661
isBlockPassesAfterPassedEnabled()
Definition: class.ilObjTest.php:821
hasNrOfTriesRestriction()
returns if the numbers of tries have to be checked
Definition: class.ilObjTest.php:4478
References $user_id, ilDatePresentation\formatDate(), 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 6299 of file class.ilObjTest.php.
Referenced by ILIAS\Test\ExportImport\Factory\getExporter(), and ILIAS\Test\Questions\Properties\DatabaseRepository\getQuestionPropertiesForTest().
Here is the caller graph for this function:
◆ isFollowupQuestionAnswerFixationEnabled()
| ilObjTest::isFollowupQuestionAnswerFixationEnabled | ( | ) |
Definition at line 6424 of file class.ilObjTest.php.
6424 : bool
6425 {
6426 return $this->getMainSettings()->getQuestionBehaviourSettings()->getLockAnswerOnNextQuestionEnabled();
6427 }
◆ isForceInstantFeedbackEnabled()
| ilObjTest::isForceInstantFeedbackEnabled | ( | ) |
Definition at line 6434 of file class.ilObjTest.php.
6434 : ?bool
6435 {
6436 return $this->getMainSettings()->getQuestionBehaviourSettings()->getForceInstantFeedbackOnNextQuestion();
6437 }
◆ 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 6090 of file class.ilObjTest.php.
6090 : bool
6091 {
6093 }
getHighscoreAnon()
Gets if the highscores should be anonymized per setting.
Definition: class.ilObjTest.php:6077
◆ 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 5224 of file class.ilObjTest.php.
5224 : bool
5225 {
5226 if (preg_match("/<[^>]*?>/", $a_text)) {
5227 return true;
5228 } else {
5229 return false;
5230 }
5231 }
◆ isInstantFeedbackAnswerFixationEnabled()
| ilObjTest::isInstantFeedbackAnswerFixationEnabled | ( | ) |
Definition at line 6429 of file class.ilObjTest.php.
6429 : bool
6430 {
6431 return $this->getMainSettings()->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled();
6432 }
◆ 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 4914 of file class.ilObjTest.php.
4914 : bool
4915 {
4917 return false;
4918 }
4919
4920 $processing_time = $this->getProcessingTimeInSeconds($active_id);
4921 $now = time();
4922 if ($now > ($starting_time + $processing_time)) {
4923 return true;
4924 }
4925
4926 return false;
4927 }
getProcessingTimeInSeconds(int $active_id=0)
Definition: class.ilObjTest.php:878
◆ isNextPassAllowed()
| ilObjTest::isNextPassAllowed | ( | ilTestPassesSelector | $testPassesSelector, |
| int & | $next_pass_allowed_timestamp | ||
| ) |
Definition at line 4830 of file class.ilObjTest.php.
4830 : bool
4831 {
4832 $waiting_between_passes = $this->getMainSettings()->getTestBehaviourSettings()->getPassWaiting();
4833 $last_finished_pass_timestamp = $testPassesSelector->getLastFinishedPassTimestamp();
4834
4835 if (
4836 $this->getMainSettings()->getTestBehaviourSettings()->getPassWaitingEnabled()
4837 && ($waiting_between_passes !== '')
4839 && ($last_finished_pass_timestamp !== null)
4840 ) {
4841 $time_values = explode(':', $waiting_between_passes);
4842 $next_pass_allowed_timestamp = strtotime('+ ' . $time_values[0] . ' Days + ' . $time_values[1] . ' Hours' . $time_values[2] . ' Minutes', $last_finished_pass_timestamp);
4843 return (time() > $next_pass_allowed_timestamp);
4844 }
4845
4846 return true;
4847 }
getLastFinishedPass()
Definition: class.ilTestPassesSelector.php:52
getLastFinishedPassTimestamp()
Definition: class.ilTestPassesSelector.php:264
References ilTestPassesSelector\getLastFinishedPass(), and ilTestPassesSelector\getLastFinishedPassTimestamp().
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 4489 of file class.ilObjTest.php.
◆ isOnline()
| ilObjTest::isOnline | ( | ) |
Definition at line 6022 of file class.ilObjTest.php.
6022 : bool
6023 {
6025 }
◆ isParticipantsLastPassActive()
|
static |
Definition at line 6440 of file class.ilObjTest.php.
6440 : bool
6441 {
6442 global $DIC;
6445
6447
6448 $active_id = $test_obj->getActiveIdOfUser($user_id);
6449
6451
6452 // Added temporarily bugfix smeyer
6453 $test_session_factory->reset();
6454
6455 $test_sequence_factory = new ilTestSequenceFactory($test_obj, $ilDB, TestDIC::dic()['question.general_properties.repository']);
6456
6457 $test_session = $test_session_factory->getSession($active_id);
6458 $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $test_session->getPass());
6459 $test_sequence->loadFromDb();
6460
6462 }
static getInstanceByRefId(int $ref_id, bool $stop_on_error=true)
get an instance of an Ilias object by reference id
Definition: class.ilObjectFactory.php:141
References $DIC, $ilDB, $user_id, 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 6167 of file class.ilObjTest.php.
6167 : bool
6168 {
6170 }
◆ isPasswordEnabled()
| ilObjTest::isPasswordEnabled | ( | ) |
Definition at line 921 of file class.ilObjTest.php.
921 : bool
922 {
924 }
References getMainSettings().
Here is the call graph for this function:
◆ isPluginActive()
| ilObjTest::isPluginActive | ( | $a_pname | ) |
Checks wheather or not a question plugin with a given name is active.
- Parameters
-
string $a_pname The plugin name @access public
Definition at line 5760 of file class.ilObjTest.php.
5760 : bool
5761 {
5762 if (!$this->component_repository->getComponentByTypeAndName(
5764 'TestQuestionPool'
5765 )->getPluginSlotById('qst')->hasPluginName($a_pname)) {
5766 return false;
5767 }
5768
5769 return $this->component_repository
5770 ->getComponentByTypeAndName(
5772 'TestQuestionPool'
5773 )
5774 ->getPluginSlotById(
5775 'qst'
5776 )
5777 ->getPluginByName(
5778 $a_pname
5779 )->isActive();
5780 }
References ilComponentInfo\TYPE_COMPONENT.
◆ isPostponingEnabled()
| ilObjTest::isPostponingEnabled | ( | ) |
Definition at line 721 of file class.ilObjTest.php.
721 : bool
722 {
723 return $this->getMainSettings()->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd();
724 }
References getMainSettings().
Here is the call graph for this function:
◆ isPreviousSolutionReuseEnabled()
| ilObjTest::isPreviousSolutionReuseEnabled | ( | ) |
Definition at line 850 of file class.ilObjTest.php.
850 : bool
851 {
852 return $this->getUsePreviousAnswers() && $this->user->getPref('tst_use_previous_answers') === '1';
853 }
References getUsePreviousAnswers(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ isRandomTest()
| ilObjTest::isRandomTest | ( | ) |
Returns the fact wether this test is a random questions test or not.
- Returns
- boolean $isRandomTest
Definition at line 6309 of file class.ilObjTest.php.
6309 : bool
6310 {
6312 }
Referenced by ILIAS\Test\Questions\Properties\DatabaseRepository\getQuestionPropertiesForTest(), loadQuestions(), and removeQuestionWithResults().
Here is the caller graph for this function:
◆ isScoreReportingEnabled()
| ilObjTest::isScoreReportingEnabled | ( | ) |
Definition at line 726 of file class.ilObjTest.php.
726 : bool
727 {
728 return $this->getScoreSettings()->getResultSummarySettings()->getScoreReporting()->isReportingEnabled();
729 }
References getScoreSettings().
Here is the call graph for this function:
◆ isShowExamIdInTestPassEnabled()
| ilObjTest::isShowExamIdInTestPassEnabled | ( | ) |
Definition at line 6270 of file class.ilObjTest.php.
6270 : bool
6271 {
6273 }
◆ isShowExamIdInTestResultsEnabled()
| ilObjTest::isShowExamIdInTestResultsEnabled | ( | ) |
Definition at line 6275 of file class.ilObjTest.php.
6275 : bool
6276 {
6278 }
◆ isShowGradingMarkEnabled()
| ilObjTest::isShowGradingMarkEnabled | ( | ) |
Definition at line 6419 of file class.ilObjTest.php.
6419 : bool
6420 {
6422 }
◆ isShowGradingStatusEnabled()
| ilObjTest::isShowGradingStatusEnabled | ( | ) |
Definition at line 6414 of file class.ilObjTest.php.
6414 : bool
6415 {
6417 }
◆ isSkillManagementGloballyActivated()
|
static |
Definition at line 6403 of file class.ilObjTest.php.
6403 : ?bool
6404 {
6405 if (self::$isSkillManagementGloballyActivated === null) {
6407
6408 self::$isSkillManagementGloballyActivated = $skmgSet->isActivated();
6409 }
6410
6412 }
static $isSkillManagementGloballyActivated
Definition: class.ilObjTest.php:6401
Skill management settings.
Definition: class.ilSkillManagementSettings.php:29
Referenced by ilTestSkillAdministrationGUI\isAccessDenied().
Here is the caller graph for this function:
◆ isSkillServiceEnabled()
| ilObjTest::isSkillServiceEnabled | ( | ) |
Definition at line 6372 of file class.ilObjTest.php.
6372 : bool
6373 {
6375 }
◆ 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.
- Returns
- boolean whether this test takes skills into account.
Definition at line 6388 of file class.ilObjTest.php.
6388 : bool
6389 {
6391 return false;
6392 }
6393
6394 if (!self::isSkillManagementGloballyActivated()) {
6395 return false;
6396 }
6397
6398 return true;
6399 }
◆ isStartingTimeEnabled()
| ilObjTest::isStartingTimeEnabled | ( | ) |
Definition at line 899 of file class.ilObjTest.php.
899 : bool
900 {
902 }
References getMainSettings().
Here is the call graph for this function:
◆ isTestFinished()
| ilObjTest::isTestFinished | ( | $active_id | ) |
returns if the active for user_id has been submitted
Definition at line 4448 of file class.ilObjTest.php.
4448 : bool
4449 {
4450 $result = $this->db->queryF(
4451 "SELECT submitted FROM tst_active WHERE active_id=%s AND submitted=%s",
4452 ['integer', 'integer'],
4453 [$active_id, 1]
4454 );
4455 return $result->numRows() == 1;
4456 }
◆ 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 1576 of file class.ilObjTest.php.
1576 : bool
1577 {
1578 $num = ilObjTest::lookupPassResultsUpdateTimestamp($active_id, $currentpass);
1579 return ((($currentpass > 0) && ($num == 0)) || $this->isTestFinished($active_id)) ? true : false;
1580 }
isTestFinished($active_id)
returns if the active for user_id has been submitted
Definition: class.ilObjTest.php:4448
static lookupPassResultsUpdateTimestamp($active_id, $pass)
Definition: class.ilObjTest.php:4712
References lookupPassResultsUpdateTimestamp(), and true.
Here is the call graph for this function:
◆ isTestQuestion()
| ilObjTest::isTestQuestion | ( | int | $question_id | ) |
Definition at line 4974 of file class.ilObjTest.php.
4974 : bool
4975 {
4977 if ($questionData['question_id'] != $question_id) {
4978 continue;
4979 }
4980
4981 return true;
4982 }
4983
4984 return false;
4985 }
◆ loadFromDb()
| ilObjTest::loadFromDb | ( | ) |
Definition at line 612 of file class.ilObjTest.php.
612 : void
613 {
614 $result = $this->db->queryF(
615 "SELECT test_id FROM tst_tests WHERE obj_fi = %s",
616 ['integer'],
617 [$this->getId()]
618 );
619 if ($result->numRows() === 1) {
620 $data = $this->db->fetchObject($result);
622 $this->loadQuestions();
623 }
624 }
References $data, ilObject\getId(), loadQuestions(), and setTestId().
Referenced by read().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ loadQuestions()
| ilObjTest::loadQuestions | ( | int | $active_id = 0, |
| ?int | $pass = null |
||
| ) |
Load the test question id's from the database.
Definition at line 630 of file class.ilObjTest.php.
630 : void
631 {
632 $this->questions = [];
634 if ($active_id === 0) {
636 }
637 if (is_null($pass)) {
638 $pass = self::_getPass($active_id);
639 }
640 $result = $this->db->queryF(
641 'SELECT tst_test_rnd_qst.* '
642 . 'FROM tst_test_rnd_qst, qpl_questions '
643 . 'WHERE tst_test_rnd_qst.active_fi = %s '
644 . 'AND qpl_questions.question_id = tst_test_rnd_qst.question_fi '
645 . 'AND tst_test_rnd_qst.pass = %s '
646 . 'ORDER BY sequence',
647 ['integer', 'integer'],
648 [$active_id, $pass]
649 );
650 } else {
651 $result = $this->db->queryF(
652 'SELECT tst_test_question.* '
653 . 'FROM tst_test_question, qpl_questions '
654 . 'WHERE tst_test_question.test_fi = %s '
655 . 'AND qpl_questions.question_id = tst_test_question.question_fi '
656 . 'ORDER BY sequence',
657 ['integer'],
658 [$this->test_id]
659 );
660 }
661 $index = 1;
662 if ($this->test_id !== -1) {
663 //Omit loading of questions for non-id'ed test
666 }
667 }
668 }
References $data, _getPass(), getActiveIdOfUser(), isRandomTest(), and ILIAS\Repository\user().
Referenced by loadFromDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ lookupExamId()
|
static |
Definition at line 6234 of file class.ilObjTest.php.
6235 {
6236 global $DIC;
6238
6239 $exam_id_query = 'SELECT exam_id FROM tst_pass_result WHERE active_fi = %s AND pass = %s';
6240 $exam_id_result = $ilDB->queryF($exam_id_query, [ 'integer', 'integer' ], [ $active_id, $pass ]);
6242 $exam_id_row = $ilDB->fetchAssoc($exam_id_result);
6243
6244 if ($exam_id_row['exam_id'] != null) {
6245 return $exam_id_row['exam_id'];
6246 }
6247 }
6248
6249 return null;
6250 }
Referenced by ilTestPlayerAbstractGUI\outQuestionSummaryCmd(), ilTestEvaluationGUI\outUserListOfAnswerPasses(), ilTestEvaluationGUI\outUserPassDetails(), ilTestServiceGUI\populateExamId(), ilTestPlayerAbstractGUI\prepareTestPage(), and ilTestSubmissionReviewGUI\show().
Here is the caller graph for this function:
◆ lookupPassResultsUpdateTimestamp()
|
static |
- Parameters
-
int $active_id int $pass
- Returns
- int
Definition at line 4712 of file class.ilObjTest.php.
4712 : int
4713 {
4714 global $DIC;
4716
4717 if (is_null($pass)) {
4718 $pass = 0;
4719 }
4720
4721 $query = "
4722 SELECT tst_pass_result.tstamp pass_res_tstamp,
4723 tst_test_result.tstamp quest_res_tstamp
4724
4725 FROM tst_pass_result
4726
4727 LEFT JOIN tst_test_result
4728 ON tst_test_result.active_fi = tst_pass_result.active_fi
4729 AND tst_test_result.pass = tst_pass_result.pass
4730
4731 WHERE tst_pass_result.active_fi = %s
4732 AND tst_pass_result.pass = %s
4733
4734 ORDER BY tst_test_result.tstamp DESC
4735 ";
4736
4737 $result = $ilDB->queryF(
4738 $query,
4739 ['integer', 'integer'],
4740 [$active_id, $pass]
4741 );
4742
4744 if ($row['quest_res_tstamp']) {
4745 return $row['quest_res_tstamp'];
4746 }
4747
4748 return $row['pass_res_tstamp'];
4749 }
4750
4751 return 0;
4752 }
Referenced by ilTestService\getPassOverviewData(), and isTestFinishedToViewResults().
Here is the caller graph for this function:
◆ lookupQuestionSetTypeByActiveId()
| ilObjTest::lookupQuestionSetTypeByActiveId | ( | int | $active_id | ) |
Definition at line 5352 of file class.ilObjTest.php.
5352 : string
5353 {
5354 return $this->main_settings_repository->getFor(
5355 self::_getTestIDFromObjectID(self::_getObjectIDFromActiveID($active_id)),
5356 )->getGeneralSettings()->getQuestionSetType();
5357 }
◆ marksEditable()
| ilObjTest::marksEditable | ( | ) |
- Returns
- {}
Definition at line 3788 of file class.ilObjTest.php.
3788 : bool
3789 {
3790 $total = $this->evalTotalPersons();
3791 $results_summary_settings = $this->getScoreSettings()->getResultSummarySettings();
3792 if ($total === 0
3793 || $results_summary_settings->getScoreReporting()->isReportingEnabled() === false) {
3794 return true;
3795 }
3796
3797 if ($results_summary_settings->getScoreReporting() === ScoreReportingTypes::SCORE_REPORTING_DATE) {
3798 return $results_summary_settings->getReportingDate()
3799 >= new DateTimeImmutable('now', new DateTimeZone('UTC'));
3800 }
3801
3802 return false;
3803 }
evalTotalPersons()
Returns the number of persons who started the test.
Definition: class.ilObjTest.php:1863
Referenced by ILIAS\Test\Scoring\Marks\MarkSchemaGUI\__construct().
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 3656 of file class.ilObjTest.php.
3657 {
3658 if ($a_tag == "Identifier" && $a_param == "Entry") {
3659 $a_value = ilUtil::insertInstIntoID($a_value);
3660 }
3661
3662 return $a_value;
3663 }
static insertInstIntoID(string $a_value)
inserts installation id into ILIAS id
Definition: class.ilUtil.php:961
References ilUtil\insertInstIntoID().
Here is the call graph for this function:
◆ moveQuestions()
| ilObjTest::moveQuestions | ( | array | $move_questions, |
| int | $target_index, | ||
| int | $insert_mode | ||
| ) |
- Parameters
-
array<int> $move_questions integer $insert_mode 0, if insert before the target position, 1 if insert after the target position
Definition at line 2609 of file class.ilObjTest.php.
2609 : void
2610 {
2611 $this->questions = array_values($this->questions);
2612 $array_pos = array_search($target_index, $this->questions);
2613 if ($insert_mode == 0) {
2614 $part1 = array_slice($this->questions, 0, $array_pos);
2615 $part2 = array_slice($this->questions, $array_pos);
2616 } elseif ($insert_mode == 1) {
2617 $part1 = array_slice($this->questions, 0, $array_pos + 1);
2618 $part2 = array_slice($this->questions, $array_pos + 1);
2619 }
2620 foreach ($move_questions as $question_id) {
2621 if (!(array_search($question_id, $part1) === false)) {
2622 unset($part1[array_search($question_id, $part1)]);
2623 }
2624 if (!(array_search($question_id, $part2) === false)) {
2625 unset($part2[array_search($question_id, $part2)]);
2626 }
2627 }
2628 $part1 = array_values($part1);
2629 $part2 = array_values($part2);
2630 $new_array = array_values(array_merge($part1, $move_questions, $part2));
2631 $this->questions = [];
2632 $counter = 1;
2633 foreach ($new_array as $question_id) {
2634 $this->questions[$counter] = $question_id;
2635 $counter++;
2636 }
2637 $this->saveQuestionsToDb();
2638
2640 $this->logger->logTestAdministrationInteraction(
2641 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
2642 $this->getRefId(),
2643 $this->user->getId(),
2644 TestAdministrationInteractionTypes::QUESTION_MOVED,
2645 [
2646 AdditionalInformationGenerator::KEY_QUESTION_ORDER => $this->questions
2647 ]
2648 )
2649 );
2650 }
2651 }
References $counter, and ILIAS\Repository\logger().
Here is the call graph for this function:
◆ onMarkSchemaSaved()
| ilObjTest::onMarkSchemaSaved | ( | ) |
Definition at line 3776 of file class.ilObjTest.php.
3776 : void
3777 {
3778 $this->saveCompleteStatus($this->question_set_config_factory->getQuestionSetConfig());
3779
3782 }
3783 }
recalculateScores($preserve_manscoring=false)
Definition: class.ilObjTest.php:6336
◆ participantDataExist()
| ilObjTest::participantDataExist | ( | ) |
Definition at line 6327 of file class.ilObjTest.php.
6327 : bool
6328 {
6331 }
6332
6334 }
$participantDataExist
holds the fact wether participant data exists or not DO NOT USE TIS PROPERTY DRIRECTLY ALWAYS USE ilO...
Definition: class.ilObjTest.php:115
◆ 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 1700 of file class.ilObjTest.php.
1700 : array
1701 {
1702 $keys = array_keys($array);
1703 shuffle($keys);
1704 $result = [];
1705 foreach ($keys as $key) {
1706 $result[$key] = $array[$key];
1707 }
1708 return $result;
1709 }
◆ 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 5320 of file class.ilObjTest.php.
5321 {
5322 if ($txt_output == null) {
5323 $txt_output = '';
5324 }
5326 $txt_output,
5327 $prepare_for_latex_output,
5328 $omitNl2BrWhenTextArea
5329 );
5330 }
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free,...
Definition: class.ilLegacyFormElementsUtil.php:109
References ilLegacyFormElementsUtil\prepareTextareaOutput().
Here is the call graph for this function:
◆ processPrintoutput2FO()
| ilObjTest::processPrintoutput2FO | ( | $print_output | ) |
Convert a print output to XSL-FO.
- Parameters
-
string $print_output The print output
- Returns
- string XSL-FO code @access public
Definition at line 5403 of file class.ilObjTest.php.
5403 : string
5404 {
5405 if (extension_loaded("tidy")) {
5406 $config = [
5407 "indent" => false,
5408 "output-xml" => true,
5410 ];
5411 $tidy = new tidy();
5412 $tidy->parseString($print_output, $config, 'utf8');
5413 $tidy->cleanRepair();
5414 $print_output = tidy_get_output($tidy);
5415 $print_output = preg_replace("/^.*?(<html)/", "\\1", $print_output);
5416 } else {
5417 $print_output = str_replace(" ", " ", $print_output);
5418 $print_output = str_replace("⊗", "X", $print_output);
5419 }
5420 $xsl = file_get_contents("./components/ILIAS/Test/xml/question2fo.xsl");
5421
5422 // additional font support
5423
5424 $xsl = str_replace(
5425 'font-family="Helvetica, unifont"',
5427 $xsl
5428 );
5429
5430 $args = [ '/_xml' => $print_output, '/_xsl' => $xsl ];
5431 $xh = xslt_create();
5432 $params = [];
5434 xslt_error($xh);
5435 xslt_free($xh);
5436 return $output;
5437 }
if(! $DIC->user() ->getId()||!ilLTIConsumerAccess::hasCustomProviderCreationAccess()) $params
Definition: ltiregstart.php:31
References $params, ILIAS\Repository\settings(), and true.
Here is the call graph for this function:
◆ qtiMaterialToArray()
| ilObjTest::qtiMaterialToArray | ( | $a_material | ) |
Reads an QTI material tag and creates a text string.
- Returns
- string text or xhtml string @access public
Definition at line 5239 of file class.ilObjTest.php.
5239 : array
5240 {
5241 $result = '';
5242 $mobs = [];
5243 for ($i = 0; $i < $a_material->getMaterialCount(); $i++) {
5244 $material = $a_material->getMaterial($i);
5245 if ($material['type'] === 'mattext') {
5246 $result .= $material['material']->getContent();
5247 }
5248 if ($material['type'] === 'matimage') {
5249 $matimage = $material['material'];
5250 if (preg_match('/(il_([0-9]+)_mob_([0-9]+))/', $matimage->getLabel(), $matches)) {
5251 $mobs[] = [
5252 'mob' => $matimage->getLabel(),
5253 'uri' => $matimage->getUri()
5254 ];
5255 }
5256 }
5257 }
5258
5259 $decoded_result = base64_decode($result);
5260 if (str_starts_with($decoded_result, '<PageObject>')) {
5261 $result = $decoded_result;
5262 }
5263
5264 return [
5265 'text' => $result,
5266 'mobs' => $mobs
5267 ];
5268 }
◆ 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 1242 of file class.ilObjTest.php.
1243 {
1244 $current_question_result = $this->db->queryF(
1245 "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
1246 ['integer','integer'],
1247 [$this->getTestId(), $question_id]
1248 );
1249 $current_question_data = $this->db->fetchObject($current_question_result);
1250 $next_question_result = $this->db->queryF(
1251 "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
1252 ['integer','integer'],
1253 [$this->getTestId(), $current_question_data->sequence + 1]
1254 );
1255 if ($this->db->numRows($next_question_result) === 1) {
1256 // OK, it's not the last question, so move it down
1257 $next_question_data = $this->db->fetchObject($next_question_result);
1258 // change next dataset
1259 $this->db->manipulateF(
1260 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
1261 ['integer','integer'],
1262 [$current_question_data->sequence, $next_question_data->test_question_id]
1263 );
1264 // move actual dataset down
1265 $this->db->manipulateF(
1266 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
1267 ['integer','integer'],
1268 [$current_question_data->sequence + 1, $current_question_data->test_question_id]
1269 );
1270 }
1271 $this->loadQuestions();
1272 }
◆ 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 1202 of file class.ilObjTest.php.
1203 {
1204 // Move a question up in sequence
1205 $result = $this->db->queryF(
1206 "SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
1207 ['integer', 'integer'],
1208 [$this->getTestId(), $question_id]
1209 );
1210 $data = $this->db->fetchObject($result);
1212 // OK, it's not the top question, so move it up
1213 $result = $this->db->queryF(
1214 "SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
1215 ['integer','integer'],
1217 );
1218 $data_previous = $this->db->fetchObject($result);
1219 // change previous dataset
1220 $this->db->manipulateF(
1221 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
1222 ['integer','integer'],
1223 [$data->sequence, $data_previous->test_question_id]
1224 );
1225 // move actual dataset up
1226 $this->db->manipulateF(
1227 "UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
1228 ['integer','integer'],
1230 );
1231 }
1232 $this->loadQuestions();
1233 }
References $data.
◆ read()
| ilObjTest::read | ( | ) |
Reimplemented from ilObject.
Definition at line 258 of file class.ilObjTest.php.
258 : void
259 {
260 parent::read();
261 $this->main_settings = null;
262 $this->score_settings = null;
263 $this->mark_schema = null;
264 $this->loadFromDb();
265 }
References loadFromDb().
Here is the call graph for this function:
◆ recalculateScores()
| ilObjTest::recalculateScores | ( | $preserve_manscoring = false | ) |
Definition at line 6336 of file class.ilObjTest.php.
6337 {
6339 $this,
6340 $this->user,
6341 $this->db,
6342 $this->test_result_repository
6343 );
6344 $scoring->setPreserveManualScores($preserve_manscoring);
6345 $scoring->recalculateSolutions();
6346 }
References ILIAS\Repository\user().
Here is the call graph for this function:
◆ reindexFixedQuestionOrdering()
| ilObjTest::reindexFixedQuestionOrdering | ( | ) |
Definition at line 5919 of file class.ilObjTest.php.
5920 {
5921 $question_set_config = $this->question_set_config_factory->getQuestionSetConfig();
5922 $reindexed_sequence_position_map = $question_set_config->reindexQuestionOrdering();
5923
5924 $this->loadQuestions();
5925
5926 return $reindexed_sequence_position_map;
5927 }
◆ removeQuestion()
| ilObjTest::removeQuestion | ( | int | $question_id | ) |
Definition at line 1033 of file class.ilObjTest.php.
1033 : void
1034 {
1035 try {
1036 $question = self::_instanciateQuestion($question_id);
1037 $question_title = $question->getTitleForHTMLOutput();
1038 $question->delete($question_id);
1040 $this->logger->logTestAdministrationInteraction(
1041 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
1042 $this->getRefId(),
1043 $this->user->getId(),
1044 TestAdministrationInteractionTypes::QUESTION_REMOVED,
1045 [
1046 AdditionalInformationGenerator::KEY_QUESTION_TITLE => $question_title
1047 ]
1048 )
1049 );
1050 }
1052 $this->logger->error($e->getMessage());
1053 $this->logger->error($e->getTraceAsString());
1054 }
1055 }
References Vendor\Package\$e, and ILIAS\Repository\logger().
Referenced by removeQuestionWithResults().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ removeQuestionFromSequences()
| ilObjTest::removeQuestionFromSequences | ( | int | $question_id, |
| array | $active_ids, | ||
| ilTestReindexedSequencePositionMap | $reindexed_sequence_position_map | ||
| ) |
- Parameters
-
array<int> $active_ids
Definition at line 996 of file class.ilObjTest.php.
1000 : void {
1002 $this,
1003 $this->db,
1004 $this->questionrepository
1005 );
1006
1007 foreach ($active_ids as $active_id) {
1009 $passSelector->setActiveId($active_id);
1010
1011 foreach ($passSelector->getExistingPasses() as $pass) {
1012 $test_sequence = $test_sequence_factory->getSequenceByActiveIdAndPass($active_id, $pass);
1013 $test_sequence->loadFromDb();
1014
1015 $test_sequence->removeQuestion($question_id, $reindexed_sequence_position_map);
1016 $test_sequence->saveToDb();
1017 }
1018 }
1019 }
References $test_sequence.
Referenced by removeQuestionWithResults().
Here is the caller graph for this function:
◆ removeQuestions()
| ilObjTest::removeQuestions | ( | array | $question_ids | ) |
- Parameters
-
array<int> $question_ids
Definition at line 1024 of file class.ilObjTest.php.
1024 : void
1025 {
1026 foreach ($question_ids as $question_id) {
1028 }
1029
1030 $this->reindexFixedQuestionOrdering();
1031 }
reindexFixedQuestionOrdering()
Definition: class.ilObjTest.php:5919
◆ removeQuestionsWithResults()
| ilObjTest::removeQuestionsWithResults | ( | array | $question_ids | ) |
Definition at line 931 of file class.ilObjTest.php.
931 : void
932 {
934 $this,
935 $this->user,
936 $this->db,
937 $this->test_result_repository
938 );
939
940 array_walk(
941 $question_ids,
943 );
944 }
removeQuestionWithResults(int $question_id, TestScoring $scoring)
Definition: class.ilObjTest.php:946
References removeQuestionWithResults(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ removeQuestionWithResults()
|
private |
Definition at line 946 of file class.ilObjTest.php.
946 : void
947 {
948 $question = \assQuestion::instantiateQuestion($question_id);
949
951 $participant_data->load($this->test_id);
952
953 $question->removeAllExistingSolutions();
954 $scoring->removeAllQuestionResults($question_id);
955
956 $this->removeQuestion($question_id);
958 $this->removeQuestionFromSequences(
959 $question_id,
960 $participant_data->getActiveIds(),
961 $this->reindexFixedQuestionOrdering()
962 );
963 }
964
965 $scoring->updatePassAndTestResults($participant_data->getActiveIds());
967 $question->delete($question_id);
968
971 $object_properties->storePropertyIsOnline(
972 $object_properties->getPropertyIsOnline()->withOffline()
973 );
974 }
975
977 $this->logger->logTestAdministrationInteraction(
978 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
979 $this->getRefId(),
980 $this->user->getId(),
981 TestAdministrationInteractionTypes::QUESTION_REMOVED_IN_CORRECTIONS,
982 [
983 AdditionalInformationGenerator::KEY_QUESTION_TITLE => $question->getTitleForHTMLOutput(),
984 AdditionalInformationGenerator::KEY_QUESTION_TEXT => $question->getQuestion(),
985 AdditionalInformationGenerator::KEY_QUESTION_ID => $question->getId(),
986 AdditionalInformationGenerator::KEY_QUESTION_TYPE => $question->getQuestionType()
987 ]
988 )
989 );
990 }
991 }
updatePassAndTestResults(array $active_ids)
Definition: TestScoring.php:283
removeAllQuestionResults($question_id)
Definition: TestScoring.php:273
static _refreshStatus(int $a_obj_id, ?array $a_users=null)
Definition: class.ilLPStatusWrapper.php:321
removeQuestionFromSequences(int $question_id, array $active_ids, ilTestReindexedSequencePositionMap $reindexed_sequence_position_map)
Definition: class.ilObjTest.php:996
References ilObject\$object_properties, ilLPStatusWrapper\_refreshStatus(), ilObject\getId(), ilObject\getObjectProperties(), getTestQuestions(), assQuestion\instantiateQuestion(), isRandomTest(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), ILIAS\Test\Scoring\Manual\TestScoring\removeAllQuestionResults(), removeQuestion(), removeQuestionFromSequences(), and ILIAS\Test\Scoring\Manual\TestScoring\updatePassAndTestResults().
Referenced by removeQuestionsWithResults().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ removeTestActives()
| ilObjTest::removeTestActives | ( | array | $active_ids | ) |
- Parameters
-
array<int> $active_ids
Definition at line 1189 of file class.ilObjTest.php.
1189 : void
1190 {
1191 $IN_activeIds = $this->db->in('active_id', $active_ids, false, 'integer');
1192 $this->db->manipulate("DELETE FROM tst_active WHERE $IN_activeIds");
1193 }
Referenced by ilCourseObjectiveResult\resetTestForUser().
Here is the caller graph for this function:
◆ removeTestResults()
| ilObjTest::removeTestResults | ( | ilTestParticipantData | $participant_data | ) |
Definition at line 1090 of file class.ilObjTest.php.
1090 : void
1091 {
1094
1095 $user_ids = array_map(
1097 $participant_data->getAnonymousActiveIds(),
1098 );
1099 $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $user_ids);
1100 }
1101
1103 /* @var ilTestLP $testLP */
1106 $test_lp->setTestObject($this);
1108 }
1109
1110 $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $participant_data->getUserIds());
1111 }
1112
1115
1116 $user_ids = array_map(
1118 $participant_data->getActiveIds(),
1119 );
1120 $this->participant_repository->removeExtraTimeByUserId($this->getTestId(), $user_ids);
1121 }
1122
1124 $this->logger->logTestAdministrationInteraction(
1125 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
1126 $this->getRefId(),
1127 $this->user->getId(),
1128 TestAdministrationInteractionTypes::PARTICIPANT_DATA_REMOVED,
1129 [
1130 AdditionalInformationGenerator::KEY_USERS => $participant_data->getUserIds(),
1131 AdditionalInformationGenerator::KEY_ANON_IDS => $participant_data->getAnonymousActiveIds()
1132 ]
1133 )
1134 );
1135 }
1136 }
removeTestResultsByActiveIds(array $active_ids)
Definition: class.ilObjTest.php:1156
Definition: class.ilTestLP.php:32
getUserIdByActiveId($activeId)
Definition: class.ilTestParticipantData.php:230
getAnonymousActiveIds()
Definition: class.ilTestParticipantData.php:267
References ilTestParticipantData\getActiveIds(), ilTestParticipantData\getAnonymousActiveIds(), ILIAS\Survey\Mode\getId(), ilObjectLP\getInstance(), ilTestParticipantData\getUserIdByActiveId(), ilTestParticipantData\getUserIds(), and ILIAS\Repository\logger().
Referenced by deleteTest().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ removeTestResultsByActiveIds()
|
private |
Definition at line 1156 of file class.ilObjTest.php.
1156 : void
1157 {
1158 $in_active_ids = $this->db->in('active_fi', $active_ids, false, 'integer');
1159
1160 $this->db->manipulate("DELETE FROM tst_solutions WHERE {$in_active_ids}");
1161 $this->db->manipulate("DELETE FROM tst_qst_solved WHERE {$in_active_ids}");
1162 $this->db->manipulate("DELETE FROM tst_test_result WHERE {$in_active_ids}");
1163 $this->db->manipulate("DELETE FROM tst_pass_result WHERE {$in_active_ids}");
1164 $this->db->manipulate("DELETE FROM tst_result_cache WHERE {$in_active_ids}");
1165 $this->db->manipulate("DELETE FROM tst_sequence WHERE {$in_active_ids}");
1166 $this->db->manipulate("DELETE FROM tst_times WHERE {$in_active_ids}");
1167 $this->db->manipulate(
1169 . ' WHERE ' . $this->db->in('active_id', $active_ids, false, 'integer')
1170 );
1171
1173 $this->db->manipulate("DELETE FROM tst_test_rnd_qst WHERE {$in_active_ids}");
1174 }
1175
1176 $this->test_result_repository->removeTestResults($active_ids, $this->getId());
1177
1178 foreach ($active_ids as $active_id) {
1179 // remove file uploads
1182 }
1183 }
1184 }
References CLIENT_WEB_DIR, ilFileUtils\delDir(), ILIAS\Survey\Mode\getId(), and PassPresentedVariablesRepo\TABLE_NAME.
Here is the call graph for this function:
◆ removeTestResultsByUserIds()
| ilObjTest::removeTestResultsByUserIds | ( | array | $user_ids | ) |
Definition at line 1138 of file class.ilObjTest.php.
1138 : void
1139 {
1141 $participantData->setUserIdsFilter($user_ids);
1142 $participantData->load($this->getTestId());
1143
1144 $in_user_ids = $this->db->in('usr_id', $participantData->getUserIds(), false, 'integer');
1145 $this->db->manipulateF(
1146 "DELETE FROM usr_pref WHERE {$in_user_ids} AND keyword = %s",
1147 ['text'],
1149 );
1150
1151 if ($participantData->getActiveIds() !== []) {
1152 $this->removeTestResultsByActiveIds($participantData->getActiveIds());
1153 }
1154 }
References ILIAS\Repository\lng().
Here is the call graph for this function:
◆ removeTestResultsFromSoapLpAdministration()
| ilObjTest::removeTestResultsFromSoapLpAdministration | ( | array | $user_ids | ) |
- at the time beeing ilObjTest::removeTestResults needs to call the LP service for deletion
- ilTestLP calls ilObjTest::removeTestResultsByUserIds
this method should only be used from non refactored soap context i think
- Parameters
-
$userIds
Definition at line 1065 of file class.ilObjTest.php.
1066 {
1067 $this->removeTestResultsByUserIds($user_ids);
1068
1070 $participantData->setUserIdsFilter($user_ids);
1071 $participantData->load($this->getTestId());
1072
1073 $this->removeTestActives($participantData->getActiveIds());
1074
1075
1077 $this->logger->logTestAdministrationInteraction(
1078 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
1079 $this->getRefId(),
1080 $this->user->getId(),
1081 TestAdministrationInteractionTypes::PARTICIPANT_DATA_REMOVED,
1082 [
1083 AdditionalInformationGenerator::KEY_USERS => $participantData->getUserIds()
1084 ]
1085 )
1086 );
1087 }
1088 }
removeTestResultsByUserIds(array $user_ids)
Definition: class.ilObjTest.php:1138
References ILIAS\Repository\lng(), and ILIAS\Repository\logger().
Here is the call graph for this function:
◆ replaceFilesInPageImports()
|
private |
Definition at line 3155 of file class.ilObjTest.php.
3155 : string
3156 {
3158 foreach ($matches[0] as $index => $match) {
3159 if (empty($mappings[$matches[2][$index]])) {
3160 continue;
3161 }
3163 }
3165 }
References $text.
◆ replaceMobsInPageImports()
|
private |
Definition at line 3142 of file class.ilObjTest.php.
3142 : string
3143 {
3145 foreach ($matches[0] as $index => $match) {
3146 if (empty($mappings[$matches[2][$index]])) {
3147 continue;
3148 }
3151 }
3153 }
static _saveUsage(int $a_mob_id, string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Save usage of mob within another container (e.g.
Definition: class.ilObjMediaObject.php:851
References $text, ilObjMediaObject\_saveUsage(), and ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ saveAuthorToMetadata()
| ilObjTest::saveAuthorToMetadata | ( | $author = "" | ) |
Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be called for conversion of "old" tests where the author hasn't been stored in the lifecycle metadata.
- Parameters
-
string $a_author A string containing the name of the test author @access private
- See also
- $author
Definition at line 3814 of file class.ilObjTest.php.
3815 {
3816 $path_to_lifecycle = $this->lo_metadata->paths()->custom()->withNextStep('lifeCycle')->get();
3817 $path_to_authors = $this->lo_metadata->paths()->authors();
3818
3820 if (!is_null($reader->allData($path_to_lifecycle)->current())) {
3821 return;
3822 }
3823
3826 }
3828 ->prepareCreateOrUpdate($path_to_authors, $author)
3829 ->execute();
3830 }
References ILIAS\Survey\Mode\getId(), and ILIAS\Repository\user().
Here is the call graph for this function:
◆ saveCompleteStatus()
| ilObjTest::saveCompleteStatus | ( | ilTestQuestionSetConfig | $test_question_set_config | ) |
Definition at line 446 of file class.ilObjTest.php.
446 : void
447 {
448 $complete = 0;
450 $complete = 1;
451 }
453 $this->db->manipulateF(
454 'UPDATE tst_tests SET complete = %s WHERE test_id = %s',
455 ['text', 'integer'],
456 [$complete, $this->test_id]
457 );
458 }
459 }
isComplete(ilTestQuestionSetConfig $test_question_set_config)
Definition: class.ilObjTest.php:432
References 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 |
||
| ) |
Definition at line 5584 of file class.ilObjTest.php.
5590 : void {
5591 $feedback_old = self::getSingleManualFeedback($active_id, $question_id, $pass);
5592 $this->db->manipulateF(
5593 'DELETE FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s',
5594 ['integer', 'integer', 'integer'],
5595 [$active_id, $question_id, $pass]
5596 );
5597
5598 $this->insertManualFeedback($active_id, $question_id, $pass, $feedback, $finalized, $feedback_old);
5599
5600 }
insertManualFeedback(int $active_id, int $question_id, int $pass, ?string $feedback, bool $finalized, array $feedback_old)
Definition: class.ilObjTest.php:5602
◆ saveQuestionsToDb()
| ilObjTest::saveQuestionsToDb | ( | ) |
Definition at line 544 of file class.ilObjTest.php.
544 : void
545 {
546 $this->db->manipulateF(
547 'DELETE FROM tst_test_question WHERE test_fi = %s',
548 ['integer'],
549 [$this->getTestId()]
550 );
551 foreach ($this->questions as $key => $value) {
552 $next_id = $this->db->nextId('tst_test_question');
553 $this->db->insert('tst_test_question', [
554 'test_question_id' => ['integer', $next_id],
556 'question_fi' => ['integer', $value],
557 'sequence' => ['integer', $key],
558 'tstamp' => ['integer', time()]
559 ]);
560 }
561 }
References getTestId().
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 461 of file class.ilObjTest.php.
461 : void
462 {
463 if ($this->test_id === -1) {
464 // Create new dataset
465 $next_id = $this->db->nextId('tst_tests');
466
467 $this->db->insert(
468 'tst_tests',
469 [
470 'test_id' => ['integer', $next_id],
472 'created' => ['integer', time()],
473 'tstamp' => ['integer', time()],
475 ]
476 );
477
478 $this->test_id = $next_id;
479
480 $this->getMainSettingsRepository()->store(
481 $this->settings_factory->createDefaultMainSettings(),
482 $this->getTestId()
483 );
484 } else {
486 // reset the finished status of participants if the nr of test passes did change
488 // set all unfinished tests with nr of passes >= allowed passes finished
489 $aresult = $this->db->queryF(
490 "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries >= %s AND submitted = %s",
491 ['integer', 'integer', 'integer'],
493 );
494 while ($row = $this->db->fetchAssoc($aresult)) {
495 $this->db->manipulateF(
496 "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
497 ['integer', 'timestamp', 'integer'],
498 [1, date('Y-m-d H:i:s'), $row["active_id"]]
499 );
500 }
501
502 // set all finished tests with nr of passes < allowed passes not finished
503 $aresult = $this->db->queryF(
504 "SELECT active_id FROM tst_active WHERE test_fi = %s AND tries < %s AND submitted = %s",
505 ['integer', 'integer', 'integer'],
507 );
508 while ($row = $this->db->fetchAssoc($aresult)) {
509 $this->db->manipulateF(
510 "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
511 ['integer', 'timestamp', 'integer'],
512 [0, null, $row["active_id"]]
513 );
514 }
515 } else {
516 // set all finished tests with nr of passes >= allowed passes not finished
517 $aresult = $this->db->queryF(
518 "SELECT active_id FROM tst_active WHERE test_fi = %s AND submitted = %s",
519 ['integer', 'integer'],
520 [$this->getTestId(), 1]
521 );
522 while ($row = $this->db->fetchAssoc($aresult)) {
523 $this->db->manipulateF(
524 "UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
525 ['integer', 'timestamp', 'integer'],
526 [0, null, $row["active_id"]]
527 );
528 }
529 }
530 }
531 }
532
533 if ($properties_only) {
534 return;
535 }
536
538 $this->saveQuestionsToDb();
539 }
540
541 $this->marks_repository->storeMarkSchema($this->getMarkSchema());
542 }
References evalTotalPersons(), ilObject\getId(), getMainSettingsRepository(), getMarkSchema(), getNrOfTries(), getQuestionSetType(), getTemplate(), getTestId(), and saveQuestionsToDb().
Here is the call graph for this function:
◆ secondsToHoursMinutesSecondsString()
|
protected |
Definition at line 5886 of file class.ilObjTest.php.
5886 : string
5887 {
5888 $diff_hours = floor($seconds / 3600);
5889 $seconds -= $diff_hours * 3600;
5890 $diff_minutes = floor($seconds / 60);
5891 $seconds -= $diff_minutes * 60;
5892 return sprintf('%02d:%02d:%02d', $diff_hours, $diff_minutes, $seconds);
5893 }
◆ setAccessFilteredParticipantList()
| ilObjTest::setAccessFilteredParticipantList | ( | ilTestParticipantList | $access_filtered_participant_list | ) |
Definition at line 2328 of file class.ilObjTest.php.
2328 : void
2329 {
2330 $this->access_filtered_participant_list = $access_filtered_participant_list;
2331 }
◆ setQuestionOrder()
| ilObjTest::setQuestionOrder | ( | array | $order | ) |
Definition at line 5929 of file class.ilObjTest.php.
5930 {
5931 asort($order);
5932
5933 $i = 0;
5934
5936 $i++;
5937
5938 $query = "
5939 UPDATE tst_test_question
5940 SET sequence = %s
5941 WHERE question_fi = %s
5942 ";
5943
5944 $this->db->manipulateF(
5945 $query,
5946 ['integer', 'integer'],
5947 [$i, $id]
5948 );
5949 }
5950
5952 $this->logger->logTestAdministrationInteraction(
5953 $this->logger->getInteractionFactory()->buildTestAdministrationInteraction(
5954 $this->getRefId(),
5955 $this->user->getId(),
5956 TestAdministrationInteractionTypes::QUESTION_MOVED,
5957 [
5958 AdditionalInformationGenerator::KEY_QUESTION_ORDER => $order
5959 ]
5960 )
5961 );
5962 }
5963
5964 $this->loadQuestions();
5965 }
References $id, and ILIAS\Repository\logger().
Here is the call graph for this function:
◆ setQuestionSetSolved()
| ilObjTest::setQuestionSetSolved | ( | $value, | |
| $question_id, | |||
| $user_id | |||
| ) |
sets question solved state to value for given user_id
Definition at line 4430 of file class.ilObjTest.php.
4431 {
4433 $this->db->manipulateF(
4434 "DELETE FROM tst_qst_solved WHERE active_fi = %s AND question_fi = %s",
4435 ['integer', 'integer'],
4436 [$active_id, $question_id]
4437 );
4438 $this->db->manipulateF(
4439 "INSERT INTO tst_qst_solved (solved, question_fi, active_fi) VALUES (%s, %s, %s)",
4440 ['integer', 'integer', 'integer'],
4441 [$value, $question_id, $active_id]
4442 );
4443 }
References $user_id.
◆ setQuestionSetType()
| ilObjTest::setQuestionSetType | ( | string | $question_set_type | ) |
Definition at line 6281 of file class.ilObjTest.php.
6282 {
6283 $this->main_settings = $this->getMainSettings()->withGeneralSettings(
6285 ->withQuestionSetType($question_set_type)
6286 );
6287 }
References getGeneralSettings().
Here is the call graph for this function:
◆ setTemplate()
| ilObjTest::setTemplate | ( | int | $template_id | ) |
Definition at line 5909 of file class.ilObjTest.php.
◆ setTestId()
| ilObjTest::setTestId | ( | $a_id | ) |
Sets the test ID.
- Parameters
-
integer $a_id Test ID
Definition at line 5680 of file class.ilObjTest.php.
5681 {
5682 $this->test_id = $a_id;
5683 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ setTmpCopyWizardCopyId()
| ilObjTest::setTmpCopyWizardCopyId | ( | int | $tmpCopyWizardCopyId | ) |
Definition at line 235 of file class.ilObjTest.php.
References $tmpCopyWizardCopyId.
◆ startingTimeReached()
| ilObjTest::startingTimeReached | ( | ) |
Returns true if the starting time of a test is reached A starting time is not available for self assessment tests.
- Returns
- boolean true if the starting time is reached, otherwise false @access public
Definition at line 2661 of file class.ilObjTest.php.
2661 : bool
2662 {
2664 $now = time();
2666 return false;
2667 }
2668 }
2669 return true;
2670 }
◆ 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 1514 of file class.ilObjTest.php.
1515 {
1516 $next_id = $this->db->nextId('tst_times');
1517 $affectedRows = $this->db->manipulateF(
1518 "INSERT INTO tst_times (times_id, active_fi, started, finished, pass, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
1519 ['integer', 'integer', 'timestamp', 'timestamp', 'integer', 'integer'],
1520 [$next_id, $active_id, date("Y-m-d H:i:s"), date("Y-m-d H:i:s"), $pass, time()]
1521 );
1522 return $next_id;
1523 }
◆ storeMarkSchema()
| ilObjTest::storeMarkSchema | ( | MarkSchema | $mark_schema | ) |
Definition at line 810 of file class.ilObjTest.php.
810 : void
811 {
812 $this->marks_repository->storeMarkSchema($mark_schema);
813 $this->mark_schema = null;
814 }
References $mark_schema.
◆ toXML()
| ilObjTest::toXML | ( | ) |
Returns a QTI xml representation of the test.
- Returns
- string The QTI xml representation of the test
Definition at line 3172 of file class.ilObjTest.php.
3172 : string
3173 {
3176 // set xml header
3177 $a_xml_writer->xmlHeader();
3178 $a_xml_writer->xmlSetDtdDef("<!DOCTYPE questestinterop SYSTEM \"ims_qtiasiv1p2p1.dtd\">");
3179 $a_xml_writer->xmlStartTag("questestinterop");
3180
3181 $attrs = [
3184 ];
3185 $a_xml_writer->xmlStartTag("assessment", $attrs);
3187
3189 $a_xml_writer->xmlElement(
3190 "duration",
3191 null,
3192 $this->getProcessingTimeForXML()
3193 );
3194 }
3195
3196 $a_xml_writer->xmlStartTag("qtimetadata");
3197 $a_xml_writer->xmlStartTag("qtimetadatafield");
3198 $a_xml_writer->xmlElement("fieldlabel", null, "ILIAS_VERSION");
3200 $a_xml_writer->xmlEndTag("qtimetadatafield");
3201
3202 $a_xml_writer->xmlStartTag("qtimetadatafield");
3203 $a_xml_writer->xmlElement("fieldlabel", null, "anonymity");
3204 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getGeneralSettings()->getAnonymity() ? 1 : 0);
3205 $a_xml_writer->xmlEndTag("qtimetadatafield");
3206
3207 $a_xml_writer->xmlStartTag("qtimetadatafield");
3208 $a_xml_writer->xmlElement("fieldlabel", null, "question_set_type");
3209 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getGeneralSettings()->getQuestionSetType());
3210 $a_xml_writer->xmlEndTag("qtimetadatafield");
3211
3212 $a_xml_writer->xmlStartTag("qtimetadatafield");
3213 $a_xml_writer->xmlElement("fieldlabel", null, "sequence_settings");
3214 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd() ? 1 : 0);
3215 $a_xml_writer->xmlEndTag("qtimetadatafield");
3216
3217 $a_xml_writer->xmlStartTag("qtimetadatafield");
3218 $a_xml_writer->xmlElement("fieldlabel", null, "author");
3220 $a_xml_writer->xmlEndTag("qtimetadatafield");
3221
3222 $a_xml_writer->xmlStartTag("qtimetadatafield");
3223 $a_xml_writer->xmlElement("fieldlabel", null, "reset_processing_time");
3224 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getResetProcessingTime() ? 1 : 0);
3225 $a_xml_writer->xmlEndTag("qtimetadatafield");
3226
3227 $a_xml_writer->xmlStartTag("qtimetadatafield");
3228 $a_xml_writer->xmlElement("fieldlabel", null, "count_system");
3230 $a_xml_writer->xmlEndTag("qtimetadatafield");
3231
3232 $a_xml_writer->xmlStartTag("qtimetadatafield");
3233 $a_xml_writer->xmlElement("fieldlabel", null, "score_cutting");
3235 $a_xml_writer->xmlEndTag("qtimetadatafield");
3236
3237 $a_xml_writer->xmlStartTag("qtimetadatafield");
3238 $a_xml_writer->xmlElement("fieldlabel", null, "password");
3239 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getPassword() ?? '');
3240 $a_xml_writer->xmlEndTag("qtimetadatafield");
3241
3242 $a_xml_writer->xmlStartTag("qtimetadatafield");
3243 $a_xml_writer->xmlElement("fieldlabel", null, "ip_range_from");
3244 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getIpRangeFrom());
3245 $a_xml_writer->xmlEndTag("qtimetadatafield");
3246
3247 $a_xml_writer->xmlStartTag("qtimetadatafield");
3248 $a_xml_writer->xmlElement("fieldlabel", null, "ip_range_to");
3249 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getIpRangeTo());
3250 $a_xml_writer->xmlEndTag("qtimetadatafield");
3251
3252 $a_xml_writer->xmlStartTag("qtimetadatafield");
3253 $a_xml_writer->xmlElement("fieldlabel", null, "pass_scoring");
3255 $a_xml_writer->xmlEndTag("qtimetadatafield");
3256
3257 $a_xml_writer->xmlStartTag('qtimetadatafield');
3258 $a_xml_writer->xmlElement('fieldlabel', null, 'pass_deletion_allowed');
3260 $a_xml_writer->xmlEndTag('qtimetadatafield');
3261
3263 $a_xml_writer->xmlStartTag("qtimetadatafield");
3264 $a_xml_writer->xmlElement("fieldlabel", null, "reporting_date");
3265 $a_xml_writer->xmlElement(
3266 "fieldentry",
3267 null,
3268 $this->buildIso8601PeriodForExportCompatibility(
3269 $this->getScoreSettings()->getResultSummarySettings()->getReportingDate(),
3270 ),
3271 );
3272 $a_xml_writer->xmlEndTag("qtimetadatafield");
3273 }
3274
3275 $a_xml_writer->xmlStartTag("qtimetadatafield");
3276 $a_xml_writer->xmlElement("fieldlabel", null, "nr_of_tries");
3277 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getNumberOfTries());
3278 $a_xml_writer->xmlEndTag("qtimetadatafield");
3279
3280 $a_xml_writer->xmlStartTag('qtimetadatafield');
3281 $a_xml_writer->xmlElement('fieldlabel', null, 'block_after_passed');
3282 $a_xml_writer->xmlElement('fieldentry', null, $main_settings->getTestBehaviourSettings()->getBlockAfterPassedEnabled() ? 1 : 0);
3283 $a_xml_writer->xmlEndTag('qtimetadatafield');
3284
3285 $a_xml_writer->xmlStartTag("qtimetadatafield");
3286 $a_xml_writer->xmlElement("fieldlabel", null, "pass_waiting");
3287 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getPassWaiting());
3288 $a_xml_writer->xmlEndTag("qtimetadatafield");
3289
3290 $a_xml_writer->xmlStartTag("qtimetadatafield");
3291 $a_xml_writer->xmlElement("fieldlabel", null, "kiosk");
3292 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getKioskMode());
3293 $a_xml_writer->xmlEndTag("qtimetadatafield");
3294
3295 $a_xml_writer->xmlStartTag('qtimetadatafield');
3296 $a_xml_writer->xmlElement("fieldlabel", null, "redirection_mode");
3297 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getRedirectionMode()->value);
3298 $a_xml_writer->xmlEndTag("qtimetadatafield");
3299
3300 $a_xml_writer->xmlStartTag('qtimetadatafield');
3301 $a_xml_writer->xmlElement("fieldlabel", null, "redirection_url");
3302 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getRedirectionUrl());
3303 $a_xml_writer->xmlEndTag("qtimetadatafield");
3304
3305 $a_xml_writer->xmlStartTag("qtimetadatafield");
3306 $a_xml_writer->xmlElement("fieldlabel", null, "use_previous_answers");
3307 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getUsePreviousAnswerAllowed() ? 1 : 0);
3308 $a_xml_writer->xmlEndTag("qtimetadatafield");
3309
3310 $a_xml_writer->xmlStartTag('qtimetadatafield');
3311 $a_xml_writer->xmlElement('fieldlabel', null, 'question_list_enabled');
3312 $a_xml_writer->xmlElement('fieldentry', null, $main_settings->getParticipantFunctionalitySettings()->getQuestionListEnabled() ? 1 : 0);
3313 $a_xml_writer->xmlEndTag('qtimetadatafield');
3314
3315 $a_xml_writer->xmlStartTag("qtimetadatafield");
3316 $a_xml_writer->xmlElement("fieldlabel", null, "title_output");
3317 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getQuestionTitleOutputMode());
3318 $a_xml_writer->xmlEndTag("qtimetadatafield");
3319
3320 $a_xml_writer->xmlStartTag("qtimetadatafield");
3321 $a_xml_writer->xmlElement("fieldlabel", null, "results_presentation");
3322 $a_xml_writer->xmlElement("fieldentry", null, $this->getScoreSettings()->getResultDetailsSettings()->getResultsPresentation());
3323 $a_xml_writer->xmlEndTag("qtimetadatafield");
3324
3325 $a_xml_writer->xmlStartTag("qtimetadatafield");
3326 $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_pass");
3327 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getExamIdInTestAttemptEnabled() ? 1 : 0);
3328 $a_xml_writer->xmlEndTag("qtimetadatafield");
3329
3330 $a_xml_writer->xmlStartTag("qtimetadatafield");
3331 $a_xml_writer->xmlElement("fieldlabel", null, "examid_in_test_res");
3332 $a_xml_writer->xmlElement("fieldentry", null, $this->getScoreSettings()->getResultDetailsSettings()->getShowExamIdInTestResults() ? 1 : 0);
3333 $a_xml_writer->xmlEndTag("qtimetadatafield");
3334
3335 $a_xml_writer->xmlStartTag("qtimetadatafield");
3336 $a_xml_writer->xmlElement("fieldlabel", null, "usr_pass_overview_mode");
3337 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getUsrPassOverviewMode());
3338 $a_xml_writer->xmlEndTag("qtimetadatafield");
3339
3340 $a_xml_writer->xmlStartTag("qtimetadatafield");
3341 $a_xml_writer->xmlElement("fieldlabel", null, "score_reporting");
3342 $a_xml_writer->xmlElement("fieldentry", null, $this->getScoreSettings()->getResultSummarySettings()->getScoreReporting()->value);
3343 $a_xml_writer->xmlEndTag("qtimetadatafield");
3344
3345 $a_xml_writer->xmlStartTag("qtimetadatafield");
3346 $a_xml_writer->xmlElement("fieldlabel", null, "show_solution_list_comparison");
3347 $a_xml_writer->xmlElement("fieldentry", null, $this->score_settings->getResultDetailsSettings()->getShowSolutionListComparison() ? 1 : 0);
3348 $a_xml_writer->xmlEndTag("qtimetadatafield");
3349
3350 $a_xml_writer->xmlStartTag("qtimetadatafield");
3351 $a_xml_writer->xmlElement("fieldlabel", null, "instant_verification");
3352 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSolutionEnabled() ? 1 : 0);
3353 $a_xml_writer->xmlEndTag("qtimetadatafield");
3354
3355 $a_xml_writer->xmlStartTag("qtimetadatafield");
3356 $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback");
3357 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackGenericEnabled() ? 1 : 0);
3358 $a_xml_writer->xmlEndTag("qtimetadatafield");
3359
3360 $a_xml_writer->xmlStartTag("qtimetadatafield");
3361 $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_specific");
3362 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled() ? 1 : 0);
3363 $a_xml_writer->xmlEndTag("qtimetadatafield");
3364
3365 $a_xml_writer->xmlStartTag("qtimetadatafield");
3366 $a_xml_writer->xmlElement("fieldlabel", null, "answer_feedback_points");
3367 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackPointsEnabled() ? 1 : 0);
3368 $a_xml_writer->xmlEndTag("qtimetadatafield");
3369
3370 $a_xml_writer->xmlStartTag("qtimetadatafield");
3371 $a_xml_writer->xmlElement("fieldlabel", null, "follow_qst_answer_fixation");
3372 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnNextQuestionEnabled() ? 1 : 0);
3373 $a_xml_writer->xmlEndTag("qtimetadatafield");
3374
3375 $a_xml_writer->xmlStartTag("qtimetadatafield");
3376 $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
3377 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled() ? 1 : 0);
3378 $a_xml_writer->xmlEndTag("qtimetadatafield");
3379
3380 $a_xml_writer->xmlStartTag("qtimetadatafield");
3381 $a_xml_writer->xmlElement("fieldlabel", null, "force_instant_feedback");
3382 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getForceInstantFeedbackOnNextQuestion() ? 1 : 0);
3383 $a_xml_writer->xmlEndTag("qtimetadatafield");
3384
3385 $highscore_metadata = [
3394 ];
3395 foreach ($highscore_metadata as $label => $value) {
3396 $a_xml_writer->xmlStartTag("qtimetadatafield");
3397 $a_xml_writer->xmlElement("fieldlabel", null, $label);
3398 $a_xml_writer->xmlElement("fieldentry", null, $value ? 1 : 0);
3399 $a_xml_writer->xmlEndTag("qtimetadatafield");
3400 }
3401 $a_xml_writer->xmlStartTag("qtimetadatafield");
3402 $a_xml_writer->xmlElement("fieldlabel", null, "highscore_top_num");
3404 $a_xml_writer->xmlEndTag("qtimetadatafield");
3405
3406 $a_xml_writer->xmlStartTag("qtimetadatafield");
3407 $a_xml_writer->xmlElement("fieldlabel", null, "suspend_test_allowed");
3408 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getSuspendTestAllowed() ? 1 : 0);
3409 $a_xml_writer->xmlEndTag("qtimetadatafield");
3410
3411 $a_xml_writer->xmlStartTag("qtimetadatafield");
3412 $a_xml_writer->xmlElement("fieldlabel", null, "show_marker");
3413 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getParticipantFunctionalitySettings()->getQuestionMarkingEnabled() ? 1 : 0);
3414 $a_xml_writer->xmlEndTag("qtimetadatafield");
3415
3416 $a_xml_writer->xmlStartTag("qtimetadatafield");
3417 $a_xml_writer->xmlElement("fieldlabel", null, "fixed_participants");
3418 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAccessSettings()->getFixedParticipants() ? 1 : 0);
3419 $a_xml_writer->xmlEndTag("qtimetadatafield");
3420
3421 $a_xml_writer->xmlStartTag("qtimetadatafield");
3422 $a_xml_writer->xmlElement("fieldlabel", null, "show_introduction");
3423 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getIntroductionSettings()->getIntroductionEnabled() ? 1 : 0);
3424 $a_xml_writer->xmlEndTag("qtimetadatafield");
3425
3426 $a_xml_writer->xmlStartTag("qtimetadatafield");
3427 $a_xml_writer->xmlElement("fieldlabel", null, 'exam_conditions');
3428 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getIntroductionSettings()->getExamConditionsCheckboxEnabled() ? 1 : 0);
3429 $a_xml_writer->xmlEndTag("qtimetadatafield");
3430
3431 $a_xml_writer->xmlStartTag("qtimetadatafield");
3432 $a_xml_writer->xmlElement("fieldlabel", null, "show_concluding_remarks");
3433 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getConcludingRemarksEnabled() ? 1 : 0);
3434 $a_xml_writer->xmlEndTag("qtimetadatafield");
3435
3436 $a_xml_writer->xmlStartTag("qtimetadatafield");
3437 $a_xml_writer->xmlElement("fieldlabel", null, "exportsettings");
3439 $a_xml_writer->xmlEndTag("qtimetadatafield");
3440
3441 $a_xml_writer->xmlStartTag("qtimetadatafield");
3442 $a_xml_writer->xmlElement("fieldlabel", null, "shuffle_questions");
3443 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getShuffleQuestions() ? 1 : 0);
3444 $a_xml_writer->xmlEndTag("qtimetadatafield");
3445
3446 $a_xml_writer->xmlStartTag("qtimetadatafield");
3447 $a_xml_writer->xmlElement("fieldlabel", null, "processing_time");
3448 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getProcessingTime());
3449 $a_xml_writer->xmlEndTag("qtimetadatafield");
3450
3451 $a_xml_writer->xmlStartTag("qtimetadatafield");
3452 $a_xml_writer->xmlElement("fieldlabel", null, "enable_examview");
3453 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getFinishingSettings()->getShowAnswerOverview() ? 1 : 0);
3454 $a_xml_writer->xmlEndTag("qtimetadatafield");
3455
3456 $a_xml_writer->xmlStartTag("qtimetadatafield");
3457 $a_xml_writer->xmlElement("fieldlabel", null, "skill_service");
3458 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getAdditionalSettings()->getSkillsServiceEnabled() ? 1 : 0);
3459 $a_xml_writer->xmlEndTag("qtimetadatafield");
3460
3462 $attrs = [
3463 "solutionswitch" => "Yes"
3464 ];
3465 } else {
3466 $attrs = null;
3467 }
3468 $a_xml_writer->xmlElement("assessmentcontrol", $attrs, null);
3469
3470 $a_xml_writer->xmlStartTag("qtimetadatafield");
3471 $a_xml_writer->xmlElement("fieldlabel", null, "show_grading_status");
3473 $a_xml_writer->xmlEndTag("qtimetadatafield");
3474
3475 $a_xml_writer->xmlStartTag("qtimetadatafield");
3476 $a_xml_writer->xmlElement("fieldlabel", null, "show_grading_mark");
3478 $a_xml_writer->xmlEndTag("qtimetadatafield");
3479
3480 $a_xml_writer->xmlStartTag('qtimetadatafield');
3481 $a_xml_writer->xmlElement('fieldlabel', null, 'hide_info_tab');
3482 $a_xml_writer->xmlElement('fieldentry', null, $this->getMainSettings()->getAdditionalSettings()->getHideInfoTab() ? 1 : 0);
3483 $a_xml_writer->xmlEndTag("qtimetadatafield");
3484
3486 $a_xml_writer->xmlStartTag("qtimetadatafield");
3487 $a_xml_writer->xmlElement("fieldlabel", null, "starting_time");
3488 $a_xml_writer->xmlElement(
3489 "fieldentry",
3490 null,
3491 $this->buildIso8601PeriodForExportCompatibility(
3493 ),
3494 );
3495 $a_xml_writer->xmlEndTag("qtimetadatafield");
3496 }
3497
3499 $a_xml_writer->xmlStartTag("qtimetadatafield");
3500 $a_xml_writer->xmlElement("fieldlabel", null, "ending_time");
3501 $a_xml_writer->xmlElement(
3502 "fieldentry",
3503 null,
3504 $this->buildIso8601PeriodForExportCompatibility(
3506 ),
3507 );
3508 $a_xml_writer->xmlEndTag("qtimetadatafield");
3509 }
3510
3511 $a_xml_writer->xmlStartTag("qtimetadatafield");
3512 $a_xml_writer->xmlElement("fieldlabel", null, "autosave");
3513 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getAutosaveEnabled() ? 1 : 0);
3514 $a_xml_writer->xmlEndTag("qtimetadatafield");
3515
3516 $a_xml_writer->xmlStartTag("qtimetadatafield");
3517 $a_xml_writer->xmlElement("fieldlabel", null, "autosave_ival");
3518 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getAutosaveInterval());
3519 $a_xml_writer->xmlEndTag("qtimetadatafield");
3520
3521 $a_xml_writer->xmlStartTag("qtimetadatafield");
3522 $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_specific");
3523 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getInstantFeedbackSpecificEnabled() ? 1 : 0);
3524 $a_xml_writer->xmlEndTag("qtimetadatafield");
3525
3526 $a_xml_writer->xmlStartTag("qtimetadatafield");
3527 $a_xml_writer->xmlElement("fieldlabel", null, "instant_feedback_answer_fixation");
3528 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getQuestionBehaviourSettings()->getLockAnswerOnInstantFeedbackEnabled() ? 1 : 0);
3529 $a_xml_writer->xmlEndTag("qtimetadatafield");
3530
3531 $a_xml_writer->xmlStartTag("qtimetadatafield");
3532 $a_xml_writer->xmlElement("fieldlabel", null, "enable_processing_time");
3533 $a_xml_writer->xmlElement("fieldentry", null, $main_settings->getTestBehaviourSettings()->getProcessingTimeEnabled() ? 1 : 0);
3534 $a_xml_writer->xmlEndTag("qtimetadatafield");
3535
3537 $a_xml_writer->xmlStartTag("qtimetadatafield");
3538 $a_xml_writer->xmlElement("fieldlabel", null, "mark_step_$index");
3539 $a_xml_writer->xmlElement("fieldentry", null, sprintf(
3540 "<short>%s</short><official>%s</official><percentage>%.2f</percentage><passed>%d</passed>",
3541 $mark->getShortName(),
3542 $mark->getOfficialName(),
3543 $mark->getMinimumLevel(),
3544 $mark->getPassed()
3545 ));
3546 $a_xml_writer->xmlEndTag("qtimetadatafield");
3547 }
3548 $a_xml_writer->xmlEndTag("qtimetadata");
3549
3551 $introduction = $page_id !== null
3554
3555 $a_xml_writer->xmlStartTag("objectives");
3556 $this->addQTIMaterial($a_xml_writer, $page_id, $introduction);
3557 $a_xml_writer->xmlEndTag("objectives");
3558
3560 $attrs = [
3561 "solutionswitch" => "Yes"
3562 ];
3563 } else {
3564 $attrs = null;
3565 }
3566 $a_xml_writer->xmlElement("assessmentcontrol", $attrs, null);
3567
3570 $concluding_remarks = $page_id !== null
3573 // add qti presentation_material
3574 $a_xml_writer->xmlStartTag("presentation_material");
3575 $a_xml_writer->xmlStartTag("flow_mat");
3576 $this->addQTIMaterial($a_xml_writer, $page_id, $concluding_remarks);
3577 $a_xml_writer->xmlEndTag("flow_mat");
3578 $a_xml_writer->xmlEndTag("presentation_material");
3579 }
3580
3581 $attrs = [
3582 "ident" => "1"
3583 ];
3584 $a_xml_writer->xmlElement("section", $attrs, null);
3585 $a_xml_writer->xmlEndTag("assessment");
3586 $a_xml_writer->xmlEndTag("questestinterop");
3587
3588 $xml = $a_xml_writer->xmlDumpMem(false);
3589 return $xml;
3590 }
buildIso8601PeriodForExportCompatibility(DateTimeImmutable $date_time)
Definition: class.ilObjTest.php:3592
getHighscoreWTime()
Gets if the column with the workingtime should be shown.
Definition: class.ilObjTest.php:6122
getHighscoreOwnTable()
Gets if the own rankings table should be shown.
Definition: class.ilObjTest.php:6130
getHighscoreTopTable()
Gets, if the top-rankings table should be shown.
Definition: class.ilObjTest.php:6138
isShowGradingStatusEnabled()
Definition: class.ilObjTest.php:6414
getHighscorePercentage()
Gets if the percentage column should be shown.
Definition: class.ilObjTest.php:6114
addQTIMaterial(ilXmlWriter &$xml_writer, ?int $page_id, string $material='')
Definition: class.ilObjTest.php:5270
getHighscoreAchievedTS()
Returns if date and time of the scores achievement should be displayed.
Definition: class.ilObjTest.php:6098
getHighscoreTopNum(int $a_retval=10)
Gets the number of entries which are to be shown in the top-rankings table.
Definition: class.ilObjTest.php:6147
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilXmlWriter.php:33
References ilRTE\_replaceMediaObjectImageSrc(), ILIAS\Test\Settings\MainSettings\MainSettings\getAccessSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getAdditionalSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getFinishingSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getGeneralSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getIntroductionSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getParticipantFunctionalitySettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getQuestionBehaviourSettings(), ILIAS\Test\Settings\MainSettings\MainSettings\getTestBehaviourSettings(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), IL_INST_ID, and ILIAS_VERSION.
Here is the call graph for this function:
◆ update()
| ilObjTest::update | ( | ) |
Reimplemented from ilObject.
Definition at line 247 of file class.ilObjTest.php.
247 : bool
248 {
249 if (!parent::update()) {
250 return false;
251 }
252
253 // put here object specific stuff
254 $this->updateMetaData();
255 return true;
256 }
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 1531 of file class.ilObjTest.php.
1532 {
1533 $affectedRows = $this->db->manipulateF(
1534 "UPDATE tst_times SET finished = %s, tstamp = %s WHERE times_id = %s",
1535 ['timestamp', 'integer', 'integer'],
1536 [date('Y-m-d H:i:s'), time(), $times_id]
1537 );
1538 }
◆ 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 5369 of file class.ilObjTest.php.
5369 : string
5370 {
5373 } else {
5375 if (strlen($uname["firstname"] . $uname["lastname"]) == 0) {
5377 }
5378 if ($sorted_order) {
5379 return trim($uname["lastname"] . ", " . $uname["firstname"]) . $suffix;
5380 } else {
5381 return trim($uname["firstname"] . " " . $uname["lastname"]) . $suffix;
5382 }
5383 }
5384 }
References $user_id, ilObjUser\_lookupName(), and ILIAS\Repository\lng().
Here is the call graph for this function:
Field Documentation
◆ $access_filtered_participant_list
|
protected |
Definition at line 143 of file class.ilObjTest.php.
◆ $activation_ending_time
|
protected |
Definition at line 108 of file class.ilObjTest.php.
◆ $activation_limited
|
private |
Definition at line 74 of file class.ilObjTest.php.
◆ $activation_starting_time
|
protected |
Definition at line 107 of file class.ilObjTest.php.
◆ $activation_visibility
|
protected |
Definition at line 106 of file class.ilObjTest.php.
◆ $author
| string ilObjTest::$author |
Definition at line 84 of file class.ilObjTest.php.
◆ $bench
|
protected |
Definition at line 123 of file class.ilObjTest.php.
◆ $component_factory
|
private |
Definition at line 140 of file class.ilObjTest.php.
◆ $component_repository
|
private |
Definition at line 139 of file class.ilObjTest.php.
◆ $ctrl
|
protected |
Definition at line 120 of file class.ilObjTest.php.
◆ $evaluation_data
| ilObjTest::$evaluation_data |
Contains the evaluation data settings the tutor defines for the user.
Definition at line 95 of file class.ilObjTest.php.
◆ $export_factory
|
protected |
Definition at line 137 of file class.ilObjTest.php.
◆ $file_ids
|
private |
Definition at line 76 of file class.ilObjTest.php.
◆ $filesystem_web
|
private |
Definition at line 141 of file class.ilObjTest.php.
◆ $global_settings_repo
|
protected |
Definition at line 126 of file class.ilObjTest.php.
◆ $invitation
| int ilObjTest::$invitation = self::INVITATION_OFF |
Definition at line 83 of file class.ilObjTest.php.
◆ $isSkillManagementGloballyActivated
|
staticprivate |
Definition at line 6401 of file class.ilObjTest.php.
◆ $lo_metadata
|
protected |
Definition at line 147 of file class.ilObjTest.php.
◆ $log_viewer
|
protected |
Definition at line 134 of file class.ilObjTest.php.
Referenced by getTestLogViewer().
◆ $logger
|
protected |
Definition at line 133 of file class.ilObjTest.php.
Referenced by getTestLogger().
◆ $main_settings
|
protected |
Definition at line 127 of file class.ilObjTest.php.
◆ $main_settings_repository
|
protected |
Definition at line 128 of file class.ilObjTest.php.
◆ $mark_schema
|
private |
Definition at line 81 of file class.ilObjTest.php.
Referenced by getMarkSchema(), and storeMarkSchema().
◆ $marks_repository
|
private |
Definition at line 80 of file class.ilObjTest.php.
◆ $metadata
| ilObjTest::$metadata |
A reference to an IMS compatible matadata set.
Definition at line 89 of file class.ilObjTest.php.
◆ $mob_ids
|
private |
Definition at line 75 of file class.ilObjTest.php.
◆ $online
|
private |
Definition at line 77 of file class.ilObjTest.php.
◆ $participant_access_filter
|
protected |
Definition at line 124 of file class.ilObjTest.php.
◆ $participant_repository
|
protected |
Definition at line 144 of file class.ilObjTest.php.
◆ $participantDataExist
|
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 115 of file class.ilObjTest.php.
◆ $print_best_solution_with_result
|
protected |
Definition at line 104 of file class.ilObjTest.php.
◆ $question_set_config_factory
|
protected |
Definition at line 135 of file class.ilObjTest.php.
◆ $questionrepository
|
protected |
Definition at line 78 of file class.ilObjTest.php.
◆ $questions
| array ilObjTest::$questions = [] |
Definition at line 90 of file class.ilObjTest.php.
◆ $refinery
|
protected |
Definition at line 121 of file class.ilObjTest.php.
◆ $score_settings
|
protected |
Definition at line 129 of file class.ilObjTest.php.
◆ $score_settings_repository
|
protected |
Definition at line 130 of file class.ilObjTest.php.
◆ $settings
|
protected |
Definition at line 122 of file class.ilObjTest.php.
◆ $settings_factory
|
protected |
Definition at line 131 of file class.ilObjTest.php.
◆ $template_id
|
private |
Definition at line 102 of file class.ilObjTest.php.
◆ $test_id
| int ilObjTest::$test_id = -1 |
Definition at line 82 of file class.ilObjTest.php.
Referenced by getTestId().
◆ $test_man_scoring_done_helper
|
private |
Definition at line 119 of file class.ilObjTest.php.
◆ $test_result_repository
|
protected |
Definition at line 145 of file class.ilObjTest.php.
◆ $test_sequence
| ilObjTest::$test_sequence = false |
contains the test sequence data
Definition at line 100 of file class.ilObjTest.php.
Referenced by removeQuestionFromSequences().
◆ $testrequest
|
private |
Definition at line 79 of file class.ilObjTest.php.
◆ $tmpCopyWizardCopyId
|
private |
Definition at line 117 of file class.ilObjTest.php.
Referenced by getTmpCopyWizardCopyId(), and setTmpCopyWizardCopyId().
◆ INVITATION_OFF
| const ilObjTest::INVITATION_OFF = 0 |
Definition at line 69 of file class.ilObjTest.php.
◆ INVITATION_ON
| const ilObjTest::INVITATION_ON = 1 |
Definition at line 70 of file class.ilObjTest.php.
◆ QUESTION_SET_TYPE_FIXED
| const ilObjTest::QUESTION_SET_TYPE_FIXED = 'FIXED_QUEST_SET' |
Definition at line 67 of file class.ilObjTest.php.
Referenced by ilObjTestGUI\executeAfterQuestionCreationTasks(), ILIAS\Test\Results\Data\Repository\fetchAdditionalTestData(), SettingsGeneralTest\getAndWithQuestionSetTypeDataProvider(), getQuestionCountAndPointsForPassOfParticipant(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), ilObjTestGUI\importFile(), ilLOTestAssignmentForm\initForm(), and ILIAS\Test\Tests\Results\Data\TestResultRepositoryTest\mockUpdateTestAttemptResult().
◆ QUESTION_SET_TYPE_RANDOM
| const ilObjTest::QUESTION_SET_TYPE_RANDOM = 'RANDOM_QUEST_SET' |
Definition at line 68 of file class.ilObjTest.php.
Referenced by ILIAS\Test\Results\Data\Repository\fetchAdditionalTestData(), SettingsGeneralTest\getAndWithQuestionSetTypeDataProvider(), getQuestionCountAndPointsForPassOfParticipant(), getQuestionSetTypeTranslation(), ilQTIParser\handlerVerifyEndTag(), and ilLOTestAssignmentForm\initForm().
◆ SCORE_BEST_PASS
| const ilObjTest::SCORE_BEST_PASS = 1 |
Definition at line 72 of file class.ilObjTest.php.
◆ SCORE_LAST_PASS
| const ilObjTest::SCORE_LAST_PASS = 0 |
Definition at line 71 of file class.ilObjTest.php.
Referenced by ilTestServiceGUI\isGradingMessageRequired().
The documentation for this class was generated from the following file:
- components/ILIAS/Test/classes/class.ilObjTest.php
