ilPRGAssignmentActions.php File Reference

Go to the source code of this file.

Functions
	getProgressIdString (int $node_id)
	getNow ()
	getRefIdFor (int $obj_id)
	getCourseReferencesInNode (int $node_obj_id)
	hasCompletedCourseChild (ilPRGProgress $pgs)
	recalculateProgressStatus (ilStudyProgrammeSettingsRepository $settings_repo, ilPRGProgress $progress)
	updateParentProgresses (ilStudyProgrammeSettingsRepository $settings_repo, Zipper $zipper)
	updateProgressValidityFromSettings (ilStudyProgrammeValidityOfAchievedQualificationSettings $settings, ilPRGProgress $progress)
	updateProgressDeadlineFromSettings (ilStudyProgrammeDeadlineSettings $settings, ilPRGProgress $progress)
	updateProgressRelevanceFromSettings (ilStudyProgrammeSettingsRepository $settings_repo, ilPRGProgress $pgs)
	applyProgressDeadline (ilStudyProgrammeSettingsRepository $settings_repo, ilPRGProgress $progress, int $acting_usr_id=null, bool $recalculate=true)
	resetProgressToSettings (ilStudyProgrammeSettingsRepository $settings_repo, ilPRGProgress $pgs, int $acting_usr_id)
	getZipper ($node_id)
	notifyProgressSuccess (ilPRGProgress $pgs)
	notifyValidityChange (ilPRGProgress $pgs)
	notifyDeadlineChange (ilPRGProgress $pgs)
	notifyScoreChange (ilPRGProgress $pgs)
	notifyProgressRevertSuccess (ilPRGProgress $pgs)
	initAssignmentDates ()
	resetProgresses (ilStudyProgrammeSettingsRepository $settings_repo, int $acting_usr_id)
	markRelevant (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	markNotRelevant (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	markAccredited (ilStudyProgrammeSettingsRepository $settings_repo, ilStudyProgrammeEvents $events, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	unmarkAccredited (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	updatePlanFromRepository (ilStudyProgrammeSettingsRepository $settings_repo, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	succeed (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $triggering_obj_id)
	markProgressesFailedForExpiredDeadline (ilStudyProgrammeSettingsRepository $settings_repo, int $acting_usr_id)
	changeProgressDeadline (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, ?DateTimeImmutable $deadline)
	changeProgressValidityDate (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, ?DateTimeImmutable $validity_date)
	changeAmountOfPoints (ilStudyProgrammeSettingsRepository $settings_repo, int $node_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, int $points)
	invalidate (ilStudyProgrammeSettingsRepository $settings_repo)

Variables
trait	ilPRGAssignmentActions
	This trait is for (physical) separation of code only; it is actually just part of an ilPRGAssignment and MUST not be used anywhere else. More...

Function Documentation

applyProgressDeadline()

applyProgressDeadline ( ilStudyProgrammeSettingsRepository  $settings_repo, ilPRGProgress  $progress, int  $acting_usr_id = null, bool  $recalculate = true  )

protected

Definition at line 213 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        $today = $this->getNow();
        $format = ilPRGProgress::DATE_FORMAT;
        $deadline = $progress->getDeadline();
 
        if (is_null($acting_usr_id)) {
            throw new Exception('no acting user.');
            $acting_usr_id = $this->getLoggedInUserId(); //TODO !
        }
 
        switch ($progress->getStatus()) {
 
            case ilPRGProgress::STATUS_IN_PROGRESS:
                if (!is_null($deadline)
                    && $deadline->format($format) < $today->format($format)
                ) {
                    $progress = $progress->markFailed($this->getNow(), $acting_usr_id);
                    $this->notifyProgressRevertSuccess($progress);
                } else {
                    $node_settings = $settings_repo->get($progress->getNodeId());
                    $completion_mode = $node_settings->getLPMode();
                    if ($recalculate || $completion_mode !== ilStudyProgrammeSettings::MODE_LP_COMPLETED) {
                        $progress = $this->recalculateProgressStatus($settings_repo, $progress);
                    }
                }
                break;
 
            case ilPRGProgress::STATUS_FAILED:
                if (is_null($deadline)
                    || $deadline->format($format) >= $today->format($format)
                ) {
                    $progress = $progress->markNotFailed($this->getNow(), $acting_usr_id);
                    $this->notifyProgressRevertSuccess($progress);
                }
                break;
        }
 
        return $progress;
    }

Referenced by updatePlanFromRepository().

Here is the caller graph for this function:

changeAmountOfPoints()

changeAmountOfPoints	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		int	$points
	)

Definition at line 649 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id)->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo, $points): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                if ($pgs->isSuccessful()) {
                    $err_collection->add(false, 'will_not_modify_successful_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $pgs = $pgs->withAmountOfPoints($points)
                    ->withLastChange($acting_usr_id, $this->getNow())
                    ->withIndividualModifications(true);
 
                $err_collection->add(true, 'required_points_updated', $this->getProgressIdString($pgs->getNodeId()));
                $pgs = $this->recalculateProgressStatus($settings_repo, $pgs);
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), ilPRGProgress\getNodeId(), and getProgressIdString().

Here is the call graph for this function:

changeProgressDeadline()

changeProgressDeadline	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		?DateTimeImmutable	$deadline
	)

Definition at line 581 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id)->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo, $deadline): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                if ($pgs->isSuccessful()) {
                    $err_collection->add(false, 'will_not_modify_deadline_on_successful_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $pgs = $pgs->withDeadline($deadline)
                    ->withLastChange($acting_usr_id, $this->getNow())
                    ->withIndividualModifications(true);
                $pgs = $this->applyProgressDeadline($settings_repo, $pgs, $acting_usr_id);
                if ($pgs->isInProgress()) {
                    $this->notifyDeadlineChange($pgs);
                }
                $err_collection->add(true, 'deadline_updated', $this->getProgressIdString($pgs->getNodeId()));
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), ilPRGProgress\getNodeId(), and getProgressIdString().

Here is the call graph for this function:

changeProgressValidityDate()

changeProgressValidityDate	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		?DateTimeImmutable	$validity_date
	)

Definition at line 615 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id)->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo, $validity_date): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                if (!$pgs->isSuccessful()) {
                    $err_collection->add(false, 'will_not_modify_validity_on_non_successful_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $validity = is_null($validity_date) || $validity_date->format(ilPRGProgress::DATE_FORMAT) >= $this->getNow()->format(ilPRGProgress::DATE_FORMAT);
                $pgs = $pgs->withValidityOfQualification($validity_date)
                    ->withLastChange($acting_usr_id, $this->getNow())
                    ->withIndividualModifications(true)
                    ->withInvalidated(!$validity);
 
                $this->notifyValidityChange($pgs);
                $err_collection->add(true, 'validity_updated', $this->getProgressIdString($pgs->getNodeId()));
                return $pgs;
            }
        );
 
        //$zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), ilPRGProgress\getNodeId(), and getProgressIdString().

Here is the call graph for this function:

getCourseReferencesInNode()

getCourseReferencesInNode ( int  $node_obj_id )

protected

Definition at line 55 of file ilPRGAssignmentActions.php.

                                                                  : array
    {
        global $DIC; //TODO!!
        $tree = $DIC['tree']; //ilTree
        $node_ref = $this->getRefIdFor($node_obj_id);
        $children = $tree->getChildsByType($node_ref, "crsr");
        $children = array_filter(
            $children,
            fn ($c) => ilObject::_exists((int)$c['ref_id'], true)
                && is_null(ilObject::_lookupDeletedDate((int)$c['ref_id']))
                && ! is_null(ilContainerReference::_lookupTargetRefId((int) $c['obj_id']))
                && is_null(ilObject::_lookupDeletedDate(
                    (int) ilContainerReference::_lookupTargetRefId((int) $c['obj_id'])
                ))
        );
        return $children;
    }

References $c, $DIC, ilObject\_exists(), ilObject\_lookupDeletedDate(), ilContainerReference\_lookupTargetRefId(), and getRefIdFor().

Referenced by hasCompletedCourseChild().

Here is the call graph for this function:

Here is the caller graph for this function:

getNow()

getNow ( )

protected

Definition at line 41 of file ilPRGAssignmentActions.php.

                               : DateTimeImmutable
    {
        return new DateTimeImmutable();
    }

Referenced by updateParentProgresses().

Here is the caller graph for this function:

getProgressIdString()

getProgressIdString ( int  $node_id )

protected

Definition at line 31 of file ilPRGAssignmentActions.php.

                                                        : string
    {
        return sprintf(
            '%s, progress-id (%s/%s)',
            $this->user_info->getFullname(),
            $this->getId(),
            (string) $node_id
        );
    }

Referenced by changeAmountOfPoints(), changeProgressDeadline(), changeProgressValidityDate(), markNotRelevant(), and markRelevant().

Here is the caller graph for this function:

getRefIdFor()

getRefIdFor ( int  $obj_id )

protected

Definition at line 46 of file ilPRGAssignmentActions.php.

                                               : int
    {
        $refs = ilObject::_getAllReferences($obj_id);
        if (count($refs) < 1) {
            throw new ilException("Could not find ref_id for programme with obj_id $obj_id");
        }
        return (int) array_shift($refs);
    }

References ilObject\_getAllReferences().

Referenced by getCourseReferencesInNode(), ilObjStudyProgramme\getInstanceByObjId(), ilObjStudyProgramme\getObjIdsOfChildren(), and ilObjStudyProgramme\getPrgInstanceByObjId().

Here is the call graph for this function:

Here is the caller graph for this function:

getZipper()

getZipper (   $node_id )

protected

Definition at line 292 of file ilPRGAssignmentActions.php.

    {
        $progress_path = $this->getProgressForNode($node_id)->getPath();
        $zipper = new Zipper($this->getProgressTree());
        return $zipper = $zipper->toPath($progress_path);
    }

Referenced by initAssignmentDates().

Here is the caller graph for this function:

hasCompletedCourseChild()

hasCompletedCourseChild ( ilPRGProgress  $pgs )

protected

Definition at line 73 of file ilPRGAssignmentActions.php.

                                                                  : ?int
    {
        foreach ($this->getCourseReferencesInNode($pgs->getNodeId()) as $child) {
            $crs_id = ilContainerReference::_lookupTargetId((int)$child["obj_id"]);
            if (ilLPStatus::_hasUserCompleted($crs_id, $this->getUserId())) {
                return (int)$child["obj_id"];
            }
        }
        return null;
    }

References ilLPStatus\_hasUserCompleted(), ilContainerReference\_lookupTargetId(), getCourseReferencesInNode(), and ilPRGProgress\getNodeId().

Here is the call graph for this function:

initAssignmentDates()

initAssignmentDates

(

)

Definition at line 320 of file ilPRGAssignmentActions.php.

                                         : self
    {
        $zipper = $this->getZipper($this->getRootId());
        $zipper = $zipper->modifyAll(
            fn ($pgs) => $pgs->withAssignmentDate($this->getNow())
        );
        return $this->withProgressTree($zipper->getRoot());
    }

References getZipper(), and ilPRGProgress\withAssignmentDate().

Here is the call graph for this function:

invalidate()

invalidate

(

ilStudyProgrammeSettingsRepository

$settings_repo

)

Definition at line 681 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($this->getRootId());
        $touched = [];
        $now = $this->getNow();
 
        $zipper = $zipper->modifyAll(
            function ($pgs) use ($now, &$touched): ilPRGProgress {
                if (!$pgs->isSuccessful() || $pgs->hasValidQualification($now)) {
                    return $pgs;
                }
                $touched[] = $pgs->getPath();
                return $pgs->invalidate();
            }
        );
 
        foreach ($touched as $path) {
            $zipper = $this->updateParentProgresses($settings_repo, $zipper->toPath($path));
        }
 
        return $this->withProgressTree($zipper->getRoot());
    }

markAccredited()

markAccredited	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		ilStudyProgrammeEvents	$events,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 396 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id);
 
        $zipper = $zipper->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $new_status = ilPRGProgress::STATUS_ACCREDITED;
                if ($pgs->getStatus() === $new_status) {
                    $err_collection->add(false, 'status_unchanged', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                if (!$pgs->isTransitionAllowedTo($new_status)) {
                    $err_collection->add(false, 'status_transition_not_allowed', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $pgs = $pgs
                    ->markAccredited($this->getNow(), $acting_usr_id)
                    ->withCurrentAmountOfPoints($pgs->getAmountOfPoints());
                $this->notifyScoreChange($pgs);
 
                if (!$pgs->getValidityOfQualification()) {
                    $settings = $settings_repo->get($pgs->getNodeId())->getValidityOfQualificationSettings();
                    $pgs = $this->updateProgressValidityFromSettings($settings, $pgs);
                }
 
                $this->notifyProgressSuccess($pgs);
                $err_collection->add(true, 'status_changed', $this->getProgressIdString($pgs->getNodeId()));
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), ilPRGProgress\getAmountOfPoints(), ilPRGProgress\getNodeId(), ilPRGProgress\getStatus(), ilPRGProgress\getValidityOfQualification(), if, ilPRGProgress\isRelevant(), ilPRGProgress\isTransitionAllowedTo(), ilPRGProgress\markAccredited(), and ilPRGProgress\STATUS_ACCREDITED.

Here is the call graph for this function:

markNotRelevant()

markNotRelevant	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 367 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id);
 
        if ($zipper->isTop()) {
            $err_collection->add(false, 'will_not_set_top_progress_to_irrelevant', $this->getProgressIdString($node_id));
            return $this;
        }
 
        $zipper = $zipper->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                $pgs = $pgs->markNotRelevant($this->getNow(), $acting_usr_id);
                $err_collection->add(true, 'set_to_irrelevant', $this->getProgressIdString($pgs->getNodeId()));
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), and getProgressIdString().

Here is the call graph for this function:

markProgressesFailedForExpiredDeadline()

markProgressesFailedForExpiredDeadline	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$acting_usr_id
	)

Definition at line 551 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($this->getRootId());
        $touched = [];
 
        $deadline = $this->getNow();
        $zipper = $zipper->modifyAll(
            function ($pgs) use ($acting_usr_id, $deadline, &$touched): ilPRGProgress {
                if (is_null($pgs->getDeadline())
                    || !$pgs->isInProgress()
                    || $pgs->getDeadline()->format(ilPRGProgress::DATE_FORMAT) >= $deadline->format(ilPRGProgress::DATE_FORMAT)
                ) {
                    return $pgs;
                }
 
                $touched[] = $pgs->getPath();
                $this->notifyProgressRevertSuccess($pgs);
                return $pgs->markFailed($this->getNow(), $acting_usr_id);
            }
        );
 
        foreach ($touched as $path) {
            $zipper = $this->updateParentProgresses($settings_repo, $zipper->toPath($path));
        }
 
        return $this->withProgressTree($zipper->getRoot());
    }

markRelevant()

markRelevant	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 344 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id)->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo): ilPRGProgress {
                if ($pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_relevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                $pgs = $pgs->markRelevant($this->getNow(), $acting_usr_id);
                $err_collection->add(true, 'set_to_relevant', $this->getProgressIdString($pgs->getNodeId()));
                $pgs = $this->recalculateProgressStatus($settings_repo, $pgs);
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGMessageCollection\add(), ilPRGProgress\getNodeId(), and getProgressIdString().

Here is the call graph for this function:

notifyDeadlineChange()

notifyDeadlineChange ( ilPRGProgress  $pgs )

protected

Definition at line 307 of file ilPRGAssignmentActions.php.

                                                               : void
    {
        $this->getEvents()->deadlineChange($this, $pgs->getNodeId());
    }

References ilPRGProgress\getNodeId().

Here is the call graph for this function:

notifyProgressRevertSuccess()

notifyProgressRevertSuccess ( ilPRGProgress  $pgs )

protected

Definition at line 315 of file ilPRGAssignmentActions.php.

                                                                      : void
    {
        $this->getEvents()->userRevertSuccessful($this, $pgs->getNodeId());
    }

References ilPRGProgress\getNodeId().

Here is the call graph for this function:

notifyProgressSuccess()

notifyProgressSuccess ( ilPRGProgress  $pgs )

protected

Definition at line 299 of file ilPRGAssignmentActions.php.

                                                                : void
    {
        $this->getEvents()->userSuccessful($this, $pgs->getNodeId());
    }

References ilPRGProgress\getNodeId().

Here is the call graph for this function:

notifyScoreChange()

notifyScoreChange ( ilPRGProgress  $pgs )

protected

Definition at line 311 of file ilPRGAssignmentActions.php.

                                                            : void
    {
        $this->getEvents()->scoreChange($this, $pgs->getNodeId());
    }

References ilPRGProgress\getNodeId().

Here is the call graph for this function:

notifyValidityChange()

notifyValidityChange ( ilPRGProgress  $pgs )

protected

Definition at line 303 of file ilPRGAssignmentActions.php.

                                                               : void
    {
        $this->getEvents()->validityChange($this, $pgs->getNodeId());
    }

References ilPRGProgress\getNodeId().

Here is the call graph for this function:

recalculateProgressStatus()

recalculateProgressStatus ( ilStudyProgrammeSettingsRepository  $settings_repo, ilPRGProgress  $progress  )

protected

Definition at line 84 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        if (!$progress->isRelevant()) {
            return $progress;
        }
        $node_settings = $settings_repo->get($progress->getNodeId());
        $completion_mode = $node_settings->getLPMode();
 
        switch ($completion_mode) {
            case ilStudyProgrammeSettings::MODE_UNDEFINED:
            case ilStudyProgrammeSettings::MODE_LP_COMPLETED:
                return $progress;
                break;
            case ilStudyProgrammeSettings::MODE_POINTS:
                $completing_crs_id = ilPRGProgress::COMPLETED_BY_SUBNODES;
                $achieved_points = $progress->getAchievedPointsOfChildren();
                break;
        }
 
        $progress = $progress->withCurrentAmountOfPoints($achieved_points);
        $this->notifyScoreChange($progress);
 
        $required_points = $progress->getAmountOfPoints();
        $successful = ($achieved_points >= $required_points);
 
        if ($successful && !$progress->isSuccessful()) {
            $progress = $progress
                ->withStatus(ilPRGProgress::STATUS_COMPLETED)
                ->withCompletion($completing_crs_id, $this->getNow());
 
            $this->notifyProgressSuccess($progress);
        }
 
        if (!$successful && $progress->isSuccessful()
            && $progress->getStatus() !== ilPRGProgress::STATUS_ACCREDITED
        ) {
            $progress = $progress
                ->withStatus(ilPRGProgress::STATUS_IN_PROGRESS)
                ->withCompletion(null, null)
                ->withValidityOfQualification(null);
 
            $this->notifyValidityChange($progress);
            $this->notifyProgressRevertSuccess($progress);
        }
 
        return $progress;
    }

Referenced by updateParentProgresses().

Here is the caller graph for this function:

resetProgresses()

resetProgresses	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$acting_usr_id
	)

Definition at line 329 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($this->getRootId());
        $zipper = $zipper->modifyAll(
            function ($pgs) use ($acting_usr_id, $settings_repo): ilPRGProgress {
                $pgs = $this->updateProgressRelevanceFromSettings($settings_repo, $pgs);
                $pgs = $this->resetProgressToSettings($settings_repo, $pgs, $acting_usr_id);
                return $pgs;
            }
        );
        return $this->withProgressTree($zipper->getRoot());
    }

References resetProgressToSettings(), and updateProgressRelevanceFromSettings().

Here is the call graph for this function:

resetProgressToSettings()

resetProgressToSettings ( ilStudyProgrammeSettingsRepository  $settings_repo, ilPRGProgress  $pgs, int  $acting_usr_id  )

protected

Definition at line 259 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        $settings = $settings_repo->get($pgs->getNodeId());
        if ($pgs->isRelevant()) {
            $pgs = $this->updateProgressValidityFromSettings($settings->getValidityOfQualificationSettings(), $pgs);
            $pgs = $this->updateProgressDeadlineFromSettings($settings->getDeadlineSettings(), $pgs);
        } else {
            $pgs = $pgs
                ->withValidityOfQualification(null)
                ->withDeadline(null);
            $this->notifyValidityChange($pgs);
        }
 
        $pgs = $pgs
            ->withAmountOfPoints($settings->getAssessmentSettings()->getPoints())
            ->withLastChange($acting_usr_id, $this->getNow())
            ->withIndividualModifications(false);
 
        if ($pgs->isSuccessful()) {
            $pgs = $pgs->withCurrentAmountOfPoints($pgs->getAmountOfPoints());
            $this->notifyScoreChange($pgs);
        }
 
        return $pgs;
    }

References updateProgressDeadlineFromSettings(), and updateProgressValidityFromSettings().

Referenced by resetProgresses(), and updatePlanFromRepository().

Here is the call graph for this function:

Here is the caller graph for this function:

succeed()

succeed	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$triggering_obj_id
	)

Definition at line 520 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id)->modifyFocus(
            function ($pgs) use ($settings_repo, $triggering_obj_id): ilPRGProgress {
                $deadline = $pgs->getDeadline();
                $format = ilPRGProgress::DATE_FORMAT;
                $now = $this->getNow();
                if ($pgs->isInProgress() &&
                    (is_null($deadline) || $deadline->format($format) >= $now->format($format))
                ) {
                    $pgs = $pgs->succeed($now, $triggering_obj_id)
                        ->withCurrentAmountOfPoints($pgs->getAmountOfPoints());
                    $this->notifyScoreChange($pgs);
 
                    $settings = $settings_repo->get($pgs->getNodeId());
                    $pgs = $this->updateProgressValidityFromSettings($settings->getValidityOfQualificationSettings(), $pgs);
                }
 
                $this->notifyProgressSuccess($pgs);
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

unmarkAccredited()

unmarkAccredited	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$node_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 443 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($node_id);
 
        $zipper = $zipper->modifyFocus(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo): ilPRGProgress {
                if (!$pgs->isRelevant()) {
                    $err_collection->add(false, 'will_not_modify_irrelevant_progress', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $new_status = ilPRGProgress::STATUS_IN_PROGRESS;
                if ($pgs->getStatus() === $new_status) {
                    $err_collection->add(false, 'status_unchanged', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
                if (!$pgs->isTransitionAllowedTo($new_status)
                    //special case: completion may not be revoked manually (but might be as a calculation-result of underlying progresses)
                    || $pgs->getStatus() === ilPRGProgress::STATUS_COMPLETED
                ) {
                    $err_collection->add(false, 'status_transition_not_allowed', $this->getProgressIdString($pgs->getNodeId()));
                    return $pgs;
                }
 
                $pgs = $pgs
                    ->unmarkAccredited($this->getNow(), $acting_usr_id)
                    ->withCurrentAmountOfPoints($pgs->getAchievedPointsOfChildren());
                $this->notifyScoreChange($pgs);
 
                $old_status = $pgs->getStatus();
                $pgs = $this->applyProgressDeadline($settings_repo, $pgs, $acting_usr_id);
                if ($pgs->getStatus() !== $old_status) {
                    $err_collection->add(false, 'status_changed_due_to_deadline', $this->getProgressIdString($pgs->getNodeId()));
                } else {
                    $err_collection->add(true, 'status_changed', $this->getProgressIdString($pgs->getNodeId()));
                }
                $this->notifyProgressRevertSuccess($pgs);
                return $pgs;
            }
        );
 
        $zipper = $this->updateParentProgresses($settings_repo, $zipper);
        return $this->withProgressTree($zipper->getRoot());
    }

References ilPRGProgress\getAchievedPointsOfChildren(), ilPRGProgress\getStatus(), if, ilPRGProgress\isRelevant(), ilPRGProgress\isTransitionAllowedTo(), ilPRGProgress\STATUS_COMPLETED, ilPRGProgress\STATUS_IN_PROGRESS, and ilPRGProgress\unmarkAccredited().

Here is the call graph for this function:

updateParentProgresses()

updateParentProgresses ( ilStudyProgrammeSettingsRepository  $settings_repo, Zipper  $zipper  )

protected

Definition at line 134 of file ilPRGAssignmentActions.php.

     : Zipper {
        while (!$zipper->isTop()) {
            $zipper = $zipper->toParent()
                ->modifyFocus(
                    function ($pgs) use ($settings_repo) {
                        $today = $this->getNow();
                        $format = ilPRGProgress::DATE_FORMAT;
                        $deadline = $pgs->getDeadline();
                        if (!is_null($deadline)
                            && $deadline->format($format) <= $today->format($format)
                        ) {
                            return $pgs;
                        }
                        return $this->recalculateProgressStatus($settings_repo, $pgs);
                    }
                );
        }
        return $zipper;
    }

References $format, ilPRGProgress\DATE_FORMAT, getNow(), recalculateProgressStatus(), and ILIAS\StudyProgramme\Assignment\Zipper\toParent().

Here is the call graph for this function:

updatePlanFromRepository()

updatePlanFromRepository	(	ilStudyProgrammeSettingsRepository	$settings_repo,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 492 of file ilPRGAssignmentActions.php.

     : self {
        $zipper = $this->getZipper($this->getRootId());
        $leafs = [];
        $zipper = $zipper->modifyAll(
            function ($pgs) use ($err_collection, $acting_usr_id, $settings_repo, &$leafs): ilPRGProgress {
                $pgs = $this->updateProgressRelevanceFromSettings($settings_repo, $pgs);
                $pgs = $this->resetProgressToSettings($settings_repo, $pgs, $acting_usr_id);
                $pgs = $this->applyProgressDeadline($settings_repo, $pgs, $acting_usr_id, false);
                if (!$pgs->getSubnodes()) {
                    $leafs[] = $pgs->getPath();
                }
 
                return $pgs;
            }
        );
 
        foreach ($leafs as $path) {
            $zipper = $this->updateParentProgresses($settings_repo, $zipper->toPath($path));
        }
 
        return $this->withProgressTree($zipper->getRoot());
    }

References applyProgressDeadline(), ILIAS\StudyProgramme\Assignment\Node\getPath(), ILIAS\StudyProgramme\Assignment\Node\getSubnodes(), resetProgressToSettings(), and updateProgressRelevanceFromSettings().

Here is the call graph for this function:

updateProgressDeadlineFromSettings()

updateProgressDeadlineFromSettings ( ilStudyProgrammeDeadlineSettings  $settings, ilPRGProgress  $progress  )

protected

Definition at line 181 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        $period = $settings->getDeadlinePeriod();
        $date = $settings->getDeadlineDate();
 
        if ($period) {
            $date = $progress->getAssignmentDate();
            $date = $date->add(new DateInterval('P' . $period . 'D'));
        }
        $this->notifyDeadlineChange($progress);
        return $progress->withDeadline($date);
    }

References ilPRGProgress\getAssignmentDate().

Referenced by resetProgressToSettings().

Here is the call graph for this function:

Here is the caller graph for this function:

updateProgressRelevanceFromSettings()

updateProgressRelevanceFromSettings ( ilStudyProgrammeSettingsRepository  $settings_repo, ilPRGProgress  $pgs  )

protected

Definition at line 196 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        $programme_status = $settings_repo->get($pgs->getNodeId())->getAssessmentSettings()->getStatus();
        $active = $programme_status === ilStudyProgrammeSettings::STATUS_ACTIVE;
 
        if ($active && !$pgs->isRelevant()) {
            $pgs = $pgs->withStatus(ilPRGProgress::STATUS_IN_PROGRESS);
        }
        if (!$active && $pgs->isInProgress()) {
            $pgs = $pgs->withStatus(ilPRGProgress::STATUS_NOT_RELEVANT);
        }
        return $pgs;
    }

References ilPRGProgress\STATUS_IN_PROGRESS, and ilPRGProgress\withStatus().

Referenced by resetProgresses(), and updatePlanFromRepository().

Here is the call graph for this function:

Here is the caller graph for this function:

updateProgressValidityFromSettings()

updateProgressValidityFromSettings ( ilStudyProgrammeValidityOfAchievedQualificationSettings  $settings, ilPRGProgress  $progress  )

protected

Definition at line 158 of file ilPRGAssignmentActions.php.

     : ilPRGProgress {
        $cdate = $progress->getCompletionDate();
        if (!$cdate
            || $progress->isSuccessful() === false
        ) {
            return $progress;
        }
        $period = $settings->getQualificationPeriod();
        $date = $settings->getQualificationDate();
 
        if ($period) {
            $date = $cdate->add(new DateInterval('P' . $period . 'D'));
        }
 
        $validity = is_null($date) || $date->format(ilPRGProgress::DATE_FORMAT) >= $this->getNow()->format(ilPRGProgress::DATE_FORMAT);
        $this->notifyValidityChange($progress);
        return $progress->withValidityOfQualification($date)
            ->withInvalidated(!$validity);
    }

Referenced by resetProgressToSettings().

Here is the caller graph for this function:

Variable Documentation

ilPRGAssignmentActions

trait ilPRGAssignmentActions

Initial value:

{
    abstract public function getEvents(): StudyProgrammeEvents

This trait is for (physical) separation of code only; it is actually just part of an ilPRGAssignment and MUST not be used anywhere else.

Definition at line 27 of file ilPRGAssignmentActions.php.