Description of class. More...

Inheritance diagram for ilDidacticTemplateLocalPolicyAction:

Collaboration diagram for ilDidacticTemplateLocalPolicyAction:

Public Member Functions
	__construct (int $action_id=0)

	addFilterPattern (ilDidacticTemplateFilterPattern $pattern)

	setFilterPatterns (array $patterns)
	Set filter patterns. More...

	getFilterPattern ()
	Get filter pattern. More...

	setFilterType (int $a_type)

	getFilterType ()

	setRoleTemplateType (int $a_tpl_type)

	getRoleTemplateType ()

	setRoleTemplateId (int $a_id)

	getRoleTemplateId ()

	save ()
	Write action to db Overwrite for filling additional db fields. More...

	delete ()
	Delete didactic template action Overwrite for filling additional db fields. More...

	apply ()
	Apply action. More...

	revert ()
	Implement everthing that is necessary to revert a didactic template return bool. More...

	getType ()
	Get type of template. More...

	toXml (ilXmlWriter $writer)

	__clone ()

	read ()

Public Member Functions inherited from ilDidacticTemplateAction
	__construct (int $action_id=0)

	getLogger ()

	getActionId ()

	setActionId (int $a_action_id)

	setType (int $a_type_id)

	setTemplateId (int $a_id)

	getTemplateId ()

	setRefId (int $a_ref_id)

	getRefId ()

	save ()
	Write action to db Overwrite for filling additional db fields. More...

	delete ()
	Delete didactic template action Overwrite for filling additional db fields. More...

	read ()

	getType ()
	Get type of template. More...

	apply ()
	Apply action. More...

	revert ()
	Implement everthing that is necessary to revert a didactic template return bool. More...

	__clone ()

	toXml (ilXmlWriter $writer)

Data Fields
const	TPL_ACTION_OVERWRITE = 1

const	TPL_ACTION_INTERSECT = 2

const	TPL_ACTION_ADD = 3

const	TPL_ACTION_SUBTRACT = 4

const	TPL_ACTION_UNION = 5

Data Fields inherited from ilDidacticTemplateAction
const	TYPE_LOCAL_POLICY = 1

const	TYPE_LOCAL_ROLE = 2

const	TYPE_BLOCK_ROLE = 3

const	FILTER_SOURCE_TITLE = 1

const	FILTER_SOURCE_OBJ_ID = 2

const	FILTER_PARENT_ROLES = 3

const	FILTER_LOCAL_ROLES = 4

const	PATTERN_PARENT_TYPE = 'action'

Protected Member Functions
	createLocalPolicy (ilObject $source, array $role)

	revertLocalPolicy (ilObject $source, array $role)

Protected Member Functions inherited from ilDidacticTemplateAction
	initSourceObject ()

	filterRoles (ilObject $source)

Private Attributes
array	$pattern = []

int	$filter_type = self::FILTER_SOURCE_TITLE

int	$role_template_type = self::TPL_ACTION_OVERWRITE

int	$role_template_id = 0

Additional Inherited Members
Protected Attributes inherited from ilDidacticTemplateAction
ilLogger	$logger

ilDBInterface	$db

ilRbacReview	$review

ilRbacAdmin	$admin

Detailed Description

Description of class.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

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

Constructor & Destructor Documentation

◆ __construct()

ilDidacticTemplateLocalPolicyAction::__construct ( int $action_id = 0 )

Reimplemented from ilDidacticTemplateAction.

Definition at line 39 of file class.ilDidacticTemplateLocalPolicyAction.php.

    {
        parent::__construct($action_id);
    }

References ilDidacticTemplateAction\$action_id, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ __clone()

ilDidacticTemplateLocalPolicyAction::__clone ( )

Reimplemented from ilDidacticTemplateAction.

Definition at line 273 of file class.ilDidacticTemplateLocalPolicyAction.php.

    {
        parent::__clone();
 
        $clones = [];
        foreach ($this->getFilterPattern() as $pattern) {
            $clones[] = clone $pattern;
        }
        $this->setFilterPatterns($clones);
    }

References $pattern, getFilterPattern(), and setFilterPatterns().

Here is the call graph for this function:

◆ addFilterPattern()

ilDidacticTemplateLocalPolicyAction::addFilterPattern ( ilDidacticTemplateFilterPattern $pattern )

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

                                                                              : void
    {
        $this->pattern[] = $pattern;
    }

References $pattern.

Referenced by read().

Here is the caller graph for this function:

◆ apply()

ilDidacticTemplateLocalPolicyAction::apply ( )

Apply action.

Returns: bool

Reimplemented from ilDidacticTemplateAction.

Definition at line 134 of file class.ilDidacticTemplateLocalPolicyAction.php.

                           : bool
    {
        $source = $this->initSourceObject();
        // Create a role folder for the new local policies
        $roles = $this->filterRoles($source);
 
        // Create local policy for filtered roles
        foreach ($roles as $role_id => $role) {
            $this->getLogger()->debug('Apply to role: ' . $role['title']);
            $this->getLogger()->debug('Role parent: ' . $role['parent']);
            $this->getLogger()->debug('Source ref_id: ' . $source->getRefId());
 
            // No local policies for protected roles of higher context
            if (
                (int) $role['parent'] !== $source->getRefId() &&
                $this->review->isProtected($role['parent'], $role_id)
            ) {
                $this->getLogger()->debug('Ignoring protected role.');
                continue;
            }
            $this->createLocalPolicy($source, $role);
        }
 
        return true;
    }

References createLocalPolicy(), ilDidacticTemplateAction\filterRoles(), ilDidacticTemplateAction\getLogger(), and ilDidacticTemplateAction\initSourceObject().

Here is the call graph for this function:

◆ createLocalPolicy()

ilDidacticTemplateLocalPolicyAction::createLocalPolicy	(	ilObject	$source,
		array	$role
	)

protected

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

                                                                       : bool
    {
        // fetch role information
        $role_data = [];
        foreach ($this->review->getParentRoleIds($source->getRefId()) as $role_id => $tmp_role) {
            if ((int) $role_id === (int) $role['obj_id']) {
                $role_data = $tmp_role;
            }
        }
 
        // Add local policy
        if (!$this->review->isRoleAssignedToObject((int) $role['obj_id'], $source->getRefId())) {
            $this->admin->assignRoleToFolder(
                (int) $role['obj_id'],
                $source->getRefId(),
                'n'
            );
        }
 
        // do nothing if role is protected in higher context
        if (
            (int) $role['parent'] !== $source->getRefId() &&
            $this->review->isProtected($source->getRefId(), (int) $role['obj_id'])
        ) {
            $this->getLogger()->info('Ignoring protected role: ' . $role['title']);
            return false;
        }
 
        switch ($this->getRoleTemplateType()) {
            case self::TPL_ACTION_UNION:
 
                $this->logger->info('Using ilRbacAdmin::copyRolePermissionUnion()');
                $this->admin->copyRolePermissionUnion(
                    (int) $role_data['obj_id'],
                    (int) $role_data['parent'],
                    $this->getRoleTemplateId(),
                    ROLE_FOLDER_ID,
                    (int) $role_data['obj_id'],
                    $source->getRefId()
                );
                break;
 
            case self::TPL_ACTION_OVERWRITE:
 
                $this->logger->info('Using ilRbacAdmin::copyRoleTemplatePermission()');
                $this->admin->copyRoleTemplatePermissions(
                    $this->getRoleTemplateId(),
                    ROLE_FOLDER_ID,
                    $source->getRefId(),
                    (int) $role_data['obj_id'],
                    true
                );
                break;
 
            case self::TPL_ACTION_INTERSECT:
 
                $this->logger->info('Using ilRbacAdmin::copyRolePermissionIntersection()' . $this->getRoleTemplateId());
                $this->admin->copyRolePermissionIntersection(
                    (int) $role_data['obj_id'],
                    (int) $role_data['parent'],
                    $this->getRoleTemplateId(),
                    ROLE_FOLDER_ID,
                    $source->getRefId(),
                    (int) $role_data['obj_id']
                );
                break;
        }
        // Change existing object
        $role_obj = new ilObjRole((int) $role_data['obj_id']);
        $role_obj->changeExistingObjects(
            $source->getRefId(),
            $role_data['protected'] ? ilObjRole::MODE_PROTECTED_DELETE_LOCAL_POLICIES : ilObjRole::MODE_UNPROTECTED_DELETE_LOCAL_POLICIES,
            ['all']
        );
 
        return true;
    }

References ilDidacticTemplateAction\getLogger(), ilObject\getRefId(), getRoleTemplateId(), getRoleTemplateType(), ILIAS\Repository\logger(), ilObjRole\MODE_PROTECTED_DELETE_LOCAL_POLICIES, ilObjRole\MODE_UNPROTECTED_DELETE_LOCAL_POLICIES, ROLE_FOLDER_ID, TPL_ACTION_INTERSECT, TPL_ACTION_OVERWRITE, and TPL_ACTION_UNION.

Referenced by apply().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ilDidacticTemplateLocalPolicyAction::delete ( )

Delete didactic template action Overwrite for filling additional db fields.

Reimplemented from ilDidacticTemplateAction.

Definition at line 122 of file class.ilDidacticTemplateLocalPolicyAction.php.

                            : void
    {
        parent::delete();
        $query = 'DELETE FROM didactic_tpl_alp ' .
            'WHERE action_id  = ' . $this->db->quote($this->getActionId(), 'integer');
        $this->db->manipulate($query);
 
        foreach ($this->getFilterPattern() as $pattern) {
            $pattern->delete();
        }
    }

References $pattern, ilDidacticTemplateAction\getActionId(), and getFilterPattern().

Here is the call graph for this function:

◆ getFilterPattern()

ilDidacticTemplateLocalPolicyAction::getFilterPattern ( )

Get filter pattern.

Returns: ilDidacticTemplateFilterPattern[]

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

                                      : array
    {
        return $this->pattern;
    }

References $pattern.

Referenced by __clone(), delete(), save(), and toXml().

Here is the caller graph for this function:

◆ getFilterType()

ilDidacticTemplateLocalPolicyAction::getFilterType ( )

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

                                   : int
    {
        return $this->filter_type;
    }

References $filter_type.

Referenced by save(), and toXml().

Here is the caller graph for this function:

◆ getRoleTemplateId()

ilDidacticTemplateLocalPolicyAction::getRoleTemplateId ( )

Definition at line 92 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                       : int
    {
        return $this->role_template_id;
    }

References $role_template_id.

Referenced by createLocalPolicy(), save(), and toXml().

Here is the caller graph for this function:

◆ getRoleTemplateType()

ilDidacticTemplateLocalPolicyAction::getRoleTemplateType ( )

Definition at line 82 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                         : int
    {
        return $this->role_template_type;
    }

References $role_template_type.

Referenced by createLocalPolicy(), save(), and toXml().

Here is the caller graph for this function:

◆ getType()

ilDidacticTemplateLocalPolicyAction::getType ( )

Get type of template.

Returns: int $type

Reimplemented from ilDidacticTemplateAction.

Definition at line 197 of file class.ilDidacticTemplateLocalPolicyAction.php.

                             : int
    {
        return self::TYPE_LOCAL_POLICY;
    }

References ilDidacticTemplateAction\TYPE_LOCAL_POLICY.

◆ read()

ilDidacticTemplateLocalPolicyAction::read ( )

Reimplemented from ilDidacticTemplateAction.

Definition at line 284 of file class.ilDidacticTemplateLocalPolicyAction.php.

                          : void
    {
        parent::read();
        $query = 'SELECT * FROM didactic_tpl_alp ' .
            'WHERE action_id = ' . $this->db->quote($this->getActionId(), ilDBConstants::T_INTEGER);
        $res = $this->db->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $this->setFilterType((int) $row->filter_type);
            $this->setRoleTemplateType((int) $row->template_type);
            $this->setRoleTemplateId((int) $row->template_id);
        }
        // Read filter
        foreach (ilDidacticTemplateFilterPatternFactory::lookupPatternsByParentId(
            $this->getActionId(),
            self::PATTERN_PARENT_TYPE
        ) as $pattern) {
            $this->addFilterPattern($pattern);
        }
    }

References $pattern, $res, addFilterPattern(), ilDBConstants\FETCHMODE_OBJECT, ilDidacticTemplateAction\getActionId(), ilDidacticTemplateFilterPatternFactory\lookupPatternsByParentId(), setFilterType(), setRoleTemplateId(), setRoleTemplateType(), and ilDBConstants\T_INTEGER.

Here is the call graph for this function:

◆ revert()

ilDidacticTemplateLocalPolicyAction::revert ( )

Implement everthing that is necessary to revert a didactic template return bool.

Reimplemented from ilDidacticTemplateAction.

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

                            : bool
    {
        $source = $this->initSourceObject();
        $roles = $this->filterRoles($source);
 
        // Delete local policy for filtered roles
        foreach ($roles as $role_id => $role) {
            // Do not delete local policies of auto generated roles
            if (!$this->review->isGlobalRole($role['obj_id']) &&
                $this->review->isAssignable($role['obj_id'], $source->getRefId()) &&
                $this->review->isSystemGeneratedRole($role['obj_id'])) {
                $this->getLogger()->debug('Reverting local policy of auto generated role: ' . $role['title']);
                $this->revertLocalPolicy($source, $role);
            } else {
                $this->getLogger()->debug('Reverting local policy and deleting local role: ' . $role['title']);
 
                // delete local role and change exiting objects
                $this->admin->deleteLocalRole($role_id, $source->getRefId());
 
                // Change existing object
                $role_obj = new ilObjRole($role_id);
 
                $protected = $this->review->isProtected($role['parent'], $role['rol_id']);
 
                $role_obj->changeExistingObjects(
                    $source->getRefId(),
                    $protected ?
                        ilObjRole::MODE_PROTECTED_DELETE_LOCAL_POLICIES :
                        ilObjRole::MODE_UNPROTECTED_DELETE_LOCAL_POLICIES,
                    ['all']
                );
            }
        }
 
        return true;
    }

References ilDidacticTemplateAction\filterRoles(), ilDidacticTemplateAction\getLogger(), ilDidacticTemplateAction\initSourceObject(), ilObjRole\MODE_PROTECTED_DELETE_LOCAL_POLICIES, ilObjRole\MODE_UNPROTECTED_DELETE_LOCAL_POLICIES, and revertLocalPolicy().

Here is the call graph for this function:

◆ revertLocalPolicy()

ilDidacticTemplateLocalPolicyAction::revertLocalPolicy	(	ilObject	$source,
		array	$role
	)

protected

Definition at line 382 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                                                       : bool
    {
        $this->logger->info('Reverting policy for role ' . $role['title']);
        // Local policies can only be reverted for auto generated roles. Otherwise the
        // original role settings are unknown
        if (strpos($role['title'], 'il_') !== 0) {
            $this->logger->warning('Cannot revert local policy for role ' . $role['title']);
            return false;
        }
 
        // No local policies
        if (!$this->review->getLocalPolicies($source->getRefId())) {
            return false;
        }
 
        $exploded_title = explode('_', $role['title']);
        $rolt_title = $exploded_title[0] . '_' . $exploded_title[1] . '_' . $exploded_title[2];
 
        // Lookup role template
        $query = 'SELECT obj_id FROM object_data ' .
            'WHERE title = ' . $this->db->quote($rolt_title, 'text') . ' ' .
            'AND type = ' . $this->db->quote('rolt', 'text');
        $res = $this->db->query($query);
        $rolt_id = 0;
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $rolt_id = (int) $row->obj_id;
        }
 
        // No template found
        if (!$rolt_id) {
            return false;
        }
 
        $this->admin->copyRoleTemplatePermissions(
            $rolt_id,
            ROLE_FOLDER_ID,
            $source->getRefId(),
            (int) $role['obj_id'],
            true
        );
 
        // Change existing object
        $role_obj = new ilObjRole((int) $role['obj_id']);
        $role_obj->changeExistingObjects(
            $source->getRefId(),
            $role['protected'] ? ilObjRole::MODE_PROTECTED_DELETE_LOCAL_POLICIES : ilObjRole::MODE_UNPROTECTED_DELETE_LOCAL_POLICIES,
            ['all']
        );
 
        return true;
    }

References $res, ilDBConstants\FETCHMODE_OBJECT, ilObject\getRefId(), ILIAS\Repository\int(), ILIAS\Repository\logger(), ilObjRole\MODE_PROTECTED_DELETE_LOCAL_POLICIES, ilObjRole\MODE_UNPROTECTED_DELETE_LOCAL_POLICIES, and ROLE_FOLDER_ID.

Referenced by revert().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilDidacticTemplateLocalPolicyAction::save ( )

Write action to db Overwrite for filling additional db fields.

Returns: int

Reimplemented from ilDidacticTemplateAction.

Definition at line 97 of file class.ilDidacticTemplateLocalPolicyAction.php.

                          : int
    {
        if (!parent::save()) {
            return 0;
        }
 
        $query = 'INSERT INTO didactic_tpl_alp (action_id,filter_type,template_type,template_id) ' .
            'VALUES( ' .
            $this->db->quote($this->getActionId(), 'integer') . ', ' .
            $this->db->quote($this->getFilterType(), 'integer') . ', ' .
            $this->db->quote($this->getRoleTemplateType(), 'integer') . ', ' .
            $this->db->quote($this->getRoleTemplateId(), 'integer') . ' ' .
            ')';
        $this->db->manipulate($query);
 
        foreach ($this->getFilterPattern() as $pattern) {
            /* @var ilDidacticTemplateFilterPattern $pattern */
            $pattern->setParentId($this->getActionId());
            $pattern->setParentType(self::PATTERN_PARENT_TYPE);
            $pattern->save();
        }
 
        return $this->getActionId();
    }

References $pattern, ilDidacticTemplateAction\getActionId(), getFilterPattern(), getFilterType(), getRoleTemplateId(), and getRoleTemplateType().

Here is the call graph for this function:

◆ setFilterPatterns()

ilDidacticTemplateLocalPolicyAction::setFilterPatterns ( array $patterns )

Set filter patterns.

Parameters

ilDidacticTemplateExcludeFilterPattern[] $patterns

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

                                                      : void
    {
        $this->pattern = $patterns;
    }

Referenced by __clone().

Here is the caller graph for this function:

◆ setFilterType()

ilDidacticTemplateLocalPolicyAction::setFilterType ( int $a_type )

Definition at line 67 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                              : void
    {
        $this->filter_type = $a_type;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setRoleTemplateId()

ilDidacticTemplateLocalPolicyAction::setRoleTemplateId ( int $a_id )

Definition at line 87 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                                : void
    {
        $this->role_template_id = $a_id;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setRoleTemplateType()

ilDidacticTemplateLocalPolicyAction::setRoleTemplateType ( int $a_tpl_type )

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

                                                        : void
    {
        $this->role_template_type = $a_tpl_type;
    }

Referenced by read().

Here is the caller graph for this function:

◆ toXml()

ilDidacticTemplateLocalPolicyAction::toXml ( ilXmlWriter $writer )

Reimplemented from ilDidacticTemplateAction.

Definition at line 202 of file class.ilDidacticTemplateLocalPolicyAction.php.

                                              : void
    {
        $writer->xmlStartTag('localPolicyAction');
 
        switch ($this->getFilterType()) {
            case self::FILTER_SOURCE_OBJ_ID:
                $writer->xmlStartTag('roleFilter', ['source' => 'objId']);
                break;
 
            case self::FILTER_PARENT_ROLES:
                $writer->xmlStartTag('roleFilter', ['source' => 'parentRoles']);
                break;
 
            case self::FILTER_LOCAL_ROLES:
                $writer->xmlStartTag('roleFilter', ['source' => 'localRoles']);
                break;
 
            case self::FILTER_SOURCE_TITLE:
            default:
                $writer->xmlStartTag('roleFilter', ['source' => 'title']);
                break;
        }
 
        foreach ($this->getFilterPattern() as $pattern) {
            $pattern->toXml($writer);
        }
        $writer->xmlEndTag('roleFilter');
 
        $il_role_id = 'il_' . IL_INST_ID . '_' . ilObject::_lookupType($this->getRoleTemplateId()) . '_' . $this->getRoleTemplateId();
 
        switch ($this->getRoleTemplateType()) {
            case self::TPL_ACTION_OVERWRITE:
                $writer->xmlStartTag(
                    'localPolicyTemplate',
                    [
                        'type' => 'overwrite',
                        'id' => $il_role_id
                    ]
                );
                break;
 
            case self::TPL_ACTION_INTERSECT:
                $writer->xmlStartTag(
                    'localPolicyTemplate',
                    [
                        'type' => 'intersect',
                        'id' => $il_role_id
                    ]
                );
                break;
 
            case self::TPL_ACTION_UNION:
                $writer->xmlStartTag(
                    'localPolicyTemplate',
                    [
                        'type' => 'union',
                        'id' => $il_role_id
                    ]
                );
                break;
        }
 
        $exp = new ilRoleXmlExport();
        $exp->setMode(ilRoleXmlExport::MODE_DTPL);
        $exp->addRole($this->getRoleTemplateId(), ROLE_FOLDER_ID);
        $exp->write();
        $writer->appendXML($exp->xmlDumpMem(false));
        $writer->xmlEndTag('localPolicyTemplate');
        $writer->xmlEndTag('localPolicyAction');
    }