ilAssQuestionSkillAssignmentsGUI Class Reference

Collaboration diagram for ilAssQuestionSkillAssignmentsGUI:

Public Member Functions
	__construct (private readonly ilCtrl $ctrl, private readonly ilAccessHandler $access, private readonly ilGlobalTemplateInterface $tpl, private readonly ilLanguage $lng, private readonly ilDBInterface $db, private readonly RequestDataCollectorInterface $request_data_collector, private readonly SkillUsageService $skill_usage_service, private readonly UIFactory $ui_factory, private readonly UIRenderer $ui_renderer, private readonly Refinery $refinery, private readonly HTTP $http, private readonly ilToolbarGUI $toolbar, private readonly ilTabsGUI $tabs)
	getQuestionOrderSequence ()
	getAssignmentConfigurationHintMessage ()
	setAssignmentConfigurationHintMessage (?string $assignmentConfigurationHintMessage)
	setQuestionOrderSequence ($questionOrderSequence)
	getQuestionList ()
	setQuestionList ($questionList)
	getQuestionContainerId ()
	setQuestionContainerId ($questionContainerId)
	isAssignmentEditingEnabled ()
	setAssignmentEditingEnabled ($assignmentEditingEnabled)
	executeCommand ()

Data Fields
const	CMD_SHOW_SKILL_QUEST_ASSIGNS = 'showSkillQuestionAssignments'
const	CMD_EDIT_SKILL_QUEST_ASSIGNS = 'editSkillQuestionAssignment'
const	CMD_SHOW_SKILL_SELECT = 'showSkillSelection'
const	CMD_UPDATE_SKILL_QUEST_ASSIGNS = 'updateSkillQuestionAssignments'
const	CMD_SHOW_SKILL_QUEST_ASSIGN_PROPERTIES_FORM = 'showSkillQuestionAssignmentPropertiesForm'
const	CMD_SAVE_SKILL_QUEST_ASSIGN_PROPERTIES_FORM = 'saveSkillQuestionAssignmentPropertiesForm'
const	CMD_SAVE_SKILL_POINTS = 'saveSkillPoints'
const	CMD_SHOW_SYNC_ORIGINAL_CONFIRMATION = 'showSyncOriginalConfirmation'
const	CMD_SYNC_ORIGINAL = 'syncOriginal'
const	PARAM_SKILL_SELECTION = 'skill_ids'

Protected Member Functions
	doesObjectTypeMatch ($objectId)

Private Member Functions
	modifyTabs ()
	isAvoidManipulationRedirectRequired ($command)
	saveSkillPointsCmd ()
	updateSkillQuestionAssignmentsCmd ()
	showSkillSelectionCmd ()
	showSkillQuestionAssignmentPropertiesFormCmd (?assQuestionGUI $question_gui=null, ?ilAssQuestionSkillAssignment $assignment=null, ?ilPropertyFormGUI $form=null)
	saveSkillQuestionAssignmentPropertiesFormCmd ()
	buildSkillQuestionAssignmentPropertiesForm (assQuestion $question, ilAssQuestionSkillAssignment $assignment)
	editSkillQuestionAssignmentCmd ()
	isSyncOriginalPossibleAndAllowed (int $questionId)
	showSyncOriginalConfirmationCmd ()
	syncOriginalCmd ()
	buildSkillQuestionAssignmentList ()
	buildSkillSelectorExplorerGUI ($assignments)
	buildSkillSelectorToolbarGUI ()
	buildQuestionPage (assQuestionGUI $question_gui)
	buildQuestionSkillAssignment (int $question_id, int $skill_base_id, int $skill_tref_id)
	isTestQuestion ($questionId)
	checkSolutionCompareExpressionInput ($input, assQuestion $question)
	checkPointsAreInt (ilPropertyFormGUI $form)
	validateSolutionCompareExpression (ilAssQuestionSolutionComparisonExpression $expression, $question)
	keepAssignmentParameters ()
	handleAssignmentConfigurationHintMessage ()
	getSkillSelectorHeader (int $questionId)
	sortAlphabetically ($array)

Private Attributes
ilAssQuestionList	$question_list
int	$question_container_id
bool	$assignment_editing_enabled
string	$assignment_configuration_hint_message = null
array	$questionOrderSequence
DataFactory	$data_factory

Detailed Description

Definition at line 46 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Constructor & Destructor Documentation

__construct()

ilAssQuestionSkillAssignmentsGUI::__construct	(	private readonly ilCtrl	$ctrl,
		private readonly ilAccessHandler	$access,
		private readonly ilGlobalTemplateInterface	$tpl,
		private readonly ilLanguage	$lng,
		private readonly ilDBInterface	$db,
		private readonly RequestDataCollectorInterface	$request_data_collector,
		private readonly SkillUsageService	$skill_usage_service,
		private readonly UIFactory	$ui_factory,
		private readonly UIRenderer	$ui_renderer,
		private readonly Refinery	$refinery,
		private readonly HTTP	$http,
		private readonly ilToolbarGUI	$toolbar,
		private readonly ilTabsGUI	$tabs
	)

Definition at line 69 of file class.ilAssQuestionSkillAssignmentsGUI.php.

      {
        $this->data_factory = new DataFactory();
    }

Member Function Documentation

buildQuestionPage()

ilAssQuestionSkillAssignmentsGUI::buildQuestionPage ( assQuestionGUI  $question_gui )

private

Definition at line 677 of file class.ilAssQuestionSkillAssignmentsGUI.php.

    {
        $this->tpl->addCss('./assets/css/content.css');
 
        $page_gui = new ilAssQuestionPageGUI($question_gui->getObject()->getId());
        $page_gui->setFileDownloadLink($question_gui->buildFileDownloadLink());
        $page_gui->setOutputMode("presentation");
        $page_gui->setRenderPageContainer(true);
 
        $page_gui->setPresentationTitle($question_gui->getObject()->getTitleForHTMLOutput());
 
        $question = $question_gui->getObject();
        $question->setShuffle(false); // dirty, but works ^^
        $question_gui->setObject($question);
        $page_gui->setQuestionHTML([
            $question_gui->getObject()->getId() => $question_gui->getSolutionOutput(0, 0, false, false, true, false, true, false, true)
        ]);
 
        return preg_replace("/src=\"\\.\\//ims", "src=\"" . ILIAS_HTTP_PATH . "/", $page_gui->presentation());
 
    }

References assQuestionGUI\buildFileDownloadLink(), assQuestionGUI\getObject(), assQuestionGUI\getSolutionOutput(), assQuestionGUI\setObject(), and assQuestion\setShuffle().

Here is the call graph for this function:

buildQuestionSkillAssignment()

ilAssQuestionSkillAssignmentsGUI::buildQuestionSkillAssignment ( int  $question_id, int  $skill_base_id, int  $skill_tref_id  )

private

Returns

ilAssQuestionSkillAssignment

Definition at line 702 of file class.ilAssQuestionSkillAssignmentsGUI.php.

     : ilAssQuestionSkillAssignment {
        $assignment = new ilAssQuestionSkillAssignment($this->db);
 
        $assignment->setParentObjId($this->getQuestionContainerId());
        $assignment->setQuestionId($question_id);
        $assignment->setSkillBaseId($skill_base_id);
        $assignment->setSkillTrefId($skill_tref_id);
 
        $assignment->loadFromDb();
        $assignment->loadAdditionalSkillData();
 
        return $assignment;
    }

buildSkillQuestionAssignmentList()

ilAssQuestionSkillAssignmentsGUI::buildSkillQuestionAssignmentList ( )

private

Definition at line 627 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                       : ilAssQuestionSkillAssignmentList
    {
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($this->getQuestionContainerId());
 
        return $assignmentList;
    }

buildSkillQuestionAssignmentPropertiesForm()

ilAssQuestionSkillAssignmentsGUI::buildSkillQuestionAssignmentPropertiesForm ( assQuestion  $question, ilAssQuestionSkillAssignment  $assignment  )

private

Definition at line 470 of file class.ilAssQuestionSkillAssignmentsGUI.php.

     : ilAssQuestionSkillAssignmentPropertyFormGUI {
        $form = new ilAssQuestionSkillAssignmentPropertyFormGUI($this);
        $form->setQuestion($question);
        $form->setAssignment($assignment);
        $form->setManipulationEnabled($this->isAssignmentEditingEnabled());
        $form->build();
 
        return $form;
    }

buildSkillSelectorExplorerGUI()

ilAssQuestionSkillAssignmentsGUI::buildSkillSelectorExplorerGUI (   $assignments )

private

Returns

ilSkillSelectorGUI

Definition at line 638 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                : ilSkillSelectorGUI
    {
        $skillSelectorExplorerGUI = new ilSkillSelectorGUI(
            $this,
            self::CMD_SHOW_SKILL_SELECT,
            $this,
            self::CMD_UPDATE_SKILL_QUEST_ASSIGNS,
            self::PARAM_SKILL_SELECTION
        );
 
        $skillSelectorExplorerGUI->setSelectMode(self::PARAM_SKILL_SELECTION, true);
        //$skillSelectorExplorerGUI->setNodeOnclickEnabled(false);
 
        // parameter name for skill selection is actually taken from value passed to constructor,
        // but passing a non empty name to setSelectMode is neccessary to keep input fields enabled
 
        foreach ($assignments as $assignment) {
            $id = "{$assignment->getSkillBaseId()}:{$assignment->getSkillTrefId()}";
            //$skillSelectorExplorerGUI->setNodeSelected($id);
            $skillSelectorExplorerGUI->setSkillSelected($id);
        }
 
        return $skillSelectorExplorerGUI;
    }

References $id.

Referenced by showSkillSelectionCmd(), and updateSkillQuestionAssignmentsCmd().

Here is the caller graph for this function:

buildSkillSelectorToolbarGUI()

ilAssQuestionSkillAssignmentsGUI::buildSkillSelectorToolbarGUI ( )

private

Returns

ilToolbarGUI

Definition at line 666 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                   : ilToolbarGUI
    {
        $skillSelectorToolbarGUI = new ilToolbarGUI();
 
        $skillSelectorToolbarGUI->setFormAction($this->ctrl->getFormAction($this));
        $skillSelectorToolbarGUI->addFormButton($this->lng->txt('qpl_save_skill_assigns_update'), self::CMD_UPDATE_SKILL_QUEST_ASSIGNS);
        $skillSelectorToolbarGUI->addFormButton($this->lng->txt('qpl_cancel_skill_assigns_update'), self::CMD_EDIT_SKILL_QUEST_ASSIGNS);
 
        return $skillSelectorToolbarGUI;
    }

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

Referenced by showSkillSelectionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

checkPointsAreInt()

ilAssQuestionSkillAssignmentsGUI::checkPointsAreInt ( ilPropertyFormGUI  $form )

private

Definition at line 747 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                               : bool
    {
        $points_result = $form->getInput('q_res_skill_points');
        $invalid_values_solution = array_filter(
            $form->getInput('solution_compare_expressions')['points'],
            fn(string $v): bool => $v != (int) $v
        );
        if ($points_result == (int) $points_result
            && $invalid_values_solution === []) {
            return true;
        }
        $this->tpl->setOnScreenMessage('failure', $this->lng->txt('numeric_only'));
        return false;
    }

References ilPropertyFormGUI\getInput(), and ILIAS\Repository\lng().

Here is the call graph for this function:

checkSolutionCompareExpressionInput()

ilAssQuestionSkillAssignmentsGUI::checkSolutionCompareExpressionInput (   $input, assQuestion  $question  )

private

Definition at line 725 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                                       : bool
    {
        $errors = [];
 
        foreach ($input->getValues() as $expression) {
            $result = $this->validateSolutionCompareExpression($expression, $question);
 
            if ($result !== true) {
                $errors[] = "{$this->lng->txt('ass_lac_expression')} {$expression->getOrderIndex()}: {$result}";
            }
        }
 
        if (count($errors)) {
            $alert = $this->lng->txt('ass_lac_validation_error');
            $alert .= '<br />' . implode('<br />', $errors);
            $input->setAlert($alert);
            return false;
        }
 
        return true;
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

doesObjectTypeMatch()

ilAssQuestionSkillAssignmentsGUI::doesObjectTypeMatch (   $objectId )

protected

Definition at line 822 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                     : bool
    {
        return ilObject::_lookupType($objectId) == 'qpl';
    }

References ilObject\_lookupType().

Here is the call graph for this function:

editSkillQuestionAssignmentCmd()

ilAssQuestionSkillAssignmentsGUI::editSkillQuestionAssignmentCmd ( )

private

Definition at line 521 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                     : void
    {
        $assignment_list = $this->buildSkillQuestionAssignmentList();
        $assignment_list->loadFromDb();
        $assignment_list->loadAdditionalSkillData();
 
        $this->keepAssignmentParameters();
 
        $edit_uri = $this->data_factory->uri(
            ILIAS_HTTP_PATH . '/' . $this->ctrl->getLinkTargetByClass(
                self::class,
                self::CMD_SHOW_SKILL_QUEST_ASSIGN_PROPERTIES_FORM
            )
        );
 
        $this->ctrl->setParameterByClass(
            ilAssQuestionSkillAssignmentsGUI::class,
            'q_id',
            $this->request_data_collector->getQuestionId()
        );
        $this->toolbar->addComponent(
            $this->ui_factory->button()->standard(
                $this->lng->txt('tst_manage_competence_select_skills'),
                $this->ctrl->getLinkTargetByClass(
                    [ilAssQuestionSkillAssignmentsGUI::class],
                    self::CMD_SHOW_SKILL_SELECT
                )
            )->withUnavailableAction(!$this->isAssignmentEditingEnabled())
        );
        $this->ctrl->setParameterByClass(ilAssQuestionSkillAssignmentsGUI::class, 'q_id', null);
 
        $components = (new EditSkillsOfQuestionTable(
            $this->request_data_collector,
            $assignment_list,
            $this->ui_factory,
            $this->lng,
            (new EditSkillsOfQuestionTableActions(
                $this->tpl,
                [
                    EditSkillsOfQuestionTableEditAction::ACTION_ID => new EditSkillsOfQuestionTableEditAction(
                        $this->ui_factory,
                        $this->lng,
                        $this->isAssignmentEditingEnabled()
                    )
                ]
            ))
        ))->getComponents(new URLBuilder($edit_uri));
 
        $this->tpl->setContent($this->ui_renderer->render($components));
    }

References $components, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\toolbar().

Referenced by updateSkillQuestionAssignmentsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilAssQuestionSkillAssignmentsGUI::executeCommand

(

)

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

                                    : void
    {
        $nextClass = $this->ctrl->getNextClass();
 
        $command = $this->ctrl->getCmd(self::CMD_SHOW_SKILL_QUEST_ASSIGNS);
 
        if ($this->isAvoidManipulationRedirectRequired($command)) {
            $this->ctrl->redirect($this, self::CMD_SHOW_SKILL_QUEST_ASSIGNS);
        }
 
        $this->keepAssignmentParameters();
 
        if (in_array($command, [self::CMD_EDIT_SKILL_QUEST_ASSIGNS])) {
            $this->modifyTabs();
        }
 
        switch ($nextClass) {
            case strtolower(__CLASS__):
            case '':
 
                $command .= 'Cmd';
                $this->$command();
                break;
 
            default:
 
                throw new ilTestQuestionPoolException('unsupported next class in ctrl flow');
        }
    }

References ILIAS\Repository\ctrl(), isAvoidManipulationRedirectRequired(), keepAssignmentParameters(), and modifyTabs().

Here is the call graph for this function:

getAssignmentConfigurationHintMessage()

ilAssQuestionSkillAssignmentsGUI::getAssignmentConfigurationHintMessage

(

)

Definition at line 92 of file class.ilAssQuestionSkillAssignmentsGUI.php.

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

References $assignment_configuration_hint_message.

getQuestionContainerId()

ilAssQuestionSkillAssignmentsGUI::getQuestionContainerId

(

)

Returns

int

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

                                            : int
    {
        return $this->question_container_id;
    }

References $question_container_id.

Referenced by saveSkillPointsCmd(), showSkillSelectionCmd(), and updateSkillQuestionAssignmentsCmd().

Here is the caller graph for this function:

getQuestionList()

ilAssQuestionSkillAssignmentsGUI::getQuestionList

(

)

Returns

ilAssQuestionList

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

                                     : ilAssQuestionList
    {
        return $this->question_list;
    }

References $question_list.

getQuestionOrderSequence()

ilAssQuestionSkillAssignmentsGUI::getQuestionOrderSequence

(

)

Definition at line 87 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                              : ?array
    {
        return $this->questionOrderSequence;
    }

References $questionOrderSequence.

getSkillSelectorHeader()

ilAssQuestionSkillAssignmentsGUI::getSkillSelectorHeader ( int  $questionId )

private

Definition at line 795 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                            : string
    {
        return sprintf(
            $this->lng->txt('qpl_qst_skl_selection_for_question_header'),
            $this->question_list->getDataArrayForQuestionId($questionId)['title']
        );
    }

References ILIAS\Repository\lng().

Referenced by showSkillSelectionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

handleAssignmentConfigurationHintMessage()

ilAssQuestionSkillAssignmentsGUI::handleAssignmentConfigurationHintMessage ( )

private

Definition at line 788 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                               : void
    {
        if ($this->getAssignmentConfigurationHintMessage()) {
            $this->tpl->setOnScreenMessage('info', $this->getAssignmentConfigurationHintMessage());
        }
    }

isAssignmentEditingEnabled()

ilAssQuestionSkillAssignmentsGUI::isAssignmentEditingEnabled

(

)

Returns

bool

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

                                                : bool
    {
        return $this->assignment_editing_enabled;
    }

References $assignment_editing_enabled.

Referenced by isAvoidManipulationRedirectRequired().

Here is the caller graph for this function:

isAvoidManipulationRedirectRequired()

ilAssQuestionSkillAssignmentsGUI::isAvoidManipulationRedirectRequired (   $command )

private

Definition at line 209 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                  : bool
    {
        if ($this->isAssignmentEditingEnabled()) {
            return false;
        }
 
        switch ($command) {
            case self::CMD_SAVE_SKILL_QUEST_ASSIGN_PROPERTIES_FORM:
            case self::CMD_UPDATE_SKILL_QUEST_ASSIGNS:
 
                return true;
        }
 
        return false;
    }

References CMD_SAVE_SKILL_QUEST_ASSIGN_PROPERTIES_FORM, CMD_UPDATE_SKILL_QUEST_ASSIGNS, and isAssignmentEditingEnabled().

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

isSyncOriginalPossibleAndAllowed()

ilAssQuestionSkillAssignmentsGUI::isSyncOriginalPossibleAndAllowed ( int  $questionId )

private

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

                                                                      : bool
    {
        $questionData = $this->question_list->getDataArrayForQuestionId($questionId);
 
        if (!$questionData['original_id']) {
            return false;
        }
 
        $parentObjId = assQuestion::lookupParentObjId($questionData['original_id']);
 
        if ($parentObjId === null || !$this->doesObjectTypeMatch($parentObjId)) {
            return false;
        }
 
        foreach (ilObject::_getAllReferences($parentObjId) as $parentRefId) {
            if ($this->access->checkAccess('write', '', $parentRefId)) {
                return true;
            }
        }
 
        return false;
    }

References ilObject\_getAllReferences(), ILIAS\Repository\access(), and assQuestion\lookupParentObjId().

Referenced by updateSkillQuestionAssignmentsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

isTestQuestion()

ilAssQuestionSkillAssignmentsGUI::isTestQuestion (   $questionId )

private

Definition at line 720 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                : bool
    {
        return $this->question_list->isInList($questionId);
    }

Referenced by saveSkillPointsCmd(), and updateSkillQuestionAssignmentsCmd().

Here is the caller graph for this function:

keepAssignmentParameters()

ilAssQuestionSkillAssignmentsGUI::keepAssignmentParameters ( )

private

Definition at line 781 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                               : void
    {
        $this->ctrl->saveParameter($this, 'q_id');
        $this->ctrl->saveParameter($this, 'skill_base_id');
        $this->ctrl->saveParameter($this, 'skill_tref_id');
    }

References ILIAS\Repository\ctrl().

Referenced by executeCommand(), showSkillSelectionCmd(), and updateSkillQuestionAssignmentsCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

modifyTabs()

ilAssQuestionSkillAssignmentsGUI::modifyTabs ( )

private

Definition at line 188 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                 : void
    {
        $this->tabs->clearTargets();
        $this->tabs->setBackTarget(
            $this->lng->txt('back'),
            $this->ctrl->getLinkTargetByClass(
                ilAssQuestionSkillAssignmentsGUI::class,
                ilAssQuestionSkillAssignmentsGUI::CMD_SHOW_SKILL_QUEST_ASSIGNS
            )
        );
        $this->tabs->addTab(
            strtolower(ilAssQuestionSkillAssignmentsGUI::class),
            $this->lng->txt('qpl_skl_sub_tab_quest_assign'),
            $this->ctrl->getLinkTargetByClass(
                ilAssQuestionSkillAssignmentsGUI::class,
                ilAssQuestionSkillAssignmentsGUI::CMD_EDIT_SKILL_QUEST_ASSIGNS
            )
        );
        $this->tabs->activateTab(strtolower(ilAssQuestionSkillAssignmentsGUI::class));
    }

References CMD_EDIT_SKILL_QUEST_ASSIGNS, CMD_SHOW_SKILL_QUEST_ASSIGNS, ILIAS\Repository\lng(), and ILIAS\Repository\tabs().

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

saveSkillPointsCmd()

ilAssQuestionSkillAssignmentsGUI::saveSkillPointsCmd ( )

private

Definition at line 225 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                         : void
    {
        $success = true;
        $skill_points = $this->request_data_collector->raw('skill_points');
 
        for ($i = 0; $i < 2; $i++) {
            foreach ($skill_points as $assignment_key => $skill_point) {
                $assignment_key = explode(':', $assignment_key);
                $skillBaseId = (int) $assignment_key[0];
                $skillTrefId = (int) $assignment_key[1];
                $questionId = (int) $assignment_key[2];
 
                if ($this->isTestQuestion($questionId)) {
                    $assignment = new ilAssQuestionSkillAssignment($this->db);
 
                    if ($i === 0) {
                        if (!$assignment->isValidSkillPoint($skill_point)) {
                            $success = false;
                            break 2;
                        }
                        continue;
                    }
 
                    $assignment->setParentObjId($this->getQuestionContainerId());
                    $assignment->setQuestionId($questionId);
                    $assignment->setSkillBaseId($skillBaseId);
                    $assignment->setSkillTrefId($skillTrefId);
 
                    if ($assignment->dbRecordExists()) {
                        $assignment->loadFromDb();
 
                        if (!$assignment->hasEvalModeBySolution()) {
                            $assignment->setSkillPoints($skill_point);
                            $assignment->saveToDb();
 
                            // add skill usage
                            $this->skill_usage_service->addUsage($this->getQuestionContainerId(), $skillBaseId, $skillTrefId);
                        }
                    }
                }
 
            }
        }
 
        if ($success) {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('tst_msg_skl_qst_assign_points_saved'), true);
            $this->ctrl->redirect($this, self::CMD_SHOW_SKILL_QUEST_ASSIGNS);
            return;
        }
 
        $this->tpl->setOnScreenMessage('failure', $this->lng->txt('tst_msg_skl_qst_assign_points_not_saved'));
        $this->showSkillQuestionAssignmentsCmd(true);
    }

References ILIAS\Repository\ctrl(), getQuestionContainerId(), ILIAS\Repository\int(), isTestQuestion(), and ILIAS\Repository\lng().

Here is the call graph for this function:

saveSkillQuestionAssignmentPropertiesFormCmd()

ilAssQuestionSkillAssignmentsGUI::saveSkillQuestionAssignmentPropertiesFormCmd ( )

private

Definition at line 405 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                   : void
    {
        $question_id = $this->request_data_collector->getQuestionId();
 
        if ($this->isTestQuestion($question_id)) {
            $question_gui = assQuestionGUI::_getQuestionGUI('', $question_id);
 
            $row_id_parameter = $this->request_data_collector->getRowIdParameter(EditSkillsOfQuestionTableActions::FULL_ROW_ID_PARAMETER);
            [1 => $skill_base_id, 2 => $skill_tref_id] = explode('_', $row_id_parameter);
            $assignment = $this->buildQuestionSkillAssignment($question_id, (int) $skill_base_id, (int) $skill_tref_id);
 
            $this->keepAssignmentParameters();
            $form = $this->buildSkillQuestionAssignmentPropertiesForm($question_gui->getObject(), $assignment);
            if (!$form->checkInput()
                || !$this->checkPointsAreInt($form)) {
                $form->setValuesByPost();
                $this->showSkillQuestionAssignmentPropertiesFormCmd($question_gui, $assignment, $form);
                return;
            }
            $form->setValuesByPost();
 
            if ($form->getItemByPostVar('eval_mode')) {
                $assignment->setEvalMode($form->getItemByPostVar('eval_mode')->getValue());
            } else {
                $assignment->setEvalMode(ilAssQuestionSkillAssignment::EVAL_MODE_BY_QUESTION_RESULT);
            }
 
            if ($assignment->hasEvalModeBySolution()) {
                $sol_cmp_expr_input = $form->getItemByPostVar('solution_compare_expressions');
 
                if (!$this->checkSolutionCompareExpressionInput($sol_cmp_expr_input, $question_gui->getObject())) {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_input_not_valid'));
                    $this->showSkillQuestionAssignmentPropertiesFormCmd($question_gui, $assignment, $form);
                    return;
                }
 
                $assignment->initSolutionComparisonExpressionList();
                $assignment->getSolutionComparisonExpressionList()->reset();
 
                foreach ($sol_cmp_expr_input->getValues() as $expression) {
                    $assignment->getSolutionComparisonExpressionList()->add($expression);
                }
            } else {
                $assignment->setSkillPoints($form->getItemByPostVar('q_res_skill_points')->getValue());
            }
 
            $assignment->saveToDb();
 
            // add skill usage
            $this->skill_usage_service->addUsage(
                $this->getQuestionContainerId(),
                $this->request_data_collector->int('skill_base_id'),
                $this->request_data_collector->int('skill_tref_id')
            );
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('qpl_qst_skl_assign_properties_modified'), true);
 
            if ($this->isSyncOriginalPossibleAndAllowed($question_id)) {
                $this->ctrl->redirect($this, self::CMD_SHOW_SYNC_ORIGINAL_CONFIRMATION);
            }
        }
 
        $this->ctrl->redirect($this, self::CMD_EDIT_SKILL_QUEST_ASSIGNS);
    }

References assQuestionGUI\_getQuestionGUI(), ILIAS\Repository\ctrl(), ilAssQuestionSkillAssignment\EVAL_MODE_BY_QUESTION_RESULT, and ILIAS\Repository\lng().

Here is the call graph for this function:

setAssignmentConfigurationHintMessage()

ilAssQuestionSkillAssignmentsGUI::setAssignmentConfigurationHintMessage

(

?string

$assignmentConfigurationHintMessage

)

Definition at line 97 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                                                      : void
    {
        $this->assignment_configuration_hint_message = $assignmentConfigurationHintMessage;
    }

setAssignmentEditingEnabled()

ilAssQuestionSkillAssignmentsGUI::setAssignmentEditingEnabled

(

$assignmentEditingEnabled

)

Parameters

bool

$assignmentEditingEnabled

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

                                                                          : void
    {
        $this->assignment_editing_enabled = $assignmentEditingEnabled;
    }

setQuestionContainerId()

ilAssQuestionSkillAssignmentsGUI::setQuestionContainerId

(

$questionContainerId

)

Parameters

int

$questionContainerId

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

                                                                : void
    {
        $this->question_container_id = $questionContainerId;
    }

setQuestionList()

ilAssQuestionSkillAssignmentsGUI::setQuestionList

(

$questionList

)

Parameters

ilAssQuestionList

$questionList

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

                                                  : void
    {
        $this->question_list = $questionList;
    }

setQuestionOrderSequence()

ilAssQuestionSkillAssignmentsGUI::setQuestionOrderSequence

(

$questionOrderSequence

)

Parameters

array

$questionOrderSequence

Definition at line 105 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                    : void
    {
        $this->questionOrderSequence = $questionOrderSequence;
    }

References $questionOrderSequence.

showSkillQuestionAssignmentPropertiesFormCmd()

ilAssQuestionSkillAssignmentsGUI::showSkillQuestionAssignmentPropertiesFormCmd ( ?assQuestionGUI  $question_gui = null, ?ilAssQuestionSkillAssignment  $assignment = null, ?ilPropertyFormGUI  $form = null  )

private

Definition at line 384 of file class.ilAssQuestionSkillAssignmentsGUI.php.

     : void {
        $this->handleAssignmentConfigurationHintMessage();
 
        $this->keepAssignmentParameters();
 
        $question_id = $this->request_data_collector->getQuestionId();
        $question_gui ??= assQuestionGUI::_getQuestionGUI('', $question_id);
 
        $row_id_parameter = $this->request_data_collector->getRowIdParameter(EditSkillsOfQuestionTableActions::FULL_ROW_ID_PARAMETER);
        [1 => $skill_base_id, 2 => $skill_tref_id] = explode('_', $row_id_parameter);
        $assignment ??= $this->buildQuestionSkillAssignment($question_id, (int) $skill_base_id, (int) $skill_tref_id);
 
        $form ??= $this->buildSkillQuestionAssignmentPropertiesForm($question_gui->getObject(), $assignment);
 
        $this->tpl->setContent($form->getHTML() . '<br />' . $this->buildQuestionPage($question_gui));
    }

showSkillSelectionCmd()

ilAssQuestionSkillAssignmentsGUI::showSkillSelectionCmd ( )

private

Definition at line 348 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                            : void
    {
        $this->keepAssignmentParameters();
        $question_id = $this->request_data_collector->getQuestionId();
 
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($this->getQuestionContainerId());
        $assignmentList->loadFromDb();
 
        $skillSelectorExplorerGUI = $this->buildSkillSelectorExplorerGUI(
            $assignmentList->getAssignmentsByQuestionId($question_id)
        );
 
        if (!$skillSelectorExplorerGUI->handleCommand()) {
            $tpl = new ilTemplate('tpl.qpl_qst_skl_assign_selection.html', false, false, 'components/ILIAS/TestQuestionPool');
 
            $tpl->setVariable('SKILL_SELECTOR_HEADER', $this->getSkillSelectorHeader($question_id));
 
            $skillSelectorToolbarGUI = $this->buildSkillSelectorToolbarGUI();
 
            $skillSelectorToolbarGUI->setOpenFormTag(true);
            $skillSelectorToolbarGUI->setCloseFormTag(false);
            $skillSelectorToolbarGUI->setLeadingImage(ilUtil::getImagePath("nav/arrow_upright.svg"), " ");
            $tpl->setVariable('SKILL_SELECTOR_TOOLBAR_TOP', $this->ctrl->getHTML($skillSelectorToolbarGUI));
 
            $tpl->setVariable('SKILL_SELECTOR_EXPLORER', $this->ctrl->getHTML($skillSelectorExplorerGUI));
 
            $skillSelectorToolbarGUI->setOpenFormTag(false);
            $skillSelectorToolbarGUI->setCloseFormTag(true);
            $skillSelectorToolbarGUI->setLeadingImage(ilUtil::getImagePath("nav/arrow_downright.svg"), " ");
            $tpl->setVariable('SKILL_SELECTOR_TOOLBAR_BOTTOM', $this->ctrl->getHTML($skillSelectorToolbarGUI));
 
            $this->tpl->setContent($tpl->get());
        }
    }

References buildSkillSelectorExplorerGUI(), buildSkillSelectorToolbarGUI(), ILIAS\Repository\ctrl(), ilUtil\getImagePath(), getQuestionContainerId(), getSkillSelectorHeader(), and keepAssignmentParameters().

Here is the call graph for this function:

showSyncOriginalConfirmationCmd()

ilAssQuestionSkillAssignmentsGUI::showSyncOriginalConfirmationCmd ( )

private

Definition at line 595 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                      : void
    {
        $confirmation = new ilConfirmationGUI();
        $confirmation->setHeaderText($this->lng->txt('qpl_sync_quest_skl_assigns_confirmation'));
 
        $confirmation->setFormAction($this->ctrl->getFormAction($this));
        $confirmation->addHiddenItem('q_id', $this->request_data_collector->getQuestionId());
        $confirmation->setConfirm($this->lng->txt('yes'), self::CMD_SYNC_ORIGINAL);
        $confirmation->setCancel($this->lng->txt('no'), self::CMD_EDIT_SKILL_QUEST_ASSIGNS);
 
        $this->tpl->setContent($this->ctrl->getHTML($confirmation));
    }

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

Here is the call graph for this function:

sortAlphabetically()

ilAssQuestionSkillAssignmentsGUI::sortAlphabetically (   $array )

private

Definition at line 803 of file class.ilAssQuestionSkillAssignmentsGUI.php.

    {
        $flags = SORT_REGULAR;
 
        if (defined('SORT_NATURAL')) {
            $flags = SORT_NATURAL;
        } elseif (defined('SORT_STRING')) {
            $flags = SORT_STRING;
        }
 
        if (defined('SORT_FLAG_CASE')) {
            $flags = $flags | SORT_FLAG_CASE;
        }
 
        asort($array, $flags);
 
        return $array;
    }

syncOriginalCmd()

ilAssQuestionSkillAssignmentsGUI::syncOriginalCmd ( )

private

Definition at line 608 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                      : void
    {
        $question_id = $this->request_data_collector->getQuestionId();
        if ($this->isTestQuestion($question_id) && $this->isSyncOriginalPossibleAndAllowed($question_id)) {
            $question = assQuestion::instantiateQuestion($question_id);
 
            $question->syncSkillAssignments(
                $question->getObjId(),
                $question->getId(),
                $question->lookupParentObjId($question->getOriginalId()),
                $question->getOriginalId()
            );
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('qpl_qst_skl_assign_synced_to_orig'), true);
        }
 
        $this->ctrl->redirect($this, self::CMD_EDIT_SKILL_QUEST_ASSIGNS);
    }

References ILIAS\Repository\ctrl(), assQuestion\getId(), assQuestion\getObjId(), assQuestion\getOriginalId(), assQuestion\instantiateQuestion(), ILIAS\Repository\lng(), assQuestion\lookupParentObjId(), and assQuestion\syncSkillAssignments().

Here is the call graph for this function:

updateSkillQuestionAssignmentsCmd()

ilAssQuestionSkillAssignmentsGUI::updateSkillQuestionAssignmentsCmd ( )

private

Definition at line 279 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                        : void
    {
        $this->keepAssignmentParameters();
        $question_id = $this->request_data_collector->getQuestionId();
 
        if ($this->isTestQuestion($question_id)) {
            $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
            $assignmentList->setParentObjId($this->getQuestionContainerId());
            $assignmentList->loadFromDb();
 
            $handledSkills = [];
 
            $sgui = $this->buildSkillSelectorExplorerGUI([]);
            $skillIds = $sgui->getSelectedSkills();
 
            foreach ($skillIds as $skillId) {
                $skill = explode(':', $skillId);
                $skillBaseId = (int) $skill[0];
                $skillTrefId = (int) $skill[1];
 
                if ($skillBaseId) {
                    if (!$assignmentList->isAssignedToQuestionId($skillBaseId, $skillTrefId, $question_id)) {
                        $assignment = new ilAssQuestionSkillAssignment($this->db);
 
                        $assignment->setParentObjId($this->getQuestionContainerId());
                        $assignment->setQuestionId($question_id);
                        $assignment->setSkillBaseId($skillBaseId);
                        $assignment->setSkillTrefId($skillTrefId);
 
                        $assignment->setSkillPoints(ilAssQuestionSkillAssignment::DEFAULT_COMPETENCE_POINTS);
                        $assignment->setEvalMode(ilAssQuestionSkillAssignment::EVAL_MODE_BY_QUESTION_RESULT);
                        $assignment->saveToDb();
 
                        // add skill usage
                        $this->skill_usage_service->addUsage($this->getQuestionContainerId(), $skillBaseId, $skillTrefId);
                    }
 
                    $handledSkills[$skillId] = $skill;
                }
            }
 
            foreach ($assignmentList->getAssignmentsByQuestionId($question_id) as $assignment) {
                if (isset($handledSkills["{$assignment->getSkillBaseId()}:{$assignment->getSkillTrefId()}"])) {
                    continue;
                }
 
                $assignment->deleteFromDb();
 
                // remove skill usage
                if (!$assignment->isSkillUsed()) {
                    $this->skill_usage_service->removeUsage(
                        $assignment->getParentObjId(),
                        $assignment->getSkillBaseId(),
                        $assignment->getSkillTrefId()
                    );
                }
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('qpl_qst_skl_assigns_updated'), true);
 
            if ($this->isSyncOriginalPossibleAndAllowed($question_id)) {
                $this->keepAssignmentParameters();
                $this->ctrl->redirect($this, self::CMD_SHOW_SYNC_ORIGINAL_CONFIRMATION);
            }
        }
 
        $this->editSkillQuestionAssignmentCmd();
    }

References buildSkillSelectorExplorerGUI(), ILIAS\Repository\ctrl(), ilAssQuestionSkillAssignment\DEFAULT_COMPETENCE_POINTS, editSkillQuestionAssignmentCmd(), ilAssQuestionSkillAssignment\EVAL_MODE_BY_QUESTION_RESULT, getQuestionContainerId(), ILIAS\Repository\int(), isSyncOriginalPossibleAndAllowed(), isTestQuestion(), keepAssignmentParameters(), and ILIAS\Repository\lng().

Here is the call graph for this function:

validateSolutionCompareExpression()

ilAssQuestionSkillAssignmentsGUI::validateSolutionCompareExpression ( ilAssQuestionSolutionComparisonExpression  $expression,   $question  )

private

Definition at line 762 of file class.ilAssQuestionSkillAssignmentsGUI.php.

                                                                                                                        : bool
    {
        try {
            $question_provider = new ilAssLacQuestionProvider();
            $question_provider->setQuestion($question);
            (new ilAssLacCompositeValidator($question_provider))->validate(
                (new ilAssLacConditionParser())->parse($expression->getExpression())
            );
        } catch (ilAssLacException $e) {
            if ($e instanceof ilAssLacFormAlertProvider) {
                return $e->getFormAlert($this->lng);
            }
 
            throw $e;
        }
 
        return true;
    }

References Vendor\Package\$e, ilAssQuestionSolutionComparisonExpression\getExpression(), and ILIAS\Repository\lng().

Here is the call graph for this function:

Field Documentation

$assignment_configuration_hint_message

string ilAssQuestionSkillAssignmentsGUI::$assignment_configuration_hint_message = null

private

Definition at line 63 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by getAssignmentConfigurationHintMessage().

$assignment_editing_enabled

bool ilAssQuestionSkillAssignmentsGUI::$assignment_editing_enabled

private

Definition at line 62 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by isAssignmentEditingEnabled().

$data_factory

DataFactory ilAssQuestionSkillAssignmentsGUI::$data_factory

private

Definition at line 67 of file class.ilAssQuestionSkillAssignmentsGUI.php.

$question_container_id

int ilAssQuestionSkillAssignmentsGUI::$question_container_id

private

Definition at line 61 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by getQuestionContainerId().

$question_list

ilAssQuestionList ilAssQuestionSkillAssignmentsGUI::$question_list

private

Definition at line 60 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by getQuestionList().

$questionOrderSequence

array ilAssQuestionSkillAssignmentsGUI::$questionOrderSequence

private

Definition at line 65 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by getQuestionOrderSequence(), and setQuestionOrderSequence().

CMD_EDIT_SKILL_QUEST_ASSIGNS

const ilAssQuestionSkillAssignmentsGUI::CMD_EDIT_SKILL_QUEST_ASSIGNS = 'editSkillQuestionAssignment'

Definition at line 49 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by ilAssQuestionSkillAssignmentPropertyFormGUI\build(), and modifyTabs().

CMD_SAVE_SKILL_POINTS

const ilAssQuestionSkillAssignmentsGUI::CMD_SAVE_SKILL_POINTS = 'saveSkillPoints'

Definition at line 54 of file class.ilAssQuestionSkillAssignmentsGUI.php.

CMD_SAVE_SKILL_QUEST_ASSIGN_PROPERTIES_FORM

const ilAssQuestionSkillAssignmentsGUI::CMD_SAVE_SKILL_QUEST_ASSIGN_PROPERTIES_FORM = 'saveSkillQuestionAssignmentPropertiesForm'

Definition at line 53 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by ilAssQuestionSkillAssignmentPropertyFormGUI\build(), and isAvoidManipulationRedirectRequired().

CMD_SHOW_SKILL_QUEST_ASSIGN_PROPERTIES_FORM

const ilAssQuestionSkillAssignmentsGUI::CMD_SHOW_SKILL_QUEST_ASSIGN_PROPERTIES_FORM = 'showSkillQuestionAssignmentPropertiesForm'

Definition at line 52 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by ILIAS\Test\Presentation\TabsManager\getQuestionsSubTabs().

CMD_SHOW_SKILL_QUEST_ASSIGNS

const ilAssQuestionSkillAssignmentsGUI::CMD_SHOW_SKILL_QUEST_ASSIGNS = 'showSkillQuestionAssignments'

Definition at line 48 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by ILIAS\Test\Presentation\TabsManager\getQuestionsSubTabs(), ilObjQuestionPoolGUI\getTabs(), ILIAS\TestQuestionPool\Skills\SkillsByQuestionOverviewTable\getViewControls(), ilQuestionPoolSkillAdministrationGUI\manageTabs(), and modifyTabs().

CMD_SHOW_SKILL_SELECT

const ilAssQuestionSkillAssignmentsGUI::CMD_SHOW_SKILL_SELECT = 'showSkillSelection'

Definition at line 50 of file class.ilAssQuestionSkillAssignmentsGUI.php.

CMD_SHOW_SYNC_ORIGINAL_CONFIRMATION

const ilAssQuestionSkillAssignmentsGUI::CMD_SHOW_SYNC_ORIGINAL_CONFIRMATION = 'showSyncOriginalConfirmation'

Definition at line 55 of file class.ilAssQuestionSkillAssignmentsGUI.php.

CMD_SYNC_ORIGINAL

const ilAssQuestionSkillAssignmentsGUI::CMD_SYNC_ORIGINAL = 'syncOriginal'

Definition at line 56 of file class.ilAssQuestionSkillAssignmentsGUI.php.

CMD_UPDATE_SKILL_QUEST_ASSIGNS

const ilAssQuestionSkillAssignmentsGUI::CMD_UPDATE_SKILL_QUEST_ASSIGNS = 'updateSkillQuestionAssignments'

Definition at line 51 of file class.ilAssQuestionSkillAssignmentsGUI.php.

Referenced by isAvoidManipulationRedirectRequired().

PARAM_SKILL_SELECTION

const ilAssQuestionSkillAssignmentsGUI::PARAM_SKILL_SELECTION = 'skill_ids'

Definition at line 58 of file class.ilAssQuestionSkillAssignmentsGUI.php.

---

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

• components/ILIAS/TestQuestionPool/classes/class.ilAssQuestionSkillAssignmentsGUI.php