ILIAS  eassessment Revision 61809
 All Data Structures Namespaces Files Functions Variables Groups Pages
Public Member Functions | Static Public Member Functions | Data Fields | Protected Member Functions | Protected Attributes | Private Attributes
ilObjTest Class Reference
+ Inheritance diagram for ilObjTest:
+ Collaboration diagram for ilObjTest:

Public Member Functions

 ilObjTest ($a_id=0, $a_call_by_reference=true)
 Constructor public.
 create ($a_upload=false)
 create test object
 update ()
 update object data
 createReference ()
 Creates a database reference id for the object (saves the object to the database and creates a reference id in the database)
 read ($a_force_db=false)
 read object data from db into object
 delete ()
 delete object and all related data
 deleteTest ()
 Deletes the test and all related objects, files and database entries.
 initDefaultRoles ()
 init default roles settings
 notify ($a_event, $a_ref_id, $a_parent_non_rbac_id, $a_node_id, $a_params=0)
 notifys an object about an event occured Based on the event happend, each object may decide how it reacts.
 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)
 getExportDirectory ()
 Get the location of the export directory for the test.
 getExportFiles ($dir)
 Get a list of the already exported files in the export directory.
 _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)
 _setImportDirectory ($a_import_dir=null)
 set import directory
 _getImportDirectory ()
 Get the import directory location of the test.
 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)
 getImportDirectory ()
 Get the import directory location of the test.
 setImportDirectory ($a_import_dir)
 Set import directory.
 hasSingleChoiceQuestions ()
 Returns TRUE if the test contains single choice results.
 isSingleChoiceTest ()
 Returns TRUE if the test contains single choice results only.
 isSingleChoiceTestWithoutShuffle ()
 Returns TRUE if the test contains single choice results and no shuffle only.
 isComplete ()
 Returns 1 (true), if a test is complete for use.
 _isComplete ($obj_id)
 Returns true, if a test is complete for use.
 saveECTSStatus ($ects_output=0, $fx_support="", $ects_a=90, $ects_b=65, $ects_c=35, $ects_d=10, $ects_e=0)
 Saves the ECTS status (output of ECTS grades in a test) to the database.
 saveCompleteStatus ()
 Checks if the test is complete and saves the status in the database.
 getAllRTEContent ()
 Returns the content of all RTE enabled text areas in the test.
 cleanupMediaobjectUsage ()
 Cleans up the media objects for all text fields in a test which are using an RTE field.
 saveToDb ($properties_only=FALSE)
 Saves a ilObjTest object to a database.
 saveQuestionsToDb ()
 Saves the test questions to the database.
 saveRandomQuestion ($active_id, $question_id, $pass=NULL, $maxcount)
 Saves a random question to the database.
 getRandomQuestionDuplicate ($question_id, $active_id)
 Returns the question id of the duplicate of a question which is already in use in a random test.
 getNrOfResultsForPass ($active_id, $pass)
 Calculates the number of user results for a specific test pass.
 hasRandomQuestionsForPass ($active_id, $pass)
 Checkes whether a random test has already created questions for a given pass or not.
 generateRandomQuestions ($active_id, $pass=NULL)
 Generates new random questions for the active user.
 saveRandomQuestionCount ($total_questions=NULL)
 Saves the total amount of a tests random questions to the database.
& getRandomQuestionpools ()
 Returns an array containing the random questionpools saved to the database.
 saveRandomQuestionpools ()
 Saves the question pools used for a random test.
 getUsedRandomQuestionpools ()
 Creates an array with title and question count of used random questionpools.
 addRandomQuestionpoolData ($count=0, $qpl=0, $position)
 removeRandomQuestionpoolData ($position)
 setRandomQuestionpoolData ($a_data)
& getRandomQuestionpoolData ()
 Returns an array containing ilRandomTestData objects containing the random test selection.
 loadFromDb ()
 Loads a ilObjTest object from a database.
 loadQuestions ($active_id="", $pass=NULL)
 Load the test question id's from the database.
 setIntroduction ($introduction="")
 Sets the introduction text of the ilObjTest object.
 setFinalStatement ($a_statement="")
 Sets the final statement text of the ilObjTest object.
 setRedirectAfterExam ($a_url="")
 Sets the redirect after exam URL.
 setRedirectOnlyKioskMode ($a_int=1)
 Sets "redirection only in kiosk mode" setting.
 setExamPdf ($a_int=0)
 Sets "save exam pdf" setting.
 setShowInfo ($a_info=1)
 Set whether the complete information page is shown or the required data only.
 setForceJS ($a_js=1)
 Set whether JavaScript should be forced for tests.
 setCustomStyle ($a_customStyle=NULL)
 Set the custom style.
 getCustomStyle ()
 Get the custom style.
 getCustomStyles ()
 Return the available custom styles.
 getTestStyleLocation ($mode="output")
 get full style sheet file name (path inclusive) of current user
 setShowFinalStatement ($show=0)
 Sets whether the final statement should be shown or not.
 isRandomTest ()
 Gets the status of the $random_test attribute.
 getRandomQuestionCount ()
 Gets the number of random questions used for a random test.
 getIntroduction ()
 Gets the introduction text of the ilObjTest object.
 getFinalStatement ()
 Gets the final statement.
 getRedirectAfterExam ()
 Gets redirect after exam URL.
 getRedirectOnlyKioskMode ()
 Gets the "redirect only in kiosk mode" setting.
 getExamPdf ()
 Gets the "save exam pdf" setting.
 getShowInfo ()
 Gets whether the complete information page is shown or the required data only.
 getForceJS ()
 Gets whether JavaScript should be forced for tests.
 getShowFinalStatement ()
 Returns whether the final statement should be shown or not.
 getTestId ()
 Gets the database id of the additional test data.
 getECTSOutput ()
 Indicates if ECTS grades output is presented in this test.
 setECTSOutput ($a_ects_output)
 Enables/Disables ECTS grades output for this test.
 getECTSFX ()
 Returns the ECTS FX grade.
 setECTSFX ($a_ects_fx)
 Sets the ECTS FX grade.
& getECTSGrades ()
 Returns the ECTS grades.
 setECTSGrades ($a_ects_grades)
 Sets the ECTS grades.
 setSequenceSettings ($sequence_settings=0)
 Sets the sequence settings of the ilObjTest object.
 setScoreReporting ($score_reporting=0)
 Sets the score reporting of the ilObjTest object.
 setInstantFeedbackSolution ($instant_feedback=0)
 Sets the instant feedback for the solution.
 setAnswerFeedback ($answer_feedback=0)
 Sets the answer specific feedback for the test.
 setAnswerFeedbackPoints ($answer_feedback_points=0)
 Sets the answer specific feedback of reached points for the test.
 setRandomTest ($a_random_test=0)
 Sets the random test indicator.
 setRandomQuestionCount ($a_random_question_count="")
 Sets the random question count.
 setReportingDate ($reporting_date)
 Sets the reporting date of the ilObjTest object.
 getSequenceSettings ()
 Gets the sequence settings of the ilObjTest object.
 getScoreReporting ()
 Gets the score reporting of the ilObjTest object.
 getInstantFeedbackSolution ()
 Returns 1 if the correct solution will be shown after answering a question.
 getAnswerFeedback ()
 Returns 1 if answer specific feedback is activated.
 getAnswerFeedbackPoints ()
 Returns 1 if answer specific feedback as reached points is activated.
 getCountSystem ()
 Gets the count system for the calculation of points.
 _getCountSystem ($active_id)
 Gets the count system for the calculation of points.
 getMCScoring ()
 Gets the scoring type for multiple choice questions.
 getScoreCutting ()
 Determines if the score of a question should be cut at 0 points or the score of the whole test.
 getPassword ()
 Returns the password for test access.
 getPassScoring ()
 Gets the pass scoring type.
 _getPassScoring ($active_id)
 Gets the pass scoring type.
 _getMCScoring ($active_id)
 Gets the scoring type for multiple choice questions.
 _getScoreCutting ($active_id)
 Determines if the score of a question should be cut at 0 points or the score of the whole test.
 getReportingDate ()
 Gets the reporting date of the ilObjTest object.
 getNrOfTries ()
 Returns the nr of tries for the test.
 getKiosk ()
 Returns the kiosk mode.
 setKiosk ($kiosk=0)
 Sets the kiosk mode for the test.
 getKioskMode ()
 Returns the kiosk mode.
 setKioskMode ($a_kiosk=FALSE)
 Sets the kiosk mode for the test.
 getShowKioskModeTitle ()
 Returns the status of the kiosk mode title.
 setShowKioskModeTitle ($a_title=FALSE)
 Set to true, if the full test title should be shown in kiosk mode.
 getShowKioskModeParticipant ()
 Returns the status of the kiosk mode participant.
 setShowKioskModeParticipant ($a_participant=FALSE)
 Set to true, if the participant's name should be shown in kiosk mode.
 getUsePreviousAnswers ()
 Returns if the previous answers should be shown for a learner.
 getTitleOutput ()
 Returns the value of the title_output status.
 _getTitleOutput ($active_id)
 Returns the value of the title_output status.
 _getUsePreviousAnswers ($active_id, $user_active_user_setting=false)
 Returns if the previous results should be hidden for a learner.
 getProcessingTime ()
 Returns the processing time for the test.
 getProcessingTimeAsArray ()
 Returns the processing time for the test.
 getProcessingTimeInSeconds ($active_id="")
 Returns the processing time for the test in seconds.
 getSecondsUntilEndingTime ()
 Returns the seconds left from the actual time until the ending time.
 getEnableProcessingTime ()
 Returns the state of the processing time (enabled/disabled)
 getResetProcessingTime ()
 Returns whether the processing time should be reset or not.
 getStartingTime ()
 Returns the starting time of the test.
 getEndingTime ()
 Returns the ending time of the test.
 setNrOfTries ($nr_of_tries=0)
 Sets the nr of tries for the test.
 setUsePreviousAnswers ($use_previous_answers=1)
 Sets the status of the visibility of previous learner answers.
 setTitleOutput ($title_output=0)
 Sets the status of the title output.
 setProcessingTime ($processing_time="00:00:00")
 Sets the processing time for the test.
 setEnableProcessingTime ($enable=0)
 Sets the processing time enabled or disabled.
 setResetProcessingTime ($reset=0)
 Sets whether the processing time should be reset or not.
 setStartingTime ($starting_time=NULL)
 Sets the starting time in database timestamp format for the test.
 setEndingTime ($ending_time=NULL)
 Sets the ending time in database timestamp format for the test.
 setCountSystem ($a_count_system=COUNT_PARTIAL_SOLUTIONS)
 Sets the count system for the calculation of points.
 setPassword ($a_password=NULL)
 Sets the password for test access.
 setScoreCutting ($a_score_cutting=SCORE_CUT_QUESTION)
 Sets the type of score cutting.
 setMCScoring ($a_mc_scoring=SCORE_ZERO_POINTS_WHEN_UNANSWERED)
 Sets the multiple choice scoring.
 setPassScoring ($a_pass_scoring=SCORE_LAST_PASS)
 Sets the pass scoring.
 removeQuestion ($question_id)
 Removes a question from the test object.
 removeAllTestEditings ($question_id="")
 Removes all references to the question in executed tests in case the question has been changed.
 removeSelectedTestResults ($active_ids)
 removeTestResultsForUser ($user_id)
 questionMoveUp ($question_id)
 Moves a question up in order.
 questionMoveDown ($question_id)
 Moves a question down in order.
 duplicateQuestionForTest ($question_id)
 Takes a question and creates a copy of the question for use in the test.
 insertQuestion ($question_id)
 Insert a question in the list of questions.
& getQuestionTitles ()
 Returns the titles of the test questions in question sequence.
& getQuestionTitlesAndIndexes ()
 Returns the titles of the test questions in question sequence.
& getQuestionOIDsByAID ()
 getQuestionTitle ($title)
 Returns the title of a test question and checks if the title output is allowed.
 getQuestionDataset ($question_id)
 Returns the dataset for a given question id.
& getExistingQuestions ($pass=NULL)
 Get the id's of the questions which are already part of the test.
 getQuestionType ($question_id)
 Returns the question type of a question with a given id.
 startWorkingTime ($active_id, $question_id, $pass)
 Write the initial entry for the tests working time to the database.
 updateWorkingTime ($times_id)
 Update the working time of a test when a question is answered.
& getWorkedQuestions ($active_id, $pass=NULL)
 Gets the id's of all questions a user already worked through.
 isTestFinishedToViewResults ($active_id, $currentpass)
 Returns true if an active user completed a test pass and did not start a new pass.
& getAllQuestions ($pass=NULL)
 Returns all questions of a test in test order.
 getActiveIdOfUser ($user_id="", $anonymous_id="")
 Gets the active id of a given user.
 _getActiveIdOfUser ($user_id="", $test_id="")
 Gets the active id of the tst_active table for the active user.
 pcArrayShuffle ($array)
 Shuffles the values of a given array.
& getTestResult ($active_id, $pass=NULL, $ordered_sequence=FALSE)
 Calculates the results of a test for a given user and returns an array with all test results.
 evalTotalPersons ()
 Returns the number of persons who started the test.
 getCompleteWorkingTime ($user_id)
 Returns the complete working time in seconds a user worked on the test.
& getCompleteWorkingTimeOfParticipants ()
 Returns the complete working time in seconds for all test participants.
& _getCompleteWorkingTimeOfParticipants ($test_id)
 Returns the complete working time in seconds for all test participants.
 getCompleteWorkingTimeOfParticipant ($active_id)
 Returns the complete working time in seconds for a test participant.
 _getWorkingTimeOfParticipantForPass ($active_id, $pass)
 Returns the complete working time in seconds for a test participant.
 getVisitTimeOfParticipant ($active_id)
 Returns the first and last visit of a participant.
 _getVisitTimeOfParticipant ($test_id, $active_id)
 Returns the first and last visit of a participant.
& evalStatistical ($active_id)
 Returns the statistical evaluation of the test for a specified user.
& getTotalPointsPassedArray ()
 Returns an array with the total points of all users who passed the test This array could be used for statistics.
& getParticipants ()
 Returns all persons who started the test.
& evalTotalPersonsArray ($name_sort_order="asc")
 Returns all persons who started the test.
& evalTotalParticipantsArray ($name_sort_order="asc")
 Returns all participants who started the test.
 evalTotalFinished ()
 Returns the number of total finished tests.
& getQuestionsOfTest ($active_id)
 Retrieves all the assigned questions for all test passes of a test participant.
& getQuestionsOfPass ($active_id, $pass)
 Retrieves all the assigned questions for a test participant in a given test pass.
 getUnfilteredEvaluationData ()
 _getQuestionCountAndPointsForPassOfParticipant ($active_id, $pass)
& getCompleteEvaluationData ($withStatistics=TRUE, $filterby="", $filtertext="")
& evalResultsOverview ()
 Creates an associated array with the results of all participants of a test.
& _evalResultsOverview ($test_id)
 Creates an associated array with the results of all participants of a test.
& evalResultsOverviewOfParticipant ($active_id)
 Creates an associated array with the results for a given participant of a test.
 buildName ($user_id, $firstname, $lastname, $title)
 Builds a user name for the output depending on test type and existence of the user.
 _buildName ($is_anonymous, $user_id, $firstname, $lastname, $title)
 Builds a user name for the output depending on test type and existence of the user.
 evalTotalStartedAverageTime ()
 Returns the average processing time for all started tests.
& getAvailableQuestionpools ($use_object_id=false, $equal_points=false, $could_be_offline=false, $show_path=FALSE, $with_questioncount=FALSE, $permission="read")
 Returns the available question pools for the active user.
 getEstimatedWorkingTime ()
 Returns the estimated working time for the test calculated from the working time of the contained questions.
 generateRandomPass ($nr, $qpls, $pass=NULL)
 Generates a random test pass for a random test.
 randomSelectQuestions ($nr_of_questions, $questionpool, $use_obj_id=0, $qpls="", $pass=NULL)
 Returns a random selection of questions.
 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.
 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.
& createQuestionGUI ($question_type, $question_id=-1)
 Creates a question GUI instance of a given question type.
& _instanciateQuestion ($question_id)
 Creates an instance of a question with a given question id.
 moveQuestions ($move_questions, $target_index, $insert_mode)
 Move questions to another position.
 startingTimeReached ()
 Returns true if the starting time of a test is reached A starting time is not available for self assessment tests.
 endingTimeReached ()
 Returns true if the ending time of a test is reached An ending time is not available for self assessment tests.
 getAvailableQuestions ($arrFilter, $completeonly=0)
 Calculates the available questions for a test.
& getQuestionTypeTranslations ()
 fromXML (&$assessment)
 Receives parameters from a QTI parser and creates a valid ILIAS test object.
 exportPagesXML (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog)
 export pages of test to xml (see ilias_co.dtd)
 exportXMLMetaData (&$a_xml_writer)
 export content objects meta data to xml (see ilias_co.dtd)
 modifyExportIdentifier ($a_tag, $a_param, $a_value)
 Returns the installation id for a given identifier.
 exportXMLPageObjects (&$a_xml_writer, $a_inst, &$expLog)
 export page objects to xml (see ilias_co.dtd)
 exportXMLMediaObjects (&$a_xml_writer, $a_inst, $a_target_dir, &$expLog)
 export media objects to xml (see ilias_co.dtd)
 exportFileItems ($a_target_dir, &$expLog)
 export files of file itmes
 getImportMapping ()
 get array of (two) new created questions for import id
 getECTSGrade ($passed_array, $reached_points, $max_points)
 Returns the ECTS grade for a number of reached points.
 _getECTSGrade ($points_passed, $reached_points, $max_points, $a, $b, $c, $d, $e, $fx)
 Returns the ECTS grade for a number of reached points.
 checkMarks ()
 getMarkSchema ()
 setAuthor ($author="")
 Sets the authors name of the ilObjTest object.
 saveAuthorToMetadata ($a_author="")
 Saves an authors name into the lifecycle metadata if no lifecycle metadata exists This will only be called for conversion of "old" tests where the author hasn't been stored in the lifecycle metadata.
 createMetaData ()
 Create meta data entry.
 getAuthor ()
 Gets the authors name of the ilObjTest object.
 _lookupAuthor ($obj_id)
 Gets the authors name of the ilObjTest object.
& _getAvailableTests ($use_object_id=FALSE)
 Returns the available tests for the active user.
 cloneRandomQuestions ($new_id)
 Duplicates the source random questionpools for another test.
 cloneObject ($a_target_id, $a_copy_id=0)
 Clone object.
 getQuestionCount ()
 Returns the number of questions in the test.
 _getQuestionCount ($test_id)
 Returns the number of questions in the test for a given user.
 removeNonRandomTestData ()
 Removes all test data of a non random test when a test was set to random test.
 removeRandomTestData ()
 Removes all test data of a random test when a test was set to non random test.
 logAction ($logtext="", $question_id="")
 Logs an action into the Test&Assessment log.
 _getObjectIDFromTestID ($test_id)
 Returns the ILIAS test object id for a given test id.
 _getObjectIDFromActiveID ($active_id)
 Returns the ILIAS test object id for a given active id.
 _getTestIDFromObjectID ($object_id)
 Returns the ILIAS test id for a given object id.
 getTextAnswer ($active_id, $question_id, $pass=NULL)
 Returns the text answer of a given user for a given question.
 getQuestiontext ($question_id)
 Returns the question text for a given question.
& getInvitedUsers ($user_id="", $order="login, lastname, firstname")
 Returns a list of all invited users in a test.
& getTestParticipants ()
 Returns a list of all participants in a test.
 getTestParticipantsForManualScoring ($filter=NULL)
& getUserData ($ids)
 Returns a data of all users specified by id list.
& getGroupData ($ids)
& getRoleData ($ids)
 inviteGroup ($group_id)
 Invites all users of a group to a test.
 inviteRole ($role_id)
 Invites all users of a role to a test.
 disinviteUser ($user_id)
 Disinvites a user from a test.
 inviteUser ($user_id, $client_ip="")
 Invites a user to a test.
 setClientIP ($user_id, $client_ip)
 _getSolvedQuestions ($active_id, $question_fi=null)
 get solved questions
 setQuestionSetSolved ($value, $question_id, $user_id)
 sets question solved state to value for given user_id
 setActiveTestSubmitted ($user_id)
 submits active test for user user_id
 isTestFinished ($active_id)
 returns if the active for user_id has been submitted
 isActiveTestSubmitted ($user_id=null)
 returns if the active for user_id has been submitted
 hasNrOfTriesRestriction ()
 returns if the numbers of tries have to be checked
 isNrOfTriesReached ($tries)
 returns if number of tries are reached
 getAllTestResults ($participants, $prepareForCSV=true)
 returns all test results for all participants
& processCSVRow ($row, $quoteAll=FALSE, $separator=";")
 Processes an array as a CSV row and converts the array values to correct CSV values.
 _getPass ($active_id)
 Retrieves the actual pass of a given user for a given test.
 _getMaxPass ($active_id)
 Retrieves the maximum pass of a given user for a given test in which the user answered at least one question.
 _getBestPass ($active_id)
 Retrieves the best pass of a given user for a given test.
 _getResultPass ($active_id)
 Retrieves the pass number that should be counted for a given user.
 getAnsweredQuestionCount ($active_id, $pass=NULL)
 Retrieves the number of answered questions for a given user in a given test.
 getPassFinishDate ($active_id, $pass)
 Retrieves the number of answered questions for a given user in a given test.
 isExecutable ($user_id, $allowPassIncrease=FALSE)
 Checks if the test is executable by the given user.
 canViewResults ()
 Returns true, if the test results can be viewed.
 canShowTestResults ($user_id)
 canEditMarks ()
 getStartingTimeOfParticipants ()
 getTimeExtensionsOfParticipants ()
 getStartingTimeOfUser ($active_id)
 Returns the unix timestamp of the time a user started a test.
 isMaxProcessingTimeReached ($starting_time, $active_id)
 Returns whether the maximum processing time for a test is reached or not.
& getTestQuestions ()
 getShuffleQuestions ()
 Returns the status of the shuffle_questions variable.
 setShuffleQuestions ($a_shuffle)
 Sets the status of the shuffle_questions variable.
 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.
 setListOfQuestionsSettings ($a_value=0)
 Sets the settings for the list of questions options in the test properties This could contain one of the following values: 0 = No list of questions offered 1 = A list of questions is offered 3 = A list of questions is offered and the list of questions is shown as first page of the test 5 = A list of questions is offered and the list of questions is shown as last page of the test 7 = A list of questions is offered and the list of questions is shown as first and last page of the test.
 getListOfQuestions ()
 Returns if the list of questions should be presented to the user or not.
 setListOfQuestions ($a_value=TRUE)
 Sets if the the list of questions should be presented to the user or not.
 getListOfQuestionsStart ()
 Returns if the list of questions should be presented as the first page of the test.
 setListOfQuestionsStart ($a_value=TRUE)
 Sets if the the list of questions as the start page of the test.
 getListOfQuestionsEnd ()
 Returns if the list of questions should be presented as the last page of the test.
 setListOfQuestionsEnd ($a_value=TRUE)
 Sets if the the list of questions as the end page of the test.
 getListOfQuestionsDescription ()
 Returns TRUE if the list of questions should be presented with the question descriptions.
 setListOfQuestionsDescription ($a_value=TRUE)
 Sets the show_summary attribute to TRUE if the list of questions should be presented with the question descriptions.
 getResultsPresentation ()
 Returns the combined results presentation value.
 getShowPassDetails ()
 Returns if the pass details should be shown when a test is not finished.
 getShowSolutionDetails ()
 Returns if the solution details should be presented to the user or not.
 getShowSolutionPrintview ()
 Returns if the solution printview should be presented to the user or not.
 getShowSolutionFeedback ()
 Returns if the feedback should be presented to the solution or not.
 getShowSolutionAnswersOnly ()
 Returns if the full solution (including ILIAS content) should be presented to the solution or not.
 getShowSolutionSignature ()
 Returns if the signature field should be shown in the test results.
 getShowSolutionSuggested ()
 getShowSolutionListComparison ()
 getShowSolutionAnwersBeforeFinish ()
 setResultsPresentation ($a_results_presentation=3)
 Sets the combined results presentation value.
 setShowPassDetails ($a_details=1)
 Sets if the pass details should be shown when a test is not finished.
 setShowSolutionDetails ($a_details=1)
 Sets if the the solution details should be presented to the user or not.
 setShowSolutionPrintview ($a_printview=1)
 Sets if the the solution printview should be presented to the user or not.
 setShowSolutionFeedback ($a_feedback=TRUE)
 Sets if the the feedback should be presented to the user in the solution or not.
 setShowSolutionAnswersOnly ($a_full=TRUE)
 Set to true, if the full solution (including the ILIAS content pages) should be shown in the solution output.
 setShowSolutionSignature ($a_signature=FALSE)
 Set to TRUE, if the signature field should be shown in the solution.
 setShowSolutionSuggested ($a_solution=FALSE)
 Set to TRUE, if the suggested solution should be shown in the solution.
 setShowSolutionListComparison ($a_comparison=FALSE)
 Set to TRUE, if the results should be compared with the correct results in the list of answers.
 setShowSolutionAnwersBeforeFinish ($a_value=FALSE)
 Set to TRUE, if the list of answers should be shown prior to finish the test.
 createNewAccessCode ()
 Returns a new, unused test access code.
 isAccessCodeUsed ($code)
 getAccessCodeSession ()
 setAccessCodeSession ($access_code)
 unsetAccessCodeSession ()
 getAllowedUsers ()
 setAllowedUsers ($a_allowed_users)
 getAllowedUsersTimeGap ()
 setAllowedUsersTimeGap ($a_allowed_users_time_gap)
 checkMaximumAllowedUsers ()
 _getLastAccess ($active_id)
 isHTML ($a_text)
 Checks if a given string contains HTML or not.
 QTIMaterialToString ($a_material)
 Reads an QTI material tag an creates a text string.
 prepareTextareaOutput ($txt_output, $prepare_for_latex_output=FALSE)
 Prepares a string for a text area output in tests.
 saveCertificateVisibility ($a_value)
 Saves the visibility settings of the certificate.
 getCertificateVisibility ()
 Returns the visibility settings of the certificate.
 setCertificateVisibility ($a_value)
 Sets the visibility settings of the certificate.
 getAnonymity ()
 Returns the anonymity status of the test.
 setAnonymity ($a_value=0)
 Sets the anonymity status of the test.
 getShowCancel ()
 Returns whether the cancel test button is shown or not.
 setShowCancel ($a_value=1)
 Sets the cancel test button status.
 getAutosave ()
 Returns if autosave is enabled.
 setAutosave ($a_value=1)
 Sets autosave.
 getShowMarker ()
 Returns whether the marker button is shown or not.
 setShowMarker ($a_value=1)
 Sets the marker button status.
 getFixedParticipants ()
 Returns the fixed participants status.
 setFixedParticipants ($a_value=1)
 Sets the fixed participants status.
 _lookupAnonymity ($a_obj_id)
 Returns the anonymity status of a test with a given object id.
 _lookupRandomTestFromActiveId ($active_id)
 Returns the random status of a test with a given object id.
 userLookupFullName ($user_id, $overwrite_anonymity=FALSE, $sorted_order=FALSE, $suffix="")
 Returns the full name of a test user according to the anonymity status.
 getStartTestLabel ($active_id)
 Returns the "Start the Test" label for the Info page.
& getAvailableDefaults ($sortby="name", $sortorder="asc")
 Returns the available test defaults for the active user.
& getTestDefaults ($test_defaults_id)
 Returns the test defaults for a given id.
 deleteDefaults ($test_default_id)
 Deletes the defaults for a test.
 addDefaults ($a_name)
 Adds the defaults of this test to the test defaults.
 applyDefaults ($test_defaults_id)
 Applies given test defaults to this test.
 deliverPDFFromHTML ($content, $title=NULL, $filename=NULL)
 Delivers a PDF file from XHTML.
 saveManualFeedback ($active_id, $question_id, $pass, $feedback)
 Saves the manual feedback for a question in a test.
 getJavaScriptOutput ()
 Returns if Javascript should be chosen for drag & drop actions for the active user.
& createTestSession ()
 Creates the test session data for the active user.
 setTestId ($a_id)
 Sets the test ID.
& setTestSession ($active_id="")
 Sets the test session data for the active user.
& getTestSession ($active_id="")
 Returns the test session data for the active user.
& createTestSequence ($active_id, $pass, $shuffle)
& getTestSequence ($active_id="", $pass="")
 hideCorrectAnsweredQuestions ()
 getDetailedTestResults ($participants)
 returns all test results for all participants
 _lookupTestObjIdForQuestionId ($a_q_id)
 Get test Object ID for question ID.
 isPluginActive ($a_pname)
 Checks whether or not a question plugin with a given name is active.
 setEvaluationAdditionalFields ($fields)
 Sets additional user fields that should be shown in the user evaluation.
 getEvaluationAdditionalFields ()
 Gets additional user fields that should be shown in the user evaluation.
 canShowCertificate ($user_id, $active_id)
 Checks whether the certificate button could be shown on the info page or not.
 getParticipantsForTestAndQuestion ($test_id, $question_id)
 Creates an associated array with all active id's for a given test and original question id.
 getAggregatedResultsData ()
 Returns the aggregated test results.
 getXMLZip ()
 Get zipped xml file for test.
 getMailNotification ()
 Get mail notification settings.
 setMailNotification ($a_notification)
 Set mail notification settings.
 sendSimpleNotification ($active_id)
 sendAdvancedNotification ($active_id)
 createRandomSolutions ($number)
 getResultsForActiveId ($active_id)
 getRunDates ()
 Returns an array of YYYY-MM-DD date strings for days that have archived runs of this test.
 getRunPackageDates ()
 Like getRunDates(), yet only return dates for runs that have packaged archives in the course folder.
 hasRun ($date)
 Returns TRUE if this test has an archived run for the date designated by YYYY-MM-DD string $date.
 hasRunPackage ($date)
 Like hasRun(), but only returns TRUE if the run has been packaged; will return FALSE even if packaging is underway yet not completed.
 packageRun ($date)
 Triggers packaging of archived run for this test designated by YYYY-MM-DD string $date (if run exists).
 getRunPackageFilename ($date)
 deleteRunPackage ($date)
 obliterateRun ($date)
 Utterly and completely destroys all evidence of an archived run, i.e.
 getMailNotificationType ()
 setMailNotificationType ($a_type)
 getExportSettings ()
 setExportSettings ($a_settings)
 getExportSettingsSingleChoiceShort ()
 setExportSettingsSingleChoiceShort ($a_settings)
 getExportSettingsRespectShuffle ()
 setExportSettingsRespectShuffle ($a_settings)
 getQuestions ()
 getExtraTime ($active_id)
 addExtraTime ($active_id, $minutes)
 recalculateSolutions ()
 getShowSerial ()
 setShowSerial ($a_value=1)
 getSerial ()
- Public Member Functions inherited from ilObject
 ilObject ($a_id=0, $a_reference=true)
 Constructor public.
 withReferences ()
 determines wehter objects are referenced or not (got ref ids or not)
 getId ()
 get object id public
 setId ($a_id)
 set object id public
 setRefId ($a_id)
 set reference id public
 getRefId ()
 get reference id public
 getType ()
 get object type public
 setType ($a_type)
 set object type public
 getPresentationTitle ()
 get presentation title Normally same as title Overwritten for sessions
 getTitle ()
 get object title public
 getUntranslatedTitle ()
 get untranslated object title public
 setTitle ($a_title)
 set object title
 getDescription ()
 get object description
 setDescription ($a_desc)
 set object description
 getLongDescription ()
 get object long description (stored in object_description)
 getImportId ()
 get import id
 setImportId ($a_import_id)
 set import id
 _lookupObjIdByImportId ($a_import_id)
 getOwner ()
 get object owner
 getOwnerName ()
 _lookupOwnerName ($a_owner_id)
 lookup owner name for owner id
 setOwner ($a_owner)
 set object owner
 getCreateDate ()
 get create date public
 getLastUpdateDate ()
 get last update date public
 getDiskUsage ()
 Gets the disk usage of the object in bytes.
 setObjDataRecord ($a_record)
 set object_data record (note: this method should only be called from the ilObjectFactory class)
 create ()
 create
 MDUpdateListener ($a_element)
 Meta data update listener.
 updateMetaData ()
 update meta data entry
 deleteMetaData ()
 delete meta data entry
 updateOwner ()
 update owner of object in db
 _getIdForImportId ($a_import_id)
 get current object id for import id (static)
 _lookupOwner ($a_id)
 lookup object owner
 _lookupDescription ($a_id)
 lookup object description
 _lookupLastUpdate ($a_id, $a_as_string=false)
 lookup last update
 _getLastUpdateOfObjects ($a_objs)
 Get last update for a set of media objects.
 _setDeletedDate ($a_ref_id)
 only called in ilTree::saveSubTree
 _resetDeletedDate ($a_ref_id)
 only called in ilObjectGUI::insertSavedNodes
 _lookupDeletedDate ($a_ref_id)
 only called in ilObjectGUI::insertSavedNodes
 _writeTitle ($a_obj_id, $a_title)
 write title to db (static)
 _writeDescription ($a_obj_id, $a_desc)
 write description to db (static)
 _writeImportId ($a_obj_id, $a_import_id)
 write import id to db (static)
 _isInTrash ($a_ref_id)
 checks wether object is in trash
 _hasUntrashedReference ($a_obj_id)
 checks wether an object has at least one reference that is not in trash
 _lookupObjectId ($a_ref_id)
 lookup object id
 _getObjectsDataForType ($a_type, $a_omit_trash=false)
 get all objects of a certain type
 putInTree ($a_parent_ref)
 maybe this method should be in tree object!?
 setPermissions ($a_parent_ref)
 set permissions of object
 countReferences ()
 count references of object
 createRoleFolder ()
 creates a local role folder
 setRegisterMode ($a_bool)
 isUserRegistered ($a_user_id=0)
 requireRegistration ()
 getHTMLDirectory ()
 appendCopyInfo ($a_target_id, $a_copy_id)
 Prepend Copy info if object with same name exists in that container.
 cloneDependencies ($a_target_id, $a_copy_id)
 Clone object dependencies.
 cloneMetaData ($target_obj)
 Copy meta data.

Static Public Member Functions

static _lookupRandomTest ($a_obj_id)
 Lookup random test.
static _getUserIdFromActiveId ($active_id)
static getManualFeedback ($active_id, $question_id, $pass)
 Retrieves the manual feedback for a question in a test.
- Static Public Member Functions inherited from ilObject
static _getAllReferences ($a_id)
 get all reference ids of object
static _lookupTitle ($a_id)
 lookup object title
static _getIdsForTitle ($title, $type= '', $partialmatch=false)
static _lookupObjId ($a_id)
static _lookupType ($a_id, $a_reference=false)
 lookup object type
 _exists ($a_id, $a_reference=false)
 checks if an object exists in object_data
static _getObjectsByType ($a_obj_type="", $a_owner="")
 Get objects by type.
static _prepareCloneSelection ($a_ref_ids, $new_type)
 Prepare copy wizard object selection.
static _getIcon ($a_obj_id="", $a_size="big", $a_type="", $a_offline=false)
 Get icon for repository item.
static collectDeletionDependencies (&$deps, $a_ref_id, $a_obj_id, $a_type, $a_depth=0)
 Collect deletion dependencies.
static getDeletionDependencies ($a_obj_id)
 Get deletion dependencies.

Data Fields

 $test_id
 $invitation = INVITATION_OFF
 $author
 $metadata
 $questions
 $introduction
 $mark_schema
 $sequence_settings
 $score_reporting
 $instant_verification
 $answer_feedback_points
 $reporting_date
 $evaluation_data
 $nr_of_tries
 $use_previous_answers
 $title_output
 $processing_time
 $enable_processing_time
 $reset_processing_time
 $starting_time
 $ending_time
 $ects_output
 $ects_fx
 $ects_grades
 $random_test
 $random_question_count
 $count_system
 $mc_scoring
 $pass_scoring
 $shuffle_questions
 $results_presentation
 $show_summary
 $score_cutting
 $password
 $allowedUsers
 $allowedUsersTimeGap
 $certificate_visibility
 $anonymity
 $show_cancel
 $autosave
 $show_marker
 $fixed_participants
 $answer_feedback
 $testSession
 $testSequence
- Data Fields inherited from ilObject
const TITLE_LENGTH = 128
 max length of object title
 $ilias
 $lng
 $id
 $ref_id
 $type
 $title
 $untranslatedTitle
 $desc
 $long_desc
 $owner
 $create_date
 $last_update
 $import_id
 $register = false
 $referenced
 $objectList
 $max_title
 $max_desc
 $add_dots
 $obj_data_record
 object_data record

Protected Member Functions

 isNewRandomTest ()
 Checks whether the test is a new random test (using tst_rnd_cpy) or an old one.
 removeDuplicatedQuestionpools ()
 Remove all duplicated questions from a random test.
 duplicateQuestionpoolForTest ($questionpool_id)
 Duplicates all valid questions of a questionpool for use in a random test.
 getPassed ($active_id)

Protected Attributes

 $_kiosk
 $mailnotification
 $mailnottype
 $random_questionpool_data
 $exportsettings
 $show_serial

Private Attributes

 $_showfinalstatement
 $_finalstatement
 $_redirect_after_exam
 $_redirect_only_kiosk_mode
 $_exam_pdf
 $_showinfo
 $_forcejs
 $_customStyle
 $import_dir

Detailed Description

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

Member Function Documentation

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

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

Parameters
boolean$is_anonymousIndicates if it is an anonymized test or not
int$user_idThe database ID of the user
string$firstnameThe first name of the user
string$lastnameThe last name of the user
string$titleThe title of the user
Returns
string The output name of the user public

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

References ilObject\$lng, $name, and ilObject\$title.

{
global $lng;
$name = "";
if (strlen($firstname.$lastname.$title) == 0)
{
$name = $lng->txt("deleted_user");
}
else
{
if ($user_id == ANONYMOUS_USER_ID)
{
$name = $lastname;
}
else
{
$name = trim($lastname . ", " . $firstname . " " . $title);
}
if ($is_anonymous)
{
$name = $lng->txt("anonymous");
}
}
return $name;
}
ilObjTest::_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)

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

References ilObject\$ilias, ilUtil\getDataDir(), and ilUtil\makeDir().

Referenced by ilObjTestGUI\uploadTstObject().

{
global $ilias;
include_once "./Services/Utilities/classes/class.ilUtil.php";
$tst_data_dir = ilUtil::getDataDir()."/tst_data";
ilUtil::makeDir($tst_data_dir);
if (!is_writable($tst_data_dir))
{
$ilias->raiseError("Test data directory (".$tst_data_dir
.") not writeable.",$ilias->error_obj->FATAL);
}
// create test directory (data_dir/tst_data/tst_import)
$tst_dir = $tst_data_dir."/tst_import";
ilUtil::makeDir($tst_dir);
if (!@is_dir($tst_dir))
{
$ilias->raiseError("Creation of test import directory failed.",$ilias->error_obj->FATAL);
}
return $tst_dir;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::_evalResultsOverview (   $test_id)

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

Returns
array An associated array containing the results public

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

References $ilDB, $row, and $test_id.

Referenced by evalResultsOverview().

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

+ Here is the caller graph for this function:

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

Gets the active id of the tst_active table for the active user.

Parameters
integer$user_idThe database id of the user
integer$test_idThe database id of the test
Returns
object The database row of the tst_active table public

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

References $ilDB, $row, and $test_id.

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

Returns the available tests for the active user.

Returns
array The available tests public

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

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

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

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::_getBestPass (   $active_id)

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
Returns
integer The best pass of the user for the given test public

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

References $ilDB, and $row.

Referenced by _getResultPass().

{
global $ilDB;
$result = $ilDB->queryF("SELECT * FROM tst_pass_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if ($result->numRows())
{
$bestrow = null;
$bestpoints = -1;
while ($row = $ilDB->fetchAssoc($result))
{
if ($row["points"] > $bestpoints)
{
$bestrow = $row;
$bestpoints = $row["points"];
}
}
if (is_array($bestrow))
{
return $bestrow["pass"];
}
else
{
return 0;
}
}
else
{
return 0;
}
}

+ Here is the caller graph for this function:

& ilObjTest::_getCompleteWorkingTimeOfParticipants (   $test_id)

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

Parameters
integer$test_idThe database ID of the test
Returns
array An array containing the working time in seconds for all test participants public

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

References $ilDB, $row, and $test_id.

Referenced by getCompleteWorkingTimeOfParticipants().

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

+ Here is the caller graph for this function:

ilObjTest::_getCountSystem (   $active_id)

Gets the count system for the calculation of points.

Returns
integer The count system for the calculation of points public
See Also
$count_system

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

References $ilDB, and $row.

Referenced by assQuestion\calculateReachedPoints().

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

+ Here is the caller graph for this function:

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

Returns the ECTS grade for a number of reached points.

Parameters
double$reached_pointsThe points reached in the test
double$max_pointsThe maximum number of points for the test
Returns
string The ECTS grade short description public

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

References $d.

Referenced by getECTSGrade().

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

+ Here is the caller graph for this function:

ilObjTest::_getImportDirectory ( )

Get the import directory location of the test.

Returns
string The location of the import directory or false if the directory doesn't exist public

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

References $_SESSION.

Referenced by assErrorTextImport\fromXML(), assFileUploadImport\fromXML(), assFlashQuestionImport\fromXML(), assSingleChoiceImport\fromXML(), assOrderingQuestionImport\fromXML(), assJavaAppletImport\fromXML(), assNumericImport\fromXML(), assMultipleChoiceImport\fromXML(), assTextSubsetImport\fromXML(), assClozeTestImport\fromXML(), assImagemapQuestionImport\fromXML(), assOrderingHorizontalImport\fromXML(), assTextQuestionImport\fromXML(), assMatchingQuestionImport\fromXML(), ilObjTestGUI\importVerifiedFileObject(), and ilObjTestGUI\uploadTstObject().

{
if (strlen($_SESSION["tst_import_dir"]))
{
return $_SESSION["tst_import_dir"];
}
return null;
}

+ Here is the caller graph for this function:

ilObjTest::_getLastAccess (   $active_id)

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

References $ilDB, and $row.

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

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
Returns
integer The pass of the user for the given test public

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

References $ilDB, and $row.

Referenced by _getResultPass().

{
global $ilDB;
$result = $ilDB->queryF("SELECT MAX(pass) maxpass FROM tst_test_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
$max = $row["maxpass"];
}
else
{
$max = NULL;
}
return $max;
}

+ Here is the caller graph for this function:

ilObjTest::_getMCScoring (   $active_id)

Gets the scoring type for multiple choice questions.

Returns
mixed The scoring type for multiple choice questions public
See Also
$mc_scoring

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

References $ilDB, and $row.

Referenced by assMultipleChoice\calculateReachedPoints().

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

+ Here is the caller graph for this function:

ilObjTest::_getObjectIDFromActiveID (   $active_id)

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

Parameters
integer$active_idThe active id
Returns
mixed The ILIAS test object id or FALSE if the query was not successful public

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

References $ilDB, and $row.

Referenced by assQuestion\_logAction(), and assQuestion\logAction().

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

+ Here is the caller graph for this function:

ilObjTest::_getObjectIDFromTestID (   $test_id)

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

Parameters
integer$test_idThe test id
Returns
mixed The ILIAS test object id or FALSE if the query was not successful public

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

References $ilDB, $row, and $test_id.

Referenced by assJavaAppletGUI\getSolutionOutput(), assJavaAppletGUI\getTestOutput(), and ASS_MarkSchema\logAction().

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

+ Here is the caller graph for this function:

ilObjTest::_getPass (   $active_id)

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
Returns
integer The pass of the user for the given test public

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

References $ilDB, and $row.

Referenced by assQuestion\calculateResultsFromSolution(), getAllQuestions(), assFileUploadGUI\getSolutionOutput(), assFlashQuestionGUI\getSolutionOutput(), assJavaAppletGUI\getSolutionOutput(), assImagemapQuestionGUI\getSolutionOutput(), getStartingTimeOfUser(), getStartTestLabel(), assFileUploadGUI\getTestOutput(), assErrorTextGUI\getTestOutput(), assOrderingHorizontalGUI\getTestOutput(), assNumericGUI\getTestOutput(), assTextQuestionGUI\getTestOutput(), assTextSubsetGUI\getTestOutput(), assFlashQuestionGUI\getTestOutput(), assSingleChoiceGUI\getTestOutput(), assJavaAppletGUI\getTestOutput(), assMultipleChoiceGUI\getTestOutput(), assImagemapQuestionGUI\getTestOutput(), assClozeTestGUI\getTestOutput(), assOrderingQuestionGUI\getTestOutput(), assMatchingQuestionGUI\getTestOutput(), assMatchingQuestionGUI\getTestOutputJS(), isExecutable(), loadQuestions(), assOrderingHorizontal\moveRight(), assImagemapQuestionGUI\outQuestionForTest(), assOrderingHorizontal\saveWorkingData(), assErrorText\saveWorkingData(), assNumeric\saveWorkingData(), assTextQuestion\saveWorkingData(), assFileUpload\saveWorkingData(), assSingleChoice\saveWorkingData(), assMultipleChoice\saveWorkingData(), assTextSubset\saveWorkingData(), assImagemapQuestion\saveWorkingData(), assOrderingQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assClozeTest\saveWorkingData(), and assErrorText\toggleSelection().

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

+ Here is the caller graph for this function:

ilObjTest::_getPassScoring (   $active_id)

Gets the pass scoring type.

Returns
integer The pass scoring type public
See Also
$pass_scoring

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

References $ilDB, and $row.

Referenced by _getResultPass().

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

+ Here is the caller graph for this function:

ilObjTest::_getQuestionCount (   $test_id)

Returns the number of questions in the test for a given user.

Returns
integer The number of questions public

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

References $data, $ilDB, $row, $test, and $test_id.

{
global $ilDB;
$num = 0;
$result = $ilDB->queryF("SELECT * FROM tst_tests WHERE test_id = %s",
array('integer'),
array($test_id)
);
if (!$result->numRows())
{
return 0;
}
$test = $ilDB->fetchAssoc($result);
if ($test["random_test"] == 1)
{
$qpls = array();
$counter = 0;
$result = $ilDB->queryF("SELECT * FROM tst_test_random WHERE test_fi = %s ORDER BY sequence, test_random_id",
array('integer'),
array($test_id)
);
if ($result->numRows())
{
while ($row = $ilDB->fetchAssoc($result))
{
$countresult = $ilDB->queryF("SELECT question_id FROM qpl_questions WHERE obj_fi = %s AND qpl_questions.tstamp > 0 AND original_id IS NULL",
array('integer'),
$row["questionpool_fi"]
);
$contains = $countresult->numRows();
$qpls[$counter] = array(
"index" => $counter,
"count" => $row["num_of_q"],
"qpl" => $row["questionpool_fi"],
"contains" => $contains
);
$counter++;
}
}
if ($test["random_question_count"] > 0)
{
$num = $test["random_question_count"];
$maxcount = 0;
foreach ($qpls as $data)
{
$maxcount += $data["contains"];
}
if ($num > $maxcount) $num = $maxcount;
}
else
{
$num = 0;
foreach ($qpls as $data)
{
$add = ($data["count"] <= $data["contains"]) ? $data["count"] : $data["contains"];
$num += $add;
}
}
}
else
{
$result = $ilDB->queryF("SELECT test_question_id FROM tst_test_question WHERE test_fi = %s",
array('integer'),
array($test_id)
);
$num = $result->numRows();
}
return $num;
}
ilObjTest::_getQuestionCountAndPointsForPassOfParticipant (   $active_id,
  $pass 
)

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

References $ilDB, $pass, $row, and _lookupRandomTestFromActiveId().

Referenced by assQuestion\_updateTestPassResults(), and ilTestEvaluationData\generateOverview().

{
global $ilDB;
$random = ilObjTest::_lookupRandomTestFromActiveId($active_id);
if ($random)
{
$result = $ilDB->queryF("SELECT tst_test_rnd_qst.pass, COUNT(tst_test_rnd_qst.question_fi) qcount, " .
"SUM(qpl_questions.points) qsum FROM tst_test_rnd_qst, qpl_questions " .
"WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id AND " .
"tst_test_rnd_qst.active_fi = %s and pass = %s GROUP BY tst_test_rnd_qst.active_fi, " .
"tst_test_rnd_qst.pass",
array('integer', 'integer'),
array($active_id, $pass)
);
}
else
{
$result = $ilDB->queryF("SELECT COUNT(tst_test_question.question_fi) qcount, " .
"SUM(qpl_questions.points) qsum FROM tst_test_question, qpl_questions, tst_active " .
"WHERE tst_test_question.question_fi = qpl_questions.question_id AND tst_test_question.test_fi = tst_active.test_fi AND " .
"tst_active.active_id = %s GROUP BY tst_test_question.test_fi",
array('integer'),
array($active_id)
);
}
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
return array("count" => $row["qcount"], "points" => $row["qsum"]);
}
else
{
return array("count" => 0, "points" => 0);
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::_getResultPass (   $active_id)

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
Returns
integer The result pass of the user for the given test public

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

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

Referenced by assQuestion\_updateTestResultCache(), ilTestNewScoring\calcReachedPoints(), evalStatistical(), getPassed(), ilTestEvaluationGUI\outCertificate(), and ilTestEvaluationGUI\outParticipantsResultsOverview().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::_getScoreCutting (   $active_id)

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

Returns
boolean The score cutting type. 0 for question cutting, 1 for test cutting public
See Also
$score_cutting

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

References $ilDB, and $row.

Referenced by assQuestion\calculateReachedPoints().

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

+ Here is the caller graph for this function:

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

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

References $ilDB, and $row.

Referenced by ilTestSequence\getSequenceSummary(), ilTestOutputGUI\outQuestionSummary(), and ilTestOutputGUI\outWorkingForm().

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

+ Here is the caller graph for this function:

ilObjTest::_getTestIDFromObjectID (   $object_id)

Returns the ILIAS test id for a given object id.

Parameters
integer$object_idThe object id
Returns
mixed The ILIAS test id or FALSE if the query was not successful public

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

References $ilDB, $row, and $test_id.

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

Returns the value of the title_output status.

Parameters
integer$active_idThe active id of a user
Returns
integer 0 for full title, 1 for title without points, 2 for no title public
See Also
$title_output

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

References $ilDB, and $row.

Referenced by assQuestionGUI\outQuestionPage().

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

+ Here is the caller graph for this function:

ilObjTest::_getUsePreviousAnswers (   $active_id,
  $user_active_user_setting = false 
)

Returns if the previous results should be hidden for a learner.

Parameters
integer$test_idThe test id
boolean$use_active_user_settingIf true, the tst_use_previous_answers- of the active user should be used as well
Returns
integer 1 if the previous results should be hidden, 0 otherwise public
See Also
$use_previous_answers

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

References $ilDB, $res, $row, and $use_previous_answers.

Referenced by assFileUploadGUI\getSolutionOutput(), assImagemapQuestionGUI\getSolutionOutput(), assFileUploadGUI\getTestOutput(), assErrorTextGUI\getTestOutput(), assOrderingHorizontalGUI\getTestOutput(), assNumericGUI\getTestOutput(), assTextQuestionGUI\getTestOutput(), assTextSubsetGUI\getTestOutput(), assSingleChoiceGUI\getTestOutput(), assJavaAppletGUI\getTestOutput(), assMultipleChoiceGUI\getTestOutput(), assImagemapQuestionGUI\getTestOutput(), assClozeTestGUI\getTestOutput(), assOrderingQuestionGUI\getTestOutput(), assMatchingQuestionGUI\getTestOutput(), assMatchingQuestionGUI\getTestOutputJS(), and assImagemapQuestionGUI\outQuestionForTest().

{
global $ilDB;
global $ilUser;
$use_previous_answers = 1;
$result = $ilDB->queryF("SELECT tst_tests.use_previous_answers FROM tst_tests, tst_active WHERE tst_tests.test_id = tst_active.test_fi AND tst_active.active_id = %s",
array("integer"),
array($active_id)
);
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
$use_previous_answers = $row["use_previous_answers"];
}
if ($use_previous_answers == 1)
{
if ($user_active_user_setting)
{
$res = $ilUser->getPref("tst_use_previous_answers");
if ($res !== FALSE)
{
$use_previous_answers = $res;
}
}
}
return $use_previous_answers;
}

+ Here is the caller graph for this function:

static ilObjTest::_getUserIdFromActiveId (   $active_id)
static

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

References $ilDB, and $row.

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

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

+ Here is the caller graph for this function:

ilObjTest::_getVisitTimeOfParticipant (   $test_id,
  $active_id 
)

Returns the first and last visit of a participant.

Parameters
integer$test_idThe database ID of the test
integer$active_idThe active ID of the participant
Returns
array The first and last visit of a participant public

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

References $ilDB, $row, and $test_id.

Referenced by getVisitTimeOfParticipant().

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

+ Here is the caller graph for this function:

ilObjTest::_getWorkingTimeOfParticipantForPass (   $active_id,
  $pass 
)

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

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

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

References $ilDB, $pass, and $row.

Referenced by assQuestion\_updateTestPassResults().

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

+ Here is the caller graph for this function:

& ilObjTest::_instanciateQuestion (   $question_id)

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

Parameters
integer$question_idThe question id
Returns
object The question instance public

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

Referenced by ilCourseObjectiveQuestion\__read(), cloneObject(), createRandomSolutions(), ilObjQuestionPool\deleteQuestion(), duplicateQuestionForTest(), duplicateQuestionpoolForTest(), ilTestEvaluationGUI\exportFileUploadsForAllParticipants(), getAllTestResults(), getDetailedTestResults(), getEstimatedWorkingTime(), ilCourseObjectiveQuestion\getMaxPointsByObjective(), ilCourseObjectiveQuestion\getMaxPointsByTest(), ilTestSequence\getSequenceSummary(), ilCourseObjectiveQuestionAssignmentTableGUI\parse(), removeDuplicatedQuestionpools(), removeQuestion(), ilTestEvaluationGUI\singleResults(), and ilTestExportQTI\toXML().

{
if (strcmp($question_id, "") != 0)
{
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
return assQuestion::_instanciateQuestion($question_id);
}
}

+ Here is the caller graph for this function:

ilObjTest::_isComplete (   $obj_id)

Returns true, if a test is complete for use.

Returns
boolean True, if the test is complete for use, otherwise false public

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

References $test, and ilObjTest().

{
$test = new ilObjTest($obj_id, false);
$test->loadFromDb();
return $test->isComplete();
}

+ Here is the call graph for this function:

ilObjTest::_lookupAnonymity (   $a_obj_id)

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

Parameters
int$a_obj_idThe object id of the test object
Returns
integer The value for the anonymity status (0 = personalized, 1 = anonymized) public

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

References $ilDB, and $row.

Referenced by ilLPListOfSettingsGUI\__checkItemAnonymized(), ilLPCollections\__read(), ilLPCollections\_getItems(), ilObjTestAccess\_getParticipantData(), ilTrObjectUsersPropsTableGUI\getSelectableColumns(), assJavaAppletGUI\getSolutionOutput(), assJavaAppletGUI\getTestOutput(), ilLearningProgressBaseGUI\isObjectAnonymized(), and ilLPFilter\searchFilterListener().

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

+ Here is the caller graph for this function:

ilObjTest::_lookupAuthor (   $obj_id)

Gets the authors name of the ilObjTest object.

Returns
string The string containing the name of the test author public
See Also
$author

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

References $author, and ilObject\$id.

Referenced by assQuestion\getInstances().

{
$author = array();
include_once "./Services/MetaData/classes/class.ilMD.php";
$md =& new ilMD($obj_id, 0, "tst");
$md_life =& $md->getLifecycle();
if ($md_life)
{
$ids =& $md_life->getContributeIds();
foreach ($ids as $id)
{
$md_cont =& $md_life->getContribute($id);
if (strcmp($md_cont->getRole(), "Author") == 0)
{
$entids =& $md_cont->getEntityIds();
foreach ($entids as $entid)
{
$md_ent =& $md_cont->getEntity($entid);
array_push($author, $md_ent->getEntity());
}
}
}
}
return join($author, ",");
}

+ Here is the caller graph for this function:

static ilObjTest::_lookupRandomTest (   $a_obj_id)
static

Lookup random test.

Parameters
int$a_obj_id
Returns
bool

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

References $ilDB, $query, $res, $row, and DB_FETCHMODE_OBJECT.

Referenced by ilCourseObjectiveQuestionAssignmentTableGUI\parse().

{
global $ilDB;
$query = "SELECT random_test FROM tst_tests ".
"WHERE obj_fi = ".$ilDB->quote($a_obj_id,'integer');
$res = $ilDB->query($query);
while($row = $res->fetchRow(DB_FETCHMODE_OBJECT))
{
return $row->random_test ? true : false;
}
return false;
}

+ Here is the caller graph for this function:

ilObjTest::_lookupRandomTestFromActiveId (   $active_id)

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

Parameters
int$a_obj_idThe object id of the test object
Returns
integer The value for the anonymity status (0 = no random, 1 = random) public

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

References $ilDB, and $row.

Referenced by _getQuestionCountAndPointsForPassOfParticipant().

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

+ Here is the caller graph for this function:

ilObjTest::_lookupTestObjIdForQuestionId (   $a_q_id)

Get test Object ID for question ID.

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

References $ilDB.

Referenced by ilObjMediaObject\getParentObjectIdForUsage().

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

+ Here is the caller graph for this function:

ilObjTest::_setImportDirectory (   $a_import_dir = null)

set import directory

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

References $_SESSION.

Referenced by ilObjTestGUI\uploadTstObject().

{
if (strlen($a_import_dir))
{
$_SESSION["tst_import_dir"] = $a_import_dir;
}
else
{
unset($_SESSION["tst_import_dir"]);
}
}

+ Here is the caller graph for this function:

ilObjTest::addDefaults (   $a_name)

Adds the defaults of this test to the test defaults.

Parameters
string$a_nameThe name of the test defaults public

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

References $ilDB, getAnonymity(), getAnswerFeedback(), getAnswerFeedbackPoints(), getAutosave(), getCountSystem(), getCustomStyle(), getECTSFX(), getECTSGrades(), getECTSOutput(), getEnableProcessingTime(), getEndingTime(), getExamPdf(), getExportSettings(), getFinalStatement(), getForceJS(), getInstantFeedbackSolution(), getIntroduction(), getKiosk(), getListOfQuestionsSettings(), getMailNotification(), getMailNotificationType(), getMCScoring(), getNrOfTries(), getPassScoring(), getProcessingTime(), getRandomQuestionCount(), getRedirectAfterExam(), getRedirectOnlyKioskMode(), getReportingDate(), getResetProcessingTime(), getResultsPresentation(), getScoreReporting(), getSequenceSettings(), getShowCancel(), getShowFinalStatement(), getShowInfo(), getShowMarker(), getShowSerial(), getShuffleQuestions(), getStartingTime(), getTitleOutput(), getUsePreviousAnswers(), and isRandomTest().

{
global $ilDB;
global $ilUser;
$testsettings = array(
"TitleOutput" => $this->getTitleOutput(),
"PassScoring" => $this->getPassScoring(),
"Introduction" => $this->getIntroduction(),
"FinalStatement" => $this->getFinalStatement(),
/* Change Sn */
"RedirectAfterExam" => $this->getRedirectAfterExam(),
"RedirectOnlyKioskMode" => $this->getRedirectOnlyKioskMode(),
"ExamPdf" => $this->getExamPdf(),
/* Change Sn End */
"ShowInfo" => $this->getShowInfo(),
"ForceJS" => $this->getForceJS(),
"CustomStyle" => $this->getCustomStyle(),
"ShowFinalStatement" => $this->getShowFinalStatement(),
"SequenceSettings" => $this->getSequenceSettings(),
"ScoreReporting" => $this->getScoreReporting(),
"InstantFeedbackSolution" => $this->getInstantFeedbackSolution(),
"AnswerFeedback" => $this->getAnswerFeedback(),
"AnswerFeedbackPoints" => $this->getAnswerFeedbackPoints(),
"ResultsPresentation" => $this->getResultsPresentation(),
"Anonymity" => $this->getAnonymity(),
"ShowCancel" => $this->getShowCancel(),
"Autosave" => $this->getAutosave(),
"ShowMarker" => $this->getShowMarker(),
"ReportingDate" => $this->getReportingDate(),
"NrOfTries" => $this->getNrOfTries(),
"Shuffle" => $this->getShuffleQuestions(),
"Kiosk" => $this->getKiosk(),
"Serial" => $this->getShowSerial(),
"Shuffle" => $this->getShuffleQuestions(),
"UsePreviousAnswers" => $this->getUsePreviousAnswers(),
"ProcessingTime" => $this->getProcessingTime(),
"EnableProcessingTime" => $this->getEnableProcessingTime(),
"ResetProcessingTime" => $this->getResetProcessingTime(),
"StartingTime" => $this->getStartingTime(),
"EndingTime" => $this->getEndingTime(),
"ECTSOutput" => $this->getECTSOutput(),
"ECTSFX" => $this->getECTSFX(),
"ECTSGrades" => $this->getECTSGrades(),
"isRandomTest" => $this->isRandomTest(),
"RandomQuestionCount" => $this->getRandomQuestionCount(),
"CountSystem" => $this->getCountSystem(),
"MCScoring" => $this->getMCScoring(),
"mailnotification" => $this->getMailNotification(),
"mailnottype" => $this->getMailNotificationType(),
"exportsettings" => $this->getExportSettings(),
"ListOfQuestionsSettings" => $this->getListOfQuestionsSettings()
);
$next_id = $ilDB->nextId('tst_test_defaults');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_test_defaults (test_defaults_id, name, user_fi, defaults, marks, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
array('integer', 'text', 'integer', 'text', 'text', 'integer'),
array($next_id, $a_name, $ilUser->getId(), serialize($testsettings), serialize($this->mark_schema), time())
);
}

+ Here is the call graph for this function:

ilObjTest::addExtraTime (   $active_id,
  $minutes 
)

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

References $ilDB, $row, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getTestId(), and logAction().

{
global $ilDB;
$participants = array();
if ($active_id == 0)
{
$result = $ilDB->queryF("SELECT active_id FROM tst_active WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
while ($row = $ilDB->fetchAssoc($result))
{
array_push($participants, $row['active_id']);
}
}
else
{
array_push($participants, $active_id);
}
foreach ($participants as $active_id)
{
$result = $ilDB->queryF("SELECT active_fi FROM tst_addtime WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if ($result->numRows() > 0)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_addtime WHERE active_fi = %s",
array('integer'),
array($active_id)
);
}
$result = $ilDB->manipulateF("UPDATE tst_active SET tries = %s, submitted = %s, submittimestamp = %s WHERE active_id = %s",
array('integer','integer','timestamp','integer'),
array(0, 0, NULL, $active_id)
);
$result = $ilDB->manipulateF("INSERT INTO tst_addtime (active_fi, additionaltime, tstamp) VALUES (%s, %s, %s)",
array('integer','integer','integer'),
array($active_id, $minutes, time())
);
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction(sprintf($this->lng->txtlng("assessment", "log_added_extratime", ilObjAssessmentFolder::_getLogLanguage()), $minutes, $active_id));
}
}
}

+ Here is the call graph for this function:

ilObjTest::addRandomQuestionpoolData (   $count = 0,
  $qpl = 0,
  $position 
)

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

{
include_once "./Modules/Test/classes/class.ilRandomTestData.php";
if (array_key_exists($position, $this->random_questionpool_data))
{
$newitems = array();
for ($i = 0; $i < $position; $i++)
{
array_push($newitems, $this->random_questionpool_data[$i]);
}
array_push($newitems, new ilRandomTestData($count, $qpl));
for ($i = $position; $i < count($this->random_questionpool_data); $i++)
{
array_push($newitems, $this->random_questionpool_data[$i]);
}
$this->random_questionpool_data = $newitems;
}
else
{
array_push($this->random_questionpool_data, new ilRandomTestData($count, $qpl));
}
}
ilObjTest::applyDefaults (   $test_defaults_id)

Applies given test defaults to this test.

Parameters
integer$test_defaults_idThe database id of the test defaults
Returns
boolean TRUE if the application succeeds, FALSE otherwise public

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

References $total, evalTotalPersons(), getQuestionCount(), getTestDefaults(), saveToDb(), setAnonymity(), setAnswerFeedback(), setAnswerFeedbackPoints(), setAutosave(), setCountSystem(), setCustomStyle(), setECTSFX(), setECTSGrades(), setECTSOutput(), setEnableProcessingTime(), setEndingTime(), setExamPdf(), setExportSettings(), setFinalStatement(), setForceJS(), setInstantFeedbackSolution(), setIntroduction(), setKiosk(), setListOfQuestionsSettings(), setMailNotification(), setMailNotificationType(), setMCScoring(), setNrOfTries(), setPassScoring(), setProcessingTime(), setRandomQuestionCount(), setRandomTest(), setRedirectAfterExam(), setRedirectOnlyKioskMode(), setReportingDate(), setResetProcessingTime(), setResultsPresentation(), setScoreReporting(), setSequenceSettings(), setShowCancel(), setShowFinalStatement(), setShowInfo(), setShowMarker(), setShowSerial(), setShuffleQuestions(), setStartingTime(), setTitleOutput(), and setUsePreviousAnswers().

{
$total = $this->evalTotalPersons();
$result = FALSE;
if (($this->getQuestionCount() == 0) && ($total == 0))
{
// only apply if there are no questions added and not user datasets exist
$defaults =& $this->getTestDefaults($test_defaults_id);
$testsettings = unserialize($defaults["defaults"]);
include_once "./Modules/Test/classes/class.assMarkSchema.php";
$this->mark_schema = unserialize($defaults["marks"]);
$this->setTitleOutput($testsettings["TitleOutput"]);
$this->setPassScoring($testsettings["PassScoring"]);
$this->setIntroduction($testsettings["Introduction"]);
$this->setFinalStatement($testsettings["FinalStatement"]);
/* Change Sn */
$this->setRedirectAfterExam($testsettings["RedirectAfterExam"]);
$this->setRedirectOnlyKioskMode($testsettings["RedirectOnlyKioskMode"]);
$this->setExamPdf($testsettings["ExamPdf"]);
/* Change Sn End */
$this->setShowInfo($testsettings["ShowInfo"]);
$this->setForceJS($testsettings["ForceJS"]);
$this->setCustomStyle($testsettings["CustomStyle"]);
$this->setShowFinalStatement($testsettings["ShowFinalStatement"]);
$this->setSequenceSettings($testsettings["SequenceSettings"]);
$this->setScoreReporting($testsettings["ScoreReporting"]);
$this->setInstantFeedbackSolution($testsettings["InstantFeedbackSolution"]);
$this->setAnswerFeedback($testsettings["AnswerFeedback"]);
$this->setAnswerFeedbackPoints($testsettings["AnswerFeedbackPoints"]);
$this->setResultsPresentation($testsettings["ResultsPresentation"]);
$this->setAnonymity($testsettings["Anonymity"]);
$this->setShowCancel($testsettings["ShowCancel"]);
$this->setAutosave($testsettings["Autosave"]);
$this->setShowMarker($testsettings["ShowMarker"]);
$this->setReportingDate($testsettings["ReportingDate"]);
$this->setShuffleQuestions($testsettings["this"]);
$this->setNrOfTries($testsettings["NrOfTries"]);
$this->setUsePreviousAnswers($testsettings["UsePreviousAnswers"]);
$this->setProcessingTime($testsettings["ProcessingTime"]);
$this->setResetProcessingTime($testsettings["ResetProcessingTime"]);
$this->setShuffleQuestions($testsettings["Shuffle"]);
$this->setEnableProcessingTime($testsettings["EnableProcessingTime"]);
$this->setStartingTime($testsettings["StartingTime"]);
$this->setKiosk($testsettings["Kiosk"]);
$this->setShowSerial($testsettings["Serial"]);
$this->setEndingTime($testsettings["EndingTime"]);
$this->setECTSOutput($testsettings["ECTSOutput"]);
$this->setECTSFX($testsettings["ECTSFX"]);
$this->setECTSGrades($testsettings["ECTSGrades"]);
$this->setRandomTest($testsettings["isRandomTest"]);
$this->setRandomQuestionCount($testsettings["RandomQuestionCount"]);
$this->setCountSystem($testsettings["CountSystem"]);
$this->setMCScoring($testsettings["MCScoring"]);
$this->setMailNotification($testsettings["mailnotification"]);
$this->setMailNotificationType($testsettings["mailnottype"]);
$this->setExportSettings($testsettings['exportsettings']);
$this->setListOfQuestionsSettings($testsettings["ListOfQuestionsSettings"]);
$this->saveToDb();
$result = TRUE;
}
return $result;
}

+ Here is the call graph for this function:

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

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

Parameters
int$user_idThe database ID of the user
string$firstnameThe first name of the user
string$lastnameThe last name of the user
string$titleThe title of the user
Returns
string The output name of the user public

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

References ilObject\$lng, $name, ilObject\$title, and getAnonymity().

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

+ Here is the call graph for this function:

ilObjTest::canEditMarks ( )

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

References $total, evalTotalPersons(), and getReportingDate().

{
$total = $this->evalTotalPersons();
if ($total > 0)
{
if ($this->getReportingDate())
{
if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->getReportingDate(), $matches))
{
$epoch_time = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
$now = mktime();
if ($now < $epoch_time)
{
return true;
}
}
}
return false;
}
else
{
return true;
}
}

+ Here is the call graph for this function:

ilObjTest::canShowCertificate (   $user_id,
  $active_id 
)

Checks whether the certificate button could be shown on the info page or not.

public

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

References canShowTestResults(), getCertificateVisibility(), and getPassed().

{
if ($this->canShowTestResults($user_id))
{
include_once "./Services/Certificate/classes/class.ilCertificate.php";
include_once "./Modules/Test/classes/class.ilTestCertificateAdapter.php";
$cert = new ilCertificate(new ilTestCertificateAdapter($this));
if ($cert->isComplete())
{
$vis = $this->getCertificateVisibility();
$showcert = FALSE;
switch ($vis)
{
case 0:
$showcert = TRUE;
break;
case 1:
if ($this->getPassed($active_id))
{
$showcert = TRUE;
}
break;
case 2:
$showcert = FALSE;
break;
}
if ($showcert)
{
return TRUE;
}
else
{
return FALSE;
}
}
else
{
return FALSE;
}
}
else
{
return FALSE;
}
}

+ Here is the call graph for this function:

ilObjTest::canShowTestResults (   $user_id)

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

References $starting_time, canViewResults(), endingTimeReached(), getActiveIdOfUser(), getScoreReporting(), getStartingTimeOfUser(), getTestSession(), isMaxProcessingTimeReached(), isTestFinishedToViewResults(), and REPORT_AFTER_TEST.

Referenced by canShowCertificate().

{
$active_id = $this->getActiveIdOfUser($user_id);
if ($active_id > 0)
{
$starting_time = $this->getStartingTimeOfUser($active_id);
}
$notimeleft = FALSE;
if ($starting_time !== FALSE)
{
if ($this->isMaxProcessingTimeReached($starting_time, $active_id))
{
$notimeleft = TRUE;
}
}
$result = TRUE;
if (!$this->isTestFinishedToViewResults($active_id, $this->getTestSession($active_id)->getPass()) && ($this->getScoreReporting() == REPORT_AFTER_TEST))
{
$result = FALSE;
}
if (($this->endingTimeReached()) || $notimeleft) $result = TRUE;
$result = $result & $this->canViewResults();
return $result;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::canViewResults ( )

Returns true, if the test results can be viewed.

Returns
boolean True, if the test results can be viewed, else false public

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

References getReportingDate(), and getScoreReporting().

Referenced by canShowTestResults().

{
$result = true;
if ($this->getScoreReporting() == 4) return false;
if ($this->getReportingDate())
{
if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->getReportingDate(), $matches))
{
$epoch_time = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
$now = mktime();
if ($now < $epoch_time)
{
$result = false;
}
}
}
return $result;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::checkMarks ( )

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

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

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

References $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getAllowedUsers(), getAllowedUsersTimeGap(), getTestId(), and logAction().

{
global $ilDB;
$nr_of_users = $this->getAllowedUsers();
$time_gap = ($this->getAllowedUsersTimeGap()) ? $this->getAllowedUsersTimeGap() : 60;
if (($nr_of_users > 0) && ($time_gap > 0))
{
$now = mktime();
$time_border = $now - $time_gap;
$str_time_border = strftime("%Y%m%d%H%M%S", $time_border);
$result = $ilDB->queryF("SELECT DISTINCT tst_times.active_fi FROM tst_times, tst_active WHERE tst_times.tstamp > %s AND tst_times.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
array('integer', 'integer'),
array($time_border, $this->getTestId())
);
if ($result->numRows() >= $nr_of_users)
{
include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_could_not_enter_test_due_to_simultaneous_users", ilObjAssessmentFolder::_getLogLanguage()));
}
return FALSE;
}
else
{
return TRUE;
}
}
return TRUE;
}

+ Here is the call graph for this function:

ilObjTest::cleanupMediaobjectUsage ( )

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

private

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

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

Referenced by saveToDb().

{
include_once("./Services/RTE/classes/class.ilRTE.php");
$completecontent = "";
foreach ($this->getAllRTEContent() as $content)
{
$completecontent .= $content;
}
ilRTE::_cleanupMediaObjectUsage($completecontent, $this->getType() . ":html",
$this->getId());
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::cloneObject (   $a_target_id,
  $a_copy_id = 0 
)

Clone object.

public

Parameters
intref id of parent container
intcopy id
Returns
object new test object

Reimplemented from ilObject.

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

References $ilDB, $ilLog, $mark_schema, ilCopyWizardOptions\_getInstance(), assQuestion\_getOriginalId(), _instanciateQuestion(), ilObject\cloneMetaData(), cloneRandomQuestions(), getAnonymity(), getAnswerFeedback(), getAnswerFeedbackPoints(), getAuthor(), getAutosave(), getCertificateVisibility(), getCountSystem(), getCustomStyle(), getECTSFX(), getECTSGrades(), getECTSOutput(), getEnableProcessingTime(), getEndingTime(), getExamPdf(), getFinalStatement(), getFixedParticipants(), getForceJS(), getInstantFeedbackSolution(), getIntroduction(), getKiosk(), getListOfQuestionsSettings(), getMailNotification(), getMailNotificationType(), getMCScoring(), getNrOfTries(), getPassScoring(), getPassword(), getProcessingTime(), getRandomQuestionCount(), getRedirectAfterExam(), getRedirectOnlyKioskMode(), ilObject\getRefId(), getReportingDate(), getResetProcessingTime(), getResultsPresentation(), getScoreCutting(), getScoreReporting(), getSequenceSettings(), getShowCancel(), getShowFinalStatement(), getShowInfo(), getShowMarker(), getShuffleQuestions(), getStartingTime(), getTitleOutput(), getUsePreviousAnswers(), isRandomTest(), and loadFromDb().

{
global $ilDB,$ilLog;
$this->loadFromDb();
// Copy settings
$newObj = parent::cloneObject($a_target_id,$a_copy_id);
$this->cloneMetaData($newObj);
$newObj->setAnonymity($this->getAnonymity());
$newObj->setAnswerFeedback($this->getAnswerFeedback());
$newObj->setAnswerFeedbackPoints($this->getAnswerFeedbackPoints());
$newObj->setAuthor($this->getAuthor());
$newObj->setCountSystem($this->getCountSystem());
$newObj->setECTSFX($this->getECTSFX());
$newObj->setECTSGrades($this->getECTSGrades());
$newObj->setECTSOutput($this->getECTSOutput());
$newObj->setEnableProcessingTime($this->getEnableProcessingTime());
$newObj->setEndingTime($this->getEndingTime());
$newObj->setFixedParticipants($this->getFixedParticipants());
$newObj->setInstantFeedbackSolution($this->getInstantFeedbackSolution());
$newObj->setIntroduction($this->getIntroduction());
$newObj->setFinalStatement($this->getFinalStatement());
/* Change Sn */
$newObj->setRedirectAfterExam($this->getRedirectAfterExam());
$newObj->setRedirectOnlyKioskMode($this->getRedirectOnlyKioskMode());
$newObj->setExamPdf($this->getExamPdf());
/* Change Sn End */
$newObj->setShowInfo($this->getShowInfo());
$newObj->setForceJS($this->getForceJS());
$newObj->setCustomStyle($this->getCustomStyle());
$newObj->setShowFinalStatement($this->getShowFinalStatement());
$newObj->setListOfQuestionsSettings($this->getListOfQuestionsSettings());
$newObj->setKiosk($this->getKiosk());
$newObj->setMCScoring($this->getMCScoring());
$newObj->setMailNotification($this->getMailNotification());
$newObj->setMailNotificationType($this->getMailNotificationType());
$newObj->setNrOfTries($this->getNrOfTries());
$newObj->setPassScoring($this->getPassScoring());
$newObj->setPassword($this->getPassword());
$newObj->setProcessingTime($this->getProcessingTime());
$newObj->setRandomQuestionCount($this->getRandomQuestionCount());
$newObj->setRandomTest($this->isRandomTest());
$newObj->setReportingDate($this->getReportingDate());
$newObj->setResetProcessingTime($this->getResetProcessingTime());
$newObj->setResultsPresentation($this->getResultsPresentation());
$newObj->setScoreCutting($this->getScoreCutting());
$newObj->setScoreReporting($this->getScoreReporting());
$newObj->setSequenceSettings($this->getSequenceSettings());
$newObj->setShowCancel($this->getShowCancel());
$newObj->setAutosave($this->getAutosave());
$newObj->setShowMarker($this->getShowMarker());
$newObj->setShuffleQuestions($this->getShuffleQuestions());
$newObj->setStartingTime($this->getStartingTime());
$newObj->setTitleOutput($this->getTitleOutput());
$newObj->setUsePreviousAnswers($this->getUsePreviousAnswers());
$newObj->setCertificateVisibility($this->getCertificateVisibility());
$newObj->mark_schema = clone $this->mark_schema;
$newObj->saveToDb();
// clone certificate
include_once "./Services/Certificate/classes/class.ilCertificate.php";
include_once "./Modules/Test/classes/class.ilTestCertificateAdapter.php";
$cert = new ilCertificate(new ilTestCertificateAdapter($this));
$newcert = new ilCertificate(new ilTestCertificateAdapter($newObj));
$cert->cloneCertificate($newcert);
if ($this->isRandomTest())
{
$newObj->saveRandomQuestionCount($newObj->getRandomQuestionCount());
$this->cloneRandomQuestions($newObj->getTestId());
}
else
{
include_once("./Services/CopyWizard/classes/class.ilCopyWizardOptions.php");
$cwo = ilCopyWizardOptions::_getInstance($a_copy_id);
// clone the questions
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
foreach ($this->questions as $key => $question_id)
{
$question = ilObjTest::_instanciateQuestion($question_id);
$newObj->questions[$key] = $question->duplicate();
$original_id = assQuestion::_getOriginalId($question_id);
$question = ilObjTest::_instanciateQuestion($newObj->questions[$key]);
$question->saveToDb($original_id);
// Save the mapping of old question id <-> new question id
// This will be used in class.ilObjCourse::cloneDependencies to copy learning objectives
$cwo->appendMapping($this->getRefId().'_'.$question_id,$newObj->getRefId().'_'.$newObj->questions[$key]);
$ilLog->write(__METHOD__.': Added mapping '.$this->getRefId().'_'.$question_id.' <-> ' .
$newObj->getRefId().'_'.$newObj->questions[$key]);
}
}
$newObj->saveToDb();
return $newObj;
}

+ Here is the call graph for this function:

ilObjTest::cloneRandomQuestions (   $new_id)

Duplicates the source random questionpools for another test.

Parameters
integer$new_idTest id of the new test which should take the random questionpools public

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

References $ilDB, $row, and getTestId().

Referenced by cloneObject().

{
global $ilDB;
if ($new_id > 0)
{
$result = $ilDB->queryF("SELECT * FROM tst_test_random WHERE test_fi = %s ORDER BY sequence, test_random_id",
array('integer'),
array($this->getTestId())
);
if ($result->numRows())
{
while ($row = $ilDB->fetchAssoc($result))
{
$next_id = $ilDB->nextId('tst_test_random');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_test_random (test_random_id, test_fi, questionpool_fi, num_of_q, tstamp, sequence) VALUES (%s, %s, %s, %s, %s, %s)",
array('integer', 'integer', 'integer', 'integer', 'integer', 'integer'),
array($next_id, $new_id, $row["questionpool_fi"], $row["num_of_q"], time(), $row['sequence'])
);
}
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::create (   $a_upload = false)

create test object

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

References ilObject\create(), and createMetaData().

{
parent::create();
// meta data will be created by
// import parser
if (!$a_upload)
{
$this->createMetaData();
}
}

+ Here is the call graph for this function:

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

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

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

+ Here is the call graph for this function:

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

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

References ilObject\$ilias, ilUtil\getDataDir(), and ilUtil\makeDir().

{
include_once "./Services/Utilities/classes/class.ilUtil.php";
$tst_data_dir = ilUtil::getDataDir()."/tst_data";
ilUtil::makeDir($tst_data_dir);
if (!is_writable($tst_data_dir))
{
$this->ilias->raiseError("Test Data Directory (".$tst_data_dir
.") not writeable.",$this->ilias->error_obj->FATAL);
}
// create test directory (data_dir/tst_data/tst_import)
$tst_dir = $tst_data_dir."/tst_import";
ilUtil::makeDir($tst_dir);
if (!@is_dir($tst_dir))
{
$ilias->raiseError("Creation of test import directory failed.",$ilias->error_obj->FATAL);
}
}

+ Here is the call graph for this function:

ilObjTest::createMetaData ( )

Create meta data entry.

public

Reimplemented from ilObject.

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

References saveAuthorToMetadata().

Referenced by create().

{
parent::createMetaData();
$this->saveAuthorToMetadata();
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::createNewAccessCode ( )

Returns a new, unused test access code.

Returns
string A new test access code

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

References isAccessCodeUsed().

{
// create a 5 character code
$codestring = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
mt_srand();
$code = "";
for ($i = 1; $i <=5; $i++)
{
$index = mt_rand(0, strlen($codestring)-1);
$code .= substr($codestring, $index, 1);
}
// verify it against the database
while ($this->isAccessCodeUsed($code))
{
$code = $this->createNewAccessCode();
}
return $code;
}

+ Here is the call graph for this function:

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

Creates a question GUI instance of a given question type.

Parameters
integer$question_typeThe question type of the question
integer$question_idThe question id of the question, if available
Returns
object The question GUI instance public

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

References assQuestion\_includeClass(), and getQuestionType().

Referenced by packageRun(), and recalculateSolutions().

{
if ((!$question_type) and ($question_id > 0))
{
$question_type = $this->getQuestionType($question_id);
}
if (!strlen($question_type)) return null;
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
assQuestion::_includeClass($question_type, 1);
$question_type_gui = $question_type . "GUI";
$question = new $question_type_gui();
if ($question_id > 0)
{
$question->object->loadFromDb($question_id);
}
return $question;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::createRandomSolutions (   $number)

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

References $data, $ilDB, $pass, $query, $testSequence, $testSession, _instanciateQuestion(), getNrOfTries(), getQuestionCount(), ilObject\getRefId(), getTestId(), isRandomTest(), and setActiveTestSubmitted().

{
global $ilDB;
// 1. get a user
$query = "SELECT usr_id FROM usr_data";
$result = $ilDB->query($query);
while ($data = $ilDB->fetchAssoc($result))
{
$activequery = sprintf("SELECT user_fi FROM tst_active WHERE test_fi = %s AND user_fi = %s",
$ilDB->quote($this->getTestId()),
$ilDB->quote($data['usr_id'])
);
$activeresult = $ilDB->query($activequery);
if ($activeresult->numRows() == 0)
{
$user_id = $data['usr_id'];
if ($user_id != 13)
{
include_once "./Modules/Test/classes/class.ilTestSession.php";
$testSession = FALSE;
$testSession = new ilTestSession();
$testSession->setRefId($this->getRefId());
$testSession->setTestId($this->getTestId());
$testSession->setUserId($user_id);
$testSession->saveToDb();
$passes = ($this->getNrOfTries()) ? $this->getNrOfTries() : 10;
$nr_of_passes = rand(1, $passes);
$active_id = $testSession->getActiveId();
for ($pass = 0; $pass < $nr_of_passes; $pass++)
{
include_once "./Modules/Test/classes/class.ilTestSequence.php";
$testSequence = new ilTestSequence($active_id, $pass, $this->isRandomTest());
if (!$testSequence->hasSequence())
{
$testSequence->createNewSequence($this->getQuestionCount(), $shuffle);
$testSequence->saveToDb();
}
for ($seq = 1; $seq <= count($this->questions); $seq++)
{
$question_id = $testSequence->getQuestionForSequence($seq);
$objQuestion = ilObjTest::_instanciateQuestion($question_id);
$objQuestion->createRandomSolution($testSession->getActiveId(), $pass);
}
if ($pass < $nr_of_passes - 1)
{
$testSession->increasePass();
$testSession->setLastSequence(0);
$testSession->saveToDb();
}
else
{
$this->setActiveTestSubmitted($user_id);
}
}
$number--;
if ($number == 0) return;
}
}
}
}

+ Here is the call graph for this function:

ilObjTest::createReference ( )

Creates a database reference id for the object (saves the object to the database and creates a reference id in the database)

public

Reimplemented from ilObject.

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

References saveToDb().

{
$result = parent::createReference();
$this->saveToDb();
return $result;
}

+ Here is the call graph for this function:

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

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

References $pass, getQuestionCount(), and isRandomTest().

{
include_once "./Modules/Test/classes/class.ilTestSequence.php";
$this->testSequence = new ilTestSequence($active_id, $pass, $this->isRandomTest());
if (!$this->testSequence->hasSequence())
{
$this->testSequence->createNewSequence($this->getQuestionCount(), $shuffle);
$this->testSequence->saveToDb();
}
}

+ Here is the call graph for this function:

& ilObjTest::createTestSession ( )

Creates the test session data for the active user.

Returns
object The ilTestSession object or FALSE if the creation of the object fails public

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

References $_SESSION, $testSession, ilObject\getRefId(), and getTestId().

{
global $ilUser;
include_once "./Modules/Test/classes/class.ilTestSession.php";
$testSession = FALSE;
$testSession = new ilTestSession();
$testSession->setRefId($this->getRefId());
$testSession->setTestId($this->getTestId());
$testSession->setUserId($ilUser->getId());
$testSession->setAnonymousId($_SESSION["tst_access_code"][$this->getTestId()]);
$testSession->saveToDb();
$this->testSession =& $testSession;
return $this->testSession;
}

+ Here is the call graph for this function:

ilObjTest::delete ( )

delete object and all related data

public

Returns
boolean true if all object data were removed; false if only a references were removed

Reimplemented from ilObject.

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

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

{
// always call parent delete function first!!
if (!parent::delete())
{
return false;
}
// delet meta data
$this->deleteMetaData();
//put here your module specific stuff
$this->deleteTest();
return true;
}

+ Here is the call graph for this function:

ilObjTest::deleteDefaults (   $test_default_id)

Deletes the defaults for a test.

Parameters
integer$test_default_idThe database ID of the test defaults public

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

References $ilDB.

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_defaults WHERE test_defaults_id = %s",
array('integer'),
array($test_default_id)
);
}
ilObjTest::deleteRunPackage (   $date)

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

References $file, and getRunPackageFilename().

Referenced by obliterateRun().

{
$packagefilename = $this->getRunPackageFilename($date);
if ('' === $packagefilename)
{
return false;
}
else
{
unlink ($packagefilename);
// cut suffix off to make directory name
$pdfdirname = substr($packagefilename, 0, -4);
// recursively delete directory and contents
// I can't believe there is no library function for this. PHP FTW.
$diriterator = new RecursiveDirectoryIterator($pdfdirname);
$diriterator->setFlags(RecursiveDirectoryIterator::SKIP_DOTS);
$iterator =
new RecursiveIteratorIterator($diriterator,
RecursiveIteratorIterator::CHILD_FIRST);
foreach ($iterator as $file)
{
if ($file->isDir())
{
rmdir($file->getPathname());
}
else
{
unlink($file->getPathname());
}
}
rmdir($pdfdirname);
// TODO there should be some kind of error handling
return true;
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::deleteTest ( )

Deletes the test and all related objects, files and database entries.

public

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

References $ilDB, $mobs, $row, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilUtil\delDir(), ilUtil\getDataDir(), ilObject\getId(), getTestId(), isRandomTest(), removeAllTestEditings(), removeDuplicatedQuestionpools(), and removeQuestion().

Referenced by delete().

{
global $ilDB;
// first of all remove all test editings, because the delete statements used for this
// contain a subquery for active ids, that are deleted in the next steps
$this->removeAllTestEditings();
$result = $ilDB->queryF("SELECT active_id FROM tst_active WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
$active_array = array();
while ($row = $ilDB->fetchAssoc($result))
{
array_push($active_array, $row["active_id"]);
}
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_active WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
if (count($active_array))
{
foreach ($active_array as $active_id)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_times WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_sequence WHERE active_fi = %s",
array('integer'),
array($active_id)
);
}
}
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_mark WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
$result = $ilDB->queryF("SELECT question_fi FROM tst_test_question WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
while ($row = $ilDB->fetchAssoc($result))
{
$this->removeQuestion($row["question_fi"]);
}
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_tests WHERE test_id = %s",
array('integer'),
array($this->getTestId())
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_random WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
// this delete is allready done by call to removeAllTestEditings some lines above
/*$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_rnd_qst WHERE tst_test_rnd_qst.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);*/
// moved to top of this method because this method performs delete statements,
// that use a subquery for active ids, that are allready deleted some lines above
//$this->removeAllTestEditings();
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_question WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
if ($this->isRandomTest())
{
$this->removeDuplicatedQuestionpools();
}
// delete export files
include_once "./Services/Utilities/classes/class.ilUtil.php";
$tst_data_dir = ilUtil::getDataDir()."/tst_data";
$directory = $tst_data_dir."/tst_".$this->getId();
if (is_dir($directory))
{
include_once "./Services/Utilities/classes/class.ilUtil.php";
ilUtil::delDir($directory);
}
include_once("./Services/MediaObjects/classes/class.ilObjMediaObject.php");
$mobs = ilObjMediaObject::_getMobsOfObject("tst:html", $this->getId());
// remaining usages are not in text anymore -> delete them
// and media objects (note: delete method of ilObjMediaObject
// checks whether object is used in another context; if yes,
// the object is not deleted!)
foreach($mobs as $mob)
{
ilObjMediaObject::_removeUsage($mob, "tst:html", $this->getId());
if (ilObjMediaObject::_exists($mob))
{
$mob_obj =& new ilObjMediaObject($mob);
$mob_obj->delete();
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::deliverPDFFromHTML (   $content,
  $title = NULL,
  $filename = NULL 
)

Delivers a PDF file from XHTML.

Parameters
string$htmlThe XHTML string public

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

References $_GET, $config, $filename, $ilLog, $tidy, ilObject\$title, _getUserIdFromActiveId(), ilObjUser\_lookupName(), ilUtil\getStyleSheetLocation(), getTestStyleLocation(), ilObject\getTitle(), and ilUtil\prepareFormOutput().

Referenced by packageRun().

{
global $ilLog;
$content = preg_replace("/href=\".*?\"/", "", $content);
$printbody = new ilTemplate("tpl.il_as_tst_print_body.html", TRUE, TRUE, "Modules/Test");
$printbody->setVariable("TITLE", ilUtil::prepareFormOutput($this->getTitle()));
$printbody->setVariable("ADM_CONTENT", $content);
$printbody->setCurrentBlock("css_file");
$printbody->setVariable("CSS_FILE", $this->getTestStyleLocation("filesystem"));
$printbody->parseCurrentBlock();
$printbody->setCurrentBlock("css_file");
$printbody->setVariable("CSS_FILE", ilUtil::getStyleSheetLocation("filesystem", "delos.css"));
$printbody->parseCurrentBlock();
$printoutput = $printbody->get();
$html = str_replace("href=\"./", "href=\"" . ILIAS_HTTP_PATH . "/", $printoutput);
$html = str_replace("img src=\"./", "img src=\"" . ILIAS_HTTP_PATH . "/", $html);
$html = preg_replace("/<div id=\"dontprint\">.*?<\\/div>/ims", "", $html);
if (extension_loaded("tidy"))
{
$config = array(
"indent" => false,
"output-xml" => true,
"numeric-entities" => true
);
$tidy = new tidy();
$tidy->parseString($html, $config, 'utf8');
$tidy->cleanRepair();
$html = tidy_get_output($tidy);
$html = preg_replace("/^.*?(<html)/", "\\1", $html);
}
else
{
$html = str_replace("&nbsp;", "&#160;", $html);
$html = str_replace("&otimes;", "X", $html);
}
$title = ($title) ? $title : $this->getTitle();
$active_id = $_GET["active_id"];
include_once './Services/User/classes/class.ilObjUser.php';
$user_id = $this->_getUserIdFromActiveId($active_id);
$uname = ilObjUser::_lookupName($user_id);
$filename_pdf = $uname['lastname']."_".$uname['firstname']."_".$uname['login']."_";
$pdfSetting = new ilSetting("pdf");
include_once "./Services/PDF/classes/class.ilHTMLToPDF.php";
$transformer = null;
switch ($pdfSetting->get('html_to_pdf_method'))
{
case 'fop':
include_once "./Services/PDF/classes/class.ilHTMLToPDFTransformerUsingFOP.php";
$transformer = new ilHTMLtoPDFTransformerUsingFOP($filename_pdf . $title . '.pdf');
$transformer->xsl = "./Modules/Test/xml/question2fo.xsl";
break;
case 'webkit':
include_once "./Services/PDF/classes/class.ilHTMLToPDFTransformerUsingWebkit.php";
$transformer = new ilHTMLtoPDFTransformerUsingWebkit($filename_pdf . $title . '.pdf');
break;
}
if (is_object($transformer))
{
$generator = new ilHTMLtoPDF($transformer);
if ($filename)
{
$generator->createPDFFileFromHTMLString($html, $filename);
}
else
{
$generator->deliverPDFFromHTMLString($html);
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::disinviteUser (   $user_id)

Disinvites a user from a test.

Parameters
integer$user_idThe database id of the disinvited user public

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

References $ilDB, and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::duplicateQuestionForTest (   $question_id)

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

Parameters
integer$question_idThe database id of the question
Returns
integer The database id of the copied question public

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

References _instanciateQuestion().

Referenced by insertQuestion(), and saveRandomQuestion().

{
global $ilUser;
$question =& ilObjTest::_instanciateQuestion($question_id);
$duplicate_id = $question->duplicate(true);
return $duplicate_id;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::duplicateQuestionpoolForTest (   $questionpool_id)
protected

Duplicates all valid questions of a questionpool for use in a random test.

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

References $ilDB, $row, _instanciateQuestion(), ilObject\_lookupTitle(), and getTestId().

Referenced by saveRandomQuestionpools().

{
global $ilDB;
$result = $ilDB->queryF('SELECT question_id FROM qpl_questions WHERE obj_fi = %s AND complete = %s AND original_id IS NULL',
array('integer', 'text'),
array($questionpool_id, 1)
);
$saved_titles = array();
while ($row = $ilDB->fetchAssoc($result))
{
$question =& ilObjTest::_instanciateQuestion($row['question_id']);
$duplicate_id = $question->duplicate(true);
if ($duplicate_id > 0)
{
$next_id = $ilDB->nextId('tst_rnd_cpy');
$ilDB->manipulateF('INSERT INTO tst_rnd_cpy (copy_id, tst_fi, qst_fi, qpl_fi) VALUES (%s, %s, %s, %s)',
array('integer', 'integer', 'integer', 'integer'),
array($next_id, $this->getTestId(), $duplicate_id, $questionpool_id)
);
if (!array_key_exists($questionpool_id, $saved_titles))
{
$next_id = $ilDB->nextId('tst_rnd_qpl_title');
$ilDB->manipulateF('INSERT INTO tst_rnd_qpl_title (title_id, tst_fi, qpl_fi, qpl_title) VALUES (%s, %s, %s, %s)',
array('integer', 'integer', 'integer', 'text'),
array($next_id, $this->getTestId(), $questionpool_id, ilObject::_lookupTitle($questionpool_id))
);
$saved_titles[$questionpool_id] = 1;
}
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::endingTimeReached ( )

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

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

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

References getEndingTime().

Referenced by canShowTestResults(), and isExecutable().

{
if ($this->getEndingTime())
{
if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->getEndingTime(), $matches))
{
$epoch_time = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
$now = mktime();
if ($now > $epoch_time)
{
// ending time reached
return true;
}
}
}
return false;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::evalResultsOverview ( )

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

Returns
array An associated array containing the results public

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

References _evalResultsOverview(), and getTestId().

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

+ Here is the call graph for this function:

& ilObjTest::evalResultsOverviewOfParticipant (   $active_id)

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

Parameters
integer$active_idThe active id of the participant
Returns
array An associated array containing the results public

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

References $ilDB, $row, and getTestId().

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

+ Here is the call graph for this function:

& ilObjTest::evalStatistical (   $active_id)

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

Returns
arrary The statistical evaluation array of the test public

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

References $ilDB, $pass, $row, _getResultPass(), and getTestResult().

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

+ Here is the call graph for this function:

ilObjTest::evalTotalFinished ( )

Returns the number of total finished tests.

Returns
integer The number of total finished tests public

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

References $ilDB, $row, and getTestId().

Referenced by getAggregatedResultsData().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Returns all participants who started the test.

Returns
arrary The active user id's and names of the persons who started the test public

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

References $ilDB, $row, getAnonymity(), and getTestId().

Referenced by getTotalPointsPassedArray().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::evalTotalPersons ( )

Returns the number of persons who started the test.

Returns
integer The number of persons who started the test public

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

References $ilDB, $row, and getTestId().

Referenced by applyDefaults(), canEditMarks(), and saveToDb().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Returns all persons who started the test.

Returns
arrary The user id's and names of the persons who started the test public

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

References $ilDB, $row, getAnonymity(), and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::evalTotalStartedAverageTime ( )

Returns the average processing time for all started tests.

Returns
integer The average processing time for all started tests public

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

References $ilDB, $row, and getTestId().

Referenced by getAggregatedResultsData().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

export files of file itmes

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

Referenced by exportPagesXML().

{
include_once "./Modules/File/classes/class.ilObjFile.php";
foreach ($this->file_ids as $file_id)
{
$expLog->write(date("[y-m-d H:i:s] ")."File Item ".$file_id);
$file_obj = new ilObjFile($file_id, false);
$file_obj->export($a_target_dir);
unset($file_obj);
}
}

+ Here is the caller graph for this function:

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_writerilXmlWriter object that receives the xml data

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

References $ilBench, exportFileItems(), exportXMLMediaObjects(), exportXMLMetaData(), and exportXMLPageObjects().

{
global $ilBench;
$this->mob_ids = array();
$this->file_ids = array();
$attrs = array();
$attrs["Type"] = "Test";
$a_xml_writer->xmlStartTag("ContentObject", $attrs);
// MetaData
$this->exportXMLMetaData($a_xml_writer);
// PageObjects
$expLog->write(date("[y-m-d H:i:s] ")."Start Export Page Objects");
$ilBench->start("ContentObjectExport", "exportPageObjects");
$this->exportXMLPageObjects($a_xml_writer, $a_inst, $expLog);
$ilBench->stop("ContentObjectExport", "exportPageObjects");
$expLog->write(date("[y-m-d H:i:s] ")."Finished Export Page Objects");
// MediaObjects
$expLog->write(date("[y-m-d H:i:s] ")."Start Export Media Objects");
$ilBench->start("ContentObjectExport", "exportMediaObjects");
$this->exportXMLMediaObjects($a_xml_writer, $a_inst, $a_target_dir, $expLog);
$ilBench->stop("ContentObjectExport", "exportMediaObjects");
$expLog->write(date("[y-m-d H:i:s] ")."Finished Export Media Objects");
// FileItems
$expLog->write(date("[y-m-d H:i:s] ")."Start Export File Items");
$ilBench->start("ContentObjectExport", "exportFileItems");
$this->exportFileItems($a_target_dir, $expLog);
$ilBench->stop("ContentObjectExport", "exportFileItems");
$expLog->write(date("[y-m-d H:i:s] ")."Finished Export File Items");
$a_xml_writer->xmlEndTag("ContentObject");
}

+ Here is the call graph for this function:

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

export media objects to xml (see ilias_co.dtd)

Parameters
object$a_xml_writerilXmlWriter object that receives the xml data

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

References ilObjMediaObject\_exists().

Referenced by exportPagesXML().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::exportXMLMetaData ( &  $a_xml_writer)

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

Parameters
object$a_xml_writerilXmlWriter object that receives the xml data

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

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

Referenced by exportPagesXML().

{
include_once "./Services/MetaData/classes/class.ilMD2XML.php";
$md2xml = new ilMD2XML($this->getId(), 0, $this->getType());
$md2xml->setExportMode(true);
$md2xml->startExport();
$a_xml_writer->appendXML($md2xml->getXML());
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

export page objects to xml (see ilias_co.dtd)

Parameters
object$a_xml_writerilXmlWriter object that receives the xml data

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

References $ilBench.

Referenced by exportPagesXML().

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

+ Here is the caller graph for this function:

ilObjTest::fromXML ( &  $assessment)

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

Parameters
object$assessmentThe QTI assessment object public

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

References $_SESSION, $ilLog, $metadata, ilObject\$type, ilRTE\_replaceMediaObjectImageSrc(), ilObjMediaObject\_saveTempFileAsMediaObject(), ilObjMediaObject\_saveUsage(), getFinalStatement(), ilObject\getId(), getImportDirectory(), getIntroduction(), QTIMaterialToString(), saveToDb(), setAllowedUsers(), setAllowedUsersTimeGap(), setAnonymity(), setAnswerFeedback(), setAnswerFeedbackPoints(), setAuthor(), setAutosave(), setCountSystem(), setCustomStyle(), ilObject\setDescription(), setEnableProcessingTime(), setEndingTime(), setExamPdf(), setExportSettings(), setFinalStatement(), setFixedParticipants(), setForceJS(), setInstantFeedbackSolution(), setIntroduction(), setKiosk(), setListOfQuestionsSettings(), setMailNotification(), setMailNotificationType(), setMCScoring(), setNrOfTries(), setPassScoring(), setPassword(), setProcessingTime(), setRandomQuestionCount(), setRandomTest(), setRedirectAfterExam(), setRedirectOnlyKioskMode(), setReportingDate(), setResetProcessingTime(), setResultsPresentation(), setScoreCutting(), setScoreReporting(), setSequenceSettings(), setShowCancel(), setShowFinalStatement(), setShowInfo(), setShowMarker(), setShowSerial(), setShowSolutionPrintview(), setShuffleQuestions(), setStartingTime(), ilObject\setTitle(), setTitleOutput(), and setUsePreviousAnswers().

{
unset($_SESSION["import_mob_xhtml"]);
$this->setDescription($assessment->getComment());
$this->setTitle($assessment->getTitle());
foreach ($assessment->objectives as $objectives)
{
foreach ($objectives->materials as $material)
{
$this->setIntroduction($this->QTIMaterialToString($material));
}
}
if ($assessment->getPresentationMaterial())
{
$this->setFinalStatement($this->QTIMaterialToString($assessment->getPresentationMaterial()));
}
foreach ($assessment->assessmentcontrol as $assessmentcontrol)
{
switch ($assessmentcontrol->getSolutionswitch())
{
case "Yes":
$this->setInstantFeedbackSolution(1);
break;
default:
$this->setInstantFeedbackSolution(0);
break;
}
}
foreach ($assessment->qtimetadata as $metadata)
{
switch ($metadata["label"])
{
case "test_type":
// for old tests with a test type
$type = $metadata["entry"];
switch ($type)
{
case 1:
// assessment
$this->setAnonymity(1);
break;
case 2:
// self assessment
break;
case 4:
// online exam
$this->setFixedParticipants(1);
$this->setListOfQuestionsSettings(7);
$this->setShowSolutionPrintview(1);
break;
case 5:
// varying random test
break;
}
break;
case "sequence_settings":
$this->setSequenceSettings($metadata["entry"]);
break;
case "author":
$this->setAuthor($metadata["entry"]);
break;
case "nr_of_tries":
$this->setNrOfTries($metadata["entry"]);
break;
case "kiosk":
$this->setKiosk($metadata["entry"]);
break;
case "showfinalstatement":
$this->setShowFinalStatement($metadata["entry"]);
break;
case "redirect_after_exam":
$this->setRedirectAfterExam($metadata["entry"]);
break;
case "redirect_only_kiosk_mode":
$this->setRedirectOnlyKioskMode($metadata["entry"]);
break;
case "exam_pdf":
$this->setExamPdf($metadata["entry"]);
break;
case "showinfo":
$this->setShowInfo($metadata["entry"]);
break;
case "forcejs":
$this->setForceJS($metadata["entry"]);
break;
case "customstyle":
$this->setCustomStyle($metadata["entry"]);
break;
case "hide_previous_results":
if ($metadata["entry"] == 0)
{
$this->setUsePreviousAnswers(1);
}
else
{
$this->setUsePreviousAnswers(0);
}
break;
case "use_previous_answers":
$this->setUsePreviousAnswers($metadata["entry"]);
break;
case "answer_feedback":
$this->setAnswerFeedback($metadata["entry"]);
break;
case "hide_title_points":
$this->setTitleOutput($metadata["entry"]);
break;
case "title_output":
$this->setTitleOutput($metadata["entry"]);
break;
case "random_test":
$this->setRandomTest($metadata["entry"]);
break;
case "random_question_count":
$this->setRandomQuestionCount($metadata["entry"]);
break;
case "results_presentation":
$this->setResultsPresentation($metadata["entry"]);
break;
case "reset_processing_time":
$this->setResetProcessingTime($metadata["entry"]);
break;
case "instant_verification":
$this->setInstantFeedbackSolution($metadata["entry"]);
break;
case "answer_feedback_points":
$this->setAnswerFeedbackPoints($metadata["entry"]);
break;
case "anonymity":
$this->setAnonymity($metadata["entry"]);
break;
case "show_cancel":
$this->setShowCancel($metadata["entry"]);
break;
case "autosave":
$this->setAutosave($metadata["entry"]);
break;
case "show_marker":
$this->setShowMarker($metadata["entry"]);
break;
case "show_serial":
$this->setShowSerial($metadata["entry"]);
break;
case "fixed_participants":
$this->setFixedParticipants($metadata["entry"]);
break;
case "score_reporting":
$this->setScoreReporting($metadata["entry"]);
break;
case "shuffle_questions":
$this->setShuffleQuestions($metadata["entry"]);
break;
case "count_system":
$this->setCountSystem($metadata["entry"]);
break;
case "mc_scoring":
$this->setMCScoring($metadata["entry"]);
break;
case "mailnotification":
$this->setMailNotification($metadata["entry"]);
break;
case "mailnottype":
$this->setMailNotificationType($metadata["entry"]);
break;
case "exportsettings":
$this->setExportSettings($metadata['exportsettings']);
break;
case "score_cutting":
$this->setScoreCutting($metadata["entry"]);
break;
case "password":
$this->setPassword($metadata["entry"]);
break;
case "allowedUsers":
$this->setAllowedUsers($metadata["entry"]);
break;
case "allowedUsersTimeGap":
$this->setAllowedUsersTimeGap($metadata["entry"]);
break;
case "pass_scoring":
$this->setPassScoring($metadata["entry"]);
break;
case "show_summary":
$this->setListOfQuestionsSettings($metadata["entry"]);
break;
case "reporting_date":
$iso8601period = $metadata["entry"];
if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches))
{
$this->setReportingDate(sprintf("%02d%02d%02d%02d%02d%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]));
}
break;
case "processing_time":
$this->setProcessingTime($metadata['entry']);
break;
case "enable_processing_time":
$this->setEnableProcessingTime($metadata['entry']);
break;
case "starting_time":
$iso8601period = $metadata["entry"];
if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches))
{
$this->setStartingTime(sprintf("%02d%02d%02d%02d%02d%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]));
}
break;
case "ending_time":
$iso8601period = $metadata["entry"];
if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches))
{
$this->setEndingTime(sprintf("%02d%02d%02d%02d%02d%02d", $matches[1], $matches[2], $matches[3], $matches[4], $matches[5], $matches[6]));
}
break;
}
if (preg_match("/mark_step_\d+/", $metadata["label"]))
{
$xmlmark = $metadata["entry"];
preg_match("/<short>(.*?)<\/short>/", $xmlmark, $matches);
$mark_short = $matches[1];
preg_match("/<official>(.*?)<\/official>/", $xmlmark, $matches);
$mark_official = $matches[1];
preg_match("/<percentage>(.*?)<\/percentage>/", $xmlmark, $matches);
$mark_percentage = $matches[1];
preg_match("/<passed>(.*?)<\/passed>/", $xmlmark, $matches);
$mark_passed = $matches[1];
$this->mark_schema->addMarkStep($mark_short, $mark_official, $mark_percentage, $mark_passed);
}
}
// handle the import of media objects in XHTML code
if (is_array($_SESSION["import_mob_xhtml"]))
{
include_once "./Services/MediaObjects/classes/class.ilObjMediaObject.php";
include_once "./Services/RTE/classes/class.ilRTE.php";
include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
foreach ($_SESSION["import_mob_xhtml"] as $mob)
{
$importfile = $this->getImportDirectory() . "/" . $_SESSION["tst_import_subdir"] . "/" . $mob["uri"];
if (file_exists($importfile))
{
$media_object =& ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, FALSE);
ilObjMediaObject::_saveUsage($media_object->getId(), "tst:html", $this->getId());
$this->setIntroduction(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getIntroduction()), 1));
$this->setFinalStatement(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getFinalStatement()), 1));
}
else
{
global $ilLog;
$ilLog->write("Error: Could not open XHTML mob file for test introduction during test import. File $importfile does not exist!");
}
}
$this->saveToDb();
}
}

+ Here is the call graph for this function:

ilObjTest::generateRandomPass (   $nr,
  $qpls,
  $pass = NULL 
)

Generates a random test pass for a random test.

Parameters
integer$nrNumber of questions to return
array$qplsArray of questionpools
integer$passTest pass
Returns
array A random selection of questions

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

References $ilDB, $pass, $row, getTestId(), and randomSelectQuestions().

Referenced by generateRandomQuestions().

{
global $ilDB;
$qplids = array();
foreach ($qpls as $arr) array_push($qplids, $arr['qpl']);
$result = $ilDB->queryF('SELECT * FROM tst_rnd_cpy WHERE tst_fi = %s AND ' . $ilDB->in('qpl_fi', $qplids, false, 'integer'),
array('integer'),
array($this->getTestId())
);
if ($result->numRows())
{
$ids = array();
while ($row = $ilDB->fetchAssoc($result)) array_push($ids, $row['qst_fi']);
$nr = ($nr > count($ids)) ? count($ids) : $nr;
if ($nr == 0) return array();
$rand_keys = array_rand($ids, $nr);
$selection = array();
if (is_array($rand_keys))
{
foreach ($rand_keys as $key)
{
$selection[$ids[$key]] = $ids[$key];
}
}
else
{
$selection[$ids[$rand_keys]] = $ids[$rand_keys];
}
return $selection;
}
else
{
// old style random questions
return $this->randomSelectQuestions($nr, 0, 1, $qplids, $pass);
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::generateRandomQuestions (   $active_id,
  $pass = NULL 
)

Generates new random questions for the active user.

private

See Also
$questions

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

References $data, $ilDB, $ilErr, ilObject\$ilias, $pass, generateRandomPass(), getNrOfResultsForPass(), getRandomQuestionCount(), getRandomQuestionpools(), getShuffleQuestions(), getTestId(), hasRandomQuestionsForPass(), and saveRandomQuestion().

{
global $ilUser;
global $ilDB;
if ($active_id > 0)
{
if ($this->hasRandomQuestionsForPass($active_id, $pass) > 0)
{
// Something went wrong. Maybe the user pressed the start button twice
// Questions already exist so there is no need to create new questions
return;
}
if ($pass > 0)
{
if ($this->getNrOfResultsForPass($active_id, $pass - 1) == 0)
{
// This means that someone maybe reloaded the test submission page
// If there are no existing results for the previous test, it makes
// no sense to create a new set of random questions
return;
}
}
}
else
{
// This may not happen! If it happens, raise a fatal error...
global $ilias, $ilErr;
$ilias->raiseError(sprintf($this->lng->txt("error_random_question_generation"), $ilUser->getId(), $this->getTestId()), $ilErr->FATAL);
}
$num = $this->getRandomQuestionCount();
if ($num > 0)
{
$qpls =& $this->getRandomQuestionpools();
$rndquestions = $this->generateRandomPass($num, $qpls, $pass);
$allquestions = array();
foreach ($rndquestions as $question_id)
{
array_push($allquestions, $question_id);
}
if ($this->getShuffleQuestions())
{
srand ((float)microtime()*1000000);
shuffle($allquestions);
}
$maxcount = 0;
foreach ($qpls as $data)
{
$maxcount += $data["contains"];
}
if ($num > $maxcount) $num = $maxcount;
foreach ($allquestions as $question_id)
{
$this->saveRandomQuestion($active_id, $question_id, $pass, $num);
}
}
else
{
$qpls =& $this->getRandomQuestionpools();
$allquestions = array();
$maxcount = 0;
foreach ($qpls as $key => $value)
{
if ($value["count"] > 0)
{
$rndquestions = $this->generateRandomPass($value["count"], array($value), $pass);
foreach ($rndquestions as $question_id)
{
array_push($allquestions, $question_id);
}
}
$add = ($value["count"] <= $value["contains"]) ? $value["count"] : $value["contains"];
$maxcount += $add;
}
if ($this->getShuffleQuestions())
{
srand ((float)microtime()*1000000);
shuffle($allquestions);
}
foreach ($allquestions as $question_id)
{
$this->saveRandomQuestion($active_id, $question_id, $pass, $maxcount);
}
}
}

+ Here is the call graph for this function:

ilObjTest::getAccessCodeSession ( )

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

References $_SESSION, ilObject\$id, and getTestId().

{
$id = $this->getTestId();
if (!is_array($_SESSION["tst_access_code"]))
{
return "";
}
else
{
return $_SESSION["tst_access_code"]["$id"];
}
}

+ Here is the call graph for this function:

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

Gets the active id of a given user.

Parameters
integer$user_idThe database id of the user
string$anonymous_idThe anonymous id if the test is an anonymized test
Returns
integer The active ID public

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

References $_SESSION, $ilDB, $row, and getTestId().

Referenced by canShowTestResults(), getAllQuestions(), getExistingQuestions(), isExecutable(), loadQuestions(), removeTestResultsForUser(), and setQuestionSetSolved().

{
global $ilDB;
global $ilUser;
if (!$user_id) $user_id = $ilUser->getId();
if (($_SESSION["AccountId"] == ANONYMOUS_USER_ID) && (strlen($_SESSION["tst_access_code"][$this->getTestId()])))
{
$result = $ilDB->queryF("SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
array('integer','integer','text'),
array($user_id, $this->test_id, $_SESSION["tst_access_code"][$this->getTestId()])
);
}
else if (strlen($anonymous_id))
{
$result = $ilDB->queryF("SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
array('integer','integer','text'),
array($user_id, $this->test_id, $anonymous_id)
);
}
else
{
if ($_SESSION["AccountId"] == ANONYMOUS_USER_ID)
{
return NULL;
}
$result = $ilDB->queryF("SELECT active_id FROM tst_active WHERE user_fi = %s AND test_fi = %s",
array('integer','integer'),
array($user_id, $this->test_id)
);
}
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
return $row["active_id"];
}
else
{
return 0;
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getAggregatedResultsData ( )

Returns the aggregated test results.

public

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

References $data, $results, evalTotalFinished(), evalTotalStartedAverageTime(), and getCompleteEvaluationData().

{
$data =& $this->getCompleteEvaluationData();
$foundParticipants =& $data->getParticipants();
$results = array("overview" => array(), "questions" => array());
if (count($foundParticipants))
{
$results["overview"][$this->lng->txt("tst_eval_total_persons")] = count($foundParticipants);
$total_finished = $this->evalTotalFinished();
$results["overview"][$this->lng->txt("tst_eval_total_finished")] = $total_finished;
$average_time = $this->evalTotalStartedAverageTime();
$diff_seconds = $average_time;
$diff_hours = floor($diff_seconds/3600);
$diff_seconds -= $diff_hours * 3600;
$diff_minutes = floor($diff_seconds/60);
$diff_seconds -= $diff_minutes * 60;
$results["overview"][$this->lng->txt("tst_eval_total_finished_average_time")] = sprintf("%02d:%02d:%02d", $diff_hours, $diff_minutes, $diff_seconds);
$total_passed = 0;
$total_passed_reached = 0;
$total_passed_max = 0;
$total_passed_time = 0;
foreach ($foundParticipants as $userdata)
{
if ($userdata->getPassed())
{
$total_passed++;
$total_passed_reached += $userdata->getReached();
$total_passed_max += $userdata->getMaxpoints();
$total_passed_time += $userdata->getTimeOfWork();
}
}
$average_passed_reached = $total_passed ? $total_passed_reached / $total_passed : 0;
$average_passed_max = $total_passed ? $total_passed_max / $total_passed : 0;
$average_passed_time = $total_passed ? $total_passed_time / $total_passed : 0;
$results["overview"][$this->lng->txt("tst_eval_total_passed")] = $total_passed;
$results["overview"][$this->lng->txt("tst_eval_total_passed_average_points")] = sprintf("%2.2f", $average_passed_reached) . " " . strtolower($this->lng->txt("of")) . " " . sprintf("%2.2f", $average_passed_max);
$average_time = $average_passed_time;
$diff_seconds = $average_time;
$diff_hours = floor($diff_seconds/3600);
$diff_seconds -= $diff_hours * 3600;
$diff_minutes = floor($diff_seconds/60);
$diff_seconds -= $diff_minutes * 60;
$results["overview"][$this->lng->txt("tst_eval_total_passed_average_time")] = sprintf("%02d:%02d:%02d", $diff_hours, $diff_minutes, $diff_seconds);
}
foreach ($data->getQuestionTitles() as $question_id => $question_title)
{
$answered = 0;
$reached = 0;
$max = 0;
foreach ($foundParticipants as $userdata)
{
for ($i = 0; $i <= $userdata->getLastPass(); $i++)
{
if (is_object($userdata->getPass($i)))
{
$question =& $userdata->getPass($i)->getAnsweredQuestionByQuestionId($question_id);
if (is_array($question))
{
$answered++;
$reached += $question["reached"];
$max += $question["points"];
}
}
}
}
$percent = $max ? $reached/$max * 100.0 : 0;
$counter++;
$results["questions"][$question_id] = array(
$question_title,
sprintf("%.2f", $answered ? $reached / $answered : 0) . " " . strtolower($this->lng->txt("of")) . " " . sprintf("%.2f", $answered ? $max / $answered : 0),
sprintf("%.2f", $percent) . "%",
$answered,
sprintf("%.2f", $answered ? $reached / $answered : 0),
sprintf("%.2f", $answered ? $max / $answered : 0),
$percent / 100.0
);
}
return $results;
}

+ Here is the call graph for this function:

ilObjTest::getAllowedUsers ( )

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

Referenced by checkMaximumAllowedUsers(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getAllowedUsersTimeGap ( )

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

Referenced by checkMaximumAllowedUsers(), and saveToDb().

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

+ Here is the caller graph for this function:

& ilObjTest::getAllQuestions (   $pass = NULL)

Returns all questions of a test in test order.

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

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

References $ilDB, $pass, $row, _getPass(), getActiveIdOfUser(), isRandomTest(), and loadQuestions().

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

+ Here is the call graph for this function:

ilObjTest::getAllRTEContent ( )

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

private

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

References getFinalStatement(), and getIntroduction().

Referenced by cleanupMediaobjectUsage().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

returns all test results for all participants

Parameters
array$partipantsarray of user ids
booleanif true, the result will be prepared for csv output (see processCSVRow)
Returns
array of fields, see code for column titles

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

References ilObject\$lng, $results, $row, _instanciateQuestion(), getAnonymity(), getECTSGrade(), getTotalPointsPassedArray(), and processCSVRow().

{
global $lng;
$results = array();
$row = array(
"user_id" => $lng->txt("user_id"),
"matriculation" => $lng->txt("matriculation"),
"lastname" => $lng->txt("lastname"),
"firstname" => $lng->txt("firstname"),
"login" =>$lng->txt("login"),
"reached_points" => $lng->txt("tst_reached_points"),
"max_points" => $lng->txt("tst_maximum_points"),
"percent_value" => $lng->txt("tst_percent_solved"),
"mark" => $lng->txt("tst_mark"),
"ects" => $lng->txt("ects_grade")
);
$results[] = $row;
if (count($participants))
{
if ($this->ects_output)
{
$passed_array =& $this->getTotalPointsPassedArray();
}
foreach ($participants as $active_id => $user_rec)
{
$row = array();
$reached_points = 0;
$max_points = 0;
foreach ($this->questions as $value)
{
$question =& ilObjTest::_instanciateQuestion($value);
if (is_object($question))
{
$max_points += $question->getMaximumPoints();
$reached_points += $question->getReachedPoints($active_id);
}
}
if ($max_points > 0)
{
$percentvalue = $reached_points / $max_points;
if ($percentvalue < 0) $percentvalue = 0.0;
}
else
{
$percentvalue = 0;
}
$mark_obj = $this->mark_schema->getMatchingMark($percentvalue * 100);
$passed = "";
if ($mark_obj)
{
$mark = $mark_obj->getOfficialName();
$ects_mark = $this->getECTSGrade($passed_array, $reached_points, $max_points);
}
if ($this->getAnonymity())
{
$user_rec['firstname'] = "";
$user_rec['lastname'] = $lng->txt("unknown");
}
$row = array(
"user_id"=>$user_rec['usr_id'],
"matriculation" => $user_rec['matriculation'],
"lastname" => $user_rec['lastname'],
"firstname" => $user_rec['firstname'],
"login"=>$user_rec['login'],
"reached_points" => $reached_points,
"max_points" => $max_points,
"percent_value" => $percentvalue,
"mark" => $mark,
"ects" => $ects_mark
);
$results[] = $prepareForCSV ? $this->processCSVRow ($row, true) : $row;
}
}
return $results;
}

+ Here is the call graph for this function:

ilObjTest::getAnonymity ( )

Returns the anonymity status of the test.

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

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

Referenced by addDefaults(), buildName(), cloneObject(), evalTotalParticipantsArray(), evalTotalPersonsArray(), getAllTestResults(), getDetailedTestResults(), getInvitedUsers(), getParticipants(), getTestParticipants(), getUserData(), saveToDb(), and userLookupFullName().

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

+ Here is the caller graph for this function:

ilObjTest::getAnsweredQuestionCount (   $active_id,
  $pass = NULL 
)

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
integer$passThe pass of the test (optional)
Returns
integer The number of answered questions public

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

References $pass, assQuestion\_isWorkedThrough(), isRandomTest(), and loadQuestions().

{
if ($this->isRandomTest())
{
$this->loadQuestions($active_id, $pass);
}
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
$workedthrough = 0;
foreach ($this->questions as $value)
{
if (assQuestion::_isWorkedThrough($active_id, $value, $pass))
{
$workedthrough += 1;
}
}
return $workedthrough;
}

+ Here is the call graph for this function:

ilObjTest::getAnswerFeedback ( )

Returns 1 if answer specific feedback is activated.

Returns
integer The status of the answer specific feedback public
See Also
$answer_feedback

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getAnswerFeedbackPoints ( )

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

Returns
integer The status of the answer specific feedback as reached points public
See Also
$answer_feedback_points

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getAuthor ( )

Gets the authors name of the ilObjTest object.

Returns
string The string containing the name of the test author public
See Also
$author

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

References $author, ilObject\$id, ilObject\getId(), and ilObject\getType().

Referenced by cloneObject(), loadFromDb(), and saveToDb().

{
$author = array();
include_once "./Services/MetaData/classes/class.ilMD.php";
$md =& new ilMD($this->getId(), 0, $this->getType());
$md_life =& $md->getLifecycle();
if ($md_life)
{
$ids =& $md_life->getContributeIds();
foreach ($ids as $id)
{
$md_cont =& $md_life->getContribute($id);
if (strcmp($md_cont->getRole(), "Author") == 0)
{
$entids =& $md_cont->getEntityIds();
foreach ($entids as $entid)
{
$md_ent =& $md_cont->getEntity($entid);
array_push($author, $md_ent->getEntity());
}
}
}
}
return join($author, ",");
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getAutosave ( )

Returns if autosave is enabled.

Returns
integer 0 = autosave disabled, 1 = autosave enabled public

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

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

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

+ Here is the caller graph for this function:

& ilObjTest::getAvailableDefaults (   $sortby = "name",
  $sortorder = "asc" 
)

Returns the available test defaults for the active user.

Parameters
string$sortbySort field for the database query
string$sortorderSort order for the database query
Returns
array An array containing the defaults public

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

References $ilDB, and $row.

{
global $ilDB;
global $ilUser;
$result = $ilDB->queryF("SELECT * FROM tst_test_defaults WHERE user_fi = %s ORDER BY $sortby $sortorder",
array('integer'),
array($ilUser->getId())
);
$defaults = array();
while ($row = $ilDB->fetchAssoc($result))
{
$defaults[$row["test_defaults_id"]] = $row;
}
return $defaults;
}
& ilObjTest::getAvailableQuestionpools (   $use_object_id = false,
  $equal_points = false,
  $could_be_offline = false,
  $show_path = FALSE,
  $with_questioncount = FALSE,
  $permission = "read" 
)

Returns the available question pools for the active user.

Returns
array The available question pools public

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

References ilObjQuestionPool\_getAvailableQuestionpools().

{
include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
return ilObjQuestionPool::_getAvailableQuestionpools($use_object_id, $equal_points, $could_be_offline, $show_path, $with_questioncount, $permission);
}

+ Here is the call graph for this function:

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

Calculates the available questions for a test.

public

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

References $ilDB, $row, ilObjQuestionPool\_getAvailableQuestionpools(), getExistingQuestions(), getQuestionTypeTranslations(), and isPluginActive().

{
global $ilUser;
global $ilDB;
include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
$available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools($use_object_id = TRUE, $equal_points = FALSE, $could_be_offline = FALSE, $showPath = FALSE, $with_questioncount = FALSE));
$available = "";
if (count($available_pools))
{
$available = " AND " . $ilDB->in('qpl_questions.obj_fi', $available_pools, false, 'integer');
}
else
{
return array();
}
if ($completeonly)
{
$available .= " AND qpl_questions.complete = " . $ilDB->quote("1", 'text');
}
$where = "";
if (is_array($arrFilter))
{
if (array_key_exists('title', $arrFilter) && strlen($arrFilter['title']))
{
$where .= " AND " . $ilDB->like('qpl_questions.title', 'text', "%%" . $arrFilter['title'] . "%%");
}
if (array_key_exists('description', $arrFilter) && strlen($arrFilter['description']))
{
$where .= " AND " . $ilDB->like('qpl_questions.description', 'text', "%%" . $arrFilter['description'] . "%%");
}
if (array_key_exists('author', $arrFilter) && strlen($arrFilter['author']))
{
$where .= " AND " . $ilDB->like('qpl_questions.author', 'text', "%%" . $arrFilter['author'] . "%%");
}
if (array_key_exists('type', $arrFilter) && strlen($arrFilter['type']))
{
$where .= " AND qpl_qst_type.type_tag = " . $ilDB->quote($arrFilter['type'], 'text');
}
if (array_key_exists('qpl', $arrFilter) && strlen($arrFilter['qpl']))
{
$where .= " AND " . $ilDB->like('object_data.title', 'text', "%%" . $arrFilter['qpl'] . "%%");
}
}
$original_ids =& $this->getExistingQuestions();
$original_clause = " qpl_questions.original_id IS NULL";
if (count($original_ids))
{
$original_clause = " qpl_questions.original_id IS NULL AND " . $ilDB->in('qpl_questions.question_id', $original_ids, true, 'integer');
}
$query_result = $ilDB->query(
"SELECT qpl_questions.*, qpl_questions.tstamp, qpl_qst_type.type_tag, qpl_qst_type.plugin, object_data.title qpl " .
"FROM qpl_questions, qpl_qst_type, object_data WHERE $original_clause $available AND " .
"object_data.obj_id = qpl_questions.obj_fi AND qpl_questions.tstamp > 0 AND " .
"qpl_questions.question_type_fi = qpl_qst_type.question_type_id$where");
$rows = array();
$types = $this->getQuestionTypeTranslations();
if ($query_result->numRows())
{
while ($row = $ilDB->fetchAssoc($query_result))
{
$row['ttype'] = $types[$row['type_tag']];
if ($row["plugin"])
{
if ($this->isPluginActive($row["type_tag"]))
{
array_push($rows, $row);
}
}
else
{
array_push($rows, $row);
}
}
}
return $rows;
}

+ Here is the call graph for this function:

ilObjTest::getCertificateVisibility ( )

Returns the visibility settings of the certificate.

Returns
integer The value for the visibility settings (0 = always, 1 = only passed, 2 = never) public

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

Referenced by canShowCertificate(), cloneObject(), and saveToDb().

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

+ Here is the caller graph for this function:

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

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

References $data, and getUnfilteredEvaluationData().

Referenced by getAggregatedResultsData(), and recalculateSolutions().

{
include_once "./Modules/Test/classes/class.ilTestEvaluationData.php";
include_once "./Modules/Test/classes/class.ilTestEvaluationPassData.php";
include_once "./Modules/Test/classes/class.ilTestEvaluationUserData.php";
$data = $this->getUnfilteredEvaluationData();
if ($withStatistics)
{
$data->calculateStatistics();
}
$data->setFilter($filterby, $filtertext);
return $data;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getCompleteWorkingTime (   $user_id)

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

Returns
integer The working time in seconds public

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

References $ilDB, $row, and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::getCompleteWorkingTimeOfParticipant (   $active_id)

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

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

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

References $ilDB, $row, and getTestId().

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

+ Here is the call graph for this function:

& ilObjTest::getCompleteWorkingTimeOfParticipants ( )

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

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

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

References _getCompleteWorkingTimeOfParticipants(), and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::getCountSystem ( )

Gets the count system for the calculation of points.

Returns
integer The count system for the calculation of points public
See Also
$count_system

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getCustomStyle ( )

Get the custom style.

Returns
mixed The custom style, NULL if empty public
See Also
$_customStyle

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

Referenced by addDefaults(), cloneObject(), getTestStyleLocation(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getCustomStyles ( )

Return the available custom styles.

Returns
array An array of strings containing the available custom styles public
See Also
$_customStyle

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

References $filename, $results, ilUtil\getStyleSheetLocation(), and ilFileUtils\recursive_dirscan().

{
$css_path = ilUtil::getStyleSheetLocation("filesystem", "ta.css", "Modules/Test");
$css_path = str_replace("ta.css", "customstyles", $css_path) . "/";
$customstyles = array();
if (is_dir($css_path))
{
$results = array();
include_once "./Services/Utilities/classes/class.ilFileUtils.php";
ilFileUtils::recursive_dirscan($css_path, $results);
if (is_array($results["file"]))
{
foreach ($results["file"] as $filename)
{
if (strpos($filename, ".css"))
{
array_push($customstyles, $filename);
}
}
}
}
return $customstyles;
}

+ Here is the call graph for this function:

ilObjTest::getDetailedTestResults (   $participants)

returns all test results for all participants

Parameters
array$partipantsarray of user ids
booleanif true, the result will be prepared for csv output (see processCSVRow)
Returns
array of fields, see code for column titles

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

References ilObject\$lng, $results, $row, _instanciateQuestion(), and getAnonymity().

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

+ Here is the call graph for this function:

ilObjTest::getECTSFX ( )

Returns the ECTS FX grade.

Returns
mixed The ECTS FX grade, NULL if empty public
See Also
$ects_fx

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

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

{
return (strlen($this->ects_fx)) ? $this->ects_fx : NULL;
}

+ Here is the caller graph for this function:

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

Returns the ECTS grade for a number of reached points.

Parameters
array$passed_arrayAn array with the points of all users who passed the test
double$reached_pointsThe points reached in the test
double$max_pointsThe maximum number of points for the test
Returns
string The ECTS grade short description public

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

References _getECTSGrade().

Referenced by getAllTestResults(), and getUnfilteredEvaluationData().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::getECTSGrades ( )

Returns the ECTS grades.

Returns
array The ECTS grades public
See Also
$ects_grades

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

References $ects_grades.

Referenced by addDefaults(), and cloneObject().

{
return $this->ects_grades;
}

+ Here is the caller graph for this function:

ilObjTest::getECTSOutput ( )

Indicates if ECTS grades output is presented in this test.

Returns
integer 0 if there is no ECTS grades output, 1 otherwise public
See Also
$ects_output

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getEnableProcessingTime ( )

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

Returns
integer The processing time state (0 for disabled, 1 for enabled) public
See Also
$processing_time

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

Referenced by addDefaults(), cloneObject(), isExecutable(), isMaxProcessingTimeReached(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getEndingTime ( )

Returns the ending time of the test.

Returns
string The ending time of the test public
See Also
$ending_time

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

Referenced by addDefaults(), cloneObject(), endingTimeReached(), getSecondsUntilEndingTime(), isExecutable(), and saveToDb().

{
return (strlen($this->ending_time)) ? $this->ending_time : NULL;
}

+ Here is the caller graph for this function:

ilObjTest::getEstimatedWorkingTime ( )

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

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

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

References _instanciateQuestion().

Referenced by getProcessingTimeAsArray().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getEvaluationAdditionalFields ( )

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

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

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

{
include_once "./Modules/Test/classes/class.ilObjTestGUI.php";
include_once "./Modules/Test/classes/tables/class.ilEvaluationAllTableGUI.php";
$table_gui = new ilEvaluationAllTableGUI(new ilObjTestGUI(), 'outEvaluation');
return $table_gui->getSelectedColumns();
}
ilObjTest::getExamPdf ( )

Gets the "save exam pdf" setting.

Returns
integer "save exam pdf" setting public
See Also
$_exam_pdf

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

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

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

+ Here is the caller graph for this function:

& ilObjTest::getExistingQuestions (   $pass = NULL)

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

Returns
array An array containing the already existing questions public

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

References $data, $ilDB, $pass, getActiveIdOfUser(), getTestId(), and isRandomTest().

Referenced by getAvailableQuestions().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getExportDirectory ( )

Get the location of the export directory for the test.

public

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

References ilUtil\getDataDir().

{
include_once "./Services/Utilities/classes/class.ilUtil.php";
$export_dir = ilUtil::getDataDir()."/tst_data"."/tst_".$this->getId()."/export";
return $export_dir;
}

+ Here is the call graph for this function:

ilObjTest::getExportFiles (   $dir)

Get a list of the already exported files in the export directory.

Returns
array A list of file names public

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

References $dir, and $file.

{
// quit if import dir not available
if (!@is_dir($dir) or
!is_writeable($dir))
{
return array();
}
// open directory
$dir = dir($dir);
// initialize array
$file = array();
// get files and save the in the array
while ($entry = $dir->read())
{
if ($entry != "." and
$entry != ".." and
//substr($entry, -4) == ".zip" and
ereg("^[0-9]{10}_{2}[0-9]+_{2}(test(__results)?(__PDF-Export)?__)*[0-9]+\.[a-z]{1,4}\$", $entry))
{
$file[] = $entry;
}
}
// close import directory
$dir->close();
// sort files
sort ($file);
reset ($file);
return $file;
}
ilObjTest::getExportSettings ( )

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

References $exportsettings.

Referenced by addDefaults(), and saveToDb().

{
if ($this->exportsettings)
{
return $this->exportsettings;
}
else
{
return 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::getExportSettingsRespectShuffle ( )

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

Referenced by setExportSettingsRespectShuffle().

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

+ Here is the caller graph for this function:

ilObjTest::getExportSettingsSingleChoiceShort ( )

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

Referenced by setExportSettingsSingleChoiceShort().

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

+ Here is the caller graph for this function:

ilObjTest::getExtraTime (   $active_id)

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

References $ilDB, and $row.

Referenced by getProcessingTimeInSeconds().

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

+ Here is the caller graph for this function:

ilObjTest::getFinalStatement ( )

Gets the final statement.

Returns
mixed The final statement, NULL if empty
See Also
$_finalstatement

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

Referenced by addDefaults(), cloneObject(), fromXML(), getAllRTEContent(), and saveToDb().

{
return (strlen($this->_finalstatement)) ? $this->_finalstatement : NULL;
}

+ Here is the caller graph for this function:

ilObjTest::getFixedParticipants ( )

Returns the fixed participants status.

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

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

Referenced by cloneObject(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getForceJS ( )

Gets whether JavaScript should be forced for tests.

Returns
integer 1 to force JavaScript, 0 otherwise public
See Also
$_forcejs

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

Referenced by addDefaults(), cloneObject(), getJavaScriptOutput(), and saveToDb().

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

+ Here is the caller graph for this function:

& ilObjTest::getGroupData (   $ids)

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

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

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

+ Here is the call graph for this function:

ilObjTest::getImagePath ( )

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

public

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

References ilObject\getId().

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

+ Here is the call graph for this function:

ilObjTest::getImagePathWeb ( )

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

public

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

References ilObject\getId(), ILIAS_ABSOLUTE_PATH, and ilUtil\removeTrailingPathSeparators().

{
include_once "./Services/Utilities/classes/class.ilUtil.php";
$webdir = ilUtil::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/" . $this->getId() . "/images/";
return str_replace(ilUtil::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH), ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH), $webdir);
}

+ Here is the call graph for this function:

ilObjTest::getImportDirectory ( )

Get the import directory location of the test.

Returns
string The location of the import directory or false if the directory doesn't exist public

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

References $import_dir, and ilUtil\getDataDir().

Referenced by fromXML().

{
if(strlen($this->import_dir))
{
return $this->import_dir;
}
include_once "./Services/Utilities/classes/class.ilUtil.php";
$import_dir = ilUtil::getDataDir()."/tst_data/tst_import";
if (@is_dir($import_dir))
{
return $import_dir;
}
else
{
return false;
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getImportMapping ( )

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

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

{
if (!is_array($this->import_mapping))
{
return array();
}
else
{
return $this->import_mapping;
}
}
ilObjTest::getInstantFeedbackSolution ( )

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

Returns
integer The status of the solution instant feedback public
See Also
$instant_verification

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getIntroduction ( )

Gets the introduction text of the ilObjTest object.

Returns
mixed The introduction text of the test, NULL if empty
See Also
$introduction

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

Referenced by addDefaults(), cloneObject(), fromXML(), getAllRTEContent(), and saveToDb().

{
return (strlen($this->introduction)) ? $this->introduction : NULL;
}

+ Here is the caller graph for this function:

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

Returns a list of all invited users in a test.

Returns
array array of invited users public

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

References $ilDB, $row, getAnonymity(), and getTestId().

{
global $ilDB;
$result_array = array();
if ($this->getAnonymity())
{
if (is_numeric($user_id))
{
$result = $ilDB->queryF("SELECT tst_active.active_id, tst_active.tries, usr_id, %s login, %s lastname, %s firstname, tst_invited_user.clientip, " .
"tst_active.submitted test_finished, matriculation FROM usr_data, tst_invited_user " .
"LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
"WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
"ORDER BY $order",
array('text', 'text', 'text', 'integer', 'integer'),
array("", $this->lng->txt("unknown"), "", $this->getTestId(), $user_id)
);
}
else
{
$result = $ilDB->queryF("SELECT tst_active.active_id, usr_id, %s login, %s lastname, %s firstname, tst_invited_user.clientip, " .
"tst_active.submitted test_finished, matriculation FROM usr_data, tst_invited_user " .
"LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi AND tst_active.test_fi = tst_invited_user.test_fi " .
"WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
"ORDER BY $order",
array('text', 'text', 'text', 'integer'),
array("", $this->lng->txt("unknown"), "", $this->getTestId())
);
}
}
else
{
if (is_numeric($user_id))
{
$result = $ilDB->queryF("SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, tst_invited_user.clientip, " .
"tst_active.submitted test_finished, matriculation FROM usr_data, tst_invited_user " .
"LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi " .
"WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id AND usr_data.usr_id=%s " .
"ORDER BY $order",
array('integer', 'integer'),
array($this->getTestId(), $user_id)
);
}
else
{
$result = $ilDB->queryF("SELECT tst_active.active_id, tst_active.tries, usr_id, login, lastname, firstname, tst_invited_user.clientip, " .
"tst_active.submitted test_finished, matriculation FROM usr_data, tst_invited_user " .
"LEFT JOIN tst_active ON tst_active.user_fi = tst_invited_user.user_fi " .
"WHERE tst_invited_user.test_fi = %s and tst_invited_user.user_fi=usr_data.usr_id " .
"ORDER BY $order",
array('integer'),
array($this->getTestId())
);
}
}
$result_array = array();
while ($row = $ilDB->fetchAssoc($result))
{
$result_array[$row['usr_id']]= $row;
}
return $result_array;
}

+ Here is the call graph for this function:

ilObjTest::getJavaScriptOutput ( )

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

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

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

References $_GET, and getForceJS().

{
global $ilUser;
if (strcmp($_GET["tst_javascript"], "0") == 0) return FALSE;
if ($this->getForceJS()) return TRUE;
$assessmentSetting = new ilSetting("assessment");
return ($ilUser->getPref("tst_javascript") === FALSE) ? $assessmentSetting->get("use_javascript") : $ilUser->getPref("tst_javascript");
}

+ Here is the call graph for this function:

ilObjTest::getKiosk ( )

Returns the kiosk mode.

Returns
integer Kiosk mode public
See Also
$_kiosk

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getKioskMode ( )

Returns the kiosk mode.

Returns
boolean Kiosk mode public
See Also
$_kiosk

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

Referenced by setKioskMode().

{
if (($this->_kiosk & 1) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getListOfQuestions ( )

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

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

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

Referenced by setListOfQuestionsDescription(), setListOfQuestionsEnd(), and setListOfQuestionsStart().

{
if (($this->show_summary & 1) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getListOfQuestionsDescription ( )

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

Returns
boolean TRUE if the list of questions is shown with the question descriptions, FALSE otherwise public

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

Referenced by setListOfQuestionsDescription().

{
if (($this->show_summary & 8) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getListOfQuestionsEnd ( )

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

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

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

Referenced by setListOfQuestionsEnd().

{
if (($this->show_summary & 4) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getListOfQuestionsSettings ( )

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

Returns
integer TRUE if the list of questions should be presented, FALSE otherwise public

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getListOfQuestionsStart ( )

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

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

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

Referenced by setListOfQuestionsStart().

{
if (($this->show_summary & 2) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getMailNotification ( )

Get mail notification settings.

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

References $mailnotification.

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

{
return $this->mailnotification;
}

+ Here is the caller graph for this function:

ilObjTest::getMailNotificationType ( )

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

References $mailnottype.

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

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

+ Here is the caller graph for this function:

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

Retrieves the manual feedback for a question in a test.

Parameters
integer$active_idActive ID of the user
integer$question_idQuestion ID
integer$passPass number
Returns
string The feedback text public

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

References $ilDB, $pass, $row, and ilRTE\_replaceMediaObjectImageSrc().

Referenced by assQuestionGUI\getAnswerFeedbackOutput().

{
global $ilDB;
$feedback = "";
$result = $ilDB->queryF("SELECT feedback FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s",
array('integer', 'integer', 'integer'),
array($active_id, $question_id, $pass)
);
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
include_once("./Services/RTE/classes/class.ilRTE.php");
$feedback = ilRTE::_replaceMediaObjectImageSrc($row["feedback"], 1);
}
return $feedback;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getMarkSchema ( )

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

References $mark_schema.

{
return $this->mark_schema;
}
ilObjTest::getMCScoring ( )

Gets the scoring type for multiple choice questions.

Returns
integer The scoring type for multiple choice questions public
See Also
$mc_scoring

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getNrOfResultsForPass (   $active_id,
  $pass 
)

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

private

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

References $ilDB, and $pass.

Referenced by generateRandomQuestions(), and getStartTestLabel().

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

+ Here is the caller graph for this function:

ilObjTest::getNrOfTries ( )

Returns the nr of tries for the test.

Returns
integer The maximum number of tries public
See Also
$nr_of_tries

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

Referenced by addDefaults(), cloneObject(), createRandomSolutions(), hasNrOfTriesRestriction(), isExecutable(), isNrOfTriesReached(), and saveToDb().

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

+ Here is the caller graph for this function:

& ilObjTest::getParticipants ( )

Returns all persons who started the test.

Returns
arrary The active ids, names and logins of the persons who started the test public

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

References $ilDB, $name, $row, getAnonymity(), and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::getParticipantsForTestAndQuestion (   $test_id,
  $question_id 
)

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

public

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

References $ilDB, $row, and $test_id.

{
global $ilDB;
/*$result = $ilDB->queryF("SELECT tst_test_result.active_fi, tst_test_result.question_fi, tst_test_result.pass FROM tst_test_result, tst_active, qpl_questions WHERE tst_active.active_id = tst_test_result.active_fi AND tst_active.test_fi = %s AND tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.original_id = %s",
array('integer', 'integer'),
array($test_id, $question_id)
);*/
$result = $ilDB->queryF("SELECT tst_test_result.active_fi, tst_test_result.question_fi, tst_test_result.pass FROM tst_test_result, tst_active, usr_data WHERE tst_active.active_id = tst_test_result.active_fi AND tst_active.test_fi = %s AND tst_test_result.question_fi = %s AND tst_active.user_fi=usr_data.usr_id ORDER BY usr_data.lastname ASC",
array('integer', 'integer'),
array($test_id, $question_id)
);
$foundusers = array();
while ($row = $ilDB->fetchAssoc($result))
{
if (!array_key_exists($row["active_fi"], $foundusers))
{
$foundusers[$row["active_fi"]] = array();
}
array_push($foundusers[$row["active_fi"]], array("pass" => $row["pass"], "qid" => $row["question_fi"]));
}
return $foundusers;
}
ilObjTest::getPassed (   $active_id)
protected

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

References $ilDB, $row, _getResultPass(), and getTestResult().

Referenced by canShowCertificate().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getPassFinishDate (   $active_id,
  $pass 
)

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

Parameters
integer$user_idThe user id
integer$test_idThe test id
integer$passThe pass of the test
Returns
timestamp The SQL timestamp of the finished pass public

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

References $ilDB, $pass, and $row.

Referenced by isTestFinishedToViewResults().

{
global $ilDB;
if (is_null($pass)) $pass = 0;
$result = $ilDB->queryF("SELECT tst_test_result.tstamp FROM tst_test_result WHERE active_fi = %s AND pass = %s ORDER BY tst_test_result.tstamp DESC",
array('integer', 'integer'),
array($active_id, $pass)
);
if ($result->numRows())
{
$row = $ilDB->fetchAssoc($result);
return $row["tstamp"];
}
else
{
return 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::getPassScoring ( )

Gets the pass scoring type.

Returns
integer The pass scoring type public
See Also
$pass_scoring

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getPassword ( )

Returns the password for test access.

Returns
striong Password for test access public
See Also
$password

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

Referenced by cloneObject(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getProcessingTime ( )

Returns the processing time for the test.

Returns
string The processing time for the test public
See Also
$processing_time

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

Referenced by addDefaults(), cloneObject(), getProcessingTimeInSeconds(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getProcessingTimeAsArray ( )

Returns the processing time for the test.

Returns
string The processing time for the test
See Also
$processing_time

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

References getEstimatedWorkingTime().

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

+ Here is the call graph for this function:

ilObjTest::getProcessingTimeInSeconds (   $active_id = "")

Returns the processing time for the test in seconds.

Returns
integer The processing time for the test in seconds public
See Also
$processing_time

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

References getExtraTime(), and getProcessingTime().

Referenced by isMaxProcessingTimeReached().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getQuestionCount ( )

Returns the number of questions in the test.

Returns
integer The number of questions public

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

References $data, getRandomQuestionCount(), getRandomQuestionpools(), and isRandomTest().

Referenced by applyDefaults(), createRandomSolutions(), createTestSequence(), getQuestionsOfPass(), getQuestionsOfTest(), and getUnfilteredEvaluationData().

{
$num = 0;
if ($this->isRandomTest())
{
if ($this->getRandomQuestionCount())
{
$num = $this->getRandomQuestionCount();
$qpls =& $this->getRandomQuestionpools();
$maxcount = 0;
foreach ($qpls as $data)
{
$maxcount += $data["contains"];
}
if ($num > $maxcount) $num = $maxcount;
}
else
{
$qpls =& $this->getRandomQuestionpools();
foreach ($qpls as $data)
{
$add = ($data["count"] <= $data["contains"]) ? $data["count"] : $data["contains"];
$num += $add;
}
}
}
else
{
$num = count($this->questions);
}
return $num;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getQuestionDataset (   $question_id)

Returns the dataset for a given question id.

Parameters
integer$question_idThe database id of the question
Returns
object Question dataset public
See Also
$questions

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

References $ilDB, and $row.

{
global $ilDB;
$result = $ilDB->queryF("SELECT qpl_questions.*, qpl_qst_type.type_tag FROM qpl_questions, qpl_qst_type WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
array('integer'),
array($question_id)
);
$row = $ilDB->fetchObject($result);
return $row;
}
& ilObjTest::getQuestionOIDsByAID ( )

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

References $ilDB, $query, $row, and isRandomTest().

{
$oids = array();
if (!$this->isRandomTest())
{
global $ilDB;
$query = sprintf("SELECT qpl_questions.question_id, qpl_questions.original_id FROM tst_test_question, qpl_questions WHERE tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id ORDER BY tst_test_question.sequence",
$ilDB->quote($this->getTestId() . "")
);
$result = $ilDB->query($query);
while ($row = $ilDB->fetchAssoc($result))
{
$oids[$row['question_id']] = $row["original_id"];
}
}
return $oids;
}

+ Here is the call graph for this function:

ilObjTest::getQuestions ( )

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

References $questions.

{
return $this->questions;
}
& ilObjTest::getQuestionsOfPass (   $active_id,
  $pass 
)

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

Returns
array An associated array containing the questions public

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

References $ilDB, $pass, $row, getQuestionCount(), and isRandomTest().

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

+ Here is the call graph for this function:

& ilObjTest::getQuestionsOfTest (   $active_id)

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

Returns
array An associated array containing the questions public

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

References $ilDB, $row, getQuestionCount(), and isRandomTest().

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

+ Here is the call graph for this function:

ilObjTest::getQuestiontext (   $question_id)

Returns the question text for a given question.

Parameters
integer$question_idThe question id
Returns
string The question text public

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

References $ilDB, $res, and $row.

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

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$titleThe original title of the question
Returns
string The title for the question title output public

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

References ilObject\$title, and getTitleOutput().

{
if ($this->getTitleOutput() == 2)
{
return $this->lng->txt("ass_question");
}
else
{
return $title;
}
}

+ Here is the call graph for this function:

& ilObjTest::getQuestionTitles ( )

Returns the titles of the test questions in question sequence.

Returns
array The question titles public
See Also
$questions

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

References $ilDB, $row, getTestId(), and isRandomTest().

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

+ Here is the call graph for this function:

& ilObjTest::getQuestionTitlesAndIndexes ( )

Returns the titles of the test questions in question sequence.

Returns
array The question titles public
See Also
$questions

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

References $ilDB, $row, getTestId(), and isRandomTest().

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

+ Here is the call graph for this function:

ilObjTest::getQuestionType (   $question_id)

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

Parameters
integer$question_idThe database id of the question
Returns
string The question type string private

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

References $data, and $ilDB.

Referenced by createQuestionGUI().

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

+ Here is the caller graph for this function:

& ilObjTest::getQuestionTypeTranslations ( )

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

References $ilDB, $ilLog, ilObject\$lng, $row, ilPlugin\getPluginObject(), and IL_COMP_MODULE.

Referenced by getAvailableQuestions().

{
global $ilDB;
global $lng;
global $ilLog;
global $ilPluginAdmin;
$lng->loadLanguageModule("assessment");
$result = $ilDB->query("SELECT * FROM qpl_qst_type");
$types = array();
while ($row = $ilDB->fetchAssoc($result))
{
if ($row["plugin"] == 0)
{
$types[$row['type_tag']] = $lng->txt($row["type_tag"]);
}
else
{
$pl_names = $ilPluginAdmin->getActivePluginsForSlot(IL_COMP_MODULE, "TestQuestionPool", "qst");
foreach ($pl_names as $pl_name)
{
$pl = ilPlugin::getPluginObject(IL_COMP_MODULE, "TestQuestionPool", "qst", $pl_name);
if (strcmp($pl->getQuestionType(), $row["type_tag"]) == 0)
{
$types[$row['type_tag']] = $pl->getQuestionTypeTranslation();
}
}
}
}
ksort($types);
return $types;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getRandomQuestionCount ( )

Gets the number of random questions used for a random test.

Returns
integer The number of random questions public
See Also
$random_question_count

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

Referenced by addDefaults(), cloneObject(), generateRandomQuestions(), getQuestionCount(), isComplete(), saveRandomQuestionCount(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getRandomQuestionDuplicate (   $question_id,
  $active_id 
)

Returns the question id of the duplicate of a question which is already in use in a random test.

Parameters
integer$question_idQuestion ID of the original question
integer$active_idActive ID of the user
Returns
mixed The question ID of the duplicate or FALSE if no duplicate was found public
See Also
$questions

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

References $ilDB, and $row.

Referenced by saveRandomQuestion().

{
global $ilDB;
$result = $ilDB->queryF("SELECT qpl_questions.question_id FROM qpl_questions, tst_test_rnd_qst WHERE qpl_questions.original_id = %s AND tst_test_rnd_qst.question_fi = qpl_questions.question_id AND tst_test_rnd_qst.active_fi = %s",
array('integer', 'integer'),
array($question_id, $active_id)
);
$num = $result->numRows();
if ($num > 0)
{
$row = $ilDB->fetchAssoc($result);
return $row["question_id"];
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

& ilObjTest::getRandomQuestionpoolData ( )

Returns an array containing ilRandomTestData objects containing the random test selection.

public

Returns
array All saved random questionpools
See Also
$questions

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

References $ilDB, $random_questionpool_data, $row, and getTestId().

{
if (is_array($this->random_questionpool_data) && count($this->random_questionpool_data)) return $this->random_questionpool_data;
global $ilDB;
$qpls = array();
$counter = 0;
$result = $ilDB->queryF("SELECT tst_test_random.*, qpl_questionpool.questioncount FROM tst_test_random, qpl_questionpool WHERE tst_test_random.test_fi = %s AND tst_test_random.questionpool_fi = qpl_questionpool.obj_fi ORDER BY sequence, test_random_id",
array("integer"),
array($this->getTestId())
);
include_once "./Modules/Test/classes/class.ilRandomTestData.php";
if ($result->numRows())
{
while ($row = $ilDB->fetchAssoc($result))
{
array_push($qpls, new ilRandomTestData($row['num_of_q'], $row['questionpool_fi']));
}
}
return $qpls;
}

+ Here is the call graph for this function:

& ilObjTest::getRandomQuestionpools ( )

Returns an array containing the random questionpools saved to the database.

public

Returns
array All saved random questionpools
See Also
$questions

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

References $ilDB, $row, and getTestId().

Referenced by generateRandomQuestions(), getQuestionCount(), and isComplete().

{
global $ilDB;
$qpls = array();
$counter = 0;
$result = $ilDB->queryF("SELECT tst_test_random.*, qpl_questionpool.questioncount FROM tst_test_random, qpl_questionpool WHERE tst_test_random.test_fi = %s AND tst_test_random.questionpool_fi = qpl_questionpool.obj_fi ORDER BY sequence, test_random_id",
array("integer"),
array($this->getTestId())
);
if ($result->numRows())
{
while ($row = $ilDB->fetchAssoc($result))
{
$qpls[$counter] = array(
"index" => $counter,
"count" => $row["num_of_q"],
"qpl" => $row["questionpool_fi"],
"contains" => $row["questioncount"]
);
$counter++;
}
}
return $qpls;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getRedirectAfterExam ( )

Gets redirect after exam URL.

Returns
string the redirection url after exam, NULL if empty public
See Also
$_redirect_after_exam

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

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

{
return (strlen($this->_redirect_after_exam)) ? $this->_redirect_after_exam : NULL;
}

+ Here is the caller graph for this function:

ilObjTest::getRedirectOnlyKioskMode ( )

Gets the "redirect only in kiosk mode" setting.

Returns
integer "redirect only in kiosk mode" setting public
See Also
$_redirect_only_kiosk_mode

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getReportingDate ( )

Gets the reporting date of the ilObjTest object.

Returns
string The reporting date of the test of an empty string (=FALSE) if no reporting date is set public
See Also
$reporting_date

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

Referenced by addDefaults(), canEditMarks(), canViewResults(), cloneObject(), and saveToDb().

{
return (strlen($this->reporting_date)) ? $this->reporting_date : NULL;
}

+ Here is the caller graph for this function:

ilObjTest::getResetProcessingTime ( )

Returns whether the processing time should be reset or not.

Returns
integer 0 for no reset, 1 for a reset public
See Also
$reset_processing_time

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

Referenced by addDefaults(), cloneObject(), getStartingTimeOfUser(), isExecutable(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getResultsForActiveId (   $active_id)

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

References $ilDB, $row, and assQuestion\_updateTestResultCache().

Referenced by getTestResult().

{
global $ilDB;
$result = $ilDB->queryF("SELECT * FROM tst_result_cache WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if (!$result->numRows())
{
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
assQuestion::_updateTestResultCache($active_id);
$result = $ilDB->queryF("SELECT * FROM tst_result_cache WHERE active_fi = %s",
array('integer'),
array($active_id)
);
}
$row = $ilDB->fetchAssoc($result);
return $row;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getResultsPresentation ( )

Returns the combined results presentation value.

Returns
integer The combined results presentation value public

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

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

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

+ Here is the caller graph for this function:

& ilObjTest::getRoleData (   $ids)

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

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

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

+ Here is the call graph for this function:

ilObjTest::getRunDates ( )

Returns an array of YYYY-MM-DD date strings for days that have archived runs of this test.

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

References $ilLog, ARCHIVE_HTML_DIR, and getTestId().

Referenced by getRunPackageDates(), and hasRun().

{
global $ilLog;
$metafiles = glob(ARCHIVE_HTML_DIR . "/*.metafile");
$ilLog->write("Metafiles: ".print_r($metafiles,true));
$testid = $this->getTestId();
$dates = array();
foreach ($metafiles as $metafile)
{
if (preg_match('/(\d\d\d\d-\d\d-\d\d)\_' . $testid . '/',$metafile, $matches))
{
$dates[] = $matches[1];
}
}
return $dates;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getRunPackageDates ( )

Like getRunDates(), yet only return dates for runs that have packaged archives in the course folder.

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

References ARCHIVE_PDF_DIR, getRunDates(), and getTestId().

Referenced by hasRunPackage().

{
$dates_in = $this->getRunDates();
$dates_out = array();
$testid = $this->getTestId();
foreach($dates_in as $date)
{
if (file_exists(ARCHIVE_PDF_DIR . "/" . $date . '_' . $testid . '.zip'))
{
$dates_out[] = $date;
}
}
return $dates_out;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getRunPackageFilename (   $date)

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

References ARCHIVE_PDF_DIR, getTestId(), and hasRunPackage().

Referenced by deleteRunPackage().

{
if ($this->hasRunPackage($date))
{
$testid = $this->getTestId();
return ARCHIVE_PDF_DIR . "/" . $date . '_' . $testid . '.zip';
}
else
{
return '';
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getScoreCutting ( )

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

Returns
integer The score cutting type. 0 for question cutting, 1 for test cutting public
See Also
$score_cutting

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

Referenced by cloneObject(), getTestResult(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getScoreReporting ( )

Gets the score reporting of the ilObjTest object.

Returns
integer The score reporting of the test public
See Also
$score_reporting

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

Referenced by addDefaults(), canShowTestResults(), canViewResults(), cloneObject(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getSecondsUntilEndingTime ( )

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

Returns
integer The seconds left until the ending time is reached public
See Also
$ending_time

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

References getEndingTime().

{
if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->getEndingTime(), $matches))
{
$ending = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
$now = time();
return $ending - $now;
}
else
{
return 0;
}
}

+ Here is the call graph for this function:

ilObjTest::getSequenceSettings ( )

Gets the sequence settings of the ilObjTest object.

Returns
integer The sequence settings of the test public
See Also
$sequence_settings

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getSerial ( )

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

References getTestSession().

{
return $this->getTestSession()->getActiveId();
}

+ Here is the call graph for this function:

ilObjTest::getShowCancel ( )

Returns whether the cancel test button is shown or not.

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

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getShowFinalStatement ( )

Returns whether the final statement should be shown or not.

Returns
integer 0 if false, 1 if true public
See Also
$_showfinalstatement

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getShowInfo ( )

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

Returns
integer 1 for the complete information, 0 otherwise public
See Also
$_showinfo

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getShowKioskModeParticipant ( )

Returns the status of the kiosk mode participant.

Returns
boolean Kiosk mode participant public
See Also
$_kiosk

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

Referenced by setShowKioskModeParticipant().

{
if (($this->_kiosk & 4) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowKioskModeTitle ( )

Returns the status of the kiosk mode title.

Returns
boolean Kiosk mode title public
See Also
$_kiosk

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

Referenced by setShowKioskModeTitle().

{
if (($this->_kiosk & 2) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowMarker ( )

Returns whether the marker button is shown or not.

Returns
integer The value for the marker status (0 = don't show, 1 = show) public

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

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

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

+ Here is the caller graph for this function:

ilObjTest::getShowPassDetails ( )

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

Returns
boolean TRUE if the pass details should be shown, FALSE otherwise public

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

Referenced by setShowPassDetails().

{
if (($this->results_presentation & 1) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSerial ( )

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

Referenced by addDefaults(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionAnswersOnly ( )

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

Returns
boolean TRUE if the full solution should be presented in the solution output, FALSE otherwise public

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

Referenced by setShowSolutionAnswersOnly().

{
if (($this->results_presentation & 16) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionAnwersBeforeFinish ( )
Returns
boolean TRUE if the list of answers should be shown prior to finish the test, FALSE otherwise public

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

Referenced by setShowSolutionAnwersBeforeFinish().

{
if (($this->results_presentation & 256) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionDetails ( )

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

Returns
boolean TRUE if the solution details should be presented, FALSE otherwise public

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

Referenced by setShowSolutionDetails().

{
if (($this->results_presentation & 2) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionFeedback ( )

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

Returns
boolean TRUE if the feedback should be presented in the solution, FALSE otherwise public

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

Referenced by packageRun(), and setShowSolutionFeedback().

{
if (($this->results_presentation & 8) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

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

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

Referenced by setShowSolutionListComparison().

{
if (($this->results_presentation & 128) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionPrintview ( )

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

Returns
boolean TRUE if the solution printview should be presented, FALSE otherwise public

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

Referenced by setShowSolutionPrintview().

{
if (($this->results_presentation & 4) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionSignature ( )

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

Returns
boolean TRUE if the signature field should be shown, FALSE otherwise public

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

Referenced by setShowSolutionSignature().

{
if (($this->results_presentation & 32) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShowSolutionSuggested ( )
Returns
boolean TRUE if the suggested solutions should be shown, FALSE otherwise public

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

Referenced by setShowSolutionSuggested().

{
if (($this->results_presentation & 64) > 0)
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::getShuffleQuestions ( )

Returns the status of the shuffle_questions variable.

Returns
integer 0 if the test questions are not shuffled, 1 if the test questions are shuffled public

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

Referenced by addDefaults(), cloneObject(), generateRandomQuestions(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::getStartingTime ( )

Returns the starting time of the test.

Returns
string The starting time of the test public
See Also
$starting_time

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

Referenced by addDefaults(), cloneObject(), isExecutable(), saveToDb(), and startingTimeReached().

{
return (strlen($this->starting_time)) ? $this->starting_time : NULL;
}

+ Here is the caller graph for this function:

ilObjTest::getStartingTimeOfParticipants ( )

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

References $ilDB, and $row.

{
global $ilDB;
$times = array();
$result = $ilDB->query("SELECT tst_times.active_fi, tst_times.started FROM tst_times, tst_active WHERE tst_times.active_fi = tst_active.active_id ORDER BY tst_times.tstamp DESC");
while ($row = $ilDB->fetchAssoc($result))
{
$times[$row['active_fi']] = $row['started'];
}
return $times;
}
ilObjTest::getStartingTimeOfUser (   $active_id)

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

Parameters
integer$active_idThe active id of the user
Returns
mixed The unix timestamp if the user started the test, FALSE otherwise public

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

References $ilDB, $pass, $row, _getPass(), and getResetProcessingTime().

Referenced by canShowTestResults(), and isExecutable().

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getStartTestLabel (   $active_id)

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

Parameters
int$active_idThe active id of the current user
Returns
string The "Start the Test" label public

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

References $res, _getPass(), and getNrOfResultsForPass().

{
//if ($this->getNrOfTries() == 1)
//{
// return $this->lng->txt("tst_start_test");
//}
$active_pass = $this->_getPass($active_id);
$res = $this->getNrOfResultsForPass($active_id, $active_pass);
if ($res == 0)
{
if ($active_pass == 0)
{
return $this->lng->txt("tst_start_test");
}
else
{
return $this->lng->txt("tst_start_new_test_pass");
}
}
else
{
return $this->lng->txt("tst_resume_test");
}
}

+ Here is the call graph for this function:

& ilObjTest::getTestDefaults (   $test_defaults_id)

Returns the test defaults for a given id.

Parameters
integer$test_defaults_idThe database id of a test defaults dataset
Returns
array An array containing the test defaults public

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

References $ilDB, and $row.

Referenced by applyDefaults().

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

+ Here is the caller graph for this function:

ilObjTest::getTestId ( )

Gets the database id of the additional test data.

Returns
integer The database id of the additional test data public
See Also
$test_id

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

References $test_id.

Referenced by addExtraTime(), checkMaximumAllowedUsers(), cloneRandomQuestions(), createRandomSolutions(), createTestSession(), deleteTest(), disinviteUser(), duplicateQuestionpoolForTest(), evalResultsOverview(), evalResultsOverviewOfParticipant(), evalTotalFinished(), evalTotalParticipantsArray(), evalTotalPersons(), evalTotalPersonsArray(), evalTotalStartedAverageTime(), generateRandomPass(), generateRandomQuestions(), getAccessCodeSession(), getActiveIdOfUser(), getCompleteWorkingTime(), getCompleteWorkingTimeOfParticipant(), getCompleteWorkingTimeOfParticipants(), getExistingQuestions(), getInvitedUsers(), getParticipants(), getQuestionTitles(), getQuestionTitlesAndIndexes(), getRandomQuestionpoolData(), getRandomQuestionpools(), getRunDates(), getRunPackageDates(), getRunPackageFilename(), getTestParticipants(), getTestQuestions(), getTimeExtensionsOfParticipants(), getUnfilteredEvaluationData(), getUsedRandomQuestionpools(), getVisitTimeOfParticipant(), hasSingleChoiceQuestions(), insertQuestion(), inviteUser(), isAccessCodeUsed(), isActiveTestSubmitted(), isNewRandomTest(), isSingleChoiceTest(), isSingleChoiceTestWithoutShuffle(), loadFromDb(), obliterateRun(), packageRun(), questionMoveDown(), questionMoveUp(), randomSelectQuestions(), removeAllTestEditings(), removeDuplicatedQuestionpools(), removeNonRandomTestData(), removeRandomTestData(), removeSelectedTestResults(), removeTestResultsForUser(), saveCertificateVisibility(), saveECTSStatus(), saveQuestionsToDb(), saveRandomQuestionCount(), saveRandomQuestionpools(), saveToDb(), setAccessCodeSession(), setActiveTestSubmitted(), setClientIP(), setTestSession(), and unsetAccessCodeSession().

{
return $this->test_id;
}

+ Here is the caller graph for this function:

& ilObjTest::getTestParticipants ( )

Returns a list of all participants in a test.

Returns
array The user id's of the participants public

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

References $data, $ilDB, $row, getAnonymity(), and getTestId().

Referenced by getTestParticipantsForManualScoring().

{
global $ilDB;
if ($this->getAnonymity())
{
$result = $ilDB->queryF("SELECT tst_active.active_id, tst_active.tries, tst_active.user_fi usr_id, %s login, %s lastname, %s firstname, tst_active.submitted test_finished, usr_data.matriculation, usr_data.active ".
"FROM tst_active LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id WHERE tst_active.test_fi = %s ORDER BY usr_data.lastname " . strtoupper($name_sort_order),
array('text', 'text', 'text', 'integer'),
array("", $this->lng->txt("unknown"), "", $this->getTestId())
);
}
else
{
$result = $ilDB->queryF("SELECT tst_active.active_id, tst_active.tries, tst_active.user_fi usr_id, usr_data.login, usr_data.lastname, usr_data.firstname, tst_active.submitted test_finished, usr_data.matriculation, usr_data.active ".
"FROM tst_active LEFT JOIN usr_data ON tst_active.user_fi = usr_data.usr_id WHERE tst_active.test_fi = %s ORDER BY usr_data.lastname " . strtoupper($name_sort_order),
array('integer'),
array($this->getTestId())
);
}
$data = array();
while ($row = $ilDB->fetchAssoc($result))
{
$data[$row['active_id']] = $row;
}
foreach ($data as $index => $participant)
{
if (strlen(trim($participant["firstname"].$participant["lastname"])) == 0)
{
$data[$index]["lastname"] = $this->lng->txt("deleted_user");
}
}
return $data;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getTestParticipantsForManualScoring (   $filter = NULL)

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

References $ilDB, $row, ilObjAssessmentFolder\_getManualScoring(), and getTestParticipants().

{
global $ilDB;
include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
$scoring = ilObjAssessmentFolder::_getManualScoring();
if (count($scoring) == 0) return array();
$participants =& $this->getTestParticipants();
$filtered_participants = array();
foreach ($participants as $active_id => $participant)
{
$result = $ilDB->queryF("SELECT tst_test_result.manual FROM tst_test_result,qpl_questions WHERE tst_test_result.question_fi = qpl_questions.question_id AND " . $ilDB->in('qpl_questions.question_type_fi', $scoring, false, 'integer') . " AND tst_test_result.active_fi = %s",
array("integer"),
array($active_id)
);
$count = $result->numRows();
if ($count > 0)
{
switch ($filter)
{
case 1: // only active users
if ($participant->active) $filtered_participants[$active_id] = $participant;
break;
case 2: // only inactive users
if (!$participant->active) $filtered_participants[$active_id] = $participant;
break;
case 3: // all users
$filtered_participants[$active_id] = $participant;
break;
case 4:
// already scored participants
//$found = 0;
//while ($row = $ilDB->fetchAssoc($result))
//{
// if ($row["manual"]) $found++;
//}
//if ($found == $count)
//{
//$filtered_participants[$active_id] = $participant;
//}
//else
//{
$assessmentSetting = new ilSetting("assessment");
$manscoring_done = $assessmentSetting->get("manscoring_done_" . $active_id);
if ($manscoring_done) $filtered_participants[$active_id] = $participant;
//}
break;
case 5:
// unscored participants
//$found = 0;
//while ($row = $ilDB->fetchAssoc($result))
//{
// if ($row["manual"]) $found++;
//}
//if ($found == 0)
//{
$assessmentSetting = new ilSetting("assessment");
$manscoring_done = $assessmentSetting->get("manscoring_done_" . $active_id);
if (!$manscoring_done) $filtered_participants[$active_id] = $participant;
//}
break;
case 6:
// partially scored participants
$found = 0;
while ($row = $ilDB->fetchAssoc($result))
{
if ($row["manual"]) $found++;
}
if (($found > 0) && ($found < $count)) $filtered_participants[$active_id] = $participant;
break;
default:
$filtered_participants[$active_id] = $participant;
break;
}
}
}
return $filtered_participants;
}

+ Here is the call graph for this function:

& ilObjTest::getTestQuestions ( )

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

References $ilDB, $row, and getTestId().

{
global $ilDB;
$query_result = $ilDB->queryF("SELECT qpl_questions.*, qpl_qst_type.type_tag, tst_test_question.sequence FROM qpl_questions, qpl_qst_type, tst_test_question WHERE qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_question.test_fi = %s AND tst_test_question.question_fi = qpl_questions.question_id ORDER BY tst_test_question.sequence",
array('integer'),
array($this->getTestId())
);
$removableQuestions = array();
while ($row = $ilDB->fetchAssoc($query_result))
{
array_push($removableQuestions, $row);
}
return $removableQuestions;
}

+ Here is the call graph for this function:

& ilObjTest::getTestResult (   $active_id,
  $pass = NULL,
  $ordered_sequence = FALSE 
)

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

Parameters
integer$active_idActive ID of the user
object$passThe test pass
boolean$ordered_sequenceReturn results in ordered sequence if true
Returns
array An array containing the test results for the given user public

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

References $data, $ilDB, $pass, $results, $row, $testSequence, assQuestion\_getSuggestedSolutionOutput(), getResultsForActiveId(), getScoreCutting(), isRandomTest(), and ilUtil\prepareFormOutput().

Referenced by evalStatistical(), getPassed(), getTotalPointsPassedArray(), and hideCorrectAnsweredQuestions().

{
global $ilDB;
$results = $this->getResultsForActiveId($active_id);
if (is_null($pass))
{
$pass = $results['pass'];
}
include_once "./Modules/Test/classes/class.ilTestSequence.php";
$testSequence = new ilTestSequence($active_id, $pass, $this->isRandomTest());
$sequence = array();
if ($ordered_sequence)
{
$sequence = $testSequence->getOrderedSequenceQuestions();
}
else
{
$sequence = $testSequence->getUserSequenceQuestions();
}
$arrResults = array();
$solutionresult = $ilDB->queryF("SELECT tst_test_result.question_fi, tst_test_result.points reached, tst_solutions.solution_id workedthru FROM tst_test_result LEFT JOIN tst_solutions ON tst_solutions.active_fi = tst_test_result.active_fi AND tst_solutions.question_fi = tst_test_result.question_fi WHERE tst_test_result.active_fi = %s AND tst_test_result.pass = %s",
array('integer', 'integer'),
array($active_id, $pass)
);
while ($row = $ilDB->fetchAssoc($solutionresult))
{
$arrResults[$row['question_fi']] = $row;
}
require_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
$result = $ilDB->query("SELECT qpl_questions.*, qpl_qst_type.type_tag, qpl_sol_sug.question_fi has_sug_sol FROM qpl_qst_type, qpl_questions LEFT JOIN qpl_sol_sug ON qpl_sol_sug.question_fi = qpl_questions.question_id WHERE qpl_qst_type.question_type_id = qpl_questions.question_type_fi AND " . $ilDB->in('qpl_questions.question_id', $sequence, false, 'integer'));
$found = array();
$unordered = array();
$key = 1;
$pass_max = 0;
$pass_reached = 0;
while ($row = $ilDB->fetchAssoc($result))
{
$percentvalue = ($row['points']) ? $arrResults[$row['question_id']]['reached'] / $row['points'] : 0;
if ($percentvalue < 0) $percentvalue = 0.0;
$data = array(
"nr" => "$key",
"title" => ilUtil::prepareFormOutput($row['title']),
"max" => round($row['points'], 2),
"reached" => round($arrResults[$row['question_id']]['reached'],2),
"percent" => sprintf("%2.2f ", ($percentvalue) * 100) . "%",
"solution" => ($row['has_sug_sol']) ? assQuestion::_getSuggestedSolutionOutput($row['question_id']) : '',
"type" => $row["type_tag"],
"qid" => $row['question_id'],
"original_id" => $row["original_id"],
"workedthrough" => ($arrResults[$row['question_id']]['workedthru']) ? 1 : 0
);
$pass_max += round($row['points'], 2);
$pass_reached += round($arrResults[$row['question_id']]['reached'], 2);
$unordered[$row['question_id']] = $data;
$key++;
}
$key = 1;
foreach ($sequence as $qid)
{
$unordered[$qid]['nr'] = $key;
array_push($found, $unordered[$qid]);
$key++;
}
$unordered = null;
if ($this->getScoreCutting() == 1)
{
if ($results['reached_points'] < 0)
{
$results['reached_points'] = 0;
}
if ($pass_reached < 0) $pass_reached = 0;
}
$found['pass']['total_max_points'] = $pass_max;
$found['pass']['total_reached_points'] = $pass_reached;
$found['pass']['percent'] = ($pass_max > 0) ? $pass_reached / $pass_max : 0;
$found["test"]["total_max_points"] = $results['max_points'];
$found["test"]["total_reached_points"] = $results['reached_points'];
$found["test"]["result_pass"] = $results['pass'];
if ((!$total_reached_points) or (!$total_max_points))
{
$percentage = 0.0;
}
else
{
$percentage = ($total_reached_points / $total_max_points) * 100.0;
if ($percentage < 0) $percentage = 0.0;
}
$found["test"]["passed"] = $results['passed'];
return $found;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::getTestSequence (   $active_id = "",
  $pass = "" 
)

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

References $pass, $testSequence, getTestSession(), and isRandomTest().

Referenced by hideCorrectAnsweredQuestions().

{
if (is_object($this->testSequence) && ($this->testSequence->getActiveId() > 0)) return $this->testSequence;
include_once "./Modules/Test/classes/class.ilTestSequence.php";
if (($active_id > 0) && (strlen($pass)))
{
$this->testSequence = new ilTestSequence($active_id, $pass, $this->isRandomTest());
}
else
{
$this->testSequence = new ilTestSequence($this->getTestSession()->getActiveId(), $this->getTestSession()->getPass(), $this->isRandomTest());
}
return $this->testSequence;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::getTestSession (   $active_id = "")

Returns the test session data for the active user.

Returns
object The ilTestSession object or FALSE if the creation of the object fails public

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

References $testSession, and setTestSession().

Referenced by canShowTestResults(), getSerial(), getTestSequence(), hideCorrectAnsweredQuestions(), and isExecutable().

{
if (is_object($this->testSession) && ($this->testSession->getActiveId() > 0)) return $this->testSession;
return $this->setTestSession($active_id);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getTestStyleLocation (   $mode = "output")

get full style sheet file name (path inclusive) of current user

Parameters
$modestring Output mode of the style sheet ("output" or "filesystem"). !"filesystem" generates the ILIAS version number as attribute to force the reload of the style sheet in a different ILIAS version public

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

References getCustomStyle(), and ilUtil\getStyleSheetLocation().

Referenced by deliverPDFFromHTML().

{
if (strlen($this->getCustomStyle()))
{
$default = ilUtil::getStyleSheetLocation("filesystem", "ta.css", "Modules/Test");
$custom = str_replace("ta.css", "customstyles/" . $this->getCustomStyle(), $default);
if (file_exists($custom))
{
$custom = ilUtil::getStyleSheetLocation($mode, "ta.css", "Modules/Test");
$custom = str_replace("ta.css", "customstyles/" . $this->getCustomStyle(), $custom);
return $custom;
}
else
{
return ilUtil::getStyleSheetLocation($mode, "ta.css", "Modules/Test");
}
}
else
{
return ilUtil::getStyleSheetLocation($mode, "ta.css", "Modules/Test");
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getTextAnswer (   $active_id,
  $question_id,
  $pass = NULL 
)

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

Parameters
integer$user_idThe user id
integer$question_idThe question id
Returns
string The answer text public

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

References $ilDB, $pass, $res, $row, and assQuestion\_getSolutionMaxPass().

{
global $ilDB;
$res = "";
if (($active_id) && ($question_id))
{
if (is_null($pass))
{
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
$pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
}
$result = $ilDB->queryF("SELECT value1 FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
array('integer', 'integer', 'integer'),
array($active_id, $question_id, $pass)
);
if ($result->numRows() == 1)
{
$row = $ilDB->fetchAssoc($result);
$res = $row["value1"];
}
}
return $res;
}

+ Here is the call graph for this function:

ilObjTest::getTimeExtensionsOfParticipants ( )

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

References $ilDB, $row, and getTestId().

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

+ Here is the call graph for this function:

ilObjTest::getTitleOutput ( )

Returns the value of the title_output status.

Returns
integer 0 for full title, 1 for title without points, 2 for no title public
See Also
$title_output

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

Referenced by addDefaults(), cloneObject(), getQuestionTitle(), and saveToDb().

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

+ Here is the caller graph for this function:

& ilObjTest::getTotalPointsPassedArray ( )

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

Returns
array The total point values public

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

References $total, evalTotalParticipantsArray(), and getTestResult().

Referenced by getAllTestResults(), and getUnfilteredEvaluationData().

{
$totalpoints_array = array();
$all_users =& $this->evalTotalParticipantsArray();
foreach ($all_users as $active_id => $user_name)
{
$test_result =& $this->getTestResult($active_id);
$reached = $test_result["test"]["total_reached_points"];
$total = $test_result["test"]["total_max_points"];
$percentage = $total != 0 ? $reached/$total : 0;
$mark = $this->mark_schema->getMatchingMark($percentage*100.0);
if ($mark)
{
if ($mark->getPassed())
{
array_push($totalpoints_array, $test_result["test"]["total_reached_points"]);
}
}
}
return $totalpoints_array;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getUnfilteredEvaluationData ( )

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

References $data, $ilDB, $pass, $row, getECTSGrade(), getQuestionCount(), getTestId(), getTotalPointsPassedArray(), getVisitTimeOfParticipant(), and isRandomTest().

Referenced by getCompleteEvaluationData().

{
global $ilDB;
include_once "./Modules/Test/classes/class.ilTestEvaluationPassData.php";
include_once "./Modules/Test/classes/class.ilTestEvaluationUserData.php";
include_once "./Modules/Test/classes/class.ilTestEvaluationData.php";
$data = new ilTestEvaluationData($this);
$result = $ilDB->queryF("SELECT tst_test_result.*, qpl_questions.original_id, qpl_questions.title questiontitle, " .
"qpl_questions.points maxpoints " .
"FROM tst_test_result, qpl_questions, tst_active " .
"WHERE tst_active.active_id = tst_test_result.active_fi " .
"AND qpl_questions.question_id = tst_test_result.question_fi " .
"AND tst_active.test_fi = %s " .
"ORDER BY tst_active.active_id, tst_test_result.pass, tst_test_result.tstamp",
array('integer'),
array($this->getTestId())
);
$pass = NULL;
$checked = array();
$datasets = 0;
while ($row = $ilDB->fetchAssoc($result))
{
$data->getParticipant($row["active_fi"])->getPass($row["pass"])->addAnsweredQuestion($row["question_fi"], $row["maxpoints"], $row["points"]);
}
foreach (array_keys($data->getParticipants()) as $active_id)
{
if ($this->isRandomTest())
{
for ($testpass = 0; $testpass <= $data->getParticipant($active_id)->getLastPass(); $testpass++)
{
$ilDB->setLimit($this->getQuestionCount(), 0);
$result = $ilDB->queryF("SELECT tst_test_rnd_qst.sequence, tst_test_rnd_qst.question_fi, qpl_questions.original_id, " .
"tst_test_rnd_qst.pass, qpl_questions.points, qpl_questions.title " .
"FROM tst_test_rnd_qst, qpl_questions " .
"WHERE tst_test_rnd_qst.question_fi = qpl_questions.question_id " .
"AND tst_test_rnd_qst.pass = %s " .
"AND tst_test_rnd_qst.active_fi = %s ORDER BY tst_test_rnd_qst.sequence",
array('integer','integer'),
array($testpass, $active_id)
);
if ($result->numRows())
{
while ($row = $ilDB->fetchAssoc($result))
{
$tpass = array_key_exists("pass", $row) ? $row["pass"] : 0;
$data->getParticipant($active_id)->addQuestion($row["original_id"] ? $row["original_id"] : $row["question_fi"], $row["question_fi"], $row["points"], $row["sequence"], $tpass);
$data->addQuestionTitle($row["question_fi"], $row["title"]);
}
}
}
}
else
{
$result = $ilDB->queryF("SELECT tst_test_question.sequence, tst_test_question.question_fi, " .
"qpl_questions.points, qpl_questions.title, qpl_questions.original_id " .
"FROM tst_test_question, tst_active, qpl_questions " .
"WHERE tst_test_question.question_fi = qpl_questions.question_id " .
"AND tst_active.active_id = %s AND tst_active.test_fi = tst_test_question.test_fi ORDER BY tst_test_question.sequence",
array('integer'),
array($active_id)
);
if ($result->numRows())
{
$questionsbysequence = array();
while ($row = $ilDB->fetchAssoc($result))
{
$questionsbysequence[$row["sequence"]] = $row;
}
$seqresult = $ilDB->queryF("SELECT * FROM tst_sequence WHERE active_fi = %s",
array('integer'),
array($active_id)
);
while ($seqrow = $ilDB->fetchAssoc($seqresult))
{
$questionsequence = unserialize($seqrow["sequence"]);
foreach ($questionsequence as $sidx => $seq)
{
$qsid = $questionsbysequence[$seq]["original_id"] ? $questionsbysequence[$seq]["original_id"] : $questionsbysequence[$seq]["question_fi"];
$data->getParticipant($active_id)->addQuestion($qsid, $questionsbysequence[$seq]["question_fi"], $questionsbysequence[$seq]["points"], $sidx + 1, $seqrow["pass"]);
$data->addQuestionTitle($questionsbysequence[$seq]["question_fi"], $questionsbysequence[$seq]["title"]);
}
}
}
}
}
if ($this->ects_output)
{
$passed_array =& $this->getTotalPointsPassedArray();
}
foreach (array_keys($data->getParticipants()) as $active_id)
{
$percentage = $data->getParticipant($active_id)->getReachedPointsInPercent();
$mark = $this->mark_schema->getMatchingMark($percentage);
if (is_object($mark))
{
$data->getParticipant($active_id)->setMark($mark->getShortName());
$data->getParticipant($active_id)->setMarkOfficial($mark->getOfficialName());
$data->getParticipant($active_id)->setPassed($mark->getPassed());
}
if ($this->ects_output)
{
$ects_mark = $this->getECTSGrade($passed_array, $data->getParticipant($active_id)->getReached(), $data->getParticipant($active_id)->getMaxPoints());
$data->getParticipant($active_id)->setECTSMark($ects_mark);
}
$visitingTime =& $this->getVisitTimeOfParticipant($active_id);
$data->getParticipant($active_id)->setFirstVisit($visitingTime["firstvisit"]);
$data->getParticipant($active_id)->setLastVisit($visitingTime["lastvisit"]);
}
return $data;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::getUsedRandomQuestionpools ( )

Creates an array with title and question count of used random questionpools.

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

References $ilDB, $row, getTestId(), and isNewRandomTest().

{
global $ilDB;
if ($this->isNewRandomTest())
{
$result = $ilDB->queryF('SELECT tst_rnd_cpy.*, tst_test_random.num_of_q FROM tst_rnd_cpy, tst_test_random WHERE tst_rnd_cpy.tst_fi = %s AND tst_rnd_cpy.tst_fi = tst_test_random.test_fi AND tst_rnd_cpy.qpl_fi = tst_test_random.questionpool_fi',
array('integer'),
array($this->getTestId())
);
$pools = array();
while ($row = $ilDB->fetchAssoc($result))
{
if (is_array($pools[$row['qpl_fi']]))
{
$pools[$row['qpl_fi']]['count']++;
}
else
{
$pools[$row['qpl_fi']]['count'] = 1;
}
$pools[$row['qpl_fi']]['num_of_q'] = $row['num_of_q'];
}
$result = $ilDB->queryF('SELECT * FROM tst_rnd_qpl_title WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
while ($row = $ilDB->fetchAssoc($result))
{
$pools[$row['qpl_fi']]['title'] = $row['qpl_title'];
}
return $pools;
}
else
{
$result = $ilDB->queryF('SELECT tst_test_random.* FROM tst_test_random WHERE tst_test_random.test_fi = %s ORDER BY sequence, test_random_id',
array('integer'),
array($this->getTestId())
);
$pools = array();
while ($row = $ilDB->fetchAssoc($result))
{
$pools[$row['questionpool_fi']]['count'] = $row['num_of_q'];
$pools[$row['questionpool_fi']]['num_of_q'] = $row['num_of_q'];
}
$result = $ilDB->queryF('SELECT * FROM tst_rnd_qpl_title WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
while ($row = $ilDB->fetchAssoc($result))
{
$pools[$row['qpl_fi']]['title'] = $row['qpl_title'];
}
return $pools;
}
}

+ Here is the call graph for this function:

ilObjTest::getUsePreviousAnswers ( )

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

Returns
integer 1 if the previous answers should be shown, 0 otherwise public
See Also
$use_previous_answers

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

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

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

+ Here is the caller graph for this function:

& ilObjTest::getUserData (   $ids)

Returns a data of all users specified by id list.

Parameters
$usr_idskommaseparated list of ids
Returns
array The user data "usr_id, login, lastname, firstname, clientip" of the users with id as key public

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

References $ilDB, ilObject\$lng, $row, and getAnonymity().

{
global $ilDB;
global $lng;
if (!is_array($ids) || count($ids) ==0) return array();
if ($this->getAnonymity())
{
$result = $ilDB->queryF("SELECT usr_id, %s login, %s lastname, %s firstname, client_ip clientip FROM usr_data WHERE " . $ilDB->in('usr_id', $ids, false, 'integer') . " ORDER BY login",
array('text', 'text', 'text'),
array("", $lng->txt("unknown"), "")
);
}
else
{
$result = $ilDB->query("SELECT usr_id, login, lastname, firstname, client_ip clientip FROM usr_data WHERE " . $ilDB->in('usr_id', $ids, false, 'integer') . " ORDER BY login");
}
$result_array = array();
while ($row = $ilDB->fetchAssoc($result))
{
$result_array[$row["usr_id"]]= $row;
}
return $result_array;
}

+ Here is the call graph for this function:

ilObjTest::getVisitTimeOfParticipant (   $active_id)

Returns the first and last visit of a participant.

Parameters
integer$active_idThe active ID of the participant
Returns
array The first and last visit of a participant public

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

References _getVisitTimeOfParticipant(), and getTestId().

Referenced by getUnfilteredEvaluationData().

{
return ilObjTest::_getVisitTimeOfParticipant($this->getTestId(), $active_id);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

& ilObjTest::getWorkedQuestions (   $active_id,
  $pass = NULL 
)

Gets the id's of all questions a user already worked through.

Returns
array The question id's of the questions already worked through public

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

References $ilDB, $pass, and $row.

{
global $ilUser;
global $ilDB;
if (is_null($pass))
{
$result = $ilDB->queryF("SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
array('integer','integer'),
array($active_id, 0)
);
}
else
{
$result = $ilDB->queryF("SELECT question_fi FROM tst_solutions WHERE active_fi = %s AND pass = %s GROUP BY question_fi",
array('integer','integer'),
array($active_id, $pass)
);
}
$result_array = array();
while ($row = $ilDB->fetchAssoc($result))
{
array_push($result_array, $row["question_fi"]);
}
return $result_array;
}
ilObjTest::getXMLZip ( )

Get zipped xml file for test.

Reimplemented from ilObject.

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

{
include_once("./Modules/Test/classes/class.ilTestExport.php");
$test_exp = new ilTestExport($this, "xml");
return $test_exp->buildExportFile();
}
ilObjTest::hasNrOfTriesRestriction ( )

returns if the numbers of tries have to be checked

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

References getNrOfTries().

Referenced by isExecutable().

{
return $this->getNrOfTries() != 0;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::hasRandomQuestionsForPass (   $active_id,
  $pass 
)

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

private

Parameters
$active_idActive id of the test
$passPass of the test
Returns
boolean TRUE if the test already contains questions, FALSE otherwise

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

References $ilDB, and $pass.

Referenced by generateRandomQuestions().

{
global $ilDB;
$result = $ilDB->queryF("SELECT test_random_question_id FROM tst_test_rnd_qst WHERE active_fi = %s AND pass = %s",
array('integer','integer'),
array($active_id, $pass)
);
return ($result->numRows() > 0) ? true : false;
}

+ Here is the caller graph for this function:

ilObjTest::hasRun (   $date)

Returns TRUE if this test has an archived run for the date designated by YYYY-MM-DD string $date.

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

References getRunDates().

Referenced by obliterateRun(), and packageRun().

{
// TODO: check $date syntax?
$dates = $this->getRunDates();
return in_array($date, $dates, TRUE);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::hasRunPackage (   $date)

Like hasRun(), but only returns TRUE if the run has been packaged; will return FALSE even if packaging is underway yet not completed.

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

References getRunPackageDates().

Referenced by getRunPackageFilename(), obliterateRun(), and packageRun().

{
// TODO: check $date syntax?
$dates = $this->getRunPackageDates();
return in_array($date, $dates, TRUE);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::hasSingleChoiceQuestions ( )

Returns TRUE if the test contains single choice results.

Returns
boolean public

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

References $ilDB, $row, and getTestId().

Referenced by isSingleChoiceTestWithoutShuffle().

{
global $ilDB;
$result = $ilDB->queryF("SELECT DISTINCT(qpl_qst_type.type_tag) foundtypes FROM qpl_questions, tst_test_result, qpl_qst_type, tst_active WHERE tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_result.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
array('integer'),
array($this->getTestId())
);
$hasSC = false;
while ($row = $ilDB->fetchAssoc($result))
{
if (strcmp($row['foundtypes'], 'assSingleChoice') == 0)
{
$hasSC = true;
}
}
return $hasSC;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::hideCorrectAnsweredQuestions ( )

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

References getTestResult(), getTestSequence(), and getTestSession().

{
if ($this->getTestSession()->getActiveId() > 0)
{
$result = $this->getTestResult($this->getTestSession()->getActiveId(), $this->getTestSession()->getPass(), TRUE);
foreach ($result as $sequence => $question)
{
if (is_numeric($sequence))
{
if ($question["reached"] == $question["max"])
{
$this->getTestSequence()->hideQuestion($question["qid"]);
}
}
}
$this->getTestSequence()->saveToDb();
}
}

+ Here is the call graph for this function:

ilObjTest::ilObjTest (   $a_id = 0,
  $a_call_by_reference = true 
)

Constructor public.

Parameters
integerreference_id or object_id
booleantreat the id as reference_id (true) or object_id (false)

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

References ilObject\$lng, COUNT_PARTIAL_SOLUTIONS, ilObject\ilObject(), REPORT_AFTER_TEST, SCORE_CUT_QUESTION, SCORE_LAST_PASS, SCORE_ZERO_POINTS_WHEN_UNANSWERED, setShowPassDetails(), setShowSolutionAnswersOnly(), setShowSolutionDetails(), setShowSolutionSignature(), and TEST_FIXED_SEQUENCE.

Referenced by _isComplete().

{
global $ilUser;
$this->type = "tst";
include_once "./Modules/Test/classes/class.assMarkSchema.php";
$this->mark_schema = new ASS_MarkSchema();
$this->test_id = -1;
$this->author = $ilUser->fullname;
$this->introduction = "";
$this->questions = array();
$this->sequence_settings = TEST_FIXED_SEQUENCE;
$this->score_reporting = REPORT_AFTER_TEST;
$this->instant_verification = 0;
$this->answer_feedback_points = 0;
$this->reporting_date = "";
$this->nr_of_tries = 0;
$this->_kiosk = 0;
$this->use_previous_answers = 1;
$this->title_output = 0;
$this->starting_time = "";
$this->ending_time = "";
$this->processing_time = "00:00:00";
$this->enable_processing_time = "0";
$this->reset_processing_time = 0;
$this->ects_output = 0;
$this->ects_fx = NULL;
$this->random_test = 0;
$this->shuffle_questions = TRUE;
$this->mailnottype = 0;
$this->exportsettings = 0;
$this->show_summary = 8;
$this->random_question_count = "";
$this->count_system = COUNT_PARTIAL_SOLUTIONS;
$this->mc_scoring = SCORE_ZERO_POINTS_WHEN_UNANSWERED;
$this->score_cutting = SCORE_CUT_QUESTION;
$this->pass_scoring = SCORE_LAST_PASS;
$this->answer_feedback = 0;
$this->password = "";
$this->certificate_visibility = 0;
$this->allowedUsers = "";
$this->_showfinalstatement = FALSE;
$this->_finalstatement = "";
$this->_redirect_after_exam = "";
$this->_redirect_only_kiosk_mode = TRUE;
$this->_exam_pdf = TRUE;
$this->_showinfo = TRUE;
$this->_forcejs = FALSE;
$this->_customStyle = "";
$this->allowedUsersTimeGap = "";
$this->anonymity = 0;
$this->show_cancel = 1;
$this->autosave = 0;
$this->show_marker = 0;
$this->show_serial = false;
$this->fixed_participants = 0;
$this->setShowPassDetails(TRUE);
$this->setShowSolutionDetails(TRUE);
$this->setShowSolutionAnswersOnly(FALSE);
$this->setShowSolutionSignature(FALSE);
$this->testSession = FALSE;
$this->testSequence = FALSE;
$this->mailnotification = 0;
global $lng;
$lng->loadLanguageModule("assessment");
$this->mark_schema->createSimpleSchema($lng->txt("failed_short"), $lng->txt("failed_official"), 0, 0, $lng->txt("passed_short"), $lng->txt("passed_official"), 50, 1);
$this->ects_grades = array(
"A" => 90,
"B" => 65,
"C" => 35,
"D" => 10,
"E" => 0
);
$this->ilObject($a_id, $a_call_by_reference);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::initDefaultRoles ( )

init default roles settings

If your module does not require any default roles, delete this method (For an example how this method is used, look at ilObjForum)

public

Returns
array object IDs of created local roles.

Reimplemented from ilObject.

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

{
global $rbacadmin;
return array();
}
ilObjTest::insertQuestion (   $question_id)

Insert a question in the list of questions.

Parameters
integer$question_idThe database id of the inserted question public

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

References $data, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), duplicateQuestionForTest(), getTestId(), loadQuestions(), logAction(), and saveCompleteStatus().

{
global $ilDB;
$duplicate_id = $this->duplicateQuestionForTest($question_id);
// get maximum sequence index in test
$result = $ilDB->queryF("SELECT MAX(sequence) seq FROM tst_test_question WHERE test_fi=%s",
array('integer'),
array($this->getTestId())
);
$sequence = 1;
if ($result->numRows() == 1)
{
$data = $ilDB->fetchObject($result);
$sequence = $data->seq + 1;
}
$next_id = $ilDB->nextId('tst_test_question');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_test_question (test_question_id, test_fi, question_fi, sequence, tstamp) VALUES (%s, %s, %s, %s, %s)",
array('integer', 'integer','integer','integer','integer'),
array($next_id, $this->getTestId(), $duplicate_id, $sequence, time())
);
if ($affectedRows == 1)
{
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_question_added", ilObjAssessmentFolder::_getLogLanguage()) . ": " . $sequence, $duplicate_id);
}
}
// remove test_active entries, because test has changed
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_active WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
$this->loadQuestions();
$this->saveCompleteStatus();
}

+ Here is the call graph for this function:

ilObjTest::inviteGroup (   $group_id)

Invites all users of a group to a test.

Parameters
integer$group_idThe database id of the invited group public

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

References ilObjUser\_lookupClientIP(), and inviteUser().

{
include_once "./Modules/Group/classes/class.ilObjGroup.php";
$group = new ilObjGroup($group_id);
$members = $group->getGroupMemberIds();
include_once './Services/User/classes/class.ilObjUser.php';
foreach ($members as $user_id)
{
$this->inviteUser($user_id, ilObjUser::_lookupClientIP($user_id));
}
}

+ Here is the call graph for this function:

ilObjTest::inviteRole (   $role_id)

Invites all users of a role to a test.

Parameters
integer$group_idThe database id of the invited group public

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

References ilObjUser\_lookupClientIP(), and inviteUser().

{
global $rbacreview;
$members = $rbacreview->assignedUsers($role_id,"usr_id");
include_once './Services/User/classes/class.ilObjUser.php';
foreach ($members as $user_id)
{
$this->inviteUser($user_id, ilObjUser::_lookupClientIP($user_id));
}
}

+ Here is the call graph for this function:

ilObjTest::inviteUser (   $user_id,
  $client_ip = "" 
)

Invites a user to a test.

Parameters
integer$user_idThe database id of the invited user public

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

References $ilDB, and getTestId().

Referenced by inviteGroup(), and inviteRole().

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
array('integer', 'integer'),
array($this->getTestId(), $user_id)
);
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_invited_user (test_fi, user_fi, clientip, tstamp) VALUES (%s, %s, %s, %s)",
array('integer', 'integer', 'text', 'integer'),
array($this->getTestId(), $user_id, (strlen($client_ip)) ? $client_ip : NULL, time())
);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isAccessCodeUsed (   $code)

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

References $ilDB, and getTestId().

Referenced by createNewAccessCode().

{
global $ilDB;
$result = $ilDB->queryF("SELECT anonymous_id FROM tst_active WHERE test_fi = %s AND anonymous_id = %s",
array('integer', 'text'),
array($this->getTestId(), $code)
);
return ($result->numRows() > 0) ? true : false;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isActiveTestSubmitted (   $user_id = null)

returns if the active for user_id has been submitted

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

References $ilDB, and getTestId().

{
global $ilUser;
global $ilDB;
if (!is_numeric($user_id))
$user_id = $ilUser->getId();
$result = $ilDB->queryF("SELECT submitted FROM tst_active WHERE test_fi=%s AND user_fi=%s AND submitted=%s",
array('integer', 'integer', 'integer'),
array($this->getTestId(), $user_id, 1)
);
return $result->numRows() == 1;
}

+ Here is the call graph for this function:

ilObjTest::isComplete ( )

Returns 1 (true), if a test is complete for use.

Returns
integer 1, if the test is complete for use, otherwise 0 public

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

References getRandomQuestionCount(), getRandomQuestionpools(), and isRandomTest().

Referenced by saveCompleteStatus(), and saveToDb().

{
if ((count($this->mark_schema->mark_steps)) and (count($this->questions)))
{
return 1;
}
else
{
if ($this->isRandomTest())
{
$arr = $this->getRandomQuestionpools();
if (count($arr) && ($this->getRandomQuestionCount() > 0))
{
return 1;
}
$count = 0;
foreach ($arr as $array)
{
$count += $array["count"];
}
if ($count)
{
return 1;
}
}
return 0;
}
return 0;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isExecutable (   $user_id,
  $allowPassIncrease = FALSE 
)

Checks if the test is executable by the given user.

Parameters
integer$user_idThe user id
Returns
array Result array public

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

References $starting_time, _getPass(), endingTimeReached(), ilFormat\ftimestamp2datetimeDB(), getActiveIdOfUser(), getEnableProcessingTime(), getEndingTime(), getNrOfTries(), getResetProcessingTime(), getStartingTime(), getStartingTimeOfUser(), getTestSession(), hasNrOfTriesRestriction(), isMaxProcessingTimeReached(), isNrOfTriesReached(), and startingTimeReached().

{
$result = array(
"executable" => true,
"errormessage" => ""
);
if (!$this->startingTimeReached())
{
$result["executable"] = false;
$result["errormessage"] = sprintf($this->lng->txt("detail_starting_time_not_reached"), ilFormat::ftimestamp2datetimeDB($this->getStartingTime()));
return $result;
}
if ($this->endingTimeReached())
{
$result["executable"] = false;
$result["errormessage"] = sprintf($this->lng->txt("detail_ending_time_reached"), ilFormat::ftimestamp2datetimeDB($this->getEndingTime()));
return $result;
}
$active_id = $this->getActiveIdOfUser($user_id);
if ($this->getEnableProcessingTime())
{
if ($active_id > 0)
{
$starting_time = $this->getStartingTimeOfUser($active_id);
if ($starting_time !== FALSE)
{
if ($this->isMaxProcessingTimeReached($starting_time, $active_id))
{
if ($allowPassIncrease && $this->getResetProcessingTime() && (($this->getNrOfTries() == 0) || ($this->getNrOfTries() > ($this->_getPass($active_id)+1))))
{
// a test pass was quitted because the maximum processing time was reached, but the time
// will be resetted for future passes, so if there are more passes allowed, the participant may
// start the test again.
// This code block is only called when $allowPassIncrease is TRUE which only happens when
// the test info page is opened. Otherwise this will lead to unexpected results!
$this->getTestSession()->increasePass();
$this->getTestSession()->setLastSequence(0);
$this->getTestSession()->saveToDb();
}
else
{
$result["executable"] = false;
$result["errormessage"] = $this->lng->txt("detail_max_processing_time_reached");
}
return $result;
}
}
}
}
if ($this->hasNrOfTriesRestriction() && ($active_id > 0) && $this->isNrOfTriesReached($this->getTestSession($active_id)->getPass()))
{
$result["executable"] = false;
$result["errormessage"] = $this->lng->txt("maximum_nr_of_tries_reached");
return $result;
}
if ($this->getTestSession($active_id)->isSubmitted())
{
$result["executable"] = FALSE;
$result["errormessage"] = $this->lng->txt("maximum_nr_of_tries_reached");
return $result;
}
// TODO: max. processing time
return $result;
}

+ Here is the call graph for this function:

ilObjTest::isHTML (   $a_text)

Checks if a given string contains HTML or not.

Parameters
string$a_textText which should be checked
Returns
boolean public

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

{
if (preg_match("/<[^>]*?>/", $a_text))
{
return TRUE;
}
else
{
return FALSE;
}
}
ilObjTest::isMaxProcessingTimeReached (   $starting_time,
  $active_id 
)

Returns whether the maximum processing time for a test is reached or not.

Parameters
long$starting_timeThe unix timestamp of the starting time of the test
Returns
boolean TRUE if the maxium processing time is reached, FALSE if the maximum processing time is not reached or no maximum processing time is given public

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

References $processing_time, $starting_time, getEnableProcessingTime(), and getProcessingTimeInSeconds().

Referenced by canShowTestResults(), and isExecutable().

{
if ($this->getEnableProcessingTime())
{
$processing_time = $this->getProcessingTimeInSeconds($active_id);
$now = mktime();
if ($now > ($starting_time + $processing_time))
{
return TRUE;
}
else
{
return FALSE;
}
}
else
{
return FALSE;
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isNewRandomTest ( )
protected

Checks whether the test is a new random test (using tst_rnd_cpy) or an old one.

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

References $ilDB, and getTestId().

Referenced by getUsedRandomQuestionpools(), and saveRandomQuestion().

{
global $ilDB;
$result = $ilDB->queryF('SELECT copy_id FROM tst_rnd_cpy WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
return $result->numRows() > 0;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isNrOfTriesReached (   $tries)

returns if number of tries are reached

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

References getNrOfTries().

Referenced by isExecutable().

{
return $tries >= (int) $this->getNrOfTries();
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::isPluginActive (   $a_pname)

Checks whether or not a question plugin with a given name is active.

Parameters
string$a_pnameThe plugin name public

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

References IL_COMP_MODULE.

Referenced by getAvailableQuestions().

{
global $ilPluginAdmin;
if ($ilPluginAdmin->isActive(IL_COMP_MODULE, "TestQuestionPool", "qst", $a_pname))
{
return TRUE;
}
else
{
return FALSE;
}
}

+ Here is the caller graph for this function:

ilObjTest::isRandomTest ( )

Gets the status of the $random_test attribute.

Returns
integer The random test status. 0 = normal, 1 = questions are generated with random generator public
See Also
$random_test

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

Referenced by addDefaults(), cloneObject(), createRandomSolutions(), createTestSequence(), deleteTest(), getAllQuestions(), getAnsweredQuestionCount(), getExistingQuestions(), getQuestionCount(), getQuestionOIDsByAID(), getQuestionsOfPass(), getQuestionsOfTest(), getQuestionTitles(), getQuestionTitlesAndIndexes(), getTestResult(), getTestSequence(), getUnfilteredEvaluationData(), isComplete(), loadQuestions(), removeAllTestEditings(), removeSelectedTestResults(), removeTestResultsForUser(), and saveToDb().

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

+ Here is the caller graph for this function:

ilObjTest::isSingleChoiceTest ( )

Returns TRUE if the test contains single choice results only.

Returns
boolean public

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

References $ilDB, $row, and getTestId().

{
global $ilDB;
$result = $ilDB->queryF("SELECT DISTINCT(qpl_qst_type.type_tag) foundtypes FROM qpl_questions, tst_test_result, qpl_qst_type, tst_active WHERE tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_result.active_fi = tst_active.active_id AND tst_active.test_fi = %s",
array('integer'),
array($this->getTestId())
);
if ($result->numRows() == 1)
{
$row = $ilDB->fetchAssoc($result);
if (strcmp($row['foundtypes'], 'assSingleChoice') == 0)
{
return TRUE;
}
else
{
return false;
}
}
return FALSE;
}

+ Here is the call graph for this function:

ilObjTest::isSingleChoiceTestWithoutShuffle ( )

Returns TRUE if the test contains single choice results and no shuffle only.

Returns
boolean public

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

References $ilDB, $row, getTestId(), and hasSingleChoiceQuestions().

{
global $ilDB;
if (!$this->hasSingleChoiceQuestions()) return false;
$result = $ilDB->queryF("SELECT DISTINCT(qpl_qst_sc.shuffle) foundshuffles FROM qpl_questions, qpl_qst_sc, tst_test_result, qpl_qst_type, tst_active WHERE tst_test_result.question_fi = qpl_questions.question_id AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id AND tst_test_result.active_fi = tst_active.active_id AND qpl_questions.question_id = qpl_qst_sc.question_fi AND tst_active.test_fi = %s AND qpl_qst_type.type_tag = %s",
array('integer', 'text'),
array($this->getTestId(), 'assSingleChoice')
);
if ($result->numRows() == 1)
{
$row = $ilDB->fetchAssoc($result);
return ($row['foundshuffles'] == 0);
}
return FALSE;
}

+ Here is the call graph for this function:

ilObjTest::isTestFinished (   $active_id)

returns if the active for user_id has been submitted

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

References $ilDB.

Referenced by isTestFinishedToViewResults().

{
global $ilDB;
$result = $ilDB->queryF("SELECT submitted FROM tst_active WHERE active_id=%s AND submitted=%s",
array('integer', 'integer'),
array($active_id, 1)
);
return $result->numRows() == 1;
}

+ Here is the caller graph for this function:

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_idThe active id of the user
integer$currentpassThe current test pass of the user
Returns
boolean true if an active user completed a test pass and did not start a new pass, false otherwise public

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

References getPassFinishDate(), and isTestFinished().

Referenced by canShowTestResults().

{
$num = $this->getPassFinishDate($active_id, $currentpass);
return ((($currentpass > 0) && ($num == 0)) || $this->isTestFinished($active_id)) ? true : false;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::loadFromDb ( )

Loads a ilObjTest object from a database.

Parameters
object$dbA pear DB object
integer$test_idA unique key which defines the test in the database public

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

References $data, $ilDB, ilRTE\_replaceMediaObjectImageSrc(), getAuthor(), ilObject\getId(), getTestId(), loadQuestions(), saveAuthorToMetadata(), setAllowedUsers(), setAllowedUsersTimeGap(), setAnonymity(), setAnswerFeedback(), setAnswerFeedbackPoints(), setAuthor(), setAutosave(), setCertificateVisibility(), setCountSystem(), setCustomStyle(), setECTSFX(), setECTSGrades(), setECTSOutput(), setEnableProcessingTime(), setEndingTime(), setExamPdf(), setExportSettings(), setFinalStatement(), setFixedParticipants(), setForceJS(), setInstantFeedbackSolution(), setIntroduction(), setKiosk(), setListOfQuestionsSettings(), setMailNotification(), setMailNotificationType(), setMCScoring(), setNrOfTries(), setPassScoring(), setPassword(), setProcessingTime(), setRandomQuestionCount(), setRandomTest(), setRedirectAfterExam(), setRedirectOnlyKioskMode(), setReportingDate(), setResetProcessingTime(), setResultsPresentation(), setScoreCutting(), setScoreReporting(), setSequenceSettings(), setShowCancel(), setShowFinalStatement(), setShowInfo(), setShowMarker(), setShowSerial(), setShuffleQuestions(), setStartingTime(), setTestId(), setTitleOutput(), and setUsePreviousAnswers().

Referenced by cloneObject(), and read().

{
global $ilDB;
$result = $ilDB->queryF("SELECT * FROM tst_tests WHERE obj_fi = %s",
array('integer'),
array($this->getId())
);
if ($result->numRows() == 1)
{
$data = $ilDB->fetchObject($result);
$this->setTestId($data->test_id);
if (strlen($this->getAuthor()) == 0)
{
$this->saveAuthorToMetadata($data->author);
}
$this->setAuthor($data->author);
include_once("./Services/RTE/classes/class.ilRTE.php");
$this->setIntroduction(ilRTE::_replaceMediaObjectImageSrc($data->introduction, 1));
$this->setFinalStatement(ilRTE::_replaceMediaObjectImageSrc($data->finalstatement, 1));
/* Change Sn */
$this->setRedirectAfterExam($data->redirect_after_exam);
$this->setRedirectOnlyKioskMode($data->redirect_only_kiosk_mode);
$this->setExamPdf($data->exam_pdf);
/* Change Sn End */
$this->setShowInfo($data->showinfo);
$this->setForceJS($data->forcejs);
$this->setCustomStyle($data->customstyle);
$this->setShowFinalStatement($data->showfinalstatement);
$this->setSequenceSettings($data->sequence_settings);
$this->setScoreReporting($data->score_reporting);
$this->setInstantFeedbackSolution($data->instant_verification);
$this->setAnswerFeedbackPoints($data->answer_feedback_points);
$this->setAnswerFeedback($data->answer_feedback);
$this->setAnonymity($data->anonymity);
$this->setShowCancel($data->show_cancel);
$this->setAutosave($data->autosave);
$this->setShowMarker($data->show_marker);
$this->setShowSerial($data->show_serial);
$this->setFixedParticipants($data->fixed_participants);
$this->setNrOfTries($data->nr_of_tries);
$this->setKiosk($data->kiosk);
$this->setUsePreviousAnswers($data->use_previous_answers);
$this->setTitleOutput($data->title_output);
$this->setProcessingTime($data->processing_time);
$this->setEnableProcessingTime($data->enable_processing_time);
$this->setResetProcessingTime($data->reset_processing_time);
$this->setReportingDate($data->reporting_date);
$this->setShuffleQuestions($data->shuffle_questions);
$this->setResultsPresentation($data->results_presentation);
$this->setListOfQuestionsSettings($data->show_summary);
$this->setStartingTime($data->starting_time);
$this->setEndingTime($data->ending_time);
$this->setECTSOutput($data->ects_output);
$this->setECTSGrades(
array(
"A" => $data->ects_a,
"B" => $data->ects_b,
"C" => $data->ects_c,
"D" => $data->ects_d,
"E" => $data->ects_e
)
);
$this->setECTSFX($data->ects_fx);
$this->setRandomTest($data->random_test);
$this->setRandomQuestionCount($data->random_question_count);
$this->mark_schema->flush();
$this->mark_schema->loadFromDb($this->getTestId());
$this->setCountSystem($data->count_system);
$this->setMCScoring($data->mc_scoring);
$this->setMailNotification($data->mailnotification);
$this->setMailNotificationType($data->mailnottype);
$this->setExportSettings($data->exportsettings);
$this->setScoreCutting($data->score_cutting);
$this->setPassword($data->password);
$this->setAllowedUsers($data->allowedusers);
$this->setAllowedUsersTimeGap($data->alloweduserstimegap);
$this->setPassScoring($data->pass_scoring);
$this->setCertificateVisibility($data->certificate_visibility);
$this->loadQuestions();
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::loadQuestions (   $active_id = "",
  $pass = NULL 
)

Load the test question id's from the database.

Parameters
integer$user_idThe user id of the test user (necessary for random tests) public

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

References $data, $ilDB, $pass, _getPass(), getActiveIdOfUser(), and isRandomTest().

Referenced by getAllQuestions(), getAnsweredQuestionCount(), insertQuestion(), loadFromDb(), questionMoveDown(), questionMoveUp(), and removeQuestion().

{
global $ilUser;
global $ilDB;
$this->questions = array();
if (strcmp($active_id, "") == 0)
{
$active_id = $this->getActiveIdOfUser($ilUser->getId());
}
if ($this->isRandomTest())
{
if (is_null($pass))
{
$pass = $this->_getPass($active_id);
}
$result = $ilDB->queryF("SELECT tst_test_rnd_qst.* FROM tst_test_rnd_qst, qpl_questions WHERE tst_test_rnd_qst.active_fi = %s AND qpl_questions.question_id = tst_test_rnd_qst.question_fi AND tst_test_rnd_qst.pass = %s ORDER BY sequence",
array('integer', 'integer'),
array($active_id, $pass)
);
// The following is a fix for random tests prior to ILIAS 3.8. If someone started a random test in ILIAS < 3.8, there
// is only one test pass (pass = 0) in tst_test_rnd_qst while with ILIAS 3.8 there are questions for every test pass.
// To prevent problems with tests started in an older version and continued in ILIAS 3.8, the first pass should be taken if
// no questions are present for a newer pass.
if ($result->numRows() == 0)
{
$result = $ilDB->queryF("SELECT tst_test_rnd_qst.* FROM tst_test_rnd_qst, qpl_questions WHERE tst_test_rnd_qst.active_fi = %s AND qpl_questions.question_id = tst_test_rnd_qst.question_fi AND tst_test_rnd_qst.pass = 0 ORDER BY sequence",
array('integer'),
array($active_id)
);
}
}
else
{
$result = $ilDB->queryF("SELECT tst_test_question.* FROM tst_test_question, qpl_questions WHERE tst_test_question.test_fi = %s AND qpl_questions.question_id = tst_test_question.question_fi ORDER BY sequence",
array('integer'),
array($this->test_id)
);
}
$index = 1;
while ($data = $ilDB->fetchAssoc($result))
{
$this->questions[$index++] = $data["question_fi"];
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Logs an action into the Test&Assessment log.

Parameters
string$logtextThe log text
integer$question_idIf given, saves the question id to the database public

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

References ilObjAssessmentFolder\_addLog(), assQuestion\_getOriginalId(), ilObject\getId(), and ilObject\getRefId().

Referenced by addExtraTime(), checkMaximumAllowedUsers(), insertQuestion(), questionMoveDown(), questionMoveUp(), removeAllTestEditings(), removeQuestion(), removeSelectedTestResults(), removeTestResultsForUser(), saveManualFeedback(), saveQuestionsToDb(), saveRandomQuestionCount(), saveRandomQuestionpools(), and saveToDb().

{
global $ilUser;
$original_id = "";
if (strcmp($question_id, "") != 0)
{
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
$original_id = assQuestion::_getOriginalId($question_id);
}
include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
ilObjAssessmentFolder::_addLog($ilUser->getId(), $this->getId(), $logtext, $question_id, $original_id, TRUE, $this->getRefId());
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::modifyExportIdentifier (   $a_tag,
  $a_param,
  $a_value 
)

Returns the installation id for a given identifier.

private

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

References ilUtil\insertInstIntoID().

{
if ($a_tag == "Identifier" && $a_param == "Entry")
{
include_once "./Services/Utilities/classes/class.ilUtil.php";
$a_value = ilUtil::insertInstIntoID($a_value);
}
return $a_value;
}

+ Here is the call graph for this function:

ilObjTest::moveQuestions (   $move_questions,
  $target_index,
  $insert_mode 
)

Move questions to another position.

Parameters
array$move_questionsAn array with the question id's of the questions to move
integer$target_indexThe question id of the target position
integer$insert_mode0, if insert before the target position, 1 if insert after the target position public

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

References saveQuestionsToDb().

{
$this->questions = array_values($this->questions);
$array_pos = array_search($target_index, $this->questions);
if ($insert_mode == 0)
{
$part1 = array_slice($this->questions, 0, $array_pos);
$part2 = array_slice($this->questions, $array_pos);
}
else if ($insert_mode == 1)
{
$part1 = array_slice($this->questions, 0, $array_pos + 1);
$part2 = array_slice($this->questions, $array_pos + 1);
}
foreach ($move_questions as $question_id)
{
if (!(array_search($question_id, $part1) === FALSE))
{
unset($part1[array_search($question_id, $part1)]);
}
if (!(array_search($question_id, $part2) === FALSE))
{
unset($part2[array_search($question_id, $part2)]);
}
}
$part1 = array_values($part1);
$part2 = array_values($part2);
$new_array = array_values(array_merge($part1, $move_questions, $part2));
$this->questions = array();
$counter = 1;
foreach ($new_array as $question_id)
{
$this->questions[$counter] = $question_id;
$counter++;
}
$this->saveQuestionsToDb();
}

+ Here is the call graph for this function:

ilObjTest::notify (   $a_event,
  $a_ref_id,
  $a_parent_non_rbac_id,
  $a_node_id,
  $a_params = 0 
)

notifys an object about an event occured Based on the event happend, each object may decide how it reacts.

If you are not required to handle any events related to your module, just delete this method. (For an example how this method is used, look at ilObjGroup)

public

Parameters
stringevent
integerreference id of object where the event occured
arraypasses optional parameters if required
Returns
boolean

Reimplemented from ilObject.

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

References $_GET, and ilObject\getType().

{
global $tree;
switch ($a_event)
{
case "link":
//var_dump("<pre>",$a_params,"</pre>");
//echo "Module name ".$this->getRefId()." triggered by link event. Objects linked into target object ref_id: ".$a_ref_id;
//exit;
break;
case "cut":
//echo "Module name ".$this->getRefId()." triggered by cut event. Objects are removed from target object ref_id: ".$a_ref_id;
//exit;
break;
case "copy":
//var_dump("<pre>",$a_params,"</pre>");
//echo "Module name ".$this->getRefId()." triggered by copy event. Objects are copied into target object ref_id: ".$a_ref_id;
//exit;
break;
case "paste":
//echo "Module name ".$this->getRefId()." triggered by paste (cut) event. Objects are pasted into target object ref_id: ".$a_ref_id;
//exit;
break;
case "new":
//echo "Module name ".$this->getRefId()." triggered by paste (new) event. Objects are applied to target object ref_id: ".$a_ref_id;
//exit;
break;
}
// At the beginning of the recursive process it avoids second call of the notify function with the same parameter
if ($a_node_id==$_GET["ref_id"])
{
$parent_obj =& $this->ilias->obj_factory->getInstanceByRefId($a_node_id);
$parent_type = $parent_obj->getType();
if ($parent_type == $this->getType())
{
$a_node_id = (int) $tree->getParentId($a_node_id);
}
}
parent::notify($a_event,$a_ref_id,$a_parent_non_rbac_id,$a_node_id,$a_params);
}

+ Here is the call graph for this function:

ilObjTest::obliterateRun (   $date)

Utterly and completely destroys all evidence of an archived run, i.e.

raw files and packaged files

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

References $ilLog, ARCHIVE_HTML_DIR, deleteRunPackage(), getTestId(), hasRun(), and hasRunPackage().

{
global $ilLog;
if (!preg_match("/^\d\d\d\d-\d\d-\d\d$/", $date))
{
$ilLog->write("$date doesn't seem to be a date in YYYY-MM-DD format");
return false;
}
// okay, first check if we have results for this date...
if (!($this->hasRun($date)))
{
$ilLog->write("no run for $date");
return false;
}
if ($this->hasRunPackage($date))
{
$ilLog->write("run for $date has package, deleting it");
$this->deleteRunPackage($date);
}
$testid = $this->getTestId();
$archive_id = $date . "_" . $testid;
$files_to_delete = glob(ARCHIVE_HTML_DIR . "/" . $archive_id . "_*.html");
$files_to_delete[] = ARCHIVE_HTML_DIR . "/" . $archive_id . ".metafile";
if(empty($files_to_delete))
{
$ilLog->write("No HTML archives or metafile found for run");
return false;
}
else
{
foreach ($files_to_delete as $file_to_delete)
{
unlink($file_to_delete);
}
}
return true;
}

+ Here is the call graph for this function:

ilObjTest::packageRun (   $date)

Triggers packaging of archived run for this test designated by YYYY-MM-DD string $date (if run exists).

Returns false if unsuccessful, else true.

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

References $_SESSION, $ilLog, ARCHIVE_HTML_DIR, ARCHIVE_PDF_DIR, createQuestionGUI(), deliverPDFFromHTML(), ilUtil\getHtmlPath(), ilUtil\getImagePath(), getShowSolutionFeedback(), ilUtil\getStyleSheetLocation(), getTestId(), ilObject\getTitle(), hasRun(), hasRunPackage(), and ilUtil\prepareFormOutput().

{
global $ilLog;
if (!preg_match("/^\d\d\d\d-\d\d-\d\d$/", $date))
{
$ilLog->write("$date doesn't seem to be a date in YYYY-MM-DD format");
return false;
}
// okay, first check if we have results for this date...
if (!($this->hasRun($date)))
{
$ilLog->write("no run for $date");
return false;
}
if ($this->hasRunPackage($date))
{
$ilLog->write("run for $date already packaged, returning");
// returning true is okay - run has already been packaged
return true;
}
$testid = $this->getTestId();
$archive_id = $date . "_" . $testid;
$html_files = glob(ARCHIVE_HTML_DIR . "/" . $archive_id . "_*.html");
if(empty($html_files))
{
$ilLog->write("No HTML archives found for run");
return false;
}
// next up: create target directory for PDF versions of HTML run archives
// TODO make paths configurable
$pdfdir = ARCHIVE_PDF_DIR . "/" . $archive_id;
if (file_exists($pdfdir))
{
if (!is_dir($pdfdir))
{
/* quietly clobber (nobody has any business dropping files with
* archive ID names in the output directory)
*/
if(!unlink($pdfdir))
{
$ilLog->write("Could not delete bogus file blocking location for PDF output directory ($pdfdir)");
return false;
}
}
else
{
$ilLog->write("PDF output directory for run already exists");
return false;
}
}
// TODO make mode, user and group configurable?
$oldumask = umask(0);
if (!mkdir($pdfdir, 0755))
{
$ilLog->write("Could not create PDF output directory for run");
return false;
}
umask($oldumask);
// let's get ourselves a PDF generator
$pdfSetting = new ilSetting("pdf");
include_once "./Services/PDF/classes/class.ilHTMLToPDF.php";
$transformer = null;
switch ($pdfSetting->get('html_to_pdf_method'))
{
case 'fop':
include_once "./Services/PDF/classes/class.ilHTMLToPDFTransformerUsingFOP.php";
$transformer = new ilHTMLtoPDFTransformerUsingFOP($pdf_file);
$transformer->xsl = "./Modules/Test/xml/question2fo.xsl";
break;
case 'webkit':
include_once "./Services/PDF/classes/class.ilHTMLToPDFTransformerUsingWebkit.php";
$transformer = new ilHTMLtoPDFTransformerUsingWebkit($pdf_file);
break;
}
if (is_object($transformer))
{
$generator = new ilHTMLtoPDF($transformer);
}
else
{
$ilLog->write("Could not generate PDF transformer");
return false;
}
// create PDF files and key file lines
$keylines = array();
$pdf_filenames = array();
$pdf_filelocalnames = array();
foreach($html_files as $html_filename)
{
$html_file_parts = pathinfo($html_filename);
$pdf_file_basename = $html_file_parts['filename'] . ".pdf";
$pdf_filename = $pdfdir . "/" . $pdf_file_basename;
$pdf_filelocalname = $archive_id . "/" . $pdf_file_basename;
$ilLog->write("Converting HTML file ".$html_filename." into PDF file ".$pdf_filename);
$generator->createPDFFileFromHTMLFile($html_filename, $pdf_filename);
$keylines[] = (hash('sha512', file_get_contents($pdf_filename))." ".$pdf_file_basename);
$pdf_filenames[] = $pdf_filename;
$pdf_filelocalnames[] = $pdf_filelocalname;
}
// write key file
$keyfilename = $pdfdir . "/" . $archive_id . ".key";
$keyfilelocalname = $archive_id . "/" . $archive_id . ".key";
$keyfile = fopen($keyfilename, 'w');
if (!$keyfile)
{
$ilLog->write("Could not write key file");
return false;
}
foreach ($keylines as $line)
{
fwrite($keyfile, $line . "\n");
}
fclose($keyfile);
$metafile_basename = $archive_id . ".metafile";
$metafile_source = ARCHIVE_HTML_DIR . "/" . $metafile_basename;
$metafile_target = $pdfdir . "/" . $metafile_basename;
$metafile_localname = $archive_id . "/" . $metafile_basename;
if (!copy($metafile_source, $metafile_target))
{
$ilLog->write("Could not copy $metafile_source to $metafile_target");
return false;
}
include_once "./Modules/Test/classes/class.ilTestExport.php";
$exporter = new ilTestExport($this, "results");
$excelfile = $exporter->exportToExcel($deliver = FALSE);
$excelfile_target = $pdfdir . "/" . $archive_id . "_results.xls";
$excelfile_localname = $archive_id . "/" . $archive_id . "_results.xls";
if (!rename($excelfile, $excelfile_target))
{
$ilLog->write("Could not move $excelfile to $excelfile_target");
return false;
}
// ****************************************************************************
// BEGIN ugly code to get scoring template
// ****************************************************************************
$this->lng = new ilLanguage($_SESSION['lang']);
$this->lng->loadLanguageModule("assessment");
$scoring_template = $pdfdir . "/" . $archive_id . "_scoring.pdf";
$scoring_template_localname = $archive_id . "/" . $archive_id . "_scoring.pdf";
// the following is lifted straight from ilObjTestGUI::printobject()
// ugly, but I wasn't able to figure out how to create an ilObjTestGUI
// and tell it to print itself from outside an interactive HTTP session
//$this->getQuestionsSubTabs();
$template = new ilTemplate("tpl.il_as_tst_print_test_confirm.html", TRUE, TRUE, "Modules/Test");
// $this->ctrl->setParameter($this, "pdf", "1");
$template->setCurrentBlock("pdf_export");
// $template->setVariable("PDF_URL", $this->ctrl->getLinkTarget($this, "print"));
// $this->ctrl->setParameter($this, "pdf", "");
$template->setVariable("PDF_TEXT", $this->lng->txt("pdf_export"));
$template->setVariable("PDF_IMG_ALT", $this->lng->txt("pdf_export"));
$template->setVariable("PDF_IMG_URL", ilUtil::getHtmlPath(ilUtil::getImagePath("application-pdf.png")));
$template->parseCurrentBlock();
$template->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
$print_date = date("c"); // ISO 8601 timestamp FTW
$max_points= 0;
$counter = 1;
foreach ($this->questions as $question)
{
$template->setCurrentBlock("question");
$question_gui = $this->createQuestionGUI("", $question);
$template->setVariable("COUNTER_QUESTION", $counter.".");
$template->setVariable("QUESTION_ID", $question_gui->object->getId());
$template->setVariable("QUESTION_TITLE", ilUtil::prepareFormOutput($question_gui->object->getTitle()));
if ($question_gui->object->getMaximumPoints() == 1)
{
$template->setVariable("QUESTION_POINTS", $question_gui->object->getMaximumPoints() . " " . $this->lng->txt("point"));
}
else
{
$template->setVariable("QUESTION_POINTS", $question_gui->object->getMaximumPoints() . " " . $this->lng->txt("points"));
}
$result_output = $question_gui->getSolutionOutput("", NULL, FALSE, TRUE, FALSE, $this->getShowSolutionFeedback());
if (strlen($result_output) == 0) $result_output = $question_gui->getPreview(FALSE);
$result_html = str_replace("src=\"../","src=\"" . ILIAS_HTTP_PATH . "/",$result_output);
$template->setVariable("SOLUTION_OUTPUT", $result_html);
$template->parseCurrentBlock("question");
$counter ++;
$max_points += $question_gui->object->getMaximumPoints();
}
// $template->setCurrentBlock("navigation_buttons");
// $template->setVariable("BUTTON_PRINT", $this->lng->txt("print"));
// $template->parseCurrentBlock();
$template->setVariable("TITLE", ilUtil::prepareFormOutput($this->getTitle()));
$template->setVariable("PRINT_TEST", ilUtil::prepareFormOutput($this->lng->txt("tst_print")));
$template->setVariable("TXT_PRINT_DATE", ilUtil::prepareFormOutput($this->lng->txt("date")));
$template->setVariable("VALUE_PRINT_DATE", ilUtil::prepareFormOutput($print_date));
$template->setVariable("TXT_MAXIMUM_POINTS", ilUtil::prepareFormOutput($this->lng->txt("tst_maximum_points")));
$template->setVariable("VALUE_MAXIMUM_POINTS", ilUtil::prepareFormOutput($max_points));
$this->deliverPDFFromHTML($template->get(), $this->getTitle(), $scoring_template);
// ****************************************************************************
// END ugly code to get scoring template
// ****************************************************************************
// now create the archive
$zip = new ZipArchive();
$zipfilebasename = $archive_id . ".zip";
$zipfilename = ARCHIVE_PDF_DIR . "/" . $zipfilebasename;
if (TRUE !== $zip->open($zipfilename, ZIPARCHIVE::CREATE))
{
$ilLog->write("Could not create ZIP file $zipfilename");
return false;
}
for ($i=0; $i<count($pdf_filenames); $i++)
{
$zip->addFile($pdf_filenames[$i], $pdf_filelocalnames[$i]);
}
$zip->addFile($keyfilename, $keyfilelocalname);
$zip->addFile($metafile_target, $metafile_localname);
$zip->addFile($excelfile_target, $excelfile_localname);
$zip->addFile($scoring_template, $scoring_template_localname);
$zip->close();
return true;
}

+ Here is the call graph for this function:

ilObjTest::pcArrayShuffle (   $array)

Shuffles the values of a given array.

Parameters
array$arrayAn array which should be shuffled public

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

{
$keys = array_keys($array);
shuffle($keys);
$result = array();
foreach ($keys as $key)
{
$result[$key] = $array[$key];
}
return $result;
}
ilObjTest::prepareTextareaOutput (   $txt_output,
  $prepare_for_latex_output = FALSE 
)

Prepares a string for a text area output in tests.

Parameters
string$txt_outputString which should be prepared for output public

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

{
include_once "./Services/Utilities/classes/class.ilUtil.php";
return ilUtil::prepareTextareaOutput($txt_output, $prepare_for_latex_output);
}
& ilObjTest::processCSVRow (   $row,
  $quoteAll = FALSE,
  $separator = ";" 
)

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

The "converted" array is returned

Parameters
array$rowThe array containing the values for a CSV row
string$quoteAllIndicates to quote every value (=TRUE) or only values containing quotes and separators (=FALSE, default)
string$separatorThe value separator in the CSV row (used for quoting) (; = default)
Returns
array The converted array ready for CSV use public

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

References $row, and $separator.

Referenced by getAllTestResults().

{
$resultarray = array();
foreach ($row as $rowindex => $entry)
{
$surround = FALSE;
if ($quoteAll)
{
$surround = TRUE;
}
if (strpos($entry, "\"") !== FALSE)
{
$entry = str_replace("\"", "\"\"", $entry);
$surround = TRUE;
}
if (strpos($entry, $separator) !== FALSE)
{
$surround = TRUE;
}
// replace all CR LF with LF (for Excel for Windows compatibility
$entry = str_replace(chr(13).chr(10), chr(10), $entry);
if ($surround)
{
$resultarray[$rowindex] = utf8_decode("\"" . $entry . "\"");
}
else
{
$resultarray[$rowindex] = utf8_decode($entry);
}
}
return $resultarray;
}

+ Here is the caller graph for this function:

ilObjTest::QTIMaterialToString (   $a_material)

Reads an QTI material tag an creates a text string.

Parameters
string$a_materialQTI material tag
Returns
string text or xhtml string public

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

References $_SESSION, and $ilLog.

Referenced by fromXML().

{
$result = "";
for ($i = 0; $i < $a_material->getMaterialCount(); $i++)
{
$material = $a_material->getMaterial($i);
if (strcmp($material["type"], "mattext") == 0)
{
$result .= $material["material"]->getContent();
}
if (strcmp($material["type"], "matimage") == 0)
{
$matimage = $material["material"];
if (preg_match("/(il_([0-9]+)_mob_([0-9]+))/", $matimage->getLabel(), $matches))
{
// import an mediaobject which was inserted using tiny mce
if (!is_array($_SESSION["import_mob_xhtml"])) $_SESSION["import_mob_xhtml"] = array();
array_push($_SESSION["import_mob_xhtml"], array("mob" => $matimage->getLabel(), "uri" => $matimage->getUri()));
}
}
}
global $ilLog;
$ilLog->write(print_r($_SESSION["import_mob_xhtml"], true));
return $result;
}

+ Here is the caller graph for this function:

ilObjTest::questionMoveDown (   $question_id)

Moves a question down in order.

Parameters
integer$question_idThe database id of the question to be moved down public
See Also
$test_id

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

References $data, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getTestId(), loadQuestions(), and logAction().

{
global $ilDB;
// Move a question down in sequence
$result = $ilDB->queryF("SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
array('integer','integer'),
array($this->getTestId(), $question_id)
);
$data = $ilDB->fetchObject($result);
$result = $ilDB->queryF("SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
array('integer','integer'),
array($this->getTestId(), $data->sequence + 1)
);
if ($result->numRows() == 1)
{
// OK, it's not the last question, so move it down
$data_next = $ilDB->fetchObject($result);
// change next dataset
$affectedRows = $ilDB->manipulateF("UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
array('integer','integer'),
array($data->sequence, $data_next->test_question_id)
);
// move actual dataset down
$affectedRows = $ilDB->manipulateF("UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
array('integer','integer'),
array($data->sequence + 1, $data->test_question_id)
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($data->sequence) . " => " . ($data->sequence+1), $question_id);
}
}
$this->loadQuestions();
}

+ Here is the call graph for this function:

ilObjTest::questionMoveUp (   $question_id)

Moves a question up in order.

Parameters
integer$question_idThe database id of the question to be moved up public
See Also
$test_id

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

References $data, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getTestId(), loadQuestions(), and logAction().

{
global $ilDB;
// Move a question up in sequence
$result = $ilDB->queryF("SELECT * FROM tst_test_question WHERE test_fi=%s AND question_fi=%s",
array('integer', 'integer'),
array($this->getTestId(), $question_id)
);
$data = $ilDB->fetchObject($result);
if ($data->sequence > 1)
{
// OK, it's not the top question, so move it up
$result = $ilDB->queryF("SELECT * FROM tst_test_question WHERE test_fi=%s AND sequence=%s",
array('integer','integer'),
array($this->getTestId(), $data->sequence - 1)
);
$data_previous = $ilDB->fetchObject($result);
// change previous dataset
$affectedRows = $ilDB->manipulateF("UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
array('integer','integer'),
array($data->sequence, $data_previous->test_question_id)
);
// move actual dataset up
$affectedRows = $ilDB->manipulateF("UPDATE tst_test_question SET sequence=%s WHERE test_question_id=%s",
array('integer','integer'),
array($data->sequence - 1, $data->test_question_id)
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($data->sequence) . " => " . ($data->sequence-1), $question_id);
}
}
$this->loadQuestions();
}

+ Here is the call graph for this function:

ilObjTest::randomSelectQuestions (   $nr_of_questions,
  $questionpool,
  $use_obj_id = 0,
  $qpls = "",
  $pass = NULL 
)

Returns a random selection of questions.

Parameters
integer$nr_of_questionsNumber of questions to return
integer$questionpoolID of questionpool to choose the questions from (0 = all available questionpools)
boolean$user_obj_idUse the object id instead of the reference id when set to true
array$qplsAn array of questionpool id's if the random questions should only be chose from the contained questionpools
Returns
array A random selection of questions public

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

References $ilDB, $row, ilObjQuestionPool\_getAvailableQuestionpools(), ilObject\_lookupObjId(), ilObject\_lookupOwner(), ilObject\getId(), and getTestId().

Referenced by generateRandomPass().

{
global $rbacsystem;
global $ilDB;
// retrieve object id instead of ref id if necessary
if (($questionpool != 0) && (!$use_obj_id)) $questionpool = ilObject::_lookupObjId($questionpool);
// get original ids of all existing questions in the test
$result = $ilDB->queryF("SELECT qpl_questions.original_id FROM qpl_questions, tst_test_question WHERE qpl_questions.question_id = tst_test_question.question_fi AND qpl_questions.tstamp > 0 AND tst_test_question.test_fi = %s",
array("integer"),
array($this->getTestId())
);
$original_ids = array();
$paramtypes = array();
$paramvalues = array();
while ($row = $ilDB->fetchAssoc($result))
{
array_push($original_ids, $row['original_id']);
}
$available = "";
// get a list of all available questionpools
if (($questionpool == 0) && (!is_array($qpls)))
{
include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
$available_pools = array_keys(ilObjQuestionPool::_getAvailableQuestionpools($use_object_id = TRUE, $equal_points = FALSE, $could_be_offline = FALSE, $showPath = FALSE, $with_questioncount = FALSE, "read", ilObject::_lookupOwner($this->getId())));
if (count($available_pools))
{
$available = " AND " . $ilDB->in('obj_fi', $available_pools, false, 'integer');
}
else
{
return array();
}
}
$constraint_qpls = "";
$result_array = array();
if ($questionpool == 0)
{
if (is_array($qpls))
{
if (count($qpls) > 0)
{
$constraint_qpls = " AND " . $ilDB->in('obj_fi', $qpls, false, 'integer');
}
}
}
$original_clause = "";
if (count($original_ids))
{
$original_clause = " AND " . $ilDB->in('question_id', $original_ids, true, 'integer');
}
if ($questionpool == 0)
{
$result = $ilDB->queryF("SELECT question_id FROM qpl_questions WHERE original_id IS NULL $available $constraint_qpls AND owner > %s AND complete = %s $original_clause",
array('integer', 'text'),
array(0, "1")
);
}
else
{
$result = $ilDB->queryF("SELECT question_id FROM qpl_questions WHERE original_id IS NULL AND obj_fi = %s AND owner > %s AND complete = %s $original_clause",
array('integer','integer', 'text'),
array($questionpool, 0, "1")
);
}
$found_ids = array();
while ($row = $ilDB->fetchAssoc($result))
{
array_push($found_ids, $row['question_id']);
}
$nr_of_questions = ($nr_of_questions > count($found_ids)) ? count($found_ids) : $nr_of_questions;
if ($nr_of_questions == 0) return array();
$rand_keys = array_rand($found_ids, $nr_of_questions);
$result = array();
if (is_array($rand_keys))
{
foreach ($rand_keys as $key)
{
$result[$found_ids[$key]] = $found_ids[$key];
}
}
else
{
$result[$found_ids[$rand_keys]] = $found_ids[$rand_keys];
}
return $result;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::read (   $a_force_db = false)

read object data from db into object

Parameters
booleanpublic

Reimplemented from ilObject.

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

References loadFromDb().

{
parent::read($a_force_db);
$this->loadFromDb();
}

+ Here is the call graph for this function:

ilObjTest::recalculateSolutions ( )

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

References $pass, $questions, assQuestion\_setReachedPoints(), createQuestionGUI(), and getCompleteEvaluationData().

{
$participants = $this->getCompleteEvaluationData(false)->getParticipants();
if (is_array($participants))
{
require_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
foreach ($participants as $active_id => $userdata)
{
if (is_object($userdata) && is_array($userdata->getPasses()))
{
$passes = $userdata->getPasses();
foreach ($passes as $pass => $passdata)
{
if (is_object($passdata))
{
$questions = $passdata->getAnsweredQuestions();
if (is_array($questions))
{
foreach ($questions as $questiondata)
{
$question_gui = $this->createQuestionGUI("", $questiondata['id']);
if (is_object($question_gui))
{
$reached = $question_gui->object->calculateReachedPoints($active_id, $pass);
assQuestion::_setReachedPoints($active_id, $questiondata['id'], $reached, $question_gui->object->getMaximumPoints(), $pass, false, true);
}
}
}
}
}
}
}
}
}

+ Here is the call graph for this function:

ilObjTest::removeAllTestEditings (   $question_id = "")

Removes all references to the question in executed tests in case the question has been changed.

If a question was changed it cannot be guaranteed that the content and the meaning of the question is the same as before. So we have to delete all already started or completed tests using that question. Therefore we have to delete all references to that question in tst_solutions and the tst_active entries which were created for the user and test in the tst_solutions entry.

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

References $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilUtil\delDir(), getTestId(), isRandomTest(), and logAction().

Referenced by deleteTest(), removeNonRandomTestData(), removeQuestion(), and removeRandomTestData().

{
global $ilDB;
// remove the question from tst_solutions
if ($question_id)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE tst_solutions.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s) AND tst_solutions.question_fi = %s",
array('integer','integer'),
array($this->getTestId(), $question_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_qst_solved WHERE tst_qst_solved.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s) AND tst_qst_solved.question_fi = %s",
array('integer','integer'),
array($this->getTestId(), $question_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_result WHERE tst_test_result.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s) AND tst_test_result.question_fi = %s",
array('integer','integer'),
array($this->getTestId(), $question_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_pass_result WHERE tst_pass_result.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
}
else
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE tst_solutions.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_qst_solved WHERE tst_qst_solved.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_result WHERE tst_test_result.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_pass_result WHERE tst_pass_result.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_user_data_removed", ilObjAssessmentFolder::_getLogLanguage()));
}
}
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_sequence WHERE tst_sequence.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
if ($this->isRandomTest())
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_rnd_qst WHERE tst_test_rnd_qst.active_fi IN (SELECT active_id FROM tst_active WHERE test_fi = %s)",
array('integer'),
array($this->getTestId())
);
}
// remove test_active entries, because test has changed
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_active WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
// remove saved user passwords
$affectedRows = $ilDB->manipulateF("DELETE FROM usr_pref WHERE keyword = %s",
array('text'),
array("tst_password_".$this->getTestId())
);
// TODO: this shouldn't be here since it is question stuff and should be modular but there's no other solution yet
// remove file uploads
if (@is_dir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId()))
{
ilUtil::delDir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId());
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::removeDuplicatedQuestionpools ( )
protected

Remove all duplicated questions from a random test.

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

References $ilDB, $row, _instanciateQuestion(), and getTestId().

Referenced by deleteTest(), saveRandomQuestionpools(), and saveToDb().

{
global $ilDB;
$result = $ilDB->queryF('SELECT * FROM tst_rnd_cpy WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
while ($row = $ilDB->fetchAssoc($result))
{
$question =& ilObjTest::_instanciateQuestion($row['qst_fi']);
$question->delete($row['qst_fi']);
}
$affectedRows = $ilDB->manipulateF('DELETE FROM tst_rnd_cpy WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
$affectedRows = $ilDB->manipulateF('DELETE FROM tst_rnd_qpl_title WHERE tst_fi = %s',
array('integer'),
array($this->getTestId())
);
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::removeNonRandomTestData ( )

Removes all test data of a non random test when a test was set to random test.

private

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

References $ilDB, getTestId(), removeAllTestEditings(), and saveCompleteStatus().

{
global $ilDB;
// delete eventually set questions of a previous non-random test
$this->removeAllTestEditings();
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_question WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
$this->questions = array();
$this->saveCompleteStatus();
}

+ Here is the call graph for this function:

ilObjTest::removeQuestion (   $question_id)

Removes a question from the test object.

Parameters
integer$question_idThe database id of the question to be removed public
See Also
$test_id

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

References ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), _instanciateQuestion(), loadQuestions(), logAction(), removeAllTestEditings(), and saveQuestionsToDb().

Referenced by deleteTest().

{
$question =& ilObjTest::_instanciateQuestion($question_id);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_question_removed", ilObjAssessmentFolder::_getLogLanguage()), $question_id);
}
$question->delete($question_id);
$this->removeAllTestEditings($question_id);
$this->loadQuestions();
$this->saveQuestionsToDb();
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::removeRandomQuestionpoolData (   $position)

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

{
if (array_key_exists($position, $this->random_questionpool_data))
{
unset($this->random_questionpool_data[$position]);
}
}
ilObjTest::removeRandomTestData ( )

Removes all test data of a random test when a test was set to non random test.

private

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

References $ilDB, getTestId(), removeAllTestEditings(), and saveCompleteStatus().

{
global $ilDB;
// delete eventually set random question pools of a previous random test
$this->removeAllTestEditings();
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_random WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
$this->questions = array();
$this->saveCompleteStatus();
}

+ Here is the call graph for this function:

ilObjTest::removeSelectedTestResults (   $active_ids)

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

References $ilDB, $usr_id, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), _getUserIdFromActiveId(), ilUtil\delDir(), getTestId(), isRandomTest(), logAction(), and userLookupFullName().

{
global $ilDB;
// remove the question from tst_solutions
foreach ($active_ids as $active_id)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_qst_solved WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_pass_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if ($this->isRandomTest())
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_rnd_qst WHERE active_fi = %s",
array('integer'),
array($active_id)
);
}
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction(sprintf($this->lng->txtlng("assessment", "log_selected_user_data_removed", ilObjAssessmentFolder::_getLogLanguage()), $this->userLookupFullName($this->_getUserIdFromActiveId($active_id))));
}
}
// remove test_active entries of selected users
foreach ($active_ids as $active_id)
{
$usr_id = $this->_getUserIdFromActiveId($active_id);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_active WHERE active_id = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_sequence WHERE active_fi = %s",
array('integer'),
array($active_id)
);
// remove saved user password
if ($usr_id > 0)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM usr_pref WHERE usr_id = %s AND keyword = %s",
array('integer', 'text'),
array($usr_id, "tst_password_".$this->getTestId())
);
}
// TODO: this shouldn't be here since it is question stuff and should be modular but there's no other solution yet
// remove file uploads
if (@is_dir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id"))
{
ilUtil::delDir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id");
}
}
}

+ Here is the call graph for this function:

ilObjTest::removeTestResultsForUser (   $user_id)

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

References $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), _getUserIdFromActiveId(), ilUtil\delDir(), getActiveIdOfUser(), getTestId(), isRandomTest(), logAction(), and userLookupFullName().

{
global $ilDB;
$active_id = $this->getActiveIdOfUser($user_id);
// remove the question from tst_solutions
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_qst_solved WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_pass_result WHERE active_fi = %s",
array('integer'),
array($active_id)
);
if ($this->isRandomTest())
{
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_rnd_qst WHERE active_fi = %s",
array('integer'),
array($active_id)
);
}
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction(sprintf($this->lng->txtlng("assessment", "log_selected_user_data_removed", ilObjAssessmentFolder::_getLogLanguage()), $this->userLookupFullName($this->_getUserIdFromActiveId($active_id))));
}
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_sequence WHERE active_fi = %s",
array('integer'),
array($active_id)
);
// remove test_active entry
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_active WHERE active_id = %s",
array('integer'),
array($active_id)
);
// remove saved user password
if ($user_id > 0)
{
$affectedRows = $ilDB->manipulateF("DELETE FROM usr_pref WHERE usr_id = %s AND keyword = %s",
array('integer', 'text'),
array($user_id, "tst_password_".$this->getTestId())
);
}
// TODO: this shouldn't be here since it is question stuff and should be modular but there's no other solution yet
// remove file uploads
if (@is_dir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id"))
{
ilUtil::delDir(CLIENT_WEB_DIR . "/assessment/tst_" . $this->getTestId() . "/$active_id");
}
}

+ Here is the call graph for this function:

ilObjTest::saveAuthorToMetadata (   $a_author = "")

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

Parameters
string$a_authorA string containing the name of the test author private
See Also
$author

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

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

Referenced by createMetaData(), and loadFromDb().

{
$md =& new ilMD($this->getId(), 0, $this->getType());
$md_life =& $md->getLifecycle();
if (!$md_life)
{
if (strlen($a_author) == 0)
{
global $ilUser;
$a_author = $ilUser->getFullname();
}
$md_life =& $md->addLifecycle();
$md_life->save();
$con =& $md_life->addContribute();
$con->setRole("Author");
$con->save();
$ent =& $con->addEntity();
$ent->setEntity($a_author);
$ent->save();
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::saveCertificateVisibility (   $a_value)

Saves the visibility settings of the certificate.

Parameters
integer$a_valueThe value for the visibility settings (0 = always, 1 = only passed, 2 = never) private

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

References $ilDB, and getTestId().

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("UPDATE tst_tests SET certificate_visibility = %s, tstamp = %s WHERE test_id = %s",
array('text', 'integer', 'integer'),
array($a_value, time(), $this->getTestId())
);
}

+ Here is the call graph for this function:

ilObjTest::saveCompleteStatus ( )

Checks if the test is complete and saves the status in the database.

public

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

References $ilDB, and isComplete().

Referenced by insertQuestion(), removeNonRandomTestData(), and removeRandomTestData().

{
global $ilDB;
$complete = 0;
if ($this->isComplete())
{
$complete = 1;
}
if ($this->test_id > 0)
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_tests SET complete = %s WHERE test_id = %s",
array('text','integer'),
array($complete, $this->test_id)
);
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::saveECTSStatus (   $ects_output = 0,
  $fx_support = "",
  $ects_a = 90,
  $ects_b = 65,
  $ects_c = 35,
  $ects_d = 10,
  $ects_e = 0 
)

Saves the ECTS status (output of ECTS grades in a test) to the database.

public

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

References $ects_output, $ilDB, and getTestId().

{
global $ilDB;
if ($this->test_id > 0)
{
$fx_support = preg_replace("/,/", ".", $fx_support);
if (preg_match("/\d+/", $fx_support))
{
$fx_support = $fx_support;
}
else
{
$fx_support = NULL;
}
$affectedRows = $ilDB->manipulateF("UPDATE tst_tests SET ects_output = %s, ects_a = %s, ects_b = %s, ects_c = %s, ects_d = %s, ects_e = %s, ects_fx = %s WHERE test_id = %s",
array('text','float','float','float','float','float','float','integer'),
array($ects_output, $ects_a, $ects_b, $ects_c, $ects_d, $ects_e, $fx_support, $this->getTestId())
);
$this->ects_output = $ects_output;
$this->ects_fx = $fx_support;
}
}

+ Here is the call graph for this function:

ilObjTest::saveManualFeedback (   $active_id,
  $question_id,
  $pass,
  $feedback 
)

Saves the manual feedback for a question in a test.

Parameters
integer$active_idActive ID of the user
integer$question_idQuestion ID
integer$passPass number
string$feedbackThe feedback text
Returns
boolean TRUE if the operation succeeds, FALSE otherwise public

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

References $ilDB, ilObject\$ilias, ilObject\$lng, $pass, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTestAccess\_getParticipantData(), assQuestion\_getQuestionTitle(), ilRTE\_replaceMediaObjectImageSrc(), PEAR\isError(), and logAction().

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_manual_fb WHERE active_fi = %s AND question_fi = %s AND pass = %s",
array('integer', 'integer', 'integer'),
array($active_id, $question_id, $pass)
);
if (strlen($feedback))
{
$next_id = $ilDB->nextId('tst_manual_fb');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_manual_fb (manual_feedback_id, active_fi, question_fi, pass, feedback, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
array('integer', 'integer', 'integer', 'integer', 'text', 'integer'),
array($next_id, $active_id, $question_id, $pass, ilRTE::_replaceMediaObjectImageSrc($feedback, 0), time())
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
global $lng, $ilUser;
include_once "./Modules/Test/classes/class.ilObjTestAccess.php";
$username = ilObjTestAccess::_getParticipantData($active_id);
include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
$this->logAction(sprintf($lng->txtlng("assessment", "log_manual_feedback", ilObjAssessmentFolder::_getLogLanguage()), $ilUser->getFullname() . " (" . $ilUser->getLogin() . ")", $username, assQuestion::_getQuestionTitle($question_id), $feedback));
}
}
if (PEAR::isError($result))
{
global $ilias;
$ilias->raiseError($result->getMessage());
}
else
{
return TRUE;
}
}

+ Here is the call graph for this function:

ilObjTest::saveQuestionsToDb ( )

Saves the test questions to the database.

public

See Also
$questions

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

References $ilDB, $pos, $row, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getTestId(), and logAction().

Referenced by moveQuestions(), removeQuestion(), and saveToDb().

{
global $ilDB;
$oldquestions = array();
include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$result = $ilDB->queryF("SELECT question_fi FROM tst_test_question WHERE test_fi = %s ORDER BY sequence",
array('integer'),
array($this->getTestId())
);
if ($result->numRows() > 0)
{
while ($row = $ilDB->fetchAssoc($result))
{
array_push($oldquestions, $row["question_fi"]);
}
}
}
// delete existing category relations
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_question WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
// create new category relations
foreach ($this->questions as $key => $value)
{
$next_id = $ilDB->nextId('tst_test_question');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_test_question (test_question_id, test_fi, question_fi, sequence, tstamp) VALUES (%s, %s, %s, %s, %s)",
array('integer','integer', 'integer', 'integer', 'integer'),
array($next_id, $this->getTestId(), $value, $key, time())
);
}
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$result = $ilDB->queryF("SELECT question_fi FROM tst_test_question WHERE test_fi = %s ORDER BY sequence",
array('integer'),
array($this->getTestId())
);
$newquestions = array();
if ($result->numRows() > 0)
{
while ($row = $ilDB->fetchAssoc($result))
{
array_push($newquestions, $row["question_fi"]);
}
}
foreach ($oldquestions as $index => $question_id)
{
if (strcmp($newquestions[$index], $question_id) != 0)
{
$pos = array_search($question_id, $newquestions);
if ($pos === FALSE)
{
$this->logAction($this->lng->txtlng("assessment", "log_question_removed", ilObjAssessmentFolder::_getLogLanguage()), $question_id);
}
else
{
$this->logAction($this->lng->txtlng("assessment", "log_question_position_changed", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($index+1) . " => " . ($pos+1), $question_id);
}
}
}
foreach ($newquestions as $index => $question_id)
{
if (array_search($question_id, $oldquestions) === FALSE)
{
$this->logAction($this->lng->txtlng("assessment", "log_question_added", ilObjAssessmentFolder::_getLogLanguage()) . ": " . ($index+1), $question_id);
}
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::saveRandomQuestion (   $active_id,
  $question_id,
  $pass = NULL,
  $maxcount 
)

Saves a random question to the database.

public

See Also
$questions

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

References $ilDB, $pass, duplicateQuestionForTest(), getRandomQuestionDuplicate(), and isNewRandomTest().

Referenced by generateRandomQuestions().

{
global $ilUser;
global $ilDB;
if (is_null($pass)) $pass = 0;
$result = $ilDB->queryF("SELECT test_random_question_id FROM tst_test_rnd_qst WHERE active_fi = %s AND pass = %s",
array('integer','integer'),
array($active_id, $pass)
);
if ($result->numRows() < $maxcount)
{
$duplicate_id = $question_id;
if (!$this->isNewRandomTest())
{
$duplicate_id = $this->getRandomQuestionDuplicate($question_id, $active_id);
if ($duplicate_id === FALSE)
{
$duplicate_id = $this->duplicateQuestionForTest($question_id);
}
}
$next_id = $ilDB->nextId('tst_test_rnd_qst');
$result = $ilDB->manipulateF("INSERT INTO tst_test_rnd_qst (test_random_question_id, active_fi, question_fi, sequence, pass, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
array('integer','integer','integer','integer','integer','integer'),
array($next_id,$active_id, $duplicate_id, $result->numRows()+1, $pass, time())
);
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::saveRandomQuestionCount (   $total_questions = NULL)

Saves the total amount of a tests random questions to the database.

Parameters
integer$total_questionsThe amount of random questions public

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

References $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getRandomQuestionCount(), getTestId(), logAction(), and setRandomQuestionCount().

{
global $ilDB;
if (strlen($total_questions))
{
$this->setRandomQuestionCount($total_questions);
}
$affectedRows = $ilDB->manipulateF("UPDATE tst_tests SET random_question_count = %s, tstamp = %s WHERE test_id = %s",
array('integer', 'integer', 'integer'),
array($this->getRandomQuestionCount(), time(), $this->getTestId())
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction(sprintf($this->lng->txtlng("assessment", "log_total_amount_of_questions", ilObjAssessmentFolder::_getLogLanguage()), $this->getRandomQuestionCount()));
}
}

+ Here is the call graph for this function:

ilObjTest::saveRandomQuestionpools ( )

Saves the question pools used for a random test.

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

References $data, $ilDB, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), duplicateQuestionpoolForTest(), getTestId(), logAction(), and removeDuplicatedQuestionpools().

{
global $ilDB;
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
// delete existing random questionpools
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_test_random WHERE test_fi = %s",
array('integer'),
array($this->getTestId())
);
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_random_question_pool_deleted", ilObjAssessmentFolder::_getLogLanguage()));
}
// delete existing duplicated questions
$this->removeDuplicatedQuestionpools();
// create new random questionpools
foreach ($this->random_questionpool_data as $idx => $data)
{
if ($data->qpl > 0)
{
// save questionpool information
$next_id = $ilDB->nextId('tst_test_random');
$result = $ilDB->manipulateF("INSERT INTO tst_test_random (test_random_id, test_fi, questionpool_fi, num_of_q, tstamp, sequence) VALUES (%s, %s, %s, %s, %s, %s)",
array('integer','integer', 'integer', 'integer', 'integer', 'integer'),
array($next_id, $this->getTestId(), $data->qpl, $data->count, time(), $idx)
);
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction(sprintf($this->lng->txtlng("assessment", "log_random_question_pool_added", ilObjAssessmentFolder::_getLogLanguage()), $value["title"] . " (" . $value["qpl"] . ")", $value["count"]));
}
// duplicate all questions of the questionpools
$this->duplicateQuestionpoolForTest($data->qpl);
}
}
}

+ Here is the call graph for this function:

ilObjTest::saveToDb (   $properties_only = FALSE)

Saves a ilObjTest object to a database.

Parameters
object$dbA pear DB object public

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

References $ilDB, ilObject\$ilias, $ilLog, $row, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilRTE\_replaceMediaObjectImageSrc(), cleanupMediaobjectUsage(), evalTotalPersons(), getAllowedUsers(), getAllowedUsersTimeGap(), getAnonymity(), getAnswerFeedback(), getAnswerFeedbackPoints(), getAuthor(), getAutosave(), getCertificateVisibility(), getCountSystem(), getCustomStyle(), getECTSFX(), getECTSOutput(), getEnableProcessingTime(), getEndingTime(), getExamPdf(), getExportSettings(), getFinalStatement(), getFixedParticipants(), getForceJS(), ilObject\getId(), getInstantFeedbackSolution(), getIntroduction(), getKiosk(), getListOfQuestionsSettings(), getMailNotification(), getMailNotificationType(), getMCScoring(), getNrOfTries(), getPassScoring(), getPassword(), getProcessingTime(), getRandomQuestionCount(), getRedirectAfterExam(), getRedirectOnlyKioskMode(), getReportingDate(), getResetProcessingTime(), getResultsPresentation(), getScoreCutting(), getScoreReporting(), getSequenceSettings(), getShowCancel(), getShowFinalStatement(), getShowInfo(), getShowMarker(), getShowSerial(), getShuffleQuestions(), getStartingTime(), getTestId(), getTitleOutput(), getUsePreviousAnswers(), isComplete(), PEAR\isError(), isRandomTest(), logAction(), removeDuplicatedQuestionpools(), and saveQuestionsToDb().

Referenced by applyDefaults(), createReference(), and fromXML().

{
global $ilDB, $ilLog;
// cleanup RTE images
$this->cleanupMediaobjectUsage();
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if ($this->test_id == -1)
{
// Create new dataset
$next_id = $ilDB->nextId('tst_tests');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_tests (test_id, obj_fi, author, introduction, " .
"finalstatement, redirect_after_exam, redirect_only_kiosk_mode, exam_pdf, showinfo, forcejs, customstyle, showfinalstatement, sequence_settings, " .
"score_reporting, instant_verification, answer_feedback_points, answer_feedback, anonymity, show_cancel, autosave, show_marker, show_serial, " .
"fixed_participants, nr_of_tries, kiosk, use_previous_answers, title_output, processing_time, enable_processing_time, " .
"reset_processing_time, reporting_date, starting_time, ending_time, complete, ects_output, ects_a, ects_b, ects_c, ects_d, " .
"ects_e, ects_fx, random_test, random_question_count, count_system, mc_scoring, score_cutting, pass_scoring, " .
"shuffle_questions, results_presentation, show_summary, password, allowedusers, mailnottype, exportsettings, " .
"alloweduserstimegap, certificate_visibility, mailnotification, created, tstamp) " .
"VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, " .
"%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)",
array(
'integer', 'integer', 'text', 'text',
'text', 'text', 'integer', 'integer', 'integer', 'integer', 'text', 'integer', 'integer',
'integer', 'text', 'text', 'text', 'text', 'text', 'text','integer','text',
'text', 'integer', 'integer', 'text', 'text', 'text', 'text',
'integer', 'text', 'text', 'text', 'text', 'text', 'float', 'float', 'float', 'float',
'float', 'float', 'text', 'integer', 'text', 'text', 'text', 'text',
'text', 'integer', 'integer', 'text', 'integer', 'integer', 'integer',
'integer', 'text', 'integer', 'integer', 'integer'
),
array(
$next_id,
$this->getId(),
$this->getAuthor(),
ilRTE::_replaceMediaObjectImageSrc($this->getIntroduction(), 0),
ilRTE::_replaceMediaObjectImageSrc($this->getFinalStatement(), 0),
$this->getRedirectAfterExam(),
$this->getRedirectOnlyKioskMode(),
$this->getExamPdf(),
$this->getShowInfo(),
$this->getForceJS(),
$this->getCustomStyle(),
$this->getShowFinalStatement(),
$this->getSequenceSettings(),
$this->getScoreReporting(),
$this->getInstantFeedbackSolution(),
$this->getAnswerFeedbackPoints(),
$this->getAnswerFeedback(),
$this->getAnonymity(),
$this->getShowCancel(),
$this->getAutosave(),
$this->getShowMarker(),
$this->getShowSerial(),
$this->getFixedParticipants(),
$this->getNrOfTries(),
$this->getKiosk(),
$this->getUsePreviousAnswers(),
$this->getTitleOutput(),
$this->getProcessingTime(),
$this->getEnableProcessingTime(),
$this->getResetProcessingTime(),
$this->getReportingDate(),
$this->getStartingTime(),
$this->getEndingTime(),
$this->isComplete(),
$this->getECTSOutput(),
strlen($this->ects_grades["A"]) ? $this->ects_grades["A"] : NULL,
strlen($this->ects_grades["B"]) ? $this->ects_grades["B"] : NULL,
strlen($this->ects_grades["C"]) ? $this->ects_grades["C"] : NULL,
strlen($this->ects_grades["D"]) ? $this->ects_grades["D"] : NULL,
strlen($this->ects_grades["E"]) ? $this->ects_grades["E"] : NULL,
$this->getECTSFX(),
$this->isRandomTest(),
$this->getRandomQuestionCount(),
$this->getCountSystem(),
$this->getMCScoring(),
$this->getScoreCutting(),
$this->getPassScoring(),
$this->getShuffleQuestions(),
$this->getResultsPresentation(),
$this->getListOfQuestionsSettings(),
$this->getPassword(),
$this->getAllowedUsers(),
$this->getMailNotificationType(),
$this->getExportSettings(),
$this->getAllowedUsersTimeGap(),
$this->getCertificateVisibility(),
$this->getMailNotification(),
time(),
time()
)
);
$this->test_id = $next_id;
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_create_new_test", ilObjAssessmentFolder::_getLogLanguage()));
}
}
else
{
// Modify existing dataset
$oldrow = array();
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$result = $ilDB->queryF("SELECT * FROM tst_tests WHERE test_id = %s",
array('integer'),
array($this->test_id)
);
if ($result->numRows() == 1)
{
$oldrow = $ilDB->fetchAssoc($result);
}
}
//echo $this->getRedirectOnlyKioskMode();
//echo $this->getExamPdf();
//echo $this->getRedirectAfterExam();
$affectedRows = $ilDB->manipulateF("UPDATE tst_tests SET author = %s, introduction = %s, " .
"finalstatement = %s, redirect_after_exam = %s, redirect_only_kiosk_mode = %s, exam_pdf = %s, showinfo = %s, forcejs = %s, customstyle = %s, showfinalstatement = %s, sequence_settings = %s, " .
"score_reporting = %s, instant_verification = %s, answer_feedback_points = %s, answer_feedback = %s, anonymity = %s, show_cancel = %s, autosave = %s, show_marker = %s, show_serial = %s, " .
"fixed_participants = %s, nr_of_tries = %s, kiosk = %s, use_previous_answers = %s, title_output = %s, processing_time = %s, enable_processing_time = %s, " .
"reset_processing_time = %s, reporting_date = %s, starting_time = %s, ending_time = %s, complete = %s, ects_output = %s, ects_a = %s, ects_b = %s, ects_c = %s, ects_d = %s, " .
"ects_e = %s, ects_fx = %s, random_test = %s, random_question_count = %s, count_system = %s, mc_scoring = %s, score_cutting = %s, pass_scoring = %s, " .
"shuffle_questions = %s, results_presentation = %s, show_summary = %s, password = %s, allowedusers = %s, mailnottype = %s, exportsettings = %s, " .
"alloweduserstimegap = %s, certificate_visibility = %s, mailnotification = %s, tstamp = %s WHERE test_id = %s",
array(
'text', 'text',
'text', 'text', 'integer', 'integer', 'integer', 'integer', 'text', 'integer', 'integer',
'integer', 'text', 'text', 'text', 'text', 'text', 'text', 'integer','text',
'text', 'integer', 'integer', 'text', 'text', 'text', 'text',
'integer', 'text', 'text', 'text', 'text', 'text', 'float', 'float', 'float', 'float',
'float', 'float', 'text', 'integer', 'text', 'text', 'text', 'text',
'text', 'integer', 'integer', 'text', 'integer','integer', 'integer',
'integer', 'text', 'integer', 'integer', 'integer'
),
array(
$this->getAuthor(),
ilRTE::_replaceMediaObjectImageSrc($this->getIntroduction(), 0),
ilRTE::_replaceMediaObjectImageSrc($this->getFinalStatement(), 0),
$this->getRedirectAfterExam(),
$this->getRedirectOnlyKioskMode(),
$this->getExamPdf(),
$this->getShowInfo(),
$this->getForceJS(),
$this->getCustomStyle(),
$this->getShowFinalStatement(),
$this->getSequenceSettings(),
$this->getScoreReporting(),
$this->getInstantFeedbackSolution(),
$this->getAnswerFeedbackPoints(),
$this->getAnswerFeedback(),
$this->getAnonymity(),
$this->getShowCancel(),
$this->getAutosave(),
$this->getShowMarker(),
$this->getShowSerial(),
$this->getFixedParticipants(),
$this->getNrOfTries(),
$this->getKiosk(),
$this->getUsePreviousAnswers(),
$this->getTitleOutput(),
$this->getProcessingTime(),
$this->getEnableProcessingTime(),
$this->getResetProcessingTime(),
$this->getReportingDate(),
$this->getStartingTime(),
$this->getEndingTime(),
$this->isComplete(),
$this->getECTSOutput(),
strlen($this->ects_grades["A"]) ? $this->ects_grades["A"] : NULL,
strlen($this->ects_grades["B"]) ? $this->ects_grades["B"] : NULL,
strlen($this->ects_grades["C"]) ? $this->ects_grades["C"] : NULL,
strlen($this->ects_grades["D"]) ? $this->ects_grades["D"] : NULL,
strlen($this->ects_grades["E"]) ? $this->ects_grades["E"] : NULL,
$this->getECTSFX(),
$this->isRandomTest(),
$this->getRandomQuestionCount(),
$this->getCountSystem(),
$this->getMCScoring(),
$this->getScoreCutting(),
$this->getPassScoring(),
$this->getShuffleQuestions(),
$this->getResultsPresentation(),
$this->getListOfQuestionsSettings(),
$this->getPassword(),
$this->getAllowedUsers(),
$this->getMailNotificationType(),
$this->getExportSettings(),
$this->getAllowedUsersTimeGap(),
$this->getCertificateVisibility(),
$this->getMailNotification(),
time(),
$this->getTestId()
)
);
include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$logresult = $ilDB->queryF("SELECT * FROM tst_tests WHERE test_id = %s",
array('integer'),
array($this->getTestId())
);
$newrow = array();
if ($logresult->numRows() == 1)
{
$newrow = $ilDB->fetchAssoc($logresult);
}
$changed_fields = array();
foreach ($oldrow as $key => $value)
{
if (strcmp($oldrow[$key], $newrow[$key]) != 0)
{
array_push($changed_fields, "$key: " . $oldrow[$key] . " => " . $newrow[$key]);
}
}
$changes = join($changed_fields, ", ");
if (count($changed_fields) > 0)
{
$this->logAction($this->lng->txtlng("assessment", "log_modified_test", ilObjAssessmentFolder::_getLogLanguage()) . " [".$changes."]");
}
}
if ($this->evalTotalPersons() > 0)
{
// reset the finished status of participants if the nr of test passes did change
if ($this->getNrOfTries() > 0)
{
// set all unfinished tests with nr of passes >= allowed passes finished
$aresult = $ilDB->queryF("SELECT active_id FROM tst_active WHERE test_fi = %s AND tries >= %s AND submitted = %s",
array('integer', 'integer', 'integer'),
array($this->getTestId(), $this->getNrOfTries(), 0)
);
while ($row = $ilDB->fetchAssoc($aresult))
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
array('integer', 'timestamp', 'integer'),
array(1, date('Y-m-d H:i:s'), $row["active_id"])
);
}
// set all finished tests with nr of passes < allowed passes not finished
$aresult = $ilDB->queryF("SELECT active_id FROM tst_active WHERE test_fi = %s AND tries < %s AND submitted = %s",
array('integer', 'integer', 'integer'),
array($this->getTestId(), $this->getNrOfTries()-1, 1)
);
while ($row = $ilDB->fetchAssoc($aresult))
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
array('integer', 'timestamp', 'integer'),
array(0, NULL, $row["active_id"])
);
}
}
else
{
// set all finished tests with nr of passes >= allowed passes not finished
$aresult = $ilDB->queryF("SELECT active_id FROM tst_active WHERE test_fi = %s AND submitted = %s",
array('integer', 'integer'),
array($this->getTestId(), 1)
);
while ($row = $ilDB->fetchAssoc($aresult))
{
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET submitted = %s, submittimestamp = %s WHERE active_id = %s",
array('integer', 'timestamp', 'integer'),
array(0, NULL, $row["active_id"])
);
}
}
}
}
if (!$this->isRandomTest())
{
$this->removeDuplicatedQuestionpools();
}
if (!$properties_only)
{
if (PEAR::isError($result))
{
global $ilias;
$ilias->raiseError($result->getMessage());
}
else
{
if (!$this->isRandomTest())
{
$this->saveQuestionsToDb();
}
$this->mark_schema->saveToDb($this->test_id);
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::sendAdvancedNotification (   $active_id)

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

References $file, _getUserIdFromActiveId(), ilObjUser\_lookupLogin(), ilDatePresentation\formatDate(), ilObject\getOwner(), ilObject\getTitle(), IL_CAL_UNIX, ilDatePresentation\setUseRelativeDates(), and userLookupFullName().

{
include_once "./Services/Mail/classes/class.ilMail.php";
$mail = new ilMail(ANONYMOUS_USER_ID);
$usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
$message = new ilTemplate("tpl.il_as_tst_finish_notification_simple.html", TRUE, TRUE, "Modules/Test");
$message->setVariable('TEXT_TEST_TITLE', $this->lng->txt('title'));
$message->setVariable('VALUE_TEST_TITLE', $this->getTitle());
$message->setVariable('TEXT_USER_NAME', $this->lng->txt('username'));
$message->setVariable('VALUE_USER_NAME', $usr_data);
$message->setVariable('TEXT_FINISH_TIME', $this->lng->txt('tst_finished'));
ilDatePresentation::setUseRelativeDates(false);
$message->setVariable('VALUE_FINISH_TIME', ilDatePresentation::formatDate(new ilDateTime(time(), IL_CAL_UNIX)));
include_once "./Modules/Test/classes/class.ilTestExport.php";
$exportObj = new ilTestExport($this, "results");
$file = $exportObj->exportToExcel($deliver = FALSE, 'active_id', $active_id, $passedonly = FALSE);
include_once "./classes/class.ilFileDataMail.php";
$fd = new ilFileDataMail(ANONYMOUS_USER_ID);
$fd->copyAttachmentFile($file, "result_" . $active_id . ".xls");
$file_names[] = "result_" . $active_id . ".xls";
$result = $mail->sendMail(
ilObjUser::_lookupLogin($this->getOwner()), // to
"", // cc
"", // bcc
sprintf($this->lng->txt('tst_user_finished_test'), $this->getTitle()), // subject
$message->get(), // message
count($file_names) ? $file_names : array(), // attachments
array('normal') // type
);
if(count($file_names))
{
$fd->unlinkFiles($file_names);
unset($fd);
@unlink($file);
}
}

+ Here is the call graph for this function:

ilObjTest::sendSimpleNotification (   $active_id)

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

References $ilLog, $res, _getUserIdFromActiveId(), ilObjUser\_lookupLogin(), ilDatePresentation\formatDate(), ilObject\getOwner(), ilObject\getTitle(), IL_CAL_UNIX, ilDatePresentation\setUseRelativeDates(), and userLookupFullName().

{
include_once "./Services/Mail/classes/class.ilMail.php";
$mail = new ilMail(ANONYMOUS_USER_ID);
$usr_data = $this->userLookupFullName(ilObjTest::_getUserIdFromActiveId($active_id));
$message = new ilTemplate("tpl.il_as_tst_finish_notification_simple.html", TRUE, TRUE, "Modules/Test");
$message->setVariable('TEXT_TEST_TITLE', $this->lng->txt('title'));
$message->setVariable('VALUE_TEST_TITLE', $this->getTitle());
$message->setVariable('TEXT_USER_NAME', $this->lng->txt('username'));
$message->setVariable('VALUE_USER_NAME', $usr_data);
$message->setVariable('TEXT_FINISH_TIME', $this->lng->txt('tst_finished'));
ilDatePresentation::setUseRelativeDates(false);
$message->setVariable('VALUE_FINISH_TIME', ilDatePresentation::formatDate(new ilDateTime(time(), IL_CAL_UNIX)));
$res = $mail->sendMail(
ilObjUser::_lookupLogin($this->getOwner()), // to
"", // cc
"", // bcc
sprintf($this->lng->txt('tst_user_finished_test'), $this->getTitle()), // subject
$message->get(), // message
array(), // attachments
array('normal') // type
);
global $ilLog; $ilLog->write("sending mail: " . $res);
}

+ Here is the call graph for this function:

ilObjTest::setAccessCodeSession (   $access_code)

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

References $_SESSION, ilObject\$id, and getTestId().

{
$id = $this->getTestId();
if (!is_array($_SESSION["tst_access_code"]))
{
$_SESSION["tst_access_code"] = array();
}
$_SESSION["tst_access_code"]["$id"] = $access_code;
}

+ Here is the call graph for this function:

ilObjTest::setActiveTestSubmitted (   $user_id)

submits active test for user user_id

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

References $ilDB, $ilLog, and getTestId().

Referenced by createRandomSolutions().

{
global $ilDB, $ilLog;
$affectedRows = $ilDB->manipulateF("UPDATE tst_active SET submitted = %s, submittimestamp = %s, tstamp = %s WHERE test_fi = %s AND user_fi = %s",
array('integer', 'timestamp', 'integer', 'integer', 'integer'),
array(1, date('Y-m-d H:i:s'), time(), $this->getTestId(), $user_id)
);
$this->testSession = NULL;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setAllowedUsers (   $a_allowed_users)

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

Referenced by fromXML(), and loadFromDb().

{
$this->allowedUsers = $a_allowed_users;
}

+ Here is the caller graph for this function:

ilObjTest::setAllowedUsersTimeGap (   $a_allowed_users_time_gap)

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

Referenced by fromXML(), and loadFromDb().

{
$this->allowedUsersTimeGap = $a_allowed_users_time_gap;
}

+ Here is the caller graph for this function:

ilObjTest::setAnonymity (   $a_value = 0)

Sets the anonymity status of the test.

Parameters
integer$a_valueThe value for the anonymity status (0 = personalized, 1 = anonymized) public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->anonymity = 1;
break;
default:
$this->anonymity = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setAnswerFeedback (   $answer_feedback = 0)

Sets the answer specific feedback for the test.

Parameters
integer$answer_feedbackIf 1, answer specific feedback will be shown after answering a question public
See Also
$answer_feedback

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

References $answer_feedback.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($answer_feedback)
{
case 1:
$this->answer_feedback = 1;
break;
default:
$this->answer_feedback = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setAnswerFeedbackPoints (   $answer_feedback_points = 0)

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

Parameters
integer$answer_feedback_pointsIf 1, answer specific feedback will show the reached points after answering a question public
See Also
$answer_feedback_points

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

References $answer_feedback_points.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($answer_feedback_points)
{
case 1:
$this->answer_feedback_points = 1;
break;
default:
$this->answer_feedback_points = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setAuthor (   $author = "")

Sets the authors name of the ilObjTest object.

Parameters
string$authorA string containing the name of the test author public
See Also
$author

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

References $author.

Referenced by fromXML(), and loadFromDb().

{
$this->author = $author;
}

+ Here is the caller graph for this function:

ilObjTest::setAutosave (   $a_value = 1)

Sets autosave.

Parameters
integer$a_valueThe autosave value (0 = disabled, 1 = enabled) public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->autosave = 1;
break;
default:
$this->autosave = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setCertificateVisibility (   $a_value)

Sets the visibility settings of the certificate.

Parameters
integer$a_valueThe value for the visibility settings (0 = always, 1 = only passed, 2 = never) public

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

Referenced by loadFromDb().

{
$this->certificate_visibility = $a_value;
}

+ Here is the caller graph for this function:

ilObjTest::setClientIP (   $user_id,
  $client_ip 
)

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

References $ilDB, and getTestId().

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("UPDATE tst_invited_user SET clientip = %s, tstamp = %s WHERE test_fi=%s and user_fi=%s",
array('text', 'integer', 'integer', 'integer'),
array((strlen($client_ip)) ? $client_ip : NULL, time(), $this->getTestId(), $user_id)
);
}

+ Here is the call graph for this function:

ilObjTest::setCountSystem (   $a_count_system = COUNT_PARTIAL_SOLUTIONS)

Sets the count system for the calculation of points.

Parameters
integer$a_count_systemThe count system for the calculation of points. public
See Also
$count_system

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->count_system = $a_count_system;
}

+ Here is the caller graph for this function:

ilObjTest::setCustomStyle (   $a_customStyle = NULL)

Set the custom style.

Parameters
string$a_customStyleThe custom style public
See Also
$_customStyle

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_customStyle = $a_customStyle;
}

+ Here is the caller graph for this function:

ilObjTest::setECTSFX (   $a_ects_fx)

Sets the ECTS FX grade.

Parameters
string$a_ects_fxThe ECTS FX grade public
See Also
$ects_fx

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

Referenced by applyDefaults(), and loadFromDb().

{
$this->ects_fx = $a_ects_fx;
}

+ Here is the caller graph for this function:

ilObjTest::setECTSGrades (   $a_ects_grades)

Sets the ECTS grades.

Parameters
array$a_ects_gradesThe ECTS grades public
See Also
$ects_grades

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

Referenced by applyDefaults(), and loadFromDb().

{
if (is_array($a_ects_grades))
{
$this->ects_grades = $a_ects_grades;
}
}

+ Here is the caller graph for this function:

ilObjTest::setECTSOutput (   $a_ects_output)

Enables/Disables ECTS grades output for this test.

Parameters
integer$a_ects_output0 if ECTS grades output should be deactivated, 1 otherwise public
See Also
$ects_output

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

Referenced by applyDefaults(), and loadFromDb().

{
$this->ects_output = $a_ects_output ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setEnableProcessingTime (   $enable = 0)

Sets the processing time enabled or disabled.

Parameters
integer$enable0 to disable the processing time, 1 to enable the processing time public
See Also
$processing_time

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if ($enable) {
$this->enable_processing_time = "1";
} else {
$this->enable_processing_time = "0";
}
}

+ Here is the caller graph for this function:

ilObjTest::setEndingTime (   $ending_time = NULL)

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

Parameters
string$ending_timeThe ending time for the test. Empty string for no ending time. public
See Also
$ending_time

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

References $ending_time.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->ending_time = $ending_time;
}

+ Here is the caller graph for this function:

ilObjTest::setEvaluationAdditionalFields (   $fields)

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

Parameters
array$fieldsArray of database fields that should be shown in the evaluation

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

References ilObject\getId().

{
$assessmentSetting = new ilSetting("assessment");
$assessmentSetting->set("evalFields_" . $this->getId(), serialize($fields));
}

+ Here is the call graph for this function:

ilObjTest::setExamPdf (   $a_int = 0)

Sets "save exam pdf" setting.

Sets "generate exam pdf" setting of the ilObjTest object

Parameters
integer$a_intpublic
See Also
$_exam_pdf

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_exam_pdf = ($a_int) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setExportSettings (   $a_settings)

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if ($a_settings)
{
$this->exportsettings = $a_settings;
}
else
{
$this->exportsettings = 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::setExportSettingsRespectShuffle (   $a_settings)

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

References getExportSettingsRespectShuffle().

{
if ($a_settings)
{
$this->exportsettings = $this->exportsettings | 2;
}
else
{
if ($this->getExportSettingsRespectShuffle())
{
$this->exportsettings = $this->exportsettings ^ 2;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setExportSettingsSingleChoiceShort (   $a_settings)

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

References getExportSettingsSingleChoiceShort().

{
if ($a_settings)
{
$this->exportsettings = $this->exportsettings | 1;
}
else
{
if ($this->getExportSettingsSingleChoiceShort())
{
$this->exportsettings = $this->exportsettings ^ 1;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setFinalStatement (   $a_statement = "")

Sets the final statement text of the ilObjTest object.

Parameters
string$a_statementA final statement public
See Also
$_finalstatement

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_finalstatement = $a_statement;
}

+ Here is the caller graph for this function:

ilObjTest::setFixedParticipants (   $a_value = 1)

Sets the fixed participants status.

Parameters
integer$a_valueThe value for the fixed participants status (0 = don't allow, 1 = allow) public

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

Referenced by fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->fixed_participants = 1;
break;
default:
$this->fixed_participants = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setForceJS (   $a_js = 1)

Set whether JavaScript should be forced for tests.

Parameters
integer$a_js1 to force JavaScript, 0 otherwise public
See Also
$_forcejs

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_forcejs = ($a_js) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setImportDirectory (   $a_import_dir)

Set import directory.

Parameters
string$a_import_dir
Returns

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

{
$this->import_dir = $a_import_dir;
}
ilObjTest::setInstantFeedbackSolution (   $instant_feedback = 0)

Sets the instant feedback for the solution.

Parameters
integer$instant_feedbackIf 1, the solution will be shown after answering a question public
See Also
$instant_verification

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($instant_feedback)
{
case 1:
$this->instant_verification = 1;
break;
default:
$this->instant_verification = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setIntroduction (   $introduction = "")

Sets the introduction text of the ilObjTest object.

Parameters
string$introductionAn introduction string for the test public
See Also
$introduction

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

References $introduction.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->introduction = $introduction;
}

+ Here is the caller graph for this function:

ilObjTest::setKiosk (   $kiosk = 0)

Sets the kiosk mode for the test.

Parameters
integer$kioskThe value for the kiosk mode. public
See Also
$_kiosk

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_kiosk = $kiosk;
}

+ Here is the caller graph for this function:

ilObjTest::setKioskMode (   $a_kiosk = FALSE)

Sets the kiosk mode for the test.

Parameters
boolean$kioskThe value for the kiosk mode public
See Also
$_kiosk

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

References getKioskMode().

{
if ($a_kiosk)
{
$this->_kiosk = $this->_kiosk | 1;
}
else
{
if ($this->getKioskMode())
{
$this->_kiosk = $this->_kiosk ^ 1;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setListOfQuestions (   $a_value = TRUE)

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

Parameters
boolean$a_valueTRUE if the list of questions should be presented, FALSE otherwise public

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

{
if ($a_value)
{
$this->show_summary = 1;
}
else
{
$this->show_summary = 0;
}
}
ilObjTest::setListOfQuestionsDescription (   $a_value = TRUE)

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

Parameters
boolean$a_valueTRUE if the list of questions should be shown with question descriptions, FALSE otherwise public

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

References getListOfQuestions(), and getListOfQuestionsDescription().

{
if ($a_value && $this->getListOfQuestions())
{
$this->show_summary = $this->show_summary | 8;
}
if (!$a_value && $this->getListOfQuestions())
{
if ($this->getListOfQuestionsDescription())
{
$this->show_summary = $this->show_summary ^ 8;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setListOfQuestionsEnd (   $a_value = TRUE)

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

Parameters
boolean$a_valueTRUE if the list of questions should be the end page, FALSE otherwise public

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

References getListOfQuestions(), and getListOfQuestionsEnd().

{
if ($a_value && $this->getListOfQuestions())
{
$this->show_summary = $this->show_summary | 4;
}
if (!$a_value && $this->getListOfQuestions())
{
if ($this->getListOfQuestionsEnd())
{
$this->show_summary = $this->show_summary ^ 4;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setListOfQuestionsSettings (   $a_value = 0)

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

Parameters
integer$a_value0, 1, 3, 5 or 7 public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->show_summary = $a_value;
}

+ Here is the caller graph for this function:

ilObjTest::setListOfQuestionsStart (   $a_value = TRUE)

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

Parameters
boolean$a_valueTRUE if the list of questions should be the start page, FALSE otherwise public

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

References getListOfQuestions(), and getListOfQuestionsStart().

{
if ($a_value && $this->getListOfQuestions())
{
$this->show_summary = $this->show_summary | 2;
}
if (!$a_value && $this->getListOfQuestions())
{
if ($this->getListOfQuestionsStart())
{
$this->show_summary = $this->show_summary ^ 2;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setMailNotification (   $a_notification)

Set mail notification settings.

Parameters
$a_notificationMail notification setting

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->mailnotification = $a_notification;
}

+ Here is the caller graph for this function:

ilObjTest::setMailNotificationType (   $a_type)

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if ($a_type == 1)
{
$this->mailnottype = 1;
}
else
{
$this->mailnottype = 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::setMCScoring (   $a_mc_scoring = SCORE_ZERO_POINTS_WHEN_UNANSWERED)

Sets the multiple choice scoring.

Parameters
integer$a_mc_scoringThe scoring for multiple choice questions public
See Also
$mc_scoring

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->mc_scoring = $a_mc_scoring;
}

+ Here is the caller graph for this function:

ilObjTest::setNrOfTries (   $nr_of_tries = 0)

Sets the nr of tries for the test.

Parameters
integer$nr_of_triesThe maximum number of tries for the test. 0 for infinite tries. public
See Also
$nr_of_tries

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

References $nr_of_tries.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->nr_of_tries = $nr_of_tries;
}

+ Here is the caller graph for this function:

ilObjTest::setPassScoring (   $a_pass_scoring = SCORE_LAST_PASS)

Sets the pass scoring.

Parameters
integer$a_pass_scoringThe pass scoring type public
See Also
$pass_scoring

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

References SCORE_BEST_PASS, and SCORE_LAST_PASS.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_pass_scoring)
{
case SCORE_BEST_PASS:
$this->pass_scoring = SCORE_BEST_PASS;
break;
default:
$this->pass_scoring = SCORE_LAST_PASS;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setPassword (   $a_password = NULL)

Sets the password for test access.

Parameters
string$a_passwordThe password for test access public
See Also
$password

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

Referenced by fromXML(), and loadFromDb().

{
$this->password = $a_password;
}

+ Here is the caller graph for this function:

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

Sets the processing time for the test.

Parameters
string$processing_timeThe maximum processing time for the test given in hh:mm:ss public
See Also
$processing_time

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

References $processing_time.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

:00:00")
{
$this->processing_time = $processing_time;
}

+ Here is the caller graph for this function:

ilObjTest::setQuestionSetSolved (   $value,
  $question_id,
  $user_id 
)

sets question solved state to value for given user_id

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

References $ilDB, and getActiveIdOfUser().

{
global $ilDB;
$active_id = $this->getActiveIdOfUser($user_id);
$affectedRows = $ilDB->manipulateF("DELETE FROM tst_qst_solved WHERE active_fi = %s AND question_fi = %s",
array('integer', 'integer'),
array($active_id, $question_id)
);
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_qst_solved (solved, question_fi, active_fi) VALUES (%s, %s, %s)",
array('integer', 'integer', 'integer'),
array($value, $question_id, $active_id)
);
}

+ Here is the call graph for this function:

ilObjTest::setRandomQuestionCount (   $a_random_question_count = "")

Sets the random question count.

Parameters
integer$a_random_question_countThe random question count public
See Also
$random_question_count

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

Referenced by applyDefaults(), fromXML(), loadFromDb(), and saveRandomQuestionCount().

{
$this->random_question_count = $a_random_question_count;
}

+ Here is the caller graph for this function:

ilObjTest::setRandomQuestionpoolData (   $a_data)

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

{
$this->random_questionpool_data = $a_data;
}
ilObjTest::setRandomTest (   $a_random_test = 0)

Sets the random test indicator.

Parameters
integer$a_random_testThe random test indicator (0 = no random test, 1 = random test) public
See Also
$random_test

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->random_test = $a_random_test;
}

+ Here is the caller graph for this function:

ilObjTest::setRedirectAfterExam (   $a_url = "")

Sets the redirect after exam URL.

Sets the redirect after exam URL of the ilObjTest object

Parameters
string$a_urlA final statement public
See Also
$_redirect_after_exam

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_redirect_after_exam = $a_url;
}

+ Here is the caller graph for this function:

ilObjTest::setRedirectOnlyKioskMode (   $a_int = 1)

Sets "redirection only in kiosk mode" setting.

Sets "redirection only in kiosk mode" setting of the ilObjTest object

Parameters
integer$a_booleanpublic
See Also
$_redirect_only_kiosk_mode

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_redirect_only_kiosk_mode = ($a_int) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setReportingDate (   $reporting_date)

Sets the reporting date of the ilObjTest object.

Parameters
timestamp$reporting_dateThe date and time the score reporting is available public
See Also
$reporting_date

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

References $reporting_date.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if (!$reporting_date)
{
$this->reporting_date = "";
$this->ects_output = 0;
}
else
{
$this->reporting_date = $reporting_date;
}
}

+ Here is the caller graph for this function:

ilObjTest::setResetProcessingTime (   $reset = 0)

Sets whether the processing time should be reset or not.

Parameters
integer$reset1 to reset the processing time, 0 otherwise public
See Also
$processing_time

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if ($reset)
{
$this->reset_processing_time = 1;
}
else
{
$this->reset_processing_time = 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::setResultsPresentation (   $a_results_presentation = 3)

Sets the combined results presentation value.

Parameters
integer$a_results_presentationThe combined results presentation value public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->results_presentation = $a_results_presentation;
}

+ Here is the caller graph for this function:

ilObjTest::setScoreCutting (   $a_score_cutting = SCORE_CUT_QUESTION)

Sets the type of score cutting.

Parameters
integer$a_score_cuttingThe type of score cutting. 0 for cut questions, 1 for cut tests public
See Also
$score_cutting

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

Referenced by fromXML(), and loadFromDb().

{
$this->score_cutting = $a_score_cutting;
}

+ Here is the caller graph for this function:

ilObjTest::setScoreReporting (   $score_reporting = 0)

Sets the score reporting of the ilObjTest object.

Parameters
integer$score_reportingThe score reporting public
See Also
$score_reporting

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

References $score_reporting.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->score_reporting = $score_reporting;
}

+ Here is the caller graph for this function:

ilObjTest::setSequenceSettings (   $sequence_settings = 0)

Sets the sequence settings of the ilObjTest object.

Parameters
integer$sequence_settingsThe sequence settings public
See Also
$sequence_settings

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

References $sequence_settings.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->sequence_settings = $sequence_settings;
}

+ Here is the caller graph for this function:

ilObjTest::setShowCancel (   $a_value = 1)

Sets the cancel test button status.

Parameters
integer$a_valueThe value for the cancel test status (0 = don't show, 1 = show) public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->show_cancel = 1;
break;
default:
$this->show_cancel = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setShowFinalStatement (   $show = 0)

Sets whether the final statement should be shown or not.

Parameters
integer$show1 if TRUE or 0 if FALSE public
See Also
$_finalstatement

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_showfinalstatement = ($show) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setShowInfo (   $a_info = 1)

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

Parameters
integer$a_info1 for the complete information, 0 otherwise public
See Also
$_showinfo

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->_showinfo = ($a_info) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setShowKioskModeParticipant (   $a_participant = FALSE)

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

Parameters
boolean$a_titleTRUE if the participant's name should be shown in kiosk mode, FALSE otherwise public

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

References getShowKioskModeParticipant().

{
if ($a_participant)
{
$this->_kiosk = $this->_kiosk | 4;
}
else
{
if ($this->getShowKioskModeParticipant())
{
$this->_kiosk = $this->_kiosk ^ 4;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShowKioskModeTitle (   $a_title = FALSE)

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

Parameters
boolean$a_titleTRUE if the test title should be shown in kiosk mode, FALSE otherwise public

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

References getShowKioskModeTitle().

{
if ($a_title)
{
$this->_kiosk = $this->_kiosk | 2;
}
else
{
if ($this->getShowKioskModeTitle())
{
$this->_kiosk = $this->_kiosk ^ 2;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShowMarker (   $a_value = 1)

Sets the marker button status.

Parameters
integer$a_valueThe value for the marker status (0 = don't show, 1 = show) public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->show_marker = 1;
break;
default:
$this->show_marker = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setShowPassDetails (   $a_details = 1)

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

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

Parameters
boolean$a_detailsTRUE if the pass details should be shown, FALSE otherwise public

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

References getShowPassDetails().

Referenced by ilObjTest().

{
if ($a_details)
{
$this->results_presentation = $this->results_presentation | 1;
}
else
{
if ($this->getShowPassDetails())
{
$this->results_presentation = $this->results_presentation ^ 1;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setShowSerial (   $a_value = 1)

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($a_value)
{
case 1:
$this->show_serial = 1;
break;
default:
$this->show_serial = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setShowSolutionAnswersOnly (   $a_full = TRUE)

Set to true, if the full solution (including the ILIAS content pages) should be shown in the solution output.

Parameters
boolean$a_fullTRUE if the full solution should be shown in the solution output, FALSE otherwise public

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

References getShowSolutionAnswersOnly().

Referenced by ilObjTest().

{
if ($a_full)
{
$this->results_presentation = $this->results_presentation | 16;
}
else
{
if ($this->getShowSolutionAnswersOnly())
{
$this->results_presentation = $this->results_presentation ^ 16;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setShowSolutionAnwersBeforeFinish (   $a_value = FALSE)

Set to TRUE, if the list of answers should be shown prior to finish the test.

Parameters
boolean$a_comparisonTRUE if the list of answers should be shown prior to finish the test, FALSE otherwise public

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

References getShowSolutionAnwersBeforeFinish().

{
if ($a_value)
{
$this->results_presentation = $this->results_presentation | 256;
}
else
{
if ($this->getShowSolutionAnwersBeforeFinish())
{
$this->results_presentation = $this->results_presentation ^ 256;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShowSolutionDetails (   $a_details = 1)

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

Parameters
integer$a_details1 if the solution details should be presented, 0 otherwise public

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

References getShowSolutionDetails().

Referenced by ilObjTest().

{
if ($a_details)
{
$this->results_presentation = $this->results_presentation | 2;
}
else
{
if ($this->getShowSolutionDetails())
{
$this->results_presentation = $this->results_presentation ^ 2;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setShowSolutionFeedback (   $a_feedback = TRUE)

Sets if the the feedback should be presented to the user in the solution or not.

Parameters
boolean$a_feedbackTRUE if the feedback should be presented in the solution, FALSE otherwise public

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

References getShowSolutionFeedback().

{
if ($a_feedback)
{
$this->results_presentation = $this->results_presentation | 8;
}
else
{
if ($this->getShowSolutionFeedback())
{
$this->results_presentation = $this->results_presentation ^ 8;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShowSolutionListComparison (   $a_comparison = FALSE)

Set to TRUE, if the results should be compared with the correct results in the list of answers.

Parameters
boolean$a_comparisonTRUE if the results should be compared with the correct results in the list of answers, FALSE otherwise public

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

References getShowSolutionListComparison().

{
if ($a_comparison)
{
$this->results_presentation = $this->results_presentation | 128;
}
else
{
if ($this->getShowSolutionListComparison())
{
$this->results_presentation = $this->results_presentation ^ 128;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShowSolutionPrintview (   $a_printview = 1)

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

Parameters
boolean$a_detailsTRUE if the solution printview should be presented, FALSE otherwise public

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

References getShowSolutionPrintview().

Referenced by fromXML().

{
if ($a_printview)
{
$this->results_presentation = $this->results_presentation | 4;
}
else
{
if ($this->getShowSolutionPrintview())
{
$this->results_presentation = $this->results_presentation ^ 4;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setShowSolutionSignature (   $a_signature = FALSE)

Set to TRUE, if the signature field should be shown in the solution.

Parameters
boolean$a_signatureTRUE if the signature field should be shown, FALSE otherwise public

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

References getShowSolutionSignature().

Referenced by ilObjTest().

{
if ($a_signature)
{
$this->results_presentation = $this->results_presentation | 32;
}
else
{
if ($this->getShowSolutionSignature())
{
$this->results_presentation = $this->results_presentation ^ 32;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setShowSolutionSuggested (   $a_solution = FALSE)

Set to TRUE, if the suggested solution should be shown in the solution.

Parameters
boolean$a_solutionTRUE if the suggested solution should be shown, FALSE otherwise public

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

References getShowSolutionSuggested().

{
if ($a_solution)
{
$this->results_presentation = $this->results_presentation | 64;
}
else
{
if ($this->getShowSolutionSuggested())
{
$this->results_presentation = $this->results_presentation ^ 64;
}
}
}

+ Here is the call graph for this function:

ilObjTest::setShuffleQuestions (   $a_shuffle)

Sets the status of the shuffle_questions variable.

Parameters
boolean$a_shuffle0 if the test questions are not shuffled, 1 if the test questions are shuffled public

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

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->shuffle_questions = ($a_shuffle) ? 1 : 0;
}

+ Here is the caller graph for this function:

ilObjTest::setStartingTime (   $starting_time = NULL)

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

Parameters
string$starting_timeThe starting time for the test. Empty string for no starting time. public
See Also
$starting_time

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

References $starting_time.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
$this->starting_time = $starting_time;
}

+ Here is the caller graph for this function:

ilObjTest::setTestId (   $a_id)

Sets the test ID.

Parameters
integer$a_idTest ID

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

Referenced by loadFromDb().

{
$this->test_id = $a_id;
}

+ Here is the caller graph for this function:

& ilObjTest::setTestSession (   $active_id = "")

Sets the test session data for the active user.

Parameters
integer$active_idThe active id of the active user
Returns
object The ilTestSession object or FALSE if the creation of the object fails public

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

References $_SESSION, $testSession, ilObject\getRefId(), and getTestId().

Referenced by getTestSession().

{
if (is_object($this->testSession) && ($this->testSession->getActiveId() > 0)) return $this->testSession;
global $ilUser;
include_once "./Modules/Test/classes/class.ilTestSession.php";
$testSession = FALSE;
if ($active_id > 0)
{
$testSession = new ilTestSession($active_id);
$testSession->setRefId($this->getRefId());
}
else
{
$testSession = new ilTestSession();
$testSession->setRefId($this->getRefId());
$testSession->loadTestSession($this->getTestId(), $ilUser->getId(), $_SESSION["tst_access_code"][$this->getTestId()]);
}
$this->testSession =& $testSession;
return $this->testSession;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::setTitleOutput (   $title_output = 0)

Sets the status of the title output.

Parameters
integer$title_output0 for full title, 1 for title without points, 2 for no title public
See Also
$title_output

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

References $title_output.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
switch ($title_output)
{
case 1:
$this->title_output = 1;
break;
case 2:
$this->title_output = 2;
break;
default:
$this->title_output = 0;
break;
}
}

+ Here is the caller graph for this function:

ilObjTest::setUsePreviousAnswers (   $use_previous_answers = 1)

Sets the status of the visibility of previous learner answers.

Parameters
integer$use_previous_answers1 if the previous answers should be shown public
See Also
$use_previous_answers

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

References $use_previous_answers.

Referenced by applyDefaults(), fromXML(), and loadFromDb().

{
if ($use_previous_answers)
{
$this->use_previous_answers = 1;
}
else
{
$this->use_previous_answers = 0;
}
}

+ Here is the caller graph for this function:

ilObjTest::startingTimeReached ( )

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

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

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

References getStartingTime().

Referenced by isExecutable().

{
if ($this->getStartingTime())
{
if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->getStartingTime(), $matches))
{
$epoch_time = mktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
$now = mktime();
if ($now < $epoch_time)
{
// starting time not reached
return false;
}
}
}
return true;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilObjTest::startWorkingTime (   $active_id,
  $question_id,
  $pass 
)

Write the initial entry for the tests working time to the database.

Parameters
integer$user_idThe database id of the user working with the test public

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

References $ilDB, and $pass.

{
global $ilDB;
$next_id = $ilDB->nextId('tst_times');
$affectedRows = $ilDB->manipulateF("INSERT INTO tst_times (times_id, active_fi, started, finished, pass, question_fi, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s)",
array('integer', 'integer', 'timestamp', 'timestamp', 'integer', 'integer', 'integer'),
array($next_id, $active_id, strftime("%Y-%m-%d %H:%M:%S"), strftime("%Y-%m-%d %H:%M:%S"), $pass, $question_id, time())
);
return $next_id;
}
ilObjTest::unsetAccessCodeSession ( )

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

References $_SESSION, ilObject\$id, and getTestId().

{
$id = $this->getTestId();
unset($_SESSION["tst_access_code"]["$id"]);
}

+ Here is the call graph for this function:

ilObjTest::update ( )

update object data

public

Returns
boolean

Reimplemented from ilObject.

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

{
if (!parent::update())
{
return false;
}
// put here object specific stuff
return true;
}
ilObjTest::updateWorkingTime (   $times_id)

Update the working time of a test when a question is answered.

Parameters
integer$times_idThe database id of a working time entry public

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

References $ilDB.

{
global $ilDB;
$affectedRows = $ilDB->manipulateF("UPDATE tst_times SET finished = %s, tstamp = %s WHERE times_id = %s",
array('timestamp', 'integer', 'integer'),
array(strftime("%Y-%m-%d %H:%M:%S"), time(), $times_id)
);
}
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_idThe database ID of the user
boolean$overwrite_anonymityIndicates if the anonymity status should be ignored
Returns
string The full name of the user or UNKNOWN if the anonymity status is affected public

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

References ilObject\$lng, ilObjUser\_lookupName(), and getAnonymity().

Referenced by removeSelectedTestResults(), removeTestResultsForUser(), sendAdvancedNotification(), and sendSimpleNotification().

{
global $lng;
if ($this->getAnonymity() && !$overwrite_anonymity)
{
return $lng->txt("unknown") . $suffix;
}
else
{
include_once './Services/User/classes/class.ilObjUser.php';
$uname = ilObjUser::_lookupName($user_id);
if (strlen($uname["firstname"].$uname["lastname"]) == 0) $uname["firstname"] = $lng->txt("deleted_user");
if ($sorted_order)
{
return trim($uname["lastname"] . ", " . $uname["firstname"]) . $suffix;
}
else
{
return trim($uname["firstname"] . " " . $uname["lastname"]) . $suffix;
}
}
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Field Documentation

ilObjTest::$_customStyle
private

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

ilObjTest::$_exam_pdf
private

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

ilObjTest::$_finalstatement
private

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

ilObjTest::$_forcejs
private

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

ilObjTest::$_kiosk
protected

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

ilObjTest::$_redirect_after_exam
private

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

ilObjTest::$_redirect_only_kiosk_mode
private

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

ilObjTest::$_showfinalstatement
private

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

ilObjTest::$_showinfo
private

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

ilObjTest::$allowedUsers

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

ilObjTest::$allowedUsersTimeGap

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

ilObjTest::$anonymity

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

ilObjTest::$answer_feedback

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

Referenced by setAnswerFeedback().

ilObjTest::$answer_feedback_points

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

Referenced by setAnswerFeedbackPoints().

ilObjTest::$author

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

Referenced by _lookupAuthor(), getAuthor(), and setAuthor().

ilObjTest::$autosave

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

ilObjTest::$certificate_visibility

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

ilObjTest::$count_system

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

ilObjTest::$ects_fx

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

ilObjTest::$ects_grades

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

Referenced by getECTSGrades().

ilObjTest::$ects_output

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

Referenced by saveECTSStatus().

ilObjTest::$enable_processing_time

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

ilObjTest::$ending_time

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

Referenced by setEndingTime().

ilObjTest::$evaluation_data

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

ilObjTest::$exportsettings
protected

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

Referenced by getExportSettings().

ilObjTest::$fixed_participants

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

ilObjTest::$import_dir
private

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

Referenced by getImportDirectory().

ilObjTest::$instant_verification

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

ilObjTest::$introduction

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

Referenced by setIntroduction().

ilObjTest::$invitation = INVITATION_OFF

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

ilObjTest::$mailnotification
protected

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

Referenced by getMailNotification().

ilObjTest::$mailnottype
protected

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

Referenced by getMailNotificationType().

ilObjTest::$mark_schema

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

Referenced by cloneObject(), and getMarkSchema().

ilObjTest::$mc_scoring

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

ilObjTest::$metadata

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

Referenced by fromXML().

ilObjTest::$nr_of_tries

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

Referenced by setNrOfTries().

ilObjTest::$pass_scoring

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

ilObjTest::$password

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

ilObjTest::$processing_time

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

Referenced by isMaxProcessingTimeReached(), and setProcessingTime().

ilObjTest::$questions

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

Referenced by getQuestions(), and recalculateSolutions().

ilObjTest::$random_question_count

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

ilObjTest::$random_questionpool_data
protected

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

Referenced by getRandomQuestionpoolData().

ilObjTest::$random_test

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

ilObjTest::$reporting_date

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

Referenced by setReportingDate().

ilObjTest::$reset_processing_time

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

ilObjTest::$results_presentation

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

ilObjTest::$score_cutting

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

ilObjTest::$score_reporting

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

Referenced by setScoreReporting().

ilObjTest::$sequence_settings

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

Referenced by setSequenceSettings().

ilObjTest::$show_cancel

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

ilObjTest::$show_marker

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

ilObjTest::$show_serial
protected

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

ilObjTest::$show_summary

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

ilObjTest::$shuffle_questions

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

ilObjTest::$starting_time

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

Referenced by canShowTestResults(), isExecutable(), isMaxProcessingTimeReached(), and setStartingTime().

ilObjTest::$test_id

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

Referenced by _evalResultsOverview(), _getActiveIdOfUser(), _getCompleteWorkingTimeOfParticipants(), _getObjectIDFromTestID(), _getQuestionCount(), _getTestIDFromObjectID(), _getVisitTimeOfParticipant(), getParticipantsForTestAndQuestion(), and getTestId().

ilObjTest::$testSequence

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

Referenced by createRandomSolutions(), getTestResult(), and getTestSequence().

ilObjTest::$testSession

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

Referenced by createRandomSolutions(), createTestSession(), getTestSession(), and setTestSession().

ilObjTest::$title_output

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

Referenced by setTitleOutput().

ilObjTest::$use_previous_answers

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

Referenced by _getUsePreviousAnswers(), and setUsePreviousAnswers().

The documentation for this class was generated from the following file: