For the purpose of streamlining the grading and learning-process status definition outside of tests, SCORM courses e.t.c. More...

Collaboration diagram for ilIndividualAssessmentMembersGUI:

Public Member Functions
	__construct (ilObjIndividualAssessment $object, ilCtrl $ctrl, ilGlobalPageTemplate $tpl, ilLanguage $lng, ilToolbarGUI $toolbar, ilObjUser $user, ilTabsGUI $tabs, IndividualAssessmentAccessHandler $iass_access, UI\Factory $factory, UI\Renderer $renderer, ilErrorHandling $error_object, ilIndividualAssessmentMemberGUI $member_gui, ILIAS\Refinery\Factory $refinery, ILIAS\HTTP\Wrapper\WrapperFactory $wrapper, ilIndividualAssessmentDateFormatter $date_formatter)

	executeCommand ()

	addUsersFromSearch (array $user_ids)

	addUsers (array $user_ids)
	Add users to corresponding iass-object. More...

	removeUser ()
	Remove users from corresponding iass-object. More...

	handleAccessViolation ()

Data Fields
const	F_STATUS = "status"

const	F_SORT = "sortation"

const	S_NAME_ASC = "user_login:asc"

const	S_NAME_DESC = "user_login:desc"

const	S_EXAMINER_ASC = "examiner_login:asc"

const	S_EXAMINER_DESC = "examiner_login:desc"

const	S_CHANGETIME_ASC = "change_time:asc"

const	S_CHANGETIME_DESC = "change_time:desc"

Protected Member Functions
	addedUsers ()

	view ()

	removeUserConfirmation ()
	Display confirmation form for user might be removed. More...

	getViewControls ()

	getModeControl (ViewControl\Factory $vc_factory)

	getSortationControl (ViewControl\Factory $vc_factory)

	getModeOptions ()

	getActiveLabelForModeByFilter ($filter)

	getLinkForStatusFilter ($value)

	getFilterValue ()

	getSortOptions ()

	getSortValue ()

	txt (string $code)

Protected Attributes
ilCtrl	$ctrl

ilObjIndividualAssessment	$object

int	$ref_id

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

ilToolbarGUI	$toolbar

ilObjUser	$user

ilTabsGUI	$tabs

IndividualAssessmentAccessHandler	$iass_access

UI Factory	$factory

UI Renderer	$renderer

ilErrorHandling	$error_object

ilIndividualAssessmentMemberGUI	$member_gui

ILIAS Refinery Factory	$refinery

ILIAS HTTP Wrapper RequestWrapper	$request_wrapper

ILIAS HTTP Wrapper ArrayBasedRequestWrapper	$post_wrapper

ilIndividualAssessmentDateFormatter	$date_formatter

Detailed Description

For the purpose of streamlining the grading and learning-process status definition outside of tests, SCORM courses e.t.c.

the IndividualAssessment is used. It carries a LPStatus, which is set Individually.

@ilCtrl_Calls ilIndividualAssessmentMembersGUI: ilRepositorySearchGUI @ilCtrl_Calls ilIndividualAssessmentMembersGUI: ilIndividualAssessmentMemberGUI

Definition at line 32 of file class.ilIndividualAssessmentMembersGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilIndividualAssessmentMembersGUI::__construct	(	ilObjIndividualAssessment	$object,
		ilCtrl	$ctrl,
		ilGlobalPageTemplate	$tpl,
		ilLanguage	$lng,
		ilToolbarGUI	$toolbar,
		ilObjUser	$user,
		ilTabsGUI	$tabs,
		IndividualAssessmentAccessHandler	$iass_access,
		UI\Factory	$factory,
		UI\Renderer	$renderer,
		ilErrorHandling	$error_object,
		ilIndividualAssessmentMemberGUI	$member_gui,
		ILIAS\Refinery\Factory	$refinery,
		ILIAS\HTTP\Wrapper\WrapperFactory	$wrapper,
		ilIndividualAssessmentDateFormatter	$date_formatter
	)

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

      {
        $this->object = $object;
        $this->ctrl = $ctrl;
        $this->tpl = $tpl;
        $this->lng = $lng;
        $this->toolbar = $toolbar;
        $this->user = $user;
        $this->tabs = $tabs;
        $this->iass_access = $iass_access;
        $this->factory = $factory;
        $this->renderer = $renderer;
        $this->error_object = $error_object;
        $this->member_gui = $member_gui;
        $this->refinery = $refinery;
        $this->request_wrapper = $wrapper->query();
        $this->post_wrapper = $wrapper->post();
        $this->date_formatter = $date_formatter;
 
        $this->ref_id = $object->getRefId();
    }

References $ctrl, $date_formatter, $error_object, $factory, $iass_access, $lng, $member_gui, $object, $refinery, $renderer, $tabs, $toolbar, $tpl, $user, ILIAS\Repository\ctrl(), factory(), ilObject\getRefId(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), renderer(), ILIAS\Repository\tabs(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ addedUsers()

ilIndividualAssessmentMembersGUI::addedUsers ( )

protected

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

                                   : void
    {
        $r = $this->refinery;
        if ($this->request_wrapper->retrieve('failure', $r->byTrying([$r->kindlyTo()->bool(), $r->always(false)]))) {
            $this->tpl->setOnScreenMessage("failure", $this->txt('iass_add_user_failure'));
        } else {
            $this->tpl->setOnScreenMessage("success", $this->txt('iass_add_user_success'));
        }
        $this->view();
    }

References $refinery, txt(), and view().

Here is the call graph for this function:

◆ addUsers()

ilIndividualAssessmentMembersGUI::addUsers ( array $user_ids )

Add users to corresponding iass-object.

To be used by repository search.

Parameters

int | string[] $user_ids

Definition at line 221 of file class.ilIndividualAssessmentMembersGUI.php.

                                             : void
    {
        if (!$this->iass_access->mayEditMembers()) {
            $this->handleAccessViolation();
        }
        $iass = $this->object;
        $members = $iass->loadMembers();
        $failure = null;
        if (count($user_ids) === 0) {
            $failure = 1;
        }
        foreach ($user_ids as $user_id) {
            $user = new ilObjUser($user_id);
            if (!$members->userAllreadyMember($user)) {
                $members = $members->withAdditionalUser($user);
            } else {
                $failure = 1;
            }
        }
        $members->updateStorageAndRBAC($iass->membersStorage(), $iass->accessHandler());
        ilIndividualAssessmentLPInterface::updateLPStatusByIds($iass->getId(), $user_ids);
        $this->ctrl->setParameter($this, 'failure', $failure);
        $this->ctrl->redirect($this, 'addedUsers');
    }

References $object, $user, $user_id, ILIAS\Repository\ctrl(), handleAccessViolation(), ilObjIndividualAssessment\loadMembers(), and ilIndividualAssessmentLPInterface\updateLPStatusByIds().

Referenced by addUsersFromSearch().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addUsersFromSearch()

ilIndividualAssessmentMembersGUI::addUsersFromSearch ( array $user_ids )

Parameters

int[]

Definition at line 206 of file class.ilIndividualAssessmentMembersGUI.php.

                                                       : void
    {
        if (!empty($user_ids)) {
            $this->addUsers($user_ids);
        }
 
        $this->tpl->setOnScreenMessage("info", $this->txt("search_no_selection"), true);
        $this->ctrl->redirect($this, 'view');
    }

References addUsers(), ILIAS\Repository\ctrl(), and txt().

Here is the call graph for this function:

◆ executeCommand()

ilIndividualAssessmentMembersGUI::executeCommand ( )

Definition at line 99 of file class.ilIndividualAssessmentMembersGUI.php.

                                    : void
    {
        if (!$this->iass_access->mayEditMembers()
            && !$this->iass_access->mayGradeAnyUser()
            && !$this->iass_access->mayViewAnyUser()
            && !$this->iass_access->mayAmendAllUsers()
        ) {
            $this->handleAccessViolation();
        }
        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass();
        $this->ctrl->saveParameterByClass("ilIndividualAssessmentMembersGUI", self::F_STATUS);
        $this->tpl->setPermanentLink("iass", $this->ref_id);
 
        switch ($next_class) {
            case "ilrepositorysearchgui":
                $rep_search = new ilRepositorySearchGUI();
                $rep_search->setCallback($this, "addUsersFromSearch");
                $rep_search->addUserAccessFilterCallable(
                    function ($a_user_ids) {
                        return $a_user_ids;
                    }
                );
                $this->ctrl->forwardCommand($rep_search);
                break;
            case "ilindividualassessmentmembergui":
                $this->tabs->clearTargets();
                $this->tabs->setBackTarget(
                    $this->lng->txt('back'),
                    $this->ctrl->getLinkTargetByClass(self::class, 'view')
                );
                $this->ctrl->forwardCommand($this->member_gui);
                break;
            default:
                if (!$cmd) {
                    $cmd = 'view';
                }
                $this->$cmd();
                break;
        }
    }

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

Here is the call graph for this function:

◆ getActiveLabelForModeByFilter()

ilIndividualAssessmentMembersGUI::getActiveLabelForModeByFilter ( $filter )

protected

Parameters

int | string | null $filter

Definition at line 358 of file class.ilIndividualAssessmentMembersGUI.php.

                                                             : string
    {
        switch ($filter) {
            case ilIndividualAssessmentMembers::LP_ASSESSMENT_NOT_COMPLETED:
                return $this->txt("iass_filter_not_started");
            case ilIndividualAssessmentMembers::LP_IN_PROGRESS:
                return $this->txt("iass_filter_not_finalized");
            case ilIndividualAssessmentMembers::LP_COMPLETED:
                return $this->txt("iass_filter_finalized");
            case ilIndividualAssessmentMembers::LP_FAILED:
                return $this->txt("iass_filter_failed");
            default:
                return $this->txt("iass_filter_all");
        }
    }

References ilIndividualAssessmentMembers\LP_ASSESSMENT_NOT_COMPLETED, ilIndividualAssessmentMembers\LP_COMPLETED, ilIndividualAssessmentMembers\LP_FAILED, ilIndividualAssessmentMembers\LP_IN_PROGRESS, and txt().

Here is the call graph for this function:

◆ getFilterValue()

ilIndividualAssessmentMembersGUI::getFilterValue ( )

protected

Definition at line 389 of file class.ilIndividualAssessmentMembersGUI.php.

                                       : ?string
    {
        if (
            $this->request_wrapper->has(self::F_STATUS) &&
            $this->request_wrapper->retrieve(self::F_STATUS, $this->refinery->kindlyTo()->string()) != "" &&
            in_array(
                $this->request_wrapper->retrieve(self::F_STATUS, $this->refinery->kindlyTo()->string()),
                [
                    ilIndividualAssessmentMembers::LP_ASSESSMENT_NOT_COMPLETED,
                    ilIndividualAssessmentMembers::LP_IN_PROGRESS,
                    ilIndividualAssessmentMembers::LP_COMPLETED,
                    ilIndividualAssessmentMembers::LP_FAILED
                ]
            )
        ) {
            return $this->request_wrapper->retrieve(self::F_STATUS, $this->refinery->kindlyTo()->string());
        }
 
        return null;
    }

References ilIndividualAssessmentMembers\LP_ASSESSMENT_NOT_COMPLETED, ilIndividualAssessmentMembers\LP_COMPLETED, ilIndividualAssessmentMembers\LP_FAILED, ilIndividualAssessmentMembers\LP_IN_PROGRESS, and ILIAS\Repository\refinery().

Referenced by view().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLinkForStatusFilter()

ilIndividualAssessmentMembersGUI::getLinkForStatusFilter ( $value )

protected

Parameters

int | string | null $value

Definition at line 377 of file class.ilIndividualAssessmentMembersGUI.php.

                                                     : string
    {
        $this->ctrl->setParameterByClass("ilIndividualAssessmentMembersGUI", self::F_SORT, $this->getSortValue());
        $this->ctrl->setParameterByClass("ilIndividualAssessmentMembersGUI", self::F_STATUS, $value);
        $link = $this->ctrl->getLinkTargetByClass("ilIndividualAssessmentMembersGUI", "view");
        $this->ctrl->setParameterByClass("ilIndividualAssessmentMembersGUI", self::F_STATUS, null);
 
        $this->ctrl->setParameterByClass("ilIndividualAssessmentMembersGUI", self::F_SORT, null);
 
        return $link;
    }

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

Referenced by getModeOptions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getModeControl()

ilIndividualAssessmentMembersGUI::getModeControl ( ViewControl\Factory $vc_factory )

protected

Definition at line 304 of file class.ilIndividualAssessmentMembersGUI.php.

                                                                      : ViewControl\Mode
    {
        $vc = $vc_factory->mode(
            $this->getModeOptions(),
            ""
        );
 
        if ($this->request_wrapper->has(self::F_STATUS)) {
            $vc = $vc->withActive(
                $this->request_wrapper->retrieve(
                    self::F_STATUS,
                    $this->refinery->kindlyTo()->string()
                )
            );
        }
 
        return $vc;
    }

References getModeOptions(), and ILIAS\UI\Component\ViewControl\Mode\withActive().

Referenced by getViewControls().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getModeOptions()

ilIndividualAssessmentMembersGUI::getModeOptions ( )

protected

Returns: string[]

Definition at line 336 of file class.ilIndividualAssessmentMembersGUI.php.

                                       : array
    {
        $ret = [];
 
        $ret[$this->txt("iass_filter_all")] = $this->getLinkForStatusFilter(null);
 
        if ($this->iass_access->mayViewAnyUser()) {
            $ret[$this->txt("iass_filter_not_started")] =
                $this->getLinkForStatusFilter(ilIndividualAssessmentMembers::LP_ASSESSMENT_NOT_COMPLETED);
            $ret[$this->txt("iass_filter_not_finalized")] =
                $this->getLinkForStatusFilter(ilIndividualAssessmentMembers::LP_IN_PROGRESS);
            $ret[$this->txt("iass_filter_finalized")] =
                $this->getLinkForStatusFilter(ilIndividualAssessmentMembers::LP_COMPLETED);
            $ret[$this->txt("iass_filter_failed")] =
                $this->getLinkForStatusFilter(ilIndividualAssessmentMembers::LP_FAILED);
        }
        return $ret;
    }

References getLinkForStatusFilter(), ilIndividualAssessmentMembers\LP_ASSESSMENT_NOT_COMPLETED, ilIndividualAssessmentMembers\LP_COMPLETED, ilIndividualAssessmentMembers\LP_FAILED, ilIndividualAssessmentMembers\LP_IN_PROGRESS, and txt().

Referenced by getModeControl().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSortationControl()

ilIndividualAssessmentMembersGUI::getSortationControl ( ViewControl\Factory $vc_factory )

protected

Definition at line 323 of file class.ilIndividualAssessmentMembersGUI.php.

                                                                           : ViewControl\Sortation
    {
        $target = $this->ctrl->getLinkTargetByClass("ilIndividualAssessmentMembersGUI", "view");
        return $vc_factory->sortation(
            $this->getSortOptions(),
            $this->getSortValue() ?? self::S_NAME_ASC
        )
        ->withTargetURL($target, self::F_SORT);
    }

References ILIAS\Repository\ctrl(), getSortOptions(), and getSortValue().

Referenced by getViewControls().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSortOptions()

ilIndividualAssessmentMembersGUI::getSortOptions ( )

protected

Definition at line 410 of file class.ilIndividualAssessmentMembersGUI.php.

                                       : array
    {
        return [
            self::S_NAME_ASC => $this->txt("iass_sort_name_asc"),
            self::S_NAME_DESC => $this->txt("iass_sort_name_desc"),
            self::S_EXAMINER_ASC => $this->txt("iass_sort_examiner_login_asc"),
            self::S_EXAMINER_DESC => $this->txt("iass_sort_examiner_login_desc"),
            self::S_CHANGETIME_ASC => $this->txt("iass_sort_changetime_asc"),
            self::S_CHANGETIME_DESC => $this->txt("iass_sort_changetime_desc")
        ];
    }

References txt().

Referenced by getSortationControl().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSortValue()

ilIndividualAssessmentMembersGUI::getSortValue ( )

protected

Definition at line 422 of file class.ilIndividualAssessmentMembersGUI.php.

                                     : ?string
    {
        if (
            $this->request_wrapper->has(self::F_SORT) &&
            $this->request_wrapper->retrieve(self::F_SORT, $this->refinery->kindlyTo()->string()) != "" &&
            in_array(
                $this->request_wrapper->retrieve(self::F_SORT, $this->refinery->kindlyTo()->string()),
                [
                    self::S_NAME_ASC,
                    self::S_NAME_DESC,
                    self::S_EXAMINER_ASC,
                    self::S_EXAMINER_DESC,
                    self::S_CHANGETIME_ASC,
                    self::S_CHANGETIME_DESC
                ]
            )
        ) {
            return $this->request_wrapper->retrieve(self::F_SORT, $this->refinery->kindlyTo()->string());
        }
 
        return null;
    }

References ILIAS\Repository\refinery().

Referenced by getLinkForStatusFilter(), getSortationControl(), and view().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getViewControls()

ilIndividualAssessmentMembersGUI::getViewControls ( )

protected

Returns: ILIAS\UI\Component\Component[]

Definition at line 291 of file class.ilIndividualAssessmentMembersGUI.php.

                                        : array
    {
        $ret = array();
 
        $vc_factory = $this->factory->viewControl();
 
        $sort = $this->getSortationControl($vc_factory);
        $ret[] = $this->getModeControl($vc_factory);
        $ret[] = $sort;
 
        return $ret;
    }

References factory(), getModeControl(), and getSortationControl().

Referenced by ILIAS\UI\Implementation\Component\Table\Ordering\applyViewControls(), and view().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleAccessViolation()

ilIndividualAssessmentMembersGUI::handleAccessViolation ( )

Definition at line 445 of file class.ilIndividualAssessmentMembersGUI.php.

                                           : void
    {
        $this->error_object->raiseError($this->txt("msg_no_perm_read"), $this->error_object->WARNING);
    }

References txt().

Referenced by addUsers(), executeCommand(), removeUser(), and removeUserConfirmation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeUser()

ilIndividualAssessmentMembersGUI::removeUser ( )

Remove users from corresponding iass-object.

To be used by repository search.

Definition at line 273 of file class.ilIndividualAssessmentMembersGUI.php.

                                : void
    {
        if (!$this->iass_access->mayEditMembers()) {
            $this->handleAccessViolation();
        }
        $usr_id = $this->request_wrapper->retrieve("usr_id", $this->refinery->kindlyTo()->int());
        $iass = $this->object;
        $iass->loadMembers()
            ->withoutPresentUser(new ilObjUser($usr_id))
            ->updateStorageAndRBAC($iass->membersStorage(), $iass->accessHandler());
        ilIndividualAssessmentLPInterface::updateLPStatusByIds($iass->getId(), array($usr_id));
        $this->tpl->setOnScreenMessage("success", $this->txt("iass_user_removed"), true);
        $this->ctrl->redirect($this, 'view');
    }

References $object, ILIAS\Repository\ctrl(), handleAccessViolation(), ilObjIndividualAssessment\loadMembers(), ILIAS\Repository\refinery(), txt(), and ilIndividualAssessmentLPInterface\updateLPStatusByIds().

Here is the call graph for this function:

◆ removeUserConfirmation()

ilIndividualAssessmentMembersGUI::removeUserConfirmation ( )

protected

Display confirmation form for user might be removed.

Definition at line 249 of file class.ilIndividualAssessmentMembersGUI.php.

                                               : void
    {
        if (!$this->iass_access->mayEditMembers()) {
            $this->handleAccessViolation();
        }
        $usr_id = $this->request_wrapper->retrieve("usr_id", $this->refinery->kindlyTo()->int());
        $message = $this->lng->txt('iass_remove_user_qst');
 
        $this->ctrl->setParameterByClass(self::class, 'usr_id', $usr_id);
        $remove = $this->ctrl->getFormAction($this, 'removeUser');
        $cancel = $this->ctrl->getFormAction($this, 'view');
        $this->ctrl->clearParameterByClass(self::class, 'usr_id');
 
        $buttons = [
            $this->factory->button()->standard($this->lng->txt('remove'), $remove),
            $this->factory->button()->standard($this->lng->txt('cancel'), $cancel)
        ];
        $message_box = $this->factory->messageBox()->confirmation($message)->withButtons($buttons);
        $this->tpl->setContent($this->renderer->render($message_box));
    }

References $message, ILIAS\Repository\ctrl(), factory(), handleAccessViolation(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and renderer().

Here is the call graph for this function:

◆ txt()

ilIndividualAssessmentMembersGUI::txt ( string $code )

protected

Definition at line 450 of file class.ilIndividualAssessmentMembersGUI.php.

                                        : string
    {
        return $this->lng->txt($code);
    }

References ILIAS\Repository\lng().

Referenced by addedUsers(), addUsersFromSearch(), getActiveLabelForModeByFilter(), getModeOptions(), getSortOptions(), handleAccessViolation(), removeUser(), and view().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ view()

ilIndividualAssessmentMembersGUI::view ( )

protected

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

                             : void
    {
        if ($this->iass_access->mayEditMembers()) {
            $search_params = ['crs', 'grp'];
            $container_id = $this->object->getParentContainerIdByType($this->ref_id, $search_params);
            if ($container_id !== 0) {
                ilRepositorySearchGUI::fillAutoCompleteToolbar(
                    $this,
                    $this->toolbar,
                    array(
                    'auto_complete_name' => $this->txt('user'),
                    'submit_name' => $this->txt('add'),
                    'add_search' => true,
                    'add_from_container' => $container_id
                )
                );
            } else {
                ilRepositorySearchGUI::fillAutoCompleteToolbar(
                    $this,
                    $this->toolbar,
                    array(
                    'auto_complete_name' => $this->txt('user'),
                    'submit_name' => $this->txt('add'),
                    'add_search' => true
                )
                );
            }
        }
        $table = new ilIndividualAssessmentMembersTableGUI(
            $this,
            $this->lng,
            $this->ctrl,
            $this->iass_access,
            $this->factory,
            $this->renderer,
            $this->user,
            $this->date_formatter
        );
 
        $filter = $this->getFilterValue();
        $sort = $this->getSortValue();
 
        $entries = $this->object->loadMembersAsSingleObjects($filter, $sort);
        $table->setData($entries);
        $view_controls = $this->getViewControls();
 
        $output = $table->render($view_controls);
 
        $this->tpl->setContent($output);
    }