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

Collaboration diagram for ilUserDefinedData:

Public Member Functions
	__construct (int $a_usr_id)

	getUserId ()

	set (string $a_field, string $a_value)

	get (string $a_field)

	getAll ()

	update ()

	toXML ()

	addToXML (ilXmlWriter $xml_writer)
	add user defined field data to xml (using usr dtd) More...

	__read ()

Static Public Member Functions
static	lookupData (array $a_user_ids, array $a_field_ids)
	Lookup data. More...

static	deleteEntriesOfUser (int $a_user_id)

static	deleteEntriesOfField (int $a_field_id)
	Delete data of particular field. More...

static	deleteFieldValue (int $a_field_id, string $a_value)
	Delete data of particular value of a (selection) field. More...

Data Fields
ilDBInterface	$db = null

array	$user_data = array()

int	$usr_id = null

Detailed Description

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

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

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

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

Definition at line 23 of file class.ilUserDefinedData.php.

Constructor & Destructor Documentation

◆ __construct()

ilUserDefinedData::__construct ( int $a_usr_id )

Definition at line 29 of file class.ilUserDefinedData.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $this->db = $ilDB;
        $this->usr_id = $a_usr_id;
 
        $this->__read();
    }

References $DIC, $ilDB, and __read().

Here is the call graph for this function:

Member Function Documentation

◆ __read()

ilUserDefinedData::__read ( )

Definition at line 207 of file class.ilUserDefinedData.php.

                            : void
    {
        $this->user_data = array();
        $query = "SELECT * FROM udf_text " .
            "WHERE usr_id = " . $this->db->quote($this->usr_id, 'integer');
        $res = $this->db->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) {
            $this->user_data["f_" . $row["field_id"]] = $row["value"];
        }
        $query = "SELECT * FROM udf_clob " .
            "WHERE usr_id = " . $this->db->quote($this->usr_id, 'integer');
        $res = $this->db->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) {
            $this->user_data["f_" . $row["field_id"]] = $row["value"];
        }
    }

References $query, $res, and ilDBConstants\FETCHMODE_ASSOC.

Referenced by __construct().

Here is the caller graph for this function:

◆ addToXML()

ilUserDefinedData::addToXML ( ilXmlWriter $xml_writer )

add user defined field data to xml (using usr dtd)

Definition at line 190 of file class.ilUserDefinedData.php.

                                                     : void
    {
        $udf_obj = ilUserDefinedFields::_getInstance();
 
        foreach ($udf_obj->getDefinitions() as $definition) {
            if ($definition["export"] != false) {
                $xml_writer->xmlElement(
                    'UserDefinedField',
                    array('Id' => $definition['il_id'],
                                          'Name' => $definition['field_name']),
                    (string) ($this->user_data['f_' . (int) $definition['field_id']] ?? '')
                );
            }
        }
    }

References ilUserDefinedFields\_getInstance(), and ilXmlWriter\xmlElement().

Here is the call graph for this function:

◆ deleteEntriesOfField()

static ilUserDefinedData::deleteEntriesOfField ( int $a_field_id )

static

Delete data of particular field.

Definition at line 144 of file class.ilUserDefinedData.php.

                                                                : void
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $ilDB->manipulate(
            "DELETE FROM udf_text WHERE "
            . " field_id = " . $ilDB->quote($a_field_id, "integer")
        );
        $ilDB->manipulate(
            "DELETE FROM udf_clob WHERE "
            . " field_id = " . $ilDB->quote($a_field_id, "integer")
        );
    }

References $DIC, and $ilDB.

Referenced by ilUserDefinedFields\delete().

Here is the caller graph for this function:

◆ deleteEntriesOfUser()

static ilUserDefinedData::deleteEntriesOfUser ( int $a_user_id )

static

Definition at line 125 of file class.ilUserDefinedData.php.

                                                              : void
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $ilDB->manipulate(
            "DELETE FROM udf_text WHERE "
            . " usr_id = " . $ilDB->quote($a_user_id, "integer")
        );
        $ilDB->manipulate(
            "DELETE FROM udf_clob WHERE "
            . " usr_id = " . $ilDB->quote($a_user_id, "integer")
        );
    }

References $DIC, and $ilDB.

Referenced by ilObjUser\deleteUserDefinedFieldEntries().

Here is the caller graph for this function:

◆ deleteFieldValue()

static ilUserDefinedData::deleteFieldValue	(	int	$a_field_id,
		string	$a_value
	)

static

Delete data of particular value of a (selection) field.

Definition at line 163 of file class.ilUserDefinedData.php.

     : void {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $ilDB->manipulate(
            "UPDATE udf_text SET value = " . $ilDB->quote("", "text") . " WHERE "
            . " field_id = " . $ilDB->quote($a_field_id, "integer")
            . " AND value = " . $ilDB->quote($a_value, "text")
        );
    }

Referenced by ilCustomUserFieldsGUI\update().

Here is the caller graph for this function:

◆ get()

ilUserDefinedData::get ( string $a_field )

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

                                        : string
    {
        return $this->user_data[$a_field] ?? '';
    }

Referenced by ilMemberExport\addUserDefinedField().

Here is the caller graph for this function:

◆ getAll()

ilUserDefinedData::getAll ( )

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

                            : array // Missing array type.
    {
        return $this->user_data;
    }

References $user_data.

◆ getUserId()

ilUserDefinedData::getUserId ( )

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

                               : int
    {
        return $this->usr_id;
    }

References $usr_id.

Referenced by ilMemberExport\addUserDefinedField(), and update().

Here is the caller graph for this function:

◆ lookupData()

static ilUserDefinedData::lookupData	(	array	$a_user_ids,
		array	$a_field_ids
	)

static

Lookup data.

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

                                                                            : array // Missing array type.
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT * FROM udf_text " .
            "WHERE " . $ilDB->in('usr_id', $a_user_ids, false, 'integer') . ' ' .
            'AND ' . $ilDB->in('field_id', $a_field_ids, false, 'integer');
        $res = $ilDB->query($query);
 
        $udfd = array();
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) {
            $udfd[$row['usr_id']][$row['field_id']] = $row['value'];
        }
 
        $def_helper = ilCustomUserFieldsHelper::getInstance();
        foreach ($def_helper->getActivePlugins() as $plugin) {
            foreach ($plugin->lookupUserData($a_user_ids, $a_field_ids) as $user_id => $usr_data) {
                foreach ($usr_data as $field_id => $value) {
                    $udfd[$user_id][$field_id] = $value;
                }
            }
        }
 
        return $udfd;
    }

References $DIC, $ilDB, XapiProxy\$plugin, $query, $res, ilDBConstants\FETCHMODE_ASSOC, and ilCustomUserFieldsHelper\getInstance().

Referenced by ilCourseParticipantsTableGUI\parse(), ilGroupParticipantsTableGUI\parse(), ilLearningSequenceParticipantsTableGUI\parse(), ilRepositoryUserResultTableGUI\parseUserIds(), ilSubscriberTableGUI\readSubscriberData(), and ilWaitingListTableGUI\readUserData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set()

ilUserDefinedData::set	(	string	$a_field,
		string	$a_value
	)

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

                                                         : void
    {
        $this->user_data[$a_field] = $a_value;
    }

◆ toXML()

ilUserDefinedData::toXML ( )

Definition at line 178 of file class.ilUserDefinedData.php.

                           : string
    {
        $xml_writer = new ilXmlWriter();
 
        $this->addToXML($xml_writer);
 
        return $xml_writer->xmlDumpMem(false);
    }

◆ update()

ilUserDefinedData::update ( )

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

                            : void
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $udf_obj = ilUserDefinedFields::_getInstance();
 
        foreach ($udf_obj->getDefinitions() as $definition) {
            if ($definition["field_type"] == UDF_TYPE_WYSIWYG) {
                $ilDB->replace(
                    "udf_clob",
                    array(
                        "usr_id" => array("integer", $this->getUserId()),
                        "field_id" => array("integer", $definition['field_id'])),
                    array(
                        "value" => array("clob", $this->get("f_" . $definition['field_id']))
                        )
                );
            } else {
                $ilDB->replace(
                    "udf_text",
                    array(
                        "usr_id" => array("integer", $this->getUserId()),
                        "field_id" => array("integer", $definition['field_id'])),
                    array(
                        "value" => array("text", $this->get("f_" . $definition['field_id']))
                        )
                );
            }
        }
    }