ilObjTestGUI Class Reference

Class ilObjTestGUI. More...

Inheritance diagram for ilObjTestGUI:

Collaboration diagram for ilObjTestGUI:

Public Member Functions
	executeCommand ()
	execute command More...
	prepareOutput (bool $show_subobjects=true)
	getTestAccess ()
	setTestAccess (ilTestAccess $test_access)
	runObject ()
	retrieveAdditionalDidacticTemplateOptions ()
	afterSave (ilObject $new_object)
	save object public More...
	backToRepositoryObject ()
	getTestObject ()
	importVerifiedFileObject (bool $skip_retrieve_selected_questions=false)
	imports question(s) into the questionpool (after verification) More...
	downloadFileObject ()
	download file More...
	fullscreenObject ()
	show fullscreen view More...
	download_paragraphObject ()
	download source code paragraph More...
	createQuestionPool ($name="dummy", $description="")
	cancelCreateQuestionObject ()
	createQuestionFormObject (?Form $form=null)
	showQuestionsObject ()
	takenObject ()
	historyObject ()
	exportLegacyLogsObject ()
	participantsActionObject ()
	Evaluates the actions on the participants page. More...
	defaultsObject ()
	Displays the settings page for test defaults. More...
	deleteDefaultsObject ()
	Deletes selected test defaults. More...
	confirmedApplyDefaultsObject ()
	applyDefaultsObject ($confirmed=false)
	Applies the selected test defaults. More...
	addDefaultsObject ()
	Adds the defaults of this test to the defaults. More...
	addLocatorItems ()
	statisticsObject ()
	certificateObject ()
	Shows the certificate editor. More...
	getTabs ()
	adds tabs to tab gui object More...
	copyQuestionsToPoolObject ()
	copyQuestionsToPool (array $question_ids, int $qpl_id)
	copyQuestionToPool (assQuestionGUI $source_question_gui, ilObjQuestionPool $target_pool)
	copyAndLinkQuestionsToPoolObject (?int $ref_id=null, array $question_ids=[])
	copyToQuestionpoolObject ()
	createQuestionPoolAndCopyObject ()
	createQuestionpoolTargetObject (string $cmd)
	Called when a new question should be created from a test Important: $cmd may be overwritten if no question pool is available. More...
Public Member Functions inherited from ilObjectGUI
	getRefId ()
	setAdminMode (string $mode)
	getAdminMode ()
	getObject ()
	executeCommand ()
	withReferences ()
	determines whether objects are referenced or not (got ref ids or not) More...
	setCreationMode (bool $mode=true)
	If true, a creation screen is displayed the current [ref_id] does belong to the parent class The mode is determined in ilRepositoryGUI. More...
	getCreationMode ()
	prepareOutput (bool $show_sub_objects=true)
	getAdminTabs ()
	administration tabs show only permissions and trash folder More...
	getHTML ()
	confirmedDeleteObject ()
	confirmed deletion of object -> objects are moved to trash or deleted immediately, if trash is disabled More...
	cancelObject ()
	cancel action and go back to previous page More...
	createObject ()
	create new object form More...
	editAvailabilityPeriodObject ()
	saveAvailabilityPeriodObject ()
	cancelCreation ()
	cancel create action and go back to repository parent More...
	saveObject ()
	getDidacticTemplateVar (string $type)
	Get didactic template setting from creation screen. More...
	putObjectInTree (ilObject $obj, ?int $parent_node_id=null)
	Add object to tree at given position. More...
	editObject ()
	addExternalEditFormCustom (ilPropertyFormGUI $form)
	updateObject ()
	updates object entry in object_data More...
	getFormAction (string $cmd, string $default_form_action="")
	Get form action for command (command is method name without "Object", e.g. More...
	isVisible (int $ref_id, string $type)
	viewObject ()
	viewObject container presentation for "administration -> repository, trash, permissions" More...
	deleteObject (bool $error=false)
	Display deletion confirmation screen. More...
	setColumnSettings (ilColumnGUI $column_gui)
	addToDeskObject ()
	removeFromDeskObject ()
Public Member Functions inherited from ILIAS\Object\ImplementsCreationCallback
	callCreationCallback (\ilObject $object, \ilObjectDefinition $obj_definition, int $requested_crtcb)
Public Member Functions inherited from ilDesktopItemHandling
	addToDeskObject ()
	removeFromDeskObject ()

Static Public Member Functions
static	_goto ($target)
	Redirect script to call a test with the test reference id. More...
Static Public Member Functions inherited from ilObjectGUI
static	_gotoRepositoryRoot (bool $raise_error=false)
	Goto repository root. More...
static	_gotoRepositoryNode (int $ref_id, string $cmd="")
static	_gotoSharedWorkspaceNode (int $wsp_id)

Data Fields
const	SHOW_QUESTIONS_CMD = 'showQuestions'
Data Fields inherited from ilObjectGUI
const	ADMIN_MODE_NONE = ""
const	ADMIN_MODE_SETTINGS = "settings"
const	ADMIN_MODE_REPOSITORY = "repository"
const	UPLOAD_TYPE_LOCAL = 1
const	UPLOAD_TYPE_UPLOAD_DIRECTORY = 2
const	CFORM_NEW = 1
const	CFORM_IMPORT = 2
const	CFORM_CLONE = 3
const	SUPPORTED_IMPORT_MIME_TYPES = [MimeType::APPLICATION__ZIP, MimeType::APPLICATION__X_ZIP_COMPRESSED]

Protected Member Functions
	redirectAfterMissingWrite ()
	redirectAfterMissingRead ()
	forwardCommandToQuestionPreview (string $cmd, ?assQuestionGUI $question_gui=null)
	forwardCommandToQuestion (string $cmd)
	trackTestObjectReadEvent ()
	exportObject ()
	Gateway for exports initiated from workspace, as there is a generic forward to {objTypeMainGUI}::export() More...
	fetchAuthoringQuestionIdParameter ()
	importFile (string $file_to_import, string $path_to_uploaded_file_in_temp_dir)
	removeImportFailsObject ()
	getTargetQuestionpoolForm ($questionpools, string $cmd)
	protectByWritePermission ()
	determineObjectiveOrientedContainer ()
	getObjectiveOrientedContainer ()
	getQuestionsTableQuery ()
	getQuestionsTableActions ()
	getTable ()
Protected Member Functions inherited from ilObjectGUI
	getObjectService ()
	assignObject ()
	setTitleAndDescription ()
	createActionDispatcherGUI ()
	initHeaderAction (?string $sub_type=null, ?int $sub_id=null)
	Add header action menu. More...
	insertHeaderAction (?ilObjectListGUI $list_gui=null)
	Insert header action into main template. More...
	addHeaderAction ()
	Add header action menu. More...
	redrawHeaderActionObject ()
	Ajax call: redraw action header only. More...
	setTabs ()
	set admin tabs More...
	setAdminTabs ()
	set admin tabs More...
	setLocator ()
	addLocatorItems ()
	should be overwritten to add object specific items (repository items are preloaded) More...
	omitLocator (bool $omit=true)
	addAdminLocatorItems (bool $do_not_add_object=false)
	should be overwritten to add object specific items (repository items are preloaded) More...
	getCreationFormsHTML (StandardForm|ilPropertyFormGUI|array $form)
	getTitleForCreationFormPage ()
	getCreationFormTitle ()
	initCreateForm (string $new_type)
	didacticTemplatesToForm ()
	initDidacticTemplate (ilPropertyFormGUI $form)
	retrieveAdditionalDidacticTemplateOptions ()
	addAdoptContentLinkToToolbar ()
	addImportButtonToToolbar ()
	addAvailabilityPeriodButtonToToolbar (ilToolbarGUI $toolbar)
	parseDidacticTemplateVar (string $var, string $type)
	afterSave (ilObject $new_object)
	Post (successful) object creation hook. More...
	initEditForm ()
	initEditCustomForm (ilPropertyFormGUI $a_form)
	Add custom fields to update form. More...
	getEditFormValues ()
	getEditFormCustomValues (array &$a_values)
	Add values to custom edit fields. More...
	validateCustom (ilPropertyFormGUI $form)
	Validate custom values (if not possible with checkInput()) More...
	updateCustom (ilPropertyFormGUI $form)
	Insert custom update form values into object. More...
	afterUpdate ()
	Post (successful) object update hook. More...
	routeImportCmdObject ()
	importFile (string $file_to_import, string $path_to_uploaded_file_in_temp_dir)
	deleteUploadedImportFile (string $path_to_uploaded_file_in_temp_dir)
	afterImport (ilObject $new_object)
	Post (successful) object import hook. More...
	setFormAction (string $cmd, string $form_action)
	getReturnLocation (string $cmd, string $default_location="")
	Get return location for command (command is method name without "Object", e.g. More...
	setReturnLocation (string $cmd, string $location)
	set specific return location for command More...
	getTargetFrame (string $cmd, string $default_target_frame="")
	get target frame for command (command is method name without "Object", e.g. More...
	setTargetFrame (string $cmd, string $target_frame)
	Set specific target frame for command. More...
	showPossibleSubObjects ()
	show possible sub objects (pull down menu) More...
	getTabs ()
	overwrite in derived GUI class of your object type More...
	redirectToRefId (int $ref_id, string $cmd="")
	redirects to (repository) view per ref id usually to a container and usually used at the end of a save/import method where the object gui type (of the new object) doesn't match with the type of the current ["ref_id"] value of the request More...
	getCenterColumnHTML ()
	Get center column. More...
	getRightColumnHTML ()
	Display right column. More...
	checkPermission (string $perm, string $cmd="", string $type="", ?int $ref_id=null)
	checkPermissionBool (string $perm, string $cmd="", string $type="", ?int $ref_id=null)
	enableDragDropFileUpload ()
	Enables the file upload into this object by dropping files. More...
	getCreatableObjectTypes ()
	buildAddNewItemElements (array $subtypes, string $create_target_class=ilRepositoryGUI::class, ?int $redirect_target_ref_id=null,)
	buildGroup (string $create_target_class, array $obj_types_in_group, string $title, array $subtypes)

Protected Attributes
TabsManager	$tabs_manager = null
ilTestAccess	$test_access
ilNavigationHistory	$navigation_history
ilComponentRepository	$component_repository
ilComponentFactory	$component_factory
ilDBInterface	$db
UIFactory	$ui_factory
UIRenderer	$ui_renderer
ilUIService	$ui_service
HTTPServices	$http
ilHelpGUI	$help
GlobalScreen	$global_screen
ilObjectDataCache	$obj_data_cache
SkillService	$skills_service
IRSS	$irss
RequestDataCollector	$testrequest
ResponseHandler	$response_handler
ParticipantRepository	$participant_repository
ResultsDataFactory	$results_data_factory
ResultsPresentationFactory	$results_presentation_factory
TestResultRepository	$test_pass_result_repository
QuestionsTableQuery	$table_query = null
QuestionsTableActions	$table_actions = null
DataFactory	$data_factory
TaxonomyService	$taxonomy
bool	$create_question_mode
Protected Attributes inherited from ilObjectGUI
ILIAS Notes Service	$notes_service
ServerRequestInterface	$request
ilLocatorGUI	$locator
ilObjUser	$user
ilAccessHandler	$access
ilSetting	$settings
ilToolbarGUI	$toolbar
ilRbacAdmin	$rbac_admin
ilRbacSystem	$rbac_system
ilRbacReview	$rbac_review
ilObjectService	$object_service
ilObjectDefinition	$obj_definition
ilGlobalTemplateInterface	$tpl
ilTree	$tree
ilCtrl	$ctrl
ilErrorHandling	$error
ilLanguage	$lng
ilTabsGUI	$tabs_gui
ILIAS	$ilias
ArrayBasedRequestWrapper	$post_wrapper
RequestWrapper	$request_wrapper
Refinery	$refinery
ilFavouritesManager	$favourites
ilObjectCustomIconFactory	$custom_icon_factory
UIFactory	$ui_factory
UIRenderer	$ui_renderer
Filesystem	$temp_file_system
ilObject	$object = null
bool	$creation_mode = false
	$data
int	$id
bool	$call_by_reference = false
bool	$prepare_output
int	$ref_id
int	$obj_id
int	$maxcount
array	$form_action = []
array	$return_location = []
array	$target_frame = []
string	$tmp_import_dir
string	$sub_objects = ""
bool	$omit_locator = false
string	$type = ""
string	$admin_mode = self::ADMIN_MODE_NONE
int	$requested_ref_id = 0
int	$requested_crtptrefid = 0
int	$requested_crtcb = 0
string	$requested_new_type = ""
string	$link_params
string	$html = ""

Private Member Functions
	addQuestionTitleToObjectTitle (string $question_title)
	addPostCreationTasksToQuestionGUI (assQuestionGUI $question_gui)
	executeAfterQuestionSaveTasks (assQuestionGUI $question_gui)
	executeAfterQuestionCreationTasks (assQuestionGUI $question_gui)
	showNextViewAfterQuestionSave (assQuestionGUI $question_gui, string $target)
	questionsTabGatewayObject ()
	showEditTestPageGUI (string $cmd)
	forwardToEvaluationGUI ()
	redirectTo_SettingsMainGUI_showForm_Object ()
	prepareSubGuiOutput ()
	getSelectedPersonalDefaultsSettingsFromForm ()
	insertQuestionsObject (?array $selected_array=null)
	buildQuestionCreationForm ()
	buildInputQuestionType ()
	buildInputPosition (array $questions)
	buildInputEditingType ()
	buildInputPoolSelection ()
	addQuestion ()
	setupToolBarAndMessage (bool $has_started_test_runs)
	populateQuestionBrowserToolbarButtons (ilToolbarGUI $toolbar)
	isCommandClassAnyInfoScreenChild ()
	infoScreenObject ()
	forwardToInfoScreen ()
	getTestScreenGUIInstance ()

Private Attributes
const	SHOW_LOGS_CMD = 'history'
const	INFO_SCREEN_CHILD_CLASSES
const	QUESTION_CREATION_POOL_SELECTION_NO_POOL = 1
const	QUESTION_CREATION_POOL_SELECTION_NEW_POOL = 2
const	QUESTION_CREATION_POOL_SELECTION_EXISTING_POOL = 3
ilTestQuestionSetConfigFactory	$test_question_set_config_factory
ilTestPlayerFactory	$test_player_factory
ilTestSessionFactory	$test_session_factory
ExportImportFactory	$export_factory
ExportRepository	$export_repository
TestQuestionsRepository	$test_questions_repository
GeneralQuestionPropertiesRepository	$questionrepository
TestTopListRepository	$toplist_repository
ilTestParticipantAccessFilterFactory	$participant_access_filter_factory
QPLRequestDataCollector	$qplrequest
TitleColumnsBuilder	$title_builder
ilTestObjectiveOrientedContainer	$objective_oriented_container
ContentStyle	$content_style
Archives	$archives

Detailed Description

Class ilObjTestGUI.

Author

Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

ilObjTestGUI: ilObjCourseGUI, ilObjectMetaDataGUI, ilCertificateGUI, ilPermissionGUI ilObjTestGUI: ilTestPlayerFixedQuestionSetGUI, ilTestPlayerRandomQuestionSetGUI ilObjTestGUI: ilTestExpresspageObjectGUI, ilAssQuestionPageGUI ilObjTestGUI: ilTestParticipantsGUI, ilTestResultsGUI ilObjTestGUI: ilLearningProgressGUI, ILIAS ilObjTestGUI: ilTestEvaluationGUI ilObjTestGUI: ilAssGenFeedbackPageGUI, ilAssSpecFeedbackPageGUI ilObjTestGUI: ilInfoScreenGUI, ilObjectCopyGUI ilObjTestGUI: ILIAS ilObjTestGUI: ilRepositorySearchGUI, ilTestExportGUI ilObjTestGUI: assMultipleChoiceGUI, assClozeTestGUI, assMatchingQuestionGUI ilObjTestGUI: assOrderingQuestionGUI, assImagemapQuestionGUI, assNumericGUI, assErrorTextGUI ilObjTestGUI: ILIAS, ILIAS ilObjTestGUI: assTextSubsetGUI, assOrderingHorizontalGUI ilObjTestGUI: assSingleChoiceGUI, assFileUploadGUI, assTextQuestionGUI ilObjTestGUI: assKprimChoiceGUI, assLongMenuGUI ilObjTestGUI: ilEditClipboardGUI ilObjTestGUI: ILIAS, ILIAS ilObjTestGUI: ilCommonActionDispatcherGUI ilObjTestGUI: ilTestFixedQuestionSetConfigGUI, ilTestRandomQuestionSetConfigGUI ilObjTestGUI: ilAssQuestionHintsGUI, ilAssQuestionFeedbackEditingGUI, ilLocalUnitConfigurationGUI, assFormulaQuestionGUI ilObjTestGUI: ilTestPassDetailsOverviewTableGUI ilObjTestGUI: ilTestCorrectionsGUI ilObjTestGUI: ilTestSettingsChangeConfirmationGUI ilObjTestGUI: ilTestSkillAdministrationGUI ilObjTestGUI: ilAssQuestionPreviewGUI ilObjTestGUI: ilTestQuestionBrowserTableGUI, ilTestInfoScreenToolbarGUI, ilLTIProviderObjectSettingGUI ilObjTestGUI: ilTestPageGUI

\

Definition at line 109 of file class.ilObjTestGUI.php.

Member Function Documentation

_goto()

static ilObjTestGUI::_goto (   $target )

static

Redirect script to call a test with the test reference id.

Parameters

integer

$a_target

The reference id of the test public

Definition at line 2469 of file class.ilObjTestGUI.php.

References $DIC, $ilErr, ilObjectGUI\$lng, ilObjectGUI\_gotoRepositoryRoot(), ilObject\_lookupObjId(), ilObject\_lookupTitle(), ROOT_FOLDER_ID, and ilLanguage\txt().

Referenced by ILIAS\StaticURL\Handler\LegacyGotoHandler\handle().

    {
        global $DIC;
        $main_tpl = $DIC->ui()->mainTemplate();
        $ilAccess = $DIC['ilAccess'];
        $ilErr = $DIC['ilErr'];
        $lng = $DIC['lng'];

        if ($ilAccess->checkAccess('read', '', (int) $target)
            || $ilAccess->checkAccess('visible', '', (int) $target)) {
            $DIC->ctrl()->setParameterByClass(self::class, 'ref_id', (int) $target);
            $DIC->ctrl()->redirectByClass(
                [
                    ilRepositoryGUI::class,
                    ilObjTestGUI::class,
                    TestScreenGUI::class
                ],
                TestScreenGUI::DEFAULT_CMD
            );
        } elseif ($ilAccess->checkAccess('read', '', ROOT_FOLDER_ID)) {
            $main_tpl->setOnScreenMessage('info', sprintf(
                $lng->txt('msg_no_perm_read_item'),
                ilObject::_lookupTitle(ilObject::_lookupObjId((int) $target))
            ), true);
            ilObjectGUI::_gotoRepositoryRoot();
        }

        $ilErr->raiseError($lng->txt('msg_no_perm_read_lm'), $ilErr->FATAL);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addDefaultsObject()

ilObjTestGUI::addDefaultsObject

(

)

Adds the defaults of this test to the defaults.

Definition at line 2176 of file class.ilObjTestGUI.php.

References defaultsObject(), getTestObject(), ILIAS\Repository\lng(), and protectByWritePermission().

                                       : void
    {
        $this->protectByWritePermission();

        $name = $this->testrequest->strVal('name');
        if ($name !== '') {
            $this->getTestObject()->addDefaults($name);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_defaults_enter_name'));
        }
        $this->defaultsObject();
    }

Here is the call graph for this function:

addLocatorItems()

ilObjTestGUI::addLocatorItems

(

)

Definition at line 2344 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), getTestObject(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), and ILIAS\Repository\locator().

                                     : void
    {
        switch ($this->ctrl->getCmd()) {
            case "run":
            case "infoScreen":
            case "redirectToInfoScreen":
            case "start":
            case "resume":
            case "previous":
            case "next":
            case "summary":
            case "finishTest":
            case "outCorrectSolution":
            case "showAnswersOfUser":
            case "outUserResultsOverview":
            case "backFromSummary":
            case "show_answers":
            case "setsolved":
            case "resetsolved":
            case "outTestSummary":
            case "outQuestionSummary":
            case "gotoQuestion":
            case "selectImagemapRegion":
            case "confirmSubmitAnswers":
            case "finalSubmission":
            case "postpone":
            case "outUserPassDetails":
            case "checkPassword":
                $this->locator->addItem(
                    $this->getTestObject()->getTitle(),
                    $this->ctrl->getLinkTargetByClass(
                        [self::class, TestScreenGUI::class],
                        TestScreenGUI::DEFAULT_CMD
                    ),
                    '',
                    $this->testrequest->getRefId()
                );
                break;
            case "eval_stat":
            case "evalAllUsers":
            case "evalUserDetail":
                $this->locator->addItem(
                    $this->getTestObject()->getTitle(),
                    $this->ctrl->getLinkTarget($this, 'eval_stat'),
                    '',
                    $this->testrequest->getRefId()
                );
                break;
            case "create":
            case "save":
            case "cancel":
            case "importFile":
            case "cloneAll":
            case "importVerifiedFile":
            case "cancelImport":
                break;
            default:
                $this->locator->addItem(
                    $this->getTestObject()->getTitle(),
                    $this->ctrl->getLinkTargetByClass(
                        [self::class, TestScreenGUI::class],
                        TestScreenGUI::DEFAULT_CMD
                    ),
                    '',
                    $this->testrequest->getRefId()
                );
                break;
        }
    }

Here is the call graph for this function:

addPostCreationTasksToQuestionGUI()

ilObjTestGUI::addPostCreationTasksToQuestionGUI ( assQuestionGUI  $question_gui )

private

Definition at line 1149 of file class.ilObjTestGUI.php.

References assQuestionGUI\setCopyToExistingPoolOnSave(), assQuestionGUI\setCopyToNewPoolOnSave(), and assQuestionGUI\setMoveAfterQuestionId().

Referenced by forwardCommandToQuestion().

     : assQuestionGUI {
        if ($this->testrequest->isset('move_after_question_with_id')) {
            $question_gui->setMoveAfterQuestionId(
                $this->testrequest->int('move_after_question_with_id')
            );
        }

        if ($this->testrequest->isset('pool_title')) {
            $question_gui->setCopyToNewPoolOnSave(
                $this->testrequest->strVal('pool_title')
            );
        }

        if ($this->testrequest->isset('pool_ref')) {
            $question_gui->setCopyToExistingPoolOnSave(
                $this->testrequest->int('pool_ref')
            );
        }
        return $question_gui;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addQuestion()

ilObjTestGUI::addQuestion ( )

private

Definition at line 1885 of file class.ilObjTestGUI.php.

References getTestObject(), insertQuestionsObject(), ILIAS\Repository\lng(), and showQuestionsObject().

Referenced by showQuestionsObject().

                                  : void
    {
        $selected_array = [$this->testrequest->int('add')];
        $total = $this->getTestObject()->evalTotalPersons();
        if ($total > 0) {
            // the test was executed previously
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('test_has_datasets_warning_page_view'));
            $this->showQuestionsObject();
            return;
        }
        $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_insert_questions'));
        $this->insertQuestionsObject($selected_array);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addQuestionTitleToObjectTitle()

ilObjTestGUI::addQuestionTitleToObjectTitle ( string  $question_title )

private

Definition at line 1077 of file class.ilObjTestGUI.php.

References ILIAS\Repository\refinery().

Referenced by executeCommand(), forwardCommandToQuestion(), and forwardCommandToQuestionPreview().

                                                                          : void
    {
        $this->tpl->setTitle(
            $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform(
                "{$this->getTestObject()->getTitle()}: {$question_title}"
            )
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

afterSave()

ilObjTestGUI::afterSave

(

ilObject

$new_object

)

save object public

Definition at line 1455 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), ilObjectGUI\getRefId(), ilObject\getRefId(), getSelectedPersonalDefaultsSettingsFromForm(), ILIAS\Repository\lng(), null, and ILIAS\Repository\user().

                                                   : void
    {
        $info = '';
        $new_object->saveToDb();

        $test_def_id = $this->getSelectedPersonalDefaultsSettingsFromForm();
        if ($test_def_id !== null
            && ($defaults = $new_object->getTestDefaults($test_def_id)) !== null) {
            $info = $new_object->applyDefaults($defaults);
        }

        $new_object->saveToDb();

        if ($new_object->getTestLogger()->isLoggingEnabled()) {
            $new_object->getTestLogger()->logTestAdministrationInteraction(
                $new_object->getTestLogger()->getInteractionFactory()->buildTestAdministrationInteraction(
                    $this->getRefId(),
                    $this->user->getId(),
                    TestAdministrationInteractionTypes::NEW_TEST_CREATED,
                    []
                )
            );
        }

        if ($info === '') {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('object_added'), true);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt($info), true);
        }
        $this->ctrl->setParameter($this, 'ref_id', $new_object->getRefId());
        $this->ctrl->redirectByClass(SettingsMainGUI::class);
    }

Here is the call graph for this function:

applyDefaultsObject()

ilObjTestGUI::applyDefaultsObject

(

$confirmed = false

)

Applies the selected test defaults.

Definition at line 2084 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), defaultsObject(), getTestObject(), ILIAS\Repository\lng(), null, protectByWritePermission(), ilObjTest\QUESTION_SET_TYPE_FIXED, and ilObjTest\QUESTION_SET_TYPE_RANDOM.

Referenced by confirmedApplyDefaultsObject().

                                                           : void
    {
        $this->protectByWritePermission();

        $defaults_id = $this->testrequest->retrieveArrayOfIntsFromPost('chb_defaults');
        if ($defaults_id === []) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_defaults_apply_select_one'));
            $this->defaultsObject();
            return;
        }

        // do not apply if user datasets exist
        if ($this->getTestObject()->evalTotalPersons() > 0
            || ($defaults = $this->getTestObject()->getTestDefaults($defaults_id[0])) === null) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_defaults_apply_not_possible'));
            $this->defaultsObject();
            return;
        }

        $default_settings = unserialize(
            $defaults['defaults'],
            ['allowed_classes' => [DateTimeImmutable::class]]
        );

        if (isset($default_settings['isRandomTest'])) {
            if ($default_settings['isRandomTest']) {
                $new_question_set_type = ilObjTest::QUESTION_SET_TYPE_RANDOM;
                $this->getTestObject()->setQuestionSetType(ilObjTest::QUESTION_SET_TYPE_RANDOM);
            } else {
                $new_question_set_type = ilObjTest::QUESTION_SET_TYPE_FIXED;
                $this->getTestObject()->setQuestionSetType(ilObjTest::QUESTION_SET_TYPE_FIXED);
            }
        } elseif (isset($default_settings['questionSetType'])) {
            $new_question_set_type = $default_settings['questionSetType'];
        }
        $old_question_set_type = $this->getTestObject()->getQuestionSetType();
        $question_set_type_setting_switched = ($old_question_set_type != $new_question_set_type);

        $old_question_set_config = $this->test_question_set_config_factory->getQuestionSetConfig();

        switch (true) {
            case !$question_set_type_setting_switched:
            case !$old_question_set_config->doesQuestionSetRelatedDataExist():
            case $confirmed:

                break;

            default:

                $confirmation = new ilTestSettingsChangeConfirmationGUI($this->testrequest, $this->getTestObject());

                $confirmation->setFormAction($this->ctrl->getFormAction($this));
                $confirmation->setCancel($this->lng->txt('cancel'), 'defaults');
                $confirmation->setConfirm($this->lng->txt('confirm'), 'confirmedApplyDefaults');

                $confirmation->setOldQuestionSetType($this->getTestObject()->getQuestionSetType());
                $confirmation->setNewQuestionSetType($new_question_set_type);
                $confirmation->setQuestionLossInfoEnabled(false);
                $confirmation->build();

                $confirmation->populateParametersFromPost();

                $this->tpl->setContent($this->ctrl->getHTML($confirmation));

                return;
        }

        if ($question_set_type_setting_switched && !$this->getTestObject()->getOfflineStatus()) {
            $this->getTestObject()->setOfflineStatus(true);
            $info = $this->lng->txt('tst_set_offline_due_to_switched_question_set_type_setting');
            $this->tpl->setOnScreenMessage('info', $info, true);
        }

        $info = $this->getTestObject()->applyDefaults($defaults);
        if ($info === '') {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('tst_defaults_applied'), true);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt($info), true);
        }



        if ($question_set_type_setting_switched && $old_question_set_config->doesQuestionSetRelatedDataExist()) {
            $old_question_set_config->removeQuestionSetRelatedData();
        }

        $this->ctrl->redirect($this, 'defaults');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

backToRepositoryObject()

ilObjTestGUI::backToRepositoryObject

(

)

Definition at line 1498 of file class.ilObjTestGUI.php.

References $path, ilObjectGUI\getReturnLocation(), getTestObject(), and ilUtil\redirect().

    {
        $path = $this->tree->getPathFull($this->getTestObject()->getRefID());
        ilUtil::redirect($this->getReturnLocation("cancel", "./ilias.php?baseClass=ilRepositoryGUI&cmd=frameset&ref_id=" . $path[count($path) - 2]["child"]));
    }

Here is the call graph for this function:

buildInputEditingType()

ilObjTestGUI::buildInputEditingType ( )

private

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

References assQuestion\ADDITIONAL_CONTENT_EDITING_MODE_IPE, assQuestion\ADDITIONAL_CONTENT_EDITING_MODE_RTE, getTestObject(), ILIAS\Repository\lng(), ILIAS\UI\Implementation\Component\Input\withValue(), and ILIAS\UI\Component\Input\Input\withValue().

Referenced by buildQuestionCreationForm().

                                            : Input
    {
        if (!$this->getTestObject()->getGlobalSettings()->isPageEditorEnabled()) {
            return $this->ui_factory->input()->field()->hidden()->withValue(
                assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE
            );
        }

        return $this->ui_factory->input()->field()->radio($this->lng->txt('tst_add_quest_cont_edit_mode'))
            ->withOption(
                assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE,
                $this->lng->txt('tst_add_quest_cont_edit_mode_IPE'),
                $this->lng->txt('tst_add_quest_cont_edit_mode_IPE_info')
            )->withOption(
                assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE,
                $this->lng->txt('tst_add_quest_cont_edit_mode_RTE'),
                $this->lng->txt('tst_add_quest_cont_edit_mode_RTE_info')
            )
            ->withValue(assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildInputPoolSelection()

ilObjTestGUI::buildInputPoolSelection ( )

private

Definition at line 1801 of file class.ilObjTestGUI.php.

References Vendor\Package\$f, ILIAS\UI\Implementation\Component\Input\$inputs, ilObjQuestionPool\_getAvailableQuestionpools(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation().

Referenced by buildQuestionCreationForm().

                                              : SwitchableGroup
    {
        $f = $this->ui_factory->input()->field();
        $kt = $this->refinery->kindlyTo();

        $trafo = $this->refinery->custom()->transformation(
            static function ($values) use ($kt): array {
                $return['qpl_type'] = $kt->int()->transform($values[0]);
                if ($return['qpl_type'] === self::QUESTION_CREATION_POOL_SELECTION_NO_POOL) {
                    return $return;
                }
                if ($return['qpl_type'] === self::QUESTION_CREATION_POOL_SELECTION_NEW_POOL) {
                    return $return + ['title' => $kt->string()->transform($values[1][0])];
                }
                return $return + ['pool_ref_id' => $kt->int()->transform($values[1][0])];
            }
        );

        $questionpools = ilObjQuestionPool::_getAvailableQuestionpools(false, false, true, false, false, "write");
        $pools_data = [];
        foreach ($questionpools as $key => $p) {
            $pools_data[$key] = $p['title'];
        }

        $inputs = [
            self::QUESTION_CREATION_POOL_SELECTION_NO_POOL => $f->group([], $this->lng->txt('assessment_no_pool')),
            self::QUESTION_CREATION_POOL_SELECTION_EXISTING_POOL => $f->group(
                [$f->select($this->lng->txt('select_questionpool'), $pools_data)],
                $this->lng->txt('assessment_existing_pool')
            ),
            self::QUESTION_CREATION_POOL_SELECTION_NEW_POOL => $f->group(
                [$f->text($this->lng->txt('name'))],
                $this->lng->txt('assessment_new_pool')
            )
        ];

        return $f->switchableGroup(
            $inputs,
            $this->lng->txt('assessment_pool_selection')
        )->withAdditionalTransformation($trafo)
            ->withRequired(true)
            ->withValue(1);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildInputPosition()

ilObjTestGUI::buildInputPosition ( array  $questions )

private

Definition at line 1767 of file class.ilObjTestGUI.php.

References ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation().

Referenced by buildQuestionCreationForm().

                                                         : Select
    {
        $options = [0 => $this->lng->txt('first')];
        foreach ($questions as $key => $title) {
            $options[$key] = $this->lng->txt('behind') . ' ' . $title
                . ' [' . $this->lng->txt('question_id_short') . ': ' . $key . ']';
        }
        return $this->ui_factory->input()->field()->select(
            $this->lng->txt('position'),
            $options
        )->withAdditionalTransformation($this->refinery->kindlyTo()->int());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildInputQuestionType()

ilObjTestGUI::buildInputQuestionType ( )

private

Definition at line 1753 of file class.ilObjTestGUI.php.

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

Referenced by buildQuestionCreationForm().

                                             : Select
    {
        $question_types = (new ilObjQuestionPool())->getQuestionTypes(false, true, false);
        $options = [];
        foreach ($question_types as $label => $data) {
            $options[$data['question_type_id']] = $label;
        }

        return $this->ui_factory->input()->field()->select(
            $this->lng->txt('question_type'),
            $options
        )->withRequired(true);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionCreationForm()

ilObjTestGUI::buildQuestionCreationForm ( )

private

Definition at line 1723 of file class.ilObjTestGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, buildInputEditingType(), buildInputPoolSelection(), buildInputPosition(), buildInputQuestionType(), ILIAS\Repository\ctrl(), getTestObject(), and ILIAS\Repository\lng().

Referenced by createQuestionPool().

                                                : Form
    {
        $inputs['question_type'] = $this->buildInputQuestionType();
        $questions = $this->getTestObject()->getQuestionTitlesAndIndexes();
        if ($questions !== []) {
            $inputs['position'] = $this->buildInputPosition($questions);
        }

        $inputs['editing_type'] = $this->buildInputEditingType();

        if ($inputs['editing_type'] instanceof Radio) {
            $sub_screen_id[] = 'editMode';
        }

        $sub_screen_id[] = 'poolSelect';

        $inputs['pool_selection'] = $this->buildInputPoolSelection();

        $section = [
            $this->ui_factory->input()->field()->section($inputs, $this->lng->txt('ass_create_question'))
        ];

        $form = $this->ui_factory->input()->container()->form()->standard(
            $this->ctrl->getFormAction($this, 'createQuestion'),
            $section
        )->withSubmitLabel($this->lng->txt('create'));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

cancelCreateQuestionObject()

ilObjTestGUI::cancelCreateQuestionObject

(

)

Definition at line 1683 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

Referenced by ilObjTestGUITest\testCancelCreateQuestionObject().

                                                : void
    {
        $this->ctrl->redirect($this, self::SHOW_QUESTIONS_CMD);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

certificateObject()

ilObjTestGUI::certificateObject

(

)

Shows the certificate editor.

Definition at line 2421 of file class.ilObjTestGUI.php.

References getTestObject().

    {
        $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);

        $guiFactory = new ilCertificateGUIFactory();
        $output_gui = $guiFactory->create($this->getTestObject());

        $output_gui->certificateEditor();
    }

Here is the call graph for this function:

confirmedApplyDefaultsObject()

ilObjTestGUI::confirmedApplyDefaultsObject

(

)

Definition at line 2073 of file class.ilObjTestGUI.php.

References applyDefaultsObject(), and protectByWritePermission().

    {
        $this->protectByWritePermission();

        $this->applyDefaultsObject(true);
        return;
    }

Here is the call graph for this function:

copyAndLinkQuestionsToPoolObject()

ilObjTestGUI::copyAndLinkQuestionsToPoolObject	(	?int	$ref_id = null,
		array	$question_ids = []
	)

Definition at line 2534 of file class.ilObjTestGUI.php.

References ilObjectGUI\$ref_id, copyQuestionsToPool(), ILIAS\Repository\ctrl(), assQuestion\instantiateQuestion(), ILIAS\Repository\lng(), null, assQuestion\saveOriginalId(), and showQuestionsObject().

Referenced by createQuestionPoolAndCopyObject().

      {

        $ref_id = $ref_id ?? $this->testrequest->int('sel_qpl');
        if ($ref_id === null
            || $ref_id === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("questionpool_not_selected"));
            $this->showQuestionsObject();
            return;
        }

        $qpl_id = $this->obj_data_cache->lookupObjId($ref_id);


        if ($question_ids === []) {
            $question_ids = $this->testrequest->getQuestionIds();
            $question_id = $this->testrequest->getQuestionId();
            if ($question_ids === [] && $question_id !== 0) {
                $question_ids = [$question_id];
            }
        }

        if ($question_ids === []) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("tst_no_question_selected_for_moving_to_qpl"));
            $this->ctrl->redirect($this, 'questions');
        }

        $result = $this->copyQuestionsToPool($question_ids, $qpl_id);

        foreach ($result->ids as $oldId => $newId) {
            $questionInstance = assQuestion::instantiateQuestion($oldId);

            $original_question_id = $questionInstance->getOriginalId();
            if ($original_question_id !== null
                && $this->test_questions_repository->originalQuestionExists($original_question_id)) {
                $oldOriginal = assQuestion::instantiateQuestion($original_question_id);
                $oldOriginal->delete($oldOriginal->getId());
            }
            assQuestion::saveOriginalId($questionInstance->getId(), $newId);
        }

        $this->tpl->setOnScreenMessage('success', $this->lng->txt('tst_qst_added_to_pool_' . (count($result->ids) > 1 ? 'p' : 's')), true);
        $this->ctrl->redirect($this, self::SHOW_QUESTIONS_CMD);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

copyQuestionsToPool()

ilObjTestGUI::copyQuestionsToPool	(	array	$question_ids,
		int	$qpl_id
	)

Parameters

Definition at line 2509 of file class.ilObjTestGUI.php.

References copyQuestionToPool().

Referenced by copyAndLinkQuestionsToPoolObject(), and copyQuestionsToPoolObject().

                                                                         : stdClass
    {
        $target_pool = new ilObjQuestionPool($qpl_id, false);
        $new_ids = [];
        foreach ($question_ids as $q_id) {
            $new_id = $this->copyQuestionToPool(assQuestion::instantiateQuestionGUI($q_id), $target_pool);
            $new_ids[$q_id] = $new_id;
        }

        $result = new stdClass();
        $result->ids = $new_ids;
        $result->qpoolid = $qpl_id;

        return $result;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

copyQuestionsToPoolObject()

ilObjTestGUI::copyQuestionsToPoolObject

(

)

Definition at line 2499 of file class.ilObjTestGUI.php.

References copyQuestionsToPool(), and ILIAS\Repository\ctrl().

    {
        $this->copyQuestionsToPool($this->testrequest->raw('q_id'), $this->testrequest->raw('sel_qpl'));
        $this->ctrl->redirect($this, self::SHOW_QUESTIONS_CMD);
    }

Here is the call graph for this function:

copyQuestionToPool()

ilObjTestGUI::copyQuestionToPool	(	assQuestionGUI	$source_question_gui,
		ilObjQuestionPool	$target_pool
	)

Definition at line 2525 of file class.ilObjTestGUI.php.

References ilObjQuestionPool\appendCounterToQuestionTitleIfNecessary(), ilObject\getId(), and assQuestionGUI\getObject().

Referenced by copyQuestionsToPool(), and executeAfterQuestionCreationTasks().

                                                                                                           : int
    {
        $new_title = $target_pool->appendCounterToQuestionTitleIfNecessary(
            $source_question_gui->getObject()->getTitle()
        );

        return $source_question_gui->getObject()->createNewOriginalFromThisDuplicate($target_pool->getId(), $new_title);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

copyToQuestionpoolObject()

ilObjTestGUI::copyToQuestionpoolObject

(

)

Definition at line 2581 of file class.ilObjTestGUI.php.

References createQuestionpoolTargetObject().

    {
        $this->createQuestionpoolTargetObject('copyQuestionsToPool');
    }

Here is the call graph for this function:

createQuestionFormObject()

ilObjTestGUI::createQuestionFormObject

(

?Form

$form = null

)

Definition at line 1703 of file class.ilObjTestGUI.php.

References ILIAS\Repository\help(), and protectByWritePermission().

Referenced by createQuestionPool().

                                                                : void
    {
        $this->protectByWritePermission();

        $this->tabs_manager->getQuestionsSubTabs();
        $this->tabs_manager->activateSubTab(TabsManager::SUBTAB_ID_QST_LIST_VIEW);

        $sub_screen_id = ['createQuestion'];

        $this->tabs_manager->activateTab(TabsManager::TAB_ID_QUESTIONS);
        $this->help->setScreenId('assQuestions');
        $this->help->setSubScreenId(implode('_', $sub_screen_id));

        $this->tpl->setContent(
            $this->ui_renderer->render(
                $form ?? $this->buildQuestionCreationForm()
            )
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

createQuestionPool()

ilObjTestGUI::createQuestionPool	(		$name = "dummy",
			$description = ""
	)

Definition at line 1619 of file class.ilObjTestGUI.php.

References ilObjectGUI\$data, assQuestionGUI\_getQuestionGUI(), buildQuestionCreationForm(), createQuestionFormObject(), ILIAS\Repository\ctrl(), assQuestionGUI\EDIT_CONTEXT_AUTHORING, ILIAS\Survey\Mode\getId(), ilObjQuestionPool\getQuestionTypeByTypeId(), ilObjectGUI\getRefId(), getTestObject(), ILIAS\Repository\lng(), null, and protectByWritePermission().

Referenced by createQuestionPoolAndCopyObject(), and executeAfterQuestionCreationTasks().

                                                                          : ilObjQuestionPool
    {
        $parent_ref = $this->tree->getParentId($this->getTestObject()->getRefId());
        $qpl = new ilObjQuestionPool();
        $qpl->setType("qpl");
        $qpl->setTitle($name);
        $qpl->setDescription($description);
        $qpl->create();
        $qpl->createReference();
        $qpl->putInTree($parent_ref);
        $qpl->setPermissions($parent_ref);
        $qpl->getObjectProperties()->storePropertyIsOnline($qpl->getObjectProperties()->getPropertyIsOnline()->withOnline()); // must be online to be available
        $qpl->saveToDb();
        return $qpl;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

createQuestionPoolAndCopyObject()

ilObjTestGUI::createQuestionPoolAndCopyObject

(

)

Definition at line 2586 of file class.ilObjTestGUI.php.

References ILIAS\Repository\access(), ilObjectGUI\checkPermissionBool(), copyAndLinkQuestionsToPoolObject(), createQuestionPool(), createQuestionpoolTargetObject(), ILIAS\Repository\lng(), and redirectAfterMissingWrite().

    {
        if (!$this->access->checkAccess('write', '', $this->object->getRefId())
            || !$this->checkPermissionBool('create', '', 'qpl')) {
            $this->redirectAfterMissingWrite();
        }

        if ($this->testrequest->raw('title')) {
            $title = $this->testrequest->raw('title');
        } else {
            $title = $this->testrequest->raw('txt_qpl');
        }

        if (!$title) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('questionpool_not_entered'));
            $this->createQuestionpoolTargetObject('createQuestionPoolAndCopy');
            return;
        }

        $question_pool = $this->createQuestionPool($title, $this->testrequest->raw('description'));
        $_REQUEST['sel_qpl'] = $question_pool->getRefId();

        $this->copyAndLinkQuestionsToPoolObject();
    }

Here is the call graph for this function:

createQuestionpoolTargetObject()

ilObjTestGUI::createQuestionpoolTargetObject

(

string

$cmd

)

Called when a new question should be created from a test Important: $cmd may be overwritten if no question pool is available.

Definition at line 2615 of file class.ilObjTestGUI.php.

References getTargetQuestionpoolForm(), getTestObject(), and protectByWritePermission().

Referenced by copyToQuestionpoolObject(), createQuestionPoolAndCopyObject(), and showQuestionsObject().

                                                               : void
    {
        $this->protectByWritePermission();

        $this->tabs_manager->getQuestionsSubTabs();
        $this->tabs_manager->activateSubTab(TabsManager::SUBTAB_ID_QST_LIST_VIEW);

        $questionpools = $this->getTestObject()->getAvailableQuestionpools(
            false,
            false,
            false,
            true,
            false,
            'write'
        );

        if ($questionpools === []) {
            $form = $this->getTargetQuestionpoolForm($questionpools, 'createQuestionPoolAndCopy');
        } else {
            $form = $this->getTargetQuestionpoolForm($questionpools, $cmd);

            switch ($cmd) {
                case 'copyQuestionsToPool':
                    break;

                case 'copyAndLinkQuestionsToPool':
                    $hidden = new ilHiddenInputGUI('link');
                    $hidden->setValue('1');
                    $form->addItem($hidden);
                    break;
            }
        }

        $this->tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

defaultsObject()

ilObjTestGUI::defaultsObject

(

)

Displays the settings page for test defaults.

Definition at line 2037 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), getTestObject(), ILIAS\Repository\lng(), protectByWritePermission(), and ILIAS\Repository\toolbar().

Referenced by addDefaultsObject(), applyDefaultsObject(), and deleteDefaultsObject().

    {
        $this->protectByWritePermission();

        $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);

        $this->toolbar->setFormAction($this->ctrl->getFormAction($this, 'addDefaults'));
        $this->toolbar->addFormButton($this->lng->txt('add'), 'addDefaults');
        $this->toolbar->addInputItem(new ilTextInputGUI($this->lng->txt('tst_defaults_defaults_of_test'), 'name'), true);
        $table = new ilTestPersonalDefaultSettingsTableGUI($this, 'defaults');
        $defaults = $this->getTestObject()->getAvailableDefaults();
        $table->setData($defaults);
        $this->tpl->setContent($table->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteDefaultsObject()

ilObjTestGUI::deleteDefaultsObject

(

)

Deletes selected test defaults.

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

References defaultsObject(), getTestObject(), ILIAS\Repository\lng(), null, and protectByWritePermission().

    {
        $this->protectByWritePermission();

        $defaults_ids = $this->testrequest->retrieveArrayOfIntsFromPost('chb_defaults');
        if ($defaults_ids !== null && $defaults_ids !== []) {
            foreach ($defaults_ids as $test_default_id) {
                $this->getTestObject()->deleteDefaults($test_default_id);
            }
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('select_one'));
        }
        $this->defaultsObject();
    }

Here is the call graph for this function:

determineObjectiveOrientedContainer()

ilObjTestGUI::determineObjectiveOrientedContainer ( )

protected

Definition at line 2709 of file class.ilObjTestGUI.php.

References $path, ilObject\_lookupObjId(), and ilLOSettings\isObjectiveTest().

Referenced by executeCommand().

    {
        if (!ilLOSettings::isObjectiveTest($this->ref_id)) {
            return;
        }

        $path = $this->tree->getPathFull($this->ref_id);

        while ($parent = array_pop($path)) {
            if ($parent['type'] === 'crs') {
                $container_ref_id = $parent['ref_id'];
                break;
            }
        }

        $container_obj_id = ilObject2::_lookupObjId($container_ref_id);

        $this->objective_oriented_container->setObjId($container_obj_id);
        $this->objective_oriented_container->setRefId($container_ref_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

download_paragraphObject()

ilObjTestGUI::download_paragraphObject

(

)

download source code paragraph

Definition at line 1612 of file class.ilObjTestGUI.php.

References exit, and ilPageObject\sendParagraph().

    {
        $pg_obj = new ilAssQuestionPage($this->testrequest->raw("pg_id"));
        $pg_obj->sendParagraph($this->testrequest->raw("par_id"), $this->testrequest->raw("downloadtitle"));
        exit;
    }

Here is the call graph for this function:

downloadFileObject()

ilObjTestGUI::downloadFileObject

(

)

download file

Definition at line 1592 of file class.ilObjTestGUI.php.

References exit.

    {
        $file = explode("_", $this->testrequest->raw("file_id"));
        $fileObj = new ilObjFile((int) $file[count($file) - 1], false);
        $fileObj->sendFile();
        exit;
    }

executeAfterQuestionCreationTasks()

ilObjTestGUI::executeAfterQuestionCreationTasks ( assQuestionGUI  $question_gui )

private

Definition at line 1185 of file class.ilObjTestGUI.php.

References copyQuestionToPool(), createQuestionPool(), assQuestionGUI\getCopyToExistingPoolOnSave(), assQuestionGUI\getCopyToNewPoolOnSave(), assQuestionGUI\getMoveAfterQuestionId(), assQuestionGUI\getObject(), getTestObject(), null, ilObjTest\QUESTION_SET_TYPE_FIXED, assQuestion\saveOriginalId(), assQuestionGUI\setCopyToExistingPoolOnSave(), assQuestionGUI\setCopyToNewPoolOnSave(), and assQuestionGUI\setMoveAfterQuestionId().

Referenced by forwardCommandToQuestion().

                                                                                    : void
    {
        if ($this->getTestObject()->getQuestionSetType() === ilObjTest::QUESTION_SET_TYPE_FIXED
            && !in_array($question_gui->getObject()->getId(), $this->getTestObject()->getQuestions())) {
            $this->getTestObject()->insertQuestion($question_gui->getObject()->getId(), true);
        }

        if ($question_gui->getMoveAfterQuestionId() !== null) {
            $this->getTestObject()->moveQuestions(
                [$question_gui->getObject()->getId()],
                $question_gui->getMoveAfterQuestionId() === 0
                    ? $this->getTestObject()->getQuestions()[1]
                    : $question_gui->getMoveAfterQuestionId(),
                $question_gui->getMoveAfterQuestionId() === 0 ? 0 : 1
            );
            $question_gui->setMoveAfterQuestionId(null);
        }

        if ($question_gui->getCopyToExistingPoolOnSave() !== null) {
            $original_id = $this->copyQuestionToPool(
                $question_gui,
                new ilObjQuestionPool($question_gui->getCopyToExistingPoolOnSave())
            );
            assQuestion::saveOriginalId($question_gui->getObject()->getId(), $original_id);
            $question_gui->setCopyToExistingPoolOnSave(null);
        }

        if ($question_gui->getCopyToNewPoolOnSave() !== null) {
            $question_pool = $this->createQuestionPool($question_gui->getCopyToNewPoolOnSave());
            $original_id = $this->copyQuestionToPool(
                $question_gui,
                $question_pool
            );
            assQuestion::saveOriginalId($question_gui->getObject()->getId(), $original_id);
            $question_gui->setCopyToNewPoolOnSave(null);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeAfterQuestionSaveTasks()

ilObjTestGUI::executeAfterQuestionSaveTasks ( assQuestionGUI  $question_gui )

private

Definition at line 1172 of file class.ilObjTestGUI.php.

References assQuestionGUI\getObject(), ilObjectGUI\getRefId(), and getTestObject().

Referenced by forwardCommandToQuestion().

                                                                                : void
    {
        if ($this->getTestObject()->getTestLogger()->isLoggingEnabled()) {
            $this->getTestObject()->getTestLogger()->logQuestionAdministrationInteraction(
                $question_gui->getObject()->toQuestionAdministrationInteraction(
                    $this->getTestObject()->getTestLogger()->getAdditionalInformationGenerator(),
                    $this->getTestObject()->getRefId(),
                    TestQuestionAdministrationInteractionTypes::QUESTION_MODIFIED
                )
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilObjTestGUI::executeCommand

(

)

execute command

2024-10-21: I've moved this down here, to avoid errors when initializing async-modals and to avoid an unnecessary redirect on errors.

Definition at line 259 of file class.ilObjTestGUI.php.

References ilObjectGUI\$access, $component_factory, ilObjectGUI\$ctrl, $data_factory, $db, $export_factory, ilObjectGUI\$lng, $participant_repository, ilObjectGUI\$refinery, $response_handler, $results_data_factory, $results_presentation_factory, $tabs_manager, $test_access, $test_pass_result_repository, $testrequest, ilObjectGUI\$toolbar, ilObjectGUI\$tpl, $ui_factory, $ui_renderer, $ui_service, assQuestionGUI\_getQuestionGUI(), ILIAS\Repository\access(), ilObjectGUI\addHeaderAction(), addQuestionTitleToObjectTitle(), ilObjectGUI\checkPermissionBool(), ilAssQuestionPreviewGUI\CMD_SHOW, ILIAS\Repository\ctrl(), determineObjectiveOrientedContainer(), fetchAuthoringQuestionIdParameter(), forwardCommandToQuestion(), forwardCommandToQuestionPreview(), forwardToEvaluationGUI(), forwardToInfoScreen(), ilObjectGUI\getCreationMode(), ILIAS\Survey\Mode\getId(), ilCommonActionDispatcherGUI\getInstanceFromAjaxCall(), ilObjectGUI\getObject(), getObjectiveOrientedContainer(), ilObjectGUI\getRefId(), getTestAccess(), getTestObject(), getTestScreenGUIInstance(), ILIAS\Repository\help(), ILIAS\FileDelivery\http(), ilLearningProgressBaseGUI\LP_CONTEXT_REPOSITORY, ILIAS\Repository\object(), prepareOutput(), prepareSubGuiOutput(), protectByWritePermission(), redirectAfterMissingRead(), redirectAfterMissingWrite(), ILIAS\Repository\settings(), showEditTestPageGUI(), trackTestObjectReadEvent(), and ILIAS\Repository\user().

                                    : void
    {
        $cmd = $this->ctrl->getCmd('testScreen');

        $cmds_disabled_due_to_offline_status = [
            'resumePlayer', 'resumePlayer', 'outUserResultsOverview', 'outUserListOfAnswerPasses'
        ];

        if (!$this->getCreationMode() && $this->object->getOfflineStatus() && in_array($cmd, $cmds_disabled_due_to_offline_status)) {
            $cmd = 'infoScreen';
        }

        $next_class = $this->ctrl->getNextClass($this);

        // add entry to navigation history
        if (!$this->getCreationMode() &&
            $this->access->checkAccess('read', '', $this->testrequest->getRefId())
        ) {
            $this->navigation_history->addItem(
                $this->testrequest->getRefId(),
                ilLink::_getLink($this->testrequest->getRefId(), 'tst'),
                'tst',
            );
        }

        $this->determineObjectiveOrientedContainer();

        switch ($next_class) {
            case 'illtiproviderobjectsettinggui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->getSettingsSubTabs();
                $this->tabs_manager->activateTab('settings');
                $this->tabs_manager->activateSubTab('lti_provider');
                $lti_gui = new ilLTIProviderObjectSettingGUI($this->getTestObject()->getRefId());
                $lti_gui->setCustomRolesForSelection($this->rbac_review->getLocalRoles($this->getTestObject()->getRefId()));
                $lti_gui->offerLTIRolesForSelection(false);
                $this->ctrl->forwardCommand($lti_gui);
                break;

            case 'iltestexportgui':
                if (!$this->access->checkAccess('write', '', $this->ref_id)) {
                    $this->redirectAfterMissingWrite();
                }

                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_EXPORT);

                $selected_files = [];
                if ($this->testrequest->isset('file') && $this->testrequest->raw('file')) {
                    $selected_files = $this->testrequest->raw('file');
                }

                if (is_string($selected_files)) {
                    $selected_files = [$selected_files];
                }

                $export_gui = new ilTestExportGUI(
                    $this,
                    $this->db,
                    $this->obj_data_cache,
                    $this->user,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->irss,
                    $this->request,
                    $this->export_repository,
                    $this->temp_file_system,
                    $this->participant_access_filter_factory,
                    new ilTestHTMLGenerator(),
                    $selected_files,
                    $this->questionrepository,
                    $this->testrequest
                );
                $this->ctrl->forwardCommand($export_gui);
                break;

            case strtolower(ilInfoScreenGUI::class):
                if (
                    !$this->access->checkAccess('read', '', $this->testrequest->getRefId())
                    && !$this->access->checkAccess('visible', '', $this->testrequest->getRefId())
                ) {
                    $this->redirectAfterMissingRead();
                }

                $this->prepareOutput();
                $this->addHeaderAction();
                $this->forwardToInfoScreen();
                break;

            case strtolower(TestScreenGUI::class):
                if (!$this->access->checkAccess('read', '', $this->testrequest->getRefId()) && !$this->access->checkAccess('visible', '', $this->testrequest->getRefId())) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $this->ctrl->forwardCommand($this->getTestScreenGUIInstance());
                break;

            case 'ilobjectmetadatagui':
                if (!$this->access->checkAccess('write', '', $this->getTestObject()->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }

                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_META_DATA);
                $md_gui = new ilObjectMetaDataGUI($this->getTestObject());
                $this->ctrl->forwardCommand($md_gui);
                break;

            case strtolower(ilTestParticipantsGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }

                $gui = new ilTestParticipantsGUI(
                    $this->getTestObject(),
                    $this->user,
                    $this->getObjectiveOrientedContainer(),
                    $this->test_question_set_config_factory->getQuestionSetConfig(),
                    $this->access,
                    $this->test_access,
                    $this->tpl,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->ui_service,
                    $this->data_factory,
                    $this->lng,
                    $this->ctrl,
                    $this->refinery,
                    $this->db,
                    $this->tabs_manager,
                    $this->toolbar,
                    $this->component_factory,
                    $this->export_factory,
                    $this->testrequest,
                    $this->response_handler,
                    $this->participant_repository,
                    $this->results_data_factory,
                    $this->results_presentation_factory,
                    $this->test_pass_result_repository
                );

                $this->ctrl->forwardCommand($gui);

                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_PARTICIPANTS);

                break;

            case 'iltestresultsgui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();

                $gui = new ilTestResultsGUI(
                    $this->getTestObject(),
                    $this->ctrl,
                    $this->test_access,
                    $this->db,
                    $this->refinery,
                    $this->user,
                    $this->lng,
                    $this->getTestObject()->getTestlogger(),
                    $this->component_repository,
                    $this->tabs_manager,
                    $this->toolbar,
                    $this->tpl,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->skills_service,
                    $this->questionrepository,
                    $this->toplist_repository,
                    $this->testrequest,
                    $this->http,
                    $this->data_factory,
                    $this->test_session_factory->getSession(),
                    $this->getObjectiveOrientedContainer()
                );

                $this->ctrl->forwardCommand($gui);
                break;

            case "iltestplayerfixedquestionsetgui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->trackTestObjectReadEvent();
                if (!$this->getTestObject()->getKioskMode()) {
                    $this->prepareOutput();
                }
                $gui = new ilTestPlayerFixedQuestionSetGUI($this->getTestObject());
                $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
                $this->ctrl->forwardCommand($gui);
                break;

            case "iltestplayerrandomquestionsetgui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->trackTestObjectReadEvent();
                if (!$this->getTestObject()->getKioskMode()) {
                    $this->prepareOutput();
                }
                $gui = new ilTestPlayerRandomQuestionSetGUI($this->getTestObject());
                $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
                $this->ctrl->forwardCommand($gui);
                break;

            case "iltestevaluationgui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->forwardToEvaluationGUI();
                break;

            case "iltestservicegui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $serviceGUI = new ilTestServiceGUI($this->getTestObject());
                $this->ctrl->forwardCommand($serviceGUI);
                break;

            case 'ilpermissiongui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_PERMISSIONS);
                $perm_gui = new ilPermissionGUI($this);
                $ret = $this->ctrl->forwardCommand($perm_gui);
                break;

            case "illearningprogressgui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }

                $this->prepareOutput();
                $this->addHeaderAction();

                $test_session = $this->test_session_factory->getSessionByUserId($this->user->getId());
                if (!$this->checkPermissionBool('write')
                    && !$this->getTestObject()->canShowTestResults($test_session)) {
                    $this->tpl->setOnScreenMessage(
                        'info',
                        $this->lng->txt('tst_res_tab_msg_no_lp_access'),
                    );
                    break;
                }

                $this->tabs_manager->activateTab(TabsManager::TAB_ID_LEARNING_PROGRESS);
                $new_gui = new ilLearningProgressGUI(ilLearningProgressGUI::LP_CONTEXT_REPOSITORY, $this->getTestObject()->getRefId());
                $this->ctrl->forwardCommand($new_gui);

                break;

            case "ilcertificategui":
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();

                $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);

                $gui_factory = new ilCertificateGUIFactory();
                $output_gui = $gui_factory->create($this->getTestObject());

                $this->ctrl->forwardCommand($output_gui);
                break;

            case strtolower(TestScoringByQuestionGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $output_gui = new TestScoringByQuestionGUI($this->getTestObject(), $this->ui_service);
                $output_gui->setTestAccess($this->getTestAccess());
                $this->ctrl->forwardCommand($output_gui);
                break;

            case strtolower(TestScoringByParticipantGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $output_gui = new TestScoringByParticipantGUI($this->getTestObject());
                $output_gui->setTestAccess($this->getTestAccess());
                $this->ctrl->forwardCommand($output_gui);
                break;

            case strtolower(MarkSchemaGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->protectByWritePermission();

                $mark_schema_gui = new MarkSchemaGUI(
                    $this->getTestObject(),
                    $this->user,
                    $this->lng,
                    $this->ctrl,
                    $this->tpl,
                    $this->toolbar,
                    $this->getObject()->getTestLogger(),
                    $this->post_wrapper,
                    $this->request_wrapper,
                    $this->response_handler,
                    $this->request,
                    $this->refinery,
                    $this->ui_factory,
                    $this->ui_renderer
                );
                $this->ctrl->forwardCommand($mark_schema_gui);

                $this->prepareOutput();
                $this->addHeaderAction();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);
                $this->tabs_manager->activateSubTab(TabsManager::SETTINGS_SUBTAB_ID_MARK_SCHEMA);

                break;

            case strtolower(SettingsMainGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }

                $gui = new SettingsMainGUI(
                    $this->tpl,
                    $this->toolbar,
                    $this->ctrl,
                    $this->access,
                    $this->lng,
                    $this->tree,
                    $this->db,
                    $this->obj_data_cache,
                    $this->settings,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->refinery,
                    $this->request,
                    $this->component_repository,
                    $this->user,
                    $this,
                    $this->getTestObject()->getTestLogger(),
                    $this->questionrepository
                );
                $this->ctrl->forwardCommand($gui);
                $this->prepareOutput();
                $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);
                $this->tabs_manager->activateSubTab(TabsManager::SUBTAB_ID_GENERAL_SETTINGS);
                $this->addHeaderAction();
                break;

            case strtolower(SettingsScoringGUI::class):
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $gui = new SettingsScoringGUI(
                    $this->ctrl,
                    $this->access,
                    $this->lng,
                    $this->tree,
                    $this->db,
                    $this->component_repository,
                    $this,
                    $this->tpl,
                    $this->tabs_gui,
                    $this->getTestObject()->getTestLogger(),
                    $this->getTestObject()->getScoreSettingsRepository(),
                    $this->getTestObject()->getTestId(),
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->refinery,
                    $this->request,
                    $this->user
                );

                $this->ctrl->forwardCommand($gui);
                break;

            case 'iltestrandomquestionsetconfiggui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $test_process_locker_factory = (new ilTestProcessLockerFactory(
                    new ilSetting('assessment'),
                    $this->db
                ))->withContextId($this->getTestObject()->getId());
                $gui = new ilTestRandomQuestionSetConfigGUI(
                    $this->getTestObject(),
                    $this->ctrl,
                    $this->user,
                    $this->access,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->data_factory,
                    $this->tabs_manager,
                    $this->lng,
                    $this->getTestObject()->getTestlogger(),
                    $this->tpl,
                    $this->db,
                    $this->tree,
                    $this->component_repository,
                    $this->obj_definition,
                    $this->obj_data_cache,
                    $test_process_locker_factory,
                    $this->testrequest,
                    $this->title_builder,
                    $this->questionrepository
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case 'iltestquestionbrowsertablegui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $gui = new ilTestQuestionBrowserTableGUI(
                    $this->tabs_gui,
                    $this->tree,
                    $this->db,
                    $this->getTestObject()->getTestlogger(),
                    $this->component_repository,
                    $this->getTestObject(),
                    $this->user,
                    $this->access,
                    $this->http,
                    $this->refinery,
                    $this->ui_factory,
                    $this->ui_renderer,
                    $this->testrequest,
                    $this->questionrepository,
                    $this->lng,
                    $this->ctrl,
                    $this->tpl,
                    $this->ui_service,
                    $this->data_factory,
                    $this->taxonomy,
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case 'iltestskilladministrationgui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $gui = new ilTestSkillAdministrationGUI(
                    $this->ctrl,
                    $this->access,
                    $this->tabs_manager,
                    $this->tpl,
                    $this->lng,
                    $this->refinery,
                    $this->db,
                    $this->getTestObject()->getTestlogger(),
                    $this->tree,
                    $this->component_repository,
                    $this->getTestObject(),
                    $this->questionrepository,
                    $this->testrequest,
                    $this->ref_id
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case 'ilobjectcopygui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();
                $cp = new ilObjectCopyGUI($this);
                $cp->setType('tst');
                $this->ctrl->forwardCommand($cp);
                break;

            case strtolower(ilAssQuestionPreviewGUI::class):
                if (!$this->access->checkAccess('write', '', $this->getTestObject()->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }
                $this->prepareOutput();
                $this->forwardCommandToQuestionPreview($cmd);
                break;
            case 'ilassquestionpagegui':
                if ($cmd === 'finishEditing') {
                    $this->prepareOutput();
                    $this->forwardCommandToQuestionPreview(ilAssQuestionPreviewGUI::CMD_SHOW);
                    break;
                }
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                if ($cmd === 'edit' && !$this->access->checkAccess('write', '', $this->testrequest->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }
                $this->prepareOutput();
                $forwarder = new ilAssQuestionPageCommandForwarder(
                    $this->getTestObject(),
                    $this->lng,
                    $this->ctrl,
                    $this->tpl,
                    $this->questionrepository,
                    $this->testrequest
                );
                $forwarder->forward();
                break;

            case 'ilassspecfeedbackpagegui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $pg_gui = new ilAssSpecFeedbackPageGUI((int) $this->testrequest->raw("feedback_id"));
                $this->ctrl->forwardCommand($pg_gui);
                break;

            case 'ilassgenfeedbackpagegui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $pg_gui = new ilAssGenFeedbackPageGUI($this->testrequest->int("feedback_id"));
                $this->ctrl->forwardCommand($pg_gui);
                break;

            case 'illocalunitconfigurationgui':
                if ((!$this->access->checkAccess("read", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareSubGuiOutput();

                // set return target
                $question_gui = assQuestionGUI::_getQuestionGUI('', $this->fetchAuthoringQuestionIdParameter());
                $question = $question_gui->getObject();
                $question->setObjId($this->getTestObject()->getId());
                $question_gui->setObject($question);
                $question_gui->setQuestionTabs();
                $gui = new ilLocalUnitConfigurationGUI(
                    new ilUnitConfigurationRepository($this->testrequest->getQuestionId())
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case "ilcommonactiondispatchergui":
                if (!$this->access->checkAccess("read", "", $this->testrequest->getRefId()) && !$this->access->checkAccess("visible", "", $this->testrequest->getRefId())) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $gui = ilCommonActionDispatcherGUI::getInstanceFromAjaxCall();
                $this->ctrl->forwardCommand($gui);
                break;

            case 'ilassquestionhintsgui':
                if (!$this->access->checkAccess('write', '', $this->getTestObject()->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }

                if ($this->getTestObject()->evalTotalPersons() !== 0) {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('question_is_part_of_running_test'), true);
                    $this->prepareOutput();
                    $this->forwardCommandToQuestionPreview(ilAssQuestionPreviewGUI::CMD_SHOW);
                    return;
                }
                $this->prepareSubGuiOutput();

                $question_gui = assQuestionGUI::_getQuestionGUI('', $this->fetchAuthoringQuestionIdParameter());
                $question = $question_gui->getObject();
                $question->setObjId($this->getTestObject()->getId());
                $question_gui->setObject($question);
                $question_gui->setQuestionTabs();

                $this->addQuestionTitleToObjectTitle($question->getTitleForHTMLOutput());

                $gui = new ilAssQuestionHintsGUI($question_gui);

                $gui->setEditingEnabled(
                    $this->access->checkAccess('write', '', $this->getTestObject()->getRefId())
                );

                $this->ctrl->forwardCommand($gui);
                break;

            case 'ilassquestionfeedbackeditinggui':
                if (!$this->access->checkAccess('write', '', $this->getTestObject()->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }
                $this->prepareSubGuiOutput();

                // set return target
                $this->ctrl->setReturnByClass(self::class, self::SHOW_QUESTIONS_CMD);
                $question_gui = assQuestionGUI::_getQuestionGUI('', $this->fetchAuthoringQuestionIdParameter());
                $question = $question_gui->getObject();
                $question->setObjId($this->getTestObject()->getId());
                $question_gui->setObject($question);
                $question_gui->setQuestionTabs();

                $this->addQuestionTitleToObjectTitle($question->getTitleForHTMLOutput());

                if ($this->getTestObject()->evalTotalPersons() !== 0) {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('question_is_part_of_running_test'), true);
                    $this->prepareOutput();
                    $this->forwardCommandToQuestionPreview(ilAssQuestionPreviewGUI::CMD_SHOW);
                }
                $gui = new ilAssQuestionFeedbackEditingGUI(
                    $question_gui,
                    $this->ctrl,
                    $this->access,
                    $this->tpl,
                    $this->tabs_gui,
                    $this->lng,
                    $this->help,
                    $this->qplrequest,
                    $this->content_style
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case 'iltestcorrectionsgui':
                if ((!$this->access->checkAccess('read', '', $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $gui = new ilTestCorrectionsGUI(
                    $this->db,
                    $this->ctrl,
                    $this->lng,
                    $this->tabs_gui,
                    $this->help,
                    $this->ui_factory,
                    $this->tpl,
                    $this->refinery,
                    $this->getTestObject()->getTestLogger(),
                    $this->testrequest,
                    $this->getTestObject(),
                    $this->user
                );
                $this->ctrl->forwardCommand($gui);
                break;

            case 'iltestpagegui':
                if ((!$this->access->checkAccess("write", "", $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingWrite();
                }

                if ($cmd === 'downloadFile') {
                    $page_id = $this->object->getIntroductionPageId();
                    if ($this->testrequest->strVal('page_type') === 'concludingremarkspage') {
                        $page_id = $this->object->getConcludingRemarksPageId();
                    }
                    $this->ctrl->forwardCommand(new ilTestPageGUI('tst', $page_id));
                }
                $this->showEditTestPageGUI($cmd);
                break;

            case '':
            case 'ilobjtestgui':
                if (!$this->access->checkAccess('read', '', $this->testrequest->getRefId())
                    && !$this->access->checkAccess('visible', '', $this->testrequest->getRefId())) {
                    $this->redirectAfterMissingRead();
                }
                $this->prepareOutput();
                $this->addHeaderAction();

                if ($cmd === 'testScreen') {
                    $this->ctrl->forwardCommand($this->getTestScreenGUIInstance());
                    return;
                }

                $local_cmd = $cmd . 'Object';
                if (!method_exists($this, $local_cmd)) {
                    $local_cmd = self::SHOW_QUESTIONS_CMD . 'Object';
                }
                $this->$local_cmd();
                break;

            default:
                if ((!$this->access->checkAccess('read', '', $this->testrequest->getRefId()))) {
                    $this->redirectAfterMissingRead();
                }
                if (in_array(
                    $cmd,
                    ['editQuestion', 'previewQuestion', 'save', 'saveReturn',
                            'syncQuestion', 'syncQuestionReturn', 'suggestedsolution']
                )
                    && !$this->access->checkAccess('write', '', $this->getTestObject()->getRefId())) {
                    $this->redirectAfterMissingWrite();
                }
                if (in_array($cmd, ['editQuestion', 'save', 'saveReturn', 'suggestedsolution'])
                    && $this->getTestObject()->evalTotalPersons() !== 0) {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('question_is_part_of_running_test'), true);
                    $this->prepareOutput();
                    $this->forwardCommandToQuestionPreview(ilAssQuestionPreviewGUI::CMD_SHOW);
                    return;
                }
                $this->forwardCommandToQuestion($cmd);
                break;
        }
        if (!in_array(strtolower($this->testrequest->raw('baseClass')), ['iladministrationgui', 'ilrepositorygui'])
            && $this->getCreationMode() !== true) {
            $this->tpl->printToStdout();
        }
    }

Here is the call graph for this function:

exportLegacyLogsObject()

ilObjTestGUI::exportLegacyLogsObject

(

)

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

References ilUtil\deliverData(), ILIAS\Survey\Mode\getId(), getTestObject(), and protectByWritePermission().

                                            : void
    {
        $this->protectByWritePermission();

        $csv_output = $this->getTestObject()->getTestLogViewer()->getLegacyLogExportForObjId($this->getTestObject()->getId());

        ilUtil::deliverData(
            $csv_output,
            "legacy_logs_for_{$this->getTestObject()->getRefId()}.csv"
        );
    }

Here is the call graph for this function:

exportObject()

ilObjTestGUI::exportObject ( )

protected

Gateway for exports initiated from workspace, as there is a generic forward to {objTypeMainGUI}::export()

Definition at line 1259 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

    {
        $this->ctrl->redirectByClass('ilTestExportGUI');
    }

Here is the call graph for this function:

fetchAuthoringQuestionIdParameter()

ilObjTestGUI::fetchAuthoringQuestionIdParameter ( )

protected

Returns

int

Exceptions

ilTestException

Definition at line 1268 of file class.ilObjTestGUI.php.

References getTestObject().

Referenced by executeCommand(), forwardCommandToQuestion(), and forwardCommandToQuestionPreview().

                                                          : int
    {
        $qid = $this->testrequest->int('q_id');

        if ($qid === 0 || $this->getTestObject()->checkQuestionParent($qid)) {
            return $qid;
        }

        throw new ilTestException('question id does not relate to parent object!');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

forwardCommandToQuestion()

ilObjTestGUI::forwardCommandToQuestion ( string  $cmd )

protected

Definition at line 1086 of file class.ilObjTestGUI.php.

References Vendor\Package\$e, assQuestionGUI\_getQuestionGUI(), addPostCreationTasksToQuestionGUI(), addQuestionTitleToObjectTitle(), ILIAS\Repository\ctrl(), assQuestionGUI\EDIT_CONTEXT_AUTHORING, executeAfterQuestionCreationTasks(), executeAfterQuestionSaveTasks(), fetchAuthoringQuestionIdParameter(), ILIAS\Survey\Mode\getId(), getTestObject(), ILIAS\Repository\lng(), prepareOutput(), showNextViewAfterQuestionSave(), showQuestionsObject(), and ilUtil\stripSlashes().

Referenced by executeCommand().

                                                            : void
    {
        $this->create_question_mode = true;
        $this->prepareOutput();

        try {
            $qid = $this->fetchAuthoringQuestionIdParameter();

            $this->ctrl->setReturnByClass(self::class, self::SHOW_QUESTIONS_CMD);

            $question_gui = assQuestionGUI::_getQuestionGUI(
                ilUtil::stripSlashes($this->testrequest->strVal('question_type')),
                $qid
            );

            $question_gui->setEditContext(assQuestionGUI::EDIT_CONTEXT_AUTHORING);
            $question = $question_gui->getObject();
            $question->setObjId($this->getTestObject()->getId());
            $question_gui->setObject($question);
            $question_gui->setContextAllowsSyncToPool(true);
            $question_gui->setQuestionTabs();

            $this->addQuestionTitleToObjectTitle($question->getTitleForHTMLOutput());

            $target = strpos($cmd, 'Return') === false ? 'stay' : 'return';

            if (in_array($cmd, ['syncQuestion', 'syncQuestionReturn'])) {
                $question_gui->syncQuestion();
                $this->showNextViewAfterQuestionSave($question_gui, $target);
                return;
            }

            if ($question_gui->isSaveCommand()
                || $question_gui->cmdNeedsExistingQuestion($cmd)) {
                $question_gui = $this->addPostCreationTasksToQuestionGUI($question_gui);
            }

            if ($qid === 0 && $question_gui->cmdNeedsExistingQuestion($cmd)) {
                $question_gui->getObject()->createNewQuestion();
                $question_gui->setQuestionTabs();
                $this->executeAfterQuestionCreationTasks($question_gui);
            }

            if (!$question_gui->isSaveCommand()) {
                $this->ctrl->forwardCommand($question_gui);
                return;
            }

            if (!$question_gui->saveQuestion()) {
                return;
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_obj_modified'), true);
            if ($qid === 0) {
                $this->executeAfterQuestionCreationTasks($question_gui);
            }
            $this->executeAfterQuestionSaveTasks($question_gui);
            $this->showNextViewAfterQuestionSave($question_gui, $target);
        } catch (ilTestException $e) {
            $this->showQuestionsObject();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

forwardCommandToQuestionPreview()

ilObjTestGUI::forwardCommandToQuestionPreview ( string  $cmd, ?assQuestionGUI  $question_gui = null  )

protected

Definition at line 1007 of file class.ilObjTestGUI.php.

References $global_screen, $http, ilObjectGUI\$ref_id, ilObjectGUI\$refinery, addQuestionTitleToObjectTitle(), ILIAS\Repository\ctrl(), fetchAuthoringQuestionIdParameter(), ILIAS\Survey\Mode\getId(), ilObjectGUI\getRefId(), getTestObject(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), ilAssQuestionPreviewGUI\setInfoMessage(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Referenced by executeCommand(), and showNextViewAfterQuestionSave().

     : void {
        $nr_of_participants_with_results = $this->getTestObject()->evalTotalPersons();

        $this->ctrl->saveParameterByClass(self::class, 'q_id');
        $gui = new ilAssQuestionPreviewGUI(
            $this->ctrl,
            $this->rbac_system,
            $this->tabs_gui,
            $this->toolbar,
            $this->tpl,
            $this->ui_factory,
            $this->lng,
            $this->db,
            $this->refinery->random(),
            $this->global_screen,
            $this->http,
            $this->refinery,
            $this->ref_id
        );

        if ($this->getTestObject()->isRandomTest() && $nr_of_participants_with_results === 0) {
            $gui->setInfoMessage($this->lng->txt('question_is_part_of_running_test'));
        }

        if ($nr_of_participants_with_results > 0) {
            $gui->addAdditionalCmd(
                $this->lng->txt('tst_corrections_qst_form'),
                $this->ctrl->getLinkTargetByClass(ilTestCorrectionsGUI::class, 'showQuestion')
            );
        }

        $question_gui ??= assQuestion::instantiateQuestionGUI($this->fetchAuthoringQuestionIdParameter());

        $this->addQuestionTitleToObjectTitle($question_gui->getObject()->getTitleForHTMLOutput());

        if (!$this->getTestObject()->isRandomTest() && $nr_of_participants_with_results === 0) {
            $gui->setPrimaryCmd(
                $this->lng->txt('edit_question'),
                $this->ctrl->getLinkTargetByClass(
                    get_class($question_gui),
                    'editQuestion'
                )
            );
            $gui->addAdditionalCmd(
                $this->lng->txt('edit_page'),
                $this->ctrl->getLinkTargetByClass(
                    ilAssQuestionPageGUI::class,
                    'edit'
                )
            );
        }

        $gui->initQuestion($question_gui, $this->getTestObject()->getId());
        $gui->initPreviewSettings($this->getTestObject()->getRefId());
        $gui->initPreviewSession($this->user->getId(), $this->testrequest->getQuestionId());
        $gui->initHintTracking();
        $gui->initStyleSheets();

        $this->ctrl->clearParameterByClass(self::class, 'q_id');
        $this->tabs_gui->setBackTarget(
            $this->lng->txt('backtocallingtest'),
            $this->ctrl->getLinkTargetByClass(self::class, self::SHOW_QUESTIONS_CMD)
        );
        $this->ctrl->saveParameterByClass(self::class, 'q_id');
        $gui->{$cmd . 'Cmd'}();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

forwardToEvaluationGUI()

ilObjTestGUI::forwardToEvaluationGUI ( )

private

Definition at line 1338 of file class.ilObjTestGUI.php.

References ilObjectGUI\addHeaderAction(), ILIAS\Repository\ctrl(), getObjectiveOrientedContainer(), getTestAccess(), getTestObject(), and prepareOutput().

Referenced by executeCommand().

    {
        $this->prepareOutput();
        $this->addHeaderAction();
        $gui = new ilTestEvaluationGUI($this->getTestObject());
        $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
        $gui->setTestAccess($this->getTestAccess());

        $this->ctrl->forwardCommand($gui);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

forwardToInfoScreen()

ilObjTestGUI::forwardToInfoScreen ( )

private

Definition at line 2205 of file class.ilObjTestGUI.php.

References ilObjectGUI\$access, ilObjectGUI\$ctrl, $db, ilObjectGUI\$lng, ilObjectGUI\$toolbar, ilObjectGUI\$tpl, $ui_factory, $ui_renderer, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ilDatePresentation\formatDate(), ILIAS\Survey\Mode\getId(), getTestObject(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), IL_CAL_UNIX, isCommandClassAnyInfoScreenChild(), null, redirectAfterMissingRead(), ILIAS\Repository\refinery(), ilObjTest\SCORE_BEST_PASS, ilToolbarGUI\setCloseFormTag(), trackTestObjectReadEvent(), and ILIAS\Repository\user().

Referenced by executeCommand().

                                          : void
    {
        if (!$this->access->checkAccess('visible', '', $this->ref_id)
            && !$this->access->checkAccess('read', '', $this->ref_id)) {
            $this->redirectAfterMissingRead();
        }

        if ($this->getTestObject()->getMainSettings()->getAdditionalSettings()->getHideInfoTab()) {
            $this->ctrl->redirectByClass([self::class, TestScreenGUI::class], TestScreenGUI::DEFAULT_CMD);
        }

        $this->tabs_manager->activateTab(TabsManager::TAB_ID_INFOSCREEN);

        if ($this->access->checkAccess('read', '', $this->ref_id)) {
            $this->trackTestObjectReadEvent();
        }
        $info = new ilInfoScreenGUI($this);

        if ($this->isCommandClassAnyInfoScreenChild()) {
            $this->ctrl->forwardCommand($info);
        }

        $toolbar = new ilTestInfoScreenToolbarGUI(
            $this->getTestObject(),
            $this->test_player_factory->getPlayerGUI(),
            $this->test_question_set_config_factory->getQuestionSetConfig(),
            $this->test_session_factory->getSession(),
            $this->db,
            $this->access,
            $this->ctrl,
            $this->lng,
            $this->ui_factory,
            $this->ui_renderer,
            $this->tpl,
            $this->toolbar
        );

        $toolbar->setCloseFormTag(false);

        $toolbar->setSessionLockString('');
        $toolbar->build();
        $toolbar->sendMessages();

        $info->enablePrivateNotes();

        $info->addSection($this->lng->txt('tst_general_properties'));
        $info->addProperty(
            $this->lng->txt('author'),
            $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform(
                $this->getTestObject()->getAuthor()
            )
        );
        $info->addProperty(
            $this->lng->txt('title'),
            $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform(
                $this->getTestObject()->getTitle()
            )
        );

        if ($this->type !== 'tst') {
            $info->hideFurtherSections(false);
        }

        $info->addSection($this->lng->txt('tst_sequence_properties'));
        $info->addProperty(
            $this->lng->txt('tst_sequence'),
            $this->lng->txt(
                $this->getTestObject()->getMainSettings()->getParticipantFunctionalitySettings()->getPostponedQuestionsMoveToEnd()
                    ? 'tst_sequence_postpone' : 'tst_sequence_fixed'
            )
        );

        $info->addSection($this->lng->txt('tst_heading_scoring'));
        $info->addProperty(
            $this->lng->txt('tst_text_count_system'),
            $this->lng->txt(
                ($this->getTestObject()->getCountSystem() == SettingsScoring::COUNT_PARTIAL_SOLUTIONS) ? 'tst_count_partial_solutions' : 'tst_count_correct_solutions'
            )
        );
        if ($this->getTestObject()->isRandomTest()) {
            $info->addProperty($this->lng->txt('tst_pass_scoring'), $this->lng->txt(($this->getTestObject()->getPassScoring() == ilObjTest::SCORE_BEST_PASS) ? 'tst_pass_best_pass' : 'tst_pass_last_pass'));
        }

        $info->addSection($this->lng->txt('tst_score_reporting'));
        $info->addProperty(
            $this->lng->txt('tst_score_reporting'),
            $this->getTestObject()->getScoreSettings()->getResultSummarySettings()
                ->getScoreReporting()->getTranslatedValue($this->lng)
        );
        $reporting_date = $this->getTestObject()
            ->getScoreSettings()
            ->getResultSummarySettings()
            ->getReportingDate();
        if ($reporting_date !== null) {
            $info->addProperty(
                $this->lng->txt('tst_score_reporting_date'),
                $reporting_date
                    ->setTimezone(new DateTimeZone($this->user->getTimeZone()))
                    ->format($this->user->getDateTimeFormat()->toString())
            );
        }

        $info->addSection($this->lng->txt('tst_session_settings'));
        $info->addProperty($this->lng->txt('tst_nr_of_tries'), $this->getTestObject()->getNrOfTries() === 0 ? $this->lng->txt('unlimited') : (string) $this->getTestObject()->getNrOfTries());
        if ($this->getTestObject()->getNrOfTries() != 1) {
            $info->addProperty(
                $this->lng->txt('tst_nr_of_tries_of_user'),
                ($this->test_session_factory->getSession()->getPass() === 0) ?
                    $this->lng->txt('tst_no_tries') : (string) $this->test_session_factory->getSession()->getPass()
            );
        }

        if ($this->getTestObject()->getEnableProcessingTime()) {
            $info->addProperty($this->lng->txt('tst_processing_time'), $this->getTestObject()->getProcessingTime());
        }

        $starting_time = $this->getTestObject()->getStartingTime();
        if ($this->getTestObject()->isStartingTimeEnabled() && $starting_time !== 0) {
            $info->addProperty($this->lng->txt('tst_starting_time'), ilDatePresentation::formatDate(new ilDateTime($starting_time, IL_CAL_UNIX)));
        }
        $ending_time = $this->getTestObject()->getEndingTime();
        if ($this->getTestObject()->isEndingTimeEnabled() && $ending_time != 0) {
            $info->addProperty($this->lng->txt('tst_ending_time'), ilDatePresentation::formatDate(new ilDateTime($ending_time, IL_CAL_UNIX)));
        }
        $info->addMetaDataSections($this->getTestObject()->getId(), 0, $this->getTestObject()->getType());

        $this->ctrl->forwardCommand($info);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

fullscreenObject()

ilObjTestGUI::fullscreenObject

(

)

show fullscreen view

Definition at line 1603 of file class.ilObjTestGUI.php.

References ilPageObjectGUI\showMediaFullscreen().

    {
        $page_gui = new ilAssQuestionPageGUI($this->testrequest->raw("pg_id"));
        $page_gui->showMediaFullscreen();
    }

Here is the call graph for this function:

getObjectiveOrientedContainer()

ilObjTestGUI::getObjectiveOrientedContainer ( )

protected

Definition at line 2730 of file class.ilObjTestGUI.php.

References $objective_oriented_container.

Referenced by executeCommand(), forwardToEvaluationGUI(), and getTabs().

                                                      : ilTestObjectiveOrientedContainer
    {
        return $this->objective_oriented_container;
    }

Here is the caller graph for this function:

getQuestionsTableActions()

ilObjTestGUI::getQuestionsTableActions ( )

protected

Definition at line 2770 of file class.ilObjTestGUI.php.

References $table_actions, ILIAS\Repository\ctrl(), getQuestionsTableQuery(), getTestObject(), ILIAS\Repository\lng(), null, ILIAS\Repository\refinery(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Referenced by getTable(), and showQuestionsObject().

                                                 : QuestionsTableActions
    {
        if ($this->table_actions === null) {
            $this->table_actions = new QuestionsTableActions(
                $this->ui_factory,
                $this->ui_renderer,
                $this->tpl,
                $this->request,
                $this->getQuestionsTableQuery(),
                $this->lng,
                $this->ctrl,
                $this->test_questions_repository,
                new QuestionPrinter(
                    $this->ui_factory,
                    $this->tpl,
                    $this->tabs_manager,
                    $this->toolbar,
                    $this->refinery,
                    $this->lng,
                    $this->ctrl,
                    $this->user,
                    new \ilTestQuestionHeaderBlockBuilder($this->lng),
                    $this->getTestObject()
                ),
                $this->object,
                $this->getTestObject()->getGlobalSettings()->isAdjustingQuestionsWithResultsAllowed(),
                $this->getTestObject()->evalTotalPersons() !== 0,
                $this->getTestObject()->isRandomTest(),
                $this->test_question_set_config_factory
            );
        }
        return $this->table_actions;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsTableQuery()

ilObjTestGUI::getQuestionsTableQuery ( )

protected

Definition at line 2756 of file class.ilObjTestGUI.php.

References ilObjectGUI\$id, $table_query, ILIAS\FileDelivery\http(), null, and ILIAS\Repository\refinery().

Referenced by getQuestionsTableActions(), getTargetQuestionpoolForm(), and showQuestionsObject().

                                               : QuestionsTableQuery
    {
        if ($this->table_query === null) {
            $id = $this->object ? $this->object->getId() : '';
            $this->table_query = new QuestionsTableQuery(
                $this->http,
                $this->refinery,
                $this->data_factory,
                ['qlist', $id]
            );
        }
        return $this->table_query;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSelectedPersonalDefaultsSettingsFromForm()

ilObjTestGUI::getSelectedPersonalDefaultsSettingsFromForm ( )

private

Definition at line 1488 of file class.ilObjTestGUI.php.

References ilObjectGUI\$data, ilObjectGUI\initCreateForm(), null, and ilObjectGUI\parseDidacticTemplateVar().

Referenced by afterSave().

                                                                  : ?int
    {
        $data = $this->initCreateForm($this->type)
            ->withRequest($this->request)
            ->getData();
        return isset($data['didactic_templates'])
            ? $this->parseDidacticTemplateVar($data['didactic_templates'], 'tstdef')
            : null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTable()

ilObjTestGUI::getTable ( )

protected

Definition at line 2804 of file class.ilObjTestGUI.php.

References ilObjectGUI\$lng, ilObjectGUI\$object, $test_questions_repository, $title_builder, getQuestionsTableActions(), ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by showQuestionsObject().

                                 : QuestionsTable
    {
        return new QuestionsTable(
            $this->ui_factory,
            $this->refinery,
            $this->http->request(),
            $this->getQuestionsTableActions(),
            $this->lng,
            $this->object,
            $this->test_questions_repository,
            $this->title_builder
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTabs()

ilObjTestGUI::getTabs

(

)

adds tabs to tab gui object

Parameters

ilTabsGUI

$tabs_gui

Definition at line 2436 of file class.ilObjTestGUI.php.

References $DIC, getObjectiveOrientedContainer(), ilObjectGUI\getRefId(), ILIAS\Repository\help(), ILIAS\Repository\lng(), and null.

                             : void
    {
        $this->help->setScreenIdComponent("tst");

        if ($this->tabs_manager === null) {
            return;
        }

        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
            $courseLink = ilLink::_getLink($this->getObjectiveOrientedContainer()->getRefId());
            $this->tabs_manager->setParentBackLabel($this->lng->txt('back_to_objective_container'));
            $this->tabs_manager->setParentBackHref($courseLink);
        }

        $this->tabs_manager->perform();
    }

Here is the call graph for this function:

getTargetQuestionpoolForm()

ilObjTestGUI::getTargetQuestionpoolForm (   $questionpools, string  $cmd  )

protected

Definition at line 2651 of file class.ilObjTestGUI.php.

References ilObjectGUI\$id, $table_query, ILIAS\Repository\ctrl(), getQuestionsTableQuery(), ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getRowIds(), ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getTableAction(), ILIAS\Repository\lng(), null, ilFormPropertyGUI\setRequired(), and ilFormPropertyGUI\setTitle().

Referenced by createQuestionpoolTargetObject().

                                                                             : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->addCommandButton($cmd, $this->lng->txt('submit'));
        $form->addCommandButton('cancelCreateQuestion', $this->lng->txt('cancel'));

        if (count($questionpools) == 0) {
            $form->setTitle($this->lng->txt("tst_enter_questionpool"));

            $title = new ilTextInputGUI($this->lng->txt('title'), 'title');
            $title->setRequired(true);
            $form->addItem($title);

            $description = new ilTextAreaInputGUI($this->lng->txt('description'), 'description');
            $form->addItem($description);
        } else {
            $form->setTitle($this->lng->txt("tst_select_questionpool"));

            $selectOptions = [
                '' => $this->lng->txt('please_select')
            ];

            foreach ($questionpools as $key => $value) {
                $selectOptions[$key] = $value["title"];
            }

            $select = new ilSelectInputGUI($this->lng->txt('tst_source_question_pool'), 'sel_qpl');
            $select->setRequired(true);
            $select->setOptions($selectOptions);

            $form->addItem($select);
        }

        $table_query = $this->getQuestionsTableQuery();
        if ($table_query->getTableAction() !== null) {
            $question_ids = $table_query->getRowIds($this->object);
        } elseif ($this->testrequest->isset('q_id') && is_array($this->testrequest->raw('q_id'))) {
            $question_ids = $this->testrequest->raw('q_id');
        }

        foreach ($question_ids as $id) {
            $hidden = new ilHiddenInputGUI('q_id[]');
            $hidden->setValue((string) $id);
            $form->addItem($hidden);
        }

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTestAccess()

ilObjTestGUI::getTestAccess

(

)

Definition at line 1328 of file class.ilObjTestGUI.php.

References $test_access.

Referenced by executeCommand(), and forwardToEvaluationGUI().

                                   : ilTestAccess
    {
        return $this->test_access;
    }

Here is the caller graph for this function:

getTestObject()

ilObjTestGUI::getTestObject

(

)

Definition at line 1504 of file class.ilObjTestGUI.php.

References ilObjectGUI\$object.

Referenced by addDefaultsObject(), addLocatorItems(), addQuestion(), applyDefaultsObject(), backToRepositoryObject(), buildInputEditingType(), buildQuestionCreationForm(), certificateObject(), createQuestionPool(), createQuestionpoolTargetObject(), defaultsObject(), deleteDefaultsObject(), executeAfterQuestionCreationTasks(), executeAfterQuestionSaveTasks(), executeCommand(), exportLegacyLogsObject(), fetchAuthoringQuestionIdParameter(), forwardCommandToQuestion(), forwardCommandToQuestionPreview(), forwardToEvaluationGUI(), forwardToInfoScreen(), getQuestionsTableActions(), getTestScreenGUIInstance(), historyObject(), insertQuestionsObject(), prepareOutput(), questionsTabGatewayObject(), removeImportFailsObject(), setupToolBarAndMessage(), showEditTestPageGUI(), showQuestionsObject(), and trackTestObjectReadEvent().

                                   : ?ilObjTest
    {
        return $this->object;
    }

Here is the caller graph for this function:

getTestScreenGUIInstance()

ilObjTestGUI::getTestScreenGUIInstance ( )

private

Definition at line 2735 of file class.ilObjTestGUI.php.

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), getTestObject(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\Repository\user().

Referenced by executeCommand().

                                               : TestScreenGUI
    {
        return new TestScreenGUI(
            $this->getTestObject(),
            $this->user,
            $this->ui_factory,
            $this->ui_renderer,
            $this->lng,
            $this->refinery,
            $this->ctrl,
            $this->tpl,
            $this->content_style,
            $this->http,
            $this->tabs_manager,
            $this->access,
            $this->test_access,
            $this->db,
            $this->rbac_system
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

historyObject()

ilObjTestGUI::historyObject

(

)

Definition at line 1963 of file class.ilObjTestGUI.php.

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ilObjectGUI\getRefId(), getTestObject(), ILIAS\Repository\lng(), redirectAfterMissingWrite(), SYSTEM_ROLE_ID, and ILIAS\Repository\toolbar().

                                   : void
    {
        if (!$this->getTestObject()->getTestLogger()->isLoggingEnabled()
            || !$this->rbac_review->isAssigned($this->user->getId(), SYSTEM_ROLE_ID)
                && !$this->access->checkAccess('tst_history_read', '', $this->getTestObject()->getRefId())) {
            $this->redirectAfterMissingWrite();
        }

        $here_uri = $this->data_factory->uri(ILIAS_HTTP_PATH
            . '/' . $this->ctrl->getLinkTargetByClass(self::class, self::SHOW_LOGS_CMD));
        list($url_builder, $action_parameter_token, $row_id_token) = (new URLBuilder($here_uri))->acquireParameters(
            LogTable::QUERY_PARAMETER_NAME_SPACE,
            LogTable::ACTION_TOKEN_STRING,
            LogTable::ENTRY_TOKEN_STRING
        );

        if ($this->request_wrapper->has($action_parameter_token->getName())) {
            $this->getTestObject()->getTestLogViewer()->executeLogTableAction(
                $url_builder,
                $action_parameter_token,
                $row_id_token,
                $this->getTestObject()->getRefId()
            );
        }

        $this->toolbar->addComponent(
            $this->ui_factory->button()->standard(
                $this->lng->txt('export_legacy_logs'),
                $this->ctrl->getLinkTargetByClass(self::class, 'exportLegacyLogs')
            )
        );
        $this->tabs_manager->activateTab(TabsManager::TAB_ID_HISTORY);

        list($filter, $table_gui) = $this->getTestObject()->getTestLogViewer()->getLogTable(
            $url_builder,
            $action_parameter_token,
            $row_id_token,
            $this->getTestObject()->getRefId()
        );

        $this->tpl->setVariable('ADM_CONTENT', $this->ui_renderer->render([$filter, $table_gui]));
    }

Here is the call graph for this function:

importFile()

ilObjTestGUI::importFile ( string  $file_to_import, string  $path_to_uploaded_file_in_temp_dir  )

protected

Definition at line 1366 of file class.ilObjTestGUI.php.

References ILIAS\TestQuestionPool\Import\buildImportDirectoriesFromImportFile(), ILIAS\TestQuestionPool\Import\buildImportQuestionsSelectionForm(), ILIAS\TestQuestionPool\Import\buildResultsFilePath(), ilFileUtils\delDir(), ilObjectGUI\deleteUploadedImportFile(), exit, ILIAS\TestQuestionPool\Import\getImportTempDirectory(), ilQTIParser\IL_MO_VERIFY_QTI, importVerifiedFileObject(), ILIAS\Repository\lng(), null, ilObjTest\QUESTION_SET_TYPE_FIXED, and ilSession\set().

                                                                                                    : void
    {
        list($subdir, $importdir, $xmlfile, $qtifile) = $this->buildImportDirectoriesFromImportFile($file_to_import);

        $options = (new ILIAS\Filesystem\Util\Archive\UnzipOptions())
            ->withZipOutputPath($this->getImportTempDirectory());

        $unzip = $this->archives->unzip(Streams::ofResource(fopen($file_to_import, 'r')), $options);
        $unzip->extract();

        if (!is_file($qtifile)) {
            ilFileUtils::delDir($importdir);
            $this->deleteUploadedImportFile($path_to_uploaded_file_in_temp_dir);
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('tst_import_non_ilias_zip'), true);
        }
        $qtiParser = new ilQTIParser($importdir, $qtifile, ilQTIParser::IL_MO_VERIFY_QTI, 0, []);
        $qtiParser->startParsing();
        $founditems = $qtiParser->getFoundItems();

        $complete = 0;
        $incomplete = 0;
        foreach ($founditems as $item) {
            if ($item["type"] !== '') {
                $complete++;
            } else {
                $incomplete++;
            }
        }

        if (count($founditems) && $complete == 0) {
            ilFileUtils::delDir($importdir);
            $this->deleteUploadedImportFile($path_to_uploaded_file_in_temp_dir);
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('qpl_import_non_ilias_files'));
            return;
        }

        ilSession::set('path_to_import_file', $file_to_import);
        ilSession::set('path_to_uploaded_file_in_temp_dir', $path_to_uploaded_file_in_temp_dir);

        if ($qtiParser->getQuestionSetType() !== ilObjTest::QUESTION_SET_TYPE_FIXED
            || file_exists($this->buildResultsFilePath($importdir, $subdir))) {
            $this->importVerifiedFileObject(true);
            return;
        }

        $form = $this->buildImportQuestionsSelectionForm(
            'importVerifiedFile',
            $importdir,
            $qtifile,
            $file_to_import,
            $path_to_uploaded_file_in_temp_dir
        );

        if ($form === null) {
            return;
        }

        $panel = $this->ui_factory->panel()->standard(
            $this->lng->txt('import_tst'),
            [
                $this->ui_factory->legacy()->content($this->lng->txt('qpl_import_verify_found_questions')),
                $form
            ]
        );
        $this->tpl->setContent($this->ui_renderer->render($panel));
        $this->tpl->printToStdout();
        exit;
    }

Here is the call graph for this function:

importVerifiedFileObject()

ilObjTestGUI::importVerifiedFileObject

(

bool

$skip_retrieve_selected_questions = false

)

imports question(s) into the questionpool (after verification)

2025-03-22, sk: This is now only needed for legacy exports as now also exports with results do contain a manifest.xml.

Definition at line 1512 of file class.ilObjTestGUI.php.

References ILIAS\TestQuestionPool\Import\buildImportDirectoriesFromImportFile(), ilObjectGUI\checkPermissionBool(), ilSession\clear(), ILIAS\Repository\ctrl(), ilFileUtils\delDir(), ilObjectGUI\deleteUploadedImportFile(), ilSession\get(), ilImport\getMapping(), IL_INST_ID, ilImport\importObject(), ILIAS\Repository\lng(), redirectAfterMissingWrite(), ILIAS\TestQuestionPool\Import\retrieveSelectedQuestionsFromImportQuestionsSelectionForm(), ilSession\set(), and ILIAS\Repository\user().

Referenced by importFile().

     : void {
        if (!$this->checkPermissionBool('create', '', $this->testrequest->strVal('new_type'))) {
            $this->redirectAfterMissingWrite();
        }
        $file_to_import = ilSession::get('path_to_import_file');
        $path_to_uploaded_file_in_temp_dir = ilSession::get('path_to_uploaded_file_in_temp_dir');
        list($subdir, $importdir, $xmlfile, $qtifile) = $this->buildImportDirectoriesFromImportFile($file_to_import);

        $new_obj = new ilObjTest(0, true);
        $new_obj->setTitle('dummy');
        $new_obj->setDescription('test import');
        $new_obj->create(true);
        $new_obj->createReference();
        $new_obj->putInTree($this->testrequest->getRefId());
        $new_obj->setPermissions($this->testrequest->getRefId());
        $new_obj->saveToDb();

        $selected_questions = [];
        if (!$skip_retrieve_selected_questions) {
            $selected_questions = $this->retrieveSelectedQuestionsFromImportQuestionsSelectionForm(
                'importVerifiedFile',
                $importdir,
                $qtifile,
                $this->request
            );
        }

        ilSession::set('tst_import_selected_questions', $selected_questions);

        $imp = new ilImport($this->testrequest->getRefId());
        $map = $imp->getMapping();
        $map->addMapping('components/ILIAS/Test', 'tst', 'new_id', (string) $new_obj->getId());

        if (is_file($importdir . DIRECTORY_SEPARATOR . '/manifest.xml')) {
            $imp->importObject($new_obj, $file_to_import, basename($file_to_import), 'tst', 'components/ILIAS/Test', true);
        } else {
            $test_importer = new ilTestImporter();
            $test_importer->setImport($imp);
            $test_importer->setInstallId(IL_INST_ID);
            $test_importer->setImportDirectory($importdir . '/' . $subdir);
            $test_importer->init();

            $test_importer->importXmlRepresentation(
                '',
                '',
                '',
                $map,
            );
        }

        if ($new_obj->getTestLogger()->isLoggingEnabled()) {
            $new_obj->getTestLogger()->logTestAdministrationInteraction(
                $new_obj->getTestLogger()->getInteractionFactory()->buildTestAdministrationInteraction(
                    $new_obj->getRefId(),
                    $this->user->getId(),
                    TestAdministrationInteractionTypes::NEW_TEST_CREATED,
                    []
                )
            );
        }

        ilFileUtils::delDir($importdir);
        $this->deleteUploadedImportFile($path_to_uploaded_file_in_temp_dir);
        ilSession::clear('path_to_import_file');
        ilSession::clear('path_to_uploaded_file_in_temp_dir');

        $this->tpl->setOnScreenMessage('success', $this->lng->txt("object_imported"), true);
        $this->ctrl->setParameterByClass(ilObjTestGUI::class, 'ref_id', $new_obj->getRefId());
        $this->ctrl->redirectByClass(ilObjTestGUI::class);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

infoScreenObject()

ilObjTestGUI::infoScreenObject ( )

private

Definition at line 2198 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

                                       : void
    {
        $this->ctrl->redirectByClass(
            [ilRepositoryGUI::class, self::class, ilInfoScreenGUI::class]
        );
    }

Here is the call graph for this function:

insertQuestionsObject()

ilObjTestGUI::insertQuestionsObject ( ?array  $selected_array = null )

private

Definition at line 1688 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), getTestObject(), ILIAS\Repository\lng(), and protectByWritePermission().

Referenced by addQuestion().

                                                                         : void
    {
        $this->protectByWritePermission();

        if (($selected_array ?? $this->testrequest->getQuestionIds()) === []) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_insert_missing_question'), true);
            $this->ctrl->redirect($this, 'browseForQuestions');
        }

        $this->getTestObject()->saveCompleteStatus($this->test_question_set_config_factory->getQuestionSetConfig());
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('tst_questions_inserted'), true);
        $this->ctrl->redirect($this, self::SHOW_QUESTIONS_CMD);
        return;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isCommandClassAnyInfoScreenChild()

ilObjTestGUI::isCommandClassAnyInfoScreenChild ( )

private

Definition at line 2189 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

Referenced by forwardToInfoScreen().

                                                       : bool
    {
        if (in_array($this->ctrl->getCmdClass(), self::INFO_SCREEN_CHILD_CLASSES)) {
            return true;
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

participantsActionObject()

ilObjTestGUI::participantsActionObject

(

)

Evaluates the actions on the participants page.

Definition at line 2021 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

                                              : void
    {
        $command = $this->testrequest->strVal('command');
        if ($command === '') {
            $method = $command . 'Object';
            if (method_exists($this, $method)) {
                $this->$method();
                return;
            }
        }
        $this->ctrl->redirect($this, 'participants');
    }

Here is the call graph for this function:

populateQuestionBrowserToolbarButtons()

ilObjTestGUI::populateQuestionBrowserToolbarButtons ( ilToolbarGUI  $toolbar )

private

Definition at line 1928 of file class.ilObjTestGUI.php.

References ilToolbarGUI\addButton(), ilTestQuestionBrowserTableGUI\CMD_BROWSE_QUESTIONS, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilTestQuestionBrowserTableGUI\MODE_BROWSE_POOLS, ilTestQuestionBrowserTableGUI\MODE_BROWSE_TESTS, and ilTestQuestionBrowserTableGUI\MODE_PARAMETER.

Referenced by setupToolBarAndMessage().

                                                                                 : void
    {
        $this->ctrl->setParameterByClass(
            ilTestQuestionBrowserTableGUI::class,
            ilTestQuestionBrowserTableGUI::MODE_PARAMETER,
            ilTestQuestionBrowserTableGUI::MODE_BROWSE_POOLS
        );

        $toolbar->addButton(
            $this->lng->txt('tst_browse_for_qpl_questions'),
            $this->ctrl->getLinkTargetByClass(
                ilTestQuestionBrowserTableGUI::class,
                ilTestQuestionBrowserTableGUI::CMD_BROWSE_QUESTIONS
            )
        );

        $this->ctrl->setParameterByClass(
            ilTestQuestionBrowserTableGUI::class,
            ilTestQuestionBrowserTableGUI::MODE_PARAMETER,
            ilTestQuestionBrowserTableGUI::MODE_BROWSE_TESTS
        );

        $toolbar->addButton(
            $this->lng->txt('tst_browse_for_tst_questions'),
            $this->ctrl->getLinkTargetByClass(
                ilTestQuestionBrowserTableGUI::class,
                ilTestQuestionBrowserTableGUI::CMD_BROWSE_QUESTIONS
            )
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

prepareOutput()

ilObjTestGUI::prepareOutput

(

bool

$show_subobjects = true

)

Definition at line 1288 of file class.ilObjTestGUI.php.

References ilObjectGUI\$settings, ilObjectGUI\getCreationMode(), ilMemberViewSettings\getInstance(), ilObjectGUI\getRefId(), and getTestObject().

Referenced by executeCommand(), forwardCommandToQuestion(), forwardToEvaluationGUI(), and showEditTestPageGUI().

                                                               : bool
    {
        if (!$this->getCreationMode()) {
            $settings = ilMemberViewSettings::getInstance();
            if ($settings->isActive() && $settings->getContainer() != $this->getTestObject()->getRefId()) {
                $settings->setContainer($this->getTestObject()->getRefId());
                $this->rbac_system->initMemberView();
            }
        }
        return parent::prepareOutput($show_subobjects);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

prepareSubGuiOutput()

ilObjTestGUI::prepareSubGuiOutput ( )

private

Definition at line 1354 of file class.ilObjTestGUI.php.

References ilObjectGUI\setLocator(), and ilObjectGUI\setTitleAndDescription().

Referenced by executeCommand().

    {
        $this->tpl->loadStandardTemplate();
        $this->setLocator();
        $this->setTitleAndDescription();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

protectByWritePermission()

ilObjTestGUI::protectByWritePermission ( )

protected

Definition at line 2701 of file class.ilObjTestGUI.php.

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by addDefaultsObject(), applyDefaultsObject(), confirmedApplyDefaultsObject(), createQuestionFormObject(), createQuestionPool(), createQuestionpoolTargetObject(), defaultsObject(), deleteDefaultsObject(), executeCommand(), exportLegacyLogsObject(), insertQuestionsObject(), and showQuestionsObject().

                                                 : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('cannot_edit_test'), true);
            $this->ctrl->redirectByClass([ilRepositoryGUI::class, self::class, ilInfoScreenGUI::class]);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

questionsTabGatewayObject()

ilObjTestGUI::questionsTabGatewayObject ( )

private

Definition at line 1279 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), and getTestObject().

    {
        if ($this->getTestObject()->isRandomTest()) {
            $this->ctrl->redirectByClass('ilTestRandomQuestionSetConfigGUI');
        }

        $this->ctrl->redirectByClass('ilObjTestGUI', self::SHOW_QUESTIONS_CMD);
    }

Here is the call graph for this function:

redirectAfterMissingRead()

ilObjTestGUI::redirectAfterMissingRead ( )

protected

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

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ROOT_FOLDER_ID.

Referenced by executeCommand(), and forwardToInfoScreen().

                                                 : void
    {
        $this->tpl->setOnScreenMessage('failure', sprintf(
            $this->lng->txt("msg_no_perm_read_item"),
            $this->object->getTitle()
        ), true);
        $this->ctrl->setParameterByClass('ilrepositorygui', 'ref_id', ROOT_FOLDER_ID);
        $this->ctrl->redirectByClass('ilrepositorygui');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

redirectAfterMissingWrite()

ilObjTestGUI::redirectAfterMissingWrite ( )

protected

Definition at line 989 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by createQuestionPoolAndCopyObject(), executeCommand(), historyObject(), and importVerifiedFileObject().

    {
        $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_permission"), true);
        $target_class = get_class($this->object) . "GUI";
        $this->ctrl->setParameterByClass($target_class, 'ref_id', $this->ref_id);
        $this->ctrl->redirectByClass($target_class);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

redirectTo_SettingsMainGUI_showForm_Object()

ilObjTestGUI::redirectTo_SettingsMainGUI_showForm_Object ( )

private

Definition at line 1349 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

    {
        $this->ctrl->redirectByClass(SettingsMainGUI::class, SettingsMainGUI::CMD_SHOW_FORM);
    }

Here is the call graph for this function:

removeImportFailsObject()

ilObjTestGUI::removeImportFailsObject ( )

protected

Definition at line 2334 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Survey\Mode\getId(), and getTestObject().

    {
        $qsaImportFails = new ilAssQuestionSkillAssignmentImportFails($this->getTestObject()->getId());
        $qsaImportFails->deleteRegisteredImportFails();
        $sltImportFails = new ilTestSkillLevelThresholdImportFails($this->getTestObject()->getId());
        $sltImportFails->deleteRegisteredImportFails();

        $this->ctrl->redirectByClass([ilRepositoryGUI::class, self::class, ilInfoScreenGUI::class]);
    }

Here is the call graph for this function:

retrieveAdditionalDidacticTemplateOptions()

ilObjTestGUI::retrieveAdditionalDidacticTemplateOptions

(

)

Definition at line 1435 of file class.ilObjTestGUI.php.

References ILIAS\Repository\lng().

                                                               : array
    {
        $tst = new ilObjTest();
        $defaults = $tst->getAvailableDefaults();
        if ($defaults === []) {
            return [];
        }

        $additional_options = [];
        foreach ($defaults as $row) {
            $additional_options["tstdef_" . $row["test_defaults_id"]] = [$row["name"],
                $this->lng->txt("tst_default_settings")];
        }
        return $additional_options;
    }

Here is the call graph for this function:

runObject()

ilObjTestGUI::runObject

(

)

Definition at line 1361 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl().

Referenced by ilObjTestGUITest\testRunObject().

    {
        $this->ctrl->redirectByClass([ilRepositoryGUI::class, self::class, ilInfoScreenGUI::class]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setTestAccess()

ilObjTestGUI::setTestAccess

(

ilTestAccess

$test_access

)

Definition at line 1333 of file class.ilObjTestGUI.php.

References $test_access.

    {
        $this->test_access = $test_access;
    }

setupToolBarAndMessage()

ilObjTestGUI::setupToolBarAndMessage ( bool  $has_started_test_runs )

private

Definition at line 1899 of file class.ilObjTestGUI.php.

References $message, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), getTestObject(), ILIAS\Repository\lng(), populateQuestionBrowserToolbarButtons(), and ILIAS\Repository\toolbar().

Referenced by showQuestionsObject().

                                                                        : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)
            || $this->getTestObject()->isRandomTest()) {
            return;
        }

        if ($has_started_test_runs) {
            $link = $this->ui_factory->link()->standard(
                $this->lng->txt('test_has_datasets_warning_page_view_link'),
                $this->ctrl->getLinkTargetByClass([\ilTestParticipantsGUI::class])
            );

            $message = $this->lng->txt('test_has_datasets_warning_page_view');
            $massage_box = $this->ui_factory->messageBox()->info($message)->withLinks([$link]);
            $this->tpl->setCurrentBlock('mess');
            $this->tpl->setVariable(
                'MESSAGE',
                $this->ui_renderer->render($massage_box)
            );
            $this->tpl->parseCurrentBlock();
            return;
        }

        $this->toolbar->addButton($this->lng->txt('ass_create_question'), $this->ctrl->getLinkTarget($this, 'createQuestionForm'));
        $this->toolbar->addSeparator();
        $this->populateQuestionBrowserToolbarButtons($this->toolbar);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showEditTestPageGUI()

ilObjTestGUI::showEditTestPageGUI ( string  $cmd )

private

Definition at line 1300 of file class.ilObjTestGUI.php.

References ILIAS\Repository\ctrl(), getTestObject(), prepareOutput(), and ILIAS\Repository\refinery().

Referenced by executeCommand().

                                                     : void
    {
        $this->prepareOutput();
        $this->tabs_manager->getSettingsSubTabs();

        if ($this->request_wrapper->has('page_type')
            && $this->request_wrapper->retrieve(
                'page_type',
                $this->refinery->kindlyTo()->string()
            ) === 'introductionpage'
        ) {
            $page_type = 'IntroductionPage';
            $this->tabs_manager->activateSubTab(TabsManager::SETTINGS_SUBTAB_ID_EDIT_INTRODUCTION_PAGE);
            $page_id = $this->getTestObject()->getIntroductionPageId();
        } else {
            $page_type = 'ConcludingRemarksPage';
            $this->tabs_manager->activateSubTab(TabsManager::SETTINGS_SUBTAB_ID_EDIT_CONCLUSION_PAGE);
            $page_id = $this->getTestObject()->getConcludingRemarksPageId();
        }
        $this->ctrl->saveParameterByClass(ilTestPageGUI::class, 'page_type');

        $gui = new ilTestPageGUI('tst', $page_id);
        $this->content_style->gui()->addCss($this->tpl, $this->ref_id);
        $this->tpl->setContent($this->ctrl->forwardCommand($gui));

        $this->tabs_manager->activateTab(TabsManager::TAB_ID_SETTINGS);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showNextViewAfterQuestionSave()

ilObjTestGUI::showNextViewAfterQuestionSave ( assQuestionGUI  $question_gui, string  $target  )

private

Definition at line 1223 of file class.ilObjTestGUI.php.

References ilAssQuestionPreviewGUI\CMD_SHOW, ILIAS\Repository\ctrl(), assQuestionGUI\editQuestion(), forwardCommandToQuestionPreview(), assQuestionGUI\getObject(), and ILIAS\Repository\lng().

Referenced by forwardCommandToQuestion().

                                                                                                : void
    {
        if ($target === 'return') {
            $this->forwardCommandToQuestionPreview(
                ilAssQuestionPreviewGUI::CMD_SHOW,
                $question_gui
            );
        }

        if ($target === 'stay') {
            $this->ctrl->setParameterByClass(ilAssQuestionPreviewGUI::class, 'q_id', $question_gui->getObject()->getId());
            $this->tabs_gui->setBackTarget(
                $this->lng->txt('backtocallingpage'),
                $this->ctrl->getLinkTargetByClass(
                    ilAssQuestionPreviewGUI::class,
                    ilAssQuestionPreviewGUI::CMD_SHOW
                )
            );
            $question_gui->editQuestion(false, false);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionsObject()

ilObjTestGUI::showQuestionsObject

(

)

Definition at line 1845 of file class.ilObjTestGUI.php.

References $table_query, addQuestion(), createQuestionpoolTargetObject(), ILIAS\Repository\ctrl(), getQuestionsTableActions(), getQuestionsTableQuery(), ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getRowIds(), getTable(), ILIAS\Test\Questions\Presentation\QuestionsTableQuery\getTableAction(), getTestObject(), null, protectByWritePermission(), and setupToolBarAndMessage().

Referenced by addQuestion(), copyAndLinkQuestionsToPoolObject(), and forwardCommandToQuestion().

    {
        $this->protectByWritePermission();

        if ($this->testrequest->raw('add')) {
            $this->addQuestion();
            return;
        }

        $table_query = $this->getQuestionsTableQuery();
        if (($table_cmd = $table_query->getTableAction()) !== null) {
            if (!$this->getQuestionsTableActions()->handleCommand(
                $table_cmd,
                $table_query->getRowIds($this->object),
                fn() => $this->protectByWritePermission(),
                fn() => $this->createQuestionpoolTargetObject('copyAndLinkQuestionsToPool'),
                fn() => $this->getTable()
            )) {
                return;
            }
        }

        $this->tpl->addBlockFile('ADM_CONTENT', 'adm_content', 'tpl.il_as_tst_questions.html', 'components/ILIAS/Test');

        $this->setupToolBarAndMessage($this->getTestObject()->evalTotalPersons() !== 0);

        $this->tabs_manager->getQuestionsSubTabs();
        $this->tabs_manager->activateSubTab(TabsManager::SUBTAB_ID_QST_LIST_VIEW);

        $this->tpl->setCurrentBlock('adm_content');
        $this->tpl->setVariable('ACTION_QUESTION_FORM', $this->ctrl->getFormAction($this));
        $this->tpl->setVariable(
            'QUESTIONBROWSER',
            $this->ui_renderer->render(
                $this->getTable()->getTableComponent()
            )
        );
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

statisticsObject()

ilObjTestGUI::statisticsObject

(

)

Definition at line 2414 of file class.ilObjTestGUI.php.

    {
    }

takenObject()

ilObjTestGUI::takenObject

(

)

Definition at line 1959 of file class.ilObjTestGUI.php.

                                 : void
    {
    }

trackTestObjectReadEvent()

ilObjTestGUI::trackTestObjectReadEvent ( )

protected

Definition at line 1245 of file class.ilObjTestGUI.php.

References ilChangeEvent\_recordReadEvent(), ILIAS\Survey\Mode\getId(), ilObjectGUI\getRefId(), getTestObject(), and ILIAS\Repository\user().

Referenced by executeCommand(), and forwardToInfoScreen().

    {
        ilChangeEvent::_recordReadEvent(
            $this->getTestObject()->getType(),
            $this->getTestObject()->getRefId(),
            $this->getTestObject()->getId(),
            $this->user->getId()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$archives

Archives ilObjTestGUI::$archives

private

Definition at line 152 of file class.ilObjTestGUI.php.

$component_factory

ilComponentFactory ilObjTestGUI::$component_factory

protected

Definition at line 140 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$component_repository

ilComponentRepository ilObjTestGUI::$component_repository

protected

Definition at line 139 of file class.ilObjTestGUI.php.

$content_style

ContentStyle ilObjTestGUI::$content_style

private

Definition at line 145 of file class.ilObjTestGUI.php.

$create_question_mode

bool ilObjTestGUI::$create_question_mode

protected

Definition at line 164 of file class.ilObjTestGUI.php.

$data_factory

DataFactory ilObjTestGUI::$data_factory

protected

Definition at line 161 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$db

ilDBInterface ilObjTestGUI::$db

protected

Definition at line 141 of file class.ilObjTestGUI.php.

Referenced by executeCommand(), and forwardToInfoScreen().

$export_factory

ExportImportFactory ilObjTestGUI::$export_factory

private

Definition at line 127 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$export_repository

ExportRepository ilObjTestGUI::$export_repository

private

Definition at line 128 of file class.ilObjTestGUI.php.

$global_screen

GlobalScreen ilObjTestGUI::$global_screen

protected

Definition at line 148 of file class.ilObjTestGUI.php.

Referenced by forwardCommandToQuestionPreview().

$help

ilHelpGUI ilObjTestGUI::$help

protected

Definition at line 147 of file class.ilObjTestGUI.php.

$http

HTTPServices ilObjTestGUI::$http

protected

Definition at line 146 of file class.ilObjTestGUI.php.

Referenced by forwardCommandToQuestionPreview().

$irss

IRSS ilObjTestGUI::$irss

protected

Definition at line 151 of file class.ilObjTestGUI.php.

$navigation_history

ilNavigationHistory ilObjTestGUI::$navigation_history

protected

Definition at line 138 of file class.ilObjTestGUI.php.

$obj_data_cache

ilObjectDataCache ilObjTestGUI::$obj_data_cache

protected

Definition at line 149 of file class.ilObjTestGUI.php.

$objective_oriented_container

ilTestObjectiveOrientedContainer ilObjTestGUI::$objective_oriented_container

private

Definition at line 136 of file class.ilObjTestGUI.php.

Referenced by getObjectiveOrientedContainer().

$participant_access_filter_factory

ilTestParticipantAccessFilterFactory ilObjTestGUI::$participant_access_filter_factory

private

Definition at line 132 of file class.ilObjTestGUI.php.

$participant_repository

ParticipantRepository ilObjTestGUI::$participant_repository

protected

Definition at line 155 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$qplrequest

QPLRequestDataCollector ilObjTestGUI::$qplrequest

private

Definition at line 133 of file class.ilObjTestGUI.php.

$questionrepository

GeneralQuestionPropertiesRepository ilObjTestGUI::$questionrepository

private

Definition at line 130 of file class.ilObjTestGUI.php.

$response_handler

ResponseHandler ilObjTestGUI::$response_handler

protected

Definition at line 154 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$results_data_factory

ResultsDataFactory ilObjTestGUI::$results_data_factory

protected

Definition at line 156 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$results_presentation_factory

ResultsPresentationFactory ilObjTestGUI::$results_presentation_factory

protected

Definition at line 157 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$skills_service

SkillService ilObjTestGUI::$skills_service

protected

Definition at line 150 of file class.ilObjTestGUI.php.

$table_actions

QuestionsTableActions ilObjTestGUI::$table_actions = null

protected

Definition at line 160 of file class.ilObjTestGUI.php.

Referenced by getQuestionsTableActions().

$table_query

QuestionsTableQuery ilObjTestGUI::$table_query = null

protected

Definition at line 159 of file class.ilObjTestGUI.php.

Referenced by getQuestionsTableQuery(), getTargetQuestionpoolForm(), and showQuestionsObject().

$tabs_manager

TabsManager ilObjTestGUI::$tabs_manager = null

protected

Definition at line 135 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$taxonomy

TaxonomyService ilObjTestGUI::$taxonomy

protected

Definition at line 162 of file class.ilObjTestGUI.php.

$test_access

ilTestAccess ilObjTestGUI::$test_access

protected

Definition at line 137 of file class.ilObjTestGUI.php.

Referenced by executeCommand(), getTestAccess(), and setTestAccess().

$test_pass_result_repository

TestResultRepository ilObjTestGUI::$test_pass_result_repository

protected

Definition at line 158 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$test_player_factory

ilTestPlayerFactory ilObjTestGUI::$test_player_factory

private

Definition at line 125 of file class.ilObjTestGUI.php.

$test_question_set_config_factory

ilTestQuestionSetConfigFactory ilObjTestGUI::$test_question_set_config_factory

private

Definition at line 124 of file class.ilObjTestGUI.php.

$test_questions_repository

TestQuestionsRepository ilObjTestGUI::$test_questions_repository

private

Definition at line 129 of file class.ilObjTestGUI.php.

Referenced by getTable().

$test_session_factory

ilTestSessionFactory ilObjTestGUI::$test_session_factory

private

Definition at line 126 of file class.ilObjTestGUI.php.

$testrequest

RequestDataCollector ilObjTestGUI::$testrequest

protected

Definition at line 153 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

$title_builder

TitleColumnsBuilder ilObjTestGUI::$title_builder

private

Definition at line 134 of file class.ilObjTestGUI.php.

Referenced by getTable().

$toplist_repository

TestTopListRepository ilObjTestGUI::$toplist_repository

private

Definition at line 131 of file class.ilObjTestGUI.php.

$ui_factory

UIFactory ilObjTestGUI::$ui_factory

protected

Definition at line 142 of file class.ilObjTestGUI.php.

Referenced by executeCommand(), and forwardToInfoScreen().

$ui_renderer

UIRenderer ilObjTestGUI::$ui_renderer

protected

Definition at line 143 of file class.ilObjTestGUI.php.

Referenced by executeCommand(), and forwardToInfoScreen().

$ui_service

ilUIService ilObjTestGUI::$ui_service

protected

Definition at line 144 of file class.ilObjTestGUI.php.

Referenced by executeCommand().

INFO_SCREEN_CHILD_CLASSES

const ilObjTestGUI::INFO_SCREEN_CHILD_CLASSES

private

Initial value:

= [
        'ilpublicuserprofilegui', 'ilobjportfoliogui'
    ]

Definition at line 116 of file class.ilObjTestGUI.php.

QUESTION_CREATION_POOL_SELECTION_EXISTING_POOL

const ilObjTestGUI::QUESTION_CREATION_POOL_SELECTION_EXISTING_POOL = 3

private

Definition at line 122 of file class.ilObjTestGUI.php.

QUESTION_CREATION_POOL_SELECTION_NEW_POOL

const ilObjTestGUI::QUESTION_CREATION_POOL_SELECTION_NEW_POOL = 2

private

Definition at line 121 of file class.ilObjTestGUI.php.

QUESTION_CREATION_POOL_SELECTION_NO_POOL

const ilObjTestGUI::QUESTION_CREATION_POOL_SELECTION_NO_POOL = 1

private

Definition at line 120 of file class.ilObjTestGUI.php.

SHOW_LOGS_CMD

const ilObjTestGUI::SHOW_LOGS_CMD = 'history'

private

Definition at line 114 of file class.ilObjTestGUI.php.

SHOW_QUESTIONS_CMD

const ilObjTestGUI::SHOW_QUESTIONS_CMD = 'showQuestions'

Definition at line 113 of file class.ilObjTestGUI.php.

Referenced by ilAssQuestionPageCommandForwarder\forward(), ILIAS\Test\Presentation\TabsManager\getBrowseForQuestionsTab(), ILIAS\Test\Presentation\TabsManager\getQuestionsSubTabs(), ILIAS\Test\Presentation\TabsManager\getRandomQuestionsTab(), ilTestQuestionBrowserTableGUI\handleTabs(), ilTestQuestionBrowserTableGUI\handleWriteAccess(), ilTestQuestionBrowserTableGUI\insertQuestionsCmd(), ILIAS\Test\Questions\Presentation\Printer\printAnswers(), ILIAS\Test\Questions\Presentation\Printer\printSelectedQuestions(), ILIAS\Test\Presentation\TabsManager\setupTabsGuiConfig(), and ilObjTestGUITest\testCancelCreateQuestionObject().

---

The documentation for this class was generated from the following file:

• components/ILIAS/Test/classes/class.ilObjTestGUI.php