ilDclSelectionRecordFieldModel Class Reference

Class ilDclSelectionRecordFieldModel. More...

Inheritance diagram for ilDclSelectionRecordFieldModel:

Collaboration diagram for ilDclSelectionRecordFieldModel:

Public Member Functions
	getValue ()
	setValueFromForm ($form)
	parseExportValue ($value)
	getValueFromExcel ($excel, $row, $col)
Public Member Functions inherited from ilDclBaseRecordFieldModel
	__construct (ilDclBaseRecordModel $record, ilDclBaseFieldModel $field)
	doCreate ()
	Creates an Id and a database entry. More...
	doUpdate ()
	Update object in database. More...
	delete ()
	Delete record field in database. More...
	getValue ()
	getValueForRepresentation ()
	serializeData ($value)
	Serialize data before storing to db. More...
	deserializeData ($value)
	Deserialize data before applying to field. More...
	setValue ($value, $omit_parsing=false)
	Set value for record field. More...
	setValueFromForm ($form)
	parseExportValue ($value)
	Function to parse incoming data from form input value $value. More...
	getValueFromExcel ($excel, $row, $col)
	parseValue ($value)
	Function to parse incoming data from form input value $value. More...
	getExportValue ()
	fillExcelExport (ilExcel $worksheet, &$row, &$col)
	getPlainText ()
	getSortingValue ($link=true)
	addHiddenItemsToConfirmation (ilConfirmationGUI &$confirmation)
	parseSortingValue ($value, $link=true)
	Returns sortable value for the specific field-types. More...
	cloneStructure (ilDclBaseRecordFieldModel $old_record_field)
	afterClone ()
	getField ()
	getId ()
	getRecord ()
	getRecordRepresentation ()
	setRecordRepresentation ($record_representation)
	getFieldRepresentation ()
	setFieldRepresentation ($field_representation)

Data Fields
const	PROP_SELECTION_TYPE = ''
const	PROP_SELECTION_OPTIONS = ''

Protected Member Functions
	getMultipleValuesFromString ($stringValues)
	Copied from reference field and slightly adjusted. More...
Protected Member Functions inherited from ilDclBaseRecordFieldModel
	doRead ()
	Read object data from database. More...
	loadValue ()
	Load the value. More...

Additional Inherited Members
Protected Attributes inherited from ilDclBaseRecordFieldModel
	$id
	$field
	$record
	$record_representation
	$field_representation
	$value
	$user
	$ctrl
	$db
	$lng

Detailed Description

Class ilDclSelectionRecordFieldModel.

Author

Theodor Truffer tt@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

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

Member Function Documentation

getMultipleValuesFromString()

ilDclSelectionRecordFieldModel::getMultipleValuesFromString (   $stringValues )

protected

Copied from reference field and slightly adjusted.

This method tries to get as many valid values out of a string separated by commata. This is problematic as a string value could contain commata itself. It is optimized to work with an exported list from this DataCollection. And works fine in most cases. Only areference list with the values "hello" and "hello, world" Will mess with it.

Parameters

$stringValues

string

Returns

int[]

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

References $delimiter, $i, $options, array, and ilDclBaseRecordFieldModel\getField().

Referenced by getValueFromExcel().

    {
        $delimiter = strpos($stringValues, '; ') ? '; ' : ', ';
        $slicedStrings = explode($delimiter, $stringValues);
        $slicedReferences = array();
        $resolved = 0;
        for ($i = 0; $i < count($slicedStrings); $i++) {
            //try to find a reference since the last resolved value separated by a comma.
            // $i = 1; $resolved = 0; $string = "hello, world, gaga" -> try to match "hello, world".
            $searchString = implode(array_slice($slicedStrings, $resolved, $i - $resolved + 1));
            if ($ref = $this->getValueFromString($searchString)) {
                $slicedReferences[] = $ref;
                $resolved = $i;
                continue;
            }

            //try to find a reference with the current index.
            // $i = 1; $resolved = 0; $string = "hello, world, gaga" -> try to match "world".
            $searchString = $slicedStrings[$i];
            if ($ref = $this->getValueFromString($searchString)) {
                $slicedReferences[] = $ref;
                $resolved = $i;
                continue;
            }
        }
        return $slicedReferences;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getValue()

ilDclSelectionRecordFieldModel::getValue

(

)

Returns

array|mixed|string

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

References ilDclBaseRecordFieldModel\$value, array, and ilDclBaseRecordFieldModel\getField().

    {
        if ($this->getField()->isMulti() && !is_array($this->value)) {
            return array($this->value);
        }
        if (!$this->getField()->isMulti() && is_array($this->value)) {
            return (count($this->value) == 1) ? array_shift($this->value) : '';
        }
        return $this->value;
    }

Here is the call graph for this function:

getValueFromExcel()

ilDclSelectionRecordFieldModel::getValueFromExcel	(		$excel,
			$row,
			$col
	)

Parameters

$excel
$row
$col

Returns

array|int|int[]|string

Definition at line 56 of file class.ilDclSelectionRecordFieldModel.php.

References $DIC, ilDclBaseRecordFieldModel\$lng, $old, $row, $warning, array, ilDataCollectionImporter\getExcelCharForInteger(), ilDclBaseRecordFieldModel\getField(), and getMultipleValuesFromString().

    {
        global $DIC;
        $lng = $DIC['lng'];
        $string = parent::getValueFromExcel($excel, $row, $col);
        $old = $string;
        if ($this->getField()->isMulti()) {
            $string = $this->getMultipleValuesFromString($string);
            $has_value = count($string);
        } else {
            $string = $this->getValueFromString($string);
            $has_value = $string;
        }

        if (!$has_value && $old) {
            $warning = "(" . $row . ", " . ilDataCollectionImporter::getExcelCharForInteger($col+1) . ") " . $lng->txt("dcl_no_such_reference") . " "
                . $old;
            return array('warning' => $warning);
        }

        return $string;
    }

Here is the call graph for this function:

parseExportValue()

ilDclSelectionRecordFieldModel::parseExportValue

(

$value

)

Parameters

mixed

$value

Returns

string

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

References ilDclBaseRecordFieldModel\$value, ilDclBaseRecordFieldModel\getField(), ilDclBaseRecordFieldModel\getId(), and ilDclSelectionOption\getValues().

    {
        $values = ilDclSelectionOption::getValues($this->getField()->getId(), $value);
        return is_array($values) ? implode("; ", $values) : $values;
    }

Here is the call graph for this function:

setValueFromForm()

ilDclSelectionRecordFieldModel::setValueFromForm

(

$form

)

Definition at line 31 of file class.ilDclSelectionRecordFieldModel.php.

References $form.

    {
        parent::setValueFromForm($form); // TODO: Change the autogenerated stub
    }

Field Documentation

PROP_SELECTION_OPTIONS

const ilDclSelectionRecordFieldModel::PROP_SELECTION_OPTIONS = ''

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

PROP_SELECTION_TYPE

const ilDclSelectionRecordFieldModel::PROP_SELECTION_TYPE = ''

Definition at line 13 of file class.ilDclSelectionRecordFieldModel.php.

---

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

• Modules/DataCollection/classes/Fields/Selection/class.ilDclSelectionRecordFieldModel.php