ilDclReferenceFieldRepresentation Class Reference

Class ilDclTextFieldRepresentation. More...

Inheritance diagram for ilDclReferenceFieldRepresentation:

Collaboration diagram for ilDclReferenceFieldRepresentation:

Public Member Functions
	getInputField (ilPropertyFormGUI $form, $record_id=0)
	Returns field-input. More...
	addFilterInputFieldToTable (ilTable2GUI $table)
	Add filter input to TableGUI. More...
	passThroughFilter (ilDclBaseRecordModel $record, $filter)
	Checks if a filter affects a record. More...
	buildFieldCreationInput (ilObjDataCollection $dcl, $mode='create')
	@inheritDoc More...
Public Member Functions inherited from ilDclBaseFieldRepresentation
	__construct (ilDclBaseFieldModel $field)
	addFilterInputFieldToTable (ilTable2GUI $table)
	Add filter input to TableGUI. More...
	passThroughFilter (ilDclBaseRecordModel $record, $filter)
	Checks if a filter affects a record. More...
	parseSortingValue ($value, $link=true)
	getInputField (ilPropertyFormGUI $form, $record_id=0)
	Returns field-input. More...
	addFieldCreationForm ($form, ilObjDataCollection $dcl, $mode="create")
	Adds the options for the field-types to the field-creation form. More...
	getPropertyInputFieldId ($property)
	Return post-var for property-fields. More...
	getField ()
	Return BaseFieldModel. More...

Data Fields
const	REFERENCE_SEPARATOR = " -> "

Additional Inherited Members
Protected Member Functions inherited from ilDclBaseFieldRepresentation
	setupFilterInputField (ilFormPropertyGUI $input)
	Set basic settings for filter-input-gui. More...
	setupInputField (ilFormPropertyGUI $input, ilDclBaseFieldModel $field)
	Sets basic settings on field-input. More...
	getFilterInputFieldValue ( $input)
	buildFieldCreationInput (ilObjDataCollection $dcl, $mode='create')
	Build the creation-input-field. More...
Protected Attributes inherited from ilDclBaseFieldRepresentation
	$field
	$lng
	$ctrl

Detailed Description

Class ilDclTextFieldRepresentation.

Author

Michael Herren mh@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Version

1.0.0

Definition at line 9 of file class.ilDclReferenceFieldRepresentation.php.

Member Function Documentation

addFilterInputFieldToTable()

ilDclReferenceFieldRepresentation::addFilterInputFieldToTable

(

ilTable2GUI

$table

)

Add filter input to TableGUI.

Parameters

ilTable2GUI

$table

Returns

null

Reimplemented from ilDclBaseFieldRepresentation.

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

    {
        $input = $table->addFilterItemByMetaType("filter_" . $this->getField()->getId(), ilTable2GUI::FILTER_SELECT, false, $this->getField()->getId());
        $ref_field_id = $this->getField()->getProperty(ilDclBaseFieldModel::PROP_REFERENCE);
        $ref_field = ilDclCache::getFieldCache($ref_field_id);
        $ref_table = ilDclCache::getTableCache($ref_field->getTableId());
        $options = array();
        foreach ($ref_table->getRecords() as $record) {
            $options[$record->getId()] = $record->getRecordFieldPlainText($ref_field_id);
        }
        // Sort by values ASC
        asort($options);
        $options = array('' => $this->lng->txt('dcl_all_entries'))
            + $options
            + array('none' => $this->lng->txt('dcl_no_entry'));
        $input->setOptions($options);
 
        $this->setupFilterInputField($input);
 
        return $this->getFilterInputFieldValue($input);
    }

References ilTable2GUI\addFilterItemByMetaType(), ilTable2GUI\FILTER_SELECT, ilDclBaseFieldRepresentation\getField(), ilDclCache\getFieldCache(), ilDclBaseFieldRepresentation\getFilterInputFieldValue(), ilDclCache\getTableCache(), ilDclBaseFieldModel\PROP_REFERENCE, and ilDclBaseFieldRepresentation\setupFilterInputField().

Here is the call graph for this function:

buildFieldCreationInput()

ilDclReferenceFieldRepresentation::buildFieldCreationInput	(	ilObjDataCollection	$dcl,
			$mode = 'create'
	)

@inheritDoc

Reimplemented from ilDclBaseFieldRepresentation.

Definition at line 134 of file class.ilDclReferenceFieldRepresentation.php.

    {
        $opt = parent::buildFieldCreationInput($dcl, $mode);
 
        $options = array();
        // Get Tables
        $tables = $dcl->getTables();
        foreach ($tables as $table) {
            foreach ($table->getRecordFields() as $field) {
                //referencing references may lead to endless loops.
                if ($field->getDatatypeId() != ilDclDatatype::INPUTFORMAT_REFERENCE) {
                    $options[$field->getId()] = $table->getTitle() . self::REFERENCE_SEPARATOR . $field->getTitle();
                }
            }
        }
        $prop_table_selection = new ilSelectInputGUI($this->lng->txt('dcl_reference_title'), 'prop_' . ilDclBaseFieldModel::PROP_REFERENCE);
        $prop_table_selection->setOptions($options);
 
        $opt->addSubItem($prop_table_selection);
 
        $prop_ref_link = new ilDclCheckboxInputGUI($this->lng->txt('dcl_reference_link'), 'prop_' . ilDclBaseFieldModel::PROP_REFERENCE_LINK);
        $prop_ref_link->setInfo($this->lng->txt('dcl_reference_link_info'));
        $opt->addSubItem($prop_ref_link);
 
        $prop_multi_select = new ilDclCheckboxInputGUI($this->lng->txt('dcl_multiple_selection'), 'prop_' . ilDclBaseFieldModel::PROP_N_REFERENCE);
        $opt->addSubItem($prop_multi_select);
 
        return $opt;
    }

References ilDclBaseFieldRepresentation\$field, ilObjDataCollection\getTables(), ilDclDatatype\INPUTFORMAT_REFERENCE, ilDclBaseFieldModel\PROP_N_REFERENCE, ilDclBaseFieldModel\PROP_REFERENCE, and ilDclBaseFieldModel\PROP_REFERENCE_LINK.

Here is the call graph for this function:

getInputField()

ilDclReferenceFieldRepresentation::getInputField	(	ilPropertyFormGUI	$form,
			$record_id = 0
	)

Returns field-input.

Parameters

ilPropertyFormGUI	$form
int	$record_id

Returns

null

Reimplemented from ilDclBaseFieldRepresentation.

Definition at line 14 of file class.ilDclReferenceFieldRepresentation.php.

    {
        if (!$this->getField()->getProperty(ilDclBaseFieldModel::PROP_N_REFERENCE)) {
            $input = new ilSelectInputGUI($this->getField()->getTitle(), 'field_' . $this->getField()->getId());
        } else {
            $input = new ilMultiSelectInputGUI($this->getField()->getTitle(), 'field_' . $this->getField()->getId());
            $input->setWidth(100);
            $input->setWidthUnit('%');
        }
 
        $this->setupInputField($input, $this->getField());
 
        $fieldref = $this->getField()->getProperty(ilDclBaseFieldModel::PROP_REFERENCE);
 
        $reffield = ilDclCache::getFieldCache($fieldref);
        $options = array();
        if (!$this->getField()->getProperty(ilDclBaseFieldModel::PROP_N_REFERENCE)) {
            $options[""] = $this->lng->txt('dcl_please_select');
        }
        $reftable = ilDclCache::getTableCache($reffield->getTableId());
        foreach ($reftable->getRecords() as $record) {
            // If the referenced field is MOB or FILE, we display the filename in the dropdown
            switch ($reffield->getDatatypeId()) {
                case ilDclDatatype::INPUTFORMAT_FILE:
                    $file_obj = new ilObjFile($record->getRecordFieldValue($fieldref), false);
                    $options[$record->getId()] = $file_obj->getFileName();
                    break;
                case ilDclDatatype::INPUTFORMAT_MOB:
                    $media_obj = new ilObjMediaObject($record->getRecordFieldValue($fieldref), false);
                    $options[$record->getId()] = $media_obj->getTitle();
                    break;
                case ilDclDatatype::INPUTFORMAT_DATETIME:
                    $options[$record->getId()] = strtotime($record->getRecordFieldSingleHTML($fieldref));
                    // TT #0019091: options2 are the actual values, options the timestamp for sorting
                    $options2[$record->getId()] = $record->getRecordFieldSingleHTML($fieldref);
                    break;
                case ilDclDatatype::INPUTFORMAT_TEXT:
                    $value = $record->getRecordFieldValue($fieldref);
                    if ($record->getRecordField($fieldref)->getField()->hasProperty(ilDclBaseFieldModel::PROP_URL)) {
                        if (!is_array($value)) {
                            $value = array('title' => '', 'link' => $value);
                        }
                        $value = $value['title'] ? $value['title'] : $value['link'];
                    }
                    $options[$record->getId()] = $value;
                    break;
                case ilDclDatatype::INPUTFORMAT_ILIAS_REF:
                    $options[$record->getId()] = $record->getRecordFieldRepresentationValue($fieldref);
                    break;
                default:
                    $options[$record->getId()] = $record->getRecordFieldExportValue($fieldref);
                    break;
            }
        }
        asort($options);
 
        // TT #0019091: restore the actual values after sorting with timestamp
        if ($reffield->getDatatypeId() == ilDclDatatype::INPUTFORMAT_DATETIME) {
            foreach ($options as $key => $opt) {
                $options[$key] = $options2[$key];
            }
            // the option 'please select' messes with the order, therefore we reset it
            unset($options[""]);
            $options = array("" => $this->lng->txt('dcl_please_select')) + $options;
        }
 
        $input->setOptions($options);
 
        if (ilObjDataCollectionAccess::hasPermissionToAddRecord($_GET['ref_id'], $reftable->getId())) {
            $input->addCustomAttribute('data-ref="1"');
            $input->addCustomAttribute('data-ref-table-id="' . $reftable->getId() . '"');
            $input->addCustomAttribute('data-ref-field-id="' . $reffield->getId() . '"');
        }
 
        return $input;
    }

References $_GET, ilDclBaseFieldRepresentation\getField(), ilDclCache\getFieldCache(), ilDclCache\getTableCache(), ilObjDataCollectionAccess\hasPermissionToAddRecord(), ilDclDatatype\INPUTFORMAT_DATETIME, ilDclDatatype\INPUTFORMAT_FILE, ilDclDatatype\INPUTFORMAT_ILIAS_REF, ilDclDatatype\INPUTFORMAT_MOB, ilDclDatatype\INPUTFORMAT_TEXT, ilDclBaseFieldModel\PROP_N_REFERENCE, ilDclBaseFieldModel\PROP_REFERENCE, ilDclBaseFieldModel\PROP_URL, and ilDclBaseFieldRepresentation\setupInputField().

Here is the call graph for this function:

passThroughFilter()

ilDclReferenceFieldRepresentation::passThroughFilter	(	ilDclBaseRecordModel	$record,
			$filter
	)

Checks if a filter affects a record.

Parameters

ilDclBaseRecordModel	$record
	$filter

Returns

bool

Reimplemented from ilDclBaseFieldRepresentation.

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

    {
        $value = $record->getRecordFieldValue($this->getField()->getId());
 
        $pass = false;
        if ($filter && $this->getField()->getProperty(ilDclBaseFieldModel::PROP_N_REFERENCE) && is_array($value) && in_array($filter, $value)) {
            $pass = true;
        }
        if (!$filter || $filter == $value) {
            $pass = true;
        }
 
        return $pass;
    }

References $pass, ilDclBaseFieldRepresentation\getField(), ilDclBaseRecordModel\getRecordFieldValue(), and ilDclBaseFieldModel\PROP_N_REFERENCE.

Here is the call graph for this function:

Field Documentation

REFERENCE_SEPARATOR

const ilDclReferenceFieldRepresentation::REFERENCE_SEPARATOR = " -> "

Definition at line 11 of file class.ilDclReferenceFieldRepresentation.php.

---

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

• Modules/DataCollection/classes/Fields/Reference/class.ilDclReferenceFieldRepresentation.php