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.

      {
        $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();
    }

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().

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.

                                         : 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;
    }

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().

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.

                                                                    : 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 "";
    }

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

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.

                                            : ?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;
    }

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

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

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.

                                             : 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;
    }

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(), ilObjSurvey\get360Mode(), ilObjSurvey\getAppraiseesData(), ilObjSurvey\getMode(), ilObjSurvey\getSurveyParticipants(), ILIAS\Repository\int(), ILIAS\Survey\Evaluation\EvaluationManager\isMultiParticipantsView(), and ilObjSurvey\MODE_SELF_EVAL.

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

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.

                                         : 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;
    }

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

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

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.

                                            : 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;
    }

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

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.

                                             : 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);*/
    }

References ILIAS\Survey\Evaluation\EvaluationManager\$access, ILIAS\Survey\Evaluation\EvaluationManager\$survey, ilObjSurvey\get360Results(), ilObjSurvey\getMode(), ilObjSurvey\getSelfEvaluationResults(), ilObjSurvey\RESULTS_360_ALL, and ilObjSurvey\RESULTS_SELF_EVAL_ALL.

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

Here is the call graph for this function:

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);
    }

References $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

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ clearAnonEvaluationAccess()

◆ getAnonEvaluationAccess()

◆ getCurrentAppraisee()

◆ getCurrentRater()

◆ getFilteredFinishedIds()

◆ getSelectableAppraisees()

◆ getSelectableRaters()

◆ getUserSpecificResults()

◆ isMultiParticipantsView()

◆ setAnonEvaluationAccess()

Field Documentation

◆ $access

◆ $domain_service

◆ $eval_repo

◆ $feature_config

◆ $repo_service

◆ $requested_appr_id

◆ $requested_rater_id

◆ $survey

◆ $user_id