ilSurveyParticipantsGUI Class Reference

Class ilSurveyParticipantsGUI. More...

Collaboration diagram for ilSurveyParticipantsGUI:

Public Member Functions
	getObject ()
	executeCommand ()
	maintenanceObject ()
	Participants maintenance. More...
	deleteAllUserDataObject ()
	Creates a confirmation form for delete all user data. More...
	confirmDeleteAllUserDataObject ()
	Deletes all user data of the survey after confirmation. More...
	cancelDeleteAllUserDataObject ()
	Cancels delete of all user data in maintenance. More...
	confirmDeleteSelectedUserDataObject ()
	Deletes all user data for the test object. More...
	cancelDeleteSelectedUserDataObject ()
	Cancels the deletion of all user data. More...
	deleteSingleUserResultsObject ()
	Asks for a confirmation to delete selected user data. More...
	setCodeLanguageObject ()
	Change survey language for direct access URL's. More...
	codesObject ()
	Display the survey access codes tab. More...
	editCodesObject ()
	updateCodesObject ()
	deleteCodesConfirmObject ()
	deleteCodesObject ()
	Delete a list of survey codes. More...
	exportCodesObject ()
	Exports a list of survey codes. More...
	exportAllCodesObject ()
	Exports all survey codes. More...
	createSurveyCodesObject ()
	Create access codes for the survey. More...
	insertSavedMessageObject ()
	deleteSavedMessageObject ()
	mailCodesObject ()
	sendCodesMailObject ()
	importExternalRecipientsFromTextObject ()
	addCodeForExternal (string $email, string $lastname, string $firstname)
	Add code for an external rater. More...
	importExternalRecipientsFromFileObject ()
	importExternalMailRecipientsFromFileFormObject ()
	importExternalMailRecipientsFromTextFormObject ()
	listAppraiseesObject ()
	addAppraisee (array $a_user_ids)
	confirmDeleteAppraiseesObject ()
	deleteAppraiseesObject ()
	handleRatersAccess ()
	editRatersObject ()
	addExternalRaterFormObject (ilPropertyFormGUI $a_form=null)
	addExternalRaterObject ()
	addRater (array $a_user_ids)
	confirmDeleteRatersObject ()
	deleteRatersObject ()
	addSelfAppraiseeObject ()
	initMailRatersForm (int $appr_id, array $rec_ids)
	mailRatersObject ()
	mailRatersObjectOld (ilPropertyFormGUI $a_form=null)
	mailRatersActionObject ()
	confirmAppraiseeCloseObject ()
	confirmAppraiseeCloseCancelObject ()
	appraiseeCloseObject ()
	confirmAdminAppraiseesCloseObject ()
	adminAppraiseesCloseObject ()
	inviteUsers (array $user_ids)

Protected Member Functions
	handleWriteAccess ()
	filterSurveyParticipantsByAccess (array $a_finished_ids=null)
	isAnonymousListActive ()
	setParticipantSubTabs (string $active)
	importAccessCodesObject ()
	Import codes from export codes file (upload form) More...
	importAccessCodesActionObject ()
	Import codes from export codes file. More...
	_convertCharset (string $a_string, string $a_from_charset="", string $a_to_charset="UTF-8")
	removeUTF8Bom (string $a_text)
	storeMailSent ()
	initExternalRaterForm (int $appr_id)
	listParticipantsObject ()

Protected Attributes
ILIAS Survey Mode FeatureConfig	$feature_config
ILIAS Survey Editing EditingGUIRequest	$edit_request
ILIAS Survey Editing EditManager	$edit_manager
ilCtrl	$ctrl
ilLanguage	$lng
ilGlobalTemplateInterface	$tpl
ilTabsGUI	$tabs
ilToolbarGUI	$toolbar
ilAccessHandler	$access
ilRbacSystem	$rbacsystem
ilObjUser	$user
ilLogger	$log
ilObjSurveyGUI	$parent_gui
ilObjSurvey	$object
int	$ref_id
bool	$has_write
Participants InvitationsManager	$invitation_manager
ILIAS Survey InternalService	$survey_service
ILIAS Survey Code CodeManager	$code_manager
ILIAS Survey InternalDataService	$data_manager

Detailed Description

Class ilSurveyParticipantsGUI.

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 ilSurveyParticipantsGUI: ilRepositorySearchGUI, ilSurveyRaterGUI

Definition at line 26 of file class.ilSurveyParticipantsGUI.php.

Member Function Documentation

_convertCharset()

ilSurveyParticipantsGUI::_convertCharset ( string  $a_string, string  $a_from_charset = "", string  $a_to_charset = "UTF-8"  )

protected

Definition at line 964 of file class.ilSurveyParticipantsGUI.php.

Referenced by importExternalRecipientsFromFileObject().

     : string {
        if (extension_loaded("mbstring")) {
            if (!$a_from_charset) {
                mb_detect_order("UTF-8, ISO-8859-1, Windows-1252, ASCII");
                $a_from_charset = mb_detect_encoding($a_string);
            }
            if (strtoupper($a_from_charset) !== $a_to_charset) {
                return mb_convert_encoding($a_string, $a_to_charset, $a_from_charset);
            }
        }
        return $a_string;
    }

Here is the caller graph for this function:

addAppraisee()

ilSurveyParticipantsGUI::addAppraisee

(

array

$a_user_ids

)

Definition at line 1168 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

     : void {
        if (count($a_user_ids)) {
            // #13319
            foreach (array_unique($a_user_ids) as $user_id) {
                $this->object->addAppraisee($user_id);
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
        $this->ctrl->redirect($this, "listAppraisees");
    }

Here is the call graph for this function:

addCodeForExternal()

ilSurveyParticipantsGUI::addCodeForExternal	(	string	$email,
		string	$lastname,
		string	$firstname
	)

Add code for an external rater.

Definition at line 949 of file class.ilSurveyParticipantsGUI.php.

Referenced by addExternalRaterObject(), importExternalRecipientsFromFileObject(), and importExternalRecipientsFromTextObject().

     : int {
        $code = $this->data_manager->code("")
           ->withEmail($email)
           ->withLastName($lastname)
           ->withFirstName($firstname);
        $code_id = $this->code_manager->add($code);
        return $code_id;
    }

Here is the caller graph for this function:

addExternalRaterFormObject()

ilSurveyParticipantsGUI::addExternalRaterFormObject

(

ilPropertyFormGUI

$a_form = null

)

Definition at line 1324 of file class.ilSurveyParticipantsGUI.php.

References $access, $tabs, ILIAS\Repository\ctrl(), handleRatersAccess(), initExternalRaterForm(), and ILIAS\Repository\lng().

Referenced by addExternalRaterObject().

     : void {
        $ilTabs = $this->tabs;
        $ilAccess = $this->access;

        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);

        $has_write = $ilAccess->checkAccess("write", "", $this->ref_id);
        if ($has_write) {
            $ilTabs->clearTargets();
            $ilTabs->setBackTarget(
                $this->lng->txt("btn_back"),
                $this->ctrl->getLinkTarget($this, "editRaters")
            );
        }

        if (!$a_form) {
            $a_form = $this->initExternalRaterForm($appr_id);
        }

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

Here is the call graph for this function:

Here is the caller graph for this function:

addExternalRaterObject()

ilSurveyParticipantsGUI::addExternalRaterObject

(

)

Definition at line 1375 of file class.ilSurveyParticipantsGUI.php.

References addCodeForExternal(), addExternalRaterFormObject(), ILIAS\Repository\ctrl(), initExternalRaterForm(), and ILIAS\Repository\lng().

                                            : void
    {
        $appr_id = $this->edit_request->getAppraiseeId();
        if (!$appr_id) {
            $this->ctrl->redirect($this, "listAppraisees");
        }

        $this->ctrl->setParameter($this, "appr_id", $appr_id);

        $form = $this->initExternalRaterForm($appr_id);
        if ($form->checkInput()) {
            $code_id = $this->addCodeForExternal(
                $form->getInput("email"),
                $form->getInput("lname"),
                $form->getInput("fname")
            );

            $this->object->addRater($appr_id, 0, $code_id);

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
            $this->ctrl->setParameter($this, "appr_id", $appr_id);
            $this->ctrl->redirect($this, "editRaters");
        }

        $form->setValuesByPost();
        $this->addExternalRaterFormObject($form);
    }

Here is the call graph for this function:

addRater()

ilSurveyParticipantsGUI::addRater

(

array

$a_user_ids

)

Definition at line 1403 of file class.ilSurveyParticipantsGUI.php.

References $access, $ilUser, $user, ILIAS\Repository\ctrl(), handleRatersAccess(), and ILIAS\Repository\lng().

     : void {
        $ilAccess = $this->access;
        $ilUser = $this->user;

        $appr_id = $this->handleRatersAccess();

        if (count($a_user_ids)) {
            // #13319
            foreach (array_unique($a_user_ids) as $user_id) {
                if ($ilAccess->checkAccess("write", "", $this->ref_id) ||
                    $this->object->get360SelfEvaluation() ||
                    $user_id != $ilUser->getId()) {
                    if ($appr_id != $user_id) {
                        $this->object->addRater($appr_id, $user_id);
                        $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
                    } else {
                        $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_appraisses_cannot_be_raters"), true);
                    }
                }
            }
        }

        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->redirect($this, "editRaters");
    }

Here is the call graph for this function:

addSelfAppraiseeObject()

ilSurveyParticipantsGUI::addSelfAppraiseeObject

(

)

Definition at line 1496 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $user, ILIAS\Repository\ctrl(), and ILIAS\Repository\object().

                                            : void
    {
        $ilUser = $this->user;

        if ($this->object->get360SelfAppraisee() &&
            !$this->object->isAppraisee($ilUser->getId())) {
            $this->object->addAppraisee($ilUser->getId());
        }

        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

Here is the call graph for this function:

adminAppraiseesCloseObject()

ilSurveyParticipantsGUI::adminAppraiseesCloseObject

(

)

Definition at line 1795 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), handleWriteAccess(), and ILIAS\Repository\lng().

                                                : void
    {
        $this->handleWriteAccess();

        $appr_ids = $this->edit_request->getAppraiseeIds();

        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }

        $appr_data = $this->object->getAppraiseesData();
        foreach ($appr_ids as $appr_id) {
            if (isset($appr_data[$appr_id]) && !$appr_data[$appr_id]["closed"]) {
                $this->object->closeAppraisee($appr_id);
            }
        }

        $this->tpl->setOnScreenMessage('success', $this->lng->txt("survey_360_appraisee_close_action_success_admin"), true);
        $this->ctrl->redirect($this, "listAppraisees");
    }

Here is the call graph for this function:

appraiseeCloseObject()

ilSurveyParticipantsGUI::appraiseeCloseObject

(

)

Definition at line 1755 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $user, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                          : void
    {
        $ilUser = $this->user;

        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "infoScreen");
        }

        $this->object->closeAppraisee($ilUser->getId());
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("survey_360_appraisee_close_action_success"), true);
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

Here is the call graph for this function:

cancelDeleteAllUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteAllUserDataObject

(

)

Cancels delete of all user data in maintenance.

Definition at line 401 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl().

                                                   : void
    {
        $this->ctrl->redirect($this, "maintenance");
    }

Here is the call graph for this function:

cancelDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteSelectedUserDataObject

(

)

Cancels the deletion of all user data.

Definition at line 432 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                                        : void
    {
        $this->tpl->setOnScreenMessage('info', $this->lng->txt('msg_cancel'), true);
        $this->ctrl->redirect($this, "maintenance");
    }

Here is the call graph for this function:

codesObject()

ilSurveyParticipantsGUI::codesObject

(

)

Display the survey access codes tab.

Definition at line 490 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $lang, $toolbar, $user, ILIAS\Repository\ctrl(), ilSubmitButton\getInstance(), handleWriteAccess(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and setParticipantSubTabs().

                                 : void
    {
        $ilUser = $this->user;
        $ilToolbar = $this->toolbar;

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");

        if ($this->object->isAccessibleWithoutCode()) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("survey_codes_no_anonymization"));
            return;
        }

        $default_lang = $ilUser->getPref("survey_code_language");

        // creation buttons
        $ilToolbar->setFormAction($this->ctrl->getFormAction($this));

        $si = new ilTextInputGUI($this->lng->txt("new_survey_codes"), "nrOfCodes");
        $si->setValue(1);
        $si->setSize(3);
        $ilToolbar->addInputItem($si, true);

        $button = ilSubmitButton::getInstance();
        $button->setCaption("create");
        $button->setCommand("createSurveyCodes");
        $ilToolbar->addButtonInstance($button);

        $ilToolbar->addSeparator();

        $button = ilSubmitButton::getInstance();
        $button->setCaption("import_from_file");
        $button->setCommand("importExternalMailRecipientsFromFileForm");
        $ilToolbar->addButtonInstance($button);

        $button = ilSubmitButton::getInstance();
        $button->setCaption("import_from_text");
        $button->setCommand("importExternalMailRecipientsFromTextForm");
        $ilToolbar->addButtonInstance($button);

        $ilToolbar->addSeparator();

        $button = ilSubmitButton::getInstance();
        $button->setCaption("svy_import_codes");
        $button->setCommand("importAccessCodes");
        $ilToolbar->addButtonInstance($button);

        $ilToolbar->addSeparator();

        $languages = $this->lng->getInstalledLanguages();
        $options = array();
        $this->lng->loadLanguageModule("meta");
        foreach ($languages as $lang) {
            $options[$lang] = $this->lng->txt("meta_l_" . $lang);
        }
        $si = new ilSelectInputGUI($this->lng->txt("survey_codes_lang"), "lang");
        $si->setOptions($options);
        $si->setValue($default_lang);
        $ilToolbar->addInputItem($si, true);

        $button = ilSubmitButton::getInstance();
        $button->setCaption("set");
        $button->setCommand("setCodeLanguage");
        $ilToolbar->addButtonInstance($button);

        $table_gui = new ilSurveyCodesTableGUI($this, 'codes');
        $survey_codes = $this->object->getSurveyCodesTableData(null, $default_lang);
        $table_gui->setData($survey_codes);
        $this->tpl->setContent($table_gui->getHTML());
    }

Here is the call graph for this function:

confirmAdminAppraiseesCloseObject()

ilSurveyParticipantsGUI::confirmAdminAppraiseesCloseObject

(

)

Definition at line 1768 of file class.ilSurveyParticipantsGUI.php.

References $tpl, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), handleWriteAccess(), ILIAS\Repository\lng(), and ilGlobalTemplateInterface\setContent().

                                                       : void
    {
        $tpl = $this->tpl;

        $this->handleWriteAccess();

        $appr_ids = $this->edit_request->getAppraiseeIds();

        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }

        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_appraisee_close_admin"));

        $cgui->setFormAction($this->ctrl->getFormAction($this, "adminAppraiseesClose"));
        $cgui->setCancel($this->lng->txt("cancel"), "listAppraisees");
        $cgui->setConfirm($this->lng->txt("confirm"), "adminAppraiseesClose");

        foreach ($appr_ids as $appr_id) {
            $cgui->addItem("appr_id[]", $appr_id, ilUserUtil::getNamePresentation($appr_id));
        }

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

Here is the call graph for this function:

confirmAppraiseeCloseCancelObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseCancelObject

(

)

Definition at line 1750 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl().

                                                       : void
    {
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

Here is the call graph for this function:

confirmAppraiseeCloseObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseObject

(

)

Definition at line 1724 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $tabs, $tpl, $user, ilTabsGUI\clearTargets(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilGlobalTemplateInterface\setContent().

                                                 : void
    {
        $ilUser = $this->user;
        $tpl = $this->tpl;
        $ilTabs = $this->tabs;

        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("menuback"),
            $this->ctrl->getLinkTarget($this->parent_gui, "infoScreen")
        );

        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "infoScreen");
        }

        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_appraisee_close"));

        $cgui->setFormAction($this->ctrl->getFormAction($this, "appraiseeClose"));
        $cgui->setCancel($this->lng->txt("cancel"), "confirmAppraiseeCloseCancel");
        $cgui->setConfirm($this->lng->txt("confirm"), "appraiseeClose");

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

Here is the call graph for this function:

confirmDeleteAllUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteAllUserDataObject

(

)

Deletes all user data of the survey after confirmation.

Definition at line 378 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), filterSurveyParticipantsByAccess(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                                    : void
    {
        if ($this->access->checkAccess('write', '', $this->object->getRefId())) {
            $this->object->deleteAllUserData();
        } else {
            $participants = $this->filterSurveyParticipantsByAccess();
            foreach ($participants as $something => $participant_data) {
                $this->object->removeSelectedSurveyResults([$participant_data['active_id']]);
            }
        }

        // #11558 - re-open closed appraisees
        if ($this->object->get360Mode()) {
            $this->object->openAllAppraisees();
        }

        $this->tpl->setOnScreenMessage('success', $this->lng->txt("svy_all_user_data_deleted"), true);
        $this->ctrl->redirect($this, "maintenance");
    }

Here is the call graph for this function:

confirmDeleteAppraiseesObject()

ilSurveyParticipantsGUI::confirmDeleteAppraiseesObject

(

)

Definition at line 1182 of file class.ilSurveyParticipantsGUI.php.

References $data, $id, $tabs, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), and ILIAS\Repository\lng().

                                                   : void
    {
        $ilTabs = $this->tabs;

        $appr_ids = $this->edit_request->getAppraiseeIds();
        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }

        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "listAppraisees")
        );

        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_delete_appraises"));

        $cgui->setFormAction($this->ctrl->getFormAction($this, "deleteAppraisees"));
        $cgui->setCancel($this->lng->txt("cancel"), "listAppraisees");
        $cgui->setConfirm($this->lng->txt("confirm"), "deleteAppraisees");

        $data = $this->object->getAppraiseesData();

        $count = 0;
        foreach ($appr_ids as $id) {
            if (isset($data[$id]) && !$data[$id]["closed"]) {
                $cgui->addItem("appr_id[]", $id, ilUserUtil::getNamePresentation($id));
                $count++;
            }
        }

        if (!$count) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }

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

Here is the call graph for this function:

confirmDeleteRatersObject()

ilSurveyParticipantsGUI::confirmDeleteRatersObject

(

)

Definition at line 1431 of file class.ilSurveyParticipantsGUI.php.

References $data, $id, $tabs, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), handleRatersAccess(), and ILIAS\Repository\lng().

                                               : void
    {
        $ilTabs = $this->tabs;

        $rater_ids = $this->edit_request->getRaterIds();
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        if (count($rater_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "editRaters");
        }

        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "editRaters")
        );

        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText(sprintf(
            $this->lng->txt("survey_360_sure_delete_raters"),
            ilUserUtil::getNamePresentation($appr_id)
        ));

        $cgui->setFormAction($this->ctrl->getFormAction($this, "deleteRaters"));
        $cgui->setCancel($this->lng->txt("cancel"), "editRaters");
        $cgui->setConfirm($this->lng->txt("confirm"), "deleteRaters");

        $data = $this->object->getRatersData($appr_id);

        foreach ($rater_ids as $id) {
            if (isset($data[$id])) {
                $cgui->addItem("rtr_id[]", $id, $data[$id]["lastname"] . ", " .
                    $data[$id]["firstname"] . " (" . $data[$id]["email"] . ")");
            }
        }

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

Here is the call graph for this function:

confirmDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteSelectedUserDataObject

(

)

Deletes all user data for the test object.

Definition at line 409 of file class.ilSurveyParticipantsGUI.php.

References $i, ILIAS\Repository\ctrl(), ILIAS\Repository\int(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                                         : void
    {
        $user_ids = $this->edit_request->getUserIds();
        if (count($user_ids) > 0) {
            $this->object->removeSelectedSurveyResults(array_filter($user_ids, static function ($i): bool {
                return is_numeric($i);
            }));

            $invitations = array_filter($user_ids, static function ($i): bool {
                return strpos($i, "inv") === 0;
            });
            foreach ($invitations as $i) {
                $this->invitation_manager->remove($this->object->getSurveyId(), (int) substr($i, 3));
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("svy_selected_user_data_deleted"), true);
        }
        $this->ctrl->redirect($this, "maintenance");
    }

Here is the call graph for this function:

createSurveyCodesObject()

ilSurveyParticipantsGUI::createSurveyCodesObject

(

)

Create access codes for the survey.

Definition at line 779 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                             : void
    {
        if ($this->edit_request->getNrOfCodes() > 0) {
            $ids = $this->code_manager->addCodes($this->edit_request->getNrOfCodes());
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_created'), true);
            $this->ctrl->setParameter($this, "new_ids", implode(";", $ids));
            $this->ctrl->redirect($this, 'editCodes');
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("enter_valid_number_of_codes"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

Here is the call graph for this function:

deleteAllUserDataObject()

ilSurveyParticipantsGUI::deleteAllUserDataObject

(

)

Creates a confirmation form for delete all user data.

Definition at line 365 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

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

Here is the call graph for this function:

deleteAppraiseesObject()

ilSurveyParticipantsGUI::deleteAppraiseesObject

(

)

Definition at line 1223 of file class.ilSurveyParticipantsGUI.php.

References $data, $id, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                            : void
    {
        $appr_ids = $this->edit_request->getAppraiseeIds();
        if (count($appr_ids) > 0) {
            $data = $this->object->getAppraiseesData();

            foreach ($appr_ids as $id) {
                // #11285
                if (isset($data[$id]) && !$data[$id]["closed"]) {
                    $this->object->deleteAppraisee($id);
                }
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }

        $this->ctrl->redirect($this, "listAppraisees");
    }

Here is the call graph for this function:

deleteCodesConfirmObject()

ilSurveyParticipantsGUI::deleteCodesConfirmObject

(

)

Definition at line 613 of file class.ilSurveyParticipantsGUI.php.

References $data, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                              : void
    {
        $codes = $this->edit_request->getCodes();

        $data = $this->object->getSurveyCodesTableData($codes);
        $data = array_filter($data, static function ($item): bool {
            return !$item["used"];
        });
        if (count($data) > 0) {
            $cgui = new ilConfirmationGUI();
            $cgui->setHeaderText($this->lng->txt("survey_code_delete_sure"));

            $cgui->setFormAction($this->ctrl->getFormAction($this));
            $cgui->setCancel($this->lng->txt("cancel"), "codes");
            $cgui->setConfirm($this->lng->txt("confirm"), "deleteCodes");

            foreach ($data as $item) {
                $title = array($item["code"]);
                $title[] = $item["email"] ?? "";
                $title[] = $item["last_name"] ?? "";
                $title[] = $item["first_name"] ?? "";
                $title = implode(", ", $title);

                $cgui->addItem("chb_code[]", $item["code"], $title);
            }

            $this->tpl->setContent($cgui->getHTML());
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('svy_please_select_unused_codes'), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

Here is the call graph for this function:

deleteCodesObject()

ilSurveyParticipantsGUI::deleteCodesObject

(

)

Delete a list of survey codes.

Definition at line 649 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        if (count($codes) > 0) {
            foreach ($codes as $survey_code) {
                $this->object->deleteSurveyCode($survey_code);
            }
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_deleted'), true);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
        }
        $this->ctrl->redirect($this, 'codes');
    }

Here is the call graph for this function:

deleteRatersObject()

ilSurveyParticipantsGUI::deleteRatersObject

(

)

Definition at line 1471 of file class.ilSurveyParticipantsGUI.php.

References $data, $id, ILIAS\Repository\ctrl(), handleRatersAccess(), and ILIAS\Repository\lng().

                                        : void
    {
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);

        $rater_ids = $this->edit_request->getRaterIds();
        if (count($rater_ids) > 0) {
            $data = $this->object->getRatersData($appr_id);

            foreach ($rater_ids as $id) {
                if (isset($data[$id])) {
                    if (strpos($id, "u") === 0) {
                        $this->object->deleteRater($appr_id, substr($id, 1));
                    } else {
                        $this->object->deleteRater($appr_id, 0, substr($id, 1));
                    }
                }
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }

        $this->ctrl->redirect($this, "editRaters");
    }

Here is the call graph for this function:

deleteSavedMessageObject()

ilSurveyParticipantsGUI::deleteSavedMessageObject

(

)

Definition at line 815 of file class.ilSurveyParticipantsGUI.php.

References Vendor\Package\$e, $log, handleWriteAccess(), ILIAS\Repository\lng(), setParticipantSubTabs(), and ilLogger\write().

                                              : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");

        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByPost();
        try {
            if ($form_gui->getSavedMessages()->getValue() > 0) {
                $this->object->deleteUserSettings($form_gui->getSavedMessages()->getValue());
                $form_gui = new FormMailCodesGUI($this);
                $form_gui->setValuesByPost();
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_message_deleted'));
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_message_deleted'));
            }
        } catch (Exception $e) {
            $ilLog = $this->log;
            $ilLog->write('Error: ' . $e->getMessage());
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

Here is the call graph for this function:

deleteSingleUserResultsObject()

ilSurveyParticipantsGUI::deleteSingleUserResultsObject

(

)

Asks for a confirmation to delete selected user data.

Definition at line 441 of file class.ilSurveyParticipantsGUI.php.

References $data, ILIAS\Repository\ctrl(), handleWriteAccess(), and ILIAS\Repository\lng().

                                                   : void
    {
        $this->handleWriteAccess();

        $user_ids = $this->edit_request->getUserIds();
        if (count($user_ids) === 0) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, "maintenance");
        }

        $this->tpl->setOnScreenMessage('question', $this->lng->txt("confirm_delete_single_user_data"));
        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance', true);
        $total = $this->object->getSurveyParticipants(null, false, true);
        $data = array();
        foreach ($total as $user_data) {
            if (in_array(($user_data['active_id'] ?? null), $user_ids)
                || (($user_data['invited'] ?? false) && in_array("inv" . $user_data['usr_id'], $user_ids))) {
                $last_access = $this->object->getLastAccess($user_data["active_id"] ?? 0);
                $data[] = array(
                    'id' => $user_data["active_id"] ?? null,
                    'name' => $user_data["sortname"],
                    'login' => $user_data["login"] ?? null,
                    'last_access' => $last_access,
                    'finished' => $user_data["finished_tstamp"] ?? 0,
                    'usr_id' => $user_data["usr_id"] ?? null,
                    'invited' => $user_data["invited"] ?? null
                );
            }
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

Here is the call graph for this function:

editCodesObject()

ilSurveyParticipantsGUI::editCodesObject

(

)

Definition at line 561 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and setParticipantSubTabs().

                                     : void
    {
        $ids = $this->edit_request->getCodeIds();
        if (count($ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, 'codes');
        }

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");

        $table_gui = new ilSurveyCodesEditTableGUI($this, 'editCodes');
        $table_gui->setData($this->object->getSurveyCodesTableData($ids));
        $this->tpl->setContent($table_gui->getHTML());
    }

Here is the call graph for this function:

editRatersObject()

ilSurveyParticipantsGUI::editRatersObject

(

)

Definition at line 1287 of file class.ilSurveyParticipantsGUI.php.

References $access, $tabs, $toolbar, $url, ilLink\_getStaticLink(), ILIAS\Repository\ctrl(), handleRatersAccess(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ilTable2GUI\setData(), and storeMailSent().

                                      : void
    {
        if ($this->edit_request->getReturnedFromMail() === 1) {
            $this->storeMailSent();
        }

        $ilTabs = $this->tabs;
        $ilToolbar = $this->toolbar;
        $ilAccess = $this->access;
        $ilTabs->activateTab("survey_360_edit_raters");
        $appr_id = $this->handleRatersAccess();

        $has_write = $ilAccess->checkAccess("write", "", $this->ref_id);
        if ($has_write) {
            $ilTabs->clearTargets();
            $ilTabs->setBackTarget(
                $this->lng->txt("btn_back"),
                $this->ctrl->getLinkTarget($this, "listAppraisees")
            );
        }

        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->setParameter($this, "rate360", 1);

        $ilToolbar->addButton(
            $this->lng->txt("svy_add_rater"),
            $this->ctrl->getLinkTargetByClass("ilSurveyRaterGUI", "add")
        );

        // #13320
        $url = ilLink::_getStaticLink($this->object->getRefId());

        $tbl = new ilSurveyAppraiseesTableGUI($this, "editRaters", true, !$this->object->isAppraiseeClosed($appr_id), $url); // #11285
        $tbl->setData($this->object->getRatersData($appr_id));
        $this->tpl->setContent($tbl->getHTML());
    }

Here is the call graph for this function:

executeCommand()

ilSurveyParticipantsGUI::executeCommand

(

)

Definition at line 113 of file class.ilSurveyParticipantsGUI.php.

References $ctrl, $lng, $tabs, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ilLanguage\txt().

                                    : void
    {
        $ilCtrl = $this->ctrl;
        $ilTabs = $this->tabs;
        $lng = $this->lng;

        $cmd = $ilCtrl->getCmd("maintenance");
        $next_class = $this->ctrl->getNextClass($this);

        switch ($next_class) {
            case 'ilrepositorysearchgui':
                $rep_search = new ilRepositorySearchGUI();

                if (!$this->edit_request->getAppr360() && !$this->edit_request->getRate360()) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $this->lng->txt("btn_back"),
                        $this->ctrl->getLinkTarget($this, "maintenance")
                    );

                    $rep_search->setCallback(
                        $this,
                        'inviteUsers',
                        array(
                            )
                    );
                    $rep_search->setTitle($lng->txt("svy_invite_participants"));
                    // Set tabs
                    $this->ctrl->setReturn($this, 'maintenance');
                    $this->ctrl->forwardCommand($rep_search);
                    $ilTabs->setTabActive('maintenance');
                } elseif ($this->edit_request->getRate360()) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $this->lng->txt("btn_back"),
                        $this->ctrl->getLinkTarget($this, "listAppraisees")
                    );

                    $this->ctrl->setParameter($this, "rate360", 1);
                    $this->ctrl->saveParameter($this, "appr_id");

                    $rep_search->setCallback(
                        $this,
                        'addRater',
                        array(
                            )
                    );

                    // Set tabs
                    $this->ctrl->setReturn($this, 'editRaters');
                    $this->ctrl->forwardCommand($rep_search);
                } else {
                    $ilTabs->activateTab("survey_360_appraisees");
                    $this->ctrl->setParameter($this, "appr360", 1);

                    $rep_search->setCallback(
                        $this,
                        'addAppraisee',
                        array(
                            )
                    );

                    // Set tabs
                    $this->ctrl->setReturn($this, 'listAppraisees');
                    $this->ctrl->forwardCommand($rep_search);
                }
                break;

            case 'ilsurveyratergui':
                $ilTabs->activateTab("survey_360_edit_raters");
                $rater_gui = new ilSurveyRaterGUI($this, $this->object);
                $this->ctrl->forwardCommand($rater_gui);
                break;

            default:
                $cmd .= "Object";
                $this->$cmd();
                break;
        }
    }

Here is the call graph for this function:

exportAllCodesObject()

ilSurveyParticipantsGUI::exportAllCodesObject

(

)

Exports all survey codes.

Definition at line 681 of file class.ilSurveyParticipantsGUI.php.

References ilUtil\deliverData(), ilFileUtils\getASCIIFilename(), and ILIAS\Repository\object().

                                          : void
    {
        $export = $this->object->getSurveyCodesForExport();
        ilUtil::deliverData($export, ilFileUtils::getASCIIFilename($this->object->getTitle() . ".csv"));
    }

Here is the call graph for this function:

exportCodesObject()

ilSurveyParticipantsGUI::exportCodesObject

(

)

Exports a list of survey codes.

Definition at line 666 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), ilUtil\deliverData(), ilFileUtils\getASCIIFilename(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        if (count($codes) > 0) {
            $export = $this->object->getSurveyCodesForExport(null, $codes);
            ilUtil::deliverData($export, ilFileUtils::getASCIIFilename($this->object->getTitle() . ".csv"));
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

Here is the call graph for this function:

filterSurveyParticipantsByAccess()

ilSurveyParticipantsGUI::filterSurveyParticipantsByAccess ( array  $a_finished_ids = null )

protected

Definition at line 194 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\access(), and ILIAS\Repository\object().

Referenced by confirmDeleteAllUserDataObject(), and maintenanceObject().

     : array {
        $all_participants = $this->object->getSurveyParticipants($a_finished_ids, false, true);
        $participant_ids = [];
        foreach ($all_participants as $participant) {
            if (isset($participant['usr_id'])) {
                $participant_ids[] = $participant['usr_id'];
            }
        }

        $filtered_participant_ids = $this->access->filterUserIdsByRbacOrPositionOfCurrentUser(
            'read_results',
            'access_results',
            $this->object->getRefId(),
            $participant_ids
        );

        $participants = [];
        foreach ($all_participants as $username => $user_data) {
            if (!($user_data['usr_id'] ?? false)) {
                $participants[$username] = $user_data;
            }
            if (in_array(($user_data['usr_id'] ?? -1), $filtered_participant_ids)) {
                $participants[$username] = $user_data;
            }
        }

        return $participants;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObject()

ilSurveyParticipantsGUI::getObject

(

)

Definition at line 101 of file class.ilSurveyParticipantsGUI.php.

References $object.

                               : ilObjSurvey
    {
        return $this->object;
    }

handleRatersAccess()

ilSurveyParticipantsGUI::handleRatersAccess

(

)

Definition at line 1242 of file class.ilSurveyParticipantsGUI.php.

References $access, $ilUser, $user, ILIAS\Repository\ctrl(), and ILIAS\Repository\object().

Referenced by addExternalRaterFormObject(), addRater(), confirmDeleteRatersObject(), deleteRatersObject(), editRatersObject(), mailRatersActionObject(), mailRatersObject(), mailRatersObjectOld(), and storeMailSent().

                                        : ?int
    {
        $ilAccess = $this->access;
        $ilUser = $this->user;

        if ($ilAccess->checkAccess("write", "", $this->ref_id)) {
            $appr_id = $this->edit_request->getAppraiseeId();
            if (!$appr_id) {
                $this->ctrl->redirect($this, "listAppraisees");
            }
            return $appr_id;
        } elseif ($this->feature_config->usesAppraisees() &&
            $this->object->get360SelfRaters() &&
            $this->object->isAppraisee($ilUser->getId()) &&
            !$this->object->isAppraiseeClosed($ilUser->getId())) {
            return $ilUser->getId();
        }
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleWriteAccess()

ilSurveyParticipantsGUI::handleWriteAccess ( )

protected

Definition at line 106 of file class.ilSurveyParticipantsGUI.php.

Referenced by adminAppraiseesCloseObject(), codesObject(), confirmAdminAppraiseesCloseObject(), deleteSavedMessageObject(), deleteSingleUserResultsObject(), editCodesObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), insertSavedMessageObject(), listAppraiseesObject(), listParticipantsObject(), mailCodesObject(), maintenanceObject(), and sendCodesMailObject().

                                          : void
    {
        if (!$this->has_write) {
            throw new ilSurveyException("Permission denied");
        }
    }

Here is the caller graph for this function:

importAccessCodesActionObject()

ilSurveyParticipantsGUI::importAccessCodesActionObject ( )

protected

Import codes from export codes file.

Definition at line 722 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\LTI\ToolProvider\$created, $email, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                                      : void
    {
        if (trim($_FILES['codes']['tmp_name'])) {
            $existing = array();
            foreach ($this->object->getSurveyCodesTableData() as $item) {
                $existing[$item["code"]] = $item["id"];
            }

            $reader = new ilCSVReader();
            $reader->open($_FILES['codes']['tmp_name']);
            foreach ($reader->getCsvAsArray() as $row) {
                // numeric check of used column due to #26176
                $code = $row[0] ?? "";
                if ($code === "") {
                    continue;
                }
                $email = $row[1] ?? "";
                if (!is_int(strpos($email, "@")) && $email !== "") {
                    continue;
                }
                $last_name = $row[2] ?? "";
                $first_name = $row[3] ?? "";
                $created = time();

                // unique code?
                if (!array_key_exists($code, $existing)) {
                    // could be date or datetime
                    /*try {
                        if (strlen($created) === 10) {
                            $created = new ilDate($created, IL_CAL_DATE);
                        } else {
                            $created = new ilDateTime($created, IL_CAL_DATETIME);
                        }
                        $created = $created->get(IL_CAL_UNIX);
                    } catch (Exception $e) {
                        $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
                        $this->ctrl->redirect($this, 'codes');
                    }*/

                    $user_data = array(
                        "email" => $email
                        ,"lastname" => $last_name
                        ,"firstname" => $first_name
                    );
                    $this->object->importSurveyCode($code, $created, $user_data);
                }
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_created'), true);
        }

        $this->ctrl->redirect($this, 'codes');
    }

Here is the call graph for this function:

importAccessCodesObject()

ilSurveyParticipantsGUI::importAccessCodesObject ( )

protected

Import codes from export codes file (upload form)

Definition at line 690 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), ilFormPropertyGUI\setInfo(), and setParticipantSubTabs().

                                                : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");

        $form_import_file = new ilPropertyFormGUI();
        $form_import_file->setFormAction($this->ctrl->getFormAction($this));
        $form_import_file->setTableWidth("100%");
        $form_import_file->setId("codes_import_file");

        $headerfile = new ilFormSectionHeaderGUI();
        $headerfile->setTitle($this->lng->txt("svy_import_codes"));
        $form_import_file->addItem($headerfile);

        $export_file = new ilFileInputGUI($this->lng->txt("codes"), "codes");
        $export_file->setInfo(sprintf(
            $this->lng->txt('svy_import_codes_info'),
            $this->lng->txt("export_all_survey_codes")
        ));
        $export_file->setSuffixes(array("csv"));
        $export_file->setRequired(true);
        $form_import_file->addItem($export_file);

        $form_import_file->addCommandButton("importAccessCodesAction", $this->lng->txt("import"));
        $form_import_file->addCommandButton("codes", $this->lng->txt("cancel"));

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

Here is the call graph for this function:

importExternalMailRecipientsFromFileFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromFileFormObject

(

)

Definition at line 1048 of file class.ilSurveyParticipantsGUI.php.

References $access, ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), ilFormPropertyGUI\setInfo(), and setParticipantSubTabs().

                                                                    : void
    {
        $ilAccess = $this->access;

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");

        $form_import_file = new ilPropertyFormGUI();
        $form_import_file->setFormAction($this->ctrl->getFormAction($this));
        $form_import_file->setTableWidth("100%");
        $form_import_file->setId("codes_import_file");

        $headerfile = new ilFormSectionHeaderGUI();
        $headerfile->setTitle($this->lng->txt("import_from_file"));
        $form_import_file->addItem($headerfile);

        $externalmails = new ilFileInputGUI($this->lng->txt("externalmails"), "externalmails");
        $externalmails->setInfo($this->lng->txt('externalmails_info'));
        $externalmails->setRequired(true);
        $form_import_file->addItem($externalmails);
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_file->addCommandButton("importExternalRecipientsFromFile", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_file->addCommandButton("codes", $this->lng->txt("cancel"));
        }

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

Here is the call graph for this function:

importExternalMailRecipientsFromTextFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromTextFormObject

(

)

Definition at line 1078 of file class.ilSurveyParticipantsGUI.php.

References $access, ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), setParticipantSubTabs(), and ilTextAreaInputGUI\setValue().

                                                                    : void
    {
        $ilAccess = $this->access;

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");

        $form_import_text = new ilPropertyFormGUI();
        $form_import_text->setFormAction($this->ctrl->getFormAction($this));
        $form_import_text->setTableWidth("100%");
        $form_import_text->setId("codes_import_text");

        $headertext = new ilFormSectionHeaderGUI();
        $headertext->setTitle($this->lng->txt("import_from_text"));
        $form_import_text->addItem($headertext);

        $inp = new ilTextAreaInputGUI($this->lng->txt('externaltext'), 'externaltext');
        $external_text = $this->edit_manager->getExternalText();
        if ($external_text !== "") {
            $inp->setValue($external_text);
        } else {
            // $this->lng->txt('mail_import_example1') #14897
            $inp->setValue("email;firstname;lastname\n" . $this->lng->txt('mail_import_example2') . "\n" . $this->lng->txt('mail_import_example3') . "\n");
        }
        $inp->setRequired(true);
        $inp->setCols(80);
        $inp->setRows(10);
        $inp->setInfo($this->lng->txt('externaltext_info'));
        $form_import_text->addItem($inp);
        $this->edit_manager->setExternalText("");

        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_text->addCommandButton("importExternalRecipientsFromText", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_text->addCommandButton("codes", $this->lng->txt("cancel"));
        }

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

Here is the call graph for this function:

importExternalRecipientsFromFileObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromFileObject

(

)

Definition at line 988 of file class.ilSurveyParticipantsGUI.php.

References $data, ILIAS\LTI\ToolProvider\$key, _convertCharset(), addCodeForExternal(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and removeUTF8Bom().

                                                            : void
    {
        if (trim($_FILES['externalmails']['tmp_name'])) {
            $reader = new ilCSVReader();
            $reader->open($_FILES['externalmails']['tmp_name']);
            $data = $reader->getCsvAsArray();
            $fields = array_shift($data);
            foreach ($fields as $idx => $field) {
                $fields[$idx] = $this->removeUTF8Bom($field);
            }
            if (!in_array('email', $fields, true)) {
                $reader->close();
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('err_external_rcp_no_email'), true);
                $this->ctrl->redirect($this, 'codes');
            }
            $existingdata = $this->object->getExternalCodeRecipients();
            $existingcolumns = array();
            if (count($existingdata)) {
                $first = array_shift($existingdata);
                foreach ($first as $key => $value) {
                    $existingcolumns[] = $key;
                }
            }

            $founddata = array();
            foreach ($data as $row) {
                if (count($row) === count($fields)) {
                    $dataset = array();
                    foreach ($fields as $idx => $fieldname) {
                        // #14811
                        $row[$idx] = $this->_convertCharset($row[$idx]);

                        if (count($existingcolumns)) {
                            if (array_key_exists($idx, $existingcolumns)) {
                                $dataset[$fieldname] = $row[$idx];
                            }
                        } else {
                            $dataset[$fieldname] = $row[$idx];
                        }
                    }
                    if ($dataset['email'] !== '') {
                        $founddata[] = $dataset;
                        $this->addCodeForExternal(
                            $dataset['email'],
                            $dataset['lastname'] ?? "",
                            $dataset['firstname'] ?? ""
                        );
                    }
                }
            }
            $reader->close();

            if (count($founddata)) {
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('external_recipients_imported'), true);
            }
        }

        $this->ctrl->redirect($this, 'codes');
    }

Here is the call graph for this function:

importExternalRecipientsFromTextObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromTextObject

(

)

Definition at line 898 of file class.ilSurveyParticipantsGUI.php.

References $data, ILIAS\LTI\ToolProvider\$key, addCodeForExternal(), ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                                            : void
    {
        if (trim($this->edit_request->getExternalText())) {
            $data = preg_split("/[\n\r]/", $this->edit_request->getExternalText());
            $fields = explode(";", array_shift($data));
            if (!in_array('email', $fields, true)) {
                $this->edit_manager->setExternalText($this->edit_request->getExternalText());
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('err_external_rcp_no_email_column'), true);
                $this->ctrl->redirect($this, 'importExternalMailRecipientsFromTextForm');
            }
            $existingdata = $this->object->getExternalCodeRecipients();
            $existingcolumns = array();
            if (count($existingdata)) {
                $first = array_shift($existingdata);
                foreach ($first as $key => $value) {
                    $existingcolumns[] = $key;
                }
            }
            $founddata = array();
            foreach ($data as $datarow) {
                $row = explode(";", $datarow);
                if (count($row) === count($fields)) {
                    $dataset = array();
                    foreach ($fields as $idx => $fieldname) {
                        if (count($existingcolumns)) {
                            if (array_key_exists($idx, $existingcolumns)) {
                                $dataset[$fieldname] = $row[$idx];
                            }
                        } else {
                            $dataset[$fieldname] = $row[$idx];
                        }
                    }
                    if ($dataset['email'] !== '') {
                        $this->addCodeForExternal(
                            $dataset['email'],
                            $dataset['lastname'] ?? "",
                            $dataset['firstname'] ?? ""
                        );
                    }
                }
            }
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('external_recipients_imported'), true);
            $this->ctrl->redirect($this, 'codes');
        }

        $this->ctrl->redirect($this, 'importExternalMailRecipientsFromTextForm');
    }

Here is the call graph for this function:

initExternalRaterForm()

ilSurveyParticipantsGUI::initExternalRaterForm ( int  $appr_id )

protected

Definition at line 1349 of file class.ilSurveyParticipantsGUI.php.

References $email, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), and ILIAS\Repository\lng().

Referenced by addExternalRaterFormObject(), and addExternalRaterObject().

     : ilPropertyFormGUI {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "addExternalRater"));
        $form->setTitle($this->lng->txt("survey_360_add_external_rater") .
            ": " . ilUserUtil::getNamePresentation($appr_id));

        $email = new ilEmailInputGUI($this->lng->txt("email"), "email");
        $email->setRequired(true);
        $form->addItem($email);

        $lname = new ilTextInputGUI($this->lng->txt("lastname"), "lname");
        $lname->setSize(30);
        $form->addItem($lname);

        $fname = new ilTextInputGUI($this->lng->txt("firstname"), "fname");
        $fname->setSize(30);
        $form->addItem($fname);

        $form->addCommandButton("addExternalRater", $this->lng->txt("save"));
        $form->addCommandButton("editRaters", $this->lng->txt("cancel"));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initMailRatersForm()

ilSurveyParticipantsGUI::initMailRatersForm	(	int	$appr_id,
		array	$rec_ids
	)

Definition at line 1508 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\LTI\ToolProvider\$key, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilCustomInputGUI\setHtml(), and ilFormPropertyGUI\setRequired().

Referenced by mailRatersActionObject(), and mailRatersObjectOld().

     : ilPropertyFormGUI {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "mailRatersAction"));
        $form->setTitle($this->lng->txt('compose'));

        $all_data = $this->object->getRatersData($appr_id);
        $rec_data = array();
        foreach ($rec_ids as $rec_id) {
            if (isset($all_data[$rec_id])) {
                $rec_data[] = $all_data[$rec_id]["lastname"] . ", " .
                    $all_data[$rec_id]["firstname"] .
                    " (" . $all_data[$rec_id]["email"] . ")";
            }
        }
        sort($rec_data);
        $rec = new ilCustomInputGUI($this->lng->txt('recipients'));
        $rec->setHtml(implode("<br />", $rec_data));
        $form->addItem($rec);

        $subject = new ilTextInputGUI($this->lng->txt('subject'), 'subject');
        $subject->setSize(50);
        $subject->setRequired(true);
        $form->addItem($subject);

        $existingdata = $this->object->getExternalCodeRecipients();
        $existingcolumns = array();
        if (count($existingdata)) {
            $first = array_shift($existingdata);
            foreach ($first as $key => $value) {
                if (strcmp($key, 'code') !== 0 && strcmp($key, 'email') !== 0 && strcmp($key, 'sent') !== 0) {
                    $existingcolumns[] = '[' . $key . ']';
                }
            }
        }

        $mailmessage_u = new ilTextAreaInputGUI($this->lng->txt('survey_360_rater_message_content_registered'), 'message_u');
        $mailmessage_u->setRequired(true);
        $mailmessage_u->setCols(80);
        $mailmessage_u->setRows(10);
        $form->addItem($mailmessage_u);

        $mailmessage_a = new ilTextAreaInputGUI($this->lng->txt('survey_360_rater_message_content_anonymous'), 'message_a');
        $mailmessage_a->setRequired(true);
        $mailmessage_a->setCols(80);
        $mailmessage_a->setRows(10);
        $mailmessage_a->setInfo(sprintf($this->lng->txt('message_content_info'), implode(', ', $existingcolumns)));
        $form->addItem($mailmessage_a);

        $recf = new ilHiddenInputGUI("rater_id");
        $recf->setValue(implode(";", $rec_ids));
        $form->addItem($recf);

        $form->addCommandButton("mailRatersAction", $this->lng->txt("send"));
        $form->addCommandButton("editRaters", $this->lng->txt("cancel"));

        $subject->setValue(sprintf($this->lng->txt('survey_360_rater_subject_default'), $this->object->getTitle()));
        $mailmessage_u->setValue($this->lng->txt('survey_360_rater_message_content_registered_default'));
        $mailmessage_a->setValue($this->lng->txt('survey_360_rater_message_content_anonymous_default'));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

insertSavedMessageObject()

ilSurveyParticipantsGUI::insertSavedMessageObject

(

)

Definition at line 792 of file class.ilSurveyParticipantsGUI.php.

References Vendor\Package\$e, $ilUser, $log, ILIAS\LTI\ToolProvider\$settings, $user, handleWriteAccess(), ILIAS\Repository\lng(), setParticipantSubTabs(), and ilLogger\write().

                                              : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");

        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByPost();
        try {
            if ($form_gui->getSavedMessages()->getValue() > 0) {
                $ilUser = $this->user;
                $settings = $this->object->getUserSettings($ilUser->getId(), 'savemessage');
                $form_gui->getMailMessage()->setValue($settings[$form_gui->getSavedMessages()->getValue()]['value']);
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_message_inserted'));
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_message_inserted'));
            }
        } catch (Exception $e) {
            $ilLog = $this->log;
            $ilLog->write('Error: ' . $e->getMessage());
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

Here is the call graph for this function:

inviteUsers()

ilSurveyParticipantsGUI::inviteUsers

(

array

$user_ids

)

Parameters

int[]

$user_ids

Exceptions

ilCtrlException

Definition at line 1842 of file class.ilSurveyParticipantsGUI.php.

References $ctrl, $lng, ILIAS\Repository\object(), ilCtrl\redirect(), and ilLanguage\txt().

                                                : void
    {
        $lng = $this->lng;
        $ctrl = $this->ctrl;

        foreach ($user_ids as $user_id) {
            $this->invitation_manager->add($this->object->getSurveyId(), $user_id);
        }
        $this->tpl->setOnScreenMessage('success', $lng->txt("svy_users_invited"), true);
        $ctrl->redirect($this, "maintenance");
    }

Here is the call graph for this function:

isAnonymousListActive()

ilSurveyParticipantsGUI::isAnonymousListActive ( )

protected

Definition at line 300 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\int().

Referenced by listParticipantsObject(), and setParticipantSubTabs().

                                              : bool
    {
        $surveySetting = new ilSetting("survey");

        if ($surveySetting->get("anonymous_participants", false) && $this->object->hasAnonymizedResults() &&
            $this->object->hasAnonymousUserList()) {
            $end = $this->object->getEndDate();
            if ($end && $end < date("YmdHis")) {
                $min = (int) $surveySetting->get("anonymous_participants_min", '0');
                $total = $this->object->getSurveyParticipants();
                if (!$min || count($total) >= $min) {
                    return true;
                }
            }
        }
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

listAppraiseesObject()

ilSurveyParticipantsGUI::listAppraiseesObject

(

)

Definition at line 1123 of file class.ilSurveyParticipantsGUI.php.

References $ctrl, $lng, $ref_id, $toolbar, ILIAS\Repository\ctrl(), ilRepositorySearchGUI\fillAutoCompleteToolbar(), handleWriteAccess(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilLanguage\txt().

Referenced by maintenanceObject().

                                          : void
    {
        $ilToolbar = $this->toolbar;
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;

        $this->handleWriteAccess();

        $this->ctrl->setParameter($this, "appr360", 1);

        ilRepositorySearchGUI::fillAutoCompleteToolbar(
            $this,
            $ilToolbar,
            array(
                'auto_complete_name' => $this->lng->txt('user'),
                'submit_name' => $this->lng->txt('add'),
                'add_search' => true,
                'add_from_container' => $this->ref_id
            )
        );

        // competence calculations
        $skmg_set = new ilSkillManagementSettings();
        if ($this->object->getSkillService() && $skmg_set->isActivated()) {
            $ilToolbar->addSeparator();
            $ilToolbar->addButton(
                $lng->txt("survey_calc_skills"),
                $ilCtrl->getLinkTargetByClass("ilsurveyskilldeterminationgui"),
                ""
            );
        }

        $ilToolbar->addSeparator();
        $ilToolbar->addButton(
            $this->lng->txt('svy_delete_all_user_data'),
            $this->ctrl->getLinkTarget($this, 'deleteAllUserData')
        );

        $this->ctrl->setParameter($this, "appr360", "");

        $tbl = new ilSurveyAppraiseesTableGUI($this, "listAppraisees");
        $tbl->setData($this->object->getAppraiseesData());
        $this->tpl->setContent($tbl->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

listParticipantsObject()

ilSurveyParticipantsGUI::listParticipantsObject ( )

protected

Definition at line 1817 of file class.ilSurveyParticipantsGUI.php.

References $toolbar, ILIAS\Repository\ctrl(), ilLinkButton\getInstance(), handleWriteAccess(), isAnonymousListActive(), and setParticipantSubTabs().

                                               : void
    {
        $ilToolbar = $this->toolbar;

        if (!$this->isAnonymousListActive()) {
            $this->ctrl->redirect($this, "maintenance");
        }

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("anon_participants");

        $button = ilLinkButton::getInstance();
        $button->setCaption("print");
        $button->setOnClick("window.print(); return false;");
        $button->setOmitPreventDoubleSubmission(true);
        $ilToolbar->addButtonInstance($button);

        $tbl = new ilSurveyParticipantsTableGUI($this, "listParticipants", $this->object);
        $this->tpl->setContent($tbl->getHTML());
    }

Here is the call graph for this function:

mailCodesObject()

ilSurveyParticipantsGUI::mailCodesObject

(

)

Definition at line 838 of file class.ilSurveyParticipantsGUI.php.

References handleWriteAccess(), ILIAS\Repository\lng(), and setParticipantSubTabs().

                                     : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");

        $mailData['m_subject'] =
            $this->edit_request->getCodeMailPart("subject")
            ?: sprintf($this->lng->txt('default_codes_mail_subject'), $this->object->getTitle());
        $mailData['m_message'] =
            $this->edit_request->getCodeMailPart("message")
                ?: $this->lng->txt('default_codes_mail_message');
        $mailData['m_notsent'] =
            $this->edit_request->getCodeMailPart("notsent")
                ?: '1';

        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByArray($mailData);
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

Here is the call graph for this function:

mailRatersActionObject()

ilSurveyParticipantsGUI::mailRatersActionObject

(

)

Definition at line 1651 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $url, $user, ilLink\_getStaticLink(), ANONYMOUS_USER_ID, ILIAS\Repository\ctrl(), handleRatersAccess(), initMailRatersForm(), ILIAS\Repository\lng(), mailRatersObject(), and ILIAS\Repository\object().

                                            : void
    {
        $ilUser = $this->user;
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);

        $rec_ids = $this->edit_request->getRaterIds();
        if (count($rec_ids) === 0) {
            $this->ctrl->redirect($this, "editRaters");
        }

        $form = $this->initMailRatersForm($appr_id, $rec_ids);
        if ($form->checkInput()) {
            $txt_u = $form->getInput("message_u");
            $txt_a = $form->getInput("message_a");
            $subj = $form->getInput("subject");

            // #12743
            $sender_id = (trim($ilUser->getEmail()))
                ? $ilUser->getId()
                : ANONYMOUS_USER_ID;

            $all_data = $this->object->getRatersData($appr_id);
            foreach ($rec_ids as $rec_id) {
                if (isset($all_data[$rec_id])) {
                    $user = $all_data[$rec_id];

                    // anonymous
                    if (strpos($rec_id, "a") === 0) {
                        $mytxt = $txt_a;
                        $url = $user["href"];
                        $rcp = $user["email"];
                    }
                    // reg
                    else {
                        $mytxt = $txt_u;
                        $user["code"] = $this->lng->txt("survey_code_mail_on_demand");
                        $url = ilLink::_getStaticLink($this->object->getRefId());
                        $rcp = $user["login"]; // #15141
                    }

                    $mytxt = str_replace(
                        ["[lastname]", "[firstname]", "[url]", "[code]"],
                        [$user["lastname"], $user["firstname"], $url, $user["code"]],
                        $mytxt
                    );

                    $mail = new ilMail($sender_id);
                    $mail->enqueue(
                        $rcp, // to
                        "", // cc
                        "", // bcc
                        $subj, // subject
                        $mytxt, // message
                        array() // attachments
                    );

                    $this->object->set360RaterSent(
                        $appr_id,
                        (strpos($rec_id, "a") === 0) ? 0 : (int) substr($rec_id, 1),
                        (strpos($rec_id, "u") === 0) ? 0 : (int) substr($rec_id, 1)
                    );
                }
            }

            $this->tpl->setOnScreenMessage('success', $this->lng->txt("mail_sent"), true);
            $this->ctrl->redirect($this, "editRaters");
        }

        $form->setValuesByPost();
        $this->mailRatersObject();
    }

Here is the call graph for this function:

mailRatersObject()

ilSurveyParticipantsGUI::mailRatersObject

(

)

Definition at line 1573 of file class.ilSurveyParticipantsGUI.php.

References $id, ilMailFormCall\CONTEXT_KEY, ILIAS\Repository\ctrl(), ilMailFormCall\getRedirectTarget(), handleRatersAccess(), ILIAS\Repository\lng(), and ilMailFormCall\setRecipients().

Referenced by mailRatersActionObject().

                                      : void
    {
        $appr_id = $this->handleRatersAccess();
        $all_data = $this->object->getRatersData($appr_id);
        $this->ctrl->setParameter($this, "appr_id", $appr_id);

        $raters = $this->edit_request->getRaterIds();

        $rec = [];
        $external_rater = false;
        $rater_id = "";
        foreach ($raters as $id) {
            if (isset($all_data[$id])) {
                if ($all_data[$id]["login"] != "") {
                    $rec[] = $all_data[$id]["login"];
                } elseif ($all_data[$id]["email"] != "") {
                    $rec[] = $all_data[$id]["email"];
                    $external_rater = true;
                    $rater_id = $all_data[$id]["user_id"];
                }
            }
        }
        if ($external_rater && count($rec) > 1) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_only_max_one_external_rater"), true);
            $this->ctrl->redirect($this, "editRaters");
        }

        // $_POST["rtr_id"]
        ilMailFormCall::setRecipients($rec);

        $contextParameters = [
            'ref_id' => $this->object->getRefId(),
            'ts' => time(),
            'appr_id' => $appr_id,
            'rater_id' => $rater_id,
            ilMailFormCall::CONTEXT_KEY => "svy_rater_inv"
        ];

        $this->ctrl->redirectToURL(ilMailFormCall::getRedirectTarget(
            $this,
            'editRaters',
            [
                'recipients' => base64_encode(json_encode($rec, JSON_THROW_ON_ERROR)),
            ],
            [
                'type' => 'new',
                'sig' => rawurlencode(base64_encode("\n\n" . $this->lng->txt("svy_link_to_svy") . ": [SURVEY_LINK]"))
            ],
            $contextParameters
        ));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

mailRatersObjectOld()

ilSurveyParticipantsGUI::mailRatersObjectOld

(

ilPropertyFormGUI

$a_form = null

)

Definition at line 1625 of file class.ilSurveyParticipantsGUI.php.

References $tabs, ILIAS\Repository\ctrl(), handleRatersAccess(), initMailRatersForm(), and ILIAS\Repository\lng().

     : void {
        $ilTabs = $this->tabs;
        $rater_ids = $this->edit_request->getRaterIds();
        if (!$a_form) {
            $appr_id = $this->handleRatersAccess();
            $this->ctrl->setParameter($this, "appr_id", $appr_id);

            if (count($rater_ids) === 0) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
                $this->ctrl->redirect($this, "editRaters");
            }

            $a_form = $this->initMailRatersForm($appr_id, $rater_ids);
        }

        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "editRaters")
        );

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

Here is the call graph for this function:

maintenanceObject()

ilSurveyParticipantsGUI::maintenanceObject

(

)

Participants maintenance.

Definition at line 229 of file class.ilSurveyParticipantsGUI.php.

References $data, $toolbar, ILIAS\Repository\ctrl(), filterSurveyParticipantsByAccess(), handleWriteAccess(), listAppraiseesObject(), ILIAS\Repository\lng(), ilObjSurvey\MODE_SELF_EVAL, ILIAS\Repository\object(), and setParticipantSubTabs().

                                       : void
    {
        $ilToolbar = $this->toolbar;

        if ($this->object->get360Mode()) {
            $this->listAppraiseesObject();
            return;
        }

        //Btn Determine Competence Levels
        if ($this->object->getMode() === ilObjSurvey::MODE_SELF_EVAL) {
            $skmg_set = new ilSkillManagementSettings();
            if ($this->object->getSkillService() && $skmg_set->isActivated()) {
                $ilToolbar->addButton(
                    $this->lng->txt("survey_calc_skills"),
                    $this->ctrl->getLinkTargetByClass("ilsurveyskilldeterminationgui"),
                    ""
                );
            }
        }

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("overview");

        $ilToolbar->addButton(
            $this->lng->txt('svy_remove_all_participants'),
            $this->ctrl->getLinkTarget($this, 'deleteAllUserData')
        );

        $ilToolbar->addSeparator();

        if ($this->object->isAccessibleWithoutCode()) {
            $ilToolbar->addButton(
                $this->lng->txt("svy_invite_participants"),
                $this->ctrl->getLinkTargetByClass('ilRepositorySearchGUI', '')
            );
        }

        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance');

        $total = $this->filterSurveyParticipantsByAccess();
        $data = array();
        foreach ($total as $user_data) {
            $finished = false;
            if ($user_data["finished"]) {
                $finished = $user_data["finished_tstamp"];
            }
            if (isset($user_data["active_id"])) {
                $wt = $this->object->getWorkingtimeForParticipant($user_data["active_id"]);
                $last_access = $this->object->getLastAccess($user_data["active_id"]);
                $active_id = $user_data["active_id"];
            } else {
                $wt = 0;
                $last_access = null;
                $active_id = 0;
            }
            $data[] = array(
                'id' => $active_id,
                'name' => $user_data["sortname"],
                'usr_id' => $user_data["usr_id"] ?? null,
                'login' => $user_data["login"],
                'last_access' => $last_access,
                'workingtime' => $wt,
                'finished' => $finished,
                'invited' => $user_data["invited"] ?? false
            );
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

Here is the call graph for this function:

removeUTF8Bom()

ilSurveyParticipantsGUI::removeUTF8Bom ( string  $a_text )

protected

Definition at line 982 of file class.ilSurveyParticipantsGUI.php.

Referenced by importExternalRecipientsFromFileObject().

                                                    : string
    {
        $bom = pack('H*', 'EFBBBF');
        return preg_replace('/^' . $bom . '/', '', $a_text);
    }

Here is the caller graph for this function:

sendCodesMailObject()

ilSurveyParticipantsGUI::sendCodesMailObject

(

)

Definition at line 858 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $lang, $user, ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), setParticipantSubTabs(), and ilStr\subStr().

                                         : void
    {
        $ilUser = $this->user;

        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");

        $form_gui = new FormMailCodesGUI($this);
        if ($form_gui->checkInput()) {
            $url_exists = strpos($this->edit_request->getCodeMailPart("message"), '[url]') !== false;
            if (!$url_exists) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('please_enter_mail_url'));
                $form_gui->setValuesByPost();
            } else {
                if ($this->edit_request->getSaveMessage() === 1) {
                    $ilUser = $this->user;
                    $title = ($this->edit_request->getSaveMessageTitle())
                        ?: ilStr::subStr($this->edit_request->getCodeMailPart("message"), 0, 40) . '...';
                    $this->object->saveUserSettings($ilUser->getId(), 'savemessage', $title, $this->edit_request->getCodeMailPart("message"));
                }

                $lang = $ilUser->getPref("survey_code_language");
                if (!$lang) {
                    $lang = $this->lng->getDefaultLanguage();
                }
                $this->object->sendCodes(
                    $this->edit_request->getCodeMailPart("notsent"),
                    $this->edit_request->getCodeMailPart("subject"),
                    nl2br($this->edit_request->getCodeMailPart("message")),
                    $lang
                );
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('mail_sent'), true);
                $this->ctrl->redirect($this, 'mailCodes');
            }
        } else {
            $form_gui->setValuesByPost();
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

Here is the call graph for this function:

setCodeLanguageObject()

ilSurveyParticipantsGUI::setCodeLanguageObject

(

)

Change survey language for direct access URL's.

Definition at line 477 of file class.ilSurveyParticipantsGUI.php.

References $ilUser, $user, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

                                           : void
    {
        if (strcmp($this->edit_request->getLang(), "-1") !== 0) {
            $ilUser = $this->user;
            $ilUser->writePref("survey_code_language", $this->edit_request->getLang());
        }
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('language_changed'), true);
        $this->ctrl->redirect($this, 'codes');
    }

Here is the call graph for this function:

setParticipantSubTabs()

ilSurveyParticipantsGUI::setParticipantSubTabs ( string  $active )

protected

Definition at line 318 of file class.ilSurveyParticipantsGUI.php.

References $data, $tabs, ilTabsGUI\addSubTab(), ILIAS\Repository\ctrl(), isAnonymousListActive(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Referenced by codesObject(), deleteSavedMessageObject(), editCodesObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), insertSavedMessageObject(), listParticipantsObject(), mailCodesObject(), maintenanceObject(), and sendCodesMailObject().

     : void {
        $ilTabs = $this->tabs;

        // not used in 360° mode

        // overview
        $ilTabs->addSubTab(
            "overview",
            $this->lng->txt("svy_part_overview"),
            $this->ctrl->getLinkTarget($this, 'maintenance')
        );

        if ($this->isAnonymousListActive()) {
            $ilTabs->addSubTab(
                "anon_participants",
                $this->lng->txt("svy_anonymous_participants_svy"),
                $this->ctrl->getLinkTarget($this, 'listParticipants')
            );
        }

        if (!$this->object->isAccessibleWithoutCode()) {
            $ilTabs->addSubTab(
                "codes",
                $this->lng->txt("svy_codes"),
                $this->ctrl->getLinkTarget($this, 'codes')
            );
        }


        $data = $this->object->getExternalCodeRecipients();
        if (count($data)) {
            $ilTabs->addSubTab(
                "mail_survey_codes",
                $this->lng->txt("mail_survey_codes"),
                $this->ctrl->getLinkTarget($this, "mailCodes")
            );
        }

        $ilTabs->activateSubTab($active);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

storeMailSent()

ilSurveyParticipantsGUI::storeMailSent ( )

protected

Definition at line 1263 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), and handleRatersAccess().

Referenced by editRatersObject().

                                      : void
    {
        $appr_id = $this->handleRatersAccess();
        $all_data = $this->object->getRatersData($appr_id);

        $recs = json_decode(base64_decode($this->edit_request->getRecipients()));
        foreach ($all_data as $rec_id => $rater) {
            $sent = false;
            if (($rater["login"] != "" && in_array($rater["login"], $recs, true)) ||
                ($rater["email"] != "" && in_array($rater["email"], $recs, true))) {
                $sent = true;
            }
            if ($sent) {
                $this->object->set360RaterSent(
                    $appr_id,
                    strpos($rec_id, "a") === 0 ? 0 : (int) substr($rec_id, 1),
                    strpos($rec_id, "u") === 0 ? 0 : (int) substr($rec_id, 1)
                );
            }
        }
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->redirect($this, "editRaters");
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateCodesObject()

ilSurveyParticipantsGUI::updateCodesObject

(

)

Definition at line 577 of file class.ilSurveyParticipantsGUI.php.

References $errors, $id, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        $mails = $this->edit_request->getCodesPar("mail");
        $lnames = $this->edit_request->getCodesPar("lname");
        $fnames = $this->edit_request->getCodesPar("fname");
        $sents = $this->edit_request->getCodesPar("sent");
        if (count($codes) === 0) {
            $this->ctrl->redirect($this, 'codes');
        }

        $errors = array();
        $error_message = "";
        foreach ($codes as $id) {
            if (!$this->object->updateCode(
                $id,
                $mails[$id] ?? "",
                $lnames[$id] ?? "",
                $fnames[$id] ?? "",
                $sents[$id] ?? 0
            )) {
                $errors[] = array($mails[$id], $lnames[$id], $fnames[$id]);
            }
        }
        if (empty($errors)) {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
        } else {
            foreach ($errors as $error) {
                $error_message .= sprintf($this->lng->txt("error_save_code"), $error[0], $error[1], $error[2]);
            }
            $this->tpl->setOnScreenMessage('failure', $error_message, true);
        }

        $this->ctrl->redirect($this, 'codes');
    }

Here is the call graph for this function:

Field Documentation

$access

ilAccessHandler ilSurveyParticipantsGUI::$access

protected

Definition at line 36 of file class.ilSurveyParticipantsGUI.php.

Referenced by addExternalRaterFormObject(), addRater(), editRatersObject(), handleRatersAccess(), importExternalMailRecipientsFromFileFormObject(), and importExternalMailRecipientsFromTextFormObject().

$code_manager

ILIAS Survey Code CodeManager ilSurveyParticipantsGUI::$code_manager

protected

Definition at line 46 of file class.ilSurveyParticipantsGUI.php.

$ctrl

ilCtrl ilSurveyParticipantsGUI::$ctrl

protected

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

Referenced by executeCommand(), inviteUsers(), and listAppraiseesObject().

$data_manager

ILIAS Survey InternalDataService ilSurveyParticipantsGUI::$data_manager

protected

Definition at line 47 of file class.ilSurveyParticipantsGUI.php.

$edit_manager

ILIAS Survey Editing EditManager ilSurveyParticipantsGUI::$edit_manager

protected

Definition at line 30 of file class.ilSurveyParticipantsGUI.php.

$edit_request

ILIAS Survey Editing EditingGUIRequest ilSurveyParticipantsGUI::$edit_request

protected

Definition at line 29 of file class.ilSurveyParticipantsGUI.php.

$feature_config

ILIAS Survey Mode FeatureConfig ilSurveyParticipantsGUI::$feature_config

protected

Definition at line 28 of file class.ilSurveyParticipantsGUI.php.

$has_write

bool ilSurveyParticipantsGUI::$has_write

protected

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

$invitation_manager

Participants InvitationsManager ilSurveyParticipantsGUI::$invitation_manager

protected

Definition at line 44 of file class.ilSurveyParticipantsGUI.php.

$lng

ilLanguage ilSurveyParticipantsGUI::$lng

protected

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

Referenced by executeCommand(), inviteUsers(), and listAppraiseesObject().

$log

ilLogger ilSurveyParticipantsGUI::$log

protected

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

Referenced by deleteSavedMessageObject(), and insertSavedMessageObject().

$object

ilObjSurvey ilSurveyParticipantsGUI::$object

protected

Definition at line 41 of file class.ilSurveyParticipantsGUI.php.

Referenced by getObject().

$parent_gui

ilObjSurveyGUI ilSurveyParticipantsGUI::$parent_gui

protected

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

$rbacsystem

ilRbacSystem ilSurveyParticipantsGUI::$rbacsystem

protected

Definition at line 37 of file class.ilSurveyParticipantsGUI.php.

$ref_id

int ilSurveyParticipantsGUI::$ref_id

protected

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

Referenced by listAppraiseesObject().

$survey_service

ILIAS Survey InternalService ilSurveyParticipantsGUI::$survey_service

protected

Definition at line 45 of file class.ilSurveyParticipantsGUI.php.

$tabs

ilTabsGUI ilSurveyParticipantsGUI::$tabs

protected

Definition at line 34 of file class.ilSurveyParticipantsGUI.php.

Referenced by addExternalRaterFormObject(), confirmAppraiseeCloseObject(), confirmDeleteAppraiseesObject(), confirmDeleteRatersObject(), editRatersObject(), executeCommand(), mailRatersObjectOld(), and setParticipantSubTabs().

$toolbar

ilToolbarGUI ilSurveyParticipantsGUI::$toolbar

protected

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

Referenced by codesObject(), editRatersObject(), listAppraiseesObject(), listParticipantsObject(), and maintenanceObject().

$tpl

ilGlobalTemplateInterface ilSurveyParticipantsGUI::$tpl

protected

Definition at line 33 of file class.ilSurveyParticipantsGUI.php.

Referenced by confirmAdminAppraiseesCloseObject(), and confirmAppraiseeCloseObject().

$user

ilObjUser ilSurveyParticipantsGUI::$user

protected

Definition at line 38 of file class.ilSurveyParticipantsGUI.php.

Referenced by addRater(), addSelfAppraiseeObject(), appraiseeCloseObject(), codesObject(), confirmAppraiseeCloseObject(), handleRatersAccess(), insertSavedMessageObject(), mailRatersActionObject(), sendCodesMailObject(), and setCodeLanguageObject().

---

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

• Modules/Survey/Participants/class.ilSurveyParticipantsGUI.php