ilDclFieldEditGUI Class Reference

Class ilDclFieldEditGUI. More...

Collaboration diagram for ilDclFieldEditGUI:

Public Member Functions
	__construct (ilDclTableListGUI $a_parent_obj)
	Constructor. More...
	executeCommand ()
	execute command More...
	create ()
	create field add form More...
	edit ()
	create field edit form More...
	permissionDenied ()
	confirmDelete ()
	confirmDelete More...
	cancelDelete ()
	cancelDelete More...
	delete ()
	cancel ()
	initForm ($a_mode="create")
	initEditCustomForm More...
	save ($a_mode="create")
	save Field More...
	getDataCollectionObject ()

Protected Member Functions
	checkInput ($a_mode)
	Check input of form. More...
	checkAccess ()

Protected Attributes
	$obj_id
	$table_id
	$parent_obj
	$table
	$form
	$field_obj

Detailed Description

Class ilDclFieldEditGUI.

Author

Martin Studer ms@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Marcel Raimann mr@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Oskar Truffer ot@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Version

$Id:

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

Constructor & Destructor Documentation

__construct()

ilDclFieldEditGUI::__construct

(

ilDclTableListGUI

$a_parent_obj

)

Constructor.

Parameters

ilDclTableListGUI	$a_parent_obj
int	$table_id	We need a table_id if no field_id is set (creation mode). We ignore the table_id by edit mode
int	$field_id	The field_id of a existing fiel (edit mode)

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

References $_GET, $_POST, $DIC, $ilCtrl, ilDclDatatype\getAllDatatype(), ilDclCache\getFieldCache(), ilDclFieldFactory\getFieldModelInstance(), and ilDclCache\getTableCache().

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        $this->obj_id = $a_parent_obj->obj_id;
        $this->parent_obj = $a_parent_obj;

        $this->table_id = $_GET["table_id"];
        $this->field_id = $_GET['field_id'];

        if ($this->field_id) {
            $this->field_obj = ilDclCache::getFieldCache($this->field_id);
        } else {
            $datatype = null;
            if (isset($_POST['datatype']) && in_array($_POST['datatype'], array_keys(ilDclDatatype::getAllDatatype()))) {
                $datatype = $_POST['datatype'];
            }
            $this->field_obj = ilDclFieldFactory::getFieldModelInstance($this->field_id, $datatype);
            if (!$this->table_id) {
                $ilCtrl->redirectByClass("ilDclTableListGUI", "listFields");
            }
            $this->field_obj->setTableId($this->table_id);
            $ilCtrl->saveParameter($this, "table_id");
        }

        $this->table = ilDclCache::getTableCache($this->table_id);
    }

Here is the call graph for this function:

Member Function Documentation

cancel()

ilDclFieldEditGUI::cancel

(

)

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

References $DIC, and $ilCtrl.

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $ilCtrl->redirectByClass("ildclfieldlistgui", "listFields");
    }

cancelDelete()

ilDclFieldEditGUI::cancelDelete

(

)

cancelDelete

Definition at line 180 of file class.ilDclFieldEditGUI.php.

References $DIC, and $ilCtrl.

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        $ilCtrl->redirectByClass("ildclfieldlistgui", "listFields");
    }

checkAccess()

ilDclFieldEditGUI::checkAccess ( )

protected

Returns

bool

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

References getDataCollectionObject(), ilObjDataCollectionAccess\hasAccessToField(), and ilObjDataCollectionAccess\hasAccessToFields().

Referenced by executeCommand().

    {
        if ($field_id = $this->field_obj->getId()) {
            return ilObjDataCollectionAccess::hasAccessToField($this->getDataCollectionObject()->ref_id, $this->table_id, $field_id);
        } else {
            return ilObjDataCollectionAccess::hasAccessToFields($this->getDataCollectionObject()->ref_id, $this->table_id);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkInput()

ilDclFieldEditGUI::checkInput (   $a_mode )

protected

Check input of form.

Parameters

$a_mode

'create' | 'update'

Returns

bool

Definition at line 358 of file class.ilDclFieldEditGUI.php.

References $DIC, $lng, $title, ilDclTable\_hasFieldByTitle(), ilDclFieldFactory\getFieldModelInstanceByClass(), and ilUtil\sendFailure().

Referenced by save().

    {
        global $DIC;
        $lng = $DIC['lng'];
        $return = $this->form->checkInput();

        // load specific model for input checking
        $datatype_id = $this->form->getInput('datatype');
        if ($datatype_id != null && is_numeric($datatype_id)) {
            $base_model = new ilDclBaseFieldModel();
            $base_model->setDatatypeId($datatype_id);
            $field_validation_class = ilDclFieldFactory::getFieldModelInstanceByClass($base_model);

            if (!$field_validation_class->checkFieldCreationInput($this->form)) {
                $return = false;
            }
        }

        // Don't allow multiple fields with the same title in this table
        if ($a_mode == 'create') {
            if ($title = $this->form->getInput('title')) {
                if (ilDclTable::_hasFieldByTitle($title, $this->table_id)) {
                    $inputObj = $this->form->getItemByPostVar('title');
                    $inputObj->setAlert($lng->txt("dcl_field_title_unique"));
                    $return = false;
                }
            }
        }

        if (!$return) {
            ilUtil::sendFailure($lng->txt("form_input_not_valid"));
        }

        return $return;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

confirmDelete()

ilDclFieldEditGUI::confirmDelete

(

)

confirmDelete

Definition at line 156 of file class.ilDclFieldEditGUI.php.

References $DIC, $ilCtrl, $lng, and $tpl.

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];

        include_once './Services/Utilities/classes/class.ilConfirmationGUI.php';
        $conf = new ilConfirmationGUI();
        $conf->setFormAction($ilCtrl->getFormAction($this));
        $conf->setHeaderText($lng->txt('dcl_confirm_delete_field'));

        $conf->addItem('field_id', (int) $this->field_obj->getId(), $this->field_obj->getTitle());

        $conf->setConfirm($lng->txt('delete'), 'delete');
        $conf->setCancel($lng->txt('cancel'), 'cancelDelete');

        $tpl->setContent($conf->getHTML());
    }

create()

ilDclFieldEditGUI::create

(

)

create field add form

Definition at line 116 of file class.ilDclFieldEditGUI.php.

References $DIC, $tpl, and initForm().

    {
        global $DIC;
        $tpl = $DIC['tpl'];

        $this->initForm();
        $tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

delete()

ilDclFieldEditGUI::delete

(

)

Definition at line 192 of file class.ilDclFieldEditGUI.php.

References $DIC, and $ilCtrl.

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        $this->table->deleteField($this->field_obj->getId());
        $ilCtrl->redirectByClass("ildclfieldlistgui", "listFields");
    }

edit()

ilDclFieldEditGUI::edit

(

)

create field edit form

Definition at line 129 of file class.ilDclFieldEditGUI.php.

References $DIC, $tpl, and initForm().

    {
        global $DIC;
        $tpl = $DIC['tpl'];

        $this->initForm("edit");

        $this->field_obj->fillPropertiesForm($this->form);

        $tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

executeCommand()

ilDclFieldEditGUI::executeCommand

(

)

execute command

Definition at line 86 of file class.ilDclFieldEditGUI.php.

References $DIC, $ilCtrl, checkAccess(), permissionDenied(), and save().

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $ilCtrl->saveParameter($this, 'field_id');

        $cmd = $ilCtrl->getCmd();

        if (!$this->checkAccess()) {
            $this->permissionDenied();

            return;
        }

        switch ($cmd) {
            case "update":
                $this->save("update");
                break;
            default:
                $this->$cmd();
                break;
        }

        return true;
    }

Here is the call graph for this function:

getDataCollectionObject()

ilDclFieldEditGUI::getDataCollectionObject

(

)

Returns

ilObjDataCollection

Definition at line 410 of file class.ilDclFieldEditGUI.php.

Referenced by checkAccess(), and initForm().

    {
        return $this->parent_obj->getDataCollectionObject();
    }

Here is the caller graph for this function:

initForm()

ilDclFieldEditGUI::initForm

(

$a_mode = "create"

)

initEditCustomForm

Parameters

string

$a_mode

values: create | edit

Definition at line 218 of file class.ilDclFieldEditGUI.php.

References $DIC, $field_obj, $ilCtrl, $lng, ilDclBaseFieldModel\_getTitleInvalidChars(), ilDclDatatype\getAllDatatype(), getDataCollectionObject(), ilDclFieldFactory\getFieldRepresentationInstance(), ilFormPropertyGUI\setInfo(), and ilFormPropertyGUI\setRequired().

Referenced by create(), edit(), and save().

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];

        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $this->form = new ilPropertyFormGUI();

        if ($a_mode == "edit") {
            $this->form->setTitle($lng->txt('dcl_edit_field'));
            $hidden_prop = new ilHiddenInputGUI("field_id");
            $this->form->addItem($hidden_prop);

            $this->form->setFormAction($ilCtrl->getFormAction($this), "update");

            $this->form->addCommandButton('update', $lng->txt('dcl_update_field'));
        } else {
            $this->form->setTitle($lng->txt('dcl_new_field'));
            $hidden_prop = new ilHiddenInputGUI("table_id");
            $hidden_prop->setValue($this->field_obj->getTableId());
            $this->form->addItem($hidden_prop);

            $this->form->setFormAction($ilCtrl->getFormAction($this), "save");

            $this->form->addCommandButton('save', $lng->txt('dcl_create_field'));
        }
        $this->form->addCommandButton('cancel', $lng->txt('cancel'));

        $text_prop = new ilTextInputGUI($lng->txt("title"), "title");
        $text_prop->setRequired(true);
        $text_prop->setInfo(sprintf($lng->txt('fieldtitle_allow_chars'), ilDclBaseFieldModel::_getTitleInvalidChars(false)));
        $text_prop->setValidationRegexp(ilDclBaseFieldModel::_getTitleInvalidChars(true));
        $this->form->addItem($text_prop);

        // Description
        $text_prop = new ilTextAreaInputGUI($lng->txt("dcl_field_description"), "description");
        $this->form->addItem($text_prop);

        $edit_datatype = new ilRadioGroupInputGUI($lng->txt('dcl_datatype'), 'datatype');

        foreach (ilDclDatatype::getAllDatatype() as $datatype) {
            $model = new ilDclBaseFieldModel();
            $model->setDatatypeId($datatype->getId());

            if ($a_mode == 'edit' && $datatype->getId() == $this->field_obj->getDatatypeId()) {
                $model = $this->field_obj;
            }

            $field_representation = ilDclFieldFactory::getFieldRepresentationInstance($model);
            $field_representation->addFieldCreationForm($edit_datatype, $this->getDataCollectionObject(), $a_mode);
        }
        $edit_datatype->setRequired(true);

        //you can't change type but we still need it in POST
        if ($a_mode == "edit") {
            $edit_datatype->setDisabled(true);
        }
        $this->form->addItem($edit_datatype);

        // Required
        $cb = new ilCheckboxInputGUI($lng->txt("dcl_field_required"), "required");
        $this->form->addItem($cb);

        //Unique
        $cb = new ilCheckboxInputGUI($lng->txt("dcl_unique"), "unique");
        $cb->setInfo($lng->txt('dcl_unique_desc'));
        $this->form->addItem($cb);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

permissionDenied()

ilDclFieldEditGUI::permissionDenied

(

)

Definition at line 145 of file class.ilDclFieldEditGUI.php.

References $DIC, and $tpl.

Referenced by executeCommand().

    {
        global $DIC;
        $tpl = $DIC['tpl'];
        $tpl->setContent("Permission denied");
    }

Here is the caller graph for this function:

save()

ilDclFieldEditGUI::save

(

$a_mode = "create"

)

save Field

Parameters

string

$a_mode

values: create | update

Definition at line 294 of file class.ilDclFieldEditGUI.php.

References $DIC, $ilCtrl, $lng, $title, $tpl, checkInput(), initForm(), and ilUtil\sendInfo().

Referenced by executeCommand().

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];

        $this->initForm($a_mode == "update" ? "edit" : "create");

        if ($this->checkInput($a_mode)) {

            // check if confirmation is needed and if so, fetch and render confirmationGUI
            if (($a_mode == "update") && !($this->form->getInput('confirmed')) && $this->field_obj->isConfirmationRequired($this->form)) {
                $ilConfirmationGUI = $this->field_obj->getConfirmationGUI($this->form);
                $tpl->setContent($ilConfirmationGUI->getHTML());

                return;
            }

            $title = $this->form->getInput("title");
            if ($a_mode != "create" && $title != $this->field_obj->getTitle()) {
                ilUtil::sendInfo($lng->txt("dcl_field_title_change_warning"), true);
            }

            $this->field_obj->setTitle($title);
            $this->field_obj->setDescription($this->form->getInput("description"));
            $this->field_obj->setDatatypeId($this->form->getInput("datatype"));
            $this->field_obj->setRequired($this->form->getInput("required"));
            $this->field_obj->setUnique($this->form->getInput("unique"));

            if ($a_mode == "update") {
                $this->field_obj->doUpdate();
            } else {
                $this->field_obj->setOrder($this->table->getNewFieldOrder());
                $this->field_obj->doCreate();
            }

            // Get possible properties and save them
            $this->field_obj->storePropertiesFromForm($this->form);

            $ilCtrl->setParameter($this, "field_id", $this->field_obj->getId());

            if ($a_mode == "update") {
                ilUtil::sendSuccess($lng->txt("dcl_msg_field_modified"), true);
            } else {
                $this->table->addField($this->field_obj);
                $this->table->buildOrderFields();
                ilUtil::sendSuccess($lng->txt("msg_field_created"), false);
            }
            $ilCtrl->redirectByClass(strtolower("ilDclFieldListGUI"), "listFields");
        } else {
            $this->form->setValuesByPost();
            $tpl->setContent($this->form->getHTML());
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$field_obj

ilDclFieldEditGUI::$field_obj

protected

Definition at line 43 of file class.ilDclFieldEditGUI.php.

Referenced by initForm().

$form

ilDclFieldEditGUI::$form

protected

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

$obj_id

ilDclFieldEditGUI::$obj_id

protected

Definition at line 23 of file class.ilDclFieldEditGUI.php.

$parent_obj

ilDclFieldEditGUI::$parent_obj

protected

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

$table

ilDclFieldEditGUI::$table

protected

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

$table_id

ilDclFieldEditGUI::$table_id

protected

Definition at line 27 of file class.ilDclFieldEditGUI.php.

---

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

• Modules/DataCollection/classes/Fields/class.ilDclFieldEditGUI.php