class.ilIndividualAssessmentMembers.php

Go to the documentation of this file.

<?php
require_once 'Services/User/classes/class.ilObjUser.php';
require_once 'Modules/IndividualAssessment/classes/class.ilObjIndividualAssessment.php';
require_once 'Services/Tracking/classes/class.ilLPStatus.php';

class ilIndividualAssessmentMembers implements Iterator, Countable
{
    protected $member_records = array();
    protected $position = 0;
    protected $iass;

    const FIELD_FIRSTNAME = 'firstname';
    const FIELD_LASTNAME = 'lastname';
    const FIELD_LOGIN = 'login';
    const FIELD_USR_ID = 'usr_id';
    const FIELD_LEARNING_PROGRESS = 'learning_progress';
    const FIELD_EXAMINER_ID = 'examiner_id';
    const FIELD_EXAMINER_FIRSTNAME = 'examiner_firstname';
    const FIELD_EXAMINER_LASTNAME = 'examiner_lastname';
    const FIELD_CHANGER_ID = "changer_id";
    const FIELD_CHANGER_FIRSTNAME = "changer_firstname";
    const FIELD_CHANGER_LASTNAME = "changer_lastname";
    const FIELD_CHANGE_TIME = "change_time";
    const FIELD_RECORD = 'record';
    const FIELD_INTERNAL_NOTE = 'internal_note';
    const FIELD_NOTIFY = 'notify';
    const FIELD_FINALIZED = 'finalized';
    const FIELD_NOTIFICATION_TS = 'notification_ts';
    const FIELD_PLACE = "place";
    const FIELD_EVENTTIME = "event_time";
    const FIELD_FILE_NAME = "file_name";
    const FIELD_USER_VIEW_FILE = "user_view_file";

    const LP_NOT_ATTEMPTED = ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM;
    const LP_IN_PROGRESS = ilLPStatus::LP_STATUS_IN_PROGRESS_NUM;
    const LP_COMPLETED = ilLPStatus::LP_STATUS_COMPLETED_NUM;
    const LP_FAILED = ilLPStatus::LP_STATUS_FAILED_NUM;
    const LP_ASSESSMENT_NOT_COMPLETED = "not_completed";

    public function __construct(ilObjIndividualAssessment $iass)
    {
        $this->iass = $iass;
    }

    public function count()
    {
        return count($this->member_records);
    }

    public function current()
    {
        return current($this->member_records);
    }

    public function key()
    {
        return key($this->member_records);
    }

    public function next()
    {
        $this->position++;
        next($this->member_records);
    }

    public function rewind()
    {
        $this->position = 0;
        reset($this->member_records);
    }

    public function valid()
    {
        return $this->position < count($this->member_records);
    }

    public function referencedObject()
    {
        return $this->iass;
    }

    public function recordOK(array $record)
    {
        if (isset($record[self::FIELD_USR_ID])) {
            if (!$this->userExists($record[self::FIELD_USR_ID])
                || $this->userAllreadyMemberByUsrId($record[self::FIELD_USR_ID])) {
                return false;
            }
        }
        if (!in_array(
            $record[self::FIELD_LEARNING_PROGRESS],
            array(self::LP_NOT_ATTEMPTED, self::LP_FAILED, self::LP_COMPLETED, self::LP_IN_PROGRESS)
        )) {
            return false;
        }
        return true;
    }

    public function userAllreadyMemberByUsrId($usr_id)
    {
        return isset($this->member_records[$usr_id]);
    }

    public function userAllreadyMember(ilObjUser $usr)
    {
        return $this->userAllreadyMemberByUsrId($usr->getId());
    }

    protected function userExists($usr_id)
    {
        return ilObjUser::_exists($usr_id, false, 'usr');
    }

    public function withAdditionalRecord(array $record)
    {
        if ($this->recordOK($record)) {
            $clone = clone $this;
            $clone->member_records[$record[self::FIELD_USR_ID]] = $record;
            return $clone;
        }
        throw new ilIndividualAssessmentException('illdefined record');
    }

    public function withAdditionalUser(ilObjUser $usr)
    {
        if (!$this->userAllreadyMember($usr)) {
            $clone = clone $this;
            $clone->member_records[$usr->getId()] = $this->buildNewRecordOfUser($usr);
            return $clone;
        }
        throw new ilIndividualAssessmentException('User allready member');
    }

    protected function buildNewRecordOfUser(ilObjUser $usr)
    {
        return array(
              self::FIELD_USR_ID => $usr->getId()
            , self::FIELD_RECORD => $this->iass->getSettings()->recordTemplate()
            , self::FIELD_NOTIFY => 0
            , self::FIELD_FIRSTNAME => $usr->getFirstname()
            , self::FIELD_LASTNAME => $usr->getLastname()
            , self::FIELD_LOGIN => $usr->getLogin()
            , self::FIELD_LEARNING_PROGRESS => self::LP_NOT_ATTEMPTED
            , self::FIELD_EXAMINER_ID => null
            , self::FIELD_EXAMINER_FIRSTNAME => null
            , self::FIELD_EXAMINER_LASTNAME => null
            , self::FIELD_INTERNAL_NOTE => null
            , self::FIELD_FILE_NAME => null
            , self::FIELD_USER_VIEW_FILE => false
            , self::FIELD_FINALIZED => 0
            , self::FIELD_CHANGER_ID => null
            , self::FIELD_CHANGER_FIRSTNAME => null
            , self::FIELD_CHANGER_LASTNAME => null
            );
    }

    public function withoutPresentUser(ilObjUser $usr)
    {
        $usr_id = $usr->getId();
        if (isset($this->member_records[$usr_id]) && (string) $this->member_records[$usr_id][self::FIELD_FINALIZED] !== "1") {
            $clone = clone $this;
            unset($clone->member_records[$usr->getId()]);
            return $clone;
        }
        throw new ilIndividualAssessmentException('User not member or allready finished');
    }

    public function withOnlyUsersByIds($keep_users_ids)
    {
        $clone = clone $this;

        $remove = array_diff($this->membersIds(), $keep_users_ids);
        foreach ($remove as $id) {
            unset($clone->member_records[$id]);
        }

        return $clone;
    }

    public function withAccessHandling(ilOrgUnitPositionAndRBACAccessHandler $access_handler)
    {
        return $this->withOnlyUsersByIds(
            $access_handler->filterUserIdsByRbacOrPositionOfCurrentUser(
                "read_learning_progress",
                "read_learning_progress",
                $this->referencedObject()->getRefId(),
                $this->membersIds()
            )
        );
    }


    public function membersIds()
    {
        return array_keys($this->member_records);
    }
    
    public function updateStorageAndRBAC(ilIndividualAssessmentMembersStorage $storage, IndividualAssessmentAccessHandler $access_handler)
    {
        $current = $storage->loadMembers($this->referencedObject());
        $iass = $this->referencedObject();
        foreach ($this as $usr_id => $record) {
            if (!$current->userAllreadyMemberByUsrId($usr_id)) {
                $storage->insertMembersRecord($this->referencedObject(), $record);
                $access_handler->assignUserToMemberRole(new ilObjUser($usr_id), $iass);
            }
        }
        foreach ($current as $usr_id => $record) {
            if (!$this->userAllreadyMemberByUsrId($usr_id)) {
                $storage->removeMembersRecord($this->referencedObject(), $record);
                $access_handler->deassignUserFromMemberRole(new ilObjUser($usr_id), $iass);
            }
        }
    }
}