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

Inheritance diagram for ilDclBaseFieldModel:

Collaboration diagram for ilDclBaseFieldModel:

Public Member Functions
	__construct (int $a_id=0)

	setId ($a_id)
	Set field id. More...

	getId ()
	Get field id. More...

	setTableId (int $a_id)
	Set table id. More...

	getTableId ()
	Get table id. More...

	setTitle (string $a_title)
	Set title. More...

	getTitle ()
	Get title. More...

	setDescription (string $a_desc)
	Set description. More...

	getDescription ()
	Get description. More...

	setDatatypeId (int $a_id)
	Set datatype id. More...

	getDatatypeId ()
	Get datatype_id. More...

	isUnique ()

	setUnique (?bool $unique)

	getDatatype ()

	getDatatypeTitle ()

	getPresentationTitle ()

	getPresentationDescription ()

	getStorageLocation ()
	Get storage location for the model. More...

	getExportable ()

	toArray ()

	isStandardField ()

	doRead ()

	buildFromDBRecord (array $rec)
	Builds model from db record. More...

	doCreate ()

	doUpdate ()

	updateProperties ()
	Update properties of this field in Database. More...

	doDelete ()
	Remove field and properties. More...

	getViewSettings ()

	getViewSetting (int $tableview_id)

	getOrder ()

	setOrder (string $order)

	hasProperty (string $key)
	Checks if a certain property for a field is set. More...

	getProperty (string $key)
	Returns a certain property of a field. More...

	getPropertyInstance (string $key)
	Return ActiveRecord of property. More...

	setProperty (string $key, $value)
	Set a property for a field (does not save) More...

	getValidFieldProperties ()
	Returns all valid properties for a field-type. More...

	checkValidityFromForm (ilPropertyFormGUI &$form, ?int $record_id=null)

	checkValidity ($value, ?int $record_id=null)
	Check if input is valid. More...

	cloneStructure (int $original_id)

	afterClone (array $records)

	cloneProperties (ilDclBaseFieldModel $originalField)

	setExportable (bool $exportable)

	allowFilterInListView ()

	getRecordQuerySortObject (string $direction="asc", bool $sort_by_status=false)
	Returns a query-object for building the record-loader-sql-query. More...

	getRecordQueryFilterObject ( $filter_value="", ?ilDclBaseFieldModel $sort_field=null)
	Returns a query-object for building the record-loader-sql-query. More...

	getSortField ()
	Returns the sort-field id. More...

	hasNumericSorting ()
	Set to true, when the sorting should be handled numerical. More...

	checkFieldCreationInput (ilPropertyFormGUI $form)
	Checks input of specific fields befor saving. More...

	getStorageLocationOverride ()

	setStorageLocationOverride (?int $storage_location_override)

	fillHeaderExcel (ilExcel $worksheet, int &$row, int &$col)

	checkTitlesForImport (array &$titles, array &$import_fields)

	storePropertiesFromForm (ilPropertyFormGUI $form)
	called when saving the 'edit field' form More...

	fillPropertiesForm (ilPropertyFormGUI &$form)
	called to fill the 'edit field' form More...

	isConfirmationRequired (ilPropertyFormGUI $form)
	called by ilDclFieldEditGUI when updating field properties if you overwrite this method, remember to also overwrite getConfirmationGUI More...

	getConfirmationGUI (ilPropertyFormGUI $form)
	called by ilDclFieldEditGUI if isConfirmationRequired returns true More...

Static Public Member Functions
static	_getTitleInvalidChars (bool $a_as_regex=true)
	All valid chars for filed titles. More...

static	_getFieldIdByTitle (string $title, int $table_id)

Data Fields
const	PROP_LENGTH = "lenght"
	General properties. More...

const	PROP_REGEX = "regex"

const	PROP_REFERENCE = "table_id"

const	PROP_URL = "url"

const	PROP_TEXTAREA = "text_area"

const	PROP_REFERENCE_LINK = "reference_link"

const	PROP_WIDTH = "width"

const	PROP_HEIGHT = "height"

const	PROP_LEARNING_PROGRESS = "learning_progress"

const	PROP_ILIAS_REFERENCE_LINK = "ILIAS_reference_link"

const	PROP_N_REFERENCE = "multiple_selection"

const	PROP_FORMULA_EXPRESSION = "expression"

const	PROP_DISPLAY_COPY_LINK_ACTION_MENU = "display_action_menu"

const	PROP_LINK_DETAIL_PAGE_TEXT = "link_detail_page_text"

const	PROP_LINK_DETAIL_PAGE_MOB = "link_detail_page_mob"

const	PROP_SUPPORTED_FILE_TYPES = "supported_file_types"

const	PROP_PLUGIN_HOOK_NAME = "plugin_hook_name"

const	EDIT_VIEW = 2

const	EXPORTABLE_VIEW = 4

Protected Member Functions
	loadDatatype ()
	Load datatype for model. More...

	loadTableFieldSetting ()
	loadTableFieldSetting More...

	addToTableViews ()
	create ilDclTableViewFieldSettings for this field in each tableview More...

	updateTableFieldSetting ()
	update exportable and fieldorder More...

	loadProperties ()
	Get all properties of a field. More...

	normalizeValue ($value)

Protected Attributes
string	$id = ""

int	$table_id = 0

string	$title = ""

string	$description = ""

int	$datatypeId = 0

int	$order = null

bool	$unique = false

array	$property = []

bool	$exportable = false

ilDclDatatype	$datatype = null

int	$storage_location_override = null
	With this property the datatype-storage-location can be overwritten. More...

ilDBInterface	$db

ilLanguage	$lng

Private Member Functions
	loadExportability ()
	Load exportability. More...

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

Definition at line 19 of file class.ilDclBaseFieldModel.php.

Constructor & Destructor Documentation

◆ __construct()

ilDclBaseFieldModel::__construct ( int $a_id = 0 )

Definition at line 63 of file class.ilDclBaseFieldModel.php.

    {
        global $DIC;
        $this->db = $DIC->database();
        $this->lng = $DIC->language();
 
        if ($a_id != 0) {
            $this->id = $a_id;
            $this->doRead();
        }
    }

References $DIC, doRead(), and ILIAS\Repository\lng().

Here is the call graph for this function:

Member Function Documentation

◆ _getFieldIdByTitle()

static ilDclBaseFieldModel::_getFieldIdByTitle	(	string	$title,
		int	$table_id
	)

static

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

                                                                           : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $result = $ilDB->query(
            'SELECT id FROM il_dcl_field WHERE title = ' . $ilDB->quote($title, 'text') . ' AND table_id = '
            . $ilDB->quote($table_id, 'integer')
        );
        $id = 0;
        while ($rec = $ilDB->fetchAssoc($result)) {
            $id = $rec['id'];
        }
 
        return $id;
    }

References $DIC, $id, $ilDB, $table_id, and $title.

◆ _getTitleInvalidChars()

static ilDclBaseFieldModel::_getTitleInvalidChars ( bool $a_as_regex = true )

static

All valid chars for filed titles.

Definition at line 78 of file class.ilDclBaseFieldModel.php.

                                                                         : string
    {
        if ($a_as_regex) {
            return '/^[^<>\\\\":]*$/i';
        } else {
            return '\ < > " :';
        }
    }

Referenced by ilDclFieldEditGUI\initForm().

Here is the caller graph for this function:

◆ addToTableViews()

ilDclBaseFieldModel::addToTableViews ( )

protected

create ilDclTableViewFieldSettings for this field in each tableview

Definition at line 357 of file class.ilDclBaseFieldModel.php.

                                        : void
    {
        foreach (ilDclTableView::getAllForTableId($this->table_id) as $tableview) {
            $tableview->createFieldSetting($this->id);
        }
    }

References ilDclTableView\getAllForTableId().

Referenced by doCreate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ afterClone()

ilDclBaseFieldModel::afterClone ( array $records )

Definition at line 610 of file class.ilDclBaseFieldModel.php.

    {
        foreach ($records as $rec) {
            ilDclCache::getRecordFieldCache($rec, $this)->afterClone();
        }
    }

References ilDclCache\getRecordFieldCache().

Here is the call graph for this function:

◆ allowFilterInListView()

ilDclBaseFieldModel::allowFilterInListView ( )

Reimplemented in ilDclStandardField, ilDclFileuploadFieldModel, ilDclFormulaFieldModel, ilDclMobFieldModel, ilDclPluginFieldModel, and ilDclReferenceFieldModel.

Definition at line 647 of file class.ilDclBaseFieldModel.php.

                                           : bool
    {
        return true;
    }

◆ buildFromDBRecord()

ilDclBaseFieldModel::buildFromDBRecord ( array $rec )

Builds model from db record.

Definition at line 319 of file class.ilDclBaseFieldModel.php.

                                                 : void
    {
        $this->setId($rec["id"]);
        $this->setTableId($rec["table_id"]);
        $this->setTitle($rec["title"]);
        $this->setDescription($rec["description"]);
        $this->setDatatypeId($rec["datatype_id"]);
        $this->setUnique($rec["is_unique"] ?? null);
    }

References setDatatypeId(), setDescription(), setId(), setTableId(), setTitle(), and setUnique().

Here is the call graph for this function:

◆ checkFieldCreationInput()

ilDclBaseFieldModel::checkFieldCreationInput ( ilPropertyFormGUI $form )

Checks input of specific fields befor saving.

Parameters

ilPropertyFormGUI $form

Returns: bool if checkInput was successful

Reimplemented in ilDclSelectionFieldModel, and ilDclTextFieldModel.

Definition at line 714 of file class.ilDclBaseFieldModel.php.

                                                                    : bool
    {
        return true;
    }

◆ checkTitlesForImport()

ilDclBaseFieldModel::checkTitlesForImport	(	array &	$titles,
		array &	$import_fields
	)

Reimplemented in ilDclTextFieldModel.

Definition at line 741 of file class.ilDclBaseFieldModel.php.

                                                                               : void
    {
        foreach ($titles as $k => $title) {
            if (!ilStr::isUtf8($title)) {
                $title = utf8_encode($title);
            }
            if ($title == $this->getTitle()) {
                $import_fields[$k] = $this;
            }
        }
    }

References ilStr\isUtf8().

Here is the call graph for this function:

◆ checkValidity()

ilDclBaseFieldModel::checkValidity	(		$value,
		?int	$record_id = `null`
	)

Check if input is valid.

Parameters

float | int | string | array | null $value

Exceptions

ilDclInputException

Reimplemented in ilDclDatetimeFieldModel, ilDclFileuploadFieldModel, ilDclNumberFieldModel, and ilDclTextFieldModel.

Definition at line 560 of file class.ilDclBaseFieldModel.php.

                                                                 : bool
    {
        //Don't check empty values
        if ($value == null) {
            return true;
        }
 
        if ($this->isUnique()) {
            $table = ilDclCache::getTableCache($this->getTableId());
            foreach ($table->getRecords() as $record) {
                if ($this->normalizeValue($record->getRecordFieldValue($this->getId())) == $this->normalizeValue($value) && ($record->getId() != $record_id || $record_id == 0)) {
                    throw new ilDclInputException(ilDclInputException::UNIQUE_EXCEPTION);
                }
            }
        }
 
        return true;
    }

References ilDclCache\getTableCache(), getTableId(), isUnique(), normalizeValue(), and ilDclInputException\UNIQUE_EXCEPTION.

Referenced by checkValidityFromForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkValidityFromForm()

ilDclBaseFieldModel::checkValidityFromForm	(	ilPropertyFormGUI &	$form,
		?int	$record_id = `null`
	)

Reimplemented in ilDclTextFieldModel.

Definition at line 549 of file class.ilDclBaseFieldModel.php.

                                                                                           : void
    {
        $value = $form->getInput('field_' . $this->getId());
        $this->checkValidity($value, $record_id);
    }

References checkValidity(), getId(), and ilPropertyFormGUI\getInput().

Here is the call graph for this function:

◆ cloneProperties()

ilDclBaseFieldModel::cloneProperties ( ilDclBaseFieldModel $originalField )

Reimplemented in ilDclSelectionFieldModel.

Definition at line 617 of file class.ilDclBaseFieldModel.php.

                                                                       : void
    {
        $orgProps = $originalField->getValidFieldProperties();
        if (count($orgProps) == 0) {
            return;
        }
        foreach ($orgProps as $prop_name) {
            $fieldprop_obj = new ilDclFieldProperty();
            $fieldprop_obj->setFieldId($this->getId());
            $fieldprop_obj->setName($prop_name);
 
            $value = $originalField->getProperty($prop_name);
 
            // If reference field, we must reset the referenced field, otherwise it will point to the old ID
            if ($originalField->getDatatypeId() == ilDclDatatype::INPUTFORMAT_REFERENCE && $prop_name == ilDclBaseFieldModel::PROP_REFERENCE) {
                $value = null;
            }
 
            if ($value) {
                $fieldprop_obj->setValue($value);
                $fieldprop_obj->create();
            }
        }
    }

References getDatatypeId(), getId(), getProperty(), getValidFieldProperties(), ilDclDatatype\INPUTFORMAT_REFERENCE, and PROP_REFERENCE.

Referenced by cloneStructure().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneStructure()

ilDclBaseFieldModel::cloneStructure ( int $original_id )

Exceptions

ilException

Definition at line 594 of file class.ilDclBaseFieldModel.php.

                                                    : void
    {
        $original = ilDclCache::getFieldCache($original_id);
        $this->setTitle($original->getTitle());
        $this->setDatatypeId($original->getDatatypeId());
        $this->setDescription($original->getDescription());
        $this->setOrder($original->getOrder());
        $this->setUnique($original->isUnique());
        $this->setExportable($original->getExportable());
        $this->doCreate();
        $this->cloneProperties($original);
 
        // mandatory for all cloning functions
        ilDclCache::setCloneOf($original_id, $this->getId(), ilDclCache::TYPE_FIELD);
    }

References cloneProperties(), doCreate(), ilDclCache\getFieldCache(), getId(), ilDclCache\setCloneOf(), setDatatypeId(), setDescription(), setExportable(), setOrder(), setTitle(), setUnique(), and ilDclCache\TYPE_FIELD.

Here is the call graph for this function:

◆ doCreate()

ilDclBaseFieldModel::doCreate ( )

Reimplemented in ilDclStandardField.

Definition at line 329 of file class.ilDclBaseFieldModel.php.

                              : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if (!ilDclTable::_tableExists($this->getTableId())) {
            throw new ilException("The field does not have a related table!");
        }
 
        $id = $ilDB->nextId("il_dcl_field");
        $this->setId($id);
        $query = "INSERT INTO il_dcl_field (" . "id" . ", table_id" . ", datatype_id" . ", title" . ", description" . ", is_unique"
            . " ) VALUES (" . $ilDB->quote($this->getId(), "integer") . "," . $ilDB->quote(
                $this->getTableId(),
                "integer"
            ) . ","
            . $ilDB->quote($this->getDatatypeId(), "integer") . "," . $ilDB->quote($this->getTitle(), "text") . ","
            . $ilDB->quote($this->getDescription(), "text") . "," . $ilDB->quote($this->isUnique(), "integer") . ")";
        $ilDB->manipulate($query);
 
        $this->updateTableFieldSetting();
 
        $this->addToTableViews();
    }

References $DIC, $id, $ilDB, $query, ilDclTable\_tableExists(), addToTableViews(), getDatatypeId(), getDescription(), getId(), getTableId(), getTitle(), isUnique(), setId(), and updateTableFieldSetting().

Referenced by cloneStructure().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ doDelete()

ilDclBaseFieldModel::doDelete ( )

Remove field and properties.

Reimplemented in ilDclSelectionFieldModel.

Definition at line 428 of file class.ilDclBaseFieldModel.php.

                              : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        // delete tablefield setting.
        ilDclTableFieldSetting::getInstance($this->getTableId(), $this->getId())->delete();
 
        $query = "DELETE FROM il_dcl_field_prop WHERE field_id = " . $ilDB->quote($this->getId(), "text");
        $ilDB->manipulate($query);
 
        $query = "DELETE FROM il_dcl_field WHERE id = " . $ilDB->quote($this->getId(), "text");
        $ilDB->manipulate($query);
 
        foreach ($this->getViewSettings() as $field_setting) {
            $field_setting->delete();
        }
    }

References $DIC, $ilDB, $query, getId(), ilDclTableFieldSetting\getInstance(), getTableId(), and getViewSettings().

Here is the call graph for this function:

◆ doRead()

ilDclBaseFieldModel::doRead ( )

Reimplemented in ilDclStandardField.

Definition at line 293 of file class.ilDclBaseFieldModel.php.

                            : void
    {
        //THEN 1 ELSE 0 END AS has_options FROM il_dcl_field f WHERE id = ".$ilDB->quote($this->getId(),"integer");
        $query = "SELECT * FROM il_dcl_field WHERE id = " . $this->db->quote($this->getId(), "integer");
        $set = $this->db->query($query);
        $rec = $this->db->fetchAssoc($set);
 
        if ($rec) {
            $this->setTableId($rec["table_id"]);
            if (null !== $rec["title"]) {
                $this->setTitle($rec["title"]);
            }
            if (null !== $rec["description"]) {
                $this->setDescription($rec["description"]);
            }
            $this->setDatatypeId($rec["datatype_id"]);
            $this->setUnique($rec["is_unique"]);
        }
 
        $this->loadProperties();
        $this->loadTableFieldSetting();
    }

References $query, getId(), loadProperties(), loadTableFieldSetting(), setDatatypeId(), setDescription(), setTableId(), setTitle(), and setUnique().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ doUpdate()

ilDclBaseFieldModel::doUpdate ( )

Reimplemented in ilDclStandardField.

Definition at line 364 of file class.ilDclBaseFieldModel.php.

                              : void
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $ilDB->update(
            "il_dcl_field",
            array(
                "table_id" => array(
                    "integer",
                    $this->getTableId(),
                ),
                "datatype_id" => array(
                    "text",
                    $this->getDatatypeId(),
                ),
                "title" => array(
                    "text",
                    $this->getTitle(),
                ),
                "description" => array(
                    "text",
                    $this->getDescription(),
                ),
                "is_unique" => array(
                    "integer",
                    $this->isUnique(),
                ),
            ),
            array(
                "id" => array(
                    "integer",
                    $this->getId(),
                ),
            )
        );
        $this->updateTableFieldSetting();
        $this->updateProperties();
    }

References $DIC, $ilDB, getDatatypeId(), getDescription(), getId(), getTableId(), getTitle(), isUnique(), updateProperties(), and updateTableFieldSetting().

Here is the call graph for this function:

◆ fillHeaderExcel()

ilDclBaseFieldModel::fillHeaderExcel	(	ilExcel	$worksheet,
		int &	$row,
		int &	$col
	)

Reimplemented in ilDclStandardField, and ilDclTextFieldModel.

Definition at line 735 of file class.ilDclBaseFieldModel.php.

                                                                             : void
    {
        $worksheet->setCell($row, $col, $this->getTitle());
        $col++;
    }

References ilExcel\setCell().

Here is the call graph for this function:

◆ fillPropertiesForm()

ilDclBaseFieldModel::fillPropertiesForm ( ilPropertyFormGUI & $form )

called to fill the 'edit field' form

Reimplemented in ilDclSelectionFieldModel.

Definition at line 773 of file class.ilDclBaseFieldModel.php.

                                                                : bool
    {
        $values = array(
            'table_id' => $this->getTableId(),
            'field_id' => $this->getId(),
            'title' => $this->getTitle(),
            'datatype' => $this->getDatatypeId(),
            'description' => $this->getDescription(),
            'unique' => $this->isUnique(),
        );
 
        $properties = $this->getValidFieldProperties();
        foreach ($properties as $prop) {
            $values['prop_' . $prop] = $this->getProperty($prop);
        }
 
        $form->setValuesByArray($values);
 
        return true;
    }

References ILIAS\Survey\Mode\getId(), and ilPropertyFormGUI\setValuesByArray().

Here is the call graph for this function:

◆ getConfirmationGUI()

ilDclBaseFieldModel::getConfirmationGUI ( ilPropertyFormGUI $form )

called by ilDclFieldEditGUI if isConfirmationRequired returns true

Reimplemented in ilDclSelectionFieldModel.

Definition at line 806 of file class.ilDclBaseFieldModel.php.

                                                               : ilConfirmationGUI
    {
        global $DIC;
        $ilConfirmationGUI = new ilConfirmationGUI();
        $ilConfirmationGUI->setFormAction($form->getFormAction());
        $ilConfirmationGUI->addHiddenItem('confirmed', 1);
        $ilConfirmationGUI->addHiddenItem('field_id', $form->getInput('field_id'));
        $ilConfirmationGUI->addHiddenItem('title', $form->getInput('title'));
        $ilConfirmationGUI->addHiddenItem('description', $form->getInput('description'));
        $ilConfirmationGUI->addHiddenItem('datatype', $form->getInput('datatype'));
        $ilConfirmationGUI->addHiddenItem('unique', $form->getInput('unique'));
        $ilConfirmationGUI->setConfirm($DIC->language()->txt('dcl_update_field'), 'update');
        $ilConfirmationGUI->setCancel($DIC->language()->txt('cancel'), 'edit');
 
        return $ilConfirmationGUI;
    }

References $DIC, ilFormGUI\getFormAction(), and ilPropertyFormGUI\getInput().

Here is the call graph for this function:

◆ getDatatype()

ilDclBaseFieldModel::getDatatype ( )

Definition at line 204 of file class.ilDclBaseFieldModel.php.

                                 : ilDclDatatype
    {
        $this->loadDatatype();
 
        return $this->datatype;
    }

References $datatype, and loadDatatype().

Referenced by ilDclFieldFactory\getClassPathByInstance(), ilDclFieldFactory\getFieldTypeByInstance(), ilDclPluginFieldModel\getPresentationDescription(), and ilDclPluginFieldModel\getPresentationTitle().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDatatypeId()

ilDclBaseFieldModel::getDatatypeId ( )

Get datatype_id.

Definition at line 185 of file class.ilDclBaseFieldModel.php.

                                   : int
    {
        if ($this->isStandardField()) {
            return ilDclStandardField::_getDatatypeForId($this->getId());
        }
 
        return $this->datatypeId;
    }

References $datatypeId, ilDclStandardField\_getDatatypeForId(), getId(), and isStandardField().

Referenced by ilDclCopyFieldRepresentation\buildFieldCreationInput(), ilDclReferenceFieldRepresentation\buildFieldCreationInput(), ilDclContentImporter\checkImportType(), cloneProperties(), doCreate(), doUpdate(), and ilDclFieldListTableGUI\fillRowFromObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDatatypeTitle()

ilDclBaseFieldModel::getDatatypeTitle ( )

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

                                      : string
    {
        $this->loadDatatype();
        return $this->datatype->getTitle();
    }

References loadDatatype().

Referenced by getPresentationDescription(), and getPresentationTitle().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDescription()

ilDclBaseFieldModel::getDescription ( )

Get description.

Definition at line 167 of file class.ilDclBaseFieldModel.php.

                                    : string
    {
        return $this->description;
    }

References $description.

Referenced by doCreate(), doUpdate(), ilDclFieldListTableGUI\fillRowFromObject(), and ilDclBaseFieldRepresentation\setupInputField().

Here is the caller graph for this function:

◆ getExportable()

ilDclBaseFieldModel::getExportable ( )

Returns: bool

Definition at line 264 of file class.ilDclBaseFieldModel.php.

                                   : bool
    {
        if (!isset($this->exportable)) {
            $this->loadExportability();
        }
 
        return $this->exportable;
    }

References $exportable, and loadExportability().

Referenced by ilDclStandardField\clone(), and ilDclFieldListTableGUI\fillRowFromObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getId()

ilDclBaseFieldModel::getId ( )

Get field id.

Definition at line 115 of file class.ilDclBaseFieldModel.php.

                           : string
    {
        return $this->id;
    }

References $id.

Referenced by ilDclTable\addField(), ilDclCopyFieldRepresentation\buildFieldCreationInput(), ilDclReferenceFieldRepresentation\buildFieldCreationInput(), checkValidityFromForm(), cloneProperties(), ilDclSelectionFieldModel\cloneProperties(), cloneStructure(), doCreate(), doDelete(), doRead(), doUpdate(), ilDclFieldListTableGUI\fillRowFromObject(), ilDclFieldFactory\getClassPathByInstance(), getDatatypeId(), ilDclFieldFactory\getFieldModelInstanceByClass(), ilDclCache\getFieldRepresentation(), ilDclFieldFactory\getFieldRepresentationInstance(), ilDclBaseRecordModel\getRecordFieldValueFromExcel(), ilDclReferenceRecordFieldModel\getReferenceFromValue(), getViewSetting(), getViewSettings(), ilDclTableEditGUI\initForm(), loadProperties(), loadTableFieldSetting(), setProperty(), ilDclBaseRecordModel\setStandardFieldValueFromExcel(), and updateTableFieldSetting().

Here is the caller graph for this function:

◆ getOrder()

ilDclBaseFieldModel::getOrder ( )

Definition at line 461 of file class.ilDclBaseFieldModel.php.

                              : int
    {
        if ($this->order == null) {
            $this->loadTableFieldSetting();
        }
 
        return !$this->order ? 0 : $this->order;
    }

References $order, and loadTableFieldSetting().

Referenced by ilDclStandardField\clone(), and updateTableFieldSetting().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPresentationDescription()

ilDclBaseFieldModel::getPresentationDescription ( )

Reimplemented in ilDclCopyFieldModel, and ilDclPluginFieldModel.

Definition at line 222 of file class.ilDclBaseFieldModel.php.

                                                : string
    {
        return $this->lng->txt('dcl_' . $this->getDatatypeTitle() . '_desc');
    }

References getDatatypeTitle(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ getPresentationTitle()

ilDclBaseFieldModel::getPresentationTitle ( )

Reimplemented in ilDclCopyFieldModel, and ilDclPluginFieldModel.

Definition at line 217 of file class.ilDclBaseFieldModel.php.

                                          : string
    {
        return $this->lng->txt('dcl_' . $this->getDatatypeTitle());
    }

References getDatatypeTitle(), and ILIAS\Repository\lng().

Referenced by ilDclFieldListTableGUI\fillRowFromObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getProperty()

ilDclBaseFieldModel::getProperty ( string $key )

Returns a certain property of a field.

Returns: ?mixed

Reimplemented in ilDclSelectionFieldModel.

Definition at line 497 of file class.ilDclBaseFieldModel.php.

    {
        $instance = $this->getPropertyInstance($key);
 
        return ($instance !== null) ? $instance->getValue() : null;
    }

References getPropertyInstance().

Referenced by cloneProperties(), and ilDclMobRecordFieldModel\parseValue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPropertyInstance()

ilDclBaseFieldModel::getPropertyInstance ( string $key )

Return ActiveRecord of property.

Returns: ?ilDclFieldProperty

Definition at line 508 of file class.ilDclBaseFieldModel.php.

    {
        $this->loadProperties();
        if ($this->hasProperty($key)) {
            $value = $this->property[$key];
 
            return $value;
        }
 
        return null;
    }

References ILIAS\LTI\ToolProvider\$key, hasProperty(), and loadProperties().

Referenced by getProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRecordQueryFilterObject()

ilDclBaseFieldModel::getRecordQueryFilterObject	(		$filter_value = `""`,
		?ilDclBaseFieldModel	$sort_field = `null`
	)

Returns a query-object for building the record-loader-sql-query.

Parameters

string | int $filter_value

Reimplemented in ilDclStandardField, ilDclBooleanFieldModel, ilDclCopyFieldModel, ilDclDatetimeFieldModel, ilDclFileuploadFieldModel, ilDclIliasReferenceFieldModel, ilDclNumberFieldModel, ilDclRatingFieldModel, ilDclReferenceFieldModel, ilDclSelectionFieldModel, and ilDclTextFieldModel.

Definition at line 682 of file class.ilDclBaseFieldModel.php.

     : ?ilDclRecordQueryObject {
        return null;
    }

◆ getRecordQuerySortObject()

ilDclBaseFieldModel::getRecordQuerySortObject	(	string	$direction = `"asc"`,
		bool	$sort_by_status = `false`
	)

Returns a query-object for building the record-loader-sql-query.

Parameters

bool $sort_by_status The specific sort object is a status field

Reimplemented in ilDclStandardField, ilDclFileuploadFieldModel, ilDclFormulaFieldModel, ilDclIliasReferenceFieldModel, ilDclRatingFieldModel, ilDclReferenceFieldModel, ilDclSelectionFieldModel, and ilDclTextFieldModel.

Definition at line 656 of file class.ilDclBaseFieldModel.php.

     : ?ilDclRecordQueryObject {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $sql_obj = new ilDclRecordQueryObject();
 
        $select_str = "sort_stloc_{$this->getId()}.value AS field_{$this->getId()}";
        $join_str
            = "LEFT JOIN il_dcl_record_field AS sort_record_field_{$this->getId()} ON (sort_record_field_{$this->getId()}.record_id = record.id AND sort_record_field_{$this->getId()}.field_id = "
            . $ilDB->quote($this->getId(), 'integer') . ") ";
        $join_str .= "LEFT JOIN il_dcl_stloc{$this->getStorageLocation()}_value AS sort_stloc_{$this->getId()} ON (sort_stloc_{$this->getId()}.record_field_id = sort_record_field_{$this->getId()}.id)";
 
        $sql_obj->setSelectStatement($select_str);
        $sql_obj->setJoinStatement($join_str);
        $sql_obj->setOrderStatement("field_{$this->getId()} {$direction}, ID ASC");
 
        return $sql_obj;
    }

Referenced by ilDclTableEditGUI\initForm().

Here is the caller graph for this function:

◆ getSortField()

ilDclBaseFieldModel::getSortField ( )

Returns the sort-field id.

Reimplemented in ilDclStandardField.

Definition at line 692 of file class.ilDclBaseFieldModel.php.

                                  : string
    {
        return $this->getTitle();
    }

◆ getStorageLocation()

ilDclBaseFieldModel::getStorageLocation ( )

Get storage location for the model.

Definition at line 230 of file class.ilDclBaseFieldModel.php.

                                        : ?int
    {
        if ($this->getStorageLocationOverride() !== null) {
            return $this->getStorageLocationOverride();
        }
 
        $this->loadDatatype();
 
        return $this->datatype->getStorageLocation();
    }

References getStorageLocationOverride(), and loadDatatype().

Here is the call graph for this function:

◆ getStorageLocationOverride()

ilDclBaseFieldModel::getStorageLocationOverride ( )

Deprecated:

Definition at line 722 of file class.ilDclBaseFieldModel.php.

                                                : ?int
    {
        return $this->storage_location_override;
    }

Referenced by getStorageLocation().

Here is the caller graph for this function:

◆ getTableId()

ilDclBaseFieldModel::getTableId ( )

Get table id.

Definition at line 131 of file class.ilDclBaseFieldModel.php.

                                : int
    {
        return $this->table_id;
    }

References $table_id.

Referenced by checkValidity(), doCreate(), doDelete(), doUpdate(), ilDclReferenceRecordFieldModel\getReferenceFromValue(), loadTableFieldSetting(), and updateTableFieldSetting().

Here is the caller graph for this function:

◆ getTitle()

ilDclBaseFieldModel::getTitle ( )

Get title.

Definition at line 151 of file class.ilDclBaseFieldModel.php.

                              : string
    {
        return $this->title;
    }

References $title.

Referenced by ilDclCopyFieldRepresentation\buildFieldCreationInput(), ilDclReferenceFieldRepresentation\buildFieldCreationInput(), ilDclContentImporter\checkImportType(), doCreate(), doUpdate(), ilDclFieldListTableGUI\fillRowFromObject(), ilDclPluginFieldModel\getPresentationDescription(), ilDclPluginFieldModel\getPresentationTitle(), and ilDclTableEditGUI\initForm().

Here is the caller graph for this function:

◆ getValidFieldProperties()

ilDclBaseFieldModel::getValidFieldProperties ( )

Returns all valid properties for a field-type.

Reimplemented in ilDclCopyFieldModel, ilDclFileuploadFieldModel, ilDclFormulaFieldModel, ilDclIliasReferenceFieldModel, ilDclMobFieldModel, ilDclPluginFieldModel, ilDclReferenceFieldModel, ilDclSelectionFieldModel, and ilDclTextFieldModel.

Definition at line 544 of file class.ilDclBaseFieldModel.php.

                                             : array
    {
        return [];
    }

Referenced by cloneProperties().

Here is the caller graph for this function:

◆ getViewSetting()

ilDclBaseFieldModel::getViewSetting ( int $tableview_id )

Definition at line 455 of file class.ilDclBaseFieldModel.php.

                                                     : ilDclTableViewFieldSetting
    {
        ilDclTableViewFieldSetting::getTableViewFieldSetting($this->getId(), $tableview_id);
        return ilDclTableViewFieldSetting::getTableViewFieldSetting($this->getId(), $tableview_id);
    }

References getId(), and ilDclTableViewFieldSetting\getTableViewFieldSetting().

Here is the call graph for this function:

◆ getViewSettings()

ilDclBaseFieldModel::getViewSettings ( )

Returns: ilDclTableViewFieldSetting[]

Definition at line 450 of file class.ilDclBaseFieldModel.php.

                                     : array
    {
        return ilDclTableViewFieldSetting::where(array('field' => $this->getId()))->get();
    }

References getId(), and ActiveRecord\where().

Referenced by doDelete().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasNumericSorting()

ilDclBaseFieldModel::hasNumericSorting ( )

Set to true, when the sorting should be handled numerical.

Reimplemented in ilDclStandardField, and ilDclNumberFieldModel.

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

                                       : bool
    {
        if ($this->getDatatypeId() == ilDclDatatype::INPUTFORMAT_NUMBER) {
            return true;
        }
 
        return false;
    }

References ilDclDatatype\INPUTFORMAT_NUMBER.

◆ hasProperty()

ilDclBaseFieldModel::hasProperty ( string $key )

Checks if a certain property for a field is set.

Definition at line 486 of file class.ilDclBaseFieldModel.php.

                                            : bool
    {
        $this->loadProperties();
 
        return (isset($this->property[$key]) && $this->property[$key]->getValue() != null);
    }

References ILIAS\LTI\ToolProvider\$key, ILIAS\UI\Implementation\Component\Input\getValue(), and loadProperties().

Referenced by getPropertyInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isConfirmationRequired()

ilDclBaseFieldModel::isConfirmationRequired ( ilPropertyFormGUI $form )

called by ilDclFieldEditGUI when updating field properties if you overwrite this method, remember to also overwrite getConfirmationGUI

Reimplemented in ilDclSelectionFieldModel.

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

                                                                   : bool
    {
        return false;
    }

◆ isStandardField()

ilDclBaseFieldModel::isStandardField ( )

Reimplemented in ilDclStandardField.

Definition at line 288 of file class.ilDclBaseFieldModel.php.

                                     : bool
    {
        return false;
    }

Referenced by ilDclFieldListTableGUI\fillRowFromObject(), and getDatatypeId().

Here is the caller graph for this function:

◆ isUnique()

ilDclBaseFieldModel::isUnique ( )

Reimplemented in ilDclStandardField.

Definition at line 194 of file class.ilDclBaseFieldModel.php.

                              : bool
    {
        return $this->unique;
    }

References $unique.

Referenced by checkValidity(), doCreate(), doUpdate(), and ilDclFieldListTableGUI\fillRowFromObject().

Here is the caller graph for this function:

◆ loadDatatype()

ilDclBaseFieldModel::loadDatatype ( )

protected

Load datatype for model.

Definition at line 244 of file class.ilDclBaseFieldModel.php.

                                     : void
    {
        if ($this->datatype == null) {
            $this->datatype = ilDclCache::getDatatype($this->datatypeId);
        }
    }

References ilDclCache\getDatatype().

Referenced by getDatatype(), getDatatypeTitle(), and getStorageLocation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadExportability()

ilDclBaseFieldModel::loadExportability ( )

private

Load exportability.

Definition at line 276 of file class.ilDclBaseFieldModel.php.

                                        : void
    {
        if ($this->exportable == null) {
            $this->loadTableFieldSetting();
        }
    }

References loadTableFieldSetting().

Referenced by getExportable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadProperties()

ilDclBaseFieldModel::loadProperties ( )

protected

Get all properties of a field.

Definition at line 478 of file class.ilDclBaseFieldModel.php.

                                       : void
    {
        $this->property = ilDclCache::getFieldProperties($this->getId());
    }

References ilDclCache\getFieldProperties(), and getId().

Referenced by doRead(), getPropertyInstance(), hasProperty(), and setProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadTableFieldSetting()

ilDclBaseFieldModel::loadTableFieldSetting ( )

protected

loadTableFieldSetting

Definition at line 254 of file class.ilDclBaseFieldModel.php.

                                              : void
    {
        $tablefield_setting = ilDclTableFieldSetting::getInstance($this->getTableId(), $this->getId());
        $this->exportable = $tablefield_setting->isExportable();
        $this->order = $tablefield_setting->getFieldOrder();
    }

References getId(), ilDclTableFieldSetting\getInstance(), and getTableId().

Referenced by doRead(), getOrder(), and loadExportability().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ normalizeValue()

ilDclBaseFieldModel::normalizeValue ( $value )

protected

Parameters

mixed $value

Definition at line 582 of file class.ilDclBaseFieldModel.php.

    {
        if (is_string($value)) {
            $value = trim(preg_replace("/\\s+/uism", " ", $value));
        }
 
        return $value;
    }

Referenced by checkValidity().

Here is the caller graph for this function:

◆ setDatatypeId()

ilDclBaseFieldModel::setDatatypeId ( int $a_id )

Set datatype id.

Definition at line 175 of file class.ilDclBaseFieldModel.php.

                                            : void
    {
        //unset the cached datatype.
        $this->datatype = null;
        $this->datatypeId = $a_id;
    }

Referenced by buildFromDBRecord(), cloneStructure(), and doRead().

Here is the caller graph for this function:

◆ setDescription()

ilDclBaseFieldModel::setDescription ( string $a_desc )

Set description.

Definition at line 159 of file class.ilDclBaseFieldModel.php.

                                                  : void
    {
        $this->description = $a_desc;
    }

Referenced by buildFromDBRecord(), cloneStructure(), and doRead().

Here is the caller graph for this function:

◆ setExportable()

ilDclBaseFieldModel::setExportable ( bool $exportable )

Definition at line 642 of file class.ilDclBaseFieldModel.php.

                                                   : void
    {
        $this->exportable = $exportable;
    }

References $exportable.

Referenced by ilDclStandardField\clone(), and cloneStructure().

Here is the caller graph for this function:

◆ setId()

ilDclBaseFieldModel::setId ( $a_id )

Set field id.

Parameters

int|string

Definition at line 107 of file class.ilDclBaseFieldModel.php.

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

Referenced by buildFromDBRecord(), and doCreate().

Here is the caller graph for this function:

◆ setOrder()

ilDclBaseFieldModel::setOrder ( string $order )

Definition at line 470 of file class.ilDclBaseFieldModel.php.

                                           : void
    {
        $this->order = $order;
    }

References $order.

Referenced by ilDclStandardField\clone(), and cloneStructure().

Here is the caller graph for this function:

◆ setProperty()

ilDclBaseFieldModel::setProperty	(	string	$key,
			$value
	)

Set a property for a field (does not save)

Parameters

string | array | int $value

Reimplemented in ilDclSelectionFieldModel.

Definition at line 524 of file class.ilDclBaseFieldModel.php.

                                                    : ?ilDclFieldProperty
    {
        $this->loadProperties();
        if (isset($this->property[$key])) {
            $this->property[$key]->setValue($value);
        } else {
            $property = new ilDclFieldProperty();
            $property->setName($key);
            $property->setFieldId($this->getId());
            $property->setValue($value);
 
            $this->property[$key] = $property;
        }
 
        return $this->property[$key];
    }

References ILIAS\LTI\ToolProvider\$key, $property, getId(), and loadProperties().

Here is the call graph for this function:

◆ setStorageLocationOverride()

ilDclBaseFieldModel::setStorageLocationOverride ( ?int $storage_location_override )

Deprecated:: override ilDclFieldTypePlugin::getStorageLocation() instead

Definition at line 730 of file class.ilDclBaseFieldModel.php.

                                                                               : void
    {
        $this->storage_location_override = $storage_location_override;
    }

◆ setTableId()

ilDclBaseFieldModel::setTableId ( int $a_id )

Set table id.

Definition at line 123 of file class.ilDclBaseFieldModel.php.

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

Referenced by buildFromDBRecord(), and doRead().

Here is the caller graph for this function:

◆ setTitle()

ilDclBaseFieldModel::setTitle ( string $a_title )

Set title.

Definition at line 139 of file class.ilDclBaseFieldModel.php.

                                             : void
    {
        //title cannot begin with _ as this is saved for other purposes. make __ instead.
        if (substr($a_title, 0, 1) == "_" && substr($a_title, 0, 2) != "__") {
            $a_title = "_" . $a_title;
        }
        $this->title = $a_title;
    }

Referenced by buildFromDBRecord(), cloneStructure(), and doRead().

Here is the caller graph for this function:

◆ setUnique()

ilDclBaseFieldModel::setUnique ( ?bool $unique )

Definition at line 199 of file class.ilDclBaseFieldModel.php.

                                            : void
    {
        $this->unique = $unique ? 1 : 0;
    }

References $unique.

Referenced by buildFromDBRecord(), ilDclStandardField\clone(), cloneStructure(), and doRead().

Here is the caller graph for this function:

◆ storePropertiesFromForm()

ilDclBaseFieldModel::storePropertiesFromForm ( ilPropertyFormGUI $form )

called when saving the 'edit field' form

Reimplemented in ilDclSelectionFieldModel.

Definition at line 756 of file class.ilDclBaseFieldModel.php.

                                                                    : void
    {
        $field_props = $this->getValidFieldProperties();
        foreach ($field_props as $property) {
            $representation = ilDclFieldFactory::getFieldRepresentationInstance($this);
            $value = $form->getInput($representation->getPropertyInputFieldId($property));
 
            // save non empty values and set them to null, when they already exist. Do not override plugin-hook when already set.
            if (!empty($value) || ($this->getPropertyInstance($property) != null && $property != self::PROP_PLUGIN_HOOK_NAME)) {
                $this->setProperty($property, $value)->store();
            }
        }
    }

References ilDclFieldFactory\getFieldRepresentationInstance(), and ilPropertyFormGUI\getInput().

Here is the call graph for this function:

◆ toArray()

ilDclBaseFieldModel::toArray ( )

Definition at line 283 of file class.ilDclBaseFieldModel.php.

                             : array
    {
        return (array) $this;
    }

◆ updateProperties()

ilDclBaseFieldModel::updateProperties ( )

Update properties of this field in Database.

Definition at line 407 of file class.ilDclBaseFieldModel.php.

                                      : void
    {
        foreach ($this->property as $prop) {
            $prop->store();
        }
    }

Referenced by doUpdate().

Here is the caller graph for this function:

◆ updateTableFieldSetting()

ilDclBaseFieldModel::updateTableFieldSetting ( )

protected

update exportable and fieldorder

Definition at line 417 of file class.ilDclBaseFieldModel.php.

                                                : void
    {
        $tablefield_setting = ilDclTableFieldSetting::getInstance($this->getTableId(), $this->getId());
        $tablefield_setting->setExportable($this->exportable);
        $tablefield_setting->setFieldOrder($this->getOrder());
        $tablefield_setting->store();
    }