ilOrgUnitSimpleUserImport Class Reference

Class ilOrgUnitSimpleUserImport. More...

Inheritance diagram for ilOrgUnitSimpleUserImport:

Collaboration diagram for ilOrgUnitSimpleUserImport:

Public Member Functions
	simpleUserImport ($file_path)
	simpleUserImportElement (SimpleXMLElement $a)
Public Member Functions inherited from ilOrgUnitImporter
	hasMoreThanOneMatch ($external_id)
	hasErrors ()
	hasWarnings ()
	addWarning ($lang_var, $import_id, $action=null)
	addError ($lang_var, $import_id, $action=null)
	getErrors ()
	getWarnings ()
	getStats ()
	importXmlRepresentation ($a_entity, $a_id, $a_xml, $a_mapping)
Public Member Functions inherited from ilXmlImporter
	__construct ()
	Constructor. More...
	setImport ($a_val)
	Set import. More...
	getImport ()
	Get import. More...
	init ()
	Init. More...
	setInstallId ($a_val)
	Set installation id. More...
	getInstallId ()
	Get installation id. More...
	setInstallUrl ($a_val)
	Set installation url. More...
	getInstallUrl ()
	Get installation url. More...
	setSchemaVersion ($a_val)
	Set schema version. More...
	getSchemaVersion ()
	Get schema version. More...
	setImportDirectory ($a_val)
	Set import directory. More...
	getImportDirectory ()
	Get import directory. More...
	setSkipEntities ($a_val)
	Set skip entities. More...
	getSkipEntities ()
	Get skip entities. More...
	exportedFromSameInstallation ()
	Is exporting and importing installation identical? More...
	importXmlRepresentation ($a_entity, $a_id, $a_xml, $a_mapping)
	Import xml representation. More...
	finalProcessing ($a_mapping)
	Final processing. More...
	afterContainerImportProcessing (ilImportMapping $mapping)
	Called after all container objects have been implemented. More...

Private Member Functions
	buildUserId ($id, $type)

Additional Inherited Members
Data Fields inherited from ilOrgUnitImporter
	$errors = []
	$warnings = []
	$stats
Protected Member Functions inherited from ilOrgUnitImporter
	buildRef ($id, $type)
Protected Attributes inherited from ilXmlImporter
	$skip_entities = array()
	$imp

Detailed Description

Class ilOrgUnitSimpleUserImport.

Author

: Oskar Truffer ot@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

: Martin Studer ms@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

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

Member Function Documentation

buildUserId()

ilOrgUnitSimpleUserImport::buildUserId (   $id,   $type  )

private

Parameters

$id
$type

Returns

bool

Definition at line 101 of file class.ilOrgUnitSimpleUserImport.php.

References $DIC, $ilDB, $type, ilObjUser\_lookupId(), and ilObject\_lookupObjIdByImportId().

Referenced by simpleUserImportElement().

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        if ($type == 'ilias_login') {
            $user_id = ilObjUser::_lookupId($id);

            return $user_id ? $user_id : false;
        } elseif ($type == 'external_id') {
            $user_id = ilObjUser::_lookupObjIdByImportId($id);

            return $user_id ? $user_id : false;
        } elseif ($type == 'email') {
            $q = 'SELECT usr_id FROM usr_data WHERE email = ' . $ilDB->quote($id, 'text');
            $set = $ilDB->query($q);
            $user_id = $ilDB->fetchAssoc($set);

            return $user_id ? $user_id : false;
        } elseif ($type == 'user_id') {
            return $id;
        } else {
            return false;
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

simpleUserImport()

ilOrgUnitSimpleUserImport::simpleUserImport

(

$file_path

)

Parameters

$file_path

Definition at line 18 of file class.ilOrgUnitSimpleUserImport.php.

References Vendor\Package\$a, $xml, ilOrgUnitImporter\addError(), and simpleUserImportElement().

    {
        $this->stats = array('created' => 0, 'removed' => 0);
        $a = file_get_contents($file_path, 'r');
        $xml = new SimpleXMLElement($a);

        if (!count($xml->children())) {
            $this->addError('no_assignment', null, null);

            return;
        }

        foreach ($xml->children() as $a) {
            $this->simpleUserImportElement($a);
        }
    }

Here is the call graph for this function:

simpleUserImportElement()

ilOrgUnitSimpleUserImport::simpleUserImportElement

(

SimpleXMLElement

$a

)

Parameters

SimpleXMLElement

$a

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

References $attributes, $DIC, ilOrgUnitImporter\addError(), ilOrgUnitImporter\buildRef(), buildUserId(), ilOrgUnitPosition\CORE_POSITION_EMPLOYEE, ilOrgUnitPosition\CORE_POSITION_SUPERIOR, ilOrgUnitUserAssignment\findOrCreateAssignment(), and ActiveRecord\where().

Referenced by simpleUserImport().

    {
        global $DIC;
        $rbacadmin = $DIC['rbacadmin'];

        $attributes = $a->attributes();
        $action = $attributes->action;
        $user_id_type = $a->User->attributes()->id_type;
        $user_id = (string) $a->User;
        $org_unit_id_type = $a->OrgUnit->attributes()->id_type;
        $org_unit_id = (string) $a->OrgUnit;
        $role = (string) $a->Role;

        if (!$user_id = $this->buildUserId($user_id, $user_id_type)) {
            $this->addError('user_not_found', $a->User);

            return;
        }

        if (!$org_unit_id = $this->buildRef($org_unit_id, $org_unit_id_type)) {
            $this->addError('org_unit_not_found', $a->OrgUnit);

            return;
        }
        $org_unit = new ilObjOrgUnit($org_unit_id);

        if ($role === 'employee') {
            $position_id = ilOrgUnitPosition::CORE_POSITION_EMPLOYEE;
        } elseif ($role === 'superior') {
            $position_id =  ilOrgUnitPosition::CORE_POSITION_SUPERIOR;
        } else {
            //if passed a custom position.
            $position = ilOrgUnitPosition::where(['title' => $role])->first();
            if ($position instanceof ilOrgUnitPosition) {
                $position_id = $position->getId();
            } else {
                $this->addError('not_a_valid_role', $user_id);
                return;
            }
        }

        if ($action == 'add') {
            $assignment = ilOrgUnitUserAssignment::findOrCreateAssignment($user_id, $position_id, $org_unit_id);
            $assignment->store();

            $this->stats['created']++;
        } elseif ($action == 'remove') {
            $assignment = ilOrgUnitUserAssignment::findOrCreateAssignment($user_id, $position_id, $org_unit_id);
            $assignment->delete();
            $this->stats['removed']++;
        } else {
            $this->addError('not_a_valid_action', $user_id);
        }
    }

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/OrgUnit/classes/SimpleUserImport/class.ilOrgUnitSimpleUserImport.php