class.EvaluationManager.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Survey\Evaluation;
 
use ILIAS\Survey\InternalDomainService;
use ILIAS\Survey\InternalRepoService;
 
class EvaluationManager
{
    protected EvaluationSessionRepo $eval_repo;
    protected int $requested_appr_id;
    protected InternalDomainService $domain_service;
    protected \ilObjSurvey $survey;
    protected int $user_id;
    protected \ILIAS\Survey\Access\AccessManager $access;
    protected \ILIAS\Survey\Mode\FeatureConfig $feature_config;
    protected InternalRepoService $repo_service;
    protected string $requested_rater_id;
 
    public function __construct(
        InternalDomainService $domain_service,
        InternalRepoService $repo_service,
        \ilObjSurvey $survey,
        int $user_id,
        int $requested_appr_id,
        string $requested_rater_id
    ) {
        $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();
    }
 
    public function isMultiParticipantsView(): 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);*/
    }
 
    public function getSelectableAppraisees(): 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;
    }
 
    public function getCurrentAppraisee(): 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;
    }
 
    public function getSelectableRaters(): 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;
    }
 
    public function getCurrentRater(bool $fallback_to_first = false): 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 "";
    }
 
    public function setAnonEvaluationAccess(int $ref_id): void
    {
        $this->eval_repo->setAnonEvaluationAccess($ref_id);
    }
 
    public function getAnonEvaluationAccess(): int
    {
        return $this->eval_repo->getAnonEvaluationAccess();
    }
 
    public function clearAnonEvaluationAccess(): void
    {
        $this->eval_repo->clearAnonEvaluationAccess();
    }
 
    public function getFilteredFinishedIds(): ?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()) {
                if ($appr_id === 0) {   // #44755
                    $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;
    }
 
    public function getUserSpecificResults(): 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;
    }
}