ILIAS  trunk Revision v11.0_alpha-2638-g80c1d007f79
ilObjDataCollection Class Reference
+ Inheritance diagram for ilObjDataCollection:
+ Collaboration diagram for ilObjDataCollection:

Public Member Functions

 sendRecordNotification (int $action, ilDclBaseRecordModel $record)
 
 cloneStructure (int $original_id)
 
 setOnline (bool $a_val)
 
 getOnline ()
 
 setRating (bool $a_val)
 
 getRating ()
 
 setPublicNotes (bool $a_val)
 
 getPublicNotes ()
 
 setApproval (bool $a_val)
 
 getApproval ()
 
 setNotification (bool $a_val)
 
 getNotification ()
 
 getTables ()
 
 getTableById (int $table_id)
 
 getVisibleTables ()
 
 getStyleSheetId ()
 
- Public Member Functions inherited from ilObject2
 __construct (int $a_id=0, bool $a_reference=true)
 Constructor. More...
 
 read ()
 
 create (bool $a_clone_mode=false)
 
 update ()
 
 delete ()
 
 cloneMetaData (ilObject $target_obj)
 
 cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false)
 
- Public Member Functions inherited from ilObject
 getObjectProperties ()
 
 flushObjectProperties ()
 
 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 $description)
 
 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, int $new_obj_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...
 

Data Fields

const TYPE = 'dcl'
 
- 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
 

Protected Member Functions

 initType ()
 
 doRead ()
 
 doCreate (bool $clone_mode=false)
 
 doDelete ()
 
 doUpdate ()
 
 doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=null)
 
- Protected Member Functions inherited from ilObject2
 initType ()
 
 doRead ()
 
 doCreate (bool $clone_mode=false)
 
 beforeCreate ()
 If overwritten this method should return true, there is currently no "abort" handling for cases where "false" is returned. More...
 
 doUpdate ()
 
 beforeUpdate ()
 
 doDelete ()
 
 beforeDelete ()
 
 doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=null)
 
 beforeCloneObject ()
 
- Protected Member Functions inherited from ilObject
 doMDUpdateListener (string $a_element)
 
 beforeMDUpdateListener (string $a_element)
 
 doCreateMetaData ()
 
 beforeCreateMetaData ()
 
 doUpdateMetaData ()
 
 beforeUpdateMetaData ()
 
 doDeleteMetaData ()
 
 beforeDeleteMetaData ()
 
 handleAutoRating ()
 
 hasAutoRating ()
 

Private Attributes

bool $is_online = false
 
bool $rating = false
 
bool $approval = false
 
bool $public_notes = false
 
bool $notification = false
 

Additional Inherited Members

- 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 getIconForType (string $type)
 
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 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
 
LOMServices $lom_services
 
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 = ""
 
string $desc = ""
 
string $long_desc = ""
 
int $owner = 0
 
string $create_date = ""
 
string $last_update = ""
 
string $import_id = ""
 
bool $register = false
 

Detailed Description

Definition at line 21 of file class.ilObjDataCollection.php.

Member Function Documentation

◆ cloneStructure()

ilObjDataCollection::cloneStructure ( int  $original_id)

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

References ilObject\getId(), getTables(), setApproval(), ilDclCache\setCloneOf(), setNotification(), setPublicNotes(), setRating(), and ilDclCache\TYPE_DATACOLLECTION.

150  : void
151  {
152  $original = new ilObjDataCollection($original_id);
153  $this->setApproval($original->getApproval());
154  $this->setNotification($original->getNotification());
155  $this->setPublicNotes($original->getPublicNotes());
156  $this->setRating($original->getRating());
157  foreach ($this->getTables() as $table) {
158  $table->doDelete();
159  }
160  foreach ($original->getTables() as $table) {
161  $new_table = new ilDclTable();
162  $new_table->setObjId($this->getId());
163  $new_table->cloneStructure($table);
164  }
166  foreach ($this->getTables() as $table) {
167  $table->afterClone();
168  }
169  }
const TYPE_DATACOLLECTION
static setCloneOf(int $old, int $new, string $type)
+ Here is the call graph for this function:

◆ doCloneObject()

ilObjDataCollection::doCloneObject ( ilObject2  $new_obj,
int  $a_target_id,
?int  $a_copy_id = null 
)
protected

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

References ilCopyWizardOptions\_getInstance(), ilObject2\cloneMetaData(), getNotification(), getOnline(), ilObject\getRefId(), and ilObject2\update().

139  : void
140  {
141  $new_obj->setNotification($this->getNotification());
142  if (!(ilCopyWizardOptions::_getInstance($a_copy_id))->isRootNode($this->getRefId())) {
143  $new_obj->setOnline($this->getOnline());
144  $new_obj->update();
145  }
146  $new_obj->cloneStructure($this->getRefId());
147  $this->cloneMetaData($new_obj);
148  }
cloneMetaData(ilObject $target_obj)
static _getInstance(int $a_copy_id)
+ Here is the call graph for this function:

◆ doCreate()

ilObjDataCollection::doCreate ( bool  $clone_mode = false)
protected

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

References ilObject\createMetaData(), getApproval(), ilObject\getId(), getNotification(), getOnline(), getPublicNotes(), getRating(), ilDclCache\getTableCache(), ilObject\getTitle(), and ilDBConstants\T_INTEGER.

47  : void
48  {
49  if (!$clone_mode) {
50  $main_table = ilDclCache::getTableCache();
51  $main_table->setObjId($this->getId());
52  $main_table->setTitle($this->getTitle());
53  $main_table->setAddPerm(true);
54  $main_table->setEditPerm(true);
55  $main_table->setDeletePerm(false);
56  $main_table->setDeleteByOwner(true);
57  $main_table->setEditByOwner(true);
58  $main_table->setLimited(false);
59  $main_table->setIsVisible(true);
60  $main_table->doCreate();
61  }
62  $this->createMetaData();
63  $this->db->insert(
64  'il_dcl_data',
65  [
66  'id' => [ilDBConstants::T_INTEGER, $this->getId()],
67  'is_online' => [ilDBConstants::T_INTEGER, $this->getOnline() ? 1 : 0],
68  'rating' => [ilDBConstants::T_INTEGER, $this->getRating() ? 1 : 0],
69  'public_notes' => [ilDBConstants::T_INTEGER, $this->getPublicNotes() ? 1 : 0],
70  'approval' => [ilDBConstants::T_INTEGER, $this->getApproval() ? 1 : 0],
71  'notification' => [ilDBConstants::T_INTEGER, $this->getNotification() ? 1 : 0],
72  ]
73  );
74  }
static getTableCache(?int $table_id=null)
+ Here is the call graph for this function:

◆ doDelete()

ilObjDataCollection::doDelete ( )
protected

Definition at line 76 of file class.ilObjDataCollection.php.

References ilObject\deleteMetaData(), ilObject\getId(), getTables(), and ilDBConstants\T_INTEGER.

76  : void
77  {
78  foreach ($this->getTables() as $table) {
79  $table->doDelete(false, true);
80  }
81  $this->deleteMetaData();
82  $this->db->manipulateF('DELETE FROM il_dcl_data WHERE id = %s', [ilDBConstants::T_INTEGER], [$this->getId()]);
83  }
+ Here is the call graph for this function:

◆ doRead()

ilObjDataCollection::doRead ( )
protected

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

References $data, ilObject\getId(), setApproval(), setNotification(), setOnline(), setPublicNotes(), setRating(), and ilDBConstants\T_INTEGER.

35  : void
36  {
37  $stmt = $this->db->queryF('SELECT * FROM il_dcl_data WHERE id = %s', [ilDBConstants::T_INTEGER], [$this->getId()]);
38  if ($data = $this->db->fetchObject($stmt)) {
39  $this->setOnline((bool) $data->is_online);
40  $this->setRating((bool) $data->rating);
41  $this->setApproval((bool) $data->approval);
42  $this->setPublicNotes((bool) $data->public_notes);
43  $this->setNotification((bool) $data->notification);
44  }
45  }
+ Here is the call graph for this function:

◆ doUpdate()

ilObjDataCollection::doUpdate ( )
protected

Definition at line 85 of file class.ilObjDataCollection.php.

References getApproval(), ilObject\getId(), getNotification(), getOnline(), getPublicNotes(), getRating(), ilDBConstants\T_INTEGER, and ilObject\updateMetaData().

85  : void
86  {
87  $this->updateMetaData();
88  $this->db->update(
89  'il_dcl_data',
90  [
91  'id' => [ilDBConstants::T_INTEGER, $this->getId()],
92  'is_online' => [ilDBConstants::T_INTEGER, $this->getOnline() ? 1 : 0],
93  'rating' => [ilDBConstants::T_INTEGER, $this->getRating() ? 1 : 0],
94  'public_notes' => [ilDBConstants::T_INTEGER, $this->getPublicNotes() ? 1 : 0],
95  'approval' => [ilDBConstants::T_INTEGER, $this->getApproval() ? 1 : 0],
96  'notification' => [ilDBConstants::T_INTEGER, $this->getNotification() ? 1 : 0],
97  ],
98  [
99  'id' => [ilDBConstants::T_INTEGER, $this->getId()],
100  ]
101  );
102  }
+ Here is the call graph for this function:

◆ getApproval()

ilObjDataCollection::getApproval ( )

Definition at line 206 of file class.ilObjDataCollection.php.

References $approval.

Referenced by doCreate(), and doUpdate().

206  : bool
207  {
208  return $this->approval;
209  }
+ Here is the caller graph for this function:

◆ getNotification()

ilObjDataCollection::getNotification ( )

Definition at line 216 of file class.ilObjDataCollection.php.

References $notification.

Referenced by doCloneObject(), doCreate(), doUpdate(), and sendRecordNotification().

216  : bool
217  {
218  return $this->notification;
219  }
+ Here is the caller graph for this function:

◆ getOnline()

ilObjDataCollection::getOnline ( )

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

References $is_online.

Referenced by doCloneObject(), doCreate(), and doUpdate().

176  : bool
177  {
178  return $this->is_online;
179  }
+ Here is the caller graph for this function:

◆ getPublicNotes()

ilObjDataCollection::getPublicNotes ( )

Definition at line 196 of file class.ilObjDataCollection.php.

References $public_notes.

Referenced by doCreate(), and doUpdate().

196  : bool
197  {
198  return $this->public_notes;
199  }
+ Here is the caller graph for this function:

◆ getRating()

ilObjDataCollection::getRating ( )

Definition at line 186 of file class.ilObjDataCollection.php.

References $rating.

Referenced by doCreate(), and doUpdate().

186  : bool
187  {
188  return $this->rating;
189  }
+ Here is the caller graph for this function:

◆ getStyleSheetId()

ilObjDataCollection::getStyleSheetId ( )

Definition at line 257 of file class.ilObjDataCollection.php.

257  : int
258  {
259  return 0;
260  }

◆ getTableById()

ilObjDataCollection::getTableById ( int  $table_id)

Definition at line 238 of file class.ilObjDataCollection.php.

References ilDclCache\getTableCache().

Referenced by getTables().

238  : ilDclTable
239  {
240  return ilDclCache::getTableCache($table_id);
241  }
static getTableCache(?int $table_id=null)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getTables()

ilObjDataCollection::getTables ( )
Returns
ilDclTable[]

Definition at line 224 of file class.ilObjDataCollection.php.

References ilObject\getId(), getTableById(), and ilDBConstants\T_INTEGER.

Referenced by ilDclCopyFieldRepresentation\buildFieldCreationInput(), ilDclReferenceFieldRepresentation\buildFieldCreationInput(), cloneStructure(), doDelete(), and getVisibleTables().

224  : array
225  {
226  $stmt = $this->db->queryF(
227  'SELECT id FROM il_dcl_table WHERE obj_id = %s ORDER BY table_order',
229  [$this->getId()]
230  );
231  $tables = [];
232  while ($rec = $this->db->fetchAssoc($stmt)) {
233  $tables[$rec['id']] = $this->getTableById($rec['id']);
234  }
235  return $tables;
236  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getVisibleTables()

ilObjDataCollection::getVisibleTables ( )
Returns
ilDclTable[]

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

References getTables().

246  : array
247  {
248  $tables = [];
249  foreach ($this->getTables() as $table) {
250  if ($table->getIsVisible() && $table->getVisibleTableViews()) {
251  $tables[$table->getId()] = $table;
252  }
253  }
254  return $tables;
255  }
+ Here is the call graph for this function:

◆ initType()

ilObjDataCollection::initType ( )
protected

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

30  : void
31  {
32  $this->type = $this::TYPE;
33  }

◆ sendRecordNotification()

ilObjDataCollection::sendRecordNotification ( int  $action,
ilDclBaseRecordModel  $record 
)

Definition at line 104 of file class.ilObjDataCollection.php.

References $user_id, ANONYMOUS_USER_ID, ilObject\getId(), getNotification(), ilNotification\getNotificationsForObject(), ilObject\getRefId(), ilDclBaseRecordModel\getTable(), ilNotification\TYPE_DATA_COLLECTION, ilNotification\updateNotificationTime(), and ILIAS\Repository\user().

104  : void
105  {
106  if (!$this->getNotification()) {
107  return;
108  }
109 
112  $this->getId(),
113  1
114  );
115 
117 
118  $mail = new ilDataCollectionMailNotification();
119  $mail->setType($action);
120  $mail->setActor($this->user->getId());
121  $mail->setObjId($this->getId());
122  $mail->setRefId($this->getRefId());
123  $mail->setRecord($record);
124  $mail->setSender(ANONYMOUS_USER_ID);
125 
126  foreach ($users as $user_id) {
127  if (
128  $user_id !== $this->user->getId() &&
129  $record->getTable()->hasPermissionToViewRecord($this->getRefId(), $record, $user_id) &&
130  [] !== $record->getTable()->getVisibleTableViews($user_id)
131  ) {
132  $mail->addRecipient($user_id);
133  }
134  }
135 
136  $mail->send();
137  }
const ANONYMOUS_USER_ID
Definition: constants.php:27
static getNotificationsForObject(int $type, int $id, ?int $page_id=null, bool $ignore_threshold=false)
Get all users/recipients for given object.
static updateNotificationTime(int $type, int $id, array $user_ids, ?int $page_id=null, bool $activate_new_entries=true)
Update the last mail timestamp for given object and users.
+ Here is the call graph for this function:

◆ setApproval()

ilObjDataCollection::setApproval ( bool  $a_val)

Definition at line 201 of file class.ilObjDataCollection.php.

Referenced by cloneStructure(), and doRead().

201  : void
202  {
203  $this->approval = $a_val;
204  }
+ Here is the caller graph for this function:

◆ setNotification()

ilObjDataCollection::setNotification ( bool  $a_val)

Definition at line 211 of file class.ilObjDataCollection.php.

References ILIAS\UI\examples\Symbol\Glyph\Notification\notification().

Referenced by cloneStructure(), and doRead().

211  : void
212  {
213  $this->notification = $a_val;
214  }
notification()
description: > Example for rendring a notification glyph.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setOnline()

ilObjDataCollection::setOnline ( bool  $a_val)

Definition at line 171 of file class.ilObjDataCollection.php.

Referenced by doRead().

171  : void
172  {
173  $this->is_online = $a_val;
174  }
+ Here is the caller graph for this function:

◆ setPublicNotes()

ilObjDataCollection::setPublicNotes ( bool  $a_val)

Definition at line 191 of file class.ilObjDataCollection.php.

Referenced by cloneStructure(), and doRead().

191  : void
192  {
193  $this->public_notes = $a_val;
194  }
+ Here is the caller graph for this function:

◆ setRating()

ilObjDataCollection::setRating ( bool  $a_val)

Definition at line 181 of file class.ilObjDataCollection.php.

Referenced by cloneStructure(), and doRead().

181  : void
182  {
183  $this->rating = $a_val;
184  }
+ Here is the caller graph for this function:

Field Documentation

◆ $approval

bool ilObjDataCollection::$approval = false
private

Definition at line 26 of file class.ilObjDataCollection.php.

Referenced by getApproval().

◆ $is_online

bool ilObjDataCollection::$is_online = false
private

Definition at line 24 of file class.ilObjDataCollection.php.

Referenced by getOnline().

◆ $notification

bool ilObjDataCollection::$notification = false
private

Definition at line 28 of file class.ilObjDataCollection.php.

Referenced by getNotification().

◆ $public_notes

bool ilObjDataCollection::$public_notes = false
private

Definition at line 27 of file class.ilObjDataCollection.php.

Referenced by getPublicNotes().

◆ $rating

bool ilObjDataCollection::$rating = false
private

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

Referenced by getRating().

◆ TYPE

const ilObjDataCollection::TYPE = 'dcl'

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

Referenced by ilObjDataCollectionGUI\getType().


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