ILIAS\Survey\Evaluation\EvaluationManager Class Reference

Evaluation manager. More...

Collaboration diagram for ILIAS\Survey\Evaluation\EvaluationManager:

Public Member Functions
	__construct (InternalDomainService $domain_service, InternalRepoService $repo_service, \ilObjSurvey $survey, int $user_id, int $requested_appr_id, string $requested_rater_id)
	isMultiParticipantsView ()
	Can the current user switch between participants and see their results? More...
	getSelectableAppraisees ()
	Get all participants the current user may see results from, including itself. More...
	getCurrentAppraisee ()
	1) We have a set of selectable appraisees. More...
	getSelectableRaters ()
	Only the individual feedback mode allows to select raters and only, if the user cannot select appraisees on top level. More...
	getCurrentRater (bool $fallback_to_first=false)
	setAnonEvaluationAccess (int $ref_id)
	getAnonEvaluationAccess ()
	clearAnonEvaluationAccess ()
	getFilteredFinishedIds ()
	getUserSpecificResults ()

Protected Attributes
EvaluationSessionRepo	$eval_repo
int	$requested_appr_id
InternalDomainService	$domain_service
ilObjSurvey	$survey
int	$user_id
ILIAS Survey Access AccessManager	$access
ILIAS Survey Mode FeatureConfig	$feature_config
InternalRepoService	$repo_service
string	$requested_rater_id

Detailed Description

Evaluation manager.

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 31 of file class.EvaluationManager.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Survey\Evaluation\EvaluationManager::__construct	(	InternalDomainService	$domain_service,
		InternalRepoService	$repo_service,
		\ilObjSurvey	$survey,
		int	$user_id,
		int	$requested_appr_id,
		string	$requested_rater_id
	)

Definition at line 43 of file class.EvaluationManager.php.

References ILIAS\Survey\Evaluation\EvaluationManager\$domain_service, ILIAS\Survey\Evaluation\EvaluationManager\$repo_service, ILIAS\Survey\Evaluation\EvaluationManager\$requested_appr_id, ILIAS\Survey\Evaluation\EvaluationManager\$requested_rater_id, ILIAS\Survey\Evaluation\EvaluationManager\$survey, ILIAS\Survey\Evaluation\EvaluationManager\$user_id, ILIAS\Repository\access(), ilObjSurvey\getMode(), and ilObject\getRefId().

      {
        $this->domain_service = $domain_service;
        $this->repo_service = $repo_service;
        $this->access = $this->domain_service->access($survey->getRefId(), $user_id);
        $this->feature_config = $this->domain_service->modeFeatureConfig($survey->getMode());
        $this->survey = $survey;
        $this->user_id = $user_id;
        $this->requested_appr_id = $requested_appr_id;
        $this->requested_rater_id = $requested_rater_id;
        $this->eval_repo = $this->repo_service->evaluation();
    }

Here is the call graph for this function:

Member Function Documentation

clearAnonEvaluationAccess()

ILIAS\Survey\Evaluation\EvaluationManager::clearAnonEvaluationAccess

(

)

Definition at line 207 of file class.EvaluationManager.php.

                                               : void
    {
        $this->eval_repo->clearAnonEvaluationAccess();
    }

getAnonEvaluationAccess()

ILIAS\Survey\Evaluation\EvaluationManager::getAnonEvaluationAccess

(

)

Definition at line 202 of file class.EvaluationManager.php.

                                             : int
    {
        return $this->eval_repo->getAnonEvaluationAccess();
    }

getCurrentAppraisee()

ILIAS\Survey\Evaluation\EvaluationManager::getCurrentAppraisee

(

)

1) We have a set of selectable appraisees.

• If the requested appraisee is within this set, the requested apraisee will be returned.
• If no appraisee is requested and the current user is part of the set, the current user will be returned.
• Otherwise the first selectable appraisee will be returned. In all other cases 0 will be returned.

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

References ILIAS\Survey\Evaluation\EvaluationManager\$requested_appr_id, ILIAS\Survey\Evaluation\EvaluationManager\$user_id, $valid, and ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees().

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getFilteredFinishedIds(), and ILIAS\Survey\Evaluation\EvaluationManager\getSelectableRaters().

                                         : int
    {
        $req_appr_id = $this->requested_appr_id;

        // if no user is requested, request current user
        $user_id = $this->user_id;
        if ($req_appr_id === 0) {
            $req_appr_id = $user_id;
        }


        // requested appraisee is valid -> return appraisee
        $valid = $this->getSelectableAppraisees();
        if (in_array($req_appr_id, $valid)) {
            return $req_appr_id;
        }

        // we have at least one selectable appraisee -> return appraisee
        if (count($valid) > 0) {
            return current($valid);
        }

        return 0;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentRater()

ILIAS\Survey\Evaluation\EvaluationManager::getCurrentRater

(

bool

$fallback_to_first = false

)

Definition at line 181 of file class.EvaluationManager.php.

References ILIAS\Survey\Evaluation\EvaluationManager\$requested_rater_id, $valid, and ILIAS\Survey\Evaluation\EvaluationManager\getSelectableRaters().

                                                                    : string
    {
        $req_rater_id = $this->requested_rater_id;

        $valid = array_map(static function ($i): string {
            return (string) $i["user_id"];
        }, $this->getSelectableRaters());
        if (in_array($req_rater_id, $valid, true)) {
            return $req_rater_id;
        }
        if ($fallback_to_first && count($this->getSelectableRaters()) > 0) {
            return $this->getSelectableRaters()[0]["user_id"];
        }
        return "";
    }

Here is the call graph for this function:

getFilteredFinishedIds()

ILIAS\Survey\Evaluation\EvaluationManager::getFilteredFinishedIds

(

)

Parameters

int

$appr_id

Returns

array|null : null means, nothing is filtered (=all), [] means "no finish id"

Definition at line 216 of file class.EvaluationManager.php.

References ILIAS\Repository\access(), ILIAS\Survey\Evaluation\EvaluationManager\getCurrentAppraisee(), ilObjSurvey\MODE_IND_FEEDB, ilObjSurvey\MODE_SELF_EVAL, null, and ilObjSurvey\RESULTS_SELF_EVAL_ALL.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getUserSpecificResults().

                                            : ?array
    {
        $appr_id = $this->getCurrentAppraisee();
        $finished_ids = null;

        $filter = false;
        if ($appr_id > 0) {
            $filter = true;
            // see #36336
            if ($this->survey->getMode() === \ilObjSurvey::MODE_SELF_EVAL &&
            $this->survey->getSelfEvaluationResults() === \ilObjSurvey::RESULTS_SELF_EVAL_ALL) {
                $filter = false;
            }
            // see #36336, #36378
            if ($this->survey->getMode() !== \ilObjSurvey::MODE_IND_FEEDB &&
                $this->access->canEditSettings()) {
                $filter = false;
            }
        }

        if ($filter) {
            $finished_ids = $this->survey->getFinishedIdsForAppraiseeId($appr_id);
            if (!count($finished_ids)) {
                $finished_ids = [];
            }
        }

        // @todo (from SM 2018)
        // filter finished ids
        /*
        $finished_ids2 = $this->access->filterUserIdsByRbacOrPositionOfCurrentUser(
            'read_results',
            'access_results',
            $this->survey->getRefId(),
            (array) $finished_ids
        );*/

        return $finished_ids;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSelectableAppraisees()

ILIAS\Survey\Evaluation\EvaluationManager::getSelectableAppraisees

(

)

Get all participants the current user may see results from, including itself.

Returns

int[]

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

References ILIAS\Survey\Evaluation\EvaluationManager\$access, ILIAS\Survey\Evaluation\EvaluationManager\$feature_config, ILIAS\Survey\Evaluation\EvaluationManager\$survey, ILIAS\Survey\Evaluation\EvaluationManager\$user_id, ilObjUser\_lookupId(), ILIAS\Repository\int(), ILIAS\Survey\Evaluation\EvaluationManager\isMultiParticipantsView(), and ilObjSurvey\MODE_SELF_EVAL.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getCurrentAppraisee().

                                             : array
    {
        $survey = $this->survey;
        $user_id = $this->user_id;
        $access = $this->access;
        $feature_config = $this->feature_config;

        $appraisee_ids = [];
        if ($this->isMultiParticipantsView()) {     // the user may see results of "others"
            if ($feature_config->usesAppraisees()) {
                foreach ($survey->getAppraiseesData() as $item) {
                    if (!$survey->get360Mode() || $item["closed"]) {
                        $appraisee_ids[] = (int) $item["user_id"];
                    }
                }
            } elseif ($survey->getMode() === \ilObjSurvey::MODE_SELF_EVAL) {
                foreach ($survey->getSurveyParticipants() as $item) {
                    $appraisee_ids[] = (int) \ilObjUser::_lookupId($item['login']);
                }
            }
        } elseif ($feature_config->usesAppraisees() ||
            $survey->getMode() === \ilObjSurvey::MODE_SELF_EVAL) {
            $appraisee_ids[] = $user_id;
        }
        return $appraisee_ids;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSelectableRaters()

ILIAS\Survey\Evaluation\EvaluationManager::getSelectableRaters

(

)

Only the individual feedback mode allows to select raters and only, if the user cannot select appraisees on top level.

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

References ILIAS\Survey\Evaluation\EvaluationManager\$survey, ILIAS\Survey\Evaluation\EvaluationManager\getCurrentAppraisee(), ILIAS\Survey\Evaluation\EvaluationManager\isMultiParticipantsView(), and ilObjSurvey\MODE_IND_FEEDB.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getCurrentRater().

                                         : array
    {
        $raters = [];
        $survey = $this->survey;

        $appr_id = $this->getCurrentAppraisee();

        if ($survey->getMode() === \ilObjSurvey::MODE_IND_FEEDB
            && !$this->isMultiParticipantsView()) {
            foreach ($survey->getRatersData($appr_id) as $rater) {
                if ($rater["finished"]) {
                    $raters[] = $rater;
                }
            }
        }

        return $raters;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserSpecificResults()

ILIAS\Survey\Evaluation\EvaluationManager::getUserSpecificResults

(

)

Definition at line 256 of file class.EvaluationManager.php.

References $data, ILIAS\Survey\Evaluation\EvaluationManager\$user_id, SurveyQuestion\_instanciateQuestionEvaluation(), ILIAS\Repository\access(), ILIAS\Survey\Evaluation\EvaluationManager\getFilteredFinishedIds(), ILIAS\Repository\int(), and null.

                                            : array
    {
        $data = array();

        $finished_ids = $this->getFilteredFinishedIds();
        $participants = $this->access->canReadResultOfParticipants($finished_ids);
        foreach ($this->survey->getSurveyQuestions() as $qdata) {
            $q_eval = \SurveyQuestion::_instanciateQuestionEvaluation((int) $qdata["question_id"], $finished_ids);
            $q_res = $q_eval->getResults();

            // see #28507 (matrix question without a row)
            if (is_array($q_res) && !is_object($q_res[0][1])) {
                continue;
            }

            $question = is_array($q_res)
                ? $q_res[0][1]->getQuestion()
                : $q_res->getQuestion();

            foreach ($participants as $user) {
                $user_id = (int) $user["active_id"];

                $parsed_results = $q_eval->parseUserSpecificResults($q_res, $user_id);

                if (!array_key_exists($user_id, $data)) {
                    $wt = $this->survey->getWorkingtimeForParticipant($user_id);

                    $finished = $user["finished"]
                        ? $user["finished_tstamp"]
                        : false;

                    $data[$user_id] = array(
                        "username" => $user["sortname"],
                        "question" => $question->getTitle(),
                        "results" => $parsed_results,
                        "workingtime" => $wt,
                        "finished" => $finished,
                        "subitems" => array()
                    );
                } else {
                    $data[$user_id]["subitems"][] = array(
                        "username" => " ",
                        "question" => $question->getTitle(),
                        "results" => $parsed_results,
                        "workingtime" => null,
                        "finished" => null
                    );
                }
            }
        }

        return $data;
    }

Here is the call graph for this function:

isMultiParticipantsView()

ILIAS\Survey\Evaluation\EvaluationManager::isMultiParticipantsView

(

)

Can the current user switch between participants and see their results?

This is true for tutors (can edit settings) or normal users, if the mode supports to see the results of others.

Definition at line 68 of file class.EvaluationManager.php.

References ILIAS\Survey\Evaluation\EvaluationManager\$access, ILIAS\Survey\Evaluation\EvaluationManager\$survey, ilObjSurvey\RESULTS_360_ALL, and ilObjSurvey\RESULTS_SELF_EVAL_ALL.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees(), and ILIAS\Survey\Evaluation\EvaluationManager\getSelectableRaters().

                                             : bool
    {
        $survey = $this->survey;
        $access = $this->access;

        switch ($survey->getMode()) {
            case \ilObjSurvey::MODE_360:
                return ($access->canEditSettings() ||
                    $survey->get360Results() === \ilObjSurvey::RESULTS_360_ALL);
                // tutors can switch appraisees on detailed evaluation screen
            case \ilObjSurvey::MODE_IND_FEEDB:
                return ($access->canEditSettings());
            case \ilObjSurvey::MODE_SELF_EVAL:
                return ($access->canEditSettings() ||
                    $survey->getSelfEvaluationResults() === \ilObjSurvey::RESULTS_SELF_EVAL_ALL);
        }
        return false;

        /*
        return ($access->canEditSettings() ||
            $survey->get360Results() === \ilObjSurvey::RESULTS_360_ALL ||
            $survey->getSelfEvaluationResults() === \ilObjSurvey::RESULTS_SELF_EVAL_ALL);*/
    }

Here is the caller graph for this function:

setAnonEvaluationAccess()

ILIAS\Survey\Evaluation\EvaluationManager::setAnonEvaluationAccess

(

int

$ref_id

)

Definition at line 197 of file class.EvaluationManager.php.

                                                        : void
    {
        $this->eval_repo->setAnonEvaluationAccess($ref_id);
    }

Field Documentation

$access

ILIAS Survey Access AccessManager ILIAS\Survey\Evaluation\EvaluationManager::$access

protected

Definition at line 38 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees(), and ILIAS\Survey\Evaluation\EvaluationManager\isMultiParticipantsView().

$domain_service

InternalDomainService ILIAS\Survey\Evaluation\EvaluationManager::$domain_service

protected

Definition at line 35 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct().

$eval_repo

EvaluationSessionRepo ILIAS\Survey\Evaluation\EvaluationManager::$eval_repo

protected

Definition at line 33 of file class.EvaluationManager.php.

$feature_config

ILIAS Survey Mode FeatureConfig ILIAS\Survey\Evaluation\EvaluationManager::$feature_config

protected

Definition at line 39 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees().

$repo_service

InternalRepoService ILIAS\Survey\Evaluation\EvaluationManager::$repo_service

protected

Definition at line 40 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct().

$requested_appr_id

int ILIAS\Survey\Evaluation\EvaluationManager::$requested_appr_id

protected

Definition at line 34 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct(), and ILIAS\Survey\Evaluation\EvaluationManager\getCurrentAppraisee().

$requested_rater_id

string ILIAS\Survey\Evaluation\EvaluationManager::$requested_rater_id

protected

Definition at line 41 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct(), and ILIAS\Survey\Evaluation\EvaluationManager\getCurrentRater().

$survey

ilObjSurvey ILIAS\Survey\Evaluation\EvaluationManager::$survey

protected

Definition at line 36 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct(), ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees(), ILIAS\Survey\Evaluation\EvaluationManager\getSelectableRaters(), and ILIAS\Survey\Evaluation\EvaluationManager\isMultiParticipantsView().

$user_id

int ILIAS\Survey\Evaluation\EvaluationManager::$user_id

protected

Definition at line 37 of file class.EvaluationManager.php.

Referenced by ILIAS\Survey\Evaluation\EvaluationManager\__construct(), ILIAS\Survey\Evaluation\EvaluationManager\getCurrentAppraisee(), ILIAS\Survey\Evaluation\EvaluationManager\getSelectableAppraisees(), and ILIAS\Survey\Evaluation\EvaluationManager\getUserSpecificResults().

---

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

• components/ILIAS/Survey/Evaluation/class.EvaluationManager.php