ilObjStudyProgramme Class Reference

Inheritance diagram for ilObjStudyProgramme:

Collaboration diagram for ilObjStudyProgramme:

Public Member Functions
	__construct (int $id=0, bool $call_by_reference=true)
	ATTENTION: After using the constructor the object won't be in the cache. More...
	getSettings ()
	updateSettings (ilStudyProgrammeSettings $settings)
	create ()
	update ()
	delete ()
	Delete Study Programme and all related data. More...
	hasAdvancedMetadata ()
	getLastChange ()
	Get the timestamp of the last change on this program or sub program. More...
	getPoints ()
	Get the amount of points. More...
	setPoints (int $points)
	Set the amount of points. More...
	getLPMode ()
	adjustLPMode ()
	Adjust the lp mode to match current state of tree: More...
	getStatus ()
	setStatus (int $a_status)
	Set the status of the node. More...
	isActive ()
	getSubType ()
	Gets the SubType Object. More...
	getAllPrgChildren ()
	getChildren (bool $include_references=false)
	Get all ilObjStudyProgrammes that are direct children of this object. More...
	getParent ()
	Get the parent ilObjStudyProgramme of this object. More...
	getReferencesToSelf ()
	getParents (bool $include_references=false)
	Get all parents of the node, where the root of the program comes first. More...
	hasChildren (bool $include_references=false)
	Does this StudyProgramme have other ilObjStudyProgrammes as children? More...
	getAmountOfChildren ($include_references=false)
	Get the amount of other StudyProgrammes this StudyProgramme has as children. More...
	getDepth ()
	Get the depth of this StudyProgramme in the tree starting at the topmost StudyProgramme (not root node of the repo tree!). More...
	getRoot ()
	Get the ilObjStudyProgramme that is the root node of the tree this programme is in. More...
	getLPChildren ()
	Get the leafs the study programme contains. More...
	getLPChildrenIds ()
	Get the obj-ids of the leafs the program contains. More...
	getAmountOfLPChildren ()
	Get the amount of leafs the study programme contains. More...
	hasLPChildren ()
	applyToSubTreeNodes (Closure $fun, bool $include_references=false)
	Apply the given Closure to every node in the subtree starting at this object. More...
	getCompletedCourses (int $usr_id)
	Get courses in this program that the given user already completed. More...
	addNode (ilObjStudyProgramme $a_prg)
	Inserts another ilObjStudyProgramme in this object. More...
	nodeInserted ($prg)
	Clears child cache and adds progress for new node. More...
	putInTree (int $parent_ref_id)
	Overwritten from ilObject. More...
	removeNode (ilObjStudyProgramme $a_prg)
	Remove a node from this object. More...
	canBeRemoved ()
	Check weather a node can be removed. More...
	moveTo (ilObjStudyProgramme $new_parent)
	Move this tree node to a new parent. More...
	assignUser (int $usr_id, int $acting_usr_id=null, $raise_event=true)
	Assign a user to this node at the study program. More...
	removeAssignment (ilPRGAssignment $assignment)
	Remove an assignment from this program. More...
	getSpecificAssignment (int $assignment_id)
	storeExpiryInfoSentFor (ilPRGAssignment $ass)
	resetExpiryInfoSentFor (ilPRGAssignment $ass)
	storeRiskyToFailSentFor (ilPRGAssignment $ass)
	resetRiskyToFailSentFor (ilPRGAssignment $ass)
	hasAssignmentOf (int $user_id)
	Check whether user is assigned to this program or any node above. More...
	getAmountOfAssignmentsOf (int $user_id)
	Get the amount of assignments a user has on this program node or any node above. More...
	getAssignmentsOf (int $user_id)
	Get the assignments of user at this program or any node above. More...
	getAssignments ()
	getMembers ()
	get usr_ids with any progress on this node More...
	getLocalMembers ()
	get usr_ids with assignment on this node More...
	hasAssignments ()
	Are there any assignments on this node or any node above? More...
	getAssignmentsOfSingleProgramForUser (int $usr_id)
	Get assignments of user to this program-node only. More...
	hasAssignmentsOfSingleProgramForUser (int $usr_id)
	Get assignments of user to this program-node only. More...
	addMissingProgresses ()
	Add missing progress records for all assignments of this programm. More...
	hasRelevantProgresses ()
	Are there any users that have a relevant progress on this programme? More...
	getIdsOfUsersWithRelevantProgress ()
	getAutomaticContentCategories ()
	Get configuration of categories with auto-content for this StudyProgramme;. More...
	hasAutomaticContentCategories ()
	storeAutomaticContentCategory (int $category_ref_id)
	Store a Category with auto-content for this StudyProgramme; a category can only be referenced once (per programme). More...
	deleteAutomaticContentCategories (array $category_ids=[])
	Delete configuration of categories with auto-content for this StudyProgramme;. More...
	deleteAllAutomaticContentCategories ()
	Delete all configuration of categories with auto-content for this StudyProgramme;. More...
	isAutoContentApplicable ()
	AutoContent should only be available in active- or draft-mode, and only, if there is no sub-programme. More...
	getAutomaticMembershipSources ()
	Get sources for auto-memberships. More...
	storeAutomaticMembershipSource (string $type, int $src_id)
	Store a source to be monitored for automatic memberships. More...
	deleteAutomaticMembershipSource (string $type, int $src_id)
	Delete a membership source. More...
	deleteAllAutomaticMembershipSources ()
	Delete all membership sources of this StudyProgramme;. More...
	disableAutomaticMembershipSource (string $type, int $src_id)
	Disable a membership source. More...
	enableAutomaticMembershipSource (string $type, int $src_id, bool $assign_now=false)
	Enable a membership source. More...
	getApplicableMembershipSourceForUser (int $usr_id, ?int $exclude_id)
	succeed (int $usr_id, int $triggering_obj_id, ilPRGAssignment $ass=null)
	updateCustomIcon ()
	markAccredited (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	unmarkAccredited (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	markNotRelevant (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	markRelevant (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection)
	changeProgressDeadline (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, ?DateTimeImmutable $deadline)
	changeProgressValidityDate (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, ?DateTimeImmutable $validity)
	changeAmountOfPoints (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection, int $points)
	updatePlanFromRepository (int $assignment_id, int $acting_usr_id, ilPRGMessageCollection $err_collection=null)
	acknowledgeCourses (int $assignment_id, array $nodes, ilPRGMessageCollection $err_collection=null)
	canBeCompleted (ilPRGProgress $progress)
	statusToRepr (int $status)
	Get a user readable representation of a status. More...
Public Member Functions inherited from ilContainer
	getTileSizes ()
	getObjectTranslation ()
	setObjectTranslation (?ilObjectTranslation $obj_trans)
	createContainerDirectory ()
	getContainerDirectory ()
	setHiddenFilesFound (bool $a_hiddenfilesfound)
	getHiddenFilesFound ()
	getStyleSheetId ()
	setStyleSheetId (int $a_style_id)
	setNewsTimeline (bool $a_val)
	getNewsTimeline ()
	setNewsTimelineAutoEntries (bool $a_val)
	getNewsTimelineAutoEntries ()
	setNewsTimelineLandingPage (bool $a_val)
	getNewsTimelineLandingPage ()
	isNewsTimelineEffective ()
	isNewsTimelineLandingPageEffective ()
	setNewsBlockActivated (bool $a_val)
	getNewsBlockActivated ()
	setUseNews (bool $a_val)
	getUseNews ()
	cloneDependencies (int $target_id, int $copy_id)
	Clone object dependencies (container sorting) More...
	cloneAllObject (string $session_id, string $client_id, string $new_type, int $ref_id, int $clone_source, array $options, bool $soap_call=false, int $a_submode=1)
	delete ()
	delete category and all related data More...
	getViewMode ()
	getOrderType ()
	setOrderType (int $a_value)
	isClassificationFilterActive ()
	filteredSubtree ()
	Note grp/crs currently allow to filter in their whole subtrees Catetories only their direct childs. More...
	getSubItems (bool $a_admin_panel_enabled=false, bool $a_include_side_block=false, int $a_get_single=0, ilContainerUserFilter $container_user_filter=null)
	gotItems ()
	addAdditionalSubItemInformation (array &$object)
	Add additional information to sub item, e.g. More...
	getGroupedObjTypes ()
	enablePageEditing ()
	create ()
	note: title, description and type should be set when this function is called More...
	putInTree (int $parent_ref_id)
	maybe this method should be in tree object!? More...
	update ()
	read ()
	readContainerSettings ()
	removeTranslations ()
	deleteTranslation (string $a_lang)
	addTranslation (string $a_title, string $a_desc, string $a_lang, string $a_lang_default)
Public Member Functions inherited from ilObject
	__construct (int $id=0, bool $reference=true)
	withReferences ()
	determines whether objects are referenced or not (got ref ids or not) More...
	processAutoRating ()
	read ()
	getId ()
	setId (int $id)
	setRefId (int $ref_id)
	getRefId ()
	getType ()
	setType (string $type)
	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...
	getTitle ()
	getUntranslatedTitle ()
	Get untranslated object title WebDAV needs to access the untranslated title of an object. More...
	setTitle (string $title)
	getDescription ()
	setDescription (string $desc)
	getLongDescription ()
	get object long description (stored in object_description) More...
	getImportId ()
	setImportId (string $import_id)
	setOfflineStatus (bool $status)
	getOfflineStatus ()
	supportsOfflineHandling ()
	getOwner ()
	getOwnerName ()
	get full name of object owner More...
	setOwner (int $usr_id)
	getCreateDate ()
	Get create date in YYYY-MM-DD HH-MM-SS format. More...
	getLastUpdateDate ()
	Get last update date in YYYY-MM-DD HH-MM-SS format. More...
	create ()
	note: title, description and type should be set when this function is called More...
	update ()
	MDUpdateListener (string $element)
	Metadata update listener. More...
	createMetaData ()
	updateMetaData ()
	deleteMetaData ()
	updateOwner ()
	update owner of object in db More...
	putInTree (int $parent_ref_id)
	maybe this method should be in tree object!? More...
	setPermissions (int $parent_ref_id)
	setParentRolePermissions (int $parent_ref_id)
	Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More...
	createReference ()
	creates reference for object More...
	countReferences ()
	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...
	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type. More...
	applyDidacticTemplate (int $tpl_id)
	getXMLZip ()
	getHTMLDirectory ()
	appendCopyInfo (int $target_id, int $copy_id)
	Prepend Copy info if object with same name exists in that container. More...
	cloneDependencies (int $target_id, int $copy_id)
	Clone object dependencies. More...
	cloneMetaData (ilObject $target_obj)
	Copy meta data. More...
	selfOrParentWithRatingEnabled ()
	getPossibleSubObjects (bool $filter=true)
	get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More...

Static Public Member Functions
static	initStudyProgrammeCache ()
static	getRefIdFor (int $obj_id)
static	getInstanceByObjId (int $obj_id)
static	getInstanceByRefId ($ref_id)
static	createInstance ()
	Create an instance of ilObjStudyProgramme, put in cache. More...
static	getAllChildren (int $a_ref_id, bool $include_references=false)
	Get a list of all ilObjStudyProgrammes in the subtree starting at $a_ref_id. More...
static	addCrsToProgrammes (int $crs_ref_id, int $cat_ref_id)
	Check, if a category is under surveilllance and automatically add the course. More...
static	removeCrsFromProgrammes (int $crs_ref_id, int $cat_ref_id)
	Check, if a category is under surveillance and automatically remove the deleted course. More...
static	addMemberToProgrammes (string $src_type, int $src_id, int $usr_id)
static	removeMemberFromProgrammes (string $src_type, int $src_id, int $usr_id)
static	setProgressesCompletedIfParentIsProgrammeInLPCompletedMode (int $ref_id, int $obj_id, int $user_id)
	Succeed all StudyProgramme(Nodes) where the object with the given id (a CRSR) is in a Programme with MODE_LP_COMPLETED. More...
static	getCreatableSubObjects (array $subobjects, $ref_id)
	Filter the list of possible subobjects for the objects that actually could be created on a concrete node. More...
Static Public Member Functions inherited from ilContainer
static	_getContainerDirectory (int $a_id)
static	_lookupContainerSetting (int $a_id, string $a_keyword, string $a_default_value=null)
static	_hasContainerSetting (int $a_id, string $a_keyword)
static	_writeContainerSetting (int $a_id, string $a_keyword, string $a_value)
static	_getContainerSettings (int $a_id)
static	_deleteContainerSettings (int $a_id, string $a_keyword="", bool $a_keyword_like=false)
static	_exportContainerSettings (ilXmlWriter $a_xml, int $a_obj_id)
static	getCompleteDescriptions (array $objects)
	overwrites description fields to long or short description in an assoc array keys needed (obj_id and description) More...
Static Public Member Functions inherited from ilObject
static	_lookupObjIdByImportId (string $import_id)
	Get (latest) object id for an import id. More...
static	_lookupImportId (int $obj_id)
static	_lookupOwnerName (int $owner_id)
	Lookup owner name for owner id. More...
static	_getIdForImportId (string $import_id)
static	_getAllReferences (int $id)
	get all reference ids for object ID More...
static	_lookupTitle (int $obj_id)
static	lookupOfflineStatus (int $obj_id)
	Lookup offline status using objectDataCache. More...
static	_lookupOwner (int $obj_id)
	Lookup owner user ID for object ID. More...
static	_getIdsForTitle (string $title, string $type='', bool $partial_match=false)
static	_lookupDescription (int $obj_id)
static	_lookupLastUpdate (int $obj_id, bool $formatted=false)
static	_getLastUpdateOfObjects (array $obj_ids)
static	_lookupObjId (int $ref_id)
static	_setDeletedDate (int $ref_id, int $deleted_by)
static	setDeletedDates (array $ref_ids, int $user_id)
static	_resetDeletedDate (int $ref_id)
static	_lookupDeletedDate (int $ref_id)
static	_writeTitle (int $obj_id, string $title)
	write title to db (static) More...
static	_writeDescription (int $obj_id, string $desc)
	write description to db (static) More...
static	_writeImportId (int $obj_id, string $import_id)
	write import id to db (static) More...
static	_lookupType (int $id, bool $reference=false)
static	_isInTrash (int $ref_id)
static	_hasUntrashedReference (int $obj_id)
	checks whether an object has at least one reference that is not in trash More...
static	_lookupObjectId (int $ref_id)
static	_getObjectsDataForType (string $type, bool $omit_trash=false)
	get all objects of a certain type More...
static	_exists (int $id, bool $reference=false, ?string $type=null)
	checks if an object exists in object_data More...
static	_getObjectsByType (string $obj_type="", int $owner=null)
static	_prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true)
	Prepare copy wizard object selection. More...
static	_getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false)
	Get icon for repository item. More...
static	collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0)
	Collect deletion dependencies. More...
static	getDeletionDependencies (int $obj_id)
	Get deletion dependencies. More...
static	getLongDescriptions (array $obj_ids)
static	getAllOwnedRepositoryObjects (int $user_id)
static	fixMissingTitles ($type, array &$obj_title_map)
	Try to fix missing object titles. More...
static	_lookupCreationDate (int $obj_id)
static	_getObjectTypeIdByTitle (string $type, \ilDBInterface $ilDB=null)

Protected Member Functions
	clearParentCache ()
	Clear the cached parent to query it again at the tree. More...
	clearChildrenCache ()
	Clear the cached children. More...
	clearLPChildrenCache ()
	Clear the cached lp children. More...
	getPrgInstanceByObjId (int $obj_id)
	getAssignmentRepository ()
	getSettingsRepository ()
	getTree ()
	getLogger ()
	deleteSettings ()
	deleteAssignmentsAndProgresses ()
	Delete all assignments from the DB. More...
	getReferencesTo (ilObjStudyProgramme $prg)
	throwIfNotInTree ()
	getMessageCollection (string $topic)
	getMembersOfMembershipSource (string $src_type, int $src_id)
	Get member-ids of a certain source. More...
	updateLastChange ()
	Update last change timestamp on this node and its parents. More...
	getLoggedInUserId ()
	getNow ()
	getObjIdsOfChildren (int $node_obj_id)
	refreshLPStatus (int $usr_id, int $node_obj_id=null)
	getProgressIdString (ilPRGAssignment $assignment, ilPRGProgress $progress)
Protected Member Functions inherited from ilContainer
	getInitialSubitems ()
	applyContainerUserFilter (array $objects, ilContainerUserFilter $container_user_filter=null)
	Apply container user filter on objects. More...
	filterObjIdsByCopyright (array $obj_ids, string $copyright_id)
	filterObjIdsByDefaultCopyright (array $obj_ids, string $default_identifier)
	legacyOnlineFilter (array $obj_ids, array $objects, int $val)
	Legacy online filter. More...
Protected Member Functions inherited from ilObject
	doMDUpdateListener (string $a_element)
	beforeMDUpdateListener (string $a_element)
	doCreateMetaData ()
	beforeCreateMetaData ()
	doUpdateMetaData ()
	beforeUpdateMetaData ()
	doDeleteMetaData ()
	beforeDeleteMetaData ()
	handleAutoRating ()
	hasAutoRating ()

Static Protected Member Functions
static	getProgrammesMonitoringCategory (int $cat_ref_id)
	Get all (not OUTDATED) StudyProgrammes monitoring this category. More...
static	getProgrammesMonitoringMemberSource (string $src_type, int $src_id)
	Get all StudyProgrammes monitoring this membership-source. More...
static	getParentId (ilObjCourseReference $leaf)
	Get the obj id of the parent object for the given object. More...

Protected Attributes
	$parent
array	$children = null
array	$lp_children = null
ilStudyProgrammeTypeDBRepository	$type_repository
ilPRGAssignmentDBRepository	$assignment_repository
ilStudyProgrammeAutoCategoryDBRepository	$auto_categories_repository
ilStudyProgrammeAutoMembershipsDBRepository	$auto_memberships_repository
ilStudyProgrammeMembershipSourceReaderFactory	$membersourcereader_factory
ilStudyProgrammeEvents	$events
ilStudyProgrammeSettingsDBRepository	$settings_repository
array	$members_cache = null
array	$reference_children = null
Filesystem	$webdir
ilObjUser	$ilUser
ilObjectFactoryWrapper	$object_factory = null
ilObjectCustomIconFactory	$custom_icon_factory
ilLogger	$logger
Protected Attributes inherited from ilContainer
ILIAS Style Content DomainService	$content_style_domain
ilNewsService	$news
ilAccessHandler	$access
ilRbacSystem	$rbacsystem
ilObjUser	$user
ilObjectDefinition	$obj_definition
int	$order_type = 0
bool	$hiddenfilesfound = false
bool	$news_timeline = false
bool	$news_timeline_auto_entries = false
ilSetting	$setting
ilObjectTranslation	$obj_trans = null
int	$style_id = 0
bool	$news_timeline_landing_page = false
bool	$news_block_activated = false
bool	$use_news = false
ilRecommendedContentManager	$recommended_content_manager
Protected Attributes inherited from ilObject
ilLogger	$obj_log
ILIAS	$ilias
ilObjectDefinition	$obj_definition
ilDBInterface	$db
ilLogger	$log
ilErrorHandling	$error
ilTree	$tree
ilAppEventHandler	$app_event_handler
ilRbacAdmin	$rbac_admin
ilRbacReview	$rbac_review
ilObjUser	$user
ilLanguage	$lng
int	$id
bool	$referenced
bool	$call_by_reference
int	$max_title = self::TITLE_LENGTH
int	$max_desc = self::DESC_LENGTH
bool	$add_dots = true
int	$ref_id = null
string	$type = ""
string	$title = ""
bool	$offline = false
string	$desc = ""
string	$long_desc = ""
int	$owner = 0
string	$create_date = ""
string	$last_update = ""
string	$import_id = ""
bool	$register = false

Static Protected Attributes
static ilObjStudyProgrammeCache	$study_programme_cache = null

Additional Inherited Members
Data Fields inherited from ilContainer
const	VIEW_SESSIONS = 0
const	VIEW_OBJECTIVE = 1
const	VIEW_TIMING = 2
const	VIEW_ARCHIVE = 3
const	VIEW_SIMPLE = 4
const	VIEW_BY_TYPE = 5
const	VIEW_INHERIT = 6
const	VIEW_DEFAULT = self::VIEW_BY_TYPE
const	SORT_TITLE = 0
const	SORT_MANUAL = 1
const	SORT_ACTIVATION = 2
const	SORT_INHERIT = 3
const	SORT_CREATION = 4
const	SORT_DIRECTION_ASC = 0
const	SORT_DIRECTION_DESC = 1
const	SORT_NEW_ITEMS_POSITION_TOP = 0
const	SORT_NEW_ITEMS_POSITION_BOTTOM = 1
const	SORT_NEW_ITEMS_ORDER_TITLE = 0
const	SORT_NEW_ITEMS_ORDER_CREATION = 1
const	SORT_NEW_ITEMS_ORDER_ACTIVATION = 2
const	TILE_NORMAL = 0
const	TILE_SMALL = 1
const	TILE_LARGE = 2
const	TILE_EXTRA_LARGE = 3
const	TILE_FULL = 4
array	$items = []
Data Fields inherited from ilObject
const	TITLE_LENGTH = 255
const	DESC_LENGTH = 128
const	LONG_DESC_LENGTH = 4000
const	TABLE_OBJECT_DATA = "object_data"
array	$objectList
string	$untranslatedTitle
Static Public Attributes inherited from ilContainer
static bool	$data_preloaded = false

Detailed Description

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

Constructor & Destructor Documentation

__construct()

ilObjStudyProgramme::__construct	(	int	$id = 0,
		bool	$call_by_reference = true
	)

ATTENTION: After using the constructor the object won't be in the cache.

This could lead to unexpected behaviour when using the tree navigation.

Reimplemented from ilObject.

Definition at line 72 of file class.ilObjStudyProgramme.php.

    {
        $dic = ilStudyProgrammeDIC::dic();
        $this->type = "prg";
 
        $this->type_repository = $dic['model.Type.ilStudyProgrammeTypeRepository'];
        $this->auto_categories_repository = $dic['model.AutoCategories.ilStudyProgrammeAutoCategoriesRepository'];
        $this->auto_memberships_repository = $dic['model.AutoMemberships.ilStudyProgrammeAutoMembershipsRepository'];
        $this->membersourcereader_factory = $dic['model.AutoMemberships.ilStudyProgrammeMembershipSourceReaderFactory'];
 
        $this->settings_repository = $dic['model.Settings.ilStudyProgrammeSettingsRepository'];
        $this->assignment_repository = $dic['repo.assignment'];
        $this->events = $dic['ilStudyProgrammeEvents'];
 
        parent::__construct($id, $call_by_reference);
 
        $this->clearParentCache();
        $this->clearChildrenCache();
        $this->clearLPChildrenCache();
 
        global $DIC;
        $tree = $DIC['tree'];
        $ilUser = $DIC['ilUser'];
        $this->webdir = $DIC->filesystem()->web();
        $this->tree = $tree;
        $this->ilUser = $ilUser;
        $this->db = $DIC['ilDB'];
        $this->lng = $DIC['lng'];
        $this->logger = ilLoggerFactory::getLogger($this->type);
 
        $this->object_factory = ilObjectFactoryWrapper::singleton();
 
        $this->custom_icon_factory = $DIC['object.customicons.factory'];
 
        self::initStudyProgrammeCache();
    }

References ilObject\$call_by_reference, $DIC, $dic, ilObject\$id, $ilUser, ilObject\$tree, ILIAS\GlobalScreen\Provider\__construct(), clearChildrenCache(), clearLPChildrenCache(), clearParentCache(), ilStudyProgrammeDIC\dic(), ilLoggerFactory\getLogger(), initStudyProgrammeCache(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), and ilObjectFactoryWrapper\singleton().

Here is the call graph for this function:

Member Function Documentation

acknowledgeCourses()

ilObjStudyProgramme::acknowledgeCourses	(	int	$assignment_id,
		array	$nodes,
		ilPRGMessageCollection	$err_collection = null
	)

Definition at line 1824 of file class.ilObjStudyProgramme.php.

     : void {
        $acting_usr_id = $this->getLoggedInUserId();
        $assignment = $this->assignment_repository->get($assignment_id);
        foreach($nodes as $nodeinfo) {
            [$node_obj_id, $course_obj_id] = $nodeinfo;
 
            $assignment = $assignment->succeed(
                $this->settings_repository,
                $node_obj_id,
                $course_obj_id
            );
 
            $msg = sprintf(
                '%s, progress-id (%s/%s)',
                $assignment->getUserInformation()->getFullname(),
                $assignment->getId(),
                (string) $node_obj_id
            );
            $err_collection->add(true, 'acknowledged_course', $msg);
        }
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

References ilPRGMessageCollection\add().

Here is the call graph for this function:

addCrsToProgrammes()

static ilObjStudyProgramme::addCrsToProgrammes ( int  $crs_ref_id, int  $cat_ref_id  )

static

Check, if a category is under surveilllance and automatically add the course.

Definition at line 1233 of file class.ilObjStudyProgramme.php.

                                                                               : void
    {
        foreach (self::getProgrammesMonitoringCategory($cat_ref_id) as $prg) {
            $course_ref = new ilObjCourseReference();
            $course_ref->setTitleType(ilContainerReference::TITLE_TYPE_REUSE);
            $course_ref->setTargetRefId($crs_ref_id);
            $course_ref->create();
            $course_ref->createReference();
            $course_ref->putInTree($prg->getRefId());
            $course_ref->setPermissions($crs_ref_id);
            $course_ref->setTargetId(ilObject::_lookupObjectId($crs_ref_id));
            $course_ref->update();
            $lp = new ilLPObjSettings($course_ref->getId());
            $lp->insert();
            $lp->setMode($lp::LP_MODE_COURSE_REFERENCE);
            $lp->update(false);
        }
    }

References ilObject\_lookupObjectId(), and ilContainerReference\TITLE_TYPE_REUSE.

Referenced by ilStudyProgrammeAppEventListener\addCrsToProgrammes().

Here is the call graph for this function:

Here is the caller graph for this function:

addMemberToProgrammes()

static ilObjStudyProgramme::addMemberToProgrammes ( string  $src_type, int  $src_id, int  $usr_id  )

static

Definition at line 1423 of file class.ilObjStudyProgramme.php.

                                                                                            : void
    {
        foreach (self::getProgrammesMonitoringMemberSource($src_type, $src_id) as $prg) {
            if ($prg->isActive() &&
                !$prg->hasAssignmentsOfSingleProgramForUser($usr_id)) {
                $assigned_by = ilStudyProgrammeAutoMembershipSource::SOURCE_MAPPING[$src_type];
                $prg->assignUser($usr_id, $assigned_by);
            }
        }
    }

References ilStudyProgrammeAutoMembershipSource\SOURCE_MAPPING.

Referenced by ilStudyProgrammeAppEventListener\addMemberToProgrammes().

Here is the caller graph for this function:

addMissingProgresses()

ilObjStudyProgramme::addMissingProgresses

(

)

Add missing progress records for all assignments of this programm.

Use this after the structure of the programme was modified, i.e.: there was a node added below this one.

Definition at line 1147 of file class.ilObjStudyProgramme.php.

                                          : void
    {
        $assignments = $this->getAssignments();
        foreach ($assignments as $ass) {
            $this->assignment_repository->store($ass);
        }
    }

References getAssignments().

Referenced by nodeInserted().

Here is the call graph for this function:

Here is the caller graph for this function:

addNode()

ilObjStudyProgramme::addNode

(

ilObjStudyProgramme

$a_prg

)

Inserts another ilObjStudyProgramme in this object.

Throws when object already contains non ilObjStudyProgrammes as children. Throws when $a_prg already is in the tree. Throws when this object is not in tree.

Parameters

ilObjStudyProgramme

$a_prg

Returns

ilObjStudyProgramme

Exceptions

ilException
ilStudyProgrammeTreeException

Definition at line 783 of file class.ilObjStudyProgramme.php.

                                                       : ilObjStudyProgramme
    {
        $this->throwIfNotInTree();
 
        if ($this->getLPMode() === ilStudyProgrammeSettings::MODE_LP_COMPLETED) {
            throw new ilStudyProgrammeTreeException("Program already contains leafs.");
        }
 
        if ($this->tree->isInTree($a_prg->getRefId())) {
            throw new ilStudyProgrammeTreeException("Other program already is in tree.");
        }
 
        if ($a_prg->getRefId() === null) {
            $a_prg->createReference();
        }
        $a_prg->putInTree($this->getRefId());
        return $this;
    }

References ilObject\createReference(), getLPMode(), ilObject\getRefId(), ilStudyProgrammeSettings\MODE_LP_COMPLETED, putInTree(), and throwIfNotInTree().

Here is the call graph for this function:

adjustLPMode()

ilObjStudyProgramme::adjustLPMode

(

)

Adjust the lp mode to match current state of tree:

If there are any non programme children, the mode is MODE_LP_COMPLETED, otherwise its MODE_POINTS.

Exceptions

ilException

when programme is not in draft mode.

Definition at line 351 of file class.ilObjStudyProgramme.php.

                                  : void
    {
        // Clear caches here, there have been some changes, because this method
        // would not have been called otherwise, and the changer just does not
        // know if we have filled the caches already...
        $this->clearLPChildrenCache();
        $this->clearChildrenCache();
 
        if ($this->tree->isInTree($this->getRefId())) {
            if ($this->getAmountOfLPChildren() > 0) {
                $this->settings_repository->update(
                    $this->getSettings()->setLPMode(ilStudyProgrammeSettings::MODE_LP_COMPLETED)
                );
            } elseif ($this->getAmountOfChildren(true) > 0) {
                $this->settings_repository->update(
                    $this->getSettings()->setLPMode(ilStudyProgrammeSettings::MODE_POINTS)
                );
            } else {
                $this->settings_repository->update(
                    $this->getSettings()->setLPMode(ilStudyProgrammeSettings::MODE_UNDEFINED)
                );
            }
        }
    }

References clearChildrenCache(), clearLPChildrenCache(), getAmountOfChildren(), getAmountOfLPChildren(), getSettings(), ilStudyProgrammeSettings\MODE_LP_COMPLETED, ilStudyProgrammeSettings\MODE_POINTS, and ilStudyProgrammeSettings\MODE_UNDEFINED.

Here is the call graph for this function:

applyToSubTreeNodes()

ilObjStudyProgramme::applyToSubTreeNodes	(	Closure	$fun,
		bool	$include_references = false
	)

Apply the given Closure to every node in the subtree starting at this object.

When the closure returns false, the underlying nodes won't be visited.

Exceptions

ilStudyProgrammeTreeException

Throws when this object is not in tree.

Definition at line 718 of file class.ilObjStudyProgramme.php.

                                                                                       : void
    {
        $this->throwIfNotInTree();
 
        if ($fun($this) !== false) {
            foreach ($this->getChildren($include_references) as $child) {
                $child->applyToSubTreeNodes($fun, $include_references);
            }
        }
    }

References getChildren(), and throwIfNotInTree().

Referenced by getAllPrgChildren().

Here is the call graph for this function:

Here is the caller graph for this function:

assignUser()

ilObjStudyProgramme::assignUser	(	int	$usr_id,
		int	$acting_usr_id = null,
			$raise_event = true
	)

Assign a user to this node at the study program.

Throws when node is in DRAFT or OUTDATED status. Throws when there are no settings for the program.

TODO: Should it be allowed to assign inactive users?

Exceptions

ilException

Definition at line 941 of file class.ilObjStudyProgramme.php.

                                                                                           : ilPRGAssignment
    {
        $this->members_cache = null;
 
        if ($this->getStatus() !== ilStudyProgrammeSettings::STATUS_ACTIVE) {
            throw new ilException(
                "ilObjStudyProgramme::assignUser: Can't assign user to program '"
                . $this->getId() . "', since it's not in active status."
            );
        }
 
        if (is_null($acting_usr_id)) {
            $acting_usr_id = $this->getLoggedInUserId();
        }
 
        $ass = $this->assignment_repository->createFor($this->getId(), $usr_id, $acting_usr_id);
        $ass = $ass
            ->initAssignmentDates();
 
        $ass = $ass->resetProgresses(
            $this->getSettingsRepository(),
            $acting_usr_id
        );
 
        $this->assignment_repository->store($ass);
 
        if ($raise_event) {
            $this->events->userAssigned($ass);
        }
        return $ass;
    }

References ilObject\getId(), getLoggedInUserId(), getSettingsRepository(), getStatus(), and ilStudyProgrammeSettings\STATUS_ACTIVE.

Referenced by enableAutomaticMembershipSource().

Here is the call graph for this function:

Here is the caller graph for this function:

canBeCompleted()

ilObjStudyProgramme::canBeCompleted

(

ilPRGProgress

$progress

)

Definition at line 1852 of file class.ilObjStudyProgramme.php.

                                                           : bool
    {
        if ($this->getLPMode() == ilStudyProgrammeSettings::MODE_LP_COMPLETED) {
            return true;
        }
        $possible_points = $progress->getPossiblePointsOfRelevantChildren();
        return $possible_points >= $progress->getAmountOfPoints();
    }

References ilPRGProgress\getAmountOfPoints(), ilPRGProgress\getPossiblePointsOfRelevantChildren(), and ilStudyProgrammeSettings\MODE_LP_COMPLETED.

Here is the call graph for this function:

canBeRemoved()

ilObjStudyProgramme::canBeRemoved

(

)

Check weather a node can be removed.

This is allowed when all progresses on the node are marked as not relevant programmatically.

Definition at line 880 of file class.ilObjStudyProgramme.php.

                                  : bool
    {
        return ! $this->hasRelevantProgresses();
    }

References hasRelevantProgresses().

Referenced by removeNode().

Here is the call graph for this function:

Here is the caller graph for this function:

changeAmountOfPoints()

ilObjStudyProgramme::changeAmountOfPoints	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		int	$points
	)

Definition at line 1788 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->changeAmountOfPoints(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection,
                $points
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

changeProgressDeadline()

ilObjStudyProgramme::changeProgressDeadline	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		?DateTimeImmutable	$deadline
	)

Definition at line 1748 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->changeProgressDeadline(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection,
                $deadline
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

changeProgressValidityDate()

ilObjStudyProgramme::changeProgressValidityDate	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection,
		?DateTimeImmutable	$validity
	)

Definition at line 1768 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->changeProgressValidityDate(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection,
                $validity
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

clearChildrenCache()

ilObjStudyProgramme::clearChildrenCache ( )

protected

Clear the cached children.

Definition at line 128 of file class.ilObjStudyProgramme.php.

                                           : void
    {
        $this->children = null;
    }

Referenced by __construct(), adjustLPMode(), moveTo(), nodeInserted(), and removeNode().

Here is the caller graph for this function:

clearLPChildrenCache()

ilObjStudyProgramme::clearLPChildrenCache ( )

protected

Clear the cached lp children.

Definition at line 136 of file class.ilObjStudyProgramme.php.

                                             : void
    {
        $this->lp_children = null;
    }

Referenced by __construct(), adjustLPMode(), and moveTo().

Here is the caller graph for this function:

clearParentCache()

ilObjStudyProgramme::clearParentCache ( )

protected

Clear the cached parent to query it again at the tree.

Definition at line 119 of file class.ilObjStudyProgramme.php.

                                         : void
    {
        // This is not initialized, but we need null if there is no parent.
        $this->parent = false;
    }

Referenced by __construct(), moveTo(), and removeNode().

Here is the caller graph for this function:

create()

ilObjStudyProgramme::create

(

)

Exceptions

ilException

Reimplemented from ilContainer.

Definition at line 236 of file class.ilObjStudyProgramme.php.

                            : int
    {
        $id = (int) parent::create();
        $this->getSettingsRepository()->createFor($id);
        return $id;
    }

References ilObject\$id, getSettingsRepository(), and ILIAS\Repository\int().

Here is the call graph for this function:

createInstance()

static ilObjStudyProgramme::createInstance ( )

static

Create an instance of ilObjStudyProgramme, put in cache.

Exceptions

ilException

Definition at line 190 of file class.ilObjStudyProgramme.php.

                                           : ilObjStudyProgramme
    {
        $obj = new ilObjStudyProgramme();
        $obj->create();
        $obj->createReference();
        self::$study_programme_cache->addInstance($obj);
        return $obj;
    }

delete()

ilObjStudyProgramme::delete

(

)

Delete Study Programme and all related data.

Exceptions

ilException

Reimplemented from ilContainer.

Definition at line 270 of file class.ilObjStudyProgramme.php.

                            : bool
    {
        // always call parent delete function first!!
        if (!parent::delete()) {
            return false;
        }
 
        $this->deleteSettings();
        $this->deleteAssignmentsAndProgresses();
        try {
            $this->auto_categories_repository->deleteFor($this->getId());
        } catch (ilStudyProgrammeTreeException $e) {
            // This would be the case when SP is in trash (#17797)
        }
 
        $this->deleteAllAutomaticContentCategories();
        $this->deleteAllAutomaticMembershipSources();
 
        $this->events->raise('delete', ['object' => $this, 'obj_id' => $this->getId()]);
        return true;
    }

References Vendor\Package\$e, deleteAllAutomaticContentCategories(), deleteAllAutomaticMembershipSources(), deleteAssignmentsAndProgresses(), deleteSettings(), and ilObject\getId().

Here is the call graph for this function:

deleteAllAutomaticContentCategories()

ilObjStudyProgramme::deleteAllAutomaticContentCategories

(

)

Delete all configuration of categories with auto-content for this StudyProgramme;.

Definition at line 1225 of file class.ilObjStudyProgramme.php.

                                                         : void
    {
        $this->auto_categories_repository->deleteFor($this->getId());
    }

References ilObject\getId().

Referenced by delete().

Here is the call graph for this function:

Here is the caller graph for this function:

deleteAllAutomaticMembershipSources()

ilObjStudyProgramme::deleteAllAutomaticMembershipSources

(

)

Delete all membership sources of this StudyProgramme;.

Definition at line 1355 of file class.ilObjStudyProgramme.php.

                                                         : void
    {
        $this->auto_memberships_repository->deleteFor($this->getId());
    }

References ilObject\getId().

Referenced by delete().

Here is the call graph for this function:

Here is the caller graph for this function:

deleteAssignmentsAndProgresses()

ilObjStudyProgramme::deleteAssignmentsAndProgresses ( )

protected

Delete all assignments from the DB.

Exceptions

ilException

Definition at line 228 of file class.ilObjStudyProgramme.php.

                                                       : void
    {
        $this->assignment_repository->deleteAllAssignmentsForProgrammeId($this->getId());
    }

References ilObject\getId().

Referenced by delete().

Here is the call graph for this function:

Here is the caller graph for this function:

deleteAutomaticContentCategories()

ilObjStudyProgramme::deleteAutomaticContentCategories

(

array

$category_ids = []

)

Delete configuration of categories with auto-content for this StudyProgramme;.

Parameters

int[]

$category_ids

Definition at line 1217 of file class.ilObjStudyProgramme.php.

                                                                              : void
    {
        $this->auto_categories_repository->delete($this->getId(), $category_ids);
    }

References ilObject\getId().

Here is the call graph for this function:

deleteAutomaticMembershipSource()

ilObjStudyProgramme::deleteAutomaticMembershipSource	(	string	$type,
		int	$src_id
	)

Delete a membership source.

Definition at line 1347 of file class.ilObjStudyProgramme.php.

                                                                              : void
    {
        $this->auto_memberships_repository->delete($this->getId(), $type, $src_id);
    }

References ilObject\getId().

Here is the call graph for this function:

deleteSettings()

ilObjStudyProgramme::deleteSettings ( )

protected

Definition at line 218 of file class.ilObjStudyProgramme.php.

                                       : void
    {
        $this->getSettingsRepository()->delete($this->getSettings());
    }

References getSettings(), and getSettingsRepository().

Referenced by delete().

Here is the call graph for this function:

Here is the caller graph for this function:

disableAutomaticMembershipSource()

ilObjStudyProgramme::disableAutomaticMembershipSource	(	string	$type,
		int	$src_id
	)

Disable a membership source.

Definition at line 1363 of file class.ilObjStudyProgramme.php.

                                                                               : void
    {
        $ams = $this->auto_memberships_repository->create($this->getId(), $type, $src_id, false);
        $this->auto_memberships_repository->update($ams);
    }

References ilObject\getId().

Here is the call graph for this function:

enableAutomaticMembershipSource()

ilObjStudyProgramme::enableAutomaticMembershipSource	(	string	$type,
		int	$src_id,
		bool	$assign_now = false
	)

Enable a membership source.

Exceptions

ilException

Definition at line 1373 of file class.ilObjStudyProgramme.php.

                                                                                                        : void
    {
        if ($assign_now) {
            $assigned_by = ilStudyProgrammeAutoMembershipSource::SOURCE_MAPPING[$type];
            $member_ids = $this->getMembersOfMembershipSource($type, $src_id);
            foreach ($member_ids as $usr_id) {
                if (!$this->getAssignmentsOfSingleProgramForUser($usr_id)) {
                    $this->assignUser($usr_id, $assigned_by);
                }
            }
        }
        $ams = $this->auto_memberships_repository->create($this->getId(), $type, $src_id, true);
        $this->auto_memberships_repository->update($ams);
    }

References ilObject\$type, assignUser(), getAssignmentsOfSingleProgramForUser(), ilObject\getId(), getMembersOfMembershipSource(), and ilStudyProgrammeAutoMembershipSource\SOURCE_MAPPING.

Here is the call graph for this function:

getAllChildren()

static ilObjStudyProgramme::getAllChildren ( int  $a_ref_id, bool  $include_references = false  )

static

Get a list of all ilObjStudyProgrammes in the subtree starting at $a_ref_id.

Throws when object is not in tree.

Returns

ilObjStudyProgramme[]

Definition at line 428 of file class.ilObjStudyProgramme.php.

                                                                                          : array
    {
        $ret = array();
        $root = self::getInstanceByRefId($a_ref_id);
        $root_id = $root->getId();
        $root->applyToSubTreeNodes(function (ilObjStudyProgramme $prg) use (&$ret, $root_id) {
            // exclude root node of subtree.
            if ($prg->getId() === $root_id) {
                return;
            }
            $ret[] = $prg;
        }, $include_references);
        return $ret;
    }

References ilObject\getId(), and getInstanceByRefId().

Referenced by ilObjStudyProgrammeTreeGUI\confirmedDelete().

Here is the call graph for this function:

Here is the caller graph for this function:

getAllPrgChildren()

ilObjStudyProgramme::getAllPrgChildren

(

)

Definition at line 443 of file class.ilObjStudyProgramme.php.

                                       : array
    {
        $ret = [];
        $this->applyToSubTreeNodes(
            function (ilObjStudyProgramme $prg) use (&$ret) {
                if ($prg->getId() === $this->getId()) {
                    return;
                }
                $ret[] = $prg;
            }
        );
        return $ret;
    }

References applyToSubTreeNodes(), and ilObject\getId().

Here is the call graph for this function:

getAmountOfAssignmentsOf()

ilObjStudyProgramme::getAmountOfAssignmentsOf

(

int

$user_id

)

Get the amount of assignments a user has on this program node or any node above.

Definition at line 1039 of file class.ilObjStudyProgramme.php.

                                                          : int
    {
        return count($this->getAssignmentsOf($user_id));
    }

References getAssignmentsOf().

Referenced by hasAssignmentOf().

Here is the call graph for this function:

Here is the caller graph for this function:

getAmountOfChildren()

ilObjStudyProgramme::getAmountOfChildren

(

$include_references = false

)

Get the amount of other StudyProgrammes this StudyProgramme has as children.

Exceptions

ilStudyProgrammeTreeException

when this object is not in tree.

Definition at line 604 of file class.ilObjStudyProgramme.php.

                                                                    : int
    {
        return count($this->getChildren($include_references));
    }

References getChildren().

Referenced by adjustLPMode(), hasChildren(), and isAutoContentApplicable().

Here is the call graph for this function:

Here is the caller graph for this function:

getAmountOfLPChildren()

ilObjStudyProgramme::getAmountOfLPChildren

(

)

Get the amount of leafs the study programme contains.

Exceptions

when	this object is not in tree.

Definition at line 687 of file class.ilObjStudyProgramme.php.

                                           : int
    {
        return count($this->getLPChildren());
    }

References getLPChildren().

Referenced by adjustLPMode(), and hasLPChildren().

Here is the call graph for this function:

Here is the caller graph for this function:

getApplicableMembershipSourceForUser()

ilObjStudyProgramme::getApplicableMembershipSourceForUser	(	int	$usr_id,
		?int	$exclude_id
	)

Definition at line 1460 of file class.ilObjStudyProgramme.php.

     : ?ilStudyProgrammeAutoMembershipSource {
        foreach ($this->getAutomaticMembershipSources() as $ams) {
            $src_id = $ams->getSourceId();
            if ($src_id !== $exclude_id
                && $ams->isEnabled()
            ) {
                $source_members = $this->getMembersOfMembershipSource($ams->getSourceType(), $src_id);
                if (in_array($usr_id, $source_members)) {
                    return $ams;
                }
            }
        }
        return null;
    }

References getMembersOfMembershipSource(), and ilStudyProgrammeAutoMembershipSource\getSourceId().

Here is the call graph for this function:

getAssignmentRepository()

ilObjStudyProgramme::getAssignmentRepository ( )

protected

Definition at line 168 of file class.ilObjStudyProgramme.php.

                                                : PRGAssignmentRepository
    {
        return $this->assignment_repository;
    }

References $assignment_repository.

getAssignments()

ilObjStudyProgramme::getAssignments

(

)

Returns

ilPRGAssignment[]

Definition at line 1070 of file class.ilObjStudyProgramme.php.

                                    : array
    {
        return $this->assignment_repository->getAllForNodeIsContained($this->getId());
    }

References ilObject\getId().

Referenced by addMissingProgresses(), and getMembers().

Here is the call graph for this function:

Here is the caller graph for this function:

getAssignmentsOf()

ilObjStudyProgramme::getAssignmentsOf

(

int

$user_id

)

Get the assignments of user at this program or any node above.

The assignments are ordered by last_change, where the most recently changed assignment is the first one.

Returns

ilPRGAssignment[]

Definition at line 1051 of file class.ilObjStudyProgramme.php.

                                                  : array
    {
        $assignments = $this->assignment_repository->getAllForNodeIsContained(
            $this->getId(),
            [$user_id]
        );
 
        usort($assignments, function ($a_one, $a_other) {
            return strcmp(
                $a_one->getLastChange()->format('Y-m-d'),
                $a_other->getLastChange()->format('Y-m-d')
            );
        });
        return $assignments;
    }

References ilObject\getId().

Referenced by getAmountOfAssignmentsOf().

Here is the call graph for this function:

Here is the caller graph for this function:

getAssignmentsOfSingleProgramForUser()

ilObjStudyProgramme::getAssignmentsOfSingleProgramForUser

(

int

$usr_id

)

Get assignments of user to this program-node only.

Returns

ilPRGAssignment[]

Definition at line 1124 of file class.ilObjStudyProgramme.php.

                                                                     : array
    {
        return $this->assignment_repository->getAllForSpecificNode($this->getId(), [$usr_id]);
    }

References ilObject\getId().

Referenced by enableAutomaticMembershipSource(), and hasAssignmentsOfSingleProgramForUser().

Here is the call graph for this function:

Here is the caller graph for this function:

getAutomaticContentCategories()

ilObjStudyProgramme::getAutomaticContentCategories

(

)

Get configuration of categories with auto-content for this StudyProgramme;.

Returns

ilStudyProgrammeAutoCategory[]

Definition at line 1189 of file class.ilObjStudyProgramme.php.

                                                   : array
    {
        return $this->auto_categories_repository->getFor($this->getId());
    }

References ilObject\getId().

Referenced by hasAutomaticContentCategories().

Here is the call graph for this function:

Here is the caller graph for this function:

getAutomaticMembershipSources()

ilObjStudyProgramme::getAutomaticMembershipSources

(

)

Get sources for auto-memberships.

Returns

ilStudyProgrammeAutoMembershipSource[]

Definition at line 1330 of file class.ilObjStudyProgramme.php.

                                                   : array
    {
        return $this->auto_memberships_repository->getFor($this->getId());
    }

References ilObject\getId().

Here is the call graph for this function:

getChildren()

ilObjStudyProgramme::getChildren

(

bool

$include_references = false

)

Get all ilObjStudyProgrammes that are direct children of this object.

Returns

ilObjStudyProgramme[]

Exceptions

ilStudyProgrammeTreeException

when this object is not in tree.

Definition at line 464 of file class.ilObjStudyProgramme.php.

                                                                 : array
    {
        $this->throwIfNotInTree();
 
        if ($this->children === null) {
            $ref_ids = $this->tree->getChildsByType($this->getRefId(), "prg");
 
            // apply container sorting to tree
            $sorting = ilContainerSorting::_getInstance($this->getId());
            $ref_ids = $sorting->sortItems(array('prg' => $ref_ids));
            $ref_ids = $ref_ids['prg'];
 
            $this->children = array_map(static function ($node_data) {
                return ilObjStudyProgramme::getInstanceByRefId($node_data["child"]);
            }, $ref_ids);
        }
 
        if ($include_references && $this->reference_children === null) {
            $this->reference_children = [];
            $ref_child_ref_ids = $this->tree->getChildsByType($this->getRefId(), "prgr");
            foreach ($this->children as $prg) {
                $ref_child_ref_ids =
                    array_merge(
                        $this->tree->getChildsByType($prg->getRefId(), "prgr"),
                        $ref_child_ref_ids
                    );
            }
            foreach (
                array_unique(
                    array_map(
                        static function ($data) {
                            return (int) $data['child'];
                        },
                        array_filter($ref_child_ref_ids, static function ($data) {
                            return $data["deleted"] === null;
                        })
                    )
                ) as $prg_ref_id
            ) {
                $this->reference_children[] =
                    (new ilObjStudyProgrammeReference($prg_ref_id))->getReferencedObject();
            }
        }
        return $include_references ?
            array_merge($this->children, $this->reference_children) :
            $this->children;
    }

References $children, $data, ilContainerSorting\_getInstance(), ilObject\getId(), getInstanceByRefId(), ilObject\getRefId(), and throwIfNotInTree().

Referenced by applyToSubTreeNodes(), getAmountOfChildren(), and ilStudyProgrammeProgressListGUI\showMoreObjectsInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

getCompletedCourses()

ilObjStudyProgramme::getCompletedCourses

(

int

$usr_id

)

Get courses in this program that the given user already completed.

Returns

int[]

Definition at line 734 of file class.ilObjStudyProgramme.php.

                                                    : array
    {
        $node_data = $this->tree->getNodeData($this->getRefId());
        $crsrs = $this->tree->getSubTree($node_data, true, ["crsr"]);
 
        $completed_crss = array();
        foreach ($crsrs as $ref) {
            $crs_id = (int) ilContainerReference::_lookupTargetId((int) $ref["obj_id"]);
            $crs_ref_id = (int) ilContainerReference::_lookupTargetRefId((int) $ref["obj_id"]);
 
            if (ilObject::_exists((int) $ref['ref_id'], true) &&
                is_null(ilObject::_lookupDeletedDate((int) $ref['ref_id'])) &&
                ilObject::_exists($crs_id, false) &&
                is_null(ilObject::_lookupDeletedDate($crs_ref_id)) &&
                ilLPStatus::_hasUserCompleted($crs_id, $usr_id)
            ) {
                $containing_prg = self::getInstanceByRefId((int) $ref["parent"]);
                if ($containing_prg->isActive()) {
                    $completed_crss[] = [
                        "crs_id" => $crs_id
                        , "prg_ref_id" => (int) $ref["parent"]
                        , "prg_obj_id" => $containing_prg->getId()
                        , "crsr_ref_id" => (int) $ref["child"]
                        , "crsr_id" => (int) $ref["obj_id"]
                        , "crs_ref_id" => (int) $crs_ref_id
                        , "crs_id" => (int) $crs_id
 
                        , "title" => ilContainerReference::_lookupTitle((int) $ref["obj_id"])
                    ];
                }
            }
        }
        return $completed_crss;
    }

References ilObject\_exists(), ilLPStatus\_hasUserCompleted(), ilObject\_lookupDeletedDate(), ilContainerReference\_lookupTargetId(), ilContainerReference\_lookupTargetRefId(), ilContainerReference\_lookupTitle(), getInstanceByRefId(), ilObject\getRefId(), and ILIAS\Repository\int().

Here is the call graph for this function:

getCreatableSubObjects()

static ilObjStudyProgramme::getCreatableSubObjects ( array  $subobjects,   $ref_id  )

static

Filter the list of possible subobjects for the objects that actually could be created on a concrete node.

Will be called by ilObjDefinition::getCreatableSubObjects.

@thorws ilException

Parameters

string[]

$subobjects

Definition at line 1591 of file class.ilObjStudyProgramme.php.

                                                                             : array
    {
        if ($ref_id === null) {
            return $subobjects;
        }
 
        if (ilObject::_lookupType($ref_id, true) !== "prg") {
            throw new ilException("Ref-Id '$ref_id' does not belong to a study programme object.");
        }
 
        $parent = self::getInstanceByRefId($ref_id);
 
        $mode = $parent->getLPMode();
 
        switch ($mode) {
            case ilStudyProgrammeSettings::MODE_UNDEFINED:
                $possible_subobjects = $subobjects;
                break;
            case ilStudyProgrammeSettings::MODE_POINTS:
                $possible_subobjects = [
                    "prg" => $subobjects["prg"],
                    "prgr" => $subobjects["prgr"]
                ];
                break;
            case ilStudyProgrammeSettings::MODE_LP_COMPLETED:
                $possible_subobjects = ['crsr' => $subobjects['crsr']];
                break;
            default:
                throw new ilException("Undefined mode for study programme: '$mode'");
        }
 
        if ($parent->hasAutomaticContentCategories()) {
            $possible_subobjects = array_filter(
                $possible_subobjects,
                static function ($subtype) {
                    return $subtype === 'crsr';
                },
                ARRAY_FILTER_USE_KEY
            );
        }
        return $possible_subobjects;
    }

References $ref_id, ilObject\_lookupType(), ilStudyProgrammeSettings\MODE_LP_COMPLETED, ilStudyProgrammeSettings\MODE_POINTS, and ilStudyProgrammeSettings\MODE_UNDEFINED.

Here is the call graph for this function:

getDepth()

ilObjStudyProgramme::getDepth

(

)

Get the depth of this StudyProgramme in the tree starting at the topmost StudyProgramme (not root node of the repo tree!).

Root node has depth = 0.

Exceptions

ilException

when this object is not in tree.

Definition at line 615 of file class.ilObjStudyProgramme.php.

                              : int
    {
        $cur = $this;
        $count = 0;
        while ($cur = $cur->getParent()) {
            $count++;
        }
        return $count;
    }

getIdsOfUsersWithRelevantProgress()

ilObjStudyProgramme::getIdsOfUsersWithRelevantProgress

(

)

Definition at line 1172 of file class.ilObjStudyProgramme.php.

                                                       : array
    {
        return array_map(
            fn ($ass) => $ass->getUserId(),
            $this->getAssignments()
        );
    }

getInstanceByObjId()

static ilObjStudyProgramme::getInstanceByObjId ( int  $obj_id )

static

Definition at line 155 of file class.ilObjStudyProgramme.php.

                                                          : ilObjStudyProgramme
    {
        return self::getInstanceByRefId(self::getRefIdFor($obj_id));
    }

References getInstanceByRefId(), and getRefIdFor().

Referenced by ilStudyProgrammeIndividualPlanProgressListGUI\buildProgressStatus(), ilStudyProgrammeProgressListGUI\buildProgressStatus(), ilStudyProgrammeIndividualPlanTableGUI\fetchData(), ilStudyProgrammeProgressListGUI\fillTemplate(), ilStudyProgrammeExpandableProgressListGUI\getAccordionContentCoursesHTML(), ilStudyProgrammeExpandableProgressListGUI\getAccordionContentHTML(), ilPRGMail\getAssignmentAndProgramme(), ilStudyProgrammeDashboardViewGUI\getHTML(), ilPrgRestartAssignmentsCronJob\getStudyProgramme(), ilPDStudyProgrammeSimpleListGUI\hasPermission(), ilStudyProgrammeExpandableProgressListGUI\shouldShowSubProgress(), ilStudyProgrammeUserTable\toRow(), ilObjStudyProgrammeIndividualPlanGUI\updateDeadlines(), ilObjStudyProgrammeIndividualPlanGUI\updateRequiredPoints(), and ilObjStudyProgrammeIndividualPlanGUI\updateStatus().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstanceByRefId()

static ilObjStudyProgramme::getInstanceByRefId (   $ref_id )

static

Definition at line 160 of file class.ilObjStudyProgramme.php.

                                                      : ilObjStudyProgramme
    {
        if (self::$study_programme_cache === null) {
            self::initStudyProgrammeCache();
        }
        return self::$study_programme_cache->getInstanceByRefId((int) $ref_id);
    }

References ilObject\$ref_id, and initStudyProgrammeCache().

Referenced by ilStudyProgrammeMembersTableGUI\__construct(), ilObjStudyProgrammeReferenceAccess\_checkAccess(), ilObjStudyProgrammeAccess\_checkAccess(), ilPRGPermissionsHelper\getAllAssignedUserIds(), getAllChildren(), getChildren(), getCompletedCourses(), getInstanceByObjId(), ilObjStudyProgrammeAutoCategoriesGUI\getObject(), ilObjStudyProgrammeAutoMembershipsGUI\getObject(), ilObjStudyProgrammeSettingsGUI\getObject(), ilStudyProgrammeChangeDeadlineGUI\getObject(), ilStudyProgrammeChangeExpireDateGUI\getObject(), getParent(), ilObjStudyProgrammeReference\getParent(), getPrgInstanceByObjId(), getProgrammesMonitoringCategory(), getProgrammesMonitoringMemberSource(), ilObjStudyProgrammeReference\getReferencedObject(), ilObjStudyProgrammeTreeExplorerGUI\getRootNode(), ilStudyProgrammeAppEventListener\getStudyProgramme(), ilObjStudyProgrammeMembersGUI\getStudyProgramme(), ilObjStudyProgrammeReference\putInTree(), putInTree(), ilObjStudyProgrammeMembersGUI\removeAssignment(), ilObjStudyProgrammeIndividualPlanGUI\setRefId(), ilObjStudyProgrammeMembersGUI\setRefId(), and ilStudyProgrammeType\updateAssignedStudyProgrammesIcons().

Here is the call graph for this function:

Here is the caller graph for this function:

getLastChange()

ilObjStudyProgramme::getLastChange

(

)

Get the timestamp of the last change on this program or sub program.

Definition at line 310 of file class.ilObjStudyProgramme.php.

                                   : DateTime
    {
        return $this->getSettings()->getLastChange();
    }

References getSettings().

Here is the call graph for this function:

getLocalMembers()

ilObjStudyProgramme::getLocalMembers

(

)

get usr_ids with assignment on this node

Definition at line 1091 of file class.ilObjStudyProgramme.php.

                                     : array
    {
        if (!$this->members_cache) {
            $this->members_cache = array_map(
                static function ($assignment) {
                    return $assignment->getUserId();
                },
                $this->assignment_repository->getByPrgId($this->getId())
            );
        }
        return $this->members_cache;
    }

References $members_cache, and ilObject\getId().

Here is the call graph for this function:

getLoggedInUserId()

ilObjStudyProgramme::getLoggedInUserId ( )

protected

Definition at line 1635 of file class.ilObjStudyProgramme.php.

                                          : int
    {
        return $this->ilUser->getId();
    }

Referenced by assignUser().

Here is the caller graph for this function:

getLogger()

ilObjStudyProgramme::getLogger ( )

protected

Definition at line 180 of file class.ilObjStudyProgramme.php.

                                  : ilLogger
    {
        return $this->logger;
    }

References $logger.

getLPChildren()

ilObjStudyProgramme::getLPChildren

(

)

Get the leafs the study programme contains.

Returns

ilStudyProgrammeLeaf[]

Exceptions

ilStudyProgrammeTreeException

when this object is not in tree.

Definition at line 644 of file class.ilObjStudyProgramme.php.

                                   : array
    {
        $this->throwIfNotInTree();
 
        if ($this->lp_children === null) {
            $this->lp_children = array();
 
            $ref_ids = $this->tree->getChildsByType($this->getRefId(), "crsr");
 
            // apply container sorting to tree
            $sorting = ilContainerSorting::_getInstance($this->getId());
            $ref_ids = $sorting->sortItems(array('crs_ref' => $ref_ids));
            $ref_ids = $ref_ids['crs_ref'];
 
            $lp_children = array_map(function ($node_data) {
                $lp_obj = $this->object_factory->getInstanceByRefId((int) $node_data["child"]);
 
                // filter out all StudyProgramme instances
                return ($lp_obj instanceof $this) ? null : $lp_obj;
            }, $ref_ids);
 
            $this->lp_children = array_filter($lp_children);
        }
        return $this->lp_children;
    }

References $lp_children, ilContainerSorting\_getInstance(), ilObject\getId(), ilObject\getRefId(), and throwIfNotInTree().

Referenced by getAmountOfLPChildren(), and getLPChildrenIds().

Here is the call graph for this function:

Here is the caller graph for this function:

getLPChildrenIds()

ilObjStudyProgramme::getLPChildrenIds

(

)

Get the obj-ids of the leafs the program contains.

Returns

int[]

Exceptions

ilStudyProgrammeTreeException

Definition at line 676 of file class.ilObjStudyProgramme.php.

                                      : array
    {
        return array_map(static function ($child) {
            return $child->getId();
        }, $this->getLPChildren());
    }

References getLPChildren().

Here is the call graph for this function:

getLPMode()

ilObjStudyProgramme::getLPMode

(

)

Definition at line 338 of file class.ilObjStudyProgramme.php.

                               : int
    {
        return $this->getSettings()->getLPMode();
    }

References getSettings().

Referenced by addNode(), and nodeInserted().

Here is the call graph for this function:

Here is the caller graph for this function:

getMembers()

ilObjStudyProgramme::getMembers

(

)

get usr_ids with any progress on this node

Returns

int[]

Definition at line 1079 of file class.ilObjStudyProgramme.php.

                                : array
    {
        $usr_ids = [];
        foreach ($this->getAssignments() as $assignment) {
            $usr_ids[] = $assignment->getUserId();
        }
        return array_unique($usr_ids);
    }

References getAssignments().

Here is the call graph for this function:

getMembersOfMembershipSource()

ilObjStudyProgramme::getMembersOfMembershipSource ( string  $src_type, int  $src_id  )

protected

Get member-ids of a certain source.

Returns

int[]

Exceptions

InvalidArgumentException

if $src_type is not in AutoMembershipSource-types

Definition at line 1393 of file class.ilObjStudyProgramme.php.

                                                                                  : array
    {
        $source_reader = $this->membersourcereader_factory->getReaderFor($src_type, $src_id);
        return $source_reader->getMemberIds();
    }

Referenced by enableAutomaticMembershipSource(), and getApplicableMembershipSourceForUser().

Here is the caller graph for this function:

getMessageCollection()

ilObjStudyProgramme::getMessageCollection ( string  $topic )

protected

Definition at line 925 of file class.ilObjStudyProgramme.php.

                                                          : ilPRGMessageCollection
    {
        $msgs = new ilPRGMessageCollection();
        return $msgs->withNewTopic($topic);
    }

getNow()

ilObjStudyProgramme::getNow ( )

protected

Definition at line 1640 of file class.ilObjStudyProgramme.php.

                               : DateTimeImmutable
    {
        return new DateTimeImmutable();
    }

getObjIdsOfChildren()

ilObjStudyProgramme::getObjIdsOfChildren ( int  $node_obj_id )

protected

Definition at line 1645 of file class.ilObjStudyProgramme.php.

                                                            : array
    {
        $node_ref_id = self::getRefIdFor($node_obj_id);
 
        $prgs = $this->tree->getChildsByType($node_ref_id, "prg");
        $prg_ids = array_map(
            static function ($nd) {
                return (int) $nd['obj_id'];
            },
            $prgs
        );
 
        $prg_ref_ids = [];
        $prg_refs = $this->tree->getChildsByType($node_ref_id, "prgr");
        foreach ($prg_refs as $ref) {
            $ref_obj = new ilObjStudyProgrammeReference((int) $ref['ref_id']);
            $prg_ref_ids[] = $ref_obj->getReferencedObject()->getId();
        }
 
        return array_merge($prg_ids, $prg_ref_ids);
    }

References $nd, and getRefIdFor().

Here is the call graph for this function:

getParent()

ilObjStudyProgramme::getParent

(

)

Get the parent ilObjStudyProgramme of this object.

Returns null if parent is no StudyProgramme.

Exceptions

ilException

when this object is not in tree.

Definition at line 518 of file class.ilObjStudyProgramme.php.

                               : ?ilObjStudyProgramme
    {
        if ($this->parent === false) {
            $this->throwIfNotInTree();
            $parent_data = $this->tree->getParentNodeData($this->getRefId());
            if ($parent_data["type"] !== "prg") {
                $this->parent = null;
            } else {
                $this->parent = self::getInstanceByRefId($parent_data["ref_id"]);
            }
        }
        return $this->parent;
    }

References $parent, getInstanceByRefId(), ilObject\getRefId(), and throwIfNotInTree().

Referenced by ilObjStudyProgrammeTreeExplorerGUI\listItemStart(), moveTo(), and removeNode().

Here is the call graph for this function:

Here is the caller graph for this function:

getParentId()

static ilObjStudyProgramme::getParentId ( ilObjCourseReference  $leaf )

staticprotected

Get the obj id of the parent object for the given object.

Returns null if object is not in the tree currently.

Definition at line 1548 of file class.ilObjStudyProgramme.php.

                                                                     : ?int
    {
        global $DIC;
        $tree = $DIC['tree'];
        if (!$tree->isInTree($leaf->getRefId())) {
            return null;
        }
 
        $nd = $tree->getParentNodeData($leaf->getRefId());
        return $nd["obj_id"];
    }

References $DIC, $nd, and ilObject\getRefId().

Here is the call graph for this function:

getParents()

ilObjStudyProgramme::getParents

(

bool

$include_references = false

)

Get all parents of the node, where the root of the program comes first.

Returns

ilObjStudyProgramme[]

Definition at line 561 of file class.ilObjStudyProgramme.php.

                                                                : array
    {
        $current = $this;
        $parents = [];
        $queque = [$current];
        while ($element = array_shift($queque)) {
            $parent = $element->getParent();
            if ($parent === null || $include_references) {
                foreach ($this->getReferencesTo($element) as $reference) {
                    if ($this->tree->isDeleted($reference->getRefId())) {
                        continue;
                    }
                    $r_parent = $reference->getParent();
                    if (is_null($r_parent)) {
                        continue;
                    }
                    $queque[] = $r_parent;
                    $parents[] = $r_parent;
                }
                continue;
            }
            $queque[] = $parent;
            $parents[] = $parent;
        }
        return array_reverse($parents);
    }

References $parent, and getReferencesTo().

Referenced by getRoot().

Here is the call graph for this function:

Here is the caller graph for this function:

getPoints()

ilObjStudyProgramme::getPoints

(

)

Get the amount of points.

Definition at line 318 of file class.ilObjStudyProgramme.php.

                               : int
    {
        return $this->getSettings()->getAssessmentSettings()->getPoints();
    }

References getSettings().

Here is the call graph for this function:

getPrgInstanceByObjId()

ilObjStudyProgramme::getPrgInstanceByObjId ( int  $obj_id )

protected

Definition at line 150 of file class.ilObjStudyProgramme.php.

                                                         : ilObjStudyProgramme
    {
        return self::getInstanceByRefId(self::getRefIdFor($obj_id));
    }

References getInstanceByRefId(), and getRefIdFor().

Here is the call graph for this function:

getProgrammesMonitoringCategory()

static ilObjStudyProgramme::getProgrammesMonitoringCategory ( int  $cat_ref_id )

staticprotected

Get all (not OUTDATED) StudyProgrammes monitoring this category.

Returns

ilObjStudyProgramme[]

Definition at line 1272 of file class.ilObjStudyProgramme.php.

                                                                              : array
    {
        $db = ilStudyProgrammeDIC::dic()['model.AutoCategories.ilStudyProgrammeAutoCategoriesRepository'];
        $programmes =
            array_filter(
                array_map(
                    static function (array $rec) {
                        $values = array_values($rec);
                        $prg_obj_id = (int) array_shift($values);
 
                        $references = ilObject::_getAllReferences($prg_obj_id);
                        $prg_ref_id = (int) array_shift($references);
 
                        $prg = self::getInstanceByRefId($prg_ref_id);
                        if ($prg->isAutoContentApplicable()) {
                            return $prg;
                        }
                    },
                    $db::getProgrammesFor($cat_ref_id)
                )
            );
        return $programmes;
    }

References ilObject\$db, ilObject\_getAllReferences(), ilStudyProgrammeDIC\dic(), getInstanceByRefId(), and ILIAS\Repository\int().

Here is the call graph for this function:

getProgrammesMonitoringMemberSource()

static ilObjStudyProgramme::getProgrammesMonitoringMemberSource ( string  $src_type, int  $src_id  )

staticprotected

Get all StudyProgrammes monitoring this membership-source.

Returns

ilObjStudyProgramme[]

Definition at line 1404 of file class.ilObjStudyProgramme.php.

                                                                                                : array
    {
        $db = ilStudyProgrammeDIC::dic()['model.AutoMemberships.ilStudyProgrammeAutoMembershipsRepository'];
        $programmes = array_map(
            static function ($rec) {
                $values = array_values($rec);
                $prg_obj_id = (int) array_shift($values);
 
                $references = ilObject::_getAllReferences($prg_obj_id);
                $prg_ref_id = (int) array_shift($references);
 
                $prg = self::getInstanceByRefId($prg_ref_id);
                return $prg;
            },
            $db::getProgrammesFor($src_type, $src_id)
        );
        return $programmes;
    }

References ilObject\$db, ilObject\_getAllReferences(), ilStudyProgrammeDIC\dic(), getInstanceByRefId(), and ILIAS\Repository\int().

Here is the call graph for this function:

getProgressIdString()

ilObjStudyProgramme::getProgressIdString ( ilPRGAssignment  $assignment, ilPRGProgress  $progress  )

protected

Definition at line 1886 of file class.ilObjStudyProgramme.php.

                                                                                                : string
    {
        $username = ilObjUser::_lookupFullname($assignment->getUserId());
        return sprintf(
            '%s, progress-id (%s/%s)',
            $username,
            $assignment->getId(),
            $progress->getNodeId()
        );
    }

References ilObjUser\_lookupFullname(), ilPRGAssignment\getId(), ilPRGProgress\getNodeId(), and ilPRGAssignment\getUserId().

Here is the call graph for this function:

getReferencesTo()

ilObjStudyProgramme::getReferencesTo ( ilObjStudyProgramme  $prg )

protected

Definition at line 532 of file class.ilObjStudyProgramme.php.

                                                                : array
    {
        $tree = $this->tree;
        return array_filter(
            array_map(
                static function ($id) {
                    $refs = ilObject::_getAllReferences((int) $id);
                    return new ilObjStudyProgrammeReference(
                        array_shift($refs)
                    );
                },
                ilContainerReference::_lookupSourceIds($prg->getId())
            ),
            static function ($prg_ref) use ($tree) {
                return !$tree->isDeleted($prg_ref->getRefId());
            }
        );
    }

References ilObject\$id, ilObject\$tree, ilObject\_getAllReferences(), ilContainerReference\_lookupSourceIds(), ilObject\getId(), and ilTree\isDeleted().

Referenced by getParents(), and getReferencesToSelf().

Here is the call graph for this function:

Here is the caller graph for this function:

getReferencesToSelf()

ilObjStudyProgramme::getReferencesToSelf

(

)

Definition at line 551 of file class.ilObjStudyProgramme.php.

                                         : array
    {
        return $this->getReferencesTo($this);
    }

References getReferencesTo().

Here is the call graph for this function:

getRefIdFor()

static ilObjStudyProgramme::getRefIdFor ( int  $obj_id )

static

Definition at line 141 of file class.ilObjStudyProgramme.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 ilStudyProgrammeMailMemberSearchGUI\getRootPrgRefId(), ilStudyProgrammeUserTable\lookupTitle(), and ilObjStudyProgrammeMembersGUI\removeAssignment().

Here is the call graph for this function:

Here is the caller graph for this function:

getRoot()

ilObjStudyProgramme::getRoot

(

)

Get the ilObjStudyProgramme that is the root node of the tree this programme is in.

Definition at line 629 of file class.ilObjStudyProgramme.php.

                             : ilObjStudyProgramme
    {
        $parents = $this->getParents();
        if (count($parents) < 1) {
            return $this;
        }
        return $parents[0];
    }

References getParents().

Here is the call graph for this function:

getSettings()

ilObjStudyProgramme::getSettings

(

)

Definition at line 203 of file class.ilObjStudyProgramme.php.

                                 : ilStudyProgrammeSettings
    {
        return $this->getSettingsRepository()->get($this->getId());
    }

References ilObject\getId(), and getSettingsRepository().

Referenced by adjustLPMode(), ilObjStudyProgrammeSettingsGUI\buildForm(), deleteSettings(), ilStudyProgrammeChangeDeadlineGUI\getDeadlineSubForm(), getLastChange(), getLPMode(), getPoints(), getStatus(), getSubType(), ilStudyProgrammeChangeExpireDateGUI\getValidityOfQualificationSubForm(), hasAdvancedMetadata(), isAutoContentApplicable(), nodeInserted(), ilPRGMail\sendInformToReAssignMail(), ilPRGMail\sendReAssignedMail(), ilPRGMail\sendRiskyToFailMail(), setPoints(), setStatus(), and update().

Here is the call graph for this function:

Here is the caller graph for this function:

getSettingsRepository()

ilObjStudyProgramme::getSettingsRepository ( )

protected

Definition at line 172 of file class.ilObjStudyProgramme.php.

                                              : ilStudyProgrammeSettingsRepository
    {
        return $this->settings_repository;
    }

References $settings_repository.

Referenced by assignUser(), create(), deleteSettings(), getSettings(), and updateSettings().

Here is the caller graph for this function:

getSpecificAssignment()

ilObjStudyProgramme::getSpecificAssignment

(

int

$assignment_id

)

Definition at line 1002 of file class.ilObjStudyProgramme.php.

                                                             : ilPRGAssignment
    {
        return $this->assignment_repository->get($assignment_id);
    }

getStatus()

ilObjStudyProgramme::getStatus

(

)

Definition at line 376 of file class.ilObjStudyProgramme.php.

                               : int
    {
        return $this->getSettings()->getAssessmentSettings()->getStatus();
    }

References getSettings().

Referenced by assignUser(), ilStudyProgrammeIndividualPlanProgressListGUI\getTitleForItem(), isActive(), and isAutoContentApplicable().

Here is the call graph for this function:

Here is the caller graph for this function:

getSubType()

ilObjStudyProgramme::getSubType

(

)

Gets the SubType Object.

Definition at line 404 of file class.ilObjStudyProgramme.php.

                                : ?ilStudyProgrammeType
    {
        $type_settings = $this->getSettings()->getTypeSettings();
        if (!in_array($type_settings->getTypeId(), array("-", "0"))) {
            $subtype_id = $type_settings->getTypeId();
            return $this->type_repository->getType($subtype_id);
        }
 
        return null;
    }

References getSettings().

Here is the call graph for this function:

getTree()

ilObjStudyProgramme::getTree ( )

protected

Definition at line 176 of file class.ilObjStudyProgramme.php.

                                : ilTree
    {
        return $this->tree;
    }

References ilObject\$tree.

hasAdvancedMetadata()

ilObjStudyProgramme::hasAdvancedMetadata

(

)

Definition at line 292 of file class.ilObjStudyProgramme.php.

                                         : bool
    {
        $sub_type_id = $this->getSettings()->getTypeSettings()->getTypeId();
        $type = null;
        if ($sub_type_id) {
            $type = $this->type_repository->getType($sub_type_id);
        }
 
        return !is_null($type) && count($this->type_repository->getAssignedAMDRecordIdsByType($type->getId(), true)) > 0;
    }

References ilObject\$type, and getSettings().

Here is the call graph for this function:

hasAssignmentOf()

ilObjStudyProgramme::hasAssignmentOf

(

int

$user_id

)

Check whether user is assigned to this program or any node above.

Definition at line 1030 of file class.ilObjStudyProgramme.php.

                                                 : bool
    {
        return $this->getAmountOfAssignmentsOf($user_id) > 0;
    }

References getAmountOfAssignmentsOf().

Here is the call graph for this function:

hasAssignments()

ilObjStudyProgramme::hasAssignments

(

)

Are there any assignments on this node or any node above?

Definition at line 1107 of file class.ilObjStudyProgramme.php.

                                    : bool
    {
        $filter = new ilPRGAssignmentFilter($this->lng);
        $count = $this->assignment_repository->countAllForNodeIsContained(
            $this->getId(),
            null,
            $filter
        );
        return $count > 0;
 
    }

References ilObject\getId(), and ILIAS\Repository\lng().

Here is the call graph for this function:

hasAssignmentsOfSingleProgramForUser()

ilObjStudyProgramme::hasAssignmentsOfSingleProgramForUser

(

int

$usr_id

)

Get assignments of user to this program-node only.

Definition at line 1132 of file class.ilObjStudyProgramme.php.

                                                                     : bool
    {
        return count($this->getAssignmentsOfSingleProgramForUser($usr_id)) > 0;
    }

References getAssignmentsOfSingleProgramForUser().

Here is the call graph for this function:

hasAutomaticContentCategories()

ilObjStudyProgramme::hasAutomaticContentCategories

(

)

Definition at line 1194 of file class.ilObjStudyProgramme.php.

                                                   : bool
    {
        return count($this->getAutomaticContentCategories()) > 0;
    }

References getAutomaticContentCategories().

Here is the call graph for this function:

hasChildren()

ilObjStudyProgramme::hasChildren

(

bool

$include_references = false

)

Does this StudyProgramme have other ilObjStudyProgrammes as children?

Exceptions

ilStudyProgrammeTreeException

Definition at line 593 of file class.ilObjStudyProgramme.php.

                                                                 : bool
    {
        return $this->getAmountOfChildren($include_references) > 0;
    }

References getAmountOfChildren().

Here is the call graph for this function:

hasLPChildren()

ilObjStudyProgramme::hasLPChildren

(

)

Definition at line 692 of file class.ilObjStudyProgramme.php.

                                   : bool
    {
        return ($this->getAmountOfLPChildren() > 0);
    }

References getAmountOfLPChildren().

Referenced by isAutoContentApplicable().

Here is the call graph for this function:

Here is the caller graph for this function:

hasRelevantProgresses()

ilObjStudyProgramme::hasRelevantProgresses

(

)

Are there any users that have a relevant progress on this programme?

Definition at line 1158 of file class.ilObjStudyProgramme.php.

                                           : bool
    {
        $filter = new ilPRGAssignmentFilter($this->lng);
        $filter = $filter->withValues([
            'prg_status_hide_irrelevant' => true
        ]);
        $count = $this->assignment_repository->countAllForNodeIsContained(
            $this->getId(),
            null,
            $filter
        );
        return $count > 0;
    }

References ilObject\getId(), and ILIAS\Repository\lng().

Referenced by canBeRemoved().

Here is the call graph for this function:

Here is the caller graph for this function:

initStudyProgrammeCache()

static ilObjStudyProgramme::initStudyProgrammeCache ( )

static

Definition at line 109 of file class.ilObjStudyProgramme.php.

                                                    : void
    {
        if (self::$study_programme_cache === null) {
            self::$study_programme_cache = ilObjStudyProgrammeCache::singleton();
        }
    }

References ilObjStudyProgrammeCache\singleton().

Referenced by __construct(), and getInstanceByRefId().

Here is the call graph for this function:

Here is the caller graph for this function:

isActive()

ilObjStudyProgramme::isActive

(

)

Definition at line 396 of file class.ilObjStudyProgramme.php.

                              : bool
    {
        return $this->getStatus() === ilStudyProgrammeSettings::STATUS_ACTIVE;
    }

References getStatus(), and ilStudyProgrammeSettings\STATUS_ACTIVE.

Here is the call graph for this function:

isAutoContentApplicable()

ilObjStudyProgramme::isAutoContentApplicable

(

)

AutoContent should only be available in active- or draft-mode, and only, if there is no sub-programme.

Exceptions

ilStudyProgrammeTreeException

Definition at line 1302 of file class.ilObjStudyProgramme.php.

                                             : bool
    {
        $valid_status = in_array(
            $this->getSettings()->getAssessmentSettings()->getStatus(),
            [
                ilStudyProgrammeSettings::STATUS_DRAFT,
                ilStudyProgrammeSettings::STATUS_ACTIVE
            ],
            true
        );
 
        $crslnk_allowed = (
            $this->hasLPChildren()
            || $this->getAmountOfChildren(true) === 0
        );
 
        return $valid_status && $crslnk_allowed;
    }

References getAmountOfChildren(), getSettings(), getStatus(), hasLPChildren(), ilStudyProgrammeSettings\STATUS_ACTIVE, and ilStudyProgrammeSettings\STATUS_DRAFT.

Here is the call graph for this function:

markAccredited()

ilObjStudyProgramme::markAccredited	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 1675 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->markAccredited(
                $this->getSettingsRepository(),
                $this->events,
                $progress_node_id,
                $acting_usr_id,
                $err_collection
            );
 
        $this->assignment_repository->store($assignment);
    }

markNotRelevant()

ilObjStudyProgramme::markNotRelevant	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 1711 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->markNotRelevant(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

markRelevant()

ilObjStudyProgramme::markRelevant	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 1729 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->markRelevant(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

moveTo()

ilObjStudyProgramme::moveTo

(

ilObjStudyProgramme

$new_parent

)

Move this tree node to a new parent.

Throws when manipulation of tree is not allowed due to invariants that need to hold on the tree.

Exceptions

ilStudyProgrammeTreeException
ilException

Definition at line 894 of file class.ilObjStudyProgramme.php.

                                                           : ilObjStudyProgramme
    {
        global $DIC;
        $rbacadmin = $DIC['rbacadmin'];
 
        if ($parent = $this->getParent()) {
            // TODO: check if there some leafs in the new parent
 
            $this->tree->moveTree($this->getRefId(), $new_parent->getRefId());
            // necessary to clean up permissions
            $rbacadmin->adjustMovedObjectPermissions($this->getRefId(), $parent->getRefId());
 
            // TODO: lp-progress needs to be updated
 
            // clear caches on different nodes
            $this->clearParentCache();
 
            $parent->clearChildrenCache();
            $parent->clearLPChildrenCache();
 
            $new_parent->clearChildrenCache();
            $new_parent->clearLPChildrenCache();
        }
 
        return $this;
    }

References $DIC, $parent, clearChildrenCache(), clearLPChildrenCache(), clearParentCache(), getParent(), and ilObject\getRefId().

Here is the call graph for this function:

nodeInserted()

ilObjStudyProgramme::nodeInserted

(

$prg

)

Clears child cache and adds progress for new node.

called by ilObjStudyProgrammeReference::putInTree, e.g.

Parameters

ilObjStudyProgrammeReference | ilObjStudyProgramme

$prg

Exceptions

ilStudyProgrammeTreeException
ilException

Definition at line 810 of file class.ilObjStudyProgramme.php.

                                      : void
    {
        if (! $prg instanceof ilObjStudyProgrammeReference &&
           ! $prg instanceof ilObjStudyProgramme
        ) {
            throw new ilStudyProgrammeTreeException("Wrong type of node: " . get_class($prg));
        }
        if ($this->getLPMode() === ilStudyProgrammeSettings::MODE_LP_COMPLETED) {
            throw new ilStudyProgrammeTreeException("Program already contains leafs.");
        }
 
        if ($this->getSettings()->getLPMode() !== ilStudyProgrammeSettings::MODE_POINTS) {
            $this->settings_repository->update(
                $this->getSettings()->setLPMode(ilStudyProgrammeSettings::MODE_POINTS)
            );
        }
 
        $this->clearChildrenCache();
        $this->addMissingProgresses();
    }

References addMissingProgresses(), clearChildrenCache(), getLPMode(), getSettings(), ilStudyProgrammeSettings\MODE_LP_COMPLETED, and ilStudyProgrammeSettings\MODE_POINTS.

Here is the call graph for this function:

putInTree()

ilObjStudyProgramme::putInTree

(

int

$parent_ref_id

)

Overwritten from ilObject.

Calls nodeInserted on parent object if parent object is another program.

Parameters

int

$parent_ref_id

Exceptions

ilStudyProgrammeTreeException
ilException

Reimplemented from ilContainer.

Definition at line 838 of file class.ilObjStudyProgramme.php.

                                                 : void
    {
        parent::putInTree($parent_ref_id);
 
        if (ilObject::_lookupType($parent_ref_id, true) === "prg") {
            $par = self::getInstanceByRefId($parent_ref_id);
            $par->nodeInserted($this);
        }
    }

References ilObject\_lookupType(), and getInstanceByRefId().

Referenced by addNode().

Here is the call graph for this function:

Here is the caller graph for this function:

refreshLPStatus()

ilObjStudyProgramme::refreshLPStatus ( int  $usr_id, int  $node_obj_id = null  )

protected

Definition at line 1667 of file class.ilObjStudyProgramme.php.

                                                                            : void
    {
        if (is_null($node_obj_id)) {
            $node_obj_id = $this->getId();
        }
        ilLPStatusWrapper::_updateStatus($node_obj_id, $usr_id);
    }

References ilLPStatusWrapper\_updateStatus(), and ILIAS\Survey\Mode\getId().

Referenced by removeAssignment().

Here is the call graph for this function:

Here is the caller graph for this function:

removeAssignment()

ilObjStudyProgramme::removeAssignment

(

ilPRGAssignment

$assignment

)

Remove an assignment from this program.

Throws when assignment doesn't have this program as root node.

Exceptions

ilException

Definition at line 980 of file class.ilObjStudyProgramme.php.

                                                                 : ilObjStudyProgramme
    {
        $this->members_cache = null;
        if ($assignment->getRootId() !== $this->getId()) {
            throw new ilException(
                "ilObjStudyProgramme::removeAssignment: Assignment '"
                . $assignment->getId() . "' does not belong to study "
                . "program '" . $this->getId() . "'."
            );
        }
 
        $this->assignment_repository->delete($assignment);
 
        $affected_node_ids = array_map(fn ($pgs) => $pgs->getNodeId(), $assignment->getProgresses());
        foreach ($affected_node_ids as $node_obj_id) {
            $this->refreshLPStatus($assignment->getUserId(), $node_obj_id);
        }
 
        $this->events->userDeassigned($assignment);
        return $this;
    }

References ilPRGAssignment\getId(), ilPRGAssignment\getProgresses(), ilPRGAssignment\getRootId(), ilPRGAssignment\getUserId(), and refreshLPStatus().

Here is the call graph for this function:

removeCrsFromProgrammes()

static ilObjStudyProgramme::removeCrsFromProgrammes ( int  $crs_ref_id, int  $cat_ref_id  )

static

Check, if a category is under surveillance and automatically remove the deleted course.

Exceptions

ilStudyProgrammeTreeException

Definition at line 1257 of file class.ilObjStudyProgramme.php.

                                                                                    : void
    {
        foreach (self::getProgrammesMonitoringCategory($cat_ref_id) as $prg) {
            foreach ($prg->getLPChildren() as $child) {
                if ((int) $child->getTargetRefId() === $crs_ref_id) {
                    $child->delete();
                }
            }
        }
    }

Referenced by ilStudyProgrammeAppEventListener\removeCrsFromProgrammes().

Here is the caller graph for this function:

removeMemberFromProgrammes()

static ilObjStudyProgramme::removeMemberFromProgrammes ( string  $src_type, int  $src_id, int  $usr_id  )

static

Definition at line 1434 of file class.ilObjStudyProgramme.php.

                                                                                                 : void
    {
        $now = new DateTimeImmutable();
        $assignment_repository = ilStudyProgrammeDIC::dic()['repo.assignment'];
        foreach (self::getProgrammesMonitoringMemberSource($src_type, $src_id) as $prg) {
            $assignments = $prg->getAssignmentsOfSingleProgramForUser($usr_id);
            $next_membership_source = $prg->getApplicableMembershipSourceForUser($usr_id, $src_id);
 
            foreach ($assignments as $assignment) {
                if (!$assignment->getProgressTree()->isInProgress()) {
                    continue;
                }
 
                if (!is_null($next_membership_source) && $next_membership_source->isEnabled()) {
                    $new_src_type = $next_membership_source->getSourceType();
                    $assigned_by = ilStudyProgrammeAutoMembershipSource::SOURCE_MAPPING[$new_src_type];
                    $assignment = $assignment->withLastChange($assigned_by, $now);
                    $assignment_repository->store($assignment);
                    break;
                } else {
                    $assignment_repository->delete($assignment);
                }
            }
        }
    }

References $assignment_repository, ilPRGAssignmentDBRepository\delete(), ilStudyProgrammeDIC\dic(), ilStudyProgrammeAutoMembershipSource\SOURCE_MAPPING, and ilPRGAssignmentDBRepository\store().

Referenced by ilStudyProgrammeAppEventListener\removeMemberFromProgrammes().

Here is the call graph for this function:

Here is the caller graph for this function:

removeNode()

ilObjStudyProgramme::removeNode

(

ilObjStudyProgramme

$a_prg

)

Remove a node from this object.

Throws when node is no child of the object. Throws when manipulation of tree is not allowed due to invariants that need to hold on the tree.

Exceptions

ilException
ilStudyProgrammeTreeException

Definition at line 857 of file class.ilObjStudyProgramme.php.

                                                          : ilObjStudyProgramme
    {
        if ($a_prg->getParent()->getId() !== $this->getId()) {
            throw new ilStudyProgrammeTreeException("This is no parent of the given programm.");
        }
 
        if (!$a_prg->canBeRemoved()) {
            throw new ilStudyProgrammeTreeException("The node has relevant assignments.");
        }
 
        // *sigh*...
        $node_data = $this->tree->getNodeData($a_prg->getRefId());
        $this->tree->deleteTree($node_data);
        $a_prg->clearParentCache();
        $this->clearChildrenCache();
 
        return $this;
    }

References canBeRemoved(), clearChildrenCache(), clearParentCache(), getParent(), and ilObject\getRefId().

Here is the call graph for this function:

resetExpiryInfoSentFor()

ilObjStudyProgramme::resetExpiryInfoSentFor

(

ilPRGAssignment

$ass

)

Definition at line 1012 of file class.ilObjStudyProgramme.php.

                                                                : void
    {
        $this->assignment_repository->resetExpiryInfoSentFor($ass);
    }

Referenced by ilPRGMail\resetExpiryInfoSentFor().

Here is the caller graph for this function:

resetRiskyToFailSentFor()

ilObjStudyProgramme::resetRiskyToFailSentFor

(

ilPRGAssignment

$ass

)

Definition at line 1022 of file class.ilObjStudyProgramme.php.

                                                                 : void
    {
        $this->assignment_repository->resetRiskyToFailSentFor($ass);
    }

Referenced by ilPRGMail\resetRiskyToFailSentFor().

Here is the caller graph for this function:

setPoints()

ilObjStudyProgramme::setPoints

(

int

$points

)

Set the amount of points.

Exceptions

ilException

Definition at line 328 of file class.ilObjStudyProgramme.php.

                                          : ilObjStudyProgramme
    {
        $settings = $this->getSettings();
        $this->updateSettings(
            $settings->withAssessmentSettings($settings->getAssessmentSettings()->withPoints($points))
        );
        $this->updateLastChange();
        return $this;
    }

References ILIAS\LTI\ToolProvider\$settings, getSettings(), updateLastChange(), and updateSettings().

Here is the call graph for this function:

setProgressesCompletedIfParentIsProgrammeInLPCompletedMode()

static ilObjStudyProgramme::setProgressesCompletedIfParentIsProgrammeInLPCompletedMode ( int  $ref_id, int  $obj_id, int  $user_id  )

static

Succeed all StudyProgramme(Nodes) where the object with the given id (a CRSR) is in a Programme with MODE_LP_COMPLETED.

This is exclusively called via event "Services/Tracking, updateStatus" (onServiceTrackingUpdateStatus)

Parameters

int	$ref_id	the RefId of the CRSR; used to find the PRG it's in
int	$obj_id	the ObjId of the CRS; used as "triggering object"
int	$user_id	the user's id to succeed for; all assignments are affected

Exceptions

ilException

Definition at line 1505 of file class.ilObjStudyProgramme.php.

     : void {
        global $DIC; // TODO: replace this by a settable static for testing purpose?
        $tree = $DIC['tree'];
        $node_data = $tree->getParentNodeData($ref_id);
        if (count($node_data) === 0 || !array_key_exists('type', $node_data) || $node_data["type"] !== "prg") {
            return;
        }
        self::initStudyProgrammeCache();
        $prg = self::getInstanceByRefId($node_data["child"]);
        if ($prg->getLPMode() !== ilStudyProgrammeSettings::MODE_LP_COMPLETED) {
            return;
        }
        $prg->succeed($user_id, $obj_id);
    }

Referenced by ilStudyProgrammeAppEventListener\onServiceTrackingUpdateStatus().

Here is the caller graph for this function:

setStatus()

ilObjStudyProgramme::setStatus

(

int

$a_status

)

Set the status of the node.

Exceptions

ilException

Definition at line 386 of file class.ilObjStudyProgramme.php.

                                            : ilObjStudyProgramme
    {
        $settings = $this->getSettings();
        $this->updateSettings(
            $settings->withAssessmentSettings($settings->getAssessmentSettings()->withStatus($a_status))
        );
        $this->updateLastChange();
        return $this;
    }

References ILIAS\LTI\ToolProvider\$settings, getSettings(), updateLastChange(), and updateSettings().

Here is the call graph for this function:

statusToRepr()

ilObjStudyProgramme::statusToRepr

(

int

$status

)

Get a user readable representation of a status.

Definition at line 1864 of file class.ilObjStudyProgramme.php.

                                             : string
    {
        $lng = $this->lng;
        $lng->loadLanguageModule("prg");
        if ($status === ilPRGProgress::STATUS_IN_PROGRESS) {
            return $lng->txt("prg_status_in_progress");
        }
        if ($status === ilPRGProgress::STATUS_COMPLETED) {
            return $lng->txt("prg_status_completed");
        }
        if ($status === ilPRGProgress::STATUS_ACCREDITED) {
            return $lng->txt("prg_status_accredited");
        }
        if ($status === ilPRGProgress::STATUS_NOT_RELEVANT) {
            return $lng->txt("prg_status_not_relevant");
        }
        if ($status === ilPRGProgress::STATUS_FAILED) {
            return $lng->txt("prg_status_failed");
        }
        throw new ilException("Unknown status: '$status'");
    }

References $lng, ilPRGProgress\STATUS_ACCREDITED, ilPRGProgress\STATUS_COMPLETED, ilPRGProgress\STATUS_FAILED, ilPRGProgress\STATUS_IN_PROGRESS, and ilPRGProgress\STATUS_NOT_RELEVANT.

storeAutomaticContentCategory()

ilObjStudyProgramme::storeAutomaticContentCategory

(

int

$category_ref_id

)

Store a Category with auto-content for this StudyProgramme; a category can only be referenced once (per programme).

Definition at line 1204 of file class.ilObjStudyProgramme.php.

                                                                       : void
    {
        $ac = $this->auto_categories_repository->create(
            $this->getId(),
            $category_ref_id
        );
        $this->auto_categories_repository->update($ac);
    }

References ilObject\getId().

Here is the call graph for this function:

storeAutomaticMembershipSource()

ilObjStudyProgramme::storeAutomaticMembershipSource	(	string	$type,
		int	$src_id
	)

Store a source to be monitored for automatic memberships.

Definition at line 1338 of file class.ilObjStudyProgramme.php.

                                                                             : void
    {
        $ams = $this->auto_memberships_repository->create($this->getId(), $type, $src_id, false);
        $this->auto_memberships_repository->update($ams);
    }

References ilObject\getId().

Here is the call graph for this function:

storeExpiryInfoSentFor()

ilObjStudyProgramme::storeExpiryInfoSentFor

(

ilPRGAssignment

$ass

)

Definition at line 1007 of file class.ilObjStudyProgramme.php.

                                                                : void
    {
        $this->assignment_repository->storeExpiryInfoSentFor($ass);
    }

Referenced by ilPRGMail\sendInformToReAssignMail().

Here is the caller graph for this function:

storeRiskyToFailSentFor()

ilObjStudyProgramme::storeRiskyToFailSentFor

(

ilPRGAssignment

$ass

)

Definition at line 1017 of file class.ilObjStudyProgramme.php.

                                                                 : void
    {
        $this->assignment_repository->storeRiskyToFailSentFor($ass);
    }

Referenced by ilPRGMail\sendRiskyToFailMail().

Here is the caller graph for this function:

succeed()

ilObjStudyProgramme::succeed	(	int	$usr_id,
		int	$triggering_obj_id,
		ilPRGAssignment	$ass = null
	)

Definition at line 1524 of file class.ilObjStudyProgramme.php.

                                                                                             : void
    {
        $progress_node_id = $this->getId();
        if (is_null($ass)) {
            $user_assignments = $this->assignment_repository
                ->getAllForNodeIsContained($progress_node_id, [$usr_id]);
        } else {
            $user_assignments = [$ass];
        }
 
        foreach ($user_assignments as $ass) {
            $ass = $ass->succeed(
                $this->getSettingsRepository(),
                $progress_node_id,
                $triggering_obj_id
            );
            $this->assignment_repository->store($ass);
        }
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

throwIfNotInTree()

ilObjStudyProgramme::throwIfNotInTree ( )

protected

Exceptions

ilStudyProgrammeTreeException

if object is not in tree.

Definition at line 700 of file class.ilObjStudyProgramme.php.

                                         : void
    {
        if (!$this->tree->isInTree($this->getRefId())) {
            throw new ilStudyProgrammeTreeException("This program is not in tree.");
        }
    }

Referenced by addNode(), applyToSubTreeNodes(), getChildren(), getLPChildren(), and getParent().

Here is the caller graph for this function:

unmarkAccredited()

ilObjStudyProgramme::unmarkAccredited	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection
	)

Definition at line 1693 of file class.ilObjStudyProgramme.php.

     : void {
        $progress_node_id = $this->getId();
        $assignment = $this->assignment_repository->get($assignment_id)
            ->unmarkAccredited(
                $this->getSettingsRepository(),
                $progress_node_id,
                $acting_usr_id,
                $err_collection
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

update()

ilObjStudyProgramme::update

(

)

Exceptions

ilException

Reimplemented from ilContainer.

Definition at line 246 of file class.ilObjStudyProgramme.php.

                            : bool
    {
        parent::update();
 
        $type_settings = $this->getSettings()->getTypeSettings();
        // Update selection for advanced metadata of the type
        if ($type_settings->getTypeId()) {
            ilAdvancedMDRecord::saveObjRecSelection(
                $this->getId(),
                'prg_type',
                $this->type_repository->getAssignedAMDRecordIdsByType($type_settings->getTypeId())
            );
        } else {
            // If no type is assigned, delete relations by passing an empty array
            ilAdvancedMDRecord::saveObjRecSelection($this->getId(), 'prg_type', array());
        }
        return true;
    }

References ilObject\getId(), getSettings(), and ilAdvancedMDRecord\saveObjRecSelection().

Here is the call graph for this function:

updateCustomIcon()

ilObjStudyProgramme::updateCustomIcon

(

)

Definition at line 1561 of file class.ilObjStudyProgramme.php.

                                      : void
    {
        $customIcon = $this->custom_icon_factory->getByObjId($this->getId(), $this->getType());
        $subtype = $this->getSubType();
 
        if ($subtype
                && $this->webdir->has($subtype->getIconPath(true))
                && $subtype->getIconPath(true) !== $subtype->getIconPath(false)
        ) {
            $icon = $subtype->getIconPath(true);
            $customIcon->saveFromSourceFile($icon);
        } else {
            $customIcon->remove();
        }
    }

References ILIAS\Survey\Mode\getId().

Referenced by ilObjStudyProgrammeSettingsGUI\buildForm().

Here is the call graph for this function:

Here is the caller graph for this function:

updateLastChange()

ilObjStudyProgramme::updateLastChange ( )

protected

Update last change timestamp on this node and its parents.

Definition at line 1485 of file class.ilObjStudyProgramme.php.

                                         : void
    {
        $this->getSettings()->updateLastChange();
        if ($parent = $this->getParent()) {
            $parent->updateLastChange();
        }
        $this->update();
    }

References ILIAS\LTI\ToolProvider\getSettings().

Referenced by setPoints(), and setStatus().

Here is the call graph for this function:

Here is the caller graph for this function:

updatePlanFromRepository()

ilObjStudyProgramme::updatePlanFromRepository	(	int	$assignment_id,
		int	$acting_usr_id,
		ilPRGMessageCollection	$err_collection = null
	)

Definition at line 1808 of file class.ilObjStudyProgramme.php.

     : void {
        $assignment = $this->assignment_repository->get($assignment_id)
            ->updatePlanFromRepository(
                $this->getSettingsRepository(),
                $acting_usr_id,
                $err_collection
            );
 
        $this->assignment_repository->store($assignment);
        $this->refreshLPStatus($assignment->getUserId());
    }

updateSettings()

ilObjStudyProgramme::updateSettings

(

ilStudyProgrammeSettings

$settings

)

Definition at line 208 of file class.ilObjStudyProgramme.php.

                                                                      : bool
    {
        if ($settings->getObjId() !== $this->getId()) {
            throw new Exception("The given settings-object does not belong to this programme", 1);
        }
        $this->getSettingsRepository()->update($settings);
 
        return true;
    }

References ILIAS\LTI\ToolProvider\$settings, and getSettingsRepository().

Referenced by ilObjStudyProgrammeSettingsGUI\buildForm(), setPoints(), and setStatus().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$assignment_repository

ilPRGAssignmentDBRepository ilObjStudyProgramme::$assignment_repository

protected

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

Referenced by getAssignmentRepository(), and removeMemberFromProgrammes().

$auto_categories_repository

ilStudyProgrammeAutoCategoryDBRepository ilObjStudyProgramme::$auto_categories_repository

protected

Definition at line 44 of file class.ilObjStudyProgramme.php.

$auto_memberships_repository

ilStudyProgrammeAutoMembershipsDBRepository ilObjStudyProgramme::$auto_memberships_repository

protected

Definition at line 45 of file class.ilObjStudyProgramme.php.

$children

array ilObjStudyProgramme::$children = null

protected

Definition at line 35 of file class.ilObjStudyProgramme.php.

Referenced by getChildren().

$custom_icon_factory

ilObjectCustomIconFactory ilObjStudyProgramme::$custom_icon_factory

protected

Definition at line 65 of file class.ilObjStudyProgramme.php.

$events

ilStudyProgrammeEvents ilObjStudyProgramme::$events

protected

Definition at line 47 of file class.ilObjStudyProgramme.php.

$ilUser

ilObjUser ilObjStudyProgramme::$ilUser

protected

Definition at line 63 of file class.ilObjStudyProgramme.php.

Referenced by __construct().

$logger

ilLogger ilObjStudyProgramme::$logger

protected

Definition at line 66 of file class.ilObjStudyProgramme.php.

Referenced by getLogger().

$lp_children

array ilObjStudyProgramme::$lp_children = null

protected

Definition at line 40 of file class.ilObjStudyProgramme.php.

Referenced by getLPChildren().

$members_cache

array ilObjStudyProgramme::$members_cache = null

protected

Definition at line 55 of file class.ilObjStudyProgramme.php.

Referenced by getLocalMembers().

$membersourcereader_factory

ilStudyProgrammeMembershipSourceReaderFactory ilObjStudyProgramme::$membersourcereader_factory

protected

Definition at line 46 of file class.ilObjStudyProgramme.php.

$object_factory

ilObjectFactoryWrapper ilObjStudyProgramme::$object_factory = null

protected

Definition at line 64 of file class.ilObjStudyProgramme.php.

$parent

ilObjStudyProgramme::$parent

protected

Definition at line 30 of file class.ilObjStudyProgramme.php.

Referenced by getParent(), getParents(), and moveTo().

$reference_children

array ilObjStudyProgramme::$reference_children = null

protected

Definition at line 60 of file class.ilObjStudyProgramme.php.

$settings_repository

ilStudyProgrammeSettingsDBRepository ilObjStudyProgramme::$settings_repository

protected

Definition at line 48 of file class.ilObjStudyProgramme.php.

Referenced by getSettingsRepository().

$study_programme_cache

ilObjStudyProgrammeCache ilObjStudyProgramme::$study_programme_cache = null

staticprotected

Definition at line 25 of file class.ilObjStudyProgramme.php.

$type_repository

ilStudyProgrammeTypeDBRepository ilObjStudyProgramme::$type_repository

protected

Definition at line 42 of file class.ilObjStudyProgramme.php.

$webdir

Filesystem ilObjStudyProgramme::$webdir

protected

Definition at line 62 of file class.ilObjStudyProgramme.php.

---

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

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