ilIndividualAssessmentMemberGUI Class Reference

For the purpose of streamlining the grading and learning-process status definition outside of tests, SCORM courses e.t.c. More...

Collaboration diagram for ilIndividualAssessmentMemberGUI:

Public Member Functions
	__construct ($members_gui, $a_parent_gui, $a_ref_id)
	executeCommand ()

Protected Member Functions
	setTabs (ilTabsGUI $tabs)
	getBackLink ()
	cancel ()
	finalizeConfirmation ()
	finalize ()
	mayBeEdited ()
	edit ()
	renderForm (ilPropertyFormGUI $a_form)
	view ()
	save ()
	updateDataInMemberByArray (ilIndividualAssessmentMember $member, $data)
	initGradingForm ($may_be_edited=true)
	fillForm (ilPropertyFormGUI $a_form, ilIndividualAssessmentMember $member)
	targetWasEditedByOtherUser (ilIndividualAssessmentMember $member)

Protected Attributes
	$notificator

Detailed Description

For the purpose of streamlining the grading and learning-process status definition outside of tests, SCORM courses e.t.c.

the IndividualAssessment is used. It caries a LPStatus, which is set Individually.

Author

Denis Klöpfer denis.nosp@m..klo.nosp@m.epfer.nosp@m.@con.nosp@m.cepts.nosp@m.-and.nosp@m.-trai.nosp@m.ning.nosp@m..de

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

Constructor & Destructor Documentation

__construct()

ilIndividualAssessmentMemberGUI::__construct	(		$members_gui,
			$a_parent_gui,
			$a_ref_id
	)

Definition at line 22 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                                    {
                        $this->notificator = new ilIndividualAssessmentPrimitiveInternalNotificator();
                        global $DIC;
                        $this->ctrl = $DIC['ilCtrl'];
                        $this->members_gui = $members_gui;
                        $this->parent_gui = $a_parent_gui;
                        $this->object = $a_parent_gui->object;
                        $this->ref_id = $a_ref_id;
                        $this->tpl =  $DIC['tpl'];
                        $this->lng = $DIC['lng'];
                        $this->ctrl->saveParameter($this,'usr_id');
                        $this->examinee = new ilObjUser($_GET['usr_id']);
                        $this->examiner = $DIC['ilUser'];
                        $this->setTabs($DIC['ilTabs']);
                        $this->member = $this->object->membersStorage()
                                                                ->loadMember($this->object, $this->examinee);
        }

References $_GET, $DIC, and setTabs().

Here is the call graph for this function:

Member Function Documentation

cancel()

ilIndividualAssessmentMemberGUI::cancel ( )

protected

Definition at line 83 of file class.ilIndividualAssessmentMemberGUI.php.

                                    {
                $this->ctrl->redirect($this->members_gui);
        }

edit()

ilIndividualAssessmentMemberGUI::edit ( )

protected

Definition at line 148 of file class.ilIndividualAssessmentMemberGUI.php.

                                  {
                if($this->mayBeEdited()) {
                        $this->parent_gui->setScreenId("iass", "member", "edit");
                        $form = $this->fillForm($this->initGradingForm(),$this->member);
                        $this->renderForm($form);
                } else {
                        $this->view();
                }
        }

References fillForm(), initGradingForm(), mayBeEdited(), renderForm(), and view().

Referenced by finalize(), and finalizeConfirmation().

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilIndividualAssessmentMemberGUI::executeCommand

(

)

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

                                         {
                $edited_by_other = $this->targetWasEditedByOtherUser($this->member);
                $read_permission = $this->object->accessHandler()->checkAccessToObj($this->object,'read_learning_progress');
                $edit_permission = $this->object->accessHandler()->checkAccessToObj($this->object,'edit_learning_progress');
                if(!$read_permission && !$edit_permission) {
                        $a_parent_gui->handleAccessViolation();
                }
                $cmd = $this->ctrl->getCmd();
                switch($cmd) {
                        case 'edit':
                        case 'save':
                        case 'finalize':
                        case 'finalizeConfirmation':
                                if($edited_by_other || !$edit_permission) {
                                        $a_parent_gui->handleAccessViolation();
                                }
                                break;
                        case 'view':
                                if(($edited_by_other || !$edit_permission) && !$read_permission) {
                                        $a_parent_gui->handleAccessViolation();
                                }
                                break;
                        case 'cancel':
                                break;
                        default:
                                $a_parent_gui->handleAccessViolation();
                }
                $this->$cmd();
        }

References $cmd, and targetWasEditedByOtherUser().

Here is the call graph for this function:

fillForm()

ilIndividualAssessmentMemberGUI::fillForm ( ilPropertyFormGUI  $a_form, ilIndividualAssessmentMember  $member  )

protected

Definition at line 244 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                                                     {
                $a_form->setValuesByArray(array(
                          'name' => $member->name()
                        , 'record' => $member->record()
                        , 'internal_note' => $member->internalNote()
                        , 'notify' => $member->notify()
                        , 'learning_progress' => (int)$member->LPStatus()
                        ));
                return $a_form;
        }

References ilIndividualAssessmentMember\internalNote(), ilIndividualAssessmentMember\LPStatus(), ilIndividualAssessmentMember\name(), ilIndividualAssessmentMember\notify(), ilIndividualAssessmentMember\record(), and ilPropertyFormGUI\setValuesByArray().

Referenced by edit(), and view().

Here is the call graph for this function:

Here is the caller graph for this function:

finalize()

ilIndividualAssessmentMemberGUI::finalize ( )

protected

Definition at line 118 of file class.ilIndividualAssessmentMemberGUI.php.

                                      {
                if($this->mayBeEdited()) {
                        $form = $this->initGradingForm();
                        $form->setValuesByArray($_POST);
                        if($form->checkInput()) {
                                $member = $this->updateDataInMemberByArray($this->member,$_POST);
                                if($member->mayBeFinalized()) {
                                        $this->member = $member->withFinalized()->maybeSendNotification($this->notificator);
                                        $this->object->membersStorage()->updateMember($this->member);
                                        ilUtil::sendSuccess($this->lng->txt('iass_membership_finalized'));
                                        if($this->object->isActiveLP()) {
                                                ilIndividualAssessmentLPInterface::updateLPStatusOfMember($this->member);
                                        }
                                        $this->view();
                                } else {
                                        ilUtil::sendFailure($this->lng->txt('iass_may_not_finalize'));
                                        $this->edit();
                                }
                        } else {
                                $this->edit();
                        }
                } else {
                        $this->view();
                }
        }

References $_POST, edit(), initGradingForm(), mayBeEdited(), ilUtil\sendFailure(), ilUtil\sendSuccess(), updateDataInMemberByArray(), ilIndividualAssessmentLPInterface\updateLPStatusOfMember(), and view().

Here is the call graph for this function:

finalizeConfirmation()

ilIndividualAssessmentMemberGUI::finalizeConfirmation ( )

protected

Definition at line 87 of file class.ilIndividualAssessmentMemberGUI.php.

                                                  {
                if($this->mayBeEdited()) {
                        $form = $this->initGradingForm();
                        $form->setValuesByArray($_POST);
                        if($form->checkInput()) {
                                $member = $this->updateDataInMemberByArray($this->member,$_POST);
                                if($member->mayBeFinalized()) {
                                        $this->parent_gui->setScreenId("iass", "member", "finalizeConfirmation");
                                        include_once './Services/Utilities/classes/class.ilConfirmationGUI.php';
                                        $confirm = new ilConfirmationGUI();
                                        $confirm->addHiddenItem('record', $_POST['record']);
                                        $confirm->addHiddenItem('internal_note', $_POST['internal_note']);
                                        $confirm->addHiddenItem('notify', $_POST['notify']);
                                        $confirm->addHiddenItem('learning_progress',$_POST['learning_progress']);
                                        $confirm->setHeaderText($this->lng->txt('iass_finalize_user_qst'));
                                        $confirm->setFormAction($this->ctrl->getFormAction($this));
                                        $confirm->setConfirm($this->lng->txt('iass_finalize'), 'finalize');
                                        $confirm->setCancel($this->lng->txt('cancel'), 'save');
                                        $this->tpl->setContent($confirm->getHTML());
                                } else {
                                        ilUtil::sendFailure($this->lng->txt('iass_may_not_finalize'));
                                        $this->edit();
                                }
                        } else {
                                $this->edit();
                        }
                } else {
                        $this->view();
                }
        }

References $_POST, edit(), initGradingForm(), mayBeEdited(), ilUtil\sendFailure(), updateDataInMemberByArray(), and view().

Here is the call graph for this function:

getBackLink()

ilIndividualAssessmentMemberGUI::getBackLink ( )

protected

Definition at line 76 of file class.ilIndividualAssessmentMemberGUI.php.

                                         {
                return $this->ctrl->getLinkTargetByClass(
                                array(get_class($this->parent_gui)
                                        ,get_class($this->members_gui))
                                ,'view');
        }

initGradingForm()

ilIndividualAssessmentMemberGUI::initGradingForm (   $may_be_edited = true )

protected

Definition at line 196 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                  {
                require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
                $form = new ilPropertyFormGUI();
                $form->setFormAction($this->ctrl->getFormAction($this));
                $form->setTitle($this->lng->txt('iass_edit_record'));
 
                $examinee_name = $this->examinee->getLastname().', '.$this->examinee->getFirstname();
 
                $usr_name = new ilNonEditableValueGUI($this->lng->txt('name'),'name');
                $form->addItem($usr_name);
                // record
                $ti = new ilTextAreaInputGUI($this->lng->txt('iass_record'), 'record');
                $ti->setInfo($this->lng->txt('iass_record_info'));
                $ti->setCols(40);
                $ti->setRows(5);
                $ti->setDisabled(!$may_be_edited);
                $form->addItem($ti);
 
                // description
                $ta = new ilTextAreaInputGUI($this->lng->txt('iass_internal_note'), 'internal_note');
                $ta->setInfo($this->lng->txt('iass_internal_note_info'));
                $ta->setCols(40);
                $ta->setRows(5);
                $ta->setDisabled(!$may_be_edited);
                $form->addItem($ta);
 
                $learning_progress = new ilSelectInputGUI($this->lng->txt('grading'),'learning_progress');
                $learning_progress->setOptions(
                        array(ilIndividualAssessmentMembers::LP_IN_PROGRESS => $this->lng->txt('iass_status_pending')
                                , ilIndividualAssessmentMembers::LP_COMPLETED => $this->lng->txt('iass_status_completed')
                                , ilIndividualAssessmentMembers::LP_FAILED => $this->lng->txt('iass_status_failed')));
                $learning_progress->setDisabled(!$may_be_edited);
                $form->addItem($learning_progress);
 
                // notify examinee
                $notify = new ilCheckboxInputGUI($this->lng->txt('iass_notify'), 'notify');
                $notify->setInfo($this->lng->txt('iass_notify_explanation'));
                $notify->setDisabled(!$may_be_edited);
                $form->addItem($notify);
 
                if($may_be_edited) {
                        $form->addCommandButton('save', $this->lng->txt('save'));
                        $form->addCommandButton('finalizeConfirmation',$this->lng->txt('iass_finalize'));
                }
                $form->addCommandButton('cancel', $this->lng->txt('iass_return'));
                return $form;
        }

References ilIndividualAssessmentMembers\LP_COMPLETED, ilIndividualAssessmentMembers\LP_FAILED, and ilIndividualAssessmentMembers\LP_IN_PROGRESS.

Referenced by edit(), finalize(), finalizeConfirmation(), save(), and view().

Here is the caller graph for this function:

mayBeEdited()

ilIndividualAssessmentMemberGUI::mayBeEdited ( )

protected

Definition at line 144 of file class.ilIndividualAssessmentMemberGUI.php.

                                         {
                return !$this->member->finalized() && !$this->targetWasEditedByOtherUser($this->member);
        }

References targetWasEditedByOtherUser().

Referenced by edit(), finalize(), finalizeConfirmation(), and save().

Here is the call graph for this function:

Here is the caller graph for this function:

renderForm()

ilIndividualAssessmentMemberGUI::renderForm ( ilPropertyFormGUI  $a_form )

protected

Definition at line 158 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                 {
                $this->tpl->setContent($a_form->getHTML());
        }

References ilPropertyFormGUI\getHTML().

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

Here is the call graph for this function:

Here is the caller graph for this function:

save()

ilIndividualAssessmentMemberGUI::save ( )

protected

Definition at line 168 of file class.ilIndividualAssessmentMemberGUI.php.

                                  {
                if($this->mayBeEdited()) {
                        $this->parent_gui->setScreenId("iass", "member", "save");
                        $form = $this->initGradingForm();
                        $form->setValuesByArray($_POST);
                        if($form->checkInput()) {
                                $this->member = $this->updateDataInMemberByArray($this->member,$_POST);
                                $this->object->membersStorage()->updateMember($this->member);
                                ilUtil::sendSuccess($this->lng->txt('iass_membership_saved'));
                                if($this->object->isActiveLP()) {
                                        ilIndividualAssessmentLPInterface::updateLPStatusOfMember($this->member);
                                }
                        }
                        $this->renderForm($form);
                } else {
                        $this->view();
                }
        }

References $_POST, initGradingForm(), mayBeEdited(), renderForm(), ilUtil\sendSuccess(), updateDataInMemberByArray(), ilIndividualAssessmentLPInterface\updateLPStatusOfMember(), and view().

Here is the call graph for this function:

setTabs()

ilIndividualAssessmentMemberGUI::setTabs ( ilTabsGUI  $tabs )

protected

Definition at line 70 of file class.ilIndividualAssessmentMemberGUI.php.

                                                    {
                $tabs->clearTargets();
                $tabs->setBackTarget($this->lng->txt('back'),
                        $this->getBackLink());
        }

References ilTabsGUI\clearTargets(), and ilTabsGUI\setBackTarget().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

targetWasEditedByOtherUser()

ilIndividualAssessmentMemberGUI::targetWasEditedByOtherUser ( ilIndividualAssessmentMember  $member )

protected

Definition at line 255 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                                            {
                return (int)$member->examinerId() !== (int)$this->examiner->getId()
                                && 0 !== (int)$member->examinerId();
        }

References ilIndividualAssessmentMember\examinerId().

Referenced by executeCommand(), and mayBeEdited().

Here is the call graph for this function:

Here is the caller graph for this function:

updateDataInMemberByArray()

ilIndividualAssessmentMemberGUI::updateDataInMemberByArray ( ilIndividualAssessmentMember  $member,   $data  )

protected

Definition at line 187 of file class.ilIndividualAssessmentMemberGUI.php.

                                                                                                  {
                $member = $member->withRecord($data['record'])
                                        ->withInternalNote($data['internal_note'])
                                        ->withLPStatus($data['learning_progress'])
                                        ->withExaminerId($this->examiner->getId())
                                        ->withNotify(($data['notify']  == 1 ? true : false));
                return $member;
        }

References $data, and ilIndividualAssessmentMember\withRecord().

Referenced by finalize(), finalizeConfirmation(), and save().

Here is the call graph for this function:

Here is the caller graph for this function:

view()

ilIndividualAssessmentMemberGUI::view ( )

protected

Definition at line 162 of file class.ilIndividualAssessmentMemberGUI.php.

                                  {
                $this->parent_gui->setScreenId("iass", "member", "view");
                $form = $this->fillForm($this->initGradingForm(false),$this->member);
                $this->renderForm($form);
        }

References fillForm(), initGradingForm(), and renderForm().

Referenced by edit(), finalize(), finalizeConfirmation(), and save().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$notificator

ilIndividualAssessmentMemberGUI::$notificator

protected

Definition at line 20 of file class.ilIndividualAssessmentMemberGUI.php.

---

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

• Modules/IndividualAssessment/classes/class.ilIndividualAssessmentMemberGUI.php