Survey execution graphical output. More...

Collaboration diagram for ilSurveyExecutionGUI:

Public Member Functions
	__construct (ilObjSurvey $a_object)

	executeCommand ()

	resume ()

	start (bool $resume=false)

	redirectQuestion ()
	Called when a user answered a page to perform a redirect after POST. More...

	previousNoSave ()

	previous (bool $a_save_input=true)

	next ()
	Navigates to the next page. More...

	gotoPage ()
	Go to a specific page without saving. More...

	outSurveyPage (int $activepage=0, int $direction=0)
	Output of the active survey question to the screen. More...

	saveUserInput (string $navigationDirection="next")
	Save the user's input. More...

	saveActiveQuestionData (array $data)
	Saves the users input of the active page. More...

	cancel ()

	runShowFinishedPage ()
	Show finish page. More...

	backToRepository ()

	exitSurvey ()
	Exits the survey after finishing it. More...

	outNavigationButtons (string $navigationblock, array $page, ilTemplate $stpl)

	preview ()

	viewUserResults ()

	mailUserResults ()

	showFinishConfirmation ()

	confirmedFinish ()

Protected Member Functions
	checkAuth (bool $a_may_start=false, bool $a_finished_run=false)

	getCurrentRunId ()

Protected Attributes
ILIAS Survey InternalGUIService	$gui

array	$raw_post_data

ILIAS Survey Execution ExecutionGUIRequest	$request

ilRbacSystem	$rbacsystem

ilObjUser	$user

ilHelpGUI	$help

ilToolbarGUI	$toolbar

ilObjSurvey	$object

ilLanguage	$lng

ilGlobalTemplateInterface	$tpl

ilCtrl	$ctrl

ilTree	$tree

bool	$preview

ilLogger	$log

ILIAS Survey Execution RunManager	$run_manager

ILIAS Survey Participants StatusManager	$participant_manager

ILIAS Survey Access AccessManager	$access_manager

int	$requested_appr_id

Mode FeatureConfig	$feature_config

Detailed Description

Survey execution graphical output.

The ilSurveyExecutionGUI class creates the execution output for the ilObjSurveyGUI class. This saves some heap space because the ilObjSurveyGUI class will be smaller.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Definition at line 32 of file class.ilSurveyExecutionGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilSurveyExecutionGUI::__construct ( ilObjSurvey $a_object )

Definition at line 55 of file class.ilSurveyExecutionGUI.php.

    {
        global $DIC;
 
        $this->rbacsystem = $DIC->rbac()->system();
        $this->user = $DIC->user();
        $this->help = $DIC["ilHelp"];
        $this->toolbar = $DIC->toolbar();
        $lng = $DIC->language();
        $tpl = $DIC["tpl"];
        $ilCtrl = $DIC->ctrl();
        $tree = $DIC->repositoryTree();
 
        $this->lng = $lng;
        $this->tpl = $tpl;
        $this->ctrl = $ilCtrl;
        $this->object = $a_object;
        $this->tree = $tree;
        $this->user = $DIC->user();
 
        $this->request = $DIC->survey()
                             ->internal()
                             ->gui()
                             ->execution()
                             ->request();
        $this->gui = $DIC->survey()
            ->internal()
            ->gui();
 
        // stay in preview mode
        $this->preview = (bool) $this->request->getPreview();
        $this->requested_appr_id = $this->request->getAppraiseeId();
        $this->ctrl->saveParameter($this, "prvw");
        $this->ctrl->saveParameter($this, "appr_id");
        $this->ctrl->saveParameter($this, "pgov");
 
        $this->log = ilLoggerFactory::getLogger("svy");
 
        $domain_service = $DIC->survey()->internal();
        $appraisee_id = ($a_object->getMode() === ilObjSurvey::MODE_SELF_EVAL)
            ? $this->user->getId()
            : $this->requested_appr_id;
        $this->run_manager = $domain_service->domain()->execution()->run(
            $a_object,
            $this->user->getId(),
            $appraisee_id
        );
        $this->participant_manager = $domain_service->domain()->participants()->status(
            $a_object,
            $this->user->getId()
        );
        $this->access_manager = $domain_service->domain()->access(
            $a_object->getRefId(),
            $this->user->getId()
        );
 
        $this->feature_config = $domain_service->domain()->modeFeatureConfig($a_object->getMode());
 
 
        // @todo this is used to store answers in the session, but should
        // be refactored somehow to avoid the use of the complete post body
        $parsed_body = $DIC->http()->request()->getParsedBody();
        $this->raw_post_data = is_array($parsed_body) ? $parsed_body : [];
    }

References $DIC, $lng, $requested_appr_id, $tpl, $tree, ILIAS\Repository\ctrl(), ilLoggerFactory\getLogger(), ilObjSurvey\getMode(), ilObject\getRefId(), ILIAS\Repository\help(), ILIAS\Repository\lng(), ilObjSurvey\MODE_SELF_EVAL, preview(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ backToRepository()

ilSurveyExecutionGUI::backToRepository ( )

Definition at line 685 of file class.ilSurveyExecutionGUI.php.

                                      : void
    {
        $tree = $this->tree;
 
        // #14971
        if ($this->object->getMode() === ilObjSurvey::MODE_360) {
            $target_ref_id = $this->object->getRefId();
        } else {
            // #11534
            $target_ref_id = $tree->getParentId($this->object->getRefId());
        }
 
        ilUtil::redirect(ilLink::_getLink($target_ref_id));
    }

References ilTree\getParentId(), ilObjSurvey\MODE_360, ILIAS\Repository\object(), and ilUtil\redirect().

Here is the call graph for this function:

◆ cancel()

ilSurveyExecutionGUI::cancel ( )

Definition at line 595 of file class.ilSurveyExecutionGUI.php.

                            : void
    {
        $this->ctrl->redirectByClass("ilobjsurveygui", "run");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ checkAuth()

ilSurveyExecutionGUI::checkAuth	(	bool	$a_may_start = `false`,
		bool	$a_finished_run = `false`
	)

protected

Definition at line 151 of file class.ilSurveyExecutionGUI.php.

     : void {
        $rbacsystem = $this->rbacsystem;
        $ilUser = $this->user;
        if ($this->preview) {
            if (!$rbacsystem->checkAccess("write", $this->object->getRefId())) {
                // only with write access it is possible to preview the survey
                throw new ilSurveyException($this->lng->txt("survey_cannot_preview_survey"));
            }
            return;
        }
 
 
        if ($a_finished_run &&
            !$this->access_manager->canRead() &&
            !$this->participant_manager->isExternalRater()) {
            throw new ilSurveyException($this->lng->txt("cannot_read_survey"));
        }
        if (!$a_finished_run && !$this->access_manager->canStartSurvey()) {
            throw new ilSurveyException($this->lng->txt("cannot_read_survey"));
        }
 
        $user_id = $ilUser->getId();
 
        // check existing code
        // see ilObjSurveyGUI::infoScreen()
        $anonymous_id = null;
        $anonymous_code = "";
        if ($this->access_manager->useCodeFromSession()) {
            // get code from session
            $anonymous_code = $this->run_manager->getCode();
            $anonymous_id = $this->object->getAnonymousIdByCode($anonymous_code);
            if (!$anonymous_id) {
                $this->tpl->setOnScreenMessage('failure', sprintf($this->lng->txt("error_retrieving_anonymous_survey"), $anonymous_code, true));
                $this->ctrl->redirectByClass("ilobjsurveygui", "run");
            }
        }
 
        // appraisee validation
        $appr_id = 0;
        $appraisees = [];
        if ($this->feature_config->usesAppraisees()) {
            $appr_id = $this->requested_appr_id;
            //if (!$appr_id) {
            //    $appr_id = $_SESSION["appr_id"][$this->object->getId()];
            //}
            // check if appraisee is valid
            if ($anonymous_id) {
                $appraisees = $this->object->getAppraiseesToRate(0, $anonymous_id);
            }
            if (!$appraisees && $user_id !== ANONYMOUS_USER_ID) {
                $appraisees = $this->object->getAppraiseesToRate($user_id);
            }
            if (!in_array($appr_id, $appraisees)) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("survey_360_execution_invalid_appraisee"), true);
                $this->ctrl->redirectByClass("ilobjsurveygui", "run");
            }
        }
        //Self evaluation mode
        #23575 in self eval the appraisee is the current user.
        if ($this->object->getMode() === ilObjSurvey::MODE_SELF_EVAL) {
            $appr_id = $ilUser->getId();
        }
 
        //$_SESSION["appr_id"][$this->object->getId()] = $appr_id;
 
        if ($a_finished_run) {
            if (!$this->run_manager->hasFinished()) {
                throw new ilSurveyException($this->lng->txt("cannot_read_survey"));
            }
        } else {
            // completed
            if ($this->run_manager->hasFinished()) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("already_completed_survey"), true);
                $this->ctrl->redirectByClass("ilobjsurveygui", "run");
            }
            // starting
            elseif (!$this->run_manager->hasStarted()) {
                if ($a_may_start) {
                    //$_SESSION["finished_id"][$this->object->getId()] =
                    //    $this->object->startSurvey($user_id, $anonymous_code, $appr_id);
                    $this->run_manager->start($appr_id);
                } else {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt("survey_use_start_button"), true);
                    $this->ctrl->redirectByClass("ilobjsurveygui", "run");
                }
            }
            // resuming
            else {
                // nothing todo
            }
        }
        // validate finished id
        //var_dump($this->run_manager->getCurrentRunId());
        //var_dump($this->object->getActiveID($user_id, $anonymous_code, $appr_id));
        //exit;
        // if anonymous read, without names, no codes, this succeedes, if second start (no resume button)
        // - getCurrentRunId will use CODE (from session) to get run
        // - getActiveID will use $anonymous_code set to get the same run id
        // - $this->access_manager->isCodeInputAllowed() returns TRUE ($survey->getAnonymize() is 2)
        // if anonymous read, with names, no codes, this fails here, if second start (resume button)
        // - $this->access_manager->isCodeInputAllowed() returns FALSE
        if ($this->object->getActiveID($user_id, $anonymous_code, $appr_id) !==
            $this->run_manager->getCurrentRunId()) {
            throw new ilSurveyException("Run ID mismatch");
        }
    }

References ilRbacSystem\checkAccess(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ confirmedFinish()

ilSurveyExecutionGUI::confirmedFinish ( )

Definition at line 805 of file class.ilSurveyExecutionGUI.php.

                                     : void
    {
        $ilUser = $this->user;
 
        if (!$this->preview) {
            $this->object->finishSurvey($this->getCurrentRunId(), $this->requested_appr_id);
 
            if ($ilUser->getId() !== ANONYMOUS_USER_ID) {
                ilLPStatusWrapper::_updateStatus($this->object->getId(), $ilUser->getId());
            }
 
            // send "single participant has finished" mail to tutors
            if ($this->object->getMailNotification()) {
                $this->object->sendNotificationMail(
                    $ilUser->getId(),
                    $this->run_manager->getCode(),
                    $this->requested_appr_id
                );
            }
        }
 
        $this->ctrl->redirect($this, "runShowFinishedPage");
    }

References ilLPStatusWrapper\_updateStatus(), ANONYMOUS_USER_ID, ILIAS\Repository\ctrl(), ILIAS\Repository\object(), and ILIAS\UI\examples\Symbol\Glyph\Preview\preview().

Here is the call graph for this function:

◆ executeCommand()

ilSurveyExecutionGUI::executeCommand ( )

Definition at line 120 of file class.ilSurveyExecutionGUI.php.

                                    : string
    {
        // record read event for lp
        ilChangeEvent::_recordReadEvent(
            'svy',
            $this->object->getRefId(),
            $this->object->getId(),
            $GLOBALS['DIC']->user()->getId()
        );
 
        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass($this);
 
        $this->log->debug("- cmd= " . $cmd);
 
        if ($cmd === null || $cmd === '') {
            $this->ctrl->setParameter(
                $this,
                "qid",
                $this->request->getQuestionId()
            );
            $this->ctrl->redirect($this, "gotoPage");
        }
        switch ($next_class) {
            default:
                $ret = $this->$cmd();
                break;
        }
        return (string) $ret;
    }

References $GLOBALS, ilChangeEvent\_recordReadEvent(), ILIAS\Repository\ctrl(), and ILIAS\Repository\object().

Here is the call graph for this function:

◆ exitSurvey()

ilSurveyExecutionGUI::exitSurvey ( )

Exits the survey after finishing it.

Definition at line 703 of file class.ilSurveyExecutionGUI.php.

                                : void
    {
        if (!$this->preview) {
            $this->backToRepository();
        } else {
            // #12841
            $this->ctrl->setParameterByClass("ilsurveyeditorgui", "pgov", $this->request->getTargetPosition());
            $this->ctrl->redirectByClass(array("ilobjsurveygui", "ilsurveyeditorgui"), "questions");
        }
    }

References ILIAS\Repository\ctrl(), and ILIAS\UI\examples\Symbol\Glyph\Preview\preview().

Here is the call graph for this function:

◆ getCurrentRunId()

ilSurveyExecutionGUI::getCurrentRunId ( )

protected

Definition at line 529 of file class.ilSurveyExecutionGUI.php.

                                        : int
    {
        return $this->run_manager->getCurrentRunId();
    }

◆ gotoPage()

ilSurveyExecutionGUI::gotoPage ( )

Go to a specific page without saving.

Definition at line 356 of file class.ilSurveyExecutionGUI.php.

                              : void
    {
        $this->ctrl->setParameter($this, "activecommand", "gotoPage");
        $this->ctrl->setParameter($this, "qid", $this->request->getQuestionId());
        $this->ctrl->setParameter($this, "direction", "0");
        $this->ctrl->redirect($this, "redirectQuestion");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ mailUserResults()

ilSurveyExecutionGUI::mailUserResults ( )

Definition at line 763 of file class.ilSurveyExecutionGUI.php.

                                     : void
    {
        $ilUser = $this->user;
 
        if (!$this->object->hasMailConfirmation()) {
            $this->backToRepository();
        }
 
        $this->checkAuth(false, true);
 
        $recipient = $this->request->getMail();
        if (!$recipient) {
            $recipient = $ilUser->getEmail();
        }
        if (!ilUtil::is_email($recipient)) {
            $this->ctrl->redirect($this, "runShowFinishedPage");
        }
 
        $survey_gui = new ilObjSurveyGUI();
        $survey_gui->sendUserResultsMail(
            $this->getCurrentRunId(),
            $recipient
        );
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("mail_sent"), true);
        $this->ctrl->redirect($this, "runShowFinishedPage");
    }

References ILIAS\Repository\ctrl(), ilUtil\is_email(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

◆ next()

ilSurveyExecutionGUI::next ( )

Navigates to the next page.

Definition at line 340 of file class.ilSurveyExecutionGUI.php.

                          : void
    {
        $result = $this->saveUserInput("next");
        $this->ctrl->setParameter($this, "activecommand", "next");
        $this->ctrl->setParameter($this, "qid", $this->request->getQuestionId());
        if ($result > 0) {
            $this->ctrl->setParameter($this, "direction", "0");
        } else {
            $this->ctrl->setParameter($this, "direction", "1");
        }
        $this->ctrl->redirect($this, "redirectQuestion");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ outNavigationButtons()

ilSurveyExecutionGUI::outNavigationButtons	(	string	$navigationblock,
		array	$page,
		ilTemplate	$stpl
	)

Definition at line 714 of file class.ilSurveyExecutionGUI.php.

     : void {
        $question_id = (int) $page[0]["question_id"];
        $prevpage = $this->object->getNextPage($question_id, -1);
        $stpl->setCurrentBlock($navigationblock . "_prev");
        if (is_null($prevpage)) {
            $stpl->setVariable("BTN_PREV", $this->lng->txt("survey_start"));
        } else {
            $stpl->setVariable("BTN_PREV", $this->lng->txt("survey_previous"));
        }
        $stpl->parseCurrentBlock();
        $nextpage = $this->object->getNextPage($question_id, 1);
        $stpl->setCurrentBlock($navigationblock . "_next");
        if (is_null($nextpage)) {
            $stpl->setVariable("BTN_NEXT", $this->lng->txt("survey_finish"));
        } else {
            $stpl->setVariable("BTN_NEXT", $this->lng->txt("survey_next"));
        }
        $stpl->parseCurrentBlock();
    }

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

◆ outSurveyPage()

ilSurveyExecutionGUI::outSurveyPage	(	int	$activepage = `0`,
		int	$direction = `0`
	)

Output of the active survey question to the screen.

Exceptions

ilCtrlException
ilSurveyException

Definition at line 369 of file class.ilSurveyExecutionGUI.php.

     : void {
        $ilUser = $this->user;
 
        $this->checkAuth();
        $page = $this->object->getNextPage($activepage, $direction);
        $constraint_true = 0;
 
        // check for constraints
        if (!is_null($page) && is_array($page[0]["constraints"]) && count($page[0]["constraints"])) {
            $this->log->debug("Page constraints= ", $page[0]["constraints"]);
 
            while (!is_null($page) and ($constraint_true == 0) and (count($page[0]["constraints"]))) {
                $constraint_true = $page[0]['constraints'][0]['conjunction'] == 0;
                foreach ($page[0]["constraints"] as $constraint) {
                    $constraint_question_id = (int) $constraint["question"];
                    if (!$this->preview) {
                        $working_data = $this->object->loadWorkingData(
                            $constraint_question_id,
                            $this->getCurrentRunId()
                        );
                    } else {
                        $working_data = $this->run_manager->getPreviewData($constraint_question_id);
                    }
                    if ($constraint['conjunction'] == 0) {
                        // and
                        $constraint_true &= $this->object->checkConstraint($constraint, $working_data);
                    } else {
                        // or
                        $constraint_true |= $this->object->checkConstraint($constraint, $working_data);
                    }
                }
                if ($constraint_true == 0) {
                    // #11047 - we are skipping the page, so we have to get rid of existing answers for that question(s)
                    foreach ($page as $page_question) {
                        $qid = (int) $page_question["question_id"];
 
                        // see saveActiveQuestionData()
                        if (!$this->preview) {
                            $this->object->deleteWorkingData($qid, $this->getCurrentRunId());
                        } else {
                            $this->run_manager->clearPreviewData($qid);
                        }
                    }
 
                    $page = $this->object->getNextPage((int) $page[0]["question_id"], $direction);
                }
            }
        }
        $first_question = -1;
        if (is_null($page) && $direction === -1) {
            $this->ctrl->redirectByClass("ilobjsurveygui", "run");
        } elseif (is_null($page) && $direction === 1) {
            $state = $this->object->getUserSurveyExecutionStatus();
            if ($this->preview ||
                !($state["runs"][$this->getCurrentRunId()]["finished"] ?? false)) {
                $this->showFinishConfirmation();
            } else {
                $this->runShowFinishedPage();
            }
            return;
        } else {
            $ilHelp = $this->help;
            $ilHelp->setScreenIdComponent("svy");
            $ilHelp->setScreenId("quest_presentation");
 
            if ($ilUser->getId() !== ANONYMOUS_USER_ID) {
                ilLearningProgress::_tracProgress($ilUser->getId(), $this->object->getId(), $this->object->getRefId(), "svy");
            }
 
            $required = false;
            //$this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_svy_content.html", "components/ILIAS/Survey");
            $stpl = new ilTemplate("tpl.il_svy_svy_content.html", true, true, "components/ILIAS/Survey");
 
            // title / appraisee
            if ($this->feature_config->usesAppraisees()) {
                $appr_id = $this->requested_appr_id;
 
                $this->tpl->setTitle($this->object->getTitle() . " (" .
                    $this->lng->txt("survey_360_appraisee") . ": " .
                    ilUserUtil::getNamePresentation($appr_id) . ")");
            }
 
            // top / bottom nav
            // removed check for getAnonymize() due to #0045475
            if (!($this->object->isAccessibleWithoutCode() && ($ilUser->getId() === ANONYMOUS_USER_ID))) {
                $stpl->setCurrentBlock("suspend_survey");
 
                if (!$this->preview) {
                    $stpl->setVariable("TEXT_SUSPEND", $this->lng->txt("cancel_survey"));
                    $stpl->setVariable("HREF_SUSPEND", $this->ctrl->getLinkTargetByClass("ilObjSurveyGUI", "run"));
                } else {
                    $this->ctrl->setParameterByClass("ilObjSurveyGUI", "pgov", $this->request->getTargetPosition());
                    $stpl->setVariable("TEXT_SUSPEND", $this->lng->txt("survey_cancel_preview"));
                    $stpl->setVariable("HREF_SUSPEND", $this->ctrl->getLinkTargetByClass(array("ilObjSurveyGUI", "ilSurveyEditorGUI"), "questions"));
                }
 
                $stpl->setVariable("ALT_IMG_SUSPEND", $this->lng->txt("cancel_survey"));
                $stpl->setVariable("TITLE_IMG_SUSPEND", $this->lng->txt("cancel_survey"));
                $stpl->parseCurrentBlock();
            }
            $this->outNavigationButtons("top", $page, $stpl);
            $this->outNavigationButtons("bottom", $page, $stpl);
 
            // progress
            $stpl->setCurrentBlock("percentage");
            $percentage = (int) (($page[0]["position"]) * 100);
            $pbar = ilProgressBar::getInstance();
            $pbar->setCurrent($percentage);
            $stpl->setVariable("NEW_PBAR", $pbar->render());
            $stpl->parseCurrentBlock();
 
            // questions
            $working_data = [];
            $errors = $this->run_manager->getErrors();
            foreach ($page as $data) {
                $question_id = (int) $data["question_id"];
                if ($first_question === -1) {
                    $first_question = $question_id;
                }
                $question_gui = $this->object->getQuestionGUI((string) $data["type_tag"], $question_id);
 
                if (count($errors) > 0) {
                    $working_data[$question_id] = $question_gui->object->getWorkingDataFromUserInput(
                        $this->run_manager->getPostData()
                    );
                } else {
                    if (!$this->preview) {
                        $working_data[$question_id] = $this->object->loadWorkingData(
                            $question_id,
                            $this->run_manager->getCurrentRunId()
                        );
                    } else {
                        $working_data[$question_id] = $this->run_manager->getPreviewData($question_id);
                    }
                }
            }
 
            $page_renderer = new \ILIAS\Survey\Page\PageRenderer(
                $this->object,
                $page,
                $working_data,
                $errors
            );
 
            $stpl->setVariable("PAGE", $page_renderer->render());
 
            $this->ctrl->setParameter($this, "qid", $first_question);
            $stpl->setVariable("FORM_ACTION", $this->ctrl->getFormAction($this, "redirectQuestion"));
            $this->tpl->setContent($stpl->get());
        }
 
        if (!$this->preview) {
            $this->object->setPage($this->getCurrentRunId(), (int) $page[0]['question_id']);
            $this->run_manager->setStartTime($first_question);
        }
    }

◆ preview()

ilSurveyExecutionGUI::preview ( )

Definition at line 738 of file class.ilSurveyExecutionGUI.php.

                             : void
    {
        $this->outSurveyPage();
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ previous()

ilSurveyExecutionGUI::previous ( bool $a_save_input = true )

Definition at line 319 of file class.ilSurveyExecutionGUI.php.

     : void {
        $has_error = "";
        if ($a_save_input) {
            // #16209
            $has_error = $this->saveUserInput("previous");
        }
        $this->ctrl->setParameter($this, "activecommand", "previous");
        $this->ctrl->setParameter($this, "qid", $this->request->getQuestionId());
        if ($has_error > 0) {
            $this->ctrl->setParameter($this, "direction", "0");
        } else {
            $this->ctrl->setParameter($this, "direction", "-1");
        }
        $this->ctrl->redirect($this, "redirectQuestion");
    }

◆ previousNoSave()

ilSurveyExecutionGUI::previousNoSave ( )

Definition at line 314 of file class.ilSurveyExecutionGUI.php.

                                    : void
    {
        $this->previous(false);
    }

◆ redirectQuestion()

ilSurveyExecutionGUI::redirectQuestion ( )

Called when a user answered a page to perform a redirect after POST.

This is called for security reasons to prevent users sending a form twice.

Definition at line 293 of file class.ilSurveyExecutionGUI.php.

                                      : void
    {
        switch ($this->request->getActiveCommand()) {
            case "previous":
            case "gotoPage":
            case "next":
                $this->outSurveyPage(
                    $this->request->getQuestionId(),
                    $this->request->getDirection()
                );
                break;
            case "default":
                $this->outSurveyPage($this->request->getQuestionId());
                break;
            default:
                // don't save input, go to the first page
                $this->outSurveyPage();
                break;
        }
    }

◆ resume()

ilSurveyExecutionGUI::resume ( )

Definition at line 261 of file class.ilSurveyExecutionGUI.php.

                            : void
    {
        $this->start(true);
    }

◆ runShowFinishedPage()

ilSurveyExecutionGUI::runShowFinishedPage ( )

Show finish page.

Definition at line 603 of file class.ilSurveyExecutionGUI.php.

                                         : void
    {
        $ilToolbar = $this->toolbar;
        $ilUser = $this->user;
 
        $has_button = false;
 
 
        if (!$this->preview) {
            if ($this->object->hasViewOwnResults()) {
                $this->gui->link(
                    $this->lng->txt("svy_view_own_results"),
                    $this->ctrl->getLinkTarget($this, "viewUserResults")
                )->toToolbar();
 
                $has_button = true;
            }
 
            if ($this->object->hasMailConfirmation()) {
                if ($has_button) {
                    $ilToolbar->addSeparator();
                }
 
                if ($ilUser->getId() === ANONYMOUS_USER_ID ||
                    !$ilUser->getEmail()) {
                    $mail = new ilTextInputGUI($this->lng->txt("email"), "mail");
                    $mail->setSize(25);
                    $ilToolbar->addInputItem($mail, true);
                }
 
                $ilToolbar->setFormAction($this->ctrl->getFormAction($this, "mailUserResults"));
 
                $this->gui->button(
                    $this->lng->txt("svy_mail_send_confirmation"),
                    "mailUserResults"
                )->submit()->toToolbar();
 
                $has_button = true;
            }
 
            // #6307
            if (ilObjSurveyAccess::_hasEvaluationAccess($this->object->getId(), $ilUser->getId())) {
                $this->gui->link(
                    $this->lng->txt("svy_results"),
                    $this->ctrl->getLinkTargetByClass("ilObjSurveyGUI", "evaluation")
                )->toToolbar();
 
                $has_button = true;
            }
        }
 
        if (!$has_button &&
            $this->object->getOutro() === '') {
            $this->exitSurvey();
        } else {
            if ($has_button) {
                $ilToolbar->addSeparator();
            }
 
            if ($this->object->getMode() === ilObjSurvey::MODE_360) {
                $txt = $this->lng->txt("survey_execution_exit_360");
            } else {
                $txt = $this->lng->txt("survey_execution_exit");
            }
            $this->gui->button(
                $txt,
                $this->ctrl->getLinkTarget($this, "exitSurvey")
            )->toToolbar();
 
            if ($this->object->getOutro() !== '') {
                $f = $this->gui->ui()->factory();
                $r = $this->gui->ui()->renderer();
                $p = $f->panel()->standard(
                    "",
                    $f->legacy()->content($this->object->prepareTextareaOutput($this->object->getOutro()))
                );
 
                $this->tpl->setContent($r->render($p));
            }
        }
    }

References Vendor\Package\$f, ilObjSurveyAccess\_hasEvaluationAccess(), ANONYMOUS_USER_ID, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilObjSurvey\MODE_360, ILIAS\Repository\object(), and ILIAS\UI\examples\Symbol\Glyph\Preview\preview().

Here is the call graph for this function:

◆ saveActiveQuestionData()

ilSurveyExecutionGUI::saveActiveQuestionData ( array $data )

Saves the users input of the active page.

Definition at line 569 of file class.ilSurveyExecutionGUI.php.

                                                       : int
    {
        $question_id = (int) $data["question_id"];
        $question = SurveyQuestion::_instanciateQuestion($question_id);
        $error = $question->checkUserInput($this->raw_post_data, $this->object->getSurveyId());
        if (strlen($error) === 0) {
            if (!$this->preview) {
                // delete old answers
                $this->object->deleteWorkingData($question_id, $this->getCurrentRunId());
 
                $question->saveUserInput($this->raw_post_data, $this->getCurrentRunId());
            } else {
                $this->run_manager->setPreviewData(
                    $question_id,
                    $question->saveUserInput($this->raw_post_data, 0, true)
                );
            }
            return 0;
        } else {
            $errors = $this->run_manager->getErrors();
            $errors[$question->getId()] = $error;
            $this->run_manager->setErrors($errors);
            return 1;
        }
    }

References $data, SurveyQuestion\_instanciateQuestion(), ILIAS\Repository\int(), ILIAS\Repository\object(), and ILIAS\UI\examples\Symbol\Glyph\Preview\preview().

Here is the call graph for this function:

◆ saveUserInput()

ilSurveyExecutionGUI::saveUserInput ( string $navigationDirection = "next" )

Save the user's input.

Definition at line 537 of file class.ilSurveyExecutionGUI.php.

     : int {
        if (!$this->preview) {
            $this->run_manager->setEndTime();
        }
 
        // check users input when it is a metric question
        $this->run_manager->clearErrors();
        $this->run_manager->setPostData($this->raw_post_data);
 
        $page_error = 0;
        $page = $this->object->getNextPage($this->request->getQuestionId(), 0);
        foreach ($page as $data) {
            $page_error += $this->saveActiveQuestionData($data);
        }
        if ($page_error && (strcmp($navigationDirection, "previous") !== 0)) {
            if ($page_error === 1) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_page_error"), true);
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_page_errors"), true);
            }
        } else {
            $page_error = 0;
            $this->run_manager->clearErrors();
        }
        return $page_error;
    }

◆ showFinishConfirmation()

ilSurveyExecutionGUI::showFinishConfirmation ( )

Definition at line 791 of file class.ilSurveyExecutionGUI.php.

                                            : void
    {
        $tpl = $this->tpl;
 
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_execution_sure_finish"));
 
        $cgui->setFormAction($this->ctrl->getFormAction($this, "confirmedFinish"));
        $cgui->setCancel($this->lng->txt("cancel"), "previousNoSave");
        $cgui->setConfirm($this->lng->txt("confirm"), "confirmedFinish");
 
        $tpl->setContent($cgui->getHTML());
    }

References ILIAS\News\Common\Table\$tpl, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\UICore\GlobalTemplate\setContent().

Here is the call graph for this function:

◆ start()

ilSurveyExecutionGUI::start ( bool $resume = false )

Definition at line 266 of file class.ilSurveyExecutionGUI.php.

                                               : void
    {
        if ($this->preview) {
            $this->run_manager->clearAllPreviewData();
        }
        $this->run_manager->clearErrors();
 
        $this->checkAuth(!$resume);
 
        $activepage = "";
        if ($resume) {
            $activepage = $this->object->getLastActivePage(
                $this->getCurrentRunId()
            );
        }
 
        if ((string) $activepage !== '') {
            $this->ctrl->setParameter($this, "qid", (string) $activepage);
        }
        $this->ctrl->setParameter($this, "activecommand", "default");
        $this->ctrl->redirect($this, "redirectQuestion");
    }

References ILIAS\Repository\ctrl(), and ILIAS\UI\examples\Symbol\Glyph\Preview\preview().

Here is the call graph for this function:

◆ viewUserResults()

ilSurveyExecutionGUI::viewUserResults ( )

Definition at line 743 of file class.ilSurveyExecutionGUI.php.

                                     : void
    {
        $ilToolbar = $this->toolbar;
 
        if (!$this->object->hasViewOwnResults()) {
            $this->backToRepository();
        }
 
        $this->checkAuth(false, true);
 
        $this->gui->link(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "runShowFinishedPage")
        )->toToolbar();
 
        $survey_gui = new ilObjSurveyGUI();
        $html = $survey_gui->getUserResultsTable($this->getCurrentRunId());
        $this->tpl->setContent($html);
    }