Public Member Functions | Data Fields

ilUserImportParser Class Reference

Inheritance diagram for ilUserImportParser:
Collaboration diagram for ilUserImportParser:

Public Member Functions

 ilUserImportParser ($a_xml_file, $a_mode=IL_USER_IMPORT, $a_conflict_rule=IL_FAIL_ON_CONFLICT)
 Constructor.
 setFolderId ($a_folder_id)
 assign users to this folder (normally the usr_folder) But if called from local admin => the ref_id of the category public
 getFolderId ()
 setHandlers ($a_xml_parser)
 set event handler should be overwritten by inherited class private
 startParsing ()
 start the parser
 setRoleAssignment ($a_assign)
 set import to local role assignemt
 buildTag ($type, $name, $attr="")
 generate a tag with given name and attributes
 handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element
 extractRolesBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element in extract roles mode
 importBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element in user import mode
 verifyBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element
 handlerEndTag ($a_xml_parser, $a_name)
 handler for end of element
 extractRolesEndTag ($a_xml_parser, $a_name)
 handler for end of element when in extract roles mode.
 getRoleObject ($a_role_id)
 Returns the parent object of the role folder object which contains the specified role.
 getCourseMembersObjectForRole ($a_role_id)
 Returns the parent object of the role folder object which contains the specified role.
 assignToRole ($a_user_obj, $a_role_id)
 Assigns a user to a role.
 detachFromRole ($a_user_obj, $a_role_id)
 Detachs a user from a role.
 importEndTag ($a_xml_parser, $a_name)
 handler for end of element when in import user mode.
 saveTempImage ($image_data, $filename)
 Saves binary image data to a temporary image file and returns the name of the image file on success.
 verifyEndTag ($a_xml_parser, $a_name)
 handler for end of element when in verify mode.
 handlerCharacterData ($a_xml_parser, $a_data)
 handler for character data
 getCollectedRoles ()
 get collected roles
 getUserCount ()
 get count of User elements
 logWarning ($aLogin, $aMessage)
 Writes a warning log message to the protocol.
 logFailure ($aLogin, $aMessage)
 Writes a failure log message to the protocol.
 logSuccess ($aLogin, $userid, $action)
 Writes a success log message to the protocol.
 getProtocol ()
 Returns the protocol.
 getProtocolAsHTML ($a_log_title)
 Returns the protocol as a HTML table.
 isSuccess ()
 Returns true, if the import was successful.
 getErrorLevel ()
 Returns the error level.
 getUserMapping ()
 returns a map user_id <=> login
 sendAccountMail ()
 send account mail
 setSendMail ($value)
 write access to property send mail
 isSendMail ()
 read access to property send mail
 setUserMappingMode ($value)
 write access to user mapping mode
 getUserMappingMode ()
 read access to user mapping mode

Data Fields

 $time_limit_set = false
 $time_limit_owner_set = false
 $updateLookAndSkin = false
 boolean to determine if look and skin should be updated
 $folder_id
 $roles
 $action
 The Action attribute determines what to do for the current User element.
 $protocol
 The variable holds the protocol of the import.
 $logins
 This variable is used to collect each login that we encounter in the import data.
 $conflict_rule
 Conflict handling rule.
 $send_mail
 $error_level
 This variable is used to report the error level of the validation process or the importing process.
 $currPasswordType
 The password type of the current user.
 $currPassword
 The password of the current user.
 $currActive
 The active state of the current user.
 $userCount
 The count of user elements in the XML file.
 $user_mapping
 $mapping_mode
 $localRoleCache
 Cached local roles.
 $personalPicture
 Cached personal picture of the actual user This is used because the ilObjUser object has no field for the personal picture.
 $ilincdata
 Cached iLinc data.
 $skin
 ILIAS skin.
 $style
 ILIAS style.
 $userStyles
 User assigned styles.
 $hideSkin
 Indicates if the skins are hidden.
 $disableSkin
 Indicates if the skins are enabled.
 $user_id

Detailed Description

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


Member Function Documentation

ilUserImportParser::assignToRole ( a_user_obj,
a_role_id 
)

Assigns a user to a role.

Definition at line 700 of file class.ilUserImportParser.php.

References $rbacadmin, $rbacreview, $tree, getCourseMembersObjectForRole(), and getRoleObject().

Referenced by importEndTag().

        {
                require_once "classes/class.ilObjRole.php";
                require_once "course/classes/class.ilObjCourse.php";
                require_once "course/classes/class.ilCourseMembers.php";

                global $rbacreview, $rbacadmin, $tree;

                // If it is a course role, use the ilCourseMember object to assign
                // the user to the role
                $role_obj = $this->getRoleObject($a_role_id);
                if (substr($role_obj->getTitle(),0,6) == 'il_crs')
                {
                        $crsmembers_obj = $this->getCourseMembersObjectForRole($a_role_id);

                        switch (substr($role_obj->getTitle(),0,12))
                        {
                                case 'il_crs_admin' :
                                        $crs_role = $crsmembers_obj->ROLE_ADMIN;
                                        $crs_status = $crsmembers_obj->STATUS_NO_NOTIFY;
                                        break;
                                case 'il_crs_tutor' :
                                        $crs_role = $crsmembers_obj->ROLE_TUTOR;
                                        $crs_status = $crsmembers_obj->STATUS_NO_NOTIFY;
                                        break;
                                case 'il_crs_membe' :
                                default :
                                        $crs_role = $crsmembers_obj->ROLE_MEMBER;
                                        $crs_status = $crsmembers_obj->STATUS_UNBLOCKED;
                                        break;
                        }

                        if ($crsmembers_obj->isAssigned($a_user_obj->getID()))
                        {
                                $crsmembers_obj->update($a_user_obj->getID(), $crs_role, $crs_status, false);
                        }
                        else
                        {
                                $crsmembers_obj->add($a_user_obj, $crs_role);
                        }
                }
                // If it is not a course role, use RBAC to assign the user to the role
                else
                {
                        $rbacadmin->assignUser($a_role_id, $a_user_obj->getId(), true);
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::buildTag ( type,
name,
attr = "" 
)

generate a tag with given name and attributes

Parameters:
string "start" | "end" for starting or ending tag
string element/tag name
array array of attributes

Definition at line 352 of file class.ilUserImportParser.php.

References $type.

        {
                $tag = "<";

                if ($type == "end")
                        $tag.= "/";

                $tag.= $name;

                if (is_array($attr))
                {
                        while (list($k,$v) = each($attr))
                                $tag.= " ".$k."=\"$v\"";
                }

                $tag.= ">";

                return $tag;
        }

ilUserImportParser::detachFromRole ( a_user_obj,
a_role_id 
)

Detachs a user from a role.

Definition at line 750 of file class.ilUserImportParser.php.

References $rbacadmin, $rbacreview, $role_id, $tree, getCourseMembersObjectForRole(), and getRoleObject().

Referenced by importEndTag().

        {
                require_once "classes/class.ilObjRole.php";
                require_once "course/classes/class.ilObjCourse.php";
                require_once "course/classes/class.ilCourseMembers.php";

                global $rbacreview, $rbacadmin, $tree;

                // If it is a course role, use the ilCourseMember object to assign
                // the user to the role
                $role_obj = $this->getRoleObject($a_role_id);
                //print_r($role_obj->getTitle());
                if (substr($role_obj->getTitle(),0,6) == 'il_crs_')
                {
                        $crsmembers_obj = $this->getCourseMembersObjectForRole($role_id);
                        //print_r($crsmembers_obj ->getTitle());
                        switch (substr($role_obj->getTitle(),0,12))
                        {
                                case 'il_crs_membe' :
                                        if ($crsmembers_obj->isMember($a_user_obj->getId()))
                                        {
                                                $crsmembers_obj->delete($a_user_obj->getId());
                                        }
                                        break;
                                case 'il_crs_admin' :
                                        if ($crsmembers_obj->isAdmin($a_user_obj->getId()))
                                        {
                                                $crsmembers_obj->delete($a_user_obj->getId());
                                        }
                                        break;
                                case 'il_crs_tutor' :
                                        if ($crsmembers_obj->isTutor($a_user_obj->getId()))
                                        {
                                                $crsmembers_obj->delete($a_user_obj->getId());
                                        }
                                        break;
                        }
                }
                // If it is not a course role, use RBAC to assign the user to the role
                else
                {
                        $rbacadmin->deassignUser($a_role_id, $a_user_obj->getId());
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::extractRolesBeginTag ( a_xml_parser,
a_name,
a_attribs 
)

handler for begin of element in extract roles mode

Definition at line 396 of file class.ilUserImportParser.php.

References ilUtil::__extractId().

Referenced by handlerBeginTag().

        {
                switch($a_name)
                {
                        case "Role":
                                // detect numeric, ilias id (then extract role id) or alphanumeric
                                $this->current_role_id = $a_attribs["Id"]; 
                                if ($internal_id = ilUtil::__extractId($this->current_role_id, IL_INST_ID)) 
                                {
                                         $this->current_role_id = $internal_id;
                                }
                                $this->current_role_type = $a_attribs["Type"];                                                  

                                break;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::extractRolesEndTag ( a_xml_parser,
a_name 
)

handler for end of element when in extract roles mode.

Definition at line 644 of file class.ilUserImportParser.php.

Referenced by handlerEndTag().

        {
                switch($a_name)
                {
                        case "Role":
                                $this->roles[$this->current_role_id]["name"] = $this->cdata;
                                $this->roles[$this->current_role_id]["type"] =
                                        $this->current_role_type;
                                break;
                }
        }

Here is the caller graph for this function:

ilUserImportParser::getCollectedRoles (  ) 

get collected roles

Definition at line 1739 of file class.ilUserImportParser.php.

        {
                return $this->roles;
        }

ilUserImportParser::getCourseMembersObjectForRole ( a_role_id  ) 

Returns the parent object of the role folder object which contains the specified role.

Definition at line 677 of file class.ilUserImportParser.php.

References $rbacadmin, $rbacreview, and $tree.

Referenced by assignToRole(), and detachFromRole().

        {
                global $rbacreview, $rbacadmin, $tree;

                if (array_key_exists($a_role_id.'_courseMembersObject', $this->localRoleCache))
                {
                        return $this->localRoleCache[$a_role_id.'_courseMembersObject'];
                }
                else
                {
                        $rolf_refs = $rbacreview->getFoldersAssignedToRole($a_role_id, true);
                        $course_ref = $tree->getParentId($rolf_refs[0]);
                        $course_obj = new ilObjCourse($course_ref, true);
                        $crsmembers_obj = new ilCourseMembers($course_obj);
                        $this->localRoleCache[$a_role_id.'_courseMembersObject'] = $crsmembers_obj;
                        return $crsmembers_obj;
                }

        }

Here is the caller graph for this function:

ilUserImportParser::getErrorLevel (  ) 

Returns the error level.

Returns:
IL_IMPORT_SUCCESS | IL_IMPORT_WARNING | IL_IMPORT_FAILURE

Definition at line 1861 of file class.ilUserImportParser.php.

        {
                return $this->error_level;
        }

ilUserImportParser::getFolderId (  ) 

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

Referenced by importEndTag().

        {
                return $this->folder_id;
        }

Here is the caller graph for this function:

ilUserImportParser::getProtocol (  ) 

Returns the protocol.

The protocol is an associative array. Keys are login names. Values are non-associative arrays. Each array element contains an error message.

Definition at line 1812 of file class.ilUserImportParser.php.

Referenced by getProtocolAsHTML().

        {
                return $this->protocol;
        }

Here is the caller graph for this function:

ilUserImportParser::getProtocolAsHTML ( a_log_title  ) 

Returns the protocol as a HTML table.

Definition at line 1819 of file class.ilUserImportParser.php.

References ilSaxParser::$lng, and getProtocol().

        {
                global $lng;

                $block = new ilTemplate("tpl.usr_import_log_block.html", true, true);
                $block->setVariable("TXT_LOG_TITLE", $a_log_title);
                $block->setVariable("TXT_MESSAGE_ID", $lng->txt("login"));
                $block->setVariable("TXT_MESSAGE_TEXT", $lng->txt("message"));
                foreach ($this->getProtocol() as $login => $messages)
                {
                        $block->setCurrentBlock("log_row");
                        $reason = "";
                        foreach ($messages as $message)
                        {
                                if ($reason == "")
                                {
                                        $reason = $message;
                                }
                                else
                                {
                                        $reason = $reason."<br>".$message;
                                }
                        }
                        $block->setVariable("MESSAGE_ID", $login);
                        $block->setVariable("MESSAGE_TEXT", $reason);
                        $block->parseCurrentBlock();
                }
                return $block->get();
        }

Here is the call graph for this function:

ilUserImportParser::getRoleObject ( a_role_id  ) 

Returns the parent object of the role folder object which contains the specified role.

Definition at line 659 of file class.ilUserImportParser.php.

Referenced by assignToRole(), and detachFromRole().

        {
                if (array_key_exists($a_role_id, $this->localRoleCache))
                {
                        return $this->localRoleCache[$a_role_id];
                }
                else
                {
                        $role_obj = new ilObjRole($a_role_id, false);
                        $role_obj->read();
                        $this->localRoleCache[$a_role_id] = $role_obj;
                        return $role_obj;
                }

        }

Here is the caller graph for this function:

ilUserImportParser::getUserCount (  ) 

get count of User elements

Definition at line 1746 of file class.ilUserImportParser.php.

        {
                return $this->userCount;
        }

ilUserImportParser::getUserMapping (  ) 

returns a map user_id <=> login

Returns:
assoc array, with user_id as key and login as value

Definition at line 1871 of file class.ilUserImportParser.php.

                                  {
            return $this->user_mapping;
        }

ilUserImportParser::getUserMappingMode (  ) 

read access to user mapping mode

Returns:
int one of IL_USER_MAPPING_ID or IL_USER_MAPPING_LOGIN

Definition at line 1925 of file class.ilUserImportParser.php.

Referenced by importBeginTag(), and verifyBeginTag().

        {
            return $this->mapping_mode;
        }

Here is the caller graph for this function:

ilUserImportParser::handlerBeginTag ( a_xml_parser,
a_name,
a_attribs 
)

handler for begin of element

Definition at line 375 of file class.ilUserImportParser.php.

References extractRolesBeginTag(), importBeginTag(), and verifyBeginTag().

        {
                switch ($this->mode)
                {
                        case IL_EXTRACT_ROLES :
                                $this->extractRolesBeginTag($a_xml_parser, $a_name, $a_attribs);
                                break;
                        case IL_USER_IMPORT :
                                $this->importBeginTag($a_xml_parser, $a_name, $a_attribs);
                                break;
                        case IL_VERIFY :
                                $this->verifyBeginTag($a_xml_parser, $a_name, $a_attribs);
                                break;
                }

                $this->cdata = "";
        }

Here is the call graph for this function:

ilUserImportParser::handlerCharacterData ( a_xml_parser,
a_data 
)

handler for character data

Definition at line 1723 of file class.ilUserImportParser.php.

        {
                // DELETE WHITESPACES AND NEWLINES OF CHARACTER DATA
                // TODO: Mit Alex klären, ob das noch benötigt wird $a_data = preg_replace("/\n/","",$a_data);
                // TODO: Mit Alex klären, ob das noch benötigt wird $a_data = preg_replace("/\t+/","",$a_data);
                if($a_data != "\n") $a_data = preg_replace("/\t+/"," ",$a_data);

                if(strlen($a_data) > 0)
                {
                        $this->cdata .= $a_data;
                }
        }

ilUserImportParser::handlerEndTag ( a_xml_parser,
a_name 
)

handler for end of element

Definition at line 625 of file class.ilUserImportParser.php.

References extractRolesEndTag(), importEndTag(), and verifyEndTag().

        {
                switch ($this->mode)
                {
                        case IL_EXTRACT_ROLES :
                                $this->extractRolesEndTag($a_xml_parser, $a_name);
                                break;
                        case IL_USER_IMPORT :
                                $this->importEndTag($a_xml_parser, $a_name);
                                break;
                        case IL_VERIFY :
                                $this->verifyEndTag($a_xml_parser, $a_name);
                                break;
                }
        }

Here is the call graph for this function:

ilUserImportParser::ilUserImportParser ( a_xml_file,
a_mode = IL_USER_IMPORT,
a_conflict_rule = IL_FAIL_ON_CONFLICT 
)

Constructor.

Parameters:
string $a_xml_file xml file
int $a_mode IL_EXTRACT_ROLES | IL_USER_IMPORT | IL_VERIFY
int $a_conflict_rue IL_FAIL_ON_CONFLICT | IL_UPDATE_ON_CONFLICT | IL_IGNORE_ON_CONFLICT

public

Definition at line 259 of file class.ilUserImportParser.php.

References ilSaxParser::$ilias, ilSaxParser::$lng, $tree, ilObjUser::_getAllUserAssignedStyles(), and ilSaxParser::ilSaxParser().

        {
                global $lng, $tree, $ilias;

                $this->roles = array();
                $this->mode = $a_mode;
                $this->conflict_rule = $a_conflict_rule;
                $this->error_level = IL_IMPORT_SUCCESS;
                $this->protocol = array();
                $this->logins = array();
                $this->userCount = 0;
                $this->localRoleCache = array();
                $this->ilincdata = array();
                $this->send_mail = false;
                $this->mapping_mode = IL_USER_MAPPING_LOGIN;
                include_once "./classes/class.ilObjUser.php"; 
                $this->userStyles = ilObjUser::_getAllUserAssignedStyles();
                $settings = $ilias->getAllSettings();
                if ($settings["usr_settings_hide_skin_style"] == 1)
                {
                        $this->hideSkin = TRUE;
                }
                else
                {
                        $this->hideSkin = FALSE;
                }
                if ($settings["usr_settings_disable_skin_style"] == 1)
                {
                        $this->disableSkin = TRUE;
                }
                else
                {
                        $this->disableSkin = FALSE;
                }

                include_once("classes/class.ilAccountMail.php");
                $this->acc_mail = new ilAccountMail();

                parent::ilSaxParser($a_xml_file);
        }

Here is the call graph for this function:

ilUserImportParser::importBeginTag ( a_xml_parser,
a_name,
a_attribs 
)

handler for begin of element in user import mode

Definition at line 415 of file class.ilUserImportParser.php.

References $id, ilSaxParser::$ilias, ilSaxParser::$lng, ilUtil::__extractId(), getUserMappingMode(), and logFailure().

Referenced by handlerBeginTag().

        {
                global $ilias;
                switch($a_name)
                {
                        case "Role":
                                $this->current_role_id = $a_attribs["Id"];
                                if ($internal_id = ilUtil::__extractId($this->current_role_id, IL_INST_ID)) 
                                {
                                         $this->current_role_id = $internal_id;
                                }                       
                                $this->current_role_type = $a_attribs["Type"];
                                $this->current_role_action = (is_null($a_attribs["Action"])) ? "Assign" : $a_attribs["Action"];
                                break;

                        case "PersonalPicture":
                                $this->personalPicture = array(
                                        "encoding" => $a_attribs["encoding"],
                                        "imagetype" => $a_attribs["imagetype"],
                                        "content" => ""
                                );
                                break;

                        case "Look":
                                $this->skin = $a_attribs["Skin"];
                                $this->style = $a_attribs["Style"];
                                break;

                        case "User":
                                $this->time_limit_set = false;
                                $this->time_limit_owner_set = false;    
                                $this->updateLookAndSkin = false;
                                $this->skin = "";
                                $this->style = "";
                                $this->personalPicture = null;
                                $this->userCount++;
                                $this->userObj = new ilObjUser();

                                // user defined fields
                                $this->udf_data = array();

                                // if we have an object id, store it
                                $this->user_id = -1;
                                if (!is_null($a_attribs["Id"]) && $this->getUserMappingMode() == IL_USER_MAPPING_ID)
                                {
                                    if (is_numeric($a_attribs["Id"]))
                                    {
                                        $this->user_id = $a_attribs["Id"];
                                    }
                                    elseif ($id = ilUtil::__extractId ($a_attribs["Id"], IL_INST_ID))
                                    {
                                        $this->user_id = $id;
                                    }
                                }

                                $this->userObj->setPref("skin",
                                        $ilias->ini->readVariable("layout","skin"));
                                $this->userObj->setPref("style",
                                        $ilias->ini->readVariable("layout","style"));
                                
                                $this->userObj->setLanguage($a_attribs["Language"]);
                                $this->userObj->setImportId($a_attribs["Id"]);
                                $this->action = (is_null($a_attribs["Action"])) ? "Insert" : $a_attribs["Action"];
                                $this->currPassword = null;
                                $this->currPasswordType = null;
                                $this->currActive = null;
                                break;

                        case "Password":
                                $this->currPasswordType = $a_attribs["Type"];
                                break;
                        case "AuthMode":
                                if (array_key_exists("type", $a_attribs))
                                {
                                        switch ($a_attribs["type"])
                                        {
                                                case "default":
                                                case "local":
                                                case "ldap":
                                                case "radius":
                                                case "shibboleth":
                                                case "script":
                                                case "cas":
                                                case "soap":
                                                        $this->userObj->setAuthMode($a_attribs["type"]);
                                                        break;
                                                default:
                                                        $this->logFailure($this->userObj->getLogin(),
                                                                                          sprintf($lng->txt("usrimport_xml_element_inapplicable"),"AuthMode",$a_attribs["type"]));
                                                        break;
                                        }
                                }
                                else
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_element_inapplicable"),"AuthMode",$a_attribs["type"]));
                                }
                                break;

                        case 'UserDefinedField':
                                $this->tmp_udf_id = $a_attribs['Id'];
                                $this->tmp_udf_name = $a_attribs['Name'];
                                break;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::importEndTag ( a_xml_parser,
a_name 
)

handler for end of element when in import user mode.

Definition at line 798 of file class.ilUserImportParser.php.

References ilSaxParser::$ilias, $ilincdata, ilSaxParser::$lng, $rbacadmin, $rbacreview, $role_id, $user_id, ilObjUser::_checkExternalAuthAccount(), ilAuthUtils::_getAuthModeName(), ilUserDefinedFields::_getInstance(), ilObjUser::_uploadPersonalPicture(), assignToRole(), detachFromRole(), getFolderId(), ilObjUser::getUserIdByLogin(), logFailure(), logSuccess(), logWarning(), saveTempImage(), and sendAccountMail().

Referenced by handlerEndTag().

        {
                global $ilias, $rbacadmin, $rbacreview, $ilUser, $lng, $ilSetting;

                switch($a_name)
                {
                        case "Role":
                                $this->roles[$this->current_role_id]["name"] = $this->cdata;
                                $this->roles[$this->current_role_id]["type"] = $this->current_role_type;
                                $this->roles[$this->current_role_id]["action"] = $this->current_role_action;
                                break;

                        case "PersonalPicture":
                                switch ($this->personalPicture["encoding"])
                                {
                                        case "Base64":
                                                $this->personalPicture["content"] = base64_decode($this->cdata);
                                                break;
                                        case "UUEncode":
                                                // this only works with PHP >= 5
                                                if (version_compare(PHP_VERSION,'5','>='))
                                                {
                                                        $this->personalPicture["content"] = convert_uudecode($this->cdata);
                                                }
                                                break;
                                }
                                break;

                        case "User":
                                // Fetch the user_id from the database, if we didn't have it in xml file
                                // fetch as well, if we are trying to insert -> recognize duplicates!
                                if ($this->user_id == -1 || $this->action=="Insert")
                                        $user_id = ilObjUser::getUserIdByLogin($this->userObj->getLogin());
                                else
                                        $user_id = $this->user_id;

                //echo $user_id.":".$this->userObj->getLogin();

                                // Handle conflicts
                                switch ($this->conflict_rule)
                                {
                                        case IL_FAIL_ON_CONFLICT :
                                                // do not change action
                                                break;
                                        case IL_UPDATE_ON_CONFLICT :
                                                switch ($this->action)
                                                {
                                                        case "Insert" :
                                                                if ($user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_replaced"),"Insert","Update"));
                                                                        $this->action = "Update";
                                                                }
                                                                break;
                                                        case "Update" :
                                                                if (! $user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_replaced"),"Update","Insert"));
                                                                        $this->action = "Insert";
                                                                }
                                                                break;
                                                        case "Delete" :
                                                                if (! $user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_ignored"),"Delete"));
                                                                        $this->action = "Ignore";
                                                                }
                                                                break;
                                                }
                                                break;
                                        case IL_IGNORE_ON_CONFLICT :
                                                switch ($this->action)
                                                {
                                                        case "Insert" :
                                                                if ($user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_ignored"),"Insert"));
                                                                        $this->action = "Ignore";
                                                                }
                                                                break;
                                                        case "Update" :
                                                                if (! $user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_ignored"),"Update"));
                                                                        $this->action = "Ignore";
                                                                }
                                                                break;
                                                        case "Delete" :
                                                                if (! $user_id)
                                                                {
                                                                        $this->logWarning($this->userObj->getLogin(),sprintf($lng->txt("usrimport_action_ignored"),"Delete"));
                                                                        $this->action = "Ignore";
                                                                }
                                                                break;
                                                }
                                                break;
                                }
                                
                                // check external account conflict (if external account is already used)
                                // note: we cannot apply conflict rules in the same manner as to logins here
                                // so we ignore records with already existing external accounts.
                                $am = ($this->userObj->getAuthMode() == "default" || $this->userObj->getAuthMode() == "")
                                        ? ilAuthUtils::_getAuthModeName($ilSetting->get('auth_mode'))
                                        : $this->userObj->getAuthMode();
                                $elogin = ($this->userObj->getExternalAccount() == "")
                                        ? ""
                                        : ilObjUser::_checkExternalAuthAccount($am, $this->userObj->getExternalAccount());
                                switch ($this->action)
                                {
                                        case "Insert" :
                                                if ($elogin != "")
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),
                                                                $lng->txt("usrimport_no_insert_ext_account_exists")." (".$this->userObj->getExternalAccount().")");
                                                        $this->action = "Ignore";
                                                }
                                                break;
                                                
                                        case "Update" :
                                                if ($elogin != "" && $elogin != $ilObjUser->getLogin())
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),
                                                                $lng->txt("usrimport_no_update_ext_account_exists")." (".$this->userObj->getExternalAccount().")");
                                                        $this->action = "Ignore";
                                                }
                                                break;
                                }

                                // Perform the action
                                switch ($this->action)
                                {
                                        case "Insert" :
                                                if ($user_id)
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),$lng->txt("usrimport_cant_insert"));
                                                }
                                                else
                                                {

                                                    if (!strlen($this->currPassword)==0)
                                                      switch ($this->currPasswordType)
                                                          {
                                                                case "ILIAS2":
                                                                        $this->userObj->setPasswd($this->currPassword, IL_PASSWD_CRYPT);
                                                                        break;

                                                                case "ILIAS3":
                                                                        $this->userObj->setPasswd($this->currPassword, IL_PASSWD_MD5);
                                                                        break;

                                                                case "PLAIN":
                                                                        $this->userObj->setPasswd($this->currPassword, IL_PASSWD_PLAIN);
                                                                        $this->acc_mail->setUserPassword($this->currPassword);
                                                                        break;

                                                          }
                                                        else
                                                        {
                                                            // this does the trick for empty passwords
                                                            // since a MD5 string has always 32 characters,
                                                            // no hashed password combination will ever equal to
                                                            // an empty string
                                                            $this->userObj->setPasswd("", IL_PASSWD_MD5);

                                                        }

                                                        $this->userObj->setTitle($this->userObj->getFullname());
                                                        $this->userObj->setDescription($this->userObj->getEmail());
                                                        
                                                        if(!$this->time_limit_owner_set)
                                                        {
                                                                $this->userObj->setTimeLimitOwner($this->getFolderId());
                                                        }

                                                        // default time limit settings
                                                        if(!$this->time_limit_set)
                                                        {
                                                                $this->userObj->setTimeLimitUnlimited(1);
                                                                $this->userObj->setTimeLimitMessage(0);
                                                                $this->userObj->setApproveDate(date("Y-m-d H:i:s"));
                                                        }


                                                        $this->userObj->setActive($this->currActive == 'true' || is_null($this->currActive), $ilUser->getId());

                                                        $this->userObj->create();

                                                        //insert user data in table user_data
                                                        $this->userObj->saveAsNew(false);

                                                        // save user preferences (skin and style)
                                                        $this->userObj->writePrefs();

                                                        if (is_array($this->personalPicture))
                                                        {
                                                                if (strlen($this->personalPicture["content"]))
                                                                {
                                                                        $extension = "jpg";
                                                                        if (preg_match("/.*(png|jpg|gif|jpeg)$/", $this->personalPicture["imagetype"], $matches))
                                                                        {
                                                                                $extension = $matches[1];
                                                                        }
                                                                        $tmp_name = $this->saveTempImage($this->personalPicture["content"], ".$extension");
                                                                        if (strlen($tmp_name))
                                                                        {
                                                                                ilObjUser::_uploadPersonalPicture($tmp_name, $this->userObj->getId());
                                                                                unlink($tmp_name);
                                                                        }
                                                                }
                                                        }

                                                        if ($this->ilincdata["id"]) {
                                                            include_once './ilinc/classes.ilObjiLincUser.php';
                                $ilinc_user = new ilObjiLincUser($this->userObj);
                                $ilinc_user->setVar("id", $this->ilincdata["id"]);
                                $ilinc_user->setVar("login", $this->ilincdata["login"]);
                                $ilinc_user->setVar("passwd", $this->ilincdata["password"]);
                                $ilinc_user->update();
                                                        }
        
                                                        //set role entries
                                                        foreach($this->roles as $role_id => $role)
                                                        {
                                                                if ($this->role_assign[$role_id])
                                                                {
                                                                        $this->assignToRole($this->userObj, $this->role_assign[$role_id]);
                                                                }
                                                        }

                                                        if(count($this->udf_data))
                                                        {
                                                                include_once 'classes/class.ilUserDefinedData.php';
                                                                $udd = new ilUserDefinedData($this->userObj->getId());
                                                                foreach($this->udf_data as $field => $value)
                                                                {
                                                                        $udd->set($field,$value);
                                                                }
                                                                $udd->update();
                                                        }

                                                        $this->sendAccountMail();
                                                        $this->logSuccess($this->userObj->getLogin(),$this->userObj->getId(), "Insert");
                                                        // reset account mail object
                                                        $this->acc_mail->reset();
                                                }
                                                break;

                                        case "Update" :
                                                if (! $user_id)
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),$lng->txt("usrimport_cant_update"));
                                                }
                                                else
                                                {
                                                        $updateUser = new ilObjUser($user_id);
                                                        $updateUser->read();
                                                        $updateUser->readPrefs();
                                                        if ($this->currPassword != null)
                                                        {
                                                                switch ($this->currPasswordType)
                                                                {
                                                                        case "ILIAS2":
                                                                                $updateUser->setPasswd($this->currPassword, IL_PASSWD_CRYPT);
                                                                                break;

                                                                        case "ILIAS3":
                                                                                $updateUser->setPasswd($this->currPassword, IL_PASSWD_MD5);
                                                                                break;

                                                                        case "PLAIN":
                                                                                $updateUser->setPasswd($this->currPassword, IL_PASSWD_PLAIN);
                                                                                $this->acc_mail->setUserPassword($this->currPassword);
                                                                                break;
                                                                }
                                                        }
                                                        if (! is_null($this->userObj->getFirstname())) $updateUser->setFirstname($this->userObj->getFirstname());
                                                        if (! is_null($this->userObj->getLastname())) $updateUser->setLastname($this->userObj->getLastname());
                                                        if (! is_null($this->userObj->getUTitle())) $updateUser->setUTitle($this->userObj->getUTitle());
                                                        if (! is_null($this->userObj->getGender())) $updateUser->setGender($this->userObj->getGender());
                                                        if (! is_null($this->userObj->getEmail())) $updateUser->setEmail($this->userObj->getEmail());
                                                        if (! is_null($this->userObj->getInstitution())) $updateUser->setInstitution($this->userObj->getInstitution());
                                                        if (! is_null($this->userObj->getStreet())) $updateUser->setStreet($this->userObj->getStreet());
                                                        if (! is_null($this->userObj->getCity())) $updateUser->setCity($this->userObj->getCity());
                                                        if (! is_null($this->userObj->getZipCode())) $updateUser->setZipCode($this->userObj->getZipCode());
                                                        if (! is_null($this->userObj->getCountry())) $updateUser->setCountry($this->userObj->getCountry());
                                                        if (! is_null($this->userObj->getPhoneOffice())) $updateUser->setPhoneOffice($this->userObj->getPhoneOffice());
                                                        if (! is_null($this->userObj->getPhoneHome())) $updateUser->setPhoneHome($this->userObj->getPhoneHome());
                                                        if (! is_null($this->userObj->getPhoneMobile())) $updateUser->setPhoneMobile($this->userObj->getPhoneMobile());
                                                        if (! is_null($this->userObj->getFax())) $updateUser->setFax($this->userObj->getFax());
                                                        if (! is_null($this->userObj->getHobby())) $updateUser->setHobby($this->userObj->getHobby());
                                                        if (! is_null($this->userObj->getComment())) $updateUser->setComment($this->userObj->getComment());
                                                        if (! is_null($this->userObj->getDepartment())) $updateUser->setDepartment($this->userObj->getDepartment());
                                                        if (! is_null($this->userObj->getMatriculation())) $updateUser->setMatriculation($this->userObj->getMatriculation());
                                                        if (! is_null($this->currActive)) $updateUser->setActive($this->currActive == "true", $ilUser->getId());
                                                        if (! is_null($this->userObj->getClientIP())) $updateUser->setClientIP($this->userObj->getClientIP());
                                                        if (! is_null($this->userObj->getTimeLimitUnlimited())) $updateUser->setTimeLimitUnlimited($this->userObj->getTimeLimitUnlimited());
                                                        if (! is_null($this->userObj->getTimeLimitFrom())) $updateUser->setTimeLimitFrom($this->userObj->getTimeLimitFrom());
                                                        if (! is_null($this->userObj->getTimeLimitUntil())) $updateUser->setTimeLimitUntil($this->userObj->getTimeLimitUntil());
                                                        if (! is_null($this->userObj->getTimeLimitMessage())) $updateUser->setTimeLimitMessage($this->userObj->getTimeLimitMessage());
                                                        if (! is_null($this->userObj->getApproveDate())) $updateUser->setApproveDate($this->userObj->getApproveDate());
                                                        if (! is_null($this->userObj->getLanguage())) $updateUser->setLanguage($this->userObj->getLanguage());
                                                        if (! is_null($this->userObj->getExternalAccount())) $updateUser->setExternalAccount($this->userObj->getExternalAccount());
                                                        if (! is_null($this->userObj->getAuthMode())) $updateUser->setAuthMode($this->userObj->getAuthMode());

                                                        // Special handlin since it defaults to 7 (USER_FOLDER_ID)
                                                        if($this->time_limit_owner_set)
                                                        {
                                                                $updateUser->setTimeLimitOwner($this->userObj->getTimeLimitOwner());
                                                        }                                                       

                                                        // save user preferences (skin and style)
                                                        if ($this->updateLookAndSkin)
                                                        {
                                                                $updateUser->setPref("skin", $this->userObj->getPref("skin"));
                                                                $updateUser->setPref("style", $this->userObj->getPref("style"));
                                                        }
                                                        $updateUser->writePrefs();
                                                        
                                                        $updateUser->update();

                                                        if ($this->ilincdata["id"]) {
                                                            include_once './ilinc/classes.ilObjiLincUser.php';
                                $ilinc_user = new ilObjiLincUser($updateUser);
                                $ilinc_user->setVar("id", $this->ilincdata["id"]);
                                $ilinc_user->setVar("login", $this->ilincdata["login"]);
                                $ilinc_user->setVar("passwd", $this->ilincdata["password"]);
                                $ilinc_user->update();
                                                        }

                                                        if(count($this->udf_data))
                                                        {
                                                                include_once 'classes/class.ilUserDefinedData.php';
                                                                $udd = new ilUserDefinedData($updateUser->getId());
                                                                foreach($this->udf_data as $field => $value)
                                                                {
                                                                        $udd->set($field,$value);
                                                                }
                                                                $udd->update();
                                                        }

                                                        // update login
                                                        if (!is_null($this->userObj->getLogin()) && $this->user_id != -1)
                                                                $updateUser->updateLogin($this->userObj->getLogin());

                                                    // if language has changed

                                                        if (is_array($this->personalPicture))
                                                        {
                                                                if (strlen($this->personalPicture["content"]))
                                                                {
                                                                        $extension = "jpg";
                                                                        if (preg_match("/.*(png|jpg|gif|jpeg)$/", $this->personalPicture["imagetype"], $matches))
                                                                        {
                                                                                $extension = $matches[1];
                                                                        }
                                                                        $tmp_name = $this->saveTempImage($this->personalPicture["content"], ".$extension");
                                                                        if (strlen($tmp_name))
                                                                        {
                                                                                ilObjUser::_uploadPersonalPicture($tmp_name, $this->userObj->getId());
                                                                                unlink($tmp_name);
                                                                        }
                                                                }
                                                        }


                                                        //update role entries
                                                        //-------------------
                                                        foreach ($this->roles as $role_id => $role)
                                                        {
                                                                if ($this->role_assign[$role_id])
                                                                {
                                                                        switch ($role["action"])
                                                                        {
                                                                                case "Assign" :
                                                                                        $this->assignToRole($updateUser, $this->role_assign[$role_id]);
                                                                                        break;
                                                                                case "Detach" :
                                                                                        $this->detachFromRole($updateUser, $this->role_assign[$role_id]);
                                                                                        break;
                                                                        }
                                                                }
                                                        }
                                                $this->logSuccess($updateUser->getLogin(), $user_id, "Update");
                                                }
                                                break;
                                        case "Delete" :
                                                if (! $user_id)
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),$lng->txt("usrimport_cant_delete"));
                                                }
                                                else
                                                {
                                                        $deleteUser = new ilObjUser($user_id);
                                                        $deleteUser->delete();

                                                        $this->logSuccess($this->userObj->getLogin(),$user_id, "Delete");
                                                }
                                                break;
                                }

                                // init role array for next user
                                $this->roles = array();
                                break;

                        case "Login":
                                $this->userObj->setLogin($this->cdata);
                                break;

                        case "Password":
                                $this->currPassword = $this->cdata;
                                break;

                        case "Firstname":
                                $this->userObj->setFirstname($this->cdata);
                                break;

                        case "Lastname":
                                $this->userObj->setLastname($this->cdata);
                                $this->userObj->setFullname();
                                break;

                        case "Title":
                                $this->userObj->setUTitle($this->cdata);
                                break;

                        case "Gender":
                                $this->userObj->setGender($this->cdata);
                                break;

                        case "Email":
                                $this->userObj->setEmail($this->cdata);
                                break;

                        case "Institution":
                                $this->userObj->setInstitution($this->cdata);
                                break;

                        case "Street":
                                $this->userObj->setStreet($this->cdata);
                                break;

                        case "City":
                                $this->userObj->setCity($this->cdata);
                                break;

                        case "PostalCode":
                                $this->userObj->setZipCode($this->cdata);
                                break;

                        case "Country":
                                $this->userObj->setCountry($this->cdata);
                                break;

                        case "PhoneOffice":
                                $this->userObj->setPhoneOffice($this->cdata);
                                break;

                        case "PhoneHome":
                                $this->userObj->setPhoneHome($this->cdata);
                                break;

                        case "PhoneMobile":
                                $this->userObj->setPhoneMobile($this->cdata);
                                break;

                        case "Fax":
                                $this->userObj->setFax($this->cdata);
                                break;

                        case "Hobby":
                                $this->userObj->setHobby($this->cdata);
                                break;

                        case "Comment":
                                $this->userObj->setComment($this->cdata);
                                break;

                        case "Department":
                                $this->userObj->setDepartment($this->cdata);
                                break;

                        case "Matriculation":
                                $this->userObj->setMatriculation($this->cdata);
                                break;

                        case "Active":
                                $this->currActive = $this->cdata;
                                break;

                        case "ClientIP":
                                $this->userObj->setClientIP($this->cdata);
                                break;

                        case "TimeLimitOwner":
                                $this->time_limit_owner_set = true;
                                $this->userObj->setTimeLimitOwner($this->cdata);
                                break;

                        case "TimeLimitUnlimited":
                                $this->time_limit_set = true;
                                $this->userObj->setTimeLimitUnlimited($this->cdata);
                                break;

                        case "TimeLimitFrom":
                                $this->userObj->setTimeLimitFrom($this->cdata);
                                break;

                        case "TimeLimitUntil":
                                $this->userObj->setTimeLimitUntil($this->cdata);
                                break;

                        case "TimeLimitMessage":
                                $this->userObj->setTimeLimitMessage($this->cdata);
                                break;

                        case "ApproveDate":
                                $this->userObj->setApproveDate($this->cdata);
                                break;

                        case "iLincID":
                                $this->ilincdata["id"] = $this->cdata;
                                break;

                        case "iLincLogin":
                                $this->$ilincdata["login"] = $this->cdata;
                                break;

                        case "iLincPasswd":
                                $this->$ilincdata["password"] = $this->cdata;
                                //$this->userObj->setiLincData($this->ilincdata);
                                break;
                                
                        case "ExternalAccount":
                                $this->userObj->setExternalAccount($this->cdata);
                                break;

                        case "Look":
                                $this->updateLookAndSkin = false;
                                if (!$this->hideSkin)
                                {
                                        // TODO: what to do with disabled skins? is it possible to change the skin via import?
                                        if ((strlen($this->skin) > 0) && (strlen($this->style) > 0))
                                        {
                                                if (is_array($this->userStyles))
                                                {
                                                        if (in_array($this->skin . ":" . $this->style, $this->userStyles))
                                                        {
                                                                $this->userObj->setPref("skin", $this->skin);
                                                                $this->userObj->setPref("style", $this->style);
                                                                $this->updateLookAndSkin = true;
                                                        }
                                                }
                                        }
                                }
                                break;
                                
                        case 'UserDefinedField':
                                include_once 'classes/class.ilUserDefinedFields.php';
                                $udf = ilUserDefinedFields::_getInstance();
                                if($field_id = $udf->fetchFieldIdFromImportId($this->tmp_udf_id))
                                {
                                        $this->udf_data[$field_id] = $this->cdata;
                                }
                                elseif($field_id = $udf->fetchFieldIdFromName($this->tmp_udf_name))
                                {
                                        $this->udf_data[$field_id] = $this->cdata;
                                }
                                break;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::isSendMail (  ) 

read access to property send mail

Returns:
boolean

Definition at line 1904 of file class.ilUserImportParser.php.

Referenced by sendAccountMail().

                               {
            return $this->send_mail;
        }

Here is the caller graph for this function:

ilUserImportParser::isSuccess (  ) 

Returns true, if the import was successful.

Definition at line 1852 of file class.ilUserImportParser.php.

        {
                return $this->error_level == IL_IMPORT_SUCCESS;
        }

ilUserImportParser::logFailure ( aLogin,
aMessage 
)

Writes a failure log message to the protocol.

Parameters:
string login
string message

Definition at line 1778 of file class.ilUserImportParser.php.

Referenced by importBeginTag(), importEndTag(), verifyBeginTag(), and verifyEndTag().

        {
                if (! array_key_exists($aLogin, $this->protocol))
                {
                        $this->protocol[$aLogin] = array();
                }
                if ($aMessage)
                {
                        $this->protocol[$aLogin][] = $aMessage;
                }
                $this->error_level = IL_IMPORT_FAILURE;
        }

Here is the caller graph for this function:

ilUserImportParser::logSuccess ( aLogin,
userid,
action 
)

Writes a success log message to the protocol.

Parameters:
string login
string userid
string action

Definition at line 1798 of file class.ilUserImportParser.php.

References $action.

Referenced by importEndTag().

        {
            $this->user_mapping[$userid] = array("login" => $aLogin, "action" => $action, "message" => "successful");
        }

Here is the caller graph for this function:

ilUserImportParser::logWarning ( aLogin,
aMessage 
)

Writes a warning log message to the protocol.

Parameters:
string login
string message

Definition at line 1757 of file class.ilUserImportParser.php.

Referenced by importEndTag(), and verifyEndTag().

        {
                if (! array_key_exists($aLogin, $this->protocol))
                {
                        $this->protocol[$aLogin] = array();
                }
                if ($aMessage)
                {
                        $this->protocol[$aLogin][] = $aMessage;
                }
                if ($this->error_level == IL_IMPORT_SUCCESS)
                {
                        $this->error_level = IL_IMPORT_WARNING;
                }
        }

Here is the caller graph for this function:

ilUserImportParser::saveTempImage ( image_data,
filename 
)

Saves binary image data to a temporary image file and returns the name of the image file on success.

Definition at line 1373 of file class.ilUserImportParser.php.

References ilUtil::ilTempnam().

Referenced by importEndTag().

        {
                $tempname = ilUtil::ilTempnam() . $filename;
                $fh = fopen($tempname, "wb");
                if ($fh == false)
                {
                        return "";
                }
                $imagefile = fwrite($fh, $image_data);
                fclose($fh);
                return $tempname;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::sendAccountMail (  ) 

send account mail

Definition at line 1878 of file class.ilUserImportParser.php.

References $_POST, and isSendMail().

Referenced by importEndTag().

        {
//var_dump($_POST["send_mail"]);
                if ($_POST["send_mail"] != "" ||
                   ($this->isSendMail() && $this->userObj->getEmail() != "")
                   )
                {
                        $this->acc_mail->setUser($this->userObj);
                        $this->acc_mail->send();
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::setFolderId ( a_folder_id  ) 

assign users to this folder (normally the usr_folder) But if called from local admin => the ref_id of the category public

Definition at line 305 of file class.ilUserImportParser.php.

        {
                $this->folder_id = $a_folder_id;
        }

ilUserImportParser::setHandlers ( a_xml_parser  ) 

set event handler should be overwritten by inherited class private

Reimplemented from ilSaxParser.

Definition at line 320 of file class.ilUserImportParser.php.

        {
                xml_set_object($a_xml_parser,$this);
                xml_set_element_handler($a_xml_parser,'handlerBeginTag','handlerEndTag');
                xml_set_character_data_handler($a_xml_parser,'handlerCharacterData');
        }

ilUserImportParser::setRoleAssignment ( a_assign  ) 

set import to local role assignemt

Parameters:
array role assignment (key: import id; value: local role id)

Definition at line 340 of file class.ilUserImportParser.php.

        {
                $this->role_assign = $a_assign;
        }

ilUserImportParser::setSendMail ( value  ) 

write access to property send mail

Parameters:
mixed $value

Definition at line 1895 of file class.ilUserImportParser.php.

                                      {
            $this->send_mail = $value ? true: false;
        }

ilUserImportParser::setUserMappingMode ( value  ) 

write access to user mapping mode

Parameters:
int $value must be one of IL_USER_MAPPING_ID or IL_USER_MAPPING_LOGIN, die otherwise

Definition at line 1913 of file class.ilUserImportParser.php.

        {
            if ($value == IL_USER_MAPPING_ID || $value == IL_USER_MAPPING_LOGIN)
               $this->mapping_mode = $value;
            else die ("wrong argument using methode setUserMappingMethod in ".__FILE__);
        }

ilUserImportParser::startParsing (  ) 

start the parser

Reimplemented from ilSaxParser.

Definition at line 330 of file class.ilUserImportParser.php.

ilUserImportParser::verifyBeginTag ( a_xml_parser,
a_name,
a_attribs 
)

handler for begin of element

Definition at line 523 of file class.ilUserImportParser.php.

References $id, ilSaxParser::$lng, ilUtil::__extractId(), getUserMappingMode(), and logFailure().

Referenced by handlerBeginTag().

        {
                global $lng;

                switch($a_name)
                {
                        case "Role":
                                if (is_null($a_attribs['Id'])
                                                                                || $a_attribs['Id'] == "")
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_attribute_missing"),"Role","Id"));
                                }
                                $this->current_role_id = $a_attribs["Id"];
                                $this->current_role_type = $a_attribs["Type"];
                                if ($this->current_role_type != 'Global'
                                && $this->current_role_type != 'Local')
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_attribute_missing"),"Role","Type"));
                                }
                                $this->current_role_action = (is_null($a_attribs["Action"])) ? "Assign" : $a_attribs["Action"];
                                if ($this->current_role_action != "Assign"
                                && $this->current_role_action != "Detach")
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"Role","Action",$a_attribs["Action"]));
                                }
                                if ($this->action == "Insert"
                                && $this->current_role_action == "Detach")
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_attribute_value_inapplicable"),"Role","Action",$this->current_role_action,$this->action));
                                }
                                if ($this->action == "Delete")
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_inapplicable"),"Role","Delete"));
                                }
                                break;

                        case "User":
                                $this->userCount++;
                                $this->userObj = new ilObjUser();
                                $this->userObj->setLanguage($a_attribs["Language"]);
                                $this->userObj->setImportId($a_attribs["Id"]);

                                // if we have an object id, store it
                                $this->user_id = -1;

                                if (!is_null($a_attribs["Id"]) && $this->getUserMappingMode() == IL_USER_MAPPING_ID)
                                {
                                        if (is_numeric($a_attribs["Id"]))
                                        {
                                                $this->user_id = $a_attribs["Id"];
                                        }
                                    elseif ($id = ilUtil::__extractId ($a_attribs["Id"], IL_INST_ID))
                                        {
                                                $this->user_id = $id;
                                        }
                                }

                                $this->action = (is_null($a_attribs["Action"])) ? "Insert" : $a_attribs["Action"];
                                if ($this->action != "Insert"
                                && $this->action != "Update"
                                && $this->action != "Delete")
                                {
                                        $this->logFailure($this->userObj->getImportId(), sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"User","Action",$a_attribs["Action"]));
                                }
                                $this->currPassword = null;
                                $this->currPasswordType = null;
                                break;

                        case "Password":
                                $this->currPasswordType = $a_attribs["Type"];
                                break;
                        case "AuthMode":
                                if (array_key_exists("type", $a_attribs))
                                {
                                        switch ($a_attribs["type"])
                                        {
                                                case "default":
                                                case "local":
                                                case "ldap":
                                                case "radius":
                                                case "shibboleth":
                                                case "script":
                                                case "cas":
                                                case "soap":
                                                        $this->userObj->setAuthMode($a_attribs["type"]);
                                                        break;
                                                default:
                                                        $this->logFailure($this->userObj->getImportId(), sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"AuthMode","type",$a_attribs["type"]));
                                                        break;
                                        }
                                }
                                else
                                {
                                        $this->logFailure($this->userObj->getImportId(), sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"AuthMode","type",""));
                                }
                                break;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilUserImportParser::verifyEndTag ( a_xml_parser,
a_name 
)

handler for end of element when in verify mode.

Definition at line 1389 of file class.ilUserImportParser.php.

References ilSaxParser::$lng, ilObjUser::_checkExternalAuthAccount(), ilAuthUtils::_getAuthModeName(), ilObjUser::_lookupId(), ilObjUser::_lookupLogin(), ilObjUser::getUserIdByLogin(), logFailure(), and logWarning().

Referenced by handlerEndTag().

        {
                global $lng,$ilAccess,$ilSetting,$ilObjDataCache;

                switch($a_name)
                {
                        case "Role":
                                $this->roles[$this->current_role_id]["name"] = $this->cdata;
                                $this->roles[$this->current_role_id]["type"] = $this->current_role_type;
                                $this->roles[$this->current_role_id]["action"] = $this->current_role_action;
                                break;

                        case "User":
                                if ($this->user_id != -1 && $this->action == "Update")
                                    $user_exists = !is_null(ilObjUser::_lookupLogin($this->user_id));
                            else
                                $user_exists = ilObjUser::getUserIdByLogin($this->userObj->getLogin()) != 0;

                                if (is_null($this->userObj->getLogin()))
                                {
                                        $this->logFailure("---",sprintf($lng->txt("usrimport_xml_element_for_action_required"),"Login", "Insert"));
                                }

                                switch ($this->action)
                                {
                                        case "Insert" :
                                                if ($user_exists)
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),$lng->txt("usrimport_cant_insert"));
                                                }
                                                if (is_null($this->userObj->getGender()))
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),sprintf($lng->txt("usrimport_xml_element_for_action_required"),"Gender", "Insert"));
                                                }
                                                if (is_null($this->userObj->getFirstname()))
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),sprintf($lng->txt("usrimport_xml_element_for_action_required"),"Firstname", "Insert"));
                                                }
                                                if (is_null($this->userObj->getLastname()))
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),sprintf($lng->txt("usrimport_xml_element_for_action_required"),"Lastname", "Insert"));
                                                }
                                                if (count($this->roles) == 0)
                                                {
                                                        $this->logFailure($this->userObj->getLogin(),sprintf($lng->txt("usrimport_xml_element_for_action_required"),"Role", "Insert"));
                                                }
                                                else
                                                {
                                                        $has_global_role = false;
                                                        foreach ($this->roles as $role)
                                                        {
                                                                if ($role['type'] == 'Global')
                                                                {
                                                                        $has_global_role = true;
                                                                        break;
                                                                }
                                                        }
                                                        if (! $has_global_role)
                                                        {
                                                                $this->logFailure($this->userObj->getLogin(),sprintf($lng->txt("usrimport_global_role_for_action_required"),"Insert"));
                                                        }
                                                }
                                                break;
                                        case "Update" :
                                                if (! $user_exists)
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),$lng->txt("usrimport_cant_update"));
                                                } elseif ($this->user_id != -1 && !is_null($this->userObj->getLogin()))
                                                        // check if someone owns the new login name!
                        {
                            $someonesId = ilObjUser::_lookupId($this->userObj->getLogin());

                            if (is_numeric($someonesId ) && $someonesId != $this->user_id) {
                                          $this->logFailure($this->userObj->getLogin(), $lng->txt("usrimport_login_is_not_unique"));
                            }
                        }
                                                break;
                                        case "Delete" :
                                                if (! $user_exists)
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),$lng->txt("usrimport_cant_delete"));
                                                }
                                                break;
                                }

                                // init role array for next user
                                $this->roles = array();
                                break;

                        case "Login":
                                if (array_key_exists($this->cdata, $this->logins))
                                {
                                        $this->logFailure($this->cdata, $lng->txt("usrimport_login_is_not_unique"));
                                }
                                else
                                {
                                        $this->logins[$this->cdata] = $this->cdata;
                                }
                        $this->userObj->setLogin($this->cdata);
                                break;

                        case "Password":
                                switch ($this->currPasswordType)
                                {
                                        case "ILIAS2":
                                                $this->userObj->setPasswd($this->cdata, IL_PASSWD_CRYPT);
                                                break;

                                        case "ILIAS3":
                                                $this->userObj->setPasswd($this->cdata, IL_PASSWD_MD5);
                                                break;

                                        case "PLAIN":
                                                $this->userObj->setPasswd($this->cdata, IL_PASSWD_PLAIN);
                                                $this->acc_mail->setUserPassword($this->currPassword);
                                                break;

                                        default :
                                                $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"Type","Password",$this->currPasswordType));
                                                break;
                                }
                                break;

                        case "Firstname":
                                $this->userObj->setFirstname($this->cdata);
                                break;

                        case "Lastname":
                                $this->userObj->setLastname($this->cdata);
                                $this->userObj->setFullname();
                                break;

                        case "Title":
                                $this->userObj->setUTitle($this->cdata);
                                break;

                        case "Gender":
                                if ($this->cdata != "m"
                                && $this->cdata != "f")
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_attribute_value_illegal"),"Gender",$this->cdata));
                                }
                                $this->userObj->setGender($this->cdata);
                                break;

                        case "Email":
                                $this->userObj->setEmail($this->cdata);
                                break;

                        case "Institution":
                                $this->userObj->setInstitution($this->cdata);
                                break;

                        case "Street":
                                $this->userObj->setStreet($this->cdata);
                                break;

                        case "City":
                                $this->userObj->setCity($this->cdata);
                                break;

                        case "PostalCode":
                                $this->userObj->setZipCode($this->cdata);
                                break;

                        case "Country":
                                $this->userObj->setCountry($this->cdata);
                                break;

                        case "PhoneOffice":
                                $this->userObj->setPhoneOffice($this->cdata);
                                break;

                        case "PhoneHome":
                                $this->userObj->setPhoneHome($this->cdata);
                                break;

                        case "PhoneMobile":
                                $this->userObj->setPhoneMobile($this->cdata);
                                break;

                        case "Fax":
                                $this->userObj->setFax($this->cdata);
                                break;

                        case "Hobby":
                                $this->userObj->setHobby($this->cdata);
                                break;

                        case "Comment":
                                $this->userObj->setComment($this->cdata);
                                break;

                        case "Department":
                                $this->userObj->setDepartment($this->cdata);
                                break;

                        case "Matriculation":
                                $this->userObj->setMatriculation($this->cdata);
                                break;
                                
                        case "ExternalAccount":
//echo "-".$this->userObj->getAuthMode()."-".$this->userObj->getLogin()."-";
                                $am = ($this->userObj->getAuthMode() == "default" || $this->userObj->getAuthMode() == "")
                                        ? ilAuthUtils::_getAuthModeName($ilSetting->get('auth_mode'))
                                        : $this->userObj->getAuthMode();
                                $elogin = (trim($this->cdata) == "")
                                        ? ""
                                        : ilObjUser::_checkExternalAuthAccount($am, trim($this->cdata));
                                switch ($this->action)
                                {
                                        case "Insert" :
                                                if ($elogin != "")
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),
                                                                $lng->txt("usrimport_no_insert_ext_account_exists")." (".$this->cdata.")");
                                                }
                                                break;
                                                
                                        case "Update" :
                                                if ($elogin != "" && $elogin != $ilObjUser->getLogin())
                                                {
                                                        $this->logWarning($this->userObj->getLogin(),
                                                                $lng->txt("usrimport_no_update_ext_account_exists")." (".$this->cdata.")");
                                                }
                                                break;
                                }
                                $this->userObj->setExternalAccount(trim($this->cdata));
                                break;
                                
                        case "Active":
                                if ($this->cdata != "true"
                                && $this->cdata != "false")
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_element_content_illegal"),"Active",$this->cdata));
                                }
                                $this->currActive = $this->cdata;
                                break;
                        case "TimeLimitOwner":
                                if (!preg_match("/\d+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitOwner",$this->cdata));
                                } 
                                elseif(!$ilAccess->checkAccess('cat_administrate_users','',$this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitOwner",$this->cdata));
                                }
                                elseif($ilObjDataCache->lookupType($ilObjDataCache->lookupObjId($this->cdata)) != 'cat')
                                {
                                        $this->logFailure($this->userObj->getLogin(),
                                                                          sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitOwner",$this->cdata));
                                        
                                }
                                $this->userObj->setTimeLimitOwner($this->cdata);
                                break;
                        case "TimeLimitUnlimited":
                                switch (strtolower($this->cdata))
                                {
                                        case "true":
                                        case "1":
                                                $this->userObj->setTimeLimitUnlimited(1);
                                                break;
                                        case "false":
                                        case "0":
                                                $this->userObj->setTimeLimitUnlimited(0);
                                                break;
                                        default:
                                                $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitUnlimited",$this->cdata));
                                                break;
                                }
                                break;
                        case "TimeLimitFrom":
                                if (!preg_match("/\d+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitFrom",$this->cdata));
                                }
                                $this->userObj->setTimeLimitFrom($this->cdata);
                                break;
                        case "TimeLimitUntil":
                                if (!preg_match("/\d+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitUntil",$this->cdata));
                                }
                                $this->userObj->setTimeLimitUntil($this->cdata);
                                break;
                        case "TimeLimitMessage":
                                switch (strtolower($this->cdata))
                                {
                                        case "1":
                                                $this->userObj->setTimeLimitMessage(1);
                                                break;
                                        case "0":
                                                $this->userObj->setTimeLimitMessage(0);
                                                break;
                                        default:
                                                $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"TimeLimitMessage",$this->cdata));
                                                break;
                                }
                                break;
                        case "ApproveDate":
                                if (!preg_match("/\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"ApproveDate",$this->cdata));
                                }
                                $this->userObj->setTimeLimitUntil($this->cdata);
                                break;
                        case "iLincID":
                                if (!preg_match("/\d+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"iLincID",$this->cdata));
                                }
                                break;
                        case "iLincUser":
                                if (!preg_match("/\w+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"iLincUser",$this->cdata));
                                }
                                break;
                        case "iLincPasswd":
                                if (!preg_match("/\w+/", $this->cdata))
                                {
                                        $this->logFailure($this->userObj->getLogin(), sprintf($lng->txt("usrimport_xml_element_content_illegal"),"iLincPasswd",$this->cdata));
                                }
                                break;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:


Field Documentation

ilUserImportParser::$action

The Action attribute determines what to do for the current User element.

This variable supports the following values: "Insert","Update","Delete".

Definition at line 65 of file class.ilUserImportParser.php.

Referenced by logSuccess().

ilUserImportParser::$conflict_rule

Conflict handling rule.

Values: IL_FAIL_ON_CONFLICT IL_UPDATE_ON_CONFLICT IL_IGNORE_ON_CONFLICT

Definition at line 93 of file class.ilUserImportParser.php.

ilUserImportParser::$currActive

The active state of the current user.

Definition at line 177 of file class.ilUserImportParser.php.

ilUserImportParser::$currPassword

The password of the current user.

Definition at line 173 of file class.ilUserImportParser.php.

ilUserImportParser::$currPasswordType

The password type of the current user.

Definition at line 169 of file class.ilUserImportParser.php.

ilUserImportParser::$disableSkin

Indicates if the skins are enabled.

Definition at line 241 of file class.ilUserImportParser.php.

ilUserImportParser::$error_level

This variable is used to report the error level of the validation process or the importing process.

Values: IL_IMPORT_SUCCESS IL_IMPORT_WARNING IL_IMPORT_FAILURE

Meaning of the values when in validation mode: IL_IMPORT_WARNING Some of the entity actions can not be processed as specified in the XML file. One or more of the following conflicts have occurred:

  • An "Insert" action has been specified for a user who is already in the database.
  • An "Update" action has been specified for a user who is not in the database.
  • A "Delete" action has been specified for a user who is not in the database. IL_IMPORT_FAILURE Some of the XML elements are invalid.

Meaning of the values when in import mode: IL_IMPORT_WARNING Some of the entity actions have not beeen processed as specified in the XML file.

In IL_UPDATE_ON_CONFLICT mode, the following may have occured:

  • An "Insert" action has been replaced by a "Update" action for a user who is already in the database.
    • An "Update" action has been replaced by a "Insert" action for a user who is not in the database.
  • A "Delete" action has been replaced by a "Ignore" action for a user who is not in the database.

In IL_IGNORE_ON_CONFLICT mode, the following may have occured:

  • An "Insert" action has been replaced by a "Ignore" action for a user who is already in the database.
  • An "Update" action has been replaced by a "Ignore" action for a user who is not in the database.
    • A "Delete" action has been replaced by a "Ignore" action for a user who is not in the database.

IL_IMPORT_FAILURE The import could not be completed.

In IL_FAIL_ON_CONFLICT mode, the following may have occured:

  • An "Insert" action has failed for a user who is already in the database.
  • An "Update" action has failed for a user who is not in the database.
  • A "Delete" action has failed for a user who is not in the database.

Definition at line 164 of file class.ilUserImportParser.php.

ilUserImportParser::$folder_id

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

ilUserImportParser::$hideSkin

Indicates if the skins are hidden.

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

ilUserImportParser::$ilincdata

Cached iLinc data.

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

Referenced by importEndTag().

ilUserImportParser::$localRoleCache

Cached local roles.

This is used to speed up access to local roles. This is an associative array. The key is either a role_id or a role_id with the string "_parent" appended. The value is a role object or the object for which the role is defined

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

ilUserImportParser::$logins

This variable is used to collect each login that we encounter in the import data.

This variable is needed to detect duplicate logins in the import data. The variable is an associative array. (I would prefer using a set, but PHP does not appear to support sets.) Keys are logins. Values are logins.

Definition at line 84 of file class.ilUserImportParser.php.

ilUserImportParser::$mapping_mode

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

ilUserImportParser::$personalPicture

Cached personal picture of the actual user This is used because the ilObjUser object has no field for the personal picture.

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

ilUserImportParser::$protocol

The variable holds the protocol of the import.

This variable is an associative array.

  • Keys are login names of users or "missing login", if the login name is missing.
  • Values are an array of error messages associated with the login. If the value array is empty, then the user was imported successfully.

Definition at line 74 of file class.ilUserImportParser.php.

ilUserImportParser::$roles

Definition at line 60 of file class.ilUserImportParser.php.

ilUserImportParser::$send_mail

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

ilUserImportParser::$skin

ILIAS skin.

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

ilUserImportParser::$style

ILIAS style.

Definition at line 226 of file class.ilUserImportParser.php.

ilUserImportParser::$time_limit_owner_set = false

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

ilUserImportParser::$time_limit_set = false

Definition at line 52 of file class.ilUserImportParser.php.

ilUserImportParser::$updateLookAndSkin = false

boolean to determine if look and skin should be updated

Definition at line 58 of file class.ilUserImportParser.php.

ilUserImportParser::$user_id

Definition at line 248 of file class.ilUserImportParser.php.

Referenced by importEndTag().

ilUserImportParser::$user_mapping

Definition at line 188 of file class.ilUserImportParser.php.

ilUserImportParser::$userCount

The count of user elements in the XML file.

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

ilUserImportParser::$userStyles

User assigned styles.

Definition at line 231 of file class.ilUserImportParser.php.


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