AMD field type address. More...

Inheritance diagram for ilAdvancedMDFieldDefinitionGroupBased:

Collaboration diagram for ilAdvancedMDFieldDefinitionGroupBased:

Public Member Functions

setOptions (array $a_values=null)

Set options. More...

getOptions ()

Get options. More...

getFieldDefinitionForTableGUI (string $content_language)

Parse properties for table gui. More...

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

Import custom post values from definition form. More...

importXMLProperty ($a_key, $a_value)

Import property from XML. More...

getValueForXML (ilADT $element)

Parse ADT value for xml (export) More...

importValueFromXML ($a_cdata)

Import value from xml. More...

getADTGroup ()

getTitles ()

hasComplexOptions ()

getComplexOptionsOverview ($a_parent_gui, string $a_parent_cmd)

Parameters

	$a_parent_gui
string	$parent_cmd

Returns: null

More...

exportOptionToTableGUI ($a_option, array &$a_item)

initOptionForm (ilPropertyFormGUI $a_form, $a_option_id)

updateComplexOption (ilPropertyFormGUI $a_form, $a_option_id)

Public Member Functions inherited from ilAdvancedMDFieldDefinition

__construct ($a_field_id=null, string $language='')

Constructor. More...

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 ()

Get type title (lang id) More...

getADTDefinition ()

Get ADT definition instance. More...

getADT ()

Get ADT instance. More...

getFieldId ()

Get field_id. More...

setRecordId ($a_id)

Set record id. More...

getRecordId ()

Get record id. More...

setImportId ($a_id_string)

Set import id. More...

getImportId ()

Get import id. More...

setPosition ($a_pos)

Set position. More...

getPosition ()

Get position. More...

setTitle ($a_title)

Get title. More...

getTitle ()

Get title. More...

setDescription ($a_desc)

Set description. More...

getDescription ()

Get description. More...

isSearchSupported ()

Is search supported at all. More...

isFilterSupported ()

Is search by filter supported. More...

setSearchable ($a_status)

Toggle searchable. More...

isSearchable ()

Is searchable. More...

setRequired ($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 ($a_field_id)

Generate unique record id. More...

save ($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 ($a_key, $a_value)

Import property from XML. More...

getValueForXML (ilADT $element)

Parse ADT value for xml (export) More...

importValueFromXML ($a_cdata)

Import value from xml. More...

importFromECS ($a_ecs_type, $a_value, $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)

Get value for search persistence. More...

setSearchValueSerialized (ilADTSearchBridge $a_adt_search, $a_value)

Set value from search persistence. More...

searchSubObjects (ilADTSearchBridge $a_adt_search, $a_obj_id, $sub_obj_type)

searchObjects (ilADTSearchBridge $a_adt_search, ilQueryParser $a_parser, array $a_object_types, $a_locate, $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 ($a_new_record_id)

Clone field definition. More...

hasComplexOptions ()

getComplexOptionsOverview ($a_parent_gui, string $parent_cmd)

Protected Member Functions
	initADTDefinition ()
	Init adt instance. More...

	importFieldDefinition (array $a_def)
	Import (type-specific) field definition from DB. More...

	getFieldDefinition ()
	Get (type-specific) field definition. More...

	addCustomFieldToDefinitionForm (ilPropertyFormGUI $a_form, $a_disabled=false, string $language='')
	Add input elements to definition form. More...

	addPropertiesToXML (ilXmlWriter $a_writer)
	Add (type-specific) properties to xml export. More...

	getADTForOption ($a_option)

	importComplexOptionFromForm ($a_option, ilADT $a_adt)

	findOptionById ($a_id)

Protected Member Functions inherited from ilAdvancedMDFieldDefinition
	init ()
	Init properties. More...

	initADTDefinition ()
	Init adt instance. More...

	setADT (ilADT $a_adt)
	Set ADT instance. More...

	setFieldId ($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, $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 ($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...

Protected Attributes
	$options = array()

	$complex = array()

Protected Attributes inherited from ilAdvancedMDFieldDefinition
	$field_id

	$record_id

	$import_id

	$position

	$title

	$description

	$searchable

	$required

	$adt_def

	$adt

	$language = ''

	$logger

Additional Inherited Members
Static Public Member Functions inherited from ilAdvancedMDFieldDefinition
static	getInstance ($a_field_id, $a_type=null, string $language='')
	Get definition instance by type. More...

static	exists ($a_field_id)
	Check if field exists. More...

static	getInstanceByTypeString ($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 ($a_import_id)
	Get definition instance by import id. More...

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 ($a_type)
	Is given type valid. More...

Data Fields inherited from ilAdvancedMDFieldDefinition
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

Static Protected Member Functions inherited from ilAdvancedMDFieldDefinition
static	getTypeString ($a_type)
	Get type string. More...

Detailed Description

AMD field type address.

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 14 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

Member Function Documentation

◆ addCustomFieldToDefinitionForm()

ilAdvancedMDFieldDefinitionGroupBased::addCustomFieldToDefinitionForm	(	ilPropertyFormGUI	$a_form,
			$a_disabled = `false`,
		string	$language = `''`
	)

protected

Add input elements to definition form.

Parameters

ilPropertyFormGUI	$a_form
bool	$a_disabled
string	$language

Exceptions

ilFormException

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 102 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        global $lng;
        
        $field = new ilTextInputGUI($lng->txt("options"), "opts");
        $field->setRequired(true);
        $field->setMulti(true);
        $field->setMaxLength(255); // :TODO:
        $a_form->addItem($field);
        
        $options = $this->getOptions();
        if ($options) {
            $field->setMultiValues($options);
            $field->setValue(array_shift($options));
        }
        
        if ($a_disabled) {
            $field->setDisabled(true);
        }
    }

References $lng, $options, ilPropertyFormGUI\addItem(), and getOptions().

Here is the call graph for this function:

◆ addPropertiesToXML()

ilAdvancedMDFieldDefinitionGroupBased::addPropertiesToXML ( ilXmlWriter $a_writer )

protected

Add (type-specific) properties to xml export.

Parameters

ilXmlWriter $a_writer

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 150 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        foreach ($this->getOptions() as $value) {
            $a_writer->xmlElement('FieldValue', null, $value);
        }
    }

References getOptions(), and ilXmlWriter\xmlElement().

Here is the call graph for this function:

◆ exportOptionToTableGUI()

ilAdvancedMDFieldDefinitionGroupBased::exportOptionToTableGUI	(		$a_option,
		array &	$a_item
	)

Definition at line 212 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $adt = $this->getADTForOption($a_option);
        foreach ($adt->getElements() as $title => $element) {
            $pres = ilADTFactory::getInstance()->getPresentationBridgeForInstance($element);
            $a_item[$title] = $pres->getList();
        }
    }

References ilAdvancedMDFieldDefinition\$adt, ilAdvancedMDFieldDefinition\$title, getADTForOption(), and ilADTFactory\getInstance().

Here is the call graph for this function:

◆ findOptionById()

ilAdvancedMDFieldDefinitionGroupBased::findOptionById ( $a_id )

protected

Definition at line 269 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        foreach ($this->getOptions() as $item) {
            if (md5($item) == $a_id) {
                return $item;
            }
        }
    }

References getOptions().

Referenced by initOptionForm(), and updateComplexOption().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getADTForOption()

ilAdvancedMDFieldDefinitionGroupBased::getADTForOption ( $a_option )

protected

Definition at line 191 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $adt = ilADTFactory::getInstance()->getInstanceByDefinition($this->getADTGroup());
        if (array_key_exists($a_option, $this->complex)) {
            $adt->importStdClass($this->complex[$a_option]);
        }
        return $adt;
    }

References ilAdvancedMDFieldDefinition\$adt, getADTGroup(), and ilADTFactory\getInstance().

Referenced by exportOptionToTableGUI(), and initOptionForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getADTGroup()

ilAdvancedMDFieldDefinitionGroupBased::getADTGroup ( )

abstract

Reimplemented in ilAdvancedMDFieldDefinitionAddress, and ilAdvancedMDFieldDefinitionText.

Referenced by getADTForOption(), and updateComplexOption().

Here is the caller graph for this function:

◆ getComplexOptionsOverview()

ilAdvancedMDFieldDefinitionGroupBased::getComplexOptionsOverview	(		$a_parent_gui,
		string	$a_parent_cmd
	)

Parameters

	$a_parent_gui
string	$parent_cmd

Returns: null

Reimplemented from ilAdvancedMDFieldDefinition.

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

                                                                                   : ?string
    {
        include_once "Services/AdvancedMetaData/classes/Types/class.ilAdvancedMDFieldDefinitionGroupTableGUI.php";
        $tbl = new ilAdvancedMDFieldDefinitionGroupTableGUI($a_parent_gui, $a_parent_cmd, $this);
        return $tbl->getHTML();
    }

◆ getFieldDefinition()

ilAdvancedMDFieldDefinitionGroupBased::getFieldDefinition ( )

protected

Get (type-specific) field definition.

Returns: array

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 80 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        return  array(
            "options" => $this->options,
            "complex" => $this->complex
        );
    }

◆ getFieldDefinitionForTableGUI()

ilAdvancedMDFieldDefinitionGroupBased::getFieldDefinitionForTableGUI ( string $content_language )

Parse properties for table gui.

Returns: array

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 88 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        global $lng;
        
        return array($lng->txt("options") => implode(",", $this->getOptions()));
    }

References $lng, and getOptions().

Here is the call graph for this function:

◆ getOptions()

ilAdvancedMDFieldDefinitionGroupBased::getOptions ( )

Get options.

Returns: array

Definition at line 64 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        return $this->options;
    }

References $options.

Referenced by addCustomFieldToDefinitionForm(), addPropertiesToXML(), findOptionById(), getFieldDefinitionForTableGUI(), importCustomDefinitionFormPostValues(), and initADTDefinition().

Here is the caller graph for this function:

◆ getTitles()

ilAdvancedMDFieldDefinitionGroupBased::getTitles ( )

abstract

Reimplemented in ilAdvancedMDFieldDefinitionAddress, and ilAdvancedMDFieldDefinitionText.

Referenced by initOptionForm().

Here is the caller graph for this function:

◆ getValueForXML()

ilAdvancedMDFieldDefinitionGroupBased::getValueForXML ( ilADT $element )

Parse ADT value for xml (export)

Parameters

ilADT $element

Returns: string

Reimplemented from ilAdvancedMDFieldDefinition.

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

    {
        return $element->getSelection();
    }

◆ hasComplexOptions()

ilAdvancedMDFieldDefinitionGroupBased::hasComplexOptions ( )

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 186 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        return true;
    }

◆ importComplexOptionFromForm()

ilAdvancedMDFieldDefinitionGroupBased::importComplexOptionFromForm	(		$a_option,
		ilADT	$a_adt
	)

protected

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

    {
        $this->complex[$a_option] = $a_adt->exportStdClass();
    }

References ilADT\exportStdClass().

Referenced by updateComplexOption().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ importCustomDefinitionFormPostValues()

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

Import custom post values from definition form.

Parameters

ilPropertyFormGUI	$a_form
string	$language

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 128 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $old = $this->getOptions();
        $new = $a_form->getInput("opts");
        
        if (is_array($old)) {
            $missing = array_diff($old, $new);
            if (sizeof($missing)) {
                foreach ($missing as $item) {
                    unset($this->complex[$item]);
                }
            }
        }
        
        $this->setOptions($new);
    }

References ilPropertyFormGUI\getInput(), getOptions(), and setOptions().

Here is the call graph for this function:

◆ importFieldDefinition()

ilAdvancedMDFieldDefinitionGroupBased::importFieldDefinition ( array $a_def )

protected

Import (type-specific) field definition from DB.

Parameters

array $a_def

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

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

    {
        $this->setOptions($a_def["options"]);
        $this->complex = $a_def["complex"];
    }

References setOptions().

Here is the call graph for this function:

◆ importValueFromXML()

ilAdvancedMDFieldDefinitionGroupBased::importValueFromXML ( $a_cdata )

Import value from xml.

Parameters

string $a_cdata

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 172 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $this->getADT()->setSelection($a_cdata);
    }

References ilAdvancedMDFieldDefinition\getADT().

Here is the call graph for this function:

◆ importXMLProperty()

ilAdvancedMDFieldDefinitionGroupBased::importXMLProperty	(	$a_key,
		$a_value
	)

Import property from XML.

Parameters

string	$a_key
string	$a_value

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 157 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $this->options[] = $a_value;
    }

◆ initADTDefinition()

ilAdvancedMDFieldDefinitionGroupBased::initADTDefinition ( )

protected

Init adt instance.

Returns: ilADTDefinition

Reimplemented from ilAdvancedMDFieldDefinition.

Reimplemented in ilAdvancedMDFieldDefinitionText.

Definition at line 24 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $def = ilADTFactory::getInstance()->getDefinitionInstanceByType("Enum");
        $def->setNumeric(false);
        
        $options = $this->getOptions();
        $def->setOptions($options);
        return $def;
    }

References $options, ilADTFactory\getInstance(), and getOptions().

Here is the call graph for this function:

◆ initOptionForm()

ilAdvancedMDFieldDefinitionGroupBased::initOptionForm	(	ilPropertyFormGUI	$a_form,
			$a_option_id
	)

Definition at line 223 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        global $lng;
        
        $option = $this->findOptionById($a_option_id);
        if ($option) {
            $title = new ilTextInputGUI($lng->txt("option"), "option");
            $title->setValue($option);
            $title->setDisabled(true);
            $a_form->addItem($title);
            
            $adt = $this->getADTForOption($option);
            $adt_form = ilADTFactory::getInstance()->getFormBridgeForInstance($adt);
            $adt_form->setForm($a_form);
            
            $titles = $this->getTitles();
            foreach ($adt_form->getElements() as $id => $element) {
                $element->setTitle($titles[$id]);
            }
            
            $adt_form->addToForm();
        }
    }

References ilAdvancedMDFieldDefinition\$adt, $lng, ilAdvancedMDFieldDefinition\$title, ilPropertyFormGUI\addItem(), findOptionById(), getADTForOption(), ilADTFactory\getInstance(), and getTitles().

Here is the call graph for this function:

◆ setOptions()

ilAdvancedMDFieldDefinitionGroupBased::setOptions ( array $a_values = null )

Set options.

Parameters

array $a_values

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

    {
        if ($a_values !== null) {
            foreach ($a_values as $idx => $value) {
                $a_values[$idx] = trim($value);
                if (!$a_values[$idx]) {
                    unset($a_values[$idx]);
                }
            }
            $a_values = array_unique($a_values);
            // sort($a_values);
        }
        $this->options = $a_values;
    }

Referenced by importCustomDefinitionFormPostValues(), and importFieldDefinition().

Here is the caller graph for this function:

◆ updateComplexOption()

ilAdvancedMDFieldDefinitionGroupBased::updateComplexOption	(	ilPropertyFormGUI	$a_form,
			$a_option_id
	)

Definition at line 247 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

    {
        $option = $this->findOptionById($a_option_id);
        if ($option) {
            $adt = ilADTFactory::getInstance()->getInstanceByDefinition($this->getADTGroup());
            $adt_form = ilADTFactory::getInstance()->getFormBridgeForInstance($adt);
            $adt_form->setForm($a_form);
            if ($adt_form->validate()) {
                $adt_form->importFromPost();
                $this->importComplexOptionFromForm($option, $adt);
                return true;
            }
        }
    
        return false;
    }

References ilAdvancedMDFieldDefinition\$adt, findOptionById(), getADTGroup(), ilADTFactory\getInstance(), and importComplexOptionFromForm().

Here is the call graph for this function:

Field Documentation

◆ $complex

ilAdvancedMDFieldDefinitionGroupBased::$complex = array()

protected

Definition at line 17 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

◆ $options

ilAdvancedMDFieldDefinitionGroupBased::$options = array()

protected

Definition at line 16 of file class.ilAdvancedMDFieldDefinitionGroupBased.php.

Referenced by addCustomFieldToDefinitionForm(), getOptions(), and initADTDefinition().

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

Services/AdvancedMetaData/classes/Types/class.ilAdvancedMDFieldDefinitionGroupBased.php

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addCustomFieldToDefinitionForm()

◆ addPropertiesToXML()

◆ exportOptionToTableGUI()

◆ findOptionById()

◆ getADTForOption()

◆ getADTGroup()

◆ getComplexOptionsOverview()

◆ getFieldDefinition()

◆ getFieldDefinitionForTableGUI()

◆ getOptions()

◆ getTitles()

◆ getValueForXML()

◆ hasComplexOptions()

◆ importComplexOptionFromForm()

◆ importCustomDefinitionFormPostValues()

◆ importFieldDefinition()

◆ importValueFromXML()

◆ importXMLProperty()

◆ initADTDefinition()

◆ initOptionForm()

◆ setOptions()

◆ updateComplexOption()

Field Documentation

◆ $complex

◆ $options