ilStudyProgrammeUserAssignment Class Reference

Represents one assignment of a user to a study programme. More...

Collaboration diagram for ilStudyProgrammeUserAssignment:

Public Member Functions
	__construct ($a_id_or_model)
	Throws when id does not refer to a study programme assignment. More...
	getId ()
	Get the id of the assignment. More...
	getStudyProgramme ()
	Get the program node where this assignment was made. More...
	getRootProgress ()
	Get the progress on the root node of the programme. More...
	getUserId ()
	Get the id of the user who is assigned. More...
	deassign ()
	Remove this assignment. More...
	delete ()
	Delete the assignment from database. More...
	addMissingProgresses ()
	Add missing progresses for new nodes in the programm. More...

Static Public Member Functions
static	getInstance ($a_id)
	Get an instance. More...
static	getInstancesOfUser ($a_user_id)
	Get all instances for a given user. More...
static	getInstancesForProgram ($a_program_id)
	Get all assignments that were made to the given program. More...

Data Fields
	$assignment

Detailed Description

Represents one assignment of a user to a study programme.

A user could have multiple assignments per programme.

Author

: Richard Klees richa.nosp@m.rd.k.nosp@m.lees@.nosp@m.conc.nosp@m.epts-.nosp@m.and-.nosp@m.train.nosp@m.ing..nosp@m.de

Definition at line 14 of file class.ilStudyProgrammeUserAssignment.php.

Constructor & Destructor Documentation

__construct()

ilStudyProgrammeUserAssignment::__construct

(

$a_id_or_model

)

Throws when id does not refer to a study programme assignment.

Exceptions

ilException

Parameters

int  |  ilStudyProgrammeAssignment

$a_id_or_model

Definition at line 23 of file class.ilStudyProgrammeUserAssignment.php.

                                                    {
                if ($a_id_or_model instanceof ilStudyProgrammeAssignment) {
                        $this->assignment = $a_id_or_model;
                }
                else {
                        $this->assignment = ilStudyProgrammeAssignment::find($a_id_or_model);
                }
                if ($this->assignment === null) {
                        throw new ilException("ilStudyProgrammeUserAssignment::__construct: "
                                                                 ."Unknown assignmemt id '$a_id_or_model'.");
                }
        }

Member Function Documentation

addMissingProgresses()

ilStudyProgrammeUserAssignment::addMissingProgresses

(

)

Add missing progresses for new nodes in the programm.

The new progresses will be set to not relevant.

Returns

$this

Definition at line 185 of file class.ilStudyProgrammeUserAssignment.php.

References $ilLog, ilStudyProgrammeProgress\createFor(), getId(), getStudyProgramme(), and ilStudyProgrammeProgress\STATUS_NOT_RELEVANT.

                                               {
                require_once("Modules/StudyProgramme/classes/exceptions/class.ilStudyProgrammeNoProgressForAssignmentException.php");
                
                $prg = $this->getStudyProgramme();
                $id = $this->getId();
                
                // TODO: $this could be removed as soon as support for PHP 5.3 is dropped:
                $self = $this;
                // Make $this->assignment protected again afterwards.
                $prg->applyToSubTreeNodes(function($node) use ($id, $self) {
                        try {
                                $node->getProgressForAssignment($id);
                        }
                        catch(ilStudyProgrammeNoProgressForAssignmentException $e) {
                                global $ilLog;
                                $ilLog->write("Adding progress for: ".$self->getId()." ".$node->getId());
                                require_once("Modules/StudyProgramme/classes/model/class.ilStudyProgrammeProgress.php");
                                $progress = ilStudyProgrammeProgress::createFor($node->getRawSettings(), $self->assignment);
                                $progress->setStatus(ilStudyProgrammeProgress::STATUS_NOT_RELEVANT)
                                                 ->update();
                        }
                });
                
                return $this;
        }

Here is the call graph for this function:

deassign()

ilStudyProgrammeUserAssignment::deassign

(

)

Remove this assignment.

Definition at line 139 of file class.ilStudyProgrammeUserAssignment.php.

References getStudyProgramme().

                                   {
                $this->getStudyProgramme()->removeAssignment($this);
        }

Here is the call graph for this function:

delete()

ilStudyProgrammeUserAssignment::delete

(

)

Delete the assignment from database.

Definition at line 146 of file class.ilStudyProgrammeUserAssignment.php.

References getId(), ilStudyProgrammeUserProgress\getInstancesForAssignment(), and getStudyProgramme().

Referenced by ilObjStudyProgramme\removeAssignment().

                                 {
                require_once("Modules/StudyProgramme/classes/class.ilStudyProgrammeUserProgress.php");
                $progresses = ilStudyProgrammeUserProgress::getInstancesForAssignment($this->getId());
                foreach ($progresses as $progress) {
                        $progress->delete();
                }
                
                $this->assignment->delete();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getId()

ilStudyProgrammeUserAssignment::getId

(

)

Get the id of the assignment.

Returns

int

Definition at line 94 of file class.ilStudyProgrammeUserAssignment.php.

Referenced by addMissingProgresses(), delete(), getRootProgress(), ilPDStudyProgrammeExpandableListGUI\new_ilStudyProgrammeAssignmentListGUI(), ilPDStudyProgrammeSimpleListGUI\new_ilStudyProgrammeAssignmentListGUI(), ilObjStudyProgramme\removeAssignment(), ilStudyProgrammeEvents\userAssigned(), and ilStudyProgrammeEvents\userDeassigned().

                                {
                return $this->assignment->getId();
        }

Here is the caller graph for this function:

getInstance()

static ilStudyProgrammeUserAssignment::getInstance (   $a_id )

static

Get an instance.

Just wraps constructor.

Exceptions

ilException

Parameters

int

$a_id

Returns

ilStudyProgrammeUserAssignment

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

Referenced by ilStudyProgrammeUserProgress\getAssignment(), and ilObjStudyProgrammeIndividualPlanGUI\getAssignmentObject().

                                                  {
                return new ilStudyProgrammeUserAssignment($a_id);
        }

Here is the caller graph for this function:

getInstancesForProgram()

static ilStudyProgrammeUserAssignment::getInstancesForProgram (   $a_program_id )

static

Get all assignments that were made to the given program.

Parameters

int

$a_program_id

Returns

ilStudyProgrammeUserAssignment[]

Definition at line 81 of file class.ilStudyProgrammeUserAssignment.php.

References ActiveRecord\where().

Referenced by ilObjStudyProgramme\updateAllAssignments().

                                                                     {
                $assignments = ilStudyProgrammeAssignment::where(array( "root_prg_id" => $a_program_id ))
                                                                                                        ->get();
                return array_map(function($ass) {
                        return new ilStudyProgrammeUserAssignment($ass);
                }, array_values($assignments)); // use array values since we want keys 0...
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstancesOfUser()

static ilStudyProgrammeUserAssignment::getInstancesOfUser (   $a_user_id )

static

Get all instances for a given user.

Parameters

int

$a_user_id

Returns

ilStudyProgrammeUserAssignment[]

Definition at line 53 of file class.ilStudyProgrammeUserAssignment.php.

References $ret, ilObject\_getAllReferences(), and ActiveRecord\where().

Referenced by ilStudyProgrammeAppEventListener\onServiceUserDeleteUser(), and ilPDStudyProgrammeSimpleListGUI\readUsersAssignments().

                                                              {
                global $tree;

                $assignments = ilStudyProgrammeAssignment::where(array( "usr_id" => $a_user_id ))
                                                                                                        ->get();

                //if parent object is deleted or in trash
                //the assignment for the user should not be returned
                $ret = array();
                foreach($assignments as $ass) {
                        $ass_obj =      new ilStudyProgrammeUserAssignment($ass);
                        foreach (ilObject::_getAllReferences($ass_obj->assignment->getRootId()) as $value) {
                                if($tree->isInTree($value)) {
                                        $ret[] = $ass_obj;
                                        break;
                                }
                        }
                }

                return $ret;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getRootProgress()

ilStudyProgrammeUserAssignment::getRootProgress

(

)

Get the progress on the root node of the programme.

Exceptions

ilException

Returns

ilStudyProgrammeUserProgress

Definition at line 123 of file class.ilStudyProgrammeUserAssignment.php.

References getId(), and getStudyProgramme().

                                          {
                return $this->getStudyProgramme()->getProgressForAssignment($this->getId());
        }

Here is the call graph for this function:

getStudyProgramme()

ilStudyProgrammeUserAssignment::getStudyProgramme

(

)

Get the program node where this assignment was made.

Throws when program this assignment is about has no ref id.

Exceptions

ilException

Returns

ilObjStudyProgramme

Definition at line 106 of file class.ilStudyProgrammeUserAssignment.php.

References ilObject\_getAllReferences(), and ilObjStudyProgramme\getInstanceByRefId().

Referenced by addMissingProgresses(), deassign(), delete(), getRootProgress(), ilPDStudyProgrammeSimpleListGUI\hasPermission(), ilPDStudyProgrammeExpandableListGUI\new_ilStudyProgrammeAssignmentListGUI(), ilPDStudyProgrammeSimpleListGUI\new_ilStudyProgrammeAssignmentListGUI(), ilObjStudyProgramme\removeAssignment(), ilStudyProgrammeEvents\userAssigned(), and ilStudyProgrammeEvents\userDeassigned().

                                            {
                require_once("./Modules/StudyProgramme/classes/class.ilObjStudyProgramme.php");
                $refs = ilObject::_getAllReferences($this->assignment->getRootId());
                if (!count($refs)) {
                        throw new ilException("ilStudyProgrammeUserAssignment::getStudyProgramme: "
                                                                 ."could not find ref_id for program '"
                                                                 .$this->assignment->getRootId()."'.");
                }
                return ilObjStudyProgramme::getInstanceByRefId(array_shift($refs));
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserId()

ilStudyProgrammeUserAssignment::getUserId

(

)

Get the id of the user who is assigned.

Returns

int

Definition at line 132 of file class.ilStudyProgrammeUserAssignment.php.

Referenced by ilStudyProgrammeEvents\userAssigned(), and ilStudyProgrammeEvents\userDeassigned().

                                    {
                return $this->assignment->getUserId();
        }

Here is the caller graph for this function:

Field Documentation

$assignment

ilStudyProgrammeUserAssignment::$assignment

Definition at line 15 of file class.ilStudyProgrammeUserAssignment.php.

---

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

• Modules/StudyProgramme/classes/class.ilStudyProgrammeUserAssignment.php