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...
	getAccessCodeImportForm ()
	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 ()
	getImportExternalMailRecipientsFromFileForm ()
	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 InternalGUIService	$gui
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 978 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 1195 of file class.ilSurveyParticipantsGUI.php.

References $user_id, 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 963 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 1351 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 1402 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 1430 of file class.ilSurveyParticipantsGUI.php.

References $access, $user, $user_id, 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 1523 of file class.ilSurveyParticipantsGUI.php.

References $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, "run");
    }

Here is the call graph for this function:

adminAppraiseesCloseObject()

ilSurveyParticipantsGUI::adminAppraiseesCloseObject

(

)

Definition at line 1821 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 1781 of file class.ilSurveyParticipantsGUI.php.

References $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, "run");
        }

        $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, "run");
    }

Here is the call graph for this function:

cancelDeleteAllUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteAllUserDataObject

(

)

Cancels delete of all user data in maintenance.

Definition at line 403 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 434 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 492 of file class.ilSurveyParticipantsGUI.php.

References $lang, $toolbar, $user, ILIAS\Repository\ctrl(), handleWriteAccess(), ILIAS\Repository\lng(), null, ILIAS\Repository\object(), ilSelectInputGUI\setOptions(), 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);

        $this->gui->button(
            $this->lng->txt("create"),
            "createSurveyCodes"
        )->submit()->toToolbar();

        $ilToolbar->addSeparator();

        $this->gui->button(
            $this->lng->txt("import_from_file"),
            "importExternalMailRecipientsFromFileForm"
        )->submit()->toToolbar();

        $this->gui->button(
            $this->lng->txt("import_from_text"),
            "importExternalMailRecipientsFromTextForm"
        )->submit()->toToolbar();

        $ilToolbar->addSeparator();

        $this->gui->button(
            $this->lng->txt("svy_import_codes"),
            "importAccessCodes"
        )->submit()->toToolbar();

        $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);

        $this->gui->button(
            $this->lng->txt("set"),
            "setCodeLanguage"
        )->submit()->toToolbar();


        $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 1794 of file class.ilSurveyParticipantsGUI.php.

References $tpl, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), handleWriteAccess(), ILIAS\Repository\lng(), and ILIAS\UICore\GlobalTemplate\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 1776 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl().

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

Here is the call graph for this function:

confirmAppraiseeCloseObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseObject

(

)

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

References $tabs, $tpl, $user, ilTabsGUI\clearTargets(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ILIAS\UICore\GlobalTemplate\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, "run")
        );

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

        $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 380 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 1209 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 1458 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 411 of file class.ilSurveyParticipantsGUI.php.

References 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 793 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 367 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 1250 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 616 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 652 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 1498 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 829 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 443 of file class.ilSurveyParticipantsGUI.php.

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

                                                   : 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 564 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 1314 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 115 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 684 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 669 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), ilUtil\deliverData(), ilFileUtils\getASCIIFilename(), ILIAS\Repository\lng(), null, 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 196 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:

getAccessCodeImportForm()

ilSurveyParticipantsGUI::getAccessCodeImportForm

(

)

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

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

Referenced by importAccessCodesActionObject(), and importAccessCodesObject().

                                             : ilPropertyFormGUI
    {
        $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"));

        return $form_import_file;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getImportExternalMailRecipientsFromFileForm()

ilSurveyParticipantsGUI::getImportExternalMailRecipientsFromFileForm

(

)

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

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

Referenced by importExternalMailRecipientsFromFileFormObject(), and importExternalRecipientsFromFileObject().

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

        $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"));
        }
        return $form_import_file;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObject()

ilSurveyParticipantsGUI::getObject

(

)

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

References $object.

                               : ilObjSurvey
    {
        return $this->object;
    }

handleRatersAccess()

ilSurveyParticipantsGUI::handleRatersAccess

(

)

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

References $access, $user, ILIAS\Repository\ctrl(), null, 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 108 of file class.ilSurveyParticipantsGUI.php.

Referenced by adminAppraiseesCloseObject(), codesObject(), confirmAdminAppraiseesCloseObject(), deleteSavedMessageObject(), deleteSingleUserResultsObject(), editCodesObject(), importAccessCodesActionObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), importExternalRecipientsFromFileObject(), 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 730 of file class.ilSurveyParticipantsGUI.php.

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

                                                      : void
    {
        $form = $this->getAccessCodeImportForm();

        if ($form->checkInput()) {
            $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');
        } else {
            $form->setValuesByPost();
            $this->handleWriteAccess();
            $this->setParticipantSubTabs("codes");
            $this->tpl->setContent($form->getHTML());
        }
    }

Here is the call graph for this function:

importAccessCodesObject()

ilSurveyParticipantsGUI::importAccessCodesObject ( )

protected

Import codes from export codes file (upload form)

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

References getAccessCodeImportForm(), handleWriteAccess(), and setParticipantSubTabs().

                                                : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
        $form_import_file = $this->getAccessCodeImportForm();
        $this->tpl->setContent($form_import_file->getHTML());
    }

Here is the call graph for this function:

importExternalMailRecipientsFromFileFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromFileFormObject

(

)

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

References getImportExternalMailRecipientsFromFileForm(), handleWriteAccess(), and setParticipantSubTabs().

                                                                    : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
        $form = $this->getImportExternalMailRecipientsFromFileForm();
        $this->tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

importExternalMailRecipientsFromTextFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromTextFormObject

(

)

Definition at line 1105 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 1002 of file class.ilSurveyParticipantsGUI.php.

References $data, _convertCharset(), addCodeForExternal(), ILIAS\Repository\ctrl(), getImportExternalMailRecipientsFromFileForm(), handleWriteAccess(), ILIAS\Repository\lng(), removeUTF8Bom(), and setParticipantSubTabs().

                                                            : void
    {
        $this->handleWriteAccess();
        $form = $this->getImportExternalMailRecipientsFromFileForm();

        if (!$form->checkInput()) {
            $this->setParticipantSubTabs("codes");
            $this->tpl->setContent($form->getHTML());
            return;
        }

        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 912 of file class.ilSurveyParticipantsGUI.php.

References $data, 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 1376 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), ILIAS\Repository\lng(), and ilFormPropertyGUI\setRequired().

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 1535 of file class.ilSurveyParticipantsGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilFormPropertyGUI\setRequired(), and ILIAS\UI\examples\Symbol\Glyph\Sort\sort().

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 806 of file class.ilSurveyParticipantsGUI.php.

References Vendor\Package\$e, $log, $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 1867 of file class.ilSurveyParticipantsGUI.php.

References $ctrl, $lng, $user_id, 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 302 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 1150 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 1843 of file class.ilSurveyParticipantsGUI.php.

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

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

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

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

        $this->gui->button(
            $this->lng->txt("print"),
            "#"
        )->onClick("window.print(); return false;")->toToolbar();

        $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 852 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 1677 of file class.ilSurveyParticipantsGUI.php.

References $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 1600 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");
        }

        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 1651 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 231 of file class.ilSurveyParticipantsGUI.php.

References $data, $toolbar, ILIAS\Repository\ctrl(), filterSurveyParticipantsByAccess(), handleWriteAccess(), listAppraiseesObject(), ILIAS\Repository\lng(), ilObjSurvey\MODE_SELF_EVAL, null, 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 996 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 872 of file class.ilSurveyParticipantsGUI.php.

References $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 479 of file class.ilSurveyParticipantsGUI.php.

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

                                           : 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 320 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(), importAccessCodesActionObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), importExternalRecipientsFromFileObject(), 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 1290 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 580 of file class.ilSurveyParticipantsGUI.php.

References $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 37 of file class.ilSurveyParticipantsGUI.php.

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

$code_manager

ILIAS Survey Code CodeManager ilSurveyParticipantsGUI::$code_manager

protected

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

$ctrl

ilCtrl ilSurveyParticipantsGUI::$ctrl

protected

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

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

$data_manager

ILIAS Survey InternalDataService ilSurveyParticipantsGUI::$data_manager

protected

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

$edit_manager

ILIAS Survey Editing EditManager ilSurveyParticipantsGUI::$edit_manager

protected

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

$edit_request

ILIAS Survey Editing EditingGUIRequest ilSurveyParticipantsGUI::$edit_request

protected

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

$feature_config

ILIAS Survey Mode FeatureConfig ilSurveyParticipantsGUI::$feature_config

protected

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

$gui

ILIAS Survey InternalGUIService ilSurveyParticipantsGUI::$gui

protected

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

$has_write

bool ilSurveyParticipantsGUI::$has_write

protected

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

$invitation_manager

Participants InvitationsManager ilSurveyParticipantsGUI::$invitation_manager

protected

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

$lng

ilLanguage ilSurveyParticipantsGUI::$lng

protected

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

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

$log

ilLogger ilSurveyParticipantsGUI::$log

protected

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

Referenced by deleteSavedMessageObject(), and insertSavedMessageObject().

$object

ilObjSurvey ilSurveyParticipantsGUI::$object

protected

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

Referenced by getObject().

$parent_gui

ilObjSurveyGUI ilSurveyParticipantsGUI::$parent_gui

protected

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

$rbacsystem

ilRbacSystem ilSurveyParticipantsGUI::$rbacsystem

protected

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

$ref_id

int ilSurveyParticipantsGUI::$ref_id

protected

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

Referenced by listAppraiseesObject().

$survey_service

ILIAS Survey InternalService ilSurveyParticipantsGUI::$survey_service

protected

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

$tabs

ilTabsGUI ilSurveyParticipantsGUI::$tabs

protected

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

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

$toolbar

ilToolbarGUI ilSurveyParticipantsGUI::$toolbar

protected

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

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

$tpl

ilGlobalTemplateInterface ilSurveyParticipantsGUI::$tpl

protected

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

Referenced by confirmAdminAppraiseesCloseObject(), and confirmAppraiseeCloseObject().

$user

ilObjUser ilSurveyParticipantsGUI::$user

protected

Definition at line 39 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:

• components/ILIAS/Survey/Participants/class.ilSurveyParticipantsGUI.php