Survey evaluation answers. More...

Collaboration diagram for ilSurveyEvaluationResults:

Public Member Functions
	__construct (SurveyQuestion $a_question)

	getQuestion ()

	setUsersAnswered ($a_value)

	getUsersAnswered ()

	setUsersSkipped ($a_value)

	getUsersSkipped ()

	setMode ($a_value, $a_nr_of_selections)

	getModeValue ()

	getModeValueAsText ()

	getModeNrOfSelections ()

	setMean ($a_mean)

	getMean ()

	setMedian ($a_value)

	getMedian ()

	getMedianAsText ()

	addVariable (ilSurveyEvaluationResultsVariable $a_variable)

	getVariables ()

	addAnswer (ilSurveyEvaluationResultsAnswer $a_answer)

	getAnswers ()

	getMappedTextAnswers ()

	getUserResults ($a_active_id)

Protected Member Functions
	getScaleText ($a_value)

	getCatTitle ($a_value)

Protected Attributes
	$lng

	$question

	$users_answered

	$users_skipped

	$mode_value

	$mode_nr_of_selections

	$arithmetic_mean

	$median

	$variables = array()

	$answers = array()

Detailed Description

Survey evaluation answers.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 11 of file class.ilSurveyEvaluationResults.php.

Constructor & Destructor Documentation

◆ __construct()

ilSurveyEvaluationResults::__construct ( SurveyQuestion $a_question )

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

    {
        global $DIC;
 
        $this->lng = $DIC->language();
        $this->question = $a_question;
    }

References $DIC.

Member Function Documentation

◆ addAnswer()

ilSurveyEvaluationResults::addAnswer ( ilSurveyEvaluationResultsAnswer $a_answer )

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

    {
        $this->answers[] = $a_answer;
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ addVariable()

ilSurveyEvaluationResults::addVariable ( ilSurveyEvaluationResultsVariable $a_variable )

Definition at line 139 of file class.ilSurveyEvaluationResults.php.

    {
        $this->variables[] = $a_variable;
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ getAnswers()

ilSurveyEvaluationResults::getAnswers ( )

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

    {
        if (sizeof($this->answers)) {
            return $this->answers;
        }
        return [];
    }

References $answers.

Referenced by getUserResults().

Here is the caller graph for this function:

◆ getCatTitle()

ilSurveyEvaluationResults::getCatTitle ( $a_value )

protected

Definition at line 177 of file class.ilSurveyEvaluationResults.php.

    {
        if (!sizeof($this->variables)) {
            return $a_value;
        } else {
            foreach ($this->variables as $var) {
                if ($var->cat->scale == $a_value) {
                    return $var->cat->title;
                }
            }
        }
    }

◆ getMappedTextAnswers()

ilSurveyEvaluationResults::getMappedTextAnswers ( )

Definition at line 190 of file class.ilSurveyEvaluationResults.php.

    {
        $res = array();
        
        foreach ($this->answers as $answer) {
            if ($answer->text) {
                $res[$this->getScaleText($answer->value)][] = $answer->text;
            }
        }
        
        return $res;
    }

References $res, and getScaleText().

Here is the call graph for this function:

◆ getMean()

ilSurveyEvaluationResults::getMean ( )

Definition at line 104 of file class.ilSurveyEvaluationResults.php.

    {
        return $this->arithmetic_mean;
    }

References $arithmetic_mean.

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the caller graph for this function:

◆ getMedian()

ilSurveyEvaluationResults::getMedian ( )

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

    {
        return $this->median;
    }

References $median.

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the caller graph for this function:

◆ getMedianAsText()

ilSurveyEvaluationResults::getMedianAsText ( )

Definition at line 121 of file class.ilSurveyEvaluationResults.php.

    {
        $lng = $this->lng;
        
        if ($this->median === null) {
            return;
        }
        
        if (!is_array($this->median)) {
            return $this->getScaleText($this->median);
        } else {
            return $lng->txt("median_between") . " " .
                $this->getScaleText($this->median[0]) . " " .
                $lng->txt("and") . " " .
                $this->getScaleText($this->median[1]);
        }
    }

References $lng, and getScaleText().

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getModeNrOfSelections()

ilSurveyEvaluationResults::getModeNrOfSelections ( )

Definition at line 94 of file class.ilSurveyEvaluationResults.php.

    {
        return $this->mode_nr_of_selections;
    }

References $mode_nr_of_selections.

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the caller graph for this function:

◆ getModeValue()

ilSurveyEvaluationResults::getModeValue ( )

Definition at line 69 of file class.ilSurveyEvaluationResults.php.

    {
        return $this->mode_value;
    }

References $mode_value.

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the caller graph for this function:

◆ getModeValueAsText()

ilSurveyEvaluationResults::getModeValueAsText ( )

Definition at line 74 of file class.ilSurveyEvaluationResults.php.

    {
        if ($this->mode_value === null) {
            return;
        }
        
        $res = array();
        
        $mvalues = $this->mode_value;
        if (!is_array($mvalues)) {
            $mvalues = array($mvalues);
        }
        sort($mvalues, SORT_NUMERIC);
        foreach ($mvalues as $value) {
            $res[] = $this->getScaleText($value);
        }
        
        return implode(", ", $res);
    }

References $mode_value, $res, and getScaleText().

Referenced by ilSurveyEvaluationGUI\parseResultsToExcel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestion()

ilSurveyEvaluationResults::getQuestion ( )

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

    {
        return $this->question;
    }

References $question.

◆ getScaleText()

ilSurveyEvaluationResults::getScaleText ( $a_value )

protected

Definition at line 164 of file class.ilSurveyEvaluationResults.php.

    {
        if (!sizeof($this->variables)) {
            return $a_value;
        } else {
            foreach ($this->variables as $var) {
                if ($var->cat->scale == $a_value) {
                    return $var->cat->title . " [" . $a_value . "]";
                }
            }
        }
    }

Referenced by getMappedTextAnswers(), getMedianAsText(), getModeValueAsText(), and getUserResults().

Here is the caller graph for this function:

◆ getUserResults()

ilSurveyEvaluationResults::getUserResults ( $a_active_id )

Definition at line 203 of file class.ilSurveyEvaluationResults.php.

    {
        $res = array();
    
        $answers = $this->getAnswers();
        if ($answers) {
            foreach ($answers as $answer) {
                if ($answer->active_id == $a_active_id) {
                    $res[] = array(
                        $this->getScaleText($answer->value),
                        $answer->text,
                        $answer->value,
                        $this->getCatTitle($answer->value)
                    );
                }
            }
        }
        
        return $res;
    }

References $answers, $res, getAnswers(), and getScaleText().

Here is the call graph for this function:

◆ getUsersAnswered()

ilSurveyEvaluationResults::getUsersAnswered ( )

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

    {
        return $this->users_answered;
    }

References $users_answered.

◆ getUsersSkipped()

ilSurveyEvaluationResults::getUsersSkipped ( )

Definition at line 56 of file class.ilSurveyEvaluationResults.php.

    {
        return $this->users_skipped;
    }

References $users_skipped.

◆ getVariables()

ilSurveyEvaluationResults::getVariables ( )

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

    {
        if (sizeof($this->variables)) {
            return $this->variables;
        }
    }

References $variables.

◆ setMean()

ilSurveyEvaluationResults::setMean ( $a_mean )

Definition at line 99 of file class.ilSurveyEvaluationResults.php.

    {
        $this->arithmetic_mean = (float) $a_mean;
    }

Referenced by SurveyMetricQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ setMedian()

ilSurveyEvaluationResults::setMedian ( $a_value )

Definition at line 109 of file class.ilSurveyEvaluationResults.php.

    {
        $this->median = is_array($a_value)
            ? $a_value
            : trim($a_value);
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ setMode()

ilSurveyEvaluationResults::setMode	(	$a_value,
		$a_nr_of_selections
	)

Definition at line 61 of file class.ilSurveyEvaluationResults.php.

    {
        $this->mode_value = is_array($a_value)
            ? $a_value
            : trim($a_value);
        $this->mode_nr_of_selections = (int) $a_nr_of_selections;
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ setUsersAnswered()

ilSurveyEvaluationResults::setUsersAnswered ( $a_value )

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

    {
        $this->users_answered = (int) $a_value;
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

◆ setUsersSkipped()

ilSurveyEvaluationResults::setUsersSkipped ( $a_value )

Definition at line 51 of file class.ilSurveyEvaluationResults.php.

    {
        $this->users_skipped = (int) $a_value;
    }

Referenced by SurveyQuestionEvaluation\parseResults().

Here is the caller graph for this function:

Field Documentation

◆ $answers

ilSurveyEvaluationResults::$answers = array()

protected

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

Referenced by getAnswers(), and getUserResults().

◆ $arithmetic_mean

ilSurveyEvaluationResults::$arithmetic_mean

protected

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

Referenced by getMean().

◆ $lng

ilSurveyEvaluationResults::$lng

protected

Definition at line 16 of file class.ilSurveyEvaluationResults.php.

Referenced by getMedianAsText().

◆ $median

ilSurveyEvaluationResults::$median

protected

Definition at line 24 of file class.ilSurveyEvaluationResults.php.

Referenced by getMedian().

◆ $mode_nr_of_selections

ilSurveyEvaluationResults::$mode_nr_of_selections

protected

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

Referenced by getModeNrOfSelections().

◆ $mode_value

ilSurveyEvaluationResults::$mode_value

protected

Definition at line 21 of file class.ilSurveyEvaluationResults.php.

Referenced by getModeValue(), and getModeValueAsText().

◆ $question

ilSurveyEvaluationResults::$question

protected

Definition at line 18 of file class.ilSurveyEvaluationResults.php.

Referenced by getQuestion().

◆ $users_answered

ilSurveyEvaluationResults::$users_answered

protected

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

Referenced by getUsersAnswered().

◆ $users_skipped

ilSurveyEvaluationResults::$users_skipped

protected

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

Referenced by getUsersSkipped().

◆ $variables

ilSurveyEvaluationResults::$variables = array()

protected

Definition at line 25 of file class.ilSurveyEvaluationResults.php.

Referenced by getVariables().

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

Modules/Survey/Evaluation/class.ilSurveyEvaluationResults.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAnswer()

◆ addVariable()

◆ getAnswers()

◆ getCatTitle()

◆ getMappedTextAnswers()

◆ getMean()

◆ getMedian()

◆ getMedianAsText()

◆ getModeNrOfSelections()

◆ getModeValue()

◆ getModeValueAsText()

◆ getQuestion()

◆ getScaleText()

◆ getUserResults()

◆ getUsersAnswered()

◆ getUsersSkipped()

◆ getVariables()

◆ setMean()

◆ setMedian()

◆ setMode()

◆ setUsersAnswered()

◆ setUsersSkipped()

Field Documentation

◆ $answers

◆ $arithmetic_mean

◆ $lng

◆ $median

◆ $mode_nr_of_selections

◆ $mode_value

◆ $question

◆ $users_answered

◆ $users_skipped

◆ $variables