ilAdvancedMDFieldDefinition Class Reference

AMD field abstract base class. More...

Inheritance diagram for ilAdvancedMDFieldDefinition:

Collaboration diagram for ilAdvancedMDFieldDefinition:

Public Member Functions
	__construct (?int $a_field_id=null, string $language='')
	getType ()
	Get type. More...
	useDefaultLanguageMode (string $language)
	Check if default language mode has to be used: no language given or language equals default language. More...
	getTypeTitle ()
	getADTDefinition ()
	Get ADT definition instance. More...
	getADT ()
	getFieldId ()
	Get field_id. More...
	setRecordId (int $a_id)
	Set record id. More...
	getRecordId ()
	Get record id. More...
	setImportId (string $a_id_string)
	Set import id. More...
	getImportId ()
	Get import id. More...
	setPosition (int $a_pos)
	Set position. More...
	getPosition ()
	Get position. More...
	setTitle (string $a_title)
	Get title. More...
	getTitle ()
	Get title. More...
	setDescription (string $a_desc)
	Set description. More...
	getDescription ()
	Get description. More...
	isSearchSupported ()
	Is search supported at all. More...
	isFilterSupported ()
	Is search by filter supported. More...
	setSearchable (bool $a_status)
	Toggle searchable. More...
	isSearchable ()
	Is searchable. More...
	setRequired (bool $a_status)
	Toggle required. More...
	isRequired ()
	Is required field. More...
	getFieldDefinitionForTableGUI (string $content_language)
	Parse properties for table gui. More...
	addToFieldDefinitionForm (ilPropertyFormGUI $a_form, ilAdvancedMDPermissionHelper $a_permissions, string $language='')
	Add input elements to definition form. More...
	importCustomDefinitionFormPostValues (ilPropertyFormGUI $a_form, string $language='')
	Import custom post values from definition form. More...
	importDefinitionFormPostValues (ilPropertyFormGUI $a_form, ilAdvancedMDPermissionHelper $a_permissions, string $active_language)
	Import post values from definition form. More...
	importDefinitionFormPostValuesNeedsConfirmation ()
	prepareCustomDefinitionFormConfirmation (ilPropertyFormGUI $a_form)
	prepareDefinitionFormConfirmation (ilPropertyFormGUI $a_form)
	generateImportId (int $a_field_id)
	Generate unique record id. More...
	save (bool $a_keep_pos=false)
	Create new field entry. More...
	update ()
	Update field entry. More...
	delete ()
	Delete field entry. More...
	toXML (ilXmlWriter $a_writer)
	To Xml. More...
	importXMLProperty (string $a_key, string $a_value)
	Import property from XML. More...
	getValueForXML (ilADT $element)
	Parse ADT value for xml (export) More...
	importValueFromXML (string $a_cdata)
	Import value from xml. More...
	importFromECS (string $a_ecs_type, $a_value, string $a_sub_id)
	Import meta data from ECS. More...
	prepareElementForEditor (ilADTFormBridge $a_bridge)
	Prepare editor form elements. More...
	getSearchQueryParserValue (ilADTSearchBridge $a_adt_search)
	Get value for search query parser. More...
	getSearchValueSerialized (ilADTSearchBridge $a_adt_search)
	setSearchValueSerialized (ilADTSearchBridge $a_adt_search, $a_value)
	Set value from search persistence. More...
	searchSubObjects (ilADTSearchBridge $a_adt_search, int $a_obj_id, string $sub_obj_type)
	searchObjects (ilADTSearchBridge $a_adt_search, ilQueryParser $a_parser, array $a_object_types, string $a_locate, string $a_search_type)
	Search objects. More...
	getLuceneSearchString ($a_value)
	Get search string in lucene syntax. More...
	prepareElementForSearch (ilADTSearchBridge $a_bridge)
	Prepare search form elements. More...
	_clone (int $a_new_record_id)
	Clone field definition. More...
	hasComplexOptions ()
	getComplexOptionsOverview (object $a_parent_gui, string $parent_cmd)

Static Public Member Functions
static	getInstance (?int $a_field_id, ?int $a_type=null, string $language='')
static	exists (int $a_field_id)
static	getInstanceByTypeString (string $a_type)
	Get instance by type string (used by import) More...
static	getInstancesByRecordId ( $a_record_id, $a_only_searchable=false, string $language='')
	Get definitions by record id. More...
static	getInstancesByObjType ($a_obj_type, $a_active_only=true)
static	getInstanceByImportId (string $a_import_id)
static	getSearchableDefinitionIds ()
	Get searchable definition ids (performance is key) More...
static	getADTGroupForDefinitions (array $a_defs)
	Init ADTGroup for definitions. More...
static	getValidTypes ()
	Get all valid types. More...
static	isValidType (int $a_type)

Data Fields
const	TYPE_SELECT = 1
const	TYPE_TEXT = 2
const	TYPE_DATE = 3
const	TYPE_DATETIME = 4
const	TYPE_INTEGER = 5
const	TYPE_FLOAT = 6
const	TYPE_LOCATION = 7
const	TYPE_SELECT_MULTI = 8
const	TYPE_ADDRESS = 99
const	TYPE_EXTERNAL_LINK = 9
const	TYPE_INTERNAL_LINK = 10

Protected Member Functions
	init ()
	initADTDefinition ()
	Init adt instance. More...
	setADT (ilADT $a_adt)
	Set ADT instance. More...
	setFieldId (int $a_id)
	Set field_id. More...
	importFieldDefinition (array $a_def)
	Import (type-specific) field definition from DB. More...
	getFieldDefinition ()
	Get (type-specific) field definition. More...
	addCustomFieldToDefinitionForm (ilPropertyFormGUI $a_form, bool $a_disabled=false, string $language='')
	Add custom input elements to definition form. More...
	getLastPosition ()
	Get last position of record. More...
	getDBProperties ()
	Get all definition properties for DB. More...
	import (array $a_data)
	Import from DB. More...
	read (?int $a_field_id)
	Read field definition. More...
	addPropertiesToXML (ilXmlWriter $a_writer)
	Add (type-specific) properties to xml export. More...
	parseSearchObjects (array $a_records, array $a_object_types)
	Add object-data needed for global search to AMD search results. More...

Static Protected Member Functions
static	getTypeString (int $a_type)
	Get type as string. More...

Protected Attributes
int	$field_id = null
int	$record_id = 0
string	$import_id = ''
int	$position = 0
string	$title = ''
string	$description = ''
bool	$searchable = false
bool	$required = false
ilADTDefinition	$adt_def = null
ilADT	$adt = null
string	$language = ''
ilDBInterface	$db
ilLanguage	$lng
ilLogger	$logger
GlobalHttpState	$http
RefineryFactory	$refinery

Detailed Description

AMD field abstract base class.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

$Id$

Definition at line 30 of file class.ilAdvancedMDFieldDefinition.php.

Constructor & Destructor Documentation

__construct()

ilAdvancedMDFieldDefinition::__construct	(	?int	$a_field_id = null,
		string	$language = ''
	)

@noinspection PhpUndefinedMethodInspection

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

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

    {
        global $DIC;
 
        $this->lng = $DIC->language();
        $this->language = $DIC->language()->getLangKey();
        $this->refinery = $DIC->refinery();
        $this->http = $DIC->http();
 
 
        if ($language) {
            $this->language = $language;
        }
        $this->logger = $DIC->logger()->amet();
        $this->db = $DIC->database();
 
        $this->init();
        $this->read($a_field_id);
    }

References $DIC, $language, ILIAS\FileDelivery\http(), init(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), read(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

Member Function Documentation

_clone()

ilAdvancedMDFieldDefinition::_clone

(

int

$a_new_record_id

)

Clone field definition.

Definition at line 1095 of file class.ilAdvancedMDFieldDefinition.php.

                                                : self
    {
        $class = get_class($this);
        $obj = new $class();
        $obj->setRecordId($a_new_record_id);
        $obj->setTitle($this->getTitle());
        $obj->setDescription($this->getDescription());
        $obj->setRequired($this->isRequired());
        $obj->setPosition($this->getPosition());
        $obj->setSearchable($this->isSearchable());
        $obj->importFieldDefinition($this->getFieldDefinition());
        $obj->save(true);
 
        return $obj;
    }

addCustomFieldToDefinitionForm()

ilAdvancedMDFieldDefinition::addCustomFieldToDefinitionForm ( ilPropertyFormGUI  $a_form, bool  $a_disabled = false, string  $language = ''  )

protected

Add custom input elements to definition form.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 570 of file class.ilAdvancedMDFieldDefinition.php.

     : void {
    }

addPropertiesToXML()

ilAdvancedMDFieldDefinition::addPropertiesToXML ( ilXmlWriter  $a_writer )

protected

Add (type-specific) properties to xml export.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 928 of file class.ilAdvancedMDFieldDefinition.php.

                                                                : void
    {
        // type-specific properties
    }

addToFieldDefinitionForm()

ilAdvancedMDFieldDefinition::addToFieldDefinitionForm	(	ilPropertyFormGUI	$a_form,
		ilAdvancedMDPermissionHelper	$a_permissions,
		string	$language = ''
	)

Add input elements to definition form.

Definition at line 580 of file class.ilAdvancedMDFieldDefinition.php.

     : void {
        global $DIC;
        $lng = $DIC['lng'];
 
        $perm = $a_permissions->hasPermissions(
            ilAdvancedMDPermissionHelper::CONTEXT_FIELD,
            (string) $this->getFieldId(),
            array(
                array(ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                      ilAdvancedMDPermissionHelper::SUBACTION_FIELD_TITLE
                )
                ,
                array(ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                      ilAdvancedMDPermissionHelper::SUBACTION_FIELD_DESCRIPTION
                )
                ,
                array(ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                      ilAdvancedMDPermissionHelper::SUBACTION_FIELD_SEARCHABLE
                )
                ,
                array(ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                      ilAdvancedMDPermissionHelper::SUBACTION_FIELD_PROPERTIES
                )
            )
        );
 
        // title
        $translations = ilAdvancedMDFieldTranslations::getInstanceByRecordId($this->getRecordId());
 
        $title = new ilTextInputGUI($lng->txt('title'), 'title');
        $title->setValue($this->getTitle());
        $title->setSize(20);
        $title->setMaxLength(70);
        $title->setRequired(true);
        if ($this->getFieldId()) {
            $translations->modifyTranslationInfoForTitle($this->getFieldId(), $a_form, $title, $language);
        } else {
            $title->setValue($this->getTitle());
        }
 
        $a_form->addItem($title);
 
        if (!$perm[ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilAdvancedMDPermissionHelper::SUBACTION_FIELD_TITLE]) {
            $title->setDisabled(true);
        }
 
        // desc
        $desc = new ilTextAreaInputGUI($lng->txt('description'), 'description');
        $desc->setValue($this->getDescription());
        $desc->setRows(3);
        $desc->setCols(50);
        if ($this->getFieldId()) {
            $translations->modifyTranslationInfoForDescription($this->getFieldId(), $a_form, $desc, $language);
        } else {
            $desc->setValue($this->getDescription());
        }
 
        $a_form->addItem($desc);
 
        if (!$perm[ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilAdvancedMDPermissionHelper::SUBACTION_FIELD_DESCRIPTION]) {
            $desc->setDisabled(true);
        }
 
        // searchable
        $check = new ilCheckboxInputGUI($lng->txt('md_adv_searchable'), 'searchable');
        $check->setChecked($this->isSearchable());
        $check->setValue("1");
        $a_form->addItem($check);
 
        if (!$perm[ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilAdvancedMDPermissionHelper::SUBACTION_FIELD_SEARCHABLE] ||
            !$this->isSearchSupported()) {
            $check->setDisabled(true);
        }
 
        /* required
        $check = new ilCheckboxInputGUI($lng->txt('md_adv_required'), 'required');
        $check->setChecked($this->isRequired());
        $check->setValue(1);
        $a_form->addItem($check);
        */
 
        $this->addCustomFieldToDefinitionForm(
            $a_form,
            !$perm[ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilAdvancedMDPermissionHelper::SUBACTION_FIELD_PROPERTIES],
            $language
        );
    }

Referenced by ilAdvancedMDSettingsGUI\initFieldForm().

Here is the caller graph for this function:

delete()

ilAdvancedMDFieldDefinition::delete

(

)

Delete field entry.

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 871 of file class.ilAdvancedMDFieldDefinition.php.

                            : void
    {
        if (!$this->getFieldId()) {
            return;
        }
 
        // delete all values
        ilAdvancedMDValues::_deleteByFieldId($this->getFieldId(), $this->getADT());
 
        $query = "DELETE FROM adv_mdf_definition" .
            " WHERE field_id = " . $this->db->quote($this->getFieldId(), "integer");
        $this->db->manipulate($query);
    }

References $query, and ilAdvancedMDValues\_deleteByFieldId().

Here is the call graph for this function:

exists()

static ilAdvancedMDFieldDefinition::exists ( int  $a_field_id )

static

Definition at line 108 of file class.ilAdvancedMDFieldDefinition.php.

                                                  : bool
    {
        global $DIC;
 
        $db = $DIC['ilDB'];
        $set = $db->query("SELECT field_type" .
            " FROM adv_mdf_definition" .
            " WHERE field_id = " . $db->quote($a_field_id, "integer"));
        if ($db->fetchAssoc($set)) {
            return true;
        }
        return false;
    }

References $DIC, ilDBInterface\fetchAssoc(), ilDBInterface\query(), and ilDBInterface\quote().

Referenced by ilContainerFilterFieldData\getFilterSetForRefId().

Here is the call graph for this function:

Here is the caller graph for this function:

generateImportId()

ilAdvancedMDFieldDefinition::generateImportId

(

int

$a_field_id

)

Generate unique record id.

Definition at line 754 of file class.ilAdvancedMDFieldDefinition.php.

                                                     : string
    {
        return 'il_' . IL_INST_ID . '_adv_md_field_' . $a_field_id;
    }

References IL_INST_ID.

getADT()

ilAdvancedMDFieldDefinition::getADT

(

)

Definition at line 368 of file class.ilAdvancedMDFieldDefinition.php.

                            : ilADT
    {
        if (!$this->adt instanceof ilADT) {
            $this->adt = ilADTFactory::getInstance()->getInstanceByDefinition($this->getADTDefinition());
        }
        return $this->adt;
    }

References ilADTFactory\getInstance().

Referenced by ilAdvancedMDFieldDefinitionDate\importValueFromXML(), ilAdvancedMDFieldDefinitionDateTime\importValueFromXML(), ilAdvancedMDFieldDefinitionExternalLink\importValueFromXML(), ilAdvancedMDFieldDefinitionInternalLink\importValueFromXML(), ilAdvancedMDFieldDefinitionLocation\importValueFromXML(), ilAdvancedMDFieldDefinitionSelectMulti\importValueFromXML(), and ilAdvancedMDFieldDefinitionInternalLink\searchObjects().

Here is the call graph for this function:

Here is the caller graph for this function:

getADTDefinition()

ilAdvancedMDFieldDefinition::getADTDefinition

(

)

Get ADT definition instance.

Returns

ilADTDefinition

Definition at line 360 of file class.ilAdvancedMDFieldDefinition.php.

                                      : ilADTDefinition
    {
        if (!$this->adt_def instanceof ilADTDefinition) {
            $this->adt_def = $this->initADTDefinition();
        }
        return $this->adt_def;
    }

Referenced by ilAdvancedMDFieldDefinitionText\getADTGroup().

Here is the caller graph for this function:

getADTGroupForDefinitions()

static ilAdvancedMDFieldDefinition::getADTGroupForDefinitions ( array  $a_defs )

static

Init ADTGroup for definitions.

Parameters

array<int,ilADTDefinition>

Returns

ilADTGroup

Todo:

check return type array<string, ilADTDefinition> or array<string, ilADTDefinition>

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

                                                                   : ilADT
    {
        $factory = ilADTFactory::getInstance();
        $group_def = $factory->getDefinitionInstanceByType("Group");
        foreach ($a_defs as $def) {
            $group_def->addElement($def->getFieldId(), $def->getADTDefinition());
        }
        $group = $factory->getInstanceByDefinition($group_def);
 
        // bind adt instances to definition
        foreach ($group->getElements() as $element_id => $element) {
            $a_defs[$element_id]->setADT($element);
        }
        return $group;
    }

References $factory, and ilADTFactory\getInstance().

Referenced by ilAdvancedMDValues\getADTGroup().

Here is the call graph for this function:

Here is the caller graph for this function:

getComplexOptionsOverview()

ilAdvancedMDFieldDefinition::getComplexOptionsOverview	(	object	$a_parent_gui,
		string	$parent_cmd
	)

Parameters

object	$a_parent_gui
string	$parent_cmd

Returns

null

Reimplemented in ilAdvancedMDFieldDefinitionGroupBased.

Definition at line 1124 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                       : ?string
    {
        return null;
    }

getDBProperties()

ilAdvancedMDFieldDefinition::getDBProperties ( )

protected

Get all definition properties for DB.

Definition at line 762 of file class.ilAdvancedMDFieldDefinition.php.

                                        : array
    {
        $fields = array(
            "field_type" => array("integer", $this->getType()),
            "record_id" => array("integer", $this->getRecordId()),
            "import_id" => array("text", $this->getImportId()),
            "title" => array("text", $this->getTitle()),
            "description" => array("text", $this->getDescription()),
            "position" => array("integer", $this->getPosition()),
            "searchable" => array("integer", $this->isSearchable()),
            "required" => array("integer", $this->isRequired())
        );
 
        $def = $this->getFieldDefinition();
        if (is_array($def)) {
            $fields["field_values"] = array("text", serialize($def));
        }
        return $fields;
    }

References ILIAS\LTI\ToolProvider\getRecordId().

Here is the call graph for this function:

getDescription()

ilAdvancedMDFieldDefinition::getDescription

(

)

Get description.

Definition at line 487 of file class.ilAdvancedMDFieldDefinition.php.

                                    : string
    {
        return $this->description;
    }

Referenced by ilAdvancedMDSettingsGUI\initFieldForm().

Here is the caller graph for this function:

getFieldDefinition()

ilAdvancedMDFieldDefinition::getFieldDefinition ( )

protected

Get (type-specific) field definition.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 554 of file class.ilAdvancedMDFieldDefinition.php.

                                           : array
    {
        return [];
    }

getFieldDefinitionForTableGUI()

ilAdvancedMDFieldDefinition::getFieldDefinitionForTableGUI

(

string

$content_language

)

Parse properties for table gui.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 562 of file class.ilAdvancedMDFieldDefinition.php.

                                                                           : array
    {
        return [];
    }

getFieldId()

ilAdvancedMDFieldDefinition::getFieldId

(

)

Get field_id.

Definition at line 398 of file class.ilAdvancedMDFieldDefinition.php.

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

Referenced by ilAdvancedMDSettingsGUI\initFieldForm(), and ilAdvancedMDFieldDefinitionInternalLink\searchObjects().

Here is the caller graph for this function:

getImportId()

ilAdvancedMDFieldDefinition::getImportId

(

)

Get import id.

Definition at line 433 of file class.ilAdvancedMDFieldDefinition.php.

                                 : string
    {
        return $this->import_id;
    }

getInstance()

static ilAdvancedMDFieldDefinition::getInstance ( ?int  $a_field_id, ?int  $a_type = null, string  $language = ''  )

static

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

     : ilAdvancedMDFieldDefinition {
        global $DIC;
 
        $db = $DIC->database();
 
        if (!$a_type) {
            $set = $db->query("SELECT field_type" .
                " FROM adv_mdf_definition" .
                " WHERE field_id = " . $db->quote($a_field_id, "integer"));
            $a_type = $db->fetchAssoc($set);
            $a_type = (int) $a_type["field_type"];
        }
 
        if (self::isValidType($a_type)) {
            $class = "ilAdvancedMDFieldDefinition" . self::getTypeString($a_type);
            return new $class($a_field_id, $language);
        }
        throw new ilException("unknown type " . $a_type);
    }

References $db, ilDBInterface\fetchAssoc(), ILIAS\Repository\int(), ilDBInterface\query(), and ilDBInterface\quote().

Referenced by ilAdvancedMDSettingsGUI\confirmDeleteFields(), ilAdvancedMDSettingsGUI\createField(), ilAdvancedMDSettingsGUI\deleteFields(), ilAdvancedMDSettingsGUI\editComplexOption(), ilAdvancedMDSettingsGUI\editField(), ilAdvancedMDSettingsGUI\editFields(), ilContainerFilterAdvMDAdapter\getAdvType(), ilLuceneAdvancedSearchFields\getFormElement(), ilContainerFilterAdvMDAdapter\getOptions(), ilContainerFilterAdvMDAdapter\getTitle(), ilLuceneAdvancedSearchFields\parseFieldQuery(), ilLuceneAdvancedSearchFields\readSections(), ilAdvancedMDSettingsGUI\saveField(), ilAdvancedSearchGUI\searchAdvancedMD(), ilAdvancedMDSettingsGUI\updateComplexOption(), and ilAdvancedMDSettingsGUI\updateField().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstanceByImportId()

static ilAdvancedMDFieldDefinition::getInstanceByImportId ( string  $a_import_id )

static

Definition at line 209 of file class.ilAdvancedMDFieldDefinition.php.

                                                                     : ?ilAdvancedMDFieldDefinition
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT field_id, field_type FROM adv_mdf_definition" .
            " WHERE import_id = " . $ilDB->quote($a_import_id, 'text');
        $set = $ilDB->query($query);
        if ($ilDB->numRows($set)) {
            $row = $ilDB->fetchAssoc($set);
            return self::getInstance((int) $row["field_id"], (int) $row["field_type"]);
        }
        return null;
    }

References $DIC, $ilDB, and $query.

getInstanceByTypeString()

static ilAdvancedMDFieldDefinition::getInstanceByTypeString ( string  $a_type )

static

Get instance by type string (used by import)

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

                                                                  : ?ilAdvancedMDFieldDefinition
    {
        // see self::getTypeString()
        $map = array(
            self::TYPE_TEXT => "Text",
            self::TYPE_SELECT => "Select",
            self::TYPE_DATE => "Date",
            self::TYPE_DATETIME => "DateTime",
            self::TYPE_FLOAT => "Float",
            self::TYPE_LOCATION => "Location",
            self::TYPE_INTEGER => "Integer",
            self::TYPE_SELECT_MULTI => "SelectMulti",
            self::TYPE_EXTERNAL_LINK => 'ExternalLink',
            self::TYPE_INTERNAL_LINK => 'InternalLink',
            self::TYPE_ADDRESS => "Address"
        );
        $map = array_flip($map);
        if (array_key_exists($a_type, $map)) {
            return self::getInstance(null, $map[$a_type]);
        }
        return null;
    }

Referenced by ilAdvancedMDRecordParser\initFieldObject().

Here is the caller graph for this function:

getInstancesByObjType()

static ilAdvancedMDFieldDefinition::getInstancesByObjType (   $a_obj_type,   $a_active_only = true  )

static

Parameters

string	$a_obj_type
bool	$a_active_only

Returns

array<int, ilAdvancedMDFieldDefinition>

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

                                                                                    : array
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT amf.* FROM adv_md_record_objs aro" .
            " JOIN adv_md_record amr ON aro.record_id = amr.record_id" .
            " JOIN adv_mdf_definition amf ON aro.record_id = amf.record_id" .
            " WHERE obj_type = " . $ilDB->quote($a_obj_type, 'text');
        if ($a_active_only) {
            $query .= " AND active = " . $ilDB->quote(1, "integer");
        }
        $query .= " ORDER BY aro.record_id,position";
        $res = $ilDB->query($query);
        $defs = [];
        while ($row = $ilDB->fetchAssoc($res)) {
            $field = self::getInstance(null, (int) $row["field_type"]);
            $field->import($row);
            $defs[(int) $row["field_id"]] = $field;
        }
        return $defs;
    }

References $DIC, $ilDB, $query, $res, and ILIAS\Repository\int().

Referenced by ilECSSettingsGUI\exportMappings(), ilECSSettingsGUI\importMappings(), ilAdvancedMDSettingsGUI\initFormSubstitutions(), ilECSSettingsGUI\initMappingsForm(), ilAdvancedMDRecordGUI\parseAppointmentPresentationa(), and ilAdvancedMDSettingsGUI\updateSubstitutions().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstancesByRecordId()

static ilAdvancedMDFieldDefinition::getInstancesByRecordId (   $a_record_id,   $a_only_searchable = false, string  $language = ''  )

static

Get definitions by record id.

Parameters

int	$a_record_id
bool	$a_only_searchable
string	$language

Returns

array<int, ilAdvancedMDFieldDefinition>

Definition at line 155 of file class.ilAdvancedMDFieldDefinition.php.

     : array {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT * FROM adv_mdf_definition" .
            " WHERE record_id = " . $ilDB->quote($a_record_id, "integer");
        if ($a_only_searchable) {
            $query .= " AND searchable = " . $ilDB->quote(1, "integer");
        }
        $query .= " ORDER BY position";
        $set = $ilDB->query($query);
        $defs = [];
        while ($row = $ilDB->fetchAssoc($set)) {
            $field = self::getInstance(null, (int) $row["field_type"], $language);
            $field->import($row);
            $defs[(int) $row["field_id"]] = $field;
        }
        return $defs;
    }

References $ilDB, and $query.

Referenced by ilAdvancedMDRecord\_clone(), ilAdvancedMDRecord\_delete(), ilAdvancedMDSettingsGUI\editFields(), ilAdvancedMDRecordTableGUI\fillRow(), ilGlossaryAdvMetaDataAdapter\getAllFields(), ilAdvancedMDValues\getDefinitions(), ilLuceneAdvancedSearchFields\getFields(), ilAdvancedMDRecordGUI\parseFilter(), ilAdvancedMDRecordGUI\parseSearch(), ilAdvancedMDRecordGUI\parseTableCells(), ilAdvancedMDRecordGUI\parseTableHead(), ilAdvancedMDFieldTranslations\read(), ilAdvancedMDRecord\toXML(), and ilAdvancedMDSettingsGUI\updateFields().

Here is the caller graph for this function:

getLastPosition()

ilAdvancedMDFieldDefinition::getLastPosition ( )

protected

Get last position of record.

Definition at line 738 of file class.ilAdvancedMDFieldDefinition.php.

                                        : int
    {
        $sql = "SELECT max(position) pos" .
            " FROM adv_mdf_definition" .
            " WHERE record_id = " . $this->db->quote($this->getRecordId(), "integer");
        $set = $this->db->query($sql);
        if ($this->db->numRows($set)) {
            $pos = $this->db->fetchAssoc($set);
            return (int) $pos["pos"];
        }
        return 0;
    }

References ILIAS\LTI\ToolProvider\getRecordId().

Here is the call graph for this function:

getLuceneSearchString()

ilAdvancedMDFieldDefinition::getLuceneSearchString

(

$a_value

)

Get search string in lucene syntax.

Parameters

string

| array

Returns

Todo:

with php 8 support change parameter to union type

Reimplemented in ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, ilAdvancedMDFieldDefinitionInternalLink, and ilAdvancedMDFieldDefinitionLocation.

Definition at line 1080 of file class.ilAdvancedMDFieldDefinition.php.

    {
        return $a_value;
    }

getPosition()

ilAdvancedMDFieldDefinition::getPosition

(

)

Get position.

Definition at line 449 of file class.ilAdvancedMDFieldDefinition.php.

                                 : int
    {
        return $this->position;
    }

getRecordId()

ilAdvancedMDFieldDefinition::getRecordId

(

)

Get record id.

Definition at line 414 of file class.ilAdvancedMDFieldDefinition.php.

                                 : int
    {
        return $this->record_id;
    }

Referenced by ilAdvancedMDFieldDefinitionText\initADTDefinition().

Here is the caller graph for this function:

getSearchableDefinitionIds()

static ilAdvancedMDFieldDefinition::getSearchableDefinitionIds ( )

static

Get searchable definition ids (performance is key)

Returns

int[]

Definition at line 229 of file class.ilAdvancedMDFieldDefinition.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $field_ids = array();
 
        $query = "SELECT field_id FROM adv_md_record amr" .
            " JOIN adv_mdf_definition amfd ON (amr.record_id = amfd.record_id)" .
            " WHERE active = " . $ilDB->quote(1, "integer") .
            " AND searchable = " . $ilDB->quote(1, "integer");
        $set = $ilDB->query($query);
        while ($row = $ilDB->fetchAssoc($set)) {
            $field_ids[] = (int) $row["field_id"];
        }
        return $field_ids;
    }

References $DIC, $ilDB, $query, and ILIAS\Repository\int().

Referenced by ilAdvancedSearchGUI\setSubTabs().

Here is the call graph for this function:

Here is the caller graph for this function:

getSearchQueryParserValue()

ilAdvancedMDFieldDefinition::getSearchQueryParserValue

(

ilADTSearchBridge

$a_adt_search

)

Get value for search query parser.

Parameters

ilADTSearchBridge

$a_adt_search

Returns

string

Todo:

check if string type is applicable

Reimplemented in ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

Definition at line 973 of file class.ilAdvancedMDFieldDefinition.php.

                                                                              : string
    {
        return '';
    }

getSearchValueSerialized()

ilAdvancedMDFieldDefinition::getSearchValueSerialized

(

ilADTSearchBridge

$a_adt_search

)

Definition at line 978 of file class.ilAdvancedMDFieldDefinition.php.

                                                                             : string
    {
        return $a_adt_search->getSerializedValue();
    }

References ilADTSearchBridge\getSerializedValue().

Here is the call graph for this function:

getTitle()

ilAdvancedMDFieldDefinition::getTitle

(

)

Get title.

Definition at line 468 of file class.ilAdvancedMDFieldDefinition.php.

                              : string
    {
        return $this->title;
    }

getType()

ilAdvancedMDFieldDefinition::getType ( )

abstract

Get type.

Reimplemented in ilAdvancedMDFieldDefinitionAddress, ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, ilAdvancedMDFieldDefinitionExternalLink, ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionInternalLink, ilAdvancedMDFieldDefinitionLocation, ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

getTypeString()

static ilAdvancedMDFieldDefinition::getTypeString ( int  $a_type )

staticprotected

Get type as string.

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

                                                        : string
    {
        if (self::isValidType($a_type)) {
            $map = array(
                self::TYPE_TEXT => "Text",
                self::TYPE_SELECT => "Select",
                self::TYPE_DATE => "Date",
                self::TYPE_DATETIME => "DateTime",
                self::TYPE_FLOAT => "Float",
                self::TYPE_LOCATION => "Location",
                self::TYPE_INTEGER => "Integer",
                self::TYPE_SELECT_MULTI => "SelectMulti",
                self::TYPE_EXTERNAL_LINK => 'ExternalLink',
                self::TYPE_INTERNAL_LINK => 'InternalLink',
                self::TYPE_ADDRESS => "Address"
            );
            return $map[$a_type];
        }
        return '';
    }

getTypeTitle()

ilAdvancedMDFieldDefinition::getTypeTitle

(

)

Todo:

check udf usage

Definition at line 346 of file class.ilAdvancedMDFieldDefinition.php.

                                  : string
    {
        return "udf_type_" . strtolower(self::getTypeString($this->getType()));
    }

Referenced by ilAdvancedMDSettingsGUI\initFieldForm().

Here is the caller graph for this function:

getValidTypes()

static ilAdvancedMDFieldDefinition::getValidTypes ( )

static

Get all valid types.

Returns

int[]

Definition at line 280 of file class.ilAdvancedMDFieldDefinition.php.

                                          : array
    {
        return array(
            self::TYPE_TEXT,
            self::TYPE_DATE,
            self::TYPE_DATETIME,
            self::TYPE_SELECT,
            self::TYPE_INTEGER,
            self::TYPE_FLOAT,
            self::TYPE_LOCATION,
            self::TYPE_SELECT_MULTI,
            self::TYPE_EXTERNAL_LINK,
            self::TYPE_INTERNAL_LINK,
            self::TYPE_ADDRESS
        );
    }

Referenced by ilAdvancedMDSettingsGUI\editFields().

Here is the caller graph for this function:

getValueForXML()

ilAdvancedMDFieldDefinition::getValueForXML ( ilADT  $element )

abstract

Parse ADT value for xml (export)

Reimplemented in ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, ilAdvancedMDFieldDefinitionExternalLink, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionInternalLink, ilAdvancedMDFieldDefinitionLocation, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionSelectMulti.

hasComplexOptions()

ilAdvancedMDFieldDefinition::hasComplexOptions

(

)

Reimplemented in ilAdvancedMDFieldDefinitionGroupBased, and ilAdvancedMDFieldDefinitionText.

Definition at line 1114 of file class.ilAdvancedMDFieldDefinition.php.

                                       : bool
    {
        return false;
    }

import()

ilAdvancedMDFieldDefinition::import ( array  $a_data )

protected

Import from DB.

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 785 of file class.ilAdvancedMDFieldDefinition.php.

                                            : void
    {
        $this->setFieldId((int) $a_data["field_id"]);
        $this->setRecordId((int) $a_data["record_id"]);
        $this->setImportId((string) $a_data["import_id"]);
        $this->setTitle((string) $a_data["title"]);
        $this->setDescription((string) $a_data["description"]);
        $this->setPosition((int) $a_data["position"]);
        $this->setSearchable((bool) $a_data["searchable"]);
        $this->setRequired((bool) $a_data["required"]);
        if (isset($a_data['field_values'])) {
            $field_values = unserialize($a_data['field_values']);
            if (is_array($field_values)) {
                $this->importFieldDefinition($field_values);
            }
        }
    }

References ILIAS\LTI\ToolProvider\setRecordId().

Here is the call graph for this function:

importCustomDefinitionFormPostValues()

ilAdvancedMDFieldDefinition::importCustomDefinitionFormPostValues	(	ilPropertyFormGUI	$a_form,
		string	$language = ''
	)

Import custom post values from definition form.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

Definition at line 675 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                                          : void
    {
        // type-specific
    }

importDefinitionFormPostValues()

ilAdvancedMDFieldDefinition::importDefinitionFormPostValues	(	ilPropertyFormGUI	$a_form,
		ilAdvancedMDPermissionHelper	$a_permissions,
		string	$active_language
	)

Import post values from definition form.

Definition at line 683 of file class.ilAdvancedMDFieldDefinition.php.

     : void {
        $record = ilAdvancedMDRecord::_getInstanceByRecordId($this->record_id);
        $is_translation = (($active_language !== '') && ($active_language != $record->getDefaultLanguage()));
        if (!$a_form->getItemByPostVar("title")->getDisabled() && !$is_translation) {
            $this->setTitle($a_form->getInput("title"));
        }
        if (!$a_form->getItemByPostVar("description")->getDisabled() && !$is_translation) {
            $this->setDescription($a_form->getInput("description"));
        }
        if (!$a_form->getItemByPostVar("searchable")->getDisabled()) {
            $this->setSearchable((bool) $a_form->getInput("searchable"));
        }
 
        if ($a_permissions->hasPermission(
            ilAdvancedMDPermissionHelper::CONTEXT_FIELD,
            (string) $this->getFieldId(),
            ilAdvancedMDPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
            ilAdvancedMDPermissionHelper::SUBACTION_FIELD_PROPERTIES
        )) {
            $this->importCustomDefinitionFormPostValues($a_form, $active_language);
        }
    }

References ilPropertyFormGUI\getInput().

Here is the call graph for this function:

importDefinitionFormPostValuesNeedsConfirmation()

ilAdvancedMDFieldDefinition::importDefinitionFormPostValuesNeedsConfirmation

(

)

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 710 of file class.ilAdvancedMDFieldDefinition.php.

                                                                     : bool
    {
        return false;
    }

importFieldDefinition()

ilAdvancedMDFieldDefinition::importFieldDefinition ( array  $a_def )

protected

Import (type-specific) field definition from DB.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 547 of file class.ilAdvancedMDFieldDefinition.php.

                                                          : void
    {
    }

importFromECS()

ilAdvancedMDFieldDefinition::importFromECS	(	string	$a_ecs_type,
			$a_value,
		string	$a_sub_id
	)

Import meta data from ECS.

Reimplemented in ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, and ilAdvancedMDFieldDefinitionText.

Definition at line 954 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                 : bool
    {
        return false;
    }

importValueFromXML()

ilAdvancedMDFieldDefinition::importValueFromXML ( string  $a_cdata )

abstract

Import value from xml.

Parameters

string

$a_cdata

Reimplemented in ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, ilAdvancedMDFieldDefinitionExternalLink, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionInternalLink, ilAdvancedMDFieldDefinitionLocation, ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

importXMLProperty()

ilAdvancedMDFieldDefinition::importXMLProperty	(	string	$a_key,
		string	$a_value
	)

Import property from XML.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionSelect, and ilAdvancedMDFieldDefinitionText.

Definition at line 936 of file class.ilAdvancedMDFieldDefinition.php.

                                                                     : void
    {
    }

init()

ilAdvancedMDFieldDefinition::init ( )

protected

Reimplemented in ilAdvancedMDFieldDefinitionFloat.

Definition at line 270 of file class.ilAdvancedMDFieldDefinition.php.

                             : void
    {
        $this->setRequired(false);
        $this->setSearchable(false);
    }

Referenced by __construct().

Here is the caller graph for this function:

initADTDefinition()

ilAdvancedMDFieldDefinition::initADTDefinition ( )

abstractprotected

Init adt instance.

Reimplemented in ilAdvancedMDFieldDefinitionDate, ilAdvancedMDFieldDefinitionDateTime, ilAdvancedMDFieldDefinitionExternalLink, ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionGroupBased, ilAdvancedMDFieldDefinitionInteger, ilAdvancedMDFieldDefinitionInternalLink, ilAdvancedMDFieldDefinitionLocation, ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

isFilterSupported()

ilAdvancedMDFieldDefinition::isFilterSupported

(

)

Is search by filter supported.

Reimplemented in ilAdvancedMDFieldDefinitionFloat, ilAdvancedMDFieldDefinitionInteger, and ilAdvancedMDFieldDefinitionLocation.

Definition at line 503 of file class.ilAdvancedMDFieldDefinition.php.

                                       : bool
    {
        return true;
    }

isRequired()

ilAdvancedMDFieldDefinition::isRequired

(

)

Is required field.

Definition at line 539 of file class.ilAdvancedMDFieldDefinition.php.

                                : bool
    {
        return $this->required;
    }

isSearchable()

ilAdvancedMDFieldDefinition::isSearchable

(

)

Is searchable.

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

                                  : bool
    {
        return $this->searchable;
    }

isSearchSupported()

ilAdvancedMDFieldDefinition::isSearchSupported

(

)

Is search supported at all.

Definition at line 495 of file class.ilAdvancedMDFieldDefinition.php.

                                       : bool
    {
        return true;
    }

isValidType()

static ilAdvancedMDFieldDefinition::isValidType ( int  $a_type )

static

Definition at line 297 of file class.ilAdvancedMDFieldDefinition.php.

                                                   : bool
    {
        return in_array($a_type, self::getValidTypes());
    }

parseSearchObjects()

ilAdvancedMDFieldDefinition::parseSearchObjects ( array  $a_records, array  $a_object_types  )

protected

Add object-data needed for global search to AMD search results.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 994 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                  : array
    {
        $res = [];
        $obj_ids = [];
        foreach ($a_records as $record) {
            if ($record["sub_type"] == "-") {
                $obj_ids[] = $record["obj_id"];
            }
        }
 
        $sql = "SELECT obj_id,type" .
            " FROM object_data" .
            " WHERE " . $this->db->in("obj_id", $obj_ids, false, "integer") .
            " AND " . $this->db->in("type", $a_object_types, false, "text");
        $set = $this->db->query($sql);
        while ($row = $this->db->fetchAssoc($set)) {
            $res[] = $row;
        }
        return $res;
    }

References $res.

Referenced by ilAdvancedMDFieldDefinitionInternalLink\searchObjects().

Here is the caller graph for this function:

prepareCustomDefinitionFormConfirmation()

ilAdvancedMDFieldDefinition::prepareCustomDefinitionFormConfirmation

(

ilPropertyFormGUI

$a_form

)

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 715 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                      : void
    {
    }

prepareDefinitionFormConfirmation()

ilAdvancedMDFieldDefinition::prepareDefinitionFormConfirmation

(

ilPropertyFormGUI

$a_form

)

Definition at line 719 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                : void
    {
        $a_form->getItemByPostVar("title")->setDisabled(true);
        $a_form->getItemByPostVar("description")->setDisabled(true);
        $a_form->getItemByPostVar("searchable")->setDisabled(true);
 
        // checkboxes have no hidden on disabled
        if ($a_form->getInput("searchable")) {
            $hidden = new ilHiddenInputGUI("searchable");
            $hidden->setValue("1");
            $a_form->addItem($hidden);
        }
 
        $this->prepareCustomDefinitionFormConfirmation($a_form);
    }

References ilPropertyFormGUI\addItem(), ilPropertyFormGUI\getInput(), and ilPropertyFormGUI\getItemByPostVar().

Here is the call graph for this function:

prepareElementForEditor()

ilAdvancedMDFieldDefinition::prepareElementForEditor

(

ilADTFormBridge

$a_bridge

)

Prepare editor form elements.

Reimplemented in ilAdvancedMDFieldDefinitionSelect, ilAdvancedMDFieldDefinitionSelectMulti, and ilAdvancedMDFieldDefinitionText.

Definition at line 962 of file class.ilAdvancedMDFieldDefinition.php.

                                                                      : void
    {
        // type-specific
    }

prepareElementForSearch()

ilAdvancedMDFieldDefinition::prepareElementForSearch

(

ilADTSearchBridge

$a_bridge

)

Prepare search form elements.

Definition at line 1088 of file class.ilAdvancedMDFieldDefinition.php.

                                                                        : void
    {
    }

read()

ilAdvancedMDFieldDefinition::read ( ?int  $a_field_id )

protected

Read field definition.

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

                                             : void
    {
        if (!(int) $a_field_id) {
            return;
        }
 
        $sql = "SELECT * FROM adv_mdf_definition" .
            " WHERE field_id = " . $this->db->quote($a_field_id, "integer");
        $set = $this->db->query($sql);
        if ($this->db->numRows($set)) {
            $row = $this->db->fetchAssoc($set);
            $this->import($row);
        }
    }

Referenced by __construct().

Here is the caller graph for this function:

save()

ilAdvancedMDFieldDefinition::save

(

bool

$a_keep_pos = false

)

Create new field entry.

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 824 of file class.ilAdvancedMDFieldDefinition.php.

                                                  : void
    {
        if ($this->getFieldId()) {
            $this->update();
            return;
        }
 
        $next_id = $this->db->nextId("adv_mdf_definition");
 
        // append
        if (!$a_keep_pos) {
            $this->setPosition($this->getLastPosition() + 1);
        }
 
        // needs unique import id
        if (!$this->getImportId()) {
            $this->setImportId($this->generateImportId($next_id));
        }
 
        $fields = $this->getDBProperties();
        $fields["field_id"] = array("integer", $next_id);
 
        $this->db->insert("adv_mdf_definition", $fields);
 
        $this->setFieldId($next_id);
    }

searchObjects()

ilAdvancedMDFieldDefinition::searchObjects	(	ilADTSearchBridge	$a_adt_search,
		ilQueryParser	$a_parser,
		array	$a_object_types,
		string	$a_locate,
		string	$a_search_type
	)

Search objects.

Reimplemented in ilAdvancedMDFieldDefinitionInternalLink, and ilAdvancedMDFieldDefinitionText.

Definition at line 1050 of file class.ilAdvancedMDFieldDefinition.php.

     : array {
        // search type only supported/needed for text
        $condition = $a_adt_search->getSQLCondition(ilADTActiveRecordByType::SINGLE_COLUMN_NAME);
        if ($condition) {
            $objects = ilADTActiveRecordByType::find(
                "adv_md_values",
                $this->getADT()->getType(),
                $this->getFieldId(),
                $condition,
                $a_locate
            );
            if (sizeof($objects)) {
                return $this->parseSearchObjects($objects, $a_object_types);
            }
        }
        return [];
    }

References ilADTActiveRecordByType\find().

Here is the call graph for this function:

searchSubObjects()

ilAdvancedMDFieldDefinition::searchSubObjects	(	ilADTSearchBridge	$a_adt_search,
		int	$a_obj_id,
		string	$sub_obj_type
	)

Definition at line 1015 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                                          : array
    {
        $element_id = ilADTActiveRecordByType::SINGLE_COLUMN_NAME;
 
        // :TODO:
        if ($a_adt_search instanceof ilADTLocationSearchBridgeSingle) {
            $element_id = "loc";
        }
 
        $condition = $a_adt_search->getSQLCondition($element_id);
        if ($condition) {
            $objects = ilADTActiveRecordByType::find(
                "adv_md_values",
                $this->getADT()->getType(),
                $this->getFieldId(),
                $condition
            );
            if (sizeof($objects)) {
                $res = array();
                foreach ($objects as $item) {
                    if ($item["obj_id"] == $a_obj_id &&
                        $item["sub_type"] == $sub_obj_type) {
                        $res[] = $item["sub_id"];
                    }
                }
                return $res;
            }
        }
 
        return array();
    }

References $res, ilADTActiveRecordByType\find(), ilADTSearchBridge\getSQLCondition(), and ilADTActiveRecordByType\SINGLE_COLUMN_NAME.

Here is the call graph for this function:

setADT()

ilAdvancedMDFieldDefinition::setADT ( ilADT  $a_adt )

protected

Set ADT instance.

See also

self::getADTGroupForDefinitions()

Definition at line 380 of file class.ilAdvancedMDFieldDefinition.php.

                                           : void
    {
        if (!$this->adt instanceof ilADT) {
            $this->adt = $a_adt;
        }
    }

setDescription()

ilAdvancedMDFieldDefinition::setDescription

(

string

$a_desc

)

Set description.

Definition at line 476 of file class.ilAdvancedMDFieldDefinition.php.

                                                  : void
    {
        if ($a_desc !== null) {
            $a_desc = trim($a_desc);
        }
        $this->description = $a_desc;
    }

setFieldId()

ilAdvancedMDFieldDefinition::setFieldId ( int  $a_id )

protected

Set field_id.

Definition at line 390 of file class.ilAdvancedMDFieldDefinition.php.

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

setImportId()

ilAdvancedMDFieldDefinition::setImportId

(

string

$a_id_string

)

Set import id.

Definition at line 422 of file class.ilAdvancedMDFieldDefinition.php.

                                                    : void
    {
        if ($a_id_string !== null) {
            $a_id_string = trim($a_id_string);
        }
        $this->import_id = $a_id_string;
    }

setPosition()

ilAdvancedMDFieldDefinition::setPosition

(

int

$a_pos

)

Set position.

Definition at line 441 of file class.ilAdvancedMDFieldDefinition.php.

                                           : void
    {
        $this->position = $a_pos;
    }

setRecordId()

ilAdvancedMDFieldDefinition::setRecordId

(

int

$a_id

)

Set record id.

Definition at line 406 of file class.ilAdvancedMDFieldDefinition.php.

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

setRequired()

ilAdvancedMDFieldDefinition::setRequired

(

bool

$a_status

)

Toggle required.

Definition at line 531 of file class.ilAdvancedMDFieldDefinition.php.

                                               : void
    {
        $this->required = $a_status;
    }

setSearchable()

ilAdvancedMDFieldDefinition::setSearchable

(

bool

$a_status

)

Toggle searchable.

Definition at line 511 of file class.ilAdvancedMDFieldDefinition.php.

                                                 : void
    {
        // see above
        if (!$this->isSearchSupported()) {
            $a_status = false;
        }
        $this->searchable = (bool) $a_status;
    }

setSearchValueSerialized()

ilAdvancedMDFieldDefinition::setSearchValueSerialized	(	ilADTSearchBridge	$a_adt_search,
			$a_value
	)

Set value from search persistence.

Definition at line 986 of file class.ilAdvancedMDFieldDefinition.php.

                                                                                       : void
    {
        $a_adt_search->setSerializedValue($a_value);
    }

References ilADTSearchBridge\setSerializedValue().

Here is the call graph for this function:

setTitle()

ilAdvancedMDFieldDefinition::setTitle

(

string

$a_title

)

Get title.

Definition at line 457 of file class.ilAdvancedMDFieldDefinition.php.

                                             : void
    {
        if ($a_title !== null) {
            $a_title = trim($a_title);
        }
        $this->title = $a_title;
    }

toXML()

ilAdvancedMDFieldDefinition::toXML

(

ilXmlWriter

$a_writer

)

To Xml.

This method writes only the subset Field Use class.ilAdvancedMDRecordXMLWriter to generate a complete xml presentation.

Definition at line 890 of file class.ilAdvancedMDFieldDefinition.php.

                                                : void
    {
        $a_writer->xmlStartTag('Field', array(
            'id' => $this->generateImportId($this->getFieldId()),
            'searchable' => ($this->isSearchable() ? 'Yes' : 'No'),
            'fieldType' => self::getTypeString($this->getType())
        ));
 
        $a_writer->xmlElement('FieldTitle', null, $this->getTitle());
        $a_writer->xmlElement('FieldDescription', null, $this->getDescription());
 
        $translations = ilAdvancedMDFieldTranslations::getInstanceByRecordId($this->getRecordId());
        $a_writer->xmlStartTag('FieldTranslations');
        foreach ($translations->getTranslations($this->getFieldId()) as $translation) {
            $a_writer->xmlStartTag('FieldTranslation', ['language' => $translation->getLangKey()]);
            $a_writer->xmlElement(
                'FieldTranslationTitle',
                [],
                $translation->getTitle()
            );
            $a_writer->xmlElement(
                'FieldTranslationDescription',
                [],
                $translation->getDescription()
            );
            $a_writer->xmlEndTag('FieldTranslation');
        }
        $a_writer->xmlEndTag('FieldTranslations');
        $a_writer->xmlElement('FieldPosition', null, $this->getPosition());
 
        $this->addPropertiesToXML($a_writer);
 
        $a_writer->xmlEndTag('Field');
    }

References ilAdvancedMDFieldTranslations\getInstanceByRecordId(), ILIAS\LTI\ToolProvider\getRecordId(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Here is the call graph for this function:

update()

ilAdvancedMDFieldDefinition::update

(

)

Update field entry.

Reimplemented in ilAdvancedMDFieldDefinitionSelect.

Definition at line 854 of file class.ilAdvancedMDFieldDefinition.php.

                            : void
    {
        if (!$this->getFieldId()) {
            $this->save();
            return;
        }
 
        $this->db->update(
            "adv_mdf_definition",
            $this->getDBProperties(),
            array("field_id" => array("integer", $this->getFieldId()))
        );
    }

useDefaultLanguageMode()

ilAdvancedMDFieldDefinition::useDefaultLanguageMode

(

string

$language

)

Check if default language mode has to be used: no language given or language equals default language.

Definition at line 334 of file class.ilAdvancedMDFieldDefinition.php.

                                                            : bool
    {
        if (!strlen($language)) {
            return true;
        }
        $record = ilAdvancedMDRecord::_getInstanceByRecordId($this->record_id);
        return strcmp($record->getDefaultLanguage(), $language) === 0;
    }

References ilAdvancedMDRecord\_getInstanceByRecordId().

Referenced by ilAdvancedMDFieldDefinitionInteger\getFieldDefinitionForTableGUI().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$adt

ilADT ilAdvancedMDFieldDefinition::$adt = null

protected

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

Referenced by ilAdvancedMDFieldDefinitionExternalLink\importValueFromXML(), and ilAdvancedMDFieldDefinitionLocation\importValueFromXML().

$adt_def

ilADTDefinition ilAdvancedMDFieldDefinition::$adt_def = null

protected

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

$db

ilDBInterface ilAdvancedMDFieldDefinition::$db

protected

Definition at line 57 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by getInstance().

$description

string ilAdvancedMDFieldDefinition::$description = ''

protected

Definition at line 49 of file class.ilAdvancedMDFieldDefinition.php.

$field_id

int ilAdvancedMDFieldDefinition::$field_id = null

protected

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

$http

GlobalHttpState ilAdvancedMDFieldDefinition::$http

protected

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

$import_id

string ilAdvancedMDFieldDefinition::$import_id = ''

protected

Definition at line 46 of file class.ilAdvancedMDFieldDefinition.php.

$language

string ilAdvancedMDFieldDefinition::$language = ''

protected

Definition at line 55 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by __construct(), ilAdvancedMDFieldDefinitionSelect\__construct(), ilAdvancedMDFieldDefinitionSelect\addCustomFieldToDefinitionForm(), ilAdvancedMDFieldDefinitionSelect\getOptionTranslation(), ilAdvancedMDFieldDefinitionSelectMulti\importCustomDefinitionFormPostValues(), ilAdvancedMDFieldDefinitionSelect\initADTDefinition(), ilAdvancedMDFieldDefinitionSelectMulti\initADTDefinition(), ilAdvancedMDFieldDefinitionSelect\setOptionTranslationsForLanguage(), and ilAdvancedMDFieldDefinitionInteger\setSuffixTranslation().

$lng

ilLanguage ilAdvancedMDFieldDefinition::$lng

protected

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

Referenced by ilAdvancedMDFieldDefinitionFloat\getFieldDefinitionForTableGUI(), ilAdvancedMDFieldDefinitionGroupBased\getFieldDefinitionForTableGUI(), ilAdvancedMDFieldDefinitionSelect\getFieldDefinitionForTableGUI(), ilAdvancedMDFieldDefinitionText\getFieldDefinitionForTableGUI(), and ilAdvancedMDFieldDefinitionAddress\getTitles().

$logger

ilLogger ilAdvancedMDFieldDefinition::$logger

protected

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

$position

int ilAdvancedMDFieldDefinition::$position = 0

protected

Definition at line 47 of file class.ilAdvancedMDFieldDefinition.php.

$record_id

int ilAdvancedMDFieldDefinition::$record_id = 0

protected

Definition at line 45 of file class.ilAdvancedMDFieldDefinition.php.

$refinery

RefineryFactory ilAdvancedMDFieldDefinition::$refinery

protected

Definition at line 61 of file class.ilAdvancedMDFieldDefinition.php.

$required

bool ilAdvancedMDFieldDefinition::$required = false

protected

Definition at line 51 of file class.ilAdvancedMDFieldDefinition.php.

$searchable

bool ilAdvancedMDFieldDefinition::$searchable = false

protected

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

$title

string ilAdvancedMDFieldDefinition::$title = ''

protected

Definition at line 48 of file class.ilAdvancedMDFieldDefinition.php.

TYPE_ADDRESS

const ilAdvancedMDFieldDefinition::TYPE_ADDRESS = 99

Definition at line 40 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionAddress\getType().

TYPE_DATE

const ilAdvancedMDFieldDefinition::TYPE_DATE = 3

Definition at line 34 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionDate\getType(), ilBookingObjectsTableGUI\numericOrdering(), ilPresentationListTableGUI\numericOrdering(), and ilTermListTableGUI\numericOrdering().

TYPE_DATETIME

const ilAdvancedMDFieldDefinition::TYPE_DATETIME = 4

Definition at line 35 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionDateTime\getType().

TYPE_EXTERNAL_LINK

const ilAdvancedMDFieldDefinition::TYPE_EXTERNAL_LINK = 9

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

Referenced by ilAdvancedMDFieldDefinitionExternalLink\getType().

TYPE_FLOAT

const ilAdvancedMDFieldDefinition::TYPE_FLOAT = 6

Definition at line 37 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionFloat\getType().

TYPE_INTEGER

const ilAdvancedMDFieldDefinition::TYPE_INTEGER = 5

Definition at line 36 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionInteger\getType().

TYPE_INTERNAL_LINK

const ilAdvancedMDFieldDefinition::TYPE_INTERNAL_LINK = 10

Definition at line 42 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionInternalLink\getType().

TYPE_LOCATION

const ilAdvancedMDFieldDefinition::TYPE_LOCATION = 7

Definition at line 38 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionLocation\getType().

TYPE_SELECT

const ilAdvancedMDFieldDefinition::TYPE_SELECT = 1

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

Referenced by ilAdvancedMDFieldDefinitionSelect\getType().

TYPE_SELECT_MULTI

const ilAdvancedMDFieldDefinition::TYPE_SELECT_MULTI = 8

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

Referenced by ilAdvancedMDFieldDefinitionSelectMulti\getType().

TYPE_TEXT

const ilAdvancedMDFieldDefinition::TYPE_TEXT = 2

Definition at line 33 of file class.ilAdvancedMDFieldDefinition.php.

Referenced by ilAdvancedMDFieldDefinitionText\getType().

---

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

• Services/AdvancedMetaData/classes/class.ilAdvancedMDFieldDefinition.php