Description of class. More...

Collaboration diagram for ilRoleXmlImporter:

Public Member Functions
	__construct ($a_role_folder_id=0)
	Constructor. More...

	setXml ($a_xml)

	getXml ()

	getRoleFolderId ()
	Get role folder id. More...

	getRole ()
	Get role. More...

	setRole (ilObject $role)
	Set role or role template. More...

	import ()
	import role \| role templatae More...

	importSimpleXml (SimpleXMLElement $role)
	Import using simplexml. More...

Protected Member Functions
	assigntoRoleFolder ()
	Assign role to folder type $rbacadmin. More...

	initRole ($import_id)

	parseXmlErrors ()

Protected Attributes
	$role_folder = 0

	$role = null

	$xml = ''

Detailed Description

Description of class.

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

Definition at line 12 of file class.ilRoleXmlImporter.php.

Constructor & Destructor Documentation

◆ __construct()

ilRoleXmlImporter::__construct ( $a_role_folder_id = 0 )

Constructor.

Definition at line 22 of file class.ilRoleXmlImporter.php.

         {
                 $this->role_folder = $a_role_folder_id;
         }

Member Function Documentation

◆ assigntoRoleFolder()

ilRoleXmlImporter::assigntoRoleFolder ( )

protected

Assign role to folder type $rbacadmin.

Returns: type

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

References getRole(), and getRoleFolderId().

         {
                 global $rbacadmin, $rbacreview;
                 
                 if(!$this->getRoleFolderId())
                 {
                         return;
                 }
 
                 if($rbacreview->isRoleAssignedToObject($this->getRole()->getId(),$this->getRoleFolderId()))
                 {
                         return;
                 }
 
                 $rbacadmin->assignRoleToFolder(
                         $this->getRole()->getId(),
                         $this->getRoleFolderId(),
                         $this->getRole() instanceof ilObjRole ? 'y' : 'n'
                 );
         }

Here is the call graph for this function:

◆ getRole()

ilRoleXmlImporter::getRole ( )

Get role.

Returns: ilObjRole

Definition at line 50 of file class.ilRoleXmlImporter.php.

References $role.

Referenced by assigntoRoleFolder(), importSimpleXml(), and initRole().

         {
                 return $this->role;
         }

Here is the caller graph for this function:

◆ getRoleFolderId()

ilRoleXmlImporter::getRoleFolderId ( )

Get role folder id.

Returns: int

Definition at line 41 of file class.ilRoleXmlImporter.php.

References $role_folder.

Referenced by assigntoRoleFolder(), and importSimpleXml().

         {
                 return $this->role_folder;
         }

Here is the caller graph for this function:

◆ getXml()

ilRoleXmlImporter::getXml ( )

Definition at line 32 of file class.ilRoleXmlImporter.php.

References $xml.

Referenced by import().

         {
                 return $this->xml;
         }

Here is the caller graph for this function:

◆ import()

ilRoleXmlImporter::import ( )

import role | role templatae

Exceptions

ilRoleXmlImporterException

Definition at line 68 of file class.ilRoleXmlImporter.php.

References getXml(), importSimpleXml(), and parseXmlErrors().

         {
                 libxml_use_internal_errors(true);
                 
                 $root = simplexml_load_string($this->getXml());
                 
                 if(!$root instanceof SimpleXMLElement)
                 {
                         throw new ilRoleImporterException($this->parseXmlErrors());
                 }
                 foreach($root->role as $roleElement)
                 {
                         $this->importSimpleXml($roleElement);
                         // only one role is parsed
                         break;
                 }
         }

Here is the call graph for this function:

◆ importSimpleXml()

ilRoleXmlImporter::importSimpleXml ( SimpleXMLElement $role )

Import using simplexml.

Parameters

SimpleXMLElement $role

Definition at line 91 of file class.ilRoleXmlImporter.php.

References $GLOBALS, $lng, ilObject\_getIdsForTitle(), ilObject\_lookupType(), array, getRole(), getRoleFolderId(), initRole(), and string.

Referenced by import().

         {
                 global $rbacadmin, $rbacreview, $lng;
 
                 $import_id = (string) $role['id'];
                 $GLOBALS['ilLog']->write(__METHOD__.' Importing role with import id '. $import_id);
 
                 if(!$this->initRole($import_id))
                 {
                         return 0;
                 }
                 
                 $this->getRole()->setTitle(trim((string) $role->title));
                 $this->getRole()->setDescription(trim((string) $role->description));
                 
                 $type =  ilObject::_lookupType($this->getRoleFolderId(), true);
                 $exp = explode("_", $this->getRole()->getTitle());
 
                 if(count($exp) > 0 && $exp[0] === "il")
                 {
                         if(count($exp) > 1 && $exp[1] !== $type)
                         {
                                 throw new ilRoleImporterException(sprintf($lng->txt("rbac_cant_import_role_wrong_type"),
                                         $lng->txt('obj_'.$exp[1]),$lng->txt('obj_'.$type)));
                         }
 
                         $exp[3] = $this->getRoleFolderId();
 
                         $id = ilObjRole::_getIdsForTitle(implode("_", $exp));
 
                         if($id[0])
                         {
                                 $GLOBALS['ilLog']->write(__METHOD__.': Overwrite role '. implode("_", $exp));
                                 $this->getRole()->setId($id[0]);
                                 $this->getRole()->read();
                         }
                 }
 
                 // Create or update
                 if($this->getRole()->getId())
                 {
                         $rbacadmin->deleteRolePermission($this->getRole()->getId(), $this->getRoleFolderId());
                         $this->getRole()->update();
                 }
                 else
                 {
                         $this->getRole()->create();
                 }
 
                 
                 $this->assignToRoleFolder();
 
                 $protected = (string) $role['protected'];
                 if($protected)
                 {
                         $rbacadmin->setProtected(0,$this->getRole()->getId(),'y');
                 }
 
                 // Add operations
                 $ops = $rbacreview->getOperations();
                 $operations = array();
                 foreach($ops as $ope)
                 {
                         $operations[$ope['operation']] = $ope['ops_id'];
                 }
 
                 foreach($role->operations as $sxml_operations)
                 {
                         foreach($sxml_operations as $sxml_op)
                         {
                                 $ops_group = (string) $sxml_op['group'];
                                 $ops_id = (int) $operations[trim((string) $sxml_op)];
                                 $ops = trim((string) $sxml_op);
                                 
                                 if($ops_group and $ops_id)
                                 {
                                         $rbacadmin->setRolePermission(
                                                 $this->getRole()->getId(),
                                                 $ops_group,
                                                 array($ops_id),
                                                 $this->getRoleFolderId() // #10161
                                         );
                                 }
                                 else
                                 {
                                         $GLOBALS['ilLog']->write(__METHOD__.': Cannot create operation for...');
                                         $GLOBALS['ilLog']->write(__METHOD__.': New operation for group '. $ops_group);
                                         $GLOBALS['ilLog']->write(__METHOD__.': New operation '.$ops);
                                         $GLOBALS['ilLog']->write(__METHOD__.': New operation '. $ops_id);
                                 }
 
                         }
                 }
 
                 return $this->getRole()->getId();
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initRole()

ilRoleXmlImporter::initRole ( $import_id )

protected

Definition at line 215 of file class.ilRoleXmlImporter.php.

References ilObject\_lookupObjIdByImportId(), ilObjectFactory\getInstanceByObjId(), and getRole().

Referenced by importSimpleXml().

         {
                 if($this->getRole())
                 {
                         return true;
                 }
                 
                 $obj_id = ilObject::_lookupObjIdByImportId($import_id);
                 include_once './Services/Object/classes/class.ilObjectFactory.php';
                 if($obj_id)
                 {
                         $this->role = ilObjectFactory::getInstanceByObjId($obj_id,false);
                 }
                 if(!$this->getRole() instanceof ilObjRole or !$this->getRole() instanceof ilObjRoleTemplate)
                 {
                         include_once './Services/AccessControl/classes/class.ilObjRoleTemplate.php';
                         $this->role = new ilObjRoleTemplate();
                 }
                 return true;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseXmlErrors()

ilRoleXmlImporter::parseXmlErrors ( )

protected

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

References $errors.

Referenced by import().

         {
                 $errors = '';
                 
                 foreach(libxml_get_errors() as $err)
                 {
                         $errors .= $err->code.'<br/>';
                 }
                 return $errors;
         }

Here is the caller graph for this function:

◆ setRole()

ilRoleXmlImporter::setRole ( ilObject $role )

Set role or role template.

Parameters

ilObject $role

Definition at line 59 of file class.ilRoleXmlImporter.php.

References $role.

         {
                 $this->role = $role;
         }

◆ setXml()

ilRoleXmlImporter::setXml ( $a_xml )

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

         {
                 $this->xml = $a_xml;
         }

Field Documentation

◆ $role

ilRoleXmlImporter::$role = null

protected

Definition at line 15 of file class.ilRoleXmlImporter.php.

Referenced by getRole(), and setRole().

◆ $role_folder

ilRoleXmlImporter::$role_folder = 0

protected

Definition at line 14 of file class.ilRoleXmlImporter.php.

Referenced by getRoleFolderId().

◆ $xml

ilRoleXmlImporter::$xml = ''

protected

Definition at line 17 of file class.ilRoleXmlImporter.php.

Referenced by getXml().

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

Services/AccessControl/classes/class.ilRoleXmlImporter.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ assigntoRoleFolder()

◆ getRole()

◆ getRoleFolderId()

◆ getXml()

◆ import()

◆ importSimpleXml()

◆ initRole()

◆ parseXmlErrors()

◆ setRole()

◆ setXml()

Field Documentation

◆ $role

◆ $role_folder

◆ $xml