ilObjDataCollectionAccess Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilObjDataCollectionAccess:

Collaboration diagram for ilObjDataCollectionAccess:

Public Member Functions
	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, ?int $user_id=null)
	Checks whether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...
Public Member Functions inherited from ilObjectAccess
	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, ?int $user_id=null)
	Checks whether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...
	canBeDelivered (ilWACPath $ilWACPath)
	canBeDelivered (ilWACPath $ilWACPath)

Static Public Member Functions
static	_getCommands ()
	get commands this method returns an array of all possible commands/permission combinations example: $commands = array ( array("permission" => "read", "cmd" => "view", "lang_var" => "show"), array("permission" => "write", "cmd" => "edit", "lang_var" => "edit"), ); More...
static	_checkGoto (string $target)
	check whether goto script will succeed More...
static	_lookupOnline (int $a_id)
	Check wether datacollection is online. More...
static	checkAccessForDataCollectionId (int $data_collection_id)
static	checkActionForObjId (string $action, int $obj_id)
static	hasWriteAccess (int $ref, ?int $user_id=0)
static	hasEditAccess (int $ref, ?int $user_id=0)
static	hasAddRecordAccess (int $ref, ?int $user_id=0)
static	hasReadAccess (int $ref, ?int $user_id=0)
static	hasAccessToTableView ($tableview, ?int $user_id=0)
	This only checks access to the tableview - if the full access check is required, use hasAccessTo($ref_id, $table_id, $tableview_id) More...
static	hasAccessToFields (int $ref_id, int $table_id)
static	hasAccessToEditTable (int $ref_id, int $table_id)
static	hasAccessToField (int $ref_id, int $table_id, int $field_id)
static	hasPermissionToAddRecord (int $ref_id, int $table_id)
Static Public Member Functions inherited from ilObjectAccess
static	_getCommands ()
	get commands More...
static	_checkGoto (string $target)
	check whether goto script will succeed More...
static	_isOffline (int $obj_id)
	Type-specific implementation of general status, has to be overwritten if object type does not support centralized offline handling. More...
static	_preloadData (array $obj_ids, array $ref_ids)
	Preload data. More...

Static Protected Member Functions
static	isTableInDataCollection (ilDclTable $table, int $ref_id)
static	hasAccessToTable (int $table_id, int $ref_id)
	returns true if either the table is visible for all users, or no tables are visible and this is the table with the lowest order (getFirstVisibleTableId()) More...

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning

Definition at line 19 of file class.ilObjDataCollectionAccess.php.

Member Function Documentation

_checkAccess()

ilObjDataCollectionAccess::_checkAccess	(	string	$cmd,
		string	$permission,
		int	$ref_id,
		int	$obj_id,
		?int	$user_id = null
	)

Checks whether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess)

Please do not check any preconditions handled by ilConditionHandler here. Also don't do any RBAC checks.

Reimplemented from ilObjectAccess.

Definition at line 77 of file class.ilObjDataCollectionAccess.php.

                                                                                                                 : bool
    {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $lng = $DIC['lng'];
        $rbacsystem = $DIC['rbacsystem'];
        $ilAccess = $DIC['ilAccess'];
 
        if (is_null($user_id) === true) {
            $user_id = $ilUser->getId();
        }
 
        switch ($cmd) {
            case "view":
 
                if (!ilObjDataCollectionAccess::_lookupOnline($obj_id)
                    && !$rbacsystem->checkAccessOfUser($user_id, 'write', $ref_id)
                ) {
                    $ilAccess->addInfoItem(ilAccessInfo::IL_NO_OBJECT_ACCESS, $lng->txt("offline"));
 
                    return false;
                }
                break;
 
                // for permission query feature
            case "infoScreen":
                if (!ilObjDataCollectionAccess::_lookupOnline($obj_id)) {
                    $ilAccess->addInfoItem(ilAccessInfo::IL_NO_OBJECT_ACCESS, $lng->txt("offline"));
                } else {
                    $ilAccess->addInfoItem(ilAccessInfo::IL_STATUS_MESSAGE, $lng->txt("online"));
                }
                break;
        }
        switch ($permission) {
            case "read":
            case "visible":
                if (!ilObjDataCollectionAccess::_lookupOnline($obj_id)
                    && (!$rbacsystem->checkAccessOfUser($user_id, 'write', $ref_id))
                ) {
                    $ilAccess->addInfoItem(ilAccessInfo::IL_NO_OBJECT_ACCESS, $lng->txt("offline"));
 
                    return false;
                }
                break;
        }
 
        return true;
    }

References $DIC, $ilUser, $lng, $ref_id, _lookupOnline(), ilAccessInfo\IL_NO_OBJECT_ACCESS, and ilAccessInfo\IL_STATUS_MESSAGE.

Here is the call graph for this function:

_checkGoto()

static ilObjDataCollectionAccess::_checkGoto ( string  $target )

static

check whether goto script will succeed

Reimplemented from ilObjectAccess.

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

                                                     : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        $t_arr = explode("_", $target);
 
        if ($t_arr[0] != "dcl" || ((int) $t_arr[1]) <= 0) {
            return false;
        }
 
        if ($ilAccess->checkAccess("read", "", $t_arr[1]) ||
            $ilAccess->checkAccess("visible", "", $t_arr[1])) {
            return true;
        }
 
        return false;
    }

References $DIC.

_getCommands()

static ilObjDataCollectionAccess::_getCommands ( )

static

get commands this method returns an array of all possible commands/permission combinations example: $commands = array ( array("permission" => "read", "cmd" => "view", "lang_var" => "show"), array("permission" => "write", "cmd" => "edit", "lang_var" => "edit"), );

Reimplemented from ilObjectAccess.

Definition at line 31 of file class.ilObjDataCollectionAccess.php.

                                         : array
    {
        $commands = array(
            array("permission" => "read", "cmd" => "render", "lang_var" => "show", "default" => true),
            array("permission" => "write", "cmd" => "listRecords", "lang_var" => "edit_content"),
            array("permission" => "write", "cmd" => "edit", "lang_var" => "settings"),
        );
 
        return $commands;
    }

Referenced by ilObjDataCollectionListGUI\init().

Here is the caller graph for this function:

_lookupOnline()

static ilObjDataCollectionAccess::_lookupOnline ( int  $a_id )

static

Check wether datacollection is online.

Parameters

int

$a_id

wiki id

Definition at line 130 of file class.ilObjDataCollectionAccess.php.

                                                   : bool
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $q = "SELECT * FROM il_dcl_data WHERE id = " . $ilDB->quote($a_id, "integer");
        $dcl_set = $ilDB->query($q);
        $dcl_rec = $ilDB->fetchAssoc($dcl_set);
 
        return !is_null($dcl_rec) && $dcl_rec["is_online"];
    }

References $DIC, and $ilDB.

Referenced by _checkAccess(), ilObjDataCollectionListGUI\getProperties(), and ilContainer\legacyOnlineFilter().

Here is the caller graph for this function:

checkAccessForDataCollectionId()

static ilObjDataCollectionAccess::checkAccessForDataCollectionId ( int  $data_collection_id )

static

Parameters

$data_collection_id

@depracated use checkActionForId instead

Returns

bool

Definition at line 151 of file class.ilObjDataCollectionAccess.php.

                                                                                  : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        $perm = false;
        $references = ilObject2::_getAllReferences($data_collection_id);
 
        if ($ilAccess->checkAccess("add_entry", "", array_shift($references))) {
            $perm = true;
        }
 
        return $perm;
    }

References $DIC, and ilObject\_getAllReferences().

Here is the call graph for this function:

checkActionForObjId()

static ilObjDataCollectionAccess::checkActionForObjId ( string  $action, int  $obj_id  )

static

Definition at line 166 of file class.ilObjDataCollectionAccess.php.

                                                                           : bool
    {
        foreach (ilObject2::_getAllReferences($obj_id) as $ref_id) {
            if (self::checkActionForRefId($action, $ref_id)) {
                return true;
            }
        }
 
        return false;
    }

References $ref_id, and ilObject\_getAllReferences().

Referenced by ilDclTableEditGUI\save().

Here is the call graph for this function:

Here is the caller graph for this function:

hasAccessToEditTable()

static ilObjDataCollectionAccess::hasAccessToEditTable ( int  $ref_id, int  $table_id  )

static

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

                                                                           : bool
    {
        return self::hasAccessToFields($ref_id, $table_id);
    }

References $ref_id, and hasAccessToFields().

Referenced by ilDclFieldListGUI\checkAccess(), ilDclTableEditGUI\checkAccess(), ilDclTableViewGUI\checkAccess(), and ilDclTableViewEditGUI\checkAccess().

Here is the call graph for this function:

Here is the caller graph for this function:

hasAccessToField()

static ilObjDataCollectionAccess::hasAccessToField ( int  $ref_id, int  $table_id, int  $field_id  )

static

Definition at line 315 of file class.ilObjDataCollectionAccess.php.

                                                                                      : bool
    {
        $table = ilDclCache::getTableCache($table_id);
 
        return in_array($field_id, $table->getFieldIds()) && self::hasAccessToFields($ref_id, $table_id);
    }

References $ref_id, ilDclCache\getTableCache(), and hasAccessToFields().

Referenced by ilDclFieldEditGUI\checkAccess().

Here is the call graph for this function:

Here is the caller graph for this function:

hasAccessToFields()

static ilObjDataCollectionAccess::hasAccessToFields ( int  $ref_id, int  $table_id  )

static

Definition at line 304 of file class.ilObjDataCollectionAccess.php.

                                                                        : bool
    {
        return self::isTableInDataCollection(ilDclCache::getTableCache($table_id), $ref_id)
            && (self::hasWriteAccess($ref_id));
    }

References $ref_id, ilDclCache\getTableCache(), hasWriteAccess(), and isTableInDataCollection().

Referenced by ilDclFieldEditGUI\checkAccess(), ilDclFieldListTableGUI\fillRowFromObject(), hasAccessToEditTable(), and hasAccessToField().

Here is the call graph for this function:

Here is the caller graph for this function:

hasAccessToTable()

static ilObjDataCollectionAccess::hasAccessToTable ( int  $table_id, int  $ref_id  )

staticprotected

returns true if either the table is visible for all users, or no tables are visible and this is the table with the lowest order (getFirstVisibleTableId())

Parameters

$table_id

Returns

bool

Definition at line 278 of file class.ilObjDataCollectionAccess.php.

                                                                          : bool
    {
        $table = ilDclCache::getTableCache($table_id);
        return self::hasWriteAccess($ref_id) || $table->getIsVisible();
    }

References $ref_id, ilDclCache\getTableCache(), and hasWriteAccess().

Here is the call graph for this function:

hasAccessToTableView()

static ilObjDataCollectionAccess::hasAccessToTableView (   $tableview, ?int  $user_id = 0  )

static

This only checks access to the tableview - if the full access check is required, use hasAccessTo($ref_id, $table_id, $tableview_id)

Parameters

integer | ilDclTableView

$tableview

can be object or id

Definition at line 253 of file class.ilObjDataCollectionAccess.php.

                                                                              : bool
    {
        global $DIC;
        $rbacreview = $DIC['rbacreview'];
        $ilUser = $DIC['ilUser'];
        if (!$tableview) {
            return false;
        }
 
        if (is_numeric($tableview)) {
            $tableview = ilDclTableView::find($tableview);
        }
 
        $assigned_roles = $rbacreview->assignedRoles($user_id ?: $ilUser->getId());
        $allowed_roles = $tableview->getRoles();
 
        return !empty(array_intersect($assigned_roles, $allowed_roles));
    }

References $DIC, and $ilUser.

Referenced by ilDclTable\getVisibleTableViews().

Here is the caller graph for this function:

hasAddRecordAccess()

static ilObjDataCollectionAccess::hasAddRecordAccess ( int  $ref, ?int  $user_id = 0  )

static

Parameters

$ref	int the reference id of the datacollection object to check.

Returns

bool whether or not the current user has admin/write access to the referenced datacollection

Definition at line 221 of file class.ilObjDataCollectionAccess.php.

                                                                          : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        if ($user_id) {
            return $ilAccess->checkAccessOfUser($user_id, "write", "", $ref);
        }
 
        return $ilAccess->checkAccess("add_entry", "", $ref);
    }

References $DIC.

Referenced by ilDclRecordEditGUI\getRecord(), hasPermissionToAddRecord(), ilDclTable\hasPermissionToDeleteRecord(), ilDclTable\hasPermissionToDeleteRecords(), and ilDclTable\hasPermissionToEditRecord().

Here is the caller graph for this function:

hasEditAccess()

static ilObjDataCollectionAccess::hasEditAccess ( int  $ref, ?int  $user_id = 0  )

static

Definition at line 205 of file class.ilObjDataCollectionAccess.php.

                                                                     : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        if ($user_id) {
            return $ilAccess->checkAccessOfUser($user_id, "write", "", $ref);
        }
 
        return $ilAccess->checkAccess("edit_content", "", $ref);
    }

References $DIC.

Referenced by ilDclTable\hasPermissionToEditRecord(), and ilDclTable\hasPermissionToViewRecord().

Here is the caller graph for this function:

hasPermissionToAddRecord()

static ilObjDataCollectionAccess::hasPermissionToAddRecord ( int  $ref_id, int  $table_id  )

static

Definition at line 322 of file class.ilObjDataCollectionAccess.php.

                                                                               : bool
    {
        $table = ilDclCache::getTableCache($table_id);
        if (!self::isTableInDataCollection($table, $ref_id)) {
            return false;
        }
 
        return ilObjDataCollectionAccess::hasWriteAccess($ref_id)
            || (ilObjDataCollectionAccess::hasAddRecordAccess($ref_id) && $table->getAddPerm() && $table->checkLimit());
    }

References $ref_id, ilDclCache\getTableCache(), hasAddRecordAccess(), and hasWriteAccess().

Referenced by ilDclReferenceFieldRepresentation\getInputField(), ilDclRecordListGUI\importExcel(), and ilDclRecordEditGUI\save().

Here is the call graph for this function:

Here is the caller graph for this function:

hasReadAccess()

static ilObjDataCollectionAccess::hasReadAccess ( int  $ref, ?int  $user_id = 0  )

static

Parameters

$ref	int the reference id of the datacollection object to check.

Returns

bool whether or not the current user has read access to the referenced datacollection

Definition at line 237 of file class.ilObjDataCollectionAccess.php.

                                                                     : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        if ($user_id) {
            return $ilAccess->checkAccessOfUser($user_id, "write", "", $ref);
        }
 
        return $ilAccess->checkAccess("read", "", $ref);
    }

References $DIC.

Referenced by ilObjDataCollection\_hasReadAccess(), ilSoapDataCollectionAdministration\exportDataCollectionContent(), and ilDclTable\hasPermissionToViewRecord().

Here is the caller graph for this function:

hasWriteAccess()

static ilObjDataCollectionAccess::hasWriteAccess ( int  $ref, ?int  $user_id = 0  )

static

Parameters

$ref	int the reference id of the datacollection object to check.

Returns

bool whether or not the current user has admin/write access to the referenced datacollection

Definition at line 193 of file class.ilObjDataCollectionAccess.php.

                                                                      : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        if ($user_id) {
            return $ilAccess->checkAccessOfUser($user_id, "write", "", $ref);
        }
 
        return $ilAccess->checkAccess("write", "", $ref);
    }

References $DIC.

Referenced by ilObjDataCollection\_hasWriteAccess(), ilDclTableEditGUI\checkAccess(), ilDclTableListGUI\checkAccess(), ilDclDetailedViewGUI\doExtReplace(), ilDclRecordListGUI\getAvailableTables(), ilDclTable\getVisibleTableViews(), hasAccessToFields(), hasAccessToTable(), hasPermissionToAddRecord(), ilDclTable\hasPermissionToDeleteRecord(), ilDclTable\hasPermissionToDeleteRecords(), ilDclTable\hasPermissionToEditRecord(), ilDclTable\hasPermissionToViewRecord(), ilDclRecordEditGUI\initForm(), and ilDclRecordEditGUI\save().

Here is the caller graph for this function:

isTableInDataCollection()

static ilObjDataCollectionAccess::isTableInDataCollection ( ilDclTable  $table, int  $ref_id  )

staticprotected

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

                                                                                     : bool
    {
        if ($table->getObjId() !== null) {
            foreach (ilObjDataCollection::_getAllReferences($table->getObjId()) as $reference) {
                if ($reference == $ref_id) {
                    return true;
                }
            }
        }
 
        return false;
    }

References $ref_id, ilObject\_getAllReferences(), and ilDclTable\getObjId().

Referenced by hasAccessToFields().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• Modules/DataCollection/classes/class.ilObjDataCollectionAccess.php