SurveyQuestion Class Reference

Basic class for all survey question types. More...

Inheritance diagram for SurveyQuestion:

Collaboration diagram for SurveyQuestion:

Public Member Functions
	SurveyQuestion ( $title="", $description="", $author="", $questiontext="", $owner=-1)
	SurveyQuestion constructor The constructor takes possible arguments an creates an instance of the SurveyQuestion object. More...
	_SurveyQuestion ()
	setComplete ($a_complete)
	Sets the complete state of the question. More...
	isComplete ()
	Returns 1, if a question is complete for use. More...
	questionTitleExists ($title, $questionpool_object="")
	Returns TRUE if the question title exists in the database. More...
	setTitle ($title="")
	Sets the title string of the SurveyQuestion object. More...
	setObligatory ($obligatory=1)
	Sets the obligatory state of the question. More...
	setOrientation ($orientation=0)
	Sets the orientation of the question output. More...
	setId ($id=-1)
	Sets the id of the SurveyQuestion object. More...
	setSurveyId ($id=-1)
	Sets the survey id of the SurveyQuestion object. More...
	setDescription ($description="")
	Sets the description string of the SurveyQuestion object. More...
	addMaterials ($materials_file, $materials_name="")
	Sets the materials uri. More...
	setMaterialsfile ($materials_filename, $materials_tempfilename="", $materials_name="")
	Sets and uploads the materials uri. More...
	deleteMaterial ($materials_name="")
	Deletes a materials uri with a given name. More...
	flushMaterials ()
	Deletes all materials uris. More...
	setAuthor ($author="")
	Sets the authors name of the SurveyQuestion object. More...
	setQuestiontext ($questiontext="")
	Sets the questiontext of the SurveyQuestion object. More...
	setOwner ($owner="")
	Sets the creator/owner ID of the SurveyQuestion object. More...
	getTitle ()
	Gets the title string of the SurveyQuestion object. More...
	getLabel ()
	getId ()
	Gets the id of the SurveyQuestion object. More...
	getObligatory ($survey_id="")
	Gets the obligatory state of the question. More...
	getSurveyId ()
	Gets the survey id of the SurveyQuestion object. More...
	getOrientation ()
	Gets the orientation of the question output. More...
	getDescription ()
	Gets the description string of the SurveyQuestion object. More...
	getAuthor ()
	Gets the authors name of the SurveyQuestion object. More...
	getOwner ()
	Gets the creator/owner ID of the SurveyQuestion object. More...
	getQuestiontext ()
	Gets the questiontext of the SurveyQuestion object. More...
	getObjId ()
	Get the reference id of the container object. More...
	setObjId ($obj_id=0)
	Set the reference id of the container object. More...
	duplicate ($for_survey=true, $title="", $author="", $owner="")
	Duplicates a survey question. More...
	copyObject ($target_questionpool, $title="")
	Copies an assOrderingQuestion object. More...
	copyXHTMLMediaObjectsOfQuestion ($a_q_id)
	Increases the media object usage counter when a question is duplicated. More...
	loadFromDb ($question_id)
	Loads a SurveyQuestion object from the database. More...
	_isComplete ($question_id)
	Checks whether the question is complete or not. More...
	saveCompletionStatus ($original_id="")
	Saves the complete flag to the database. More...
	saveToDb ($original_id="")
	Saves a SurveyQuestion object to a database. More...
	saveMaterial ()
	save material to db More...
	createNewQuestion ()
	Creates a new question with a 0 timestamp when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...
	saveWorkingData ($limit_to=LIMIT_NO_LIMIT)
	Saves the learners input of the question to the database. More...
	getImagePath ()
	Returns the image path for web accessable images of a question. More...
	getMaterialsPath ()
	Returns the materials path for web accessable materials of a question. More...
	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...
	getMaterialsPathWeb ()
	Returns the web image path for web accessable images of a question. More...
	saveCategoryToDb ($categorytext, $neutral=0)
	Saves a category to the database. More...
	deleteAdditionalTableData ($question_id)
	Deletes datasets from the additional question table in the database. More...
	delete ($question_id)
	Deletes a question and all materials from the database. More...
	_getQuestionType ($question_id)
	Returns the question type of a question with a given id. More...
	_getTitle ($question_id)
	Returns the question title of a question with a given id. More...
	_getOriginalId ($question_id, $a_return_question_id_if_no_original=true)
	Returns the original id of a question. More...
	syncWithOriginal ()
	getPhrase ($phrase_id)
	Returns a phrase for a given database id. More...
	phraseExists ($title)
	Returns true if the phrase title already exists for the current user. More...
	_questionExists ($question_id)
	Returns true if the question already exists in the database. More...
	addInternalLink ($material_id, $title="")
	deleteMaterials ($a_array)
	Deletes materials. More...
	duplicateMaterials ($question_id)
	Duplicates the materials of a question. More...
	addMaterial ($obj_material)
	setMaterial ($material_id="", $is_import=false, $material_title="")
	Sets a material link for the question. More...
	_resolveInternalLink ($internal_link)
	_resolveIntLinks ($question_id)
	_getInternalLinkHref ($target="", $a_parent_ref_id=null)
	_isWriteable ($question_id, $user_id)
	Returns true if the question is writeable by a certain user. More...
	getQuestionTypeID ()
	Returns the question type ID of the question. More...
	getQuestionType ()
	Returns the question type of the question. More...
&	_instanciateQuestion ($question_id)
	Creates an instance of a question with a given question id. More...
&	_instanciateQuestionGUI ($question_id)
	Creates an instance of a question GUI with a given question id. More...
	isHTML ($a_text)
	Checks if a given string contains HTML or not. More...
	QTIMaterialToString ($a_material)
	Reads an QTI material tag an creates a text string. More...
	addMaterialTag (&$a_xml_writer, $a_material, $close_material_tag=TRUE, $add_mobs=TRUE, $a_attrs=null)
	Creates an XML material tag from a plain text or xhtml text. More...
	prepareTextareaOutput ($txt_output, $prepare_for_latex_output=FALSE)
	Prepares a string for a text area output in surveys. More...
	_getQuestionDataArray ($id)
	Returns the question data fields from the database. More...
	addUserSpecificResultsExportTitles (&$a_array, $a_use_label=false, $a_substitute=true)
	Adds the entries for the title row of the user specific results. More...
	addUserSpecificResultsData (&$a_array, &$resultset)
	Adds the values for the user specific results export for a given user. More...
&	getUserAnswers ($survey_id)
	Returns an array containing all answers to this question in a given survey. More...
&	getWorkingDataFromUserInput ($post_data)
	Creates the user data of the svy_answer table from the POST data. More...
	importAdditionalMetadata ($a_meta)
	Import additional meta data from the question import file. More...
	importResponses ($a_data)
	Import response data from the question import file. More...
	importAdjectives ($a_data)
	Import bipolar adjectives from the question import file. More...
	importMatrix ($a_data)
	Import matrix rows from the question import file. More...
	setExportCumulatedXLS (&$worksheet, &$format_title, &$format_bold, &$eval_data, $row, $export_label)
	Creates the Excel output for the cumulated results of this question. More...
&	setExportCumulatedCVS (&$eval_data, $export_label)
	Creates the CSV output for the cumulated results of this question. More...
	setExportDetailsXLS (&$workbook, &$format_title, &$format_bold, &$eval_data, $export_label)
	Creates an Excel worksheet for the detailed cumulated results of this question. More...
	usableForPrecondition ()
	Returns if the question is usable for preconditions. More...
	getAvailableRelations ()
	Returns the available relations for the question. More...
	getPreconditionOptions ()
	Returns the options for preconditions. More...
	getPreconditionValueOutput ($value)
	Returns the output for a precondition value. More...
	getPreconditionSelectValue ($default="", $title, $variable)
	Creates a form property for the precondition value. More...
	outChart ($survey_id, $type="")
	Creates an image visualising the results of the question. More...
	setOriginalId ($original_id)
	getOriginalId ()
	saveRandomData ($active_id)
	Saves random answers for a given active user in the database. More...
	getMaterial ()
	setSubtype ($a_subtype)
	getSubtype ()
	getCumulatedResultData ($survey_id, $counter, $finished_ids)
	Creates a the cumulated results data for the question. More...
	__get ($value)
	Object getter. More...
	__set ($key, $value)
	Object setter. More...
	getCopyIds ($a_group_by_survey=false)
	hasCopies ()
	getSkippedValue ()

Static Public Member Functions
static	_includeClass ($question_type, $gui=0)
	Include the php class file for a given question type. More...
static	_getQuestionTypeName ($type_tag)
	Return the translation for a given question type tag. More...
static	_changeOriginalId ($a_question_id, $a_original_id, $a_object_id)
	Change original id of existing question in db. More...
static	_lookupSurveyObjId ($a_question_id)
static	lookupObjFi ($a_qid)
	Lookip obj fi. More...

Data Fields
	$id
	$title
	$description
	$owner
	$author
	$materials
	$survey_id
	$obj_id
	$questiontext
	$obligatory
	$ilias
	$tpl
	$lng
	$orientation
	$material
	$complete

Protected Member Functions
&	calculateCumulatedResults ($survey_id, $finished_ids)

Protected Attributes
	$cumulated
	An array containing the cumulated results of the question for a given survey. More...

Private Attributes
	$arrData
	data array containing the question data More...

Detailed Description

Basic class for all survey question types.

The SurveyQuestion class defines and encapsulates basic methods and attributes for survey question types to be used for all parent classes.

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

Version

$Id$

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

Member Function Documentation

__get()

SurveyQuestion::__get

(

$value

)

Object getter.

Definition at line 2345 of file class.SurveyQuestion.php.

        {
                switch ($value)
                {
                        default:
                                if (array_key_exists($value, $this->arrData))
                                {
                                        return $this->arrData[$value];
                                }
                                else
                                {
                                        return null;
                                }
                                break;
                }
        }

__set()

SurveyQuestion::__set	(		$key,
			$value
	)

Object setter.

Definition at line 2365 of file class.SurveyQuestion.php.

        {
                switch ($key)
                {
                        default:
                                $this->arrData[$key] = $value;
                                break;
                }
        }

_changeOriginalId()

static SurveyQuestion::_changeOriginalId (   $a_question_id,   $a_original_id,   $a_object_id  )

static

Change original id of existing question in db.

Parameters

int	$a_question_id
int	$a_original_id
int	$a_object_id

Definition at line 2382 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                $ilDB->manipulate("UPDATE svy_question".
                        " SET original_id = ".$ilDB->quote($a_original_id, "integer").",".
                        " obj_fi = ".$ilDB->quote($a_object_id, "integer").
                        " WHERE question_id = ".$ilDB->quote($a_question_id, "integer"));
        }

References $ilDB.

Referenced by ilSurveyEditorGUI\executeCopyQuestionsToPoolObject().

Here is the caller graph for this function:

_getInternalLinkHref()

SurveyQuestion::_getInternalLinkHref	(		$target = "",
			$a_parent_ref_id = null
	)

Definition at line 1639 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                $linktypes = array(
                        "lm" => "LearningModule",
                        "pg" => "PageObject",
                        "st" => "StructureObject",
                        "git" => "GlossaryItem",
                        "mob" => "MediaObject"
                );
                $href = "";
                if (preg_match("/il__(\w+)_(\d+)/", $target, $matches))
                {
                        $type = $matches[1];
                        $target_id = $matches[2];
                        include_once "./Services/Utilities/classes/class.ilUtil.php";
                        switch($linktypes[$matches[1]])
                        {
                                case "LearningModule":
                                        $href = ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH) ."/goto.php?target=" . $type . "_" . $target_id;
                                        break;
                                case "PageObject":
                                case "StructureObject":
                                        $href = ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH) ."/goto.php?target=" . $type . "_" . $target_id;
                                        break;
                                case "GlossaryItem":
                                        $href = ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH) ."/goto.php?target=" . $type . "_" . $target_id;
                                        break;
                                case "MediaObject":
                                        $href = ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH) . "/ilias.php?baseClass=ilLMPresentationGUI&obj_type=" . $linktypes[$type] . "&cmd=media&ref_id=".$a_parent_ref_id."&mob_id=".$target_id;
                                        break;
                        }
                }
                return $href;
        }

References $ilDB, $target_id, and ilUtil\removeTrailingPathSeparators().

Referenced by SurveyQuestionGUI\getMaterialOutput(), and SurveyQuestionGUI\material().

Here is the call graph for this function:

Here is the caller graph for this function:

_getOriginalId()

SurveyQuestion::_getOriginalId	(		$question_id,
			$a_return_question_id_if_no_original = true
	)

Returns the original id of a question.

Parameters

integer

$question_id

The database id of the question

Returns

integer The database id of the original question @access public

Definition at line 1255 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                $result = $ilDB->queryF("SELECT * FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows() > 0)
                {
                        $row = $ilDB->fetchAssoc($result);
                        if ($row["original_id"] > 0)
                        {
                                return $row["original_id"];
                        }
                        else if((bool)$a_return_question_id_if_no_original) // #12419
                        {
                                return $row["question_id"];
                        }
                }
                else
                {
                        return "";
                }
        }

References $ilDB, $result, and $row.

Referenced by ilObjSurvey\cloneObject(), and copyObject().

Here is the caller graph for this function:

_getQuestionDataArray()

SurveyQuestion::_getQuestionDataArray

(

$id

)

Returns the question data fields from the database.

Parameters

integer

$id

The question ID from the database

Returns

array Array containing the question fields and data from the database @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 1960 of file class.SurveyQuestion.php.

        {
                return array();
        }

_getQuestionType()

SurveyQuestion::_getQuestionType

(

$question_id

)

Returns the question type of a question with a given id.

Parameters

integer

$question_id

The database id of the question

Returns

string The question type string @access private

Definition at line 1199 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                if ($question_id < 1) return "";
 
                $result = $ilDB->queryF("SELECT type_tag FROM svy_question, svy_qtype WHERE svy_question.question_id = %s AND svy_question.questiontype_fi = svy_qtype.questiontype_id",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows() == 1) 
                {
                        $data = $ilDB->fetchAssoc($result);
                        return $data["type_tag"];
                } 
                else 
                {
                        return "";
                }
        }

References $data, $ilDB, and $result.

Referenced by ilObjSurvey\_instanciateQuestion(), _instanciateQuestion(), _instanciateQuestionGUI(), ilObjSurveyGUI\addLocatorItems(), ilObjSurveyQuestionPoolGUI\addLocatorItems(), ilSurveyConstraintsGUI\confirmDeleteConstraintsObject(), ilObjSurvey\getConstraints(), and ilObjSurvey\getUserSpecificResults().

Here is the caller graph for this function:

_getQuestionTypeName()

static SurveyQuestion::_getQuestionTypeName (   $type_tag )

static

Return the translation for a given question type tag.

Parameters

string

$type_tag

The type tag of the question type @access public

Definition at line 1783 of file class.SurveyQuestion.php.

        {
                if (file_exists("./Modules/SurveyQuestionPool/classes/class.".$type_tag.".php"))
                {
                        global $lng;
                        return $lng->txt($type_tag);
                }
                else
                {
                        global $ilPluginAdmin;
                        $pl_names = $ilPluginAdmin->getActivePluginsForSlot(IL_COMP_MODULE, "SurveyQuestionPool", "svyq");
                        foreach ($pl_names as $pl_name)
                        {
                                $pl = ilPlugin::getPluginObject(IL_COMP_MODULE, "SurveyQuestionPool", "svyq", $pl_name);
                                if (strcmp($pl->getQuestionType(), $type_tag) == 0)
                                {
                                        return $pl->getQuestionTypeTranslation();
                                }
                        }
                }
                return "";
        }

References $lng, ilPlugin\getPluginObject(), and IL_COMP_MODULE.

Referenced by ilSurveyConstraintsGUI\constraintForm(), ilObjSurveyQuestionPoolGUI\deleteQuestionsObject(), ilSurveyQuestionsTableGUI\fillRow(), and ilSurveyEditorGUI\removeQuestionsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

_getTitle()

SurveyQuestion::_getTitle

(

$question_id

)

Returns the question title of a question with a given id.

Parameters

integer

$question_id

The database id of the question

Returns

string The question title @access private

Definition at line 1227 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                if ($question_id < 1) return "";
 
                $result = $ilDB->queryF("SELECT title FROM svy_question WHERE svy_question.question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows() == 1) 
                {
                        $data = $ilDB->fetchAssoc($result);
                        return $data["title"];
                } 
                else 
                {
                        return "";
                }
        }

References $data, $ilDB, and $result.

Referenced by ilObjSurveyGUI\addLocatorItems(), ilObjSurveyQuestionPoolGUI\addLocatorItems(), ilTermUsagesTableGUI\fillRow(), and ilSurveySyncTableGUI\importData().

Here is the caller graph for this function:

_includeClass()

static SurveyQuestion::_includeClass (   $question_type,   $gui = 0  )

static

Include the php class file for a given question type.

Parameters

string

$question_type

The type tag of the question type

Returns

integer 0 if the class should be included, 1 if the GUI class should be included @access public

Definition at line 1751 of file class.SurveyQuestion.php.

        {
                $type = $question_type;
                if ($gui) $type .= "GUI";
                if (file_exists("./Modules/SurveyQuestionPool/classes/class.".$type.".php"))
                {
                        include_once "./Modules/SurveyQuestionPool/classes/class.".$type.".php";
                        return true;
                }
                else
                {
                        global $ilPluginAdmin;
                        $pl_names = $ilPluginAdmin->getActivePluginsForSlot(IL_COMP_MODULE, "SurveyQuestionPool", "svyq");
                        foreach ($pl_names as $pl_name)
                        {
                                $pl = ilPlugin::getPluginObject(IL_COMP_MODULE, "SurveyQuestionPool", "svyq", $pl_name);
                                if (strcmp($pl->getQuestionType(), $question_type) == 0)
                                {
                                        $pl->includeClass("class.".$type.".php");
                                        return true;
                                }
                        }
                }
                return false;
        }

References ilPlugin\getPluginObject(), and IL_COMP_MODULE.

Referenced by SurveyQuestionGUI\_getQuestionGUI(), ilObjSurvey\_instanciateQuestion(), _instanciateQuestion(), _instanciateQuestionGUI(), ilSurveyConstraintsGUI\confirmDeleteConstraintsObject(), ilSurveyConstraintsGUI\constraintForm(), ilObjSurvey\getConstraints(), ilObjSurvey\getUserSpecificResults(), SurveyImportParser\handlerBeginTag(), and ilObjSurveyQuestionPool\toXML().

Here is the call graph for this function:

Here is the caller graph for this function:

_instanciateQuestion()

& SurveyQuestion::_instanciateQuestion

(

$question_id

)

Creates an instance of a question with a given question id.

Parameters

integer

$question_id

The question id

Returns

object The question instance @access public

Definition at line 1814 of file class.SurveyQuestion.php.

        {
                $question_type = SurveyQuestion::_getQuestionType($question_id);
                if($question_type)
                {
                        SurveyQuestion::_includeClass($question_type);
                        $question = new $question_type();
                        $question->loadFromDb($question_id);
                        return $question;
                }
        }

References _getQuestionType(), and _includeClass().

Referenced by ilSurveySkill\determineMaxScale(), ilObjSurveyQuestionPool\duplicateQuestion(), ilSurveyEvaluationGUI\exportCumulatedResults(), ilSurveyEvaluationGUI\exportUserSpecificResults(), ilObjSurvey\fillSurveyForUser(), ilObjSurvey\getDetailedParticipantResultsAsText(), ilObjMediaObject\getParentObjectIdForUsage(), ilObjSurvey\importObject(), ilObjSurveyQuestionPool\removeQuestion(), and ilSurveyExecutionGUI\saveActiveQuestionData().

Here is the call graph for this function:

Here is the caller graph for this function:

_instanciateQuestionGUI()

& SurveyQuestion::_instanciateQuestionGUI

(

$question_id

)

Creates an instance of a question GUI with a given question id.

Parameters

integer

$question_id

The question id

Returns

object The question GUI instance @access public

Definition at line 1833 of file class.SurveyQuestion.php.

        {
                $question_type = SurveyQuestion::_getQuestionType($question_id);
                if($question_type)
                {
                        SurveyQuestion::_includeClass($question_type, 1);
                        $guitype = $question_type . "GUI";
                        $question = new $guitype($question_id);
                        return $question;
                }
        }

References _getQuestionType(), and _includeClass().

Referenced by ilSurveyEvaluationGUI\evaluation().

Here is the call graph for this function:

Here is the caller graph for this function:

_isComplete()

SurveyQuestion::_isComplete

(

$question_id

)

Checks whether the question is complete or not.

Returns

boolean TRUE if the question is complete, FALSE otherwise @access public

Definition at line 741 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                $result = $ilDB->queryF("SELECT complete FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows())
                {
                        $row = $ilDB->fetchAssoc($result);
                        if ($row["complete"] == 1)
                        {
                                return TRUE;
                        }
                }
                return FALSE;
        }

References $ilDB, $result, and $row.

Referenced by ilSurveyPageGUI\insertNewQuestion(), ilObjSurvey\insertQuestion(), and SurveyQuestionGUI\save().

Here is the caller graph for this function:

_isWriteable()

SurveyQuestion::_isWriteable	(		$question_id,
			$user_id
	)

Returns true if the question is writeable by a certain user.

Parameters

integer	$question_id	The database id of the question
integer	$user_id	The database id of the user

Returns

boolean True, if the question exists, otherwise False @access public

Definition at line 1683 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                if (($question_id < 1) || ($user_id < 1))
                {
                        return false;
                }
                
                $result = $ilDB->queryF("SELECT obj_fi FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows() == 1)
                {
                        $row = $ilDB->fetchAssoc($result);
                        $qpl_object_id = $row["obj_fi"];
                        include_once "./Modules/SurveyQuestionPool/classes/class.ilObjSurveyQuestionPool.php";
                        return ilObjSurveyQuestionPool::_isWriteable($qpl_object_id, $user_id);
                }
                else
                {
                        return false;
                }
        }

References $ilDB, $result, $row, and ilObjSurveyQuestionPool\_isWriteable().

Referenced by SurveyQuestionGUI\save().

Here is the call graph for this function:

Here is the caller graph for this function:

_lookupSurveyObjId()

static SurveyQuestion::_lookupSurveyObjId (   $a_question_id )

static

Definition at line 2427 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT svy_svy.obj_fi FROM svy_svy_qst".
                        " JOIN svy_svy ON (svy_svy.survey_id = svy_svy_qst.survey_fi)".
                        " WHERE svy_svy_qst.question_fi = ".$ilDB->quote($a_question_id, "integer"));
                $row = $ilDB->fetchAssoc($set);
                if($ilDB->numRows($set))
                {
                        return $row["obj_fi"];
                }
        }

References $ilDB, and $row.

Referenced by ilObjMediaObject\getParentObjectIdForUsage().

Here is the caller graph for this function:

_questionExists()

SurveyQuestion::_questionExists

(

$question_id

)

Returns true if the question already exists in the database.

Parameters

integer

$question_id

The database id of the question

Returns

boolean True, if the question exists, otherwise False @access public

Definition at line 1363 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                if ($question_id < 1)
                {
                        return false;
                }
                
                $result = $ilDB->queryF("SELECT question_id FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                return ($result->numRows() == 1) ? true : false;
        }

References $ilDB, and $result.

Referenced by ilSurveySkill\read().

Here is the caller graph for this function:

_resolveInternalLink()

SurveyQuestion::_resolveInternalLink

(

$internal_link

)

Definition at line 1551 of file class.SurveyQuestion.php.

        {
                if (preg_match("/il_(\d+)_(\w+)_(\d+)/", $internal_link, $matches))
                {
                        include_once "./Services/Link/classes/class.ilInternalLink.php";
                        include_once "./Modules/LearningModule/classes/class.ilLMObject.php";
                        include_once "./Modules/Glossary/classes/class.ilGlossaryTerm.php";
                        switch ($matches[2])
                        {
                                case "lm":
                                        $resolved_link = ilLMObject::_getIdForImportId($internal_link);
                                        break;
                                case "pg":
                                        $resolved_link = ilInternalLink::_getIdForImportId("PageObject", $internal_link);
                                        break;
                                case "st":
                                        $resolved_link = ilInternalLink::_getIdForImportId("StructureObject", $internal_link);
                                        break;
                                case "git":
                                        $resolved_link = ilInternalLink::_getIdForImportId("GlossaryItem", $internal_link);
                                        break;
                                case "mob":
                                        $resolved_link = ilInternalLink::_getIdForImportId("MediaObject", $internal_link);
                                        break;
                        }
                        if (strcmp($resolved_link, "") == 0)
                        {
                                $resolved_link = $internal_link;
                        }
                }
                else
                {
                        $resolved_link = $internal_link;
                }
                return $resolved_link;
        }

References ilLMObject\_getIdForImportId(), and ilInternalLink\_getIdForImportId().

Referenced by _resolveIntLinks(), and setMaterial().

Here is the call graph for this function:

Here is the caller graph for this function:

_resolveIntLinks()

SurveyQuestion::_resolveIntLinks

(

$question_id

)

Definition at line 1588 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                $resolvedlinks = 0;
                $result = $ilDB->queryF("SELECT * FROM svy_material WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows())
                {
                        while ($row = $ilDB->fetchAssoc($result))
                        {
                                $internal_link = $row["internal_link"];
                                include_once "./Modules/SurveyQuestionPool/classes/class.SurveyQuestion.php";
                                $resolved_link = SurveyQuestion::_resolveInternalLink($internal_link);
                                if (strcmp($internal_link, $resolved_link) != 0)
                                {
                                        // internal link was resolved successfully
                                        $affectedRows = $ilDB->manipulateF("UPDATE svy_material SET internal_link = %s, tstamp = %s WHERE material_id = %s",
                                                array('text', 'integer', 'integer'),
                                                array($resolved_link, time(), $row["material_id"])
                                        );
                                        $resolvedlinks++;
                                }
                        }
                }
                if ($resolvedlinks)
                {
                        // there are resolved links -> reenter theses links to the database
 
                        // delete all internal links from the database
                        include_once "./Services/Link/classes/class.ilInternalLink.php";
                        ilInternalLink::_deleteAllLinksOfSource("sqst", $question_id);
 
                        $result = $ilDB->queryF("SELECT * FROM svy_material WHERE question_fi = %s",
                                array('integer'),
                                array($question_id)
                        );
                        if ($result->numRows())
                        {
                                while ($row = $ilDB->fetchAssoc($result))
                                {
                                        if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $row["internal_link"], $matches))
                                        {
                                                ilInternalLink::_saveLink("sqst", $question_id, $matches[2], $matches[3], $matches[1]);
                                        }
                                }
                        }
                }
        }

References $ilDB, $result, $row, ilInternalLink\_deleteAllLinksOfSource(), _resolveInternalLink(), and ilInternalLink\_saveLink().

Referenced by ilContObjParser\processPagesToParse().

Here is the call graph for this function:

Here is the caller graph for this function:

_SurveyQuestion()

SurveyQuestion::_SurveyQuestion

(

)

Definition at line 198 of file class.SurveyQuestion.php.

        {
        }

addInternalLink()

SurveyQuestion::addInternalLink	(		$material_id,
			$title = ""
	)

Definition at line 1379 of file class.SurveyQuestion.php.

        {
                if (strlen($material_id))
                {
                        if (strcmp($material_title, "") == 0)
                        {
                                if (preg_match("/il__(\w+)_(\d+)/", $material_id, $matches))
                                {
                                        $type = $matches[1];
                                        $target_id = $matches[2];
                                        $material_title = $this->lng->txt("obj_$type") . ": ";
                                        switch ($type)
                                        {
                                                case "lm":
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $target_id, true);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $material_title .= $cont_obj->getTitle();
                                                        break;
                                                case "pg":
                                                        include_once("./Modules/LearningModule/classes/class.ilLMPageObject.php");
                                                        include_once("./Modules/LearningModule/classes/class.ilLMObject.php");
                                                        $lm_id = ilLMObject::_lookupContObjID($target_id);
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $lm_id, FALSE);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $pg_obj =& new ilLMPageObject($cont_obj, $target_id);
                                                        $material_title .= $pg_obj->getTitle();
                                                        break;
                                                case "st":
                                                        include_once("./Modules/LearningModule/classes/class.ilStructureObject.php");
                                                        include_once("./Modules/LearningModule/classes/class.ilLMObject.php");
                                                        $lm_id = ilLMObject::_lookupContObjID($target_id);
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $lm_id, FALSE);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $st_obj =& new ilStructureObject($cont_obj, $target_id);
                                                        $material_title .= $st_obj->getTitle();
                                                        break;
                                                case "git":
                                                        include_once "./Modules/Glossary/classes/class.ilGlossaryTerm.php";
                                                        $material_title = $this->lng->txt("glossary_term") . ": " . ilGlossaryTerm::_lookGlossaryTerm($target_id);
                                                        break;
                                                case "mob":
                                                        break;
                                        }
                                }
                        }
                        include_once "./Modules/SurveyQuestionPool/classes/class.ilSurveyMaterial.php";
                        $mat = new ilSurveyMaterial();
                        $mat->type = 0;
                        $mat->internal_link = $material_id;
                        $mat->title = $material_title;
                        $this->addMaterial($mat);
                        $this->saveMaterial();
                }
        }

References $target_id, ilGlossaryTerm\_lookGlossaryTerm(), ilLMObject\_lookupContObjID(), addMaterial(), and saveMaterial().

Here is the call graph for this function:

addMaterial()

SurveyQuestion::addMaterial

(

$obj_material

)

Definition at line 1476 of file class.SurveyQuestion.php.

        {
                array_push($this->material, $obj_material);
        }

Referenced by addInternalLink().

Here is the caller graph for this function:

addMaterials()

SurveyQuestion::addMaterials	(		$materials_file,
			$materials_name = ""
	)

Sets the materials uri.

Parameters

string	$materials_file	An uri to additional materials
string	$materials_name	An uri name to additional materials @access public

See also

$materials

Definition at line 331 of file class.SurveyQuestion.php.

        {
                if (empty($materials_name)) 
                {
                        $materials_name = $materials_file;
                }
                if ((!empty($materials_name))&&(!array_key_exists($materials_name, $this->materials))) 
                {
                        $this->materials[$materials_name] = $materials_file;
                }
        }

Referenced by setMaterialsfile().

Here is the caller graph for this function:

addMaterialTag()

SurveyQuestion::addMaterialTag	(	&	$a_xml_writer,
			$a_material,
			$close_material_tag = TRUE,
			$add_mobs = TRUE,
			$a_attrs = null
	)

Creates an XML material tag from a plain text or xhtml text.

Parameters

object	$a_xml_writer	Reference to the ILIAS XML writer
string	$a_material	plain text or html text containing the material

Returns

string XML material tag @access public

Definition at line 1904 of file class.SurveyQuestion.php.

        {
                include_once "./Services/RTE/classes/class.ilRTE.php";
                include_once("./Services/MediaObjects/classes/class.ilObjMediaObject.php");
 
                $a_xml_writer->xmlStartTag("material");
                $attrs = array(
                        "type" => "text/plain"
                );
                if ($this->isHTML($a_material))
                {
                        $attrs["type"] = "text/xhtml";
                }
                if (is_array($a_attrs))
                {
                        $attrs = array_merge($attrs, $a_attrs);
                }
                $a_xml_writer->xmlElement("mattext", $attrs, ilRTE::_replaceMediaObjectImageSrc($a_material, 0));
 
                if ($add_mobs)
                {
                        $mobs = ilObjMediaObject::_getMobsOfObject("spl:html", $this->getId());
                        foreach ($mobs as $mob)
                        {
                                $mob_obj =& new ilObjMediaObject($mob);
                                $imgattrs = array(
                                        "label" => "il_" . IL_INST_ID . "_mob_" . $mob,
                                        "uri" => "objects/" . "il_" . IL_INST_ID . "_mob_" . $mob . "/" . $mob_obj->getTitle(),
                                        "type" => "spl:html",
                                        "id" => $this->getId()
                                );
                                $a_xml_writer->xmlElement("matimage", $imgattrs, NULL);
                        }
                }               
                if ($close_material_tag) $a_xml_writer->xmlEndTag("material");
        }

References $mobs, ilObjMediaObject\_getMobsOfObject(), ilRTE\_replaceMediaObjectImageSrc(), getId(), and isHTML().

Referenced by SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), and SurveyTextQuestion\insertXML().

Here is the call graph for this function:

Here is the caller graph for this function:

addUserSpecificResultsData()

SurveyQuestion::addUserSpecificResultsData	(	&	$a_array,
		&	$resultset
	)

Adds the values for the user specific results export for a given user.

Parameters

array	$a_array	An array which is used to append the values
array	$resultset	The evaluation data for a given user @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2000 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

addUserSpecificResultsExportTitles()

SurveyQuestion::addUserSpecificResultsExportTitles	(	&	$a_array,
			$a_use_label = false,
			$a_substitute = true
	)

Adds the entries for the title row of the user specific results.

Parameters

array

$a_array

An array which is used to append the title row entries @access public

Reimplemented in SurveyMatrixQuestion, SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 1971 of file class.SurveyQuestion.php.

        {
                if(!$a_use_label)
                {
                        $title = $this->title;                  
                }
                else
                {
                        if($a_substitute)
                        {
                                $title = $this->label ? $this->label : $this->title;
                        }
                        else
                        {
                                $title = $this->label;
                        }
                }       
                
                array_push($a_array, $title);
                return $title;
        }

References $title.

calculateCumulatedResults()

& SurveyQuestion::calculateCumulatedResults (   $survey_id,   $finished_ids  )

protected

Definition at line 2289 of file class.SurveyQuestion.php.

        {
                if (count($this->cumulated) == 0)
                {                       
                        if(!$finished_ids)
                        {
                                include_once "./Modules/Survey/classes/class.ilObjSurvey.php";
                                $nr_of_users = ilObjSurvey::_getNrOfParticipants($survey_id);
                        }
                        else
                        {
                                $nr_of_users = sizeof($finished_ids);
                        }
                        if($nr_of_users)
                        {
                                $this->cumulated =& $this->getCumulatedResults($survey_id, $nr_of_users, $finished_ids);
                        }
                }
                return $this->cumulated;
        }

References $cumulated, $survey_id, and ilObjSurvey\_getNrOfParticipants().

Referenced by SurveyMatrixQuestion\getCumulatedResultData(), and getCumulatedResultData().

Here is the call graph for this function:

Here is the caller graph for this function:

copyObject()

SurveyQuestion::copyObject	(		$target_questionpool,
			$title = ""
	)

Copies an assOrderingQuestion object.

@access public

Definition at line 660 of file class.SurveyQuestion.php.

        {
                if ($this->getId() <= 0)
                {
                        // The question has not been saved. It cannot be copied
                        return;
                }
                $clone = $this;
                $original_id = SurveyQuestion::_getOriginalId($this->getId(), false);
                $clone->setId(-1);
                $source_questionpool = $this->getObjId();
                $clone->setObjId($target_questionpool);
                if ($title)
                {
                        $clone->setTitle($title);
                }
                
                $clone->saveToDb();
 
                // duplicate the materials
                $clone->duplicateMaterials($original_id);
                // copy XHTML media objects
                $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
                return $clone->getId();
        }

References $title, _getOriginalId(), getId(), and getObjId().

Here is the call graph for this function:

copyXHTMLMediaObjectsOfQuestion()

SurveyQuestion::copyXHTMLMediaObjectsOfQuestion

(

$a_q_id

)

Increases the media object usage counter when a question is duplicated.

Parameters

integer

$a_q_id

The question id of the original question @access public

Definition at line 692 of file class.SurveyQuestion.php.

        {
                include_once("./Services/MediaObjects/classes/class.ilObjMediaObject.php");
                $mobs = ilObjMediaObject::_getMobsOfObject("spl:html", $a_q_id);
                foreach ($mobs as $mob)
                {
                        ilObjMediaObject::_saveUsage($mob, "spl:html", $this->getId());
                }
        }

References $mobs, ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_saveUsage(), and getId().

Here is the call graph for this function:

createNewQuestion()

SurveyQuestion::createNewQuestion

(

)

Creates a new question with a 0 timestamp when a new question is created This assures that an ID is given to the question if a file upload or something else occurs.

Returns

integer ID of the new question

Definition at line 926 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                                
                $obj_id = $this->getObjId();
                if ($obj_id > 0)
                {
                        $next_id = $ilDB->nextId('svy_question');
                        $affectedRows = $ilDB->manipulateF("INSERT INTO svy_question (question_id, questiontype_fi, " .
                                "obj_fi, owner_fi, title, description, author, questiontext, obligatory, complete, " .
                                "created, original_id, tstamp) VALUES " .
                                "(%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)",
                                array('integer', 'integer', 'integer', 'integer', 'text', 'text', 'text', 'text', 
                                        'text', 'text', 'integer', 'integer', 'integer'),
                                array(
                                        $next_id,
                                        $this->getQuestionTypeID(),
                                        $obj_id,
                                        $this->getOwner(),
                                        NULL,
                                        NULL,
                                        $this->getAuthor(),
                                        NULL,
                                        "1",
                                        "0",
                                        time(),
                                        NULL,
                                        0
                                )
                        );
                        $this->setId($next_id);
                }
                return $this->getId();
        }

References $ilDB, $obj_id, getAuthor(), getId(), getObjId(), getOwner(), getQuestionTypeID(), and setId().

Here is the call graph for this function:

delete()

SurveyQuestion::delete

(

$question_id

)

Deletes a question and all materials from the database.

Parameters

integer

$question_id

The database id of the question @access private

Definition at line 1086 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                if ($question_id < 1) return;
      
                $result = $ilDB->queryF("SELECT obj_fi FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
                if ($result->numRows() == 1)
                {
                        $row = $ilDB->fetchAssoc($result);
                        $obj_id = $row["obj_fi"];
                }
                else
                {
                        return;
                }
                
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_answer WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
 
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_constraint WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
 
                $result = $ilDB->queryF("SELECT constraint_fi FROM svy_qst_constraint WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                while ($row = $ilDB->fetchObject($result))
                {
                        $affectedRows = $ilDB->manipulateF("DELETE FROM svy_constraint WHERE constraint_id = %s",
                                array('integer'),
                                array($row->constraint_fi)
                        );
                }
        
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_qst_constraint WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
 
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_qblk_qst WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_qst_oblig WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_svy_qst WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_variable WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_question WHERE question_id = %s",
                        array('integer'),
                        array($question_id)
                );
 
                $this->deleteAdditionalTableData($question_id);
                
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_material WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
                include_once "./Services/Link/classes/class.ilInternalLink.php";
                ilInternalLink::_deleteAllLinksOfSource("sqst", $question_id);
 
                $directory = CLIENT_WEB_DIR . "/survey/" . $obj_id . "/$question_id";
                if (preg_match("/\d+/", $obj_id) and preg_match("/\d+/", $question_id) and is_dir($directory))
                {
                        include_once "./Services/Utilities/classes/class.ilUtil.php";
                        ilUtil::delDir($directory);
                }
 
                include_once("./Services/MediaObjects/classes/class.ilObjMediaObject.php");
                $mobs = ilObjMediaObject::_getMobsOfObject("spl:html", $question_id);
                // remaining usages are not in text anymore -> delete them
                // and media objects (note: delete method of ilObjMediaObject
                // checks whether object is used in another context; if yes,
                // the object is not deleted!)
                foreach($mobs as $mob)
                {
                        ilObjMediaObject::_removeUsage($mob, "spl:html", $question_id);
                        $mob_obj =& new ilObjMediaObject($mob);
                        $mob_obj->delete();
                }
                
                include_once("./Modules/Survey/classes/class.ilSurveySkill.php");
                ilSurveySkill::handleQuestionDeletion($question_id, $obj_id);
                
                // #12772 - untie question copies from pool question 
                $ilDB->manipulate("UPDATE svy_question".
                        " SET original_id = NULL".
                        " WHERE original_id  = ".$ilDB->quote($question_id, "integer"));                
        }

References $ilDB, $mobs, $obj_id, $result, $row, ilInternalLink\_deleteAllLinksOfSource(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilUtil\delDir(), deleteAdditionalTableData(), and ilSurveySkill\handleQuestionDeletion().

Here is the call graph for this function:

deleteAdditionalTableData()

SurveyQuestion::deleteAdditionalTableData

(

$question_id

)

Deletes datasets from the additional question table in the database.

Parameters

integer

$question_id

The question id which should be deleted in the additional question table @access public

Reimplemented in SurveyMatrixQuestion.

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

        {
                global $ilDB;
                $affectedRows = $ilDB->manipulateF("DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s",
                        array('integer'),
                        array($question_id)
                );
        }

References $ilDB.

Referenced by delete().

Here is the caller graph for this function:

deleteMaterial()

SurveyQuestion::deleteMaterial

(

$materials_name = ""

)

Deletes a materials uri with a given name.

Parameters

string

$index

A materials_name of the materials uri @access public

See also

$materials

Definition at line 379 of file class.SurveyQuestion.php.

        {
                foreach ($this->materials as $key => $value) 
                {
                        if (strcmp($key, $materials_name)==0) 
                        {
                                if (file_exists($this->getMaterialsPath().$value)) 
                                {
                                        unlink($this->getMaterialsPath().$value);
                                }
                                unset($this->materials[$key]);
                        }
                }
  }

References getMaterialsPath().

Here is the call graph for this function:

deleteMaterials()

SurveyQuestion::deleteMaterials

(

$a_array

)

Deletes materials.

Parameters

array

$a_array

Array with indexes of the materials to delete

Definition at line 1442 of file class.SurveyQuestion.php.

        {
                foreach ($a_array as $idx)
                {
                        unset($this->material[$idx]);
                }
                $this->material = array_values($this->material);
                $this->saveMaterial();
        }

References saveMaterial().

Here is the call graph for this function:

duplicate()

SurveyQuestion::duplicate	(		$for_survey = true,
			$title = "",
			$author = "",
			$owner = ""
	)

Duplicates a survey question.

@access public

Definition at line 617 of file class.SurveyQuestion.php.

        {
                if ($this->getId() <= 0)
                {
                        // The question has not been saved. It cannot be duplicated
                        return;
                }
                // duplicate the question in database
                $clone = $this;
                $original_id = $this->getId();
                $clone->setId(-1);
                if ($title)
                {
                        $clone->setTitle($title);
                }
                if ($author)
                {
                        $clone->setAuthor($author);
                }
                if ($owner)
                {
                        $clone->setOwner($owner);
                }
                if ($for_survey)
                {
                        $clone->saveToDb($original_id);
                }
                else
                {
                        $clone->saveToDb();
                }
                // duplicate the materials
                $clone->duplicateMaterials($original_id);
                // copy XHTML media objects
                $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
                return $clone->getId();
        }

References $author, $owner, $title, and getId().

Here is the call graph for this function:

duplicateMaterials()

SurveyQuestion::duplicateMaterials

(

$question_id

)

Duplicates the materials of a question.

Parameters

integer

$question_id

The database id of the original survey question @access public

Definition at line 1458 of file class.SurveyQuestion.php.

        {
                foreach ($this->materials as $filename)
                {
                        $materialspath = $this->getMaterialsPath();
                        $materialspath_original = preg_replace("/([^\d])$this->id([^\d])/", "\${1}$question_id\${2}", $materialspath);
                        if (!file_exists($materialspath)) 
                        {
                                include_once "./Services/Utilities/classes/class.ilUtil.php";
                                ilUtil::makeDirParents($materialspath);
                        }
                        if (!copy($materialspath_original . $filename, $materialspath . $filename)) 
                        {
                                print "material could not be duplicated!!!! ";
                        }
                }
        }

References $filename, getMaterialsPath(), ilUtil\makeDirParents(), and print.

Here is the call graph for this function:

flushMaterials()

SurveyQuestion::flushMaterials

(

)

Deletes all materials uris.

@access public

See also

$materials

Definition at line 400 of file class.SurveyQuestion.php.

        {
    $this->materials = array();
  }

getAuthor()

SurveyQuestion::getAuthor

(

)

Gets the authors name of the SurveyQuestion object.

Returns

string The string containing the name of the questions author @access public

See also

$author

Definition at line 560 of file class.SurveyQuestion.php.

        {
                return (strlen($this->author)) ? $this->author : NULL;
        }

Referenced by createNewQuestion(), SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), SurveyMatrixQuestion\isComplete(), SurveyMetricQuestion\isComplete(), SurveyMultipleChoiceQuestion\isComplete(), SurveySingleChoiceQuestion\isComplete(), SurveyTextQuestion\isComplete(), and saveToDb().

Here is the caller graph for this function:

getAvailableRelations()

SurveyQuestion::getAvailableRelations

(

)

Returns the available relations for the question.

Returns

array An array containing the available relations @access public

Reimplemented in SurveyMetricQuestion, SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 2199 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                return array();
        }

getCopyIds()

SurveyQuestion::getCopyIds

(

$a_group_by_survey = false

)

Definition at line 2392 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT q.question_id,s.obj_fi".
                        " FROM svy_question q".
                        " JOIN svy_svy_qst sq ON (sq.question_fi = q.question_id)".
                        " JOIN svy_svy s ON (s.survey_id = sq.survey_fi)".
                        " WHERE original_id = ".$ilDB->quote($this->getId(), "integer"));
                $res = array();
                while($row = $ilDB->fetchAssoc($set))
                {
                        if(!$a_group_by_survey)
                        {
                                $res[] = $row["question_id"];
                        }
                        else
                        {
                                $res[$row["obj_fi"]][] = $row["question_id"];
                        }
                }
                return $res;
        }

References $ilDB, $res, and $row.

Referenced by hasCopies().

Here is the caller graph for this function:

getCumulatedResultData()

SurveyQuestion::getCumulatedResultData	(		$survey_id,
			$counter,
			$finished_ids
	)

Creates a the cumulated results data for the question.

Returns

array Data

Reimplemented in SurveyMatrixQuestion.

Definition at line 2315 of file class.SurveyQuestion.php.

        {               
                $cumulated =& $this->calculateCumulatedResults($survey_id, $finished_ids);
                $questiontext = preg_replace("/<[^>]+?>/ims", "", $this->getQuestiontext());
                
                $maxlen = 75;
                include_once "./Services/Utilities/classes/class.ilStr.php";
                if (ilStr::strlen($questiontext) > $maxlen + 3)
                {
                        $questiontext = ilStr::substr($questiontext, 0, $maxlen) . "...";
                }
                
                $result = array(
                        'counter' => $counter,
                        'title' => $counter.'. '.$this->getTitle(),
                        'question' => $questiontext,
                        'users_answered' => $cumulated['USERS_ANSWERED'],
                        'users_skipped' => $cumulated['USERS_SKIPPED'],
                        'question_type' => $this->lng->txt($cumulated["QUESTION_TYPE"]),
                        'mode' => $cumulated["MODE"],
                        'mode_nr_of_selections' => $cumulated["MODE_NR_OF_SELECTIONS"],
                        'median' => $cumulated["MEDIAN"],
                        'arithmetic_mean' => $cumulated["ARITHMETIC_MEAN"]
                );
                return $result;
        }

References $cumulated, $questiontext, $result, calculateCumulatedResults(), and getQuestiontext().

Here is the call graph for this function:

getDescription()

SurveyQuestion::getDescription

(

)

Gets the description string of the SurveyQuestion object.

Returns

string The description string to describe the question @access public

See also

$description

Definition at line 548 of file class.SurveyQuestion.php.

        {
                return (strlen($this->description)) ? $this->description : NULL;
        }

Referenced by SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), and saveToDb().

Here is the caller graph for this function:

getId()

SurveyQuestion::getId

(

)

Gets the id of the SurveyQuestion object.

Returns

integer The id of the SurveyQuestion object @access public

See also

$id

Definition at line 469 of file class.SurveyQuestion.php.

        {
                return $this->id;
        }

References $id.

Referenced by addMaterialTag(), SurveyMatrixQuestion\addUserSpecificResultsData(), SurveyMetricQuestion\addUserSpecificResultsData(), SurveyMultipleChoiceQuestion\addUserSpecificResultsData(), SurveySingleChoiceQuestion\addUserSpecificResultsData(), SurveyTextQuestion\addUserSpecificResultsData(), SurveyMatrixQuestion\checkUserInput(), SurveyMetricQuestion\checkUserInput(), SurveyMultipleChoiceQuestion\checkUserInput(), SurveySingleChoiceQuestion\checkUserInput(), SurveyTextQuestion\checkUserInput(), copyObject(), copyXHTMLMediaObjectsOfQuestion(), createNewQuestion(), duplicate(), SurveyMatrixQuestion\getCumulatedResults(), SurveyMetricQuestion\getCumulatedResults(), SurveyMultipleChoiceQuestion\getCumulatedResults(), SurveySingleChoiceQuestion\getCumulatedResults(), SurveyTextQuestion\getCumulatedResults(), SurveyMatrixQuestion\getCumulatedResultsForRow(), SurveyMatrixQuestion\getNrOfUsersAnswered(), getObligatory(), SurveyMatrixQuestion\getUserAnswers(), SurveyMetricQuestion\getUserAnswers(), SurveyMultipleChoiceQuestion\getUserAnswers(), SurveySingleChoiceQuestion\getUserAnswers(), SurveyTextQuestion\getUserAnswers(), SurveyMatrixQuestion\getWorkingDataFromUserInput(), SurveyMetricQuestion\getWorkingDataFromUserInput(), SurveyMultipleChoiceQuestion\getWorkingDataFromUserInput(), SurveySingleChoiceQuestion\getWorkingDataFromUserInput(), SurveyTextQuestion\getWorkingDataFromUserInput(), SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), loadFromDb(), SurveyMatrixQuestion\saveBipolarAdjectives(), SurveyMultipleChoiceQuestion\saveCategoriesToDb(), SurveySingleChoiceQuestion\saveCategoriesToDb(), SurveyMatrixQuestion\saveColumnsToDb(), saveCompletionStatus(), SurveyMatrixQuestion\saveLayout(), saveMaterial(), SurveyMatrixQuestion\saveRandomData(), SurveyMetricQuestion\saveRandomData(), SurveyMultipleChoiceQuestion\saveRandomData(), SurveySingleChoiceQuestion\saveRandomData(), SurveyTextQuestion\saveRandomData(), SurveyMatrixQuestion\saveRowsToDb(), SurveyMetricQuestion\saveToDb(), SurveyMultipleChoiceQuestion\saveToDb(), saveToDb(), SurveySingleChoiceQuestion\saveToDb(), SurveyTextQuestion\saveToDb(), SurveyMatrixQuestion\saveToDb(), SurveyMatrixQuestion\saveUserInput(), SurveyMetricQuestion\saveUserInput(), SurveyMultipleChoiceQuestion\saveUserInput(), SurveySingleChoiceQuestion\saveUserInput(), SurveyTextQuestion\saveUserInput(), and syncWithOriginal().

Here is the caller graph for this function:

getImagePath()

SurveyQuestion::getImagePath

(

)

Returns the image path for web accessable images of a question.

The image path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/images

@access public

Definition at line 977 of file class.SurveyQuestion.php.

        {
                return CLIENT_WEB_DIR . "/survey/$this->obj_id/$this->id/images/";
        }

getImagePathWeb()

SurveyQuestion::getImagePathWeb

(

)

Returns the web image path for web accessable images of a question.

The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/images

@access public

Definition at line 999 of file class.SurveyQuestion.php.

        {
                include_once "./Services/Utilities/classes/class.ilUtil.php";
                $webdir = ilUtil::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/survey/$this->obj_id/$this->id/images/";
                return str_replace(ilUtil::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH), ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH), $webdir);
        }

References ILIAS_ABSOLUTE_PATH, and ilUtil\removeTrailingPathSeparators().

Here is the call graph for this function:

getLabel()

SurveyQuestion::getLabel

(

)

Definition at line 457 of file class.SurveyQuestion.php.

        {
                return $this->label;
        }

getMaterial()

SurveyQuestion::getMaterial

(

)

Definition at line 2273 of file class.SurveyQuestion.php.

        {
                return $this->material;
        }

References $material.

getMaterialsPath()

SurveyQuestion::getMaterialsPath

(

)

Returns the materials path for web accessable materials of a question.

The materials path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/materials

@access public

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

        {
                return CLIENT_WEB_DIR . "/survey/$this->obj_id/$this->id/materials/";
        }

Referenced by deleteMaterial(), duplicateMaterials(), and setMaterialsfile().

Here is the caller graph for this function:

getMaterialsPathWeb()

SurveyQuestion::getMaterialsPathWeb

(

)

Returns the web image path for web accessable images of a question.

The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/images

@access public

Definition at line 1012 of file class.SurveyQuestion.php.

        {
                include_once "./Services/Utilities/classes/class.ilUtil.php";
                $webdir = ilUtil::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/survey/$this->obj_id/$this->id/materials/";
                return str_replace(ilUtil::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH), ilUtil::removeTrailingPathSeparators(ILIAS_HTTP_PATH), $webdir);
        }

References ILIAS_ABSOLUTE_PATH, and ilUtil\removeTrailingPathSeparators().

Here is the call graph for this function:

getObjId()

SurveyQuestion::getObjId

(

)

Get the reference id of the container object.

Returns

integer The reference id of the container object @access public

See also

$obj_id

Definition at line 596 of file class.SurveyQuestion.php.

                            {
                return $this->obj_id;
        }

References $obj_id.

Referenced by copyObject(), createNewQuestion(), and saveToDb().

Here is the caller graph for this function:

getObligatory()

SurveyQuestion::getObligatory

(

$survey_id = ""

)

Gets the obligatory state of the question.

Returns

integer 1, if the question is obligatory, otherwise 0

See also

$obligatory

Definition at line 480 of file class.SurveyQuestion.php.

        {
                if ($survey_id > 0)
                {
                        global $ilDB;
                        
                        $result = $ilDB->queryF("SELECT * FROM svy_qst_oblig WHERE survey_fi = %s AND question_fi = %s",
                                array('integer', 'integer'),
                                array($survey_id, $this->getId())
                        );
                        if ($result->numRows())
                        {
                                $row = $ilDB->fetchAssoc($result);
                                return ($row["obligatory"]) ? 1 : 0;
                        }
                        else
                        {
                                return ($this->obligatory) ? 1 : 0;
                        }
                }
                else
                {
                        return ($this->obligatory) ? 1 : 0;
                }
  }

References $ilDB, $result, $row, $survey_id, and getId().

Referenced by SurveyMatrixQuestion\checkUserInput(), SurveyMetricQuestion\checkUserInput(), SurveyMultipleChoiceQuestion\checkUserInput(), SurveySingleChoiceQuestion\checkUserInput(), SurveyTextQuestion\checkUserInput(), SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), and saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

getOrientation()

SurveyQuestion::getOrientation

(

)

Gets the orientation of the question output.

Returns

integer 0 = vertical, 1 = horizontal @access public

See also

$orientation

Definition at line 525 of file class.SurveyQuestion.php.

        {
                switch ($this->orientation)
                {
                        case 0:
                        case 1:
                        case 2:
                                break;
                        default:
                                $this->orientation = 0;
                                break;
                }
    return $this->orientation;
  }

References $orientation.

Referenced by SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyMultipleChoiceQuestion\saveToDb(), and SurveySingleChoiceQuestion\saveToDb().

Here is the caller graph for this function:

getOriginalId()

SurveyQuestion::getOriginalId

(

)

Definition at line 2258 of file class.SurveyQuestion.php.

        {
                return $this->original_id;
        }

Referenced by SurveyMatrixQuestion\syncWithOriginal(), and syncWithOriginal().

Here is the caller graph for this function:

getOwner()

SurveyQuestion::getOwner

(

)

Gets the creator/owner ID of the SurveyQuestion object.

Returns

integer The numerical ID to identify the owner/creator @access public

See also

$owner

Definition at line 572 of file class.SurveyQuestion.php.

        {
                return $this->owner;
        }

References $owner.

Referenced by createNewQuestion(), and saveToDb().

Here is the caller graph for this function:

getPhrase()

SurveyQuestion::getPhrase

(

$phrase_id

)

Returns a phrase for a given database id.

Returns

String The title of the phrase @access public

Definition at line 1323 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $result = $ilDB->queryF("SELECT title FROM svy_phrase WHERE phrase_id = %s",
                        array('integer'),
                        array($phrase_id)
                );
                if ($row = $ilDB->fetchAssoc($result))
                {
                        return $row["title"];
                }
                return "";
        }

References $ilDB, $result, and $row.

getPreconditionOptions()

SurveyQuestion::getPreconditionOptions

(

)

Returns the options for preconditions.

Returns

array

Reimplemented in SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 2210 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

Referenced by SurveyMatrixQuestion\getPreconditionSelectValue().

Here is the caller graph for this function:

getPreconditionSelectValue()

SurveyQuestion::getPreconditionSelectValue	(		$default = "",
			$title,
			$variable
	)

Creates a form property for the precondition value.

Returns

The ILIAS form element @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 2234 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                return null;
        }

getPreconditionValueOutput()

SurveyQuestion::getPreconditionValueOutput

(

$value

)

Returns the output for a precondition value.

Parameters

string

$value

The precondition value

Returns

string The output of the precondition value @access public

Reimplemented in SurveyMatrixQuestion, SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 2222 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                return $value;
        }

getQuestiontext()

SurveyQuestion::getQuestiontext

(

)

Gets the questiontext of the SurveyQuestion object.

Returns

string The questiontext of the question object @access public

See also

$questiontext

Definition at line 584 of file class.SurveyQuestion.php.

        {
                return (strlen($this->questiontext)) ? $this->questiontext : NULL;
        }

Referenced by SurveyMatrixQuestion\getCumulatedResultData(), getCumulatedResultData(), SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), SurveyMatrixQuestion\isComplete(), SurveyMetricQuestion\isComplete(), SurveyMultipleChoiceQuestion\isComplete(), SurveySingleChoiceQuestion\isComplete(), SurveyTextQuestion\isComplete(), saveToDb(), SurveyMatrixQuestion\setExportCumulatedCVS(), setExportCumulatedCVS(), SurveyMatrixQuestion\setExportCumulatedXLS(), setExportCumulatedXLS(), SurveyMatrixQuestion\setExportDetailsXLS(), SurveyMetricQuestion\setExportDetailsXLS(), SurveyMultipleChoiceQuestion\setExportDetailsXLS(), SurveySingleChoiceQuestion\setExportDetailsXLS(), and SurveyTextQuestion\setExportDetailsXLS().

Here is the caller graph for this function:

getQuestionType()

SurveyQuestion::getQuestionType

(

)

Returns the question type of the question.

Returns

integer The question type of the question @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 1739 of file class.SurveyQuestion.php.

        {
                return "";
        }

Referenced by getQuestionTypeID().

Here is the caller graph for this function:

getQuestionTypeID()

SurveyQuestion::getQuestionTypeID

(

)

Returns the question type ID of the question.

Returns

integer The question type of the question @access public

Reimplemented in SurveyMetricQuestion.

Definition at line 1715 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                $result = $ilDB->queryF("SELECT questiontype_id FROM svy_qtype WHERE type_tag = %s",
                        array('text'),
                        array($this->getQuestionType())
                );
                if ($result->numRows() == 1)
                {
                        $row = $ilDB->fetchAssoc($result);
                        return $row["questiontype_id"];
                }
                else
                {
                        return 0;
                }
        }

References $ilDB, $result, $row, and getQuestionType().

Referenced by createNewQuestion(), and saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

getSkippedValue()

SurveyQuestion::getSkippedValue

(

)

Definition at line 2421 of file class.SurveyQuestion.php.

        {
                include_once "Modules/Survey/classes/class.ilObjSurvey.php";
                return ilObjSurvey::getSurveySkippedValue();
        }

References ilObjSurvey\getSurveySkippedValue().

Referenced by SurveyMatrixQuestion\addUserSpecificResultsData(), SurveyMetricQuestion\addUserSpecificResultsData(), SurveyMultipleChoiceQuestion\addUserSpecificResultsData(), SurveySingleChoiceQuestion\addUserSpecificResultsData(), and SurveyTextQuestion\addUserSpecificResultsData().

Here is the call graph for this function:

Here is the caller graph for this function:

getSubtype()

SurveyQuestion::getSubtype

(

)

Reimplemented in SurveyMatrixQuestion, and SurveyMetricQuestion.

Definition at line 2283 of file class.SurveyQuestion.php.

        {
                // do nothing
                return null;
        }

getSurveyId()

SurveyQuestion::getSurveyId

(

)

Gets the survey id of the SurveyQuestion object.

Returns

integer The survey id of the SurveyQuestion object @access public

See also

$survey_id

Definition at line 513 of file class.SurveyQuestion.php.

        {
                return $this->survey_id;
        }

References $survey_id.

getTitle()

SurveyQuestion::getTitle

(

)

Gets the title string of the SurveyQuestion object.

Returns

string The title string to describe the question @access public

See also

$title

Definition at line 452 of file class.SurveyQuestion.php.

        {
                return $this->title;
        }

References $title.

Referenced by SurveyMatrixQuestion\insertXML(), SurveyMetricQuestion\insertXML(), SurveyMultipleChoiceQuestion\insertXML(), SurveySingleChoiceQuestion\insertXML(), SurveyTextQuestion\insertXML(), SurveyMatrixQuestion\isComplete(), SurveyMetricQuestion\isComplete(), SurveyMultipleChoiceQuestion\isComplete(), SurveySingleChoiceQuestion\isComplete(), SurveyTextQuestion\isComplete(), saveToDb(), SurveyMatrixQuestion\setExportCumulatedCVS(), setExportCumulatedCVS(), SurveyMatrixQuestion\setExportCumulatedXLS(), setExportCumulatedXLS(), SurveyMatrixQuestion\setExportDetailsXLS(), SurveyMetricQuestion\setExportDetailsXLS(), SurveyMultipleChoiceQuestion\setExportDetailsXLS(), SurveySingleChoiceQuestion\setExportDetailsXLS(), and SurveyTextQuestion\setExportDetailsXLS().

Here is the caller graph for this function:

getUserAnswers()

& SurveyQuestion::getUserAnswers

(

$survey_id

)

Returns an array containing all answers to this question in a given survey.

Parameters

integer

$survey_id

The database ID of the survey

Returns

array An array containing the answers to the question. The keys are either the user id or the anonymous id @access public

Definition at line 2012 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                return array();
        }

getWorkingDataFromUserInput()

& SurveyQuestion::getWorkingDataFromUserInput

(

$post_data

)

Creates the user data of the svy_answer table from the POST data.

Returns

array User data according to the svy_answer table @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2024 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                $data = array();
                return $data;
        }

References $data.

hasCopies()

SurveyQuestion::hasCopies

(

)

Definition at line 2416 of file class.SurveyQuestion.php.

        {
                return (bool)sizeof($this->getCopyIds());                                               
        }

References getCopyIds().

Here is the call graph for this function:

importAdditionalMetadata()

SurveyQuestion::importAdditionalMetadata

(

$a_meta

)

Import additional meta data from the question import file.

Usually the meta data section is used to store question elements which are not part of the standard XML schema.

Returns

array $a_meta Array containing the additional meta data @access public

Reimplemented in SurveyMatrixQuestion, SurveyMultipleChoiceQuestion, and SurveySingleChoiceQuestion.

Definition at line 2039 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

importAdjectives()

SurveyQuestion::importAdjectives

(

$a_data

)

Import bipolar adjectives from the question import file.

Returns

array $a_data Array containing the adjectives @access public

Reimplemented in SurveyMatrixQuestion.

Definition at line 2061 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

importMatrix()

SurveyQuestion::importMatrix

(

$a_data

)

Import matrix rows from the question import file.

Returns

array $a_data Array containing the matrix rows @access public

Reimplemented in SurveyMatrixQuestion.

Definition at line 2072 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

importResponses()

SurveyQuestion::importResponses

(

$a_data

)

Import response data from the question import file.

Returns

array $a_data Array containing the response data @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2050 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

isComplete()

SurveyQuestion::isComplete

(

)

Returns 1, if a question is complete for use.

Returns

integer 1, if the question is complete for use, otherwise 0 @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 219 of file class.SurveyQuestion.php.

        {
                return 0;
        }

Referenced by saveCompletionStatus(), and saveToDb().

Here is the caller graph for this function:

isHTML()

SurveyQuestion::isHTML

(

$a_text

)

Checks if a given string contains HTML or not.

Parameters

string

$a_text

Text which should be checked

Returns

boolean @access public

Definition at line 1853 of file class.SurveyQuestion.php.

        {
                if (preg_match("/<[^>]*?>/", $a_text))
                {
                        return TRUE;
                }
                else
                {
                        return FALSE; 
                }
        }

Referenced by addMaterialTag().

Here is the caller graph for this function:

loadFromDb()

SurveyQuestion::loadFromDb

(

$question_id

)

Loads a SurveyQuestion object from the database.

Parameters

integer

$question_id

A unique key which defines the question in the database @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 708 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $result = $ilDB->queryF("SELECT * FROM svy_material WHERE question_fi = %s",
                        array('integer'),
                        array($this->getId())
                );
                $this->material = array();
                if ($result->numRows())
                {
                        include_once "./Modules/SurveyQuestionPool/classes/class.ilSurveyMaterial.php";
                        while ($row = $ilDB->fetchAssoc($result))
                        {
                                $mat = new ilSurveyMaterial();
                                $mat->type = $row['material_type'];
                                $mat->internal_link = $row['internal_link'];
                                $mat->title = $row['material_title'];
                                $mat->import_id = $row['import_id'];
                                $mat->text_material = $row['text_material'];
                                $mat->external_link = $row['external_link'];
                                $mat->file_material = $row['file_material'];
                                array_push($this->material, $mat);
                        }
                }
        }

References $ilDB, $result, $row, and getId().

Here is the call graph for this function:

lookupObjFi()

static SurveyQuestion::lookupObjFi (   $a_qid )

static

Lookip obj fi.

Parameters

return

Definition at line 2447 of file class.SurveyQuestion.php.

        {
                global $ilDB;
 
                $set = $ilDB->query("SELECT obj_fi FROM svy_question ".
                        " WHERE question_id = ".$ilDB->quote($a_qid, "integer")
                        );
                $rec = $ilDB->fetchAssoc($set);
                return $rec["obj_fi"];
        }

References $ilDB.

Referenced by ilTermUsagesTableGUI\fillRow().

Here is the caller graph for this function:

outChart()

SurveyQuestion::outChart	(		$survey_id,
			$type = ""
	)

Creates an image visualising the results of the question.

Parameters

integer	$survey_id	The database ID of the survey
string	$type	An additional parameter to allow to draw more than one chart per question. Must be interpreted by the question. Default is an empty string

Returns

binary Image with the visualisation @access private

Definition at line 2248 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

phraseExists()

SurveyQuestion::phraseExists

(

$title

)

Returns true if the phrase title already exists for the current user.

Parameters

string

$title

The title of the phrase

Returns

boolean True, if the title exists, otherwise False @access public

Definition at line 1345 of file class.SurveyQuestion.php.

        {
                global $ilUser, $ilDB;
                
                $result = $ilDB->queryF("SELECT phrase_id FROM svy_phrase WHERE title = %s AND owner_fi = %s",
                        array('text', 'integer'),
                        array($title, $ilUser->getId())
                );
                return ($result->numRows() == 0) ? false : true;
        }

References $ilDB, $ilUser, $result, and $title.

prepareTextareaOutput()

SurveyQuestion::prepareTextareaOutput	(		$txt_output,
			$prepare_for_latex_output = FALSE
	)

Prepares a string for a text area output in surveys.

Parameters

string

$txt_output

String which should be prepared for output @access public

Definition at line 1947 of file class.SurveyQuestion.php.

        {
                include_once "./Services/Utilities/classes/class.ilUtil.php";
                return ilUtil::prepareTextareaOutput($txt_output, $prepare_for_latex_output);
        }

References ilUtil\prepareTextareaOutput().

Here is the call graph for this function:

QTIMaterialToString()

SurveyQuestion::QTIMaterialToString

(

$a_material

)

Reads an QTI material tag an creates a text string.

Parameters

string

$a_material

QTI material tag

Returns

string text or xhtml string @access public

Definition at line 1872 of file class.SurveyQuestion.php.

        {
                $result = "";
                for ($i = 0; $i < $a_material->getMaterialCount(); $i++)
                {
                        $material = $a_material->getMaterial($i);
                        if (strcmp($material["type"], "mattext") == 0)
                        {
                                $result .= $material["material"]->getContent();
                        }
                        if (strcmp($material["type"], "matimage") == 0)
                        {
                                $matimage = $material["material"];
                                if (preg_match("/(il_([0-9]+)_mob_([0-9]+))/", $matimage->getLabel(), $matches))
                                {
                                        // import an mediaobject which was inserted using tiny mce
                                        if (!is_array($_SESSION["import_mob_xhtml"])) $_SESSION["import_mob_xhtml"] = array();
                                        array_push($_SESSION["import_mob_xhtml"], array("mob" => $matimage->getLabel(), "uri" => $matimage->getUri()));
                                }
                        }
                }
                return $result;
        }

References $_SESSION, $material, and $result.

questionTitleExists()

SurveyQuestion::questionTitleExists	(		$title,
			$questionpool_object = ""
	)

Returns TRUE if the question title exists in the database.

Parameters

string	$title	The title of the question
string	$questionpool_reference	The reference id of a container question pool

Returns

boolean The result of the title check @access public

Definition at line 232 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $refwhere = "";
                if (strcmp($questionpool_object, "") != 0)
                {
                        $refwhere = sprintf(" AND obj_fi = %s",
                                $ilDB->quote($questionpool_object, 'integer')
                        );
                }
                $result = $ilDB->queryF("SELECT question_id FROM svy_question WHERE title = %s$refwhere",
                        array('text'),
                        array($title)
                );
                return ($result->numRows() > 0) ? true : false;
        }

References $ilDB, $result, and $title.

saveCategoryToDb()

SurveyQuestion::saveCategoryToDb	(		$categorytext,
			$neutral = 0
	)

Saves a category to the database.

Parameters

string

$categorytext

The description of the category

Returns

integer The database id of the category @access public

See also

$categories

Definition at line 1027 of file class.SurveyQuestion.php.

        {
                global $ilUser, $ilDB;
                
                $result = $ilDB->queryF("SELECT title, category_id FROM svy_category WHERE title = %s AND neutral = %s AND owner_fi = %s",
                        array('text','text','integer'),
                        array($categorytext, $neutral, $ilUser->getId())
                );
                $insert = FALSE;
                $returnvalue = "";
                if ($result->numRows()) 
                {
                        $insert = TRUE;
                        while ($row = $ilDB->fetchAssoc($result))
                        {
                                if (strcmp($row["title"], $categorytext) == 0)
                                {
                                        $returnvalue = $row["category_id"];
                                        $insert = FALSE;
                                }
                        }
                }
                else
                {
                        $insert = TRUE;
                }
                if ($insert)
                {
                        $next_id = $ilDB->nextId('svy_category');
                        $affectedRows = $ilDB->manipulateF("INSERT INTO svy_category (category_id, title, neutral, owner_fi, tstamp) VALUES (%s, %s, %s, %s, %s)",
                                array('integer','text','text','integer','integer'),
                                array($next_id, $categorytext, $neutral, $ilUser->getId(), time())
                        );
                        $returnvalue = $next_id;
                }
                return $returnvalue;
        }

References $ilDB, $ilUser, $result, and $row.

Referenced by SurveyMultipleChoiceQuestion\saveCategoriesToDb(), and SurveySingleChoiceQuestion\saveCategoriesToDb().

Here is the caller graph for this function:

saveCompletionStatus()

SurveyQuestion::saveCompletionStatus

(

$original_id = ""

)

Saves the complete flag to the database.

@access public

Definition at line 765 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                $question_id = $this->getId();
                if (strlen($original_id))
                {
                        $question_id = $original_id;
                }
 
                if ($this->getId() > 0) 
                {
                        // update existing dataset
                        $affectedRows = $ilDB->manipulateF("UPDATE svy_question SET complete = %s, tstamp = %s WHERE question_id = %s",
                                array('text', 'integer', 'integer'),
                                array($this->isComplete(), time(), $question_id)
                        );
                }
        }

References $ilDB, getId(), and isComplete().

Referenced by SurveyMultipleChoiceQuestion\saveCategoriesToDb(), SurveySingleChoiceQuestion\saveCategoriesToDb(), SurveyMatrixQuestion\saveColumnsToDb(), and SurveyMatrixQuestion\saveRowsToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

saveMaterial()

SurveyQuestion::saveMaterial

(

)

save material to db

Definition at line 889 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                include_once "./Services/Link/classes/class.ilInternalLink.php";
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_material WHERE question_fi = %s",
                        array('integer'),
                        array($this->getId())
                );
                ilInternalLink::_deleteAllLinksOfSource("sqst", $this->getId());
 
                foreach ($this->material as $material)
                {
                        $next_id = $ilDB->nextId('svy_material');
                        $affectedRows = $ilDB->manipulateF("INSERT INTO svy_material " .
                                "(material_id, question_fi, internal_link, import_id, material_title, tstamp," .
                                "text_material, external_link, file_material, material_type) ".
                                "VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s)",
                                array('integer','integer','text','text','text','integer','text','text','text','integer'),
                                array(
                                        $next_id, $this->getId(), $material->internal_link, $material->import_id, 
                                        $material->title, time(), $material->text_material, $material->external_link,
                                        $material->file_material, $material->type)
                        );
                        if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $material->internal_link, $matches))
                        {
                                ilInternalLink::_saveLink("sqst", $this->getId(), $matches[2], $matches[3], $matches[1]);
                        }
                }
        }

References $ilDB, $material, ilInternalLink\_deleteAllLinksOfSource(), ilInternalLink\_saveLink(), and getId().

Referenced by addInternalLink(), deleteMaterials(), SurveyMetricQuestion\saveToDb(), SurveyMultipleChoiceQuestion\saveToDb(), SurveySingleChoiceQuestion\saveToDb(), SurveyTextQuestion\saveToDb(), SurveyMatrixQuestion\saveToDb(), and setMaterial().

Here is the call graph for this function:

Here is the caller graph for this function:

saveRandomData()

SurveyQuestion::saveRandomData

(

$active_id

)

Saves random answers for a given active user in the database.

Parameters

integer

$active_id

The database ID of the active user

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2268 of file class.SurveyQuestion.php.

        {
                // do nothing, overwrite in parent classes
        }

saveToDb()

SurveyQuestion::saveToDb

(

$original_id = ""

)

Saves a SurveyQuestion object to a database.

Parameters

integer

$original_id

@access public

Reimplemented in SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

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

        {
                global $ilDB;
                
                // cleanup RTE images which are not inserted into the question text
                include_once("./Services/RTE/classes/class.ilRTE.php");
                ilRTE::_cleanupMediaObjectUsage($this->getQuestiontext(), "spl:html", $this->getId());
                $affectedRows = 0;
                if ($this->getId() == -1) 
                {
                        // Write new dataset
                        $next_id = $ilDB->nextId('svy_question');
                        $affectedRows = $ilDB->insert("svy_question", array(
                                "question_id" => array("integer", $next_id),
                                "questiontype_fi" => array("integer", $this->getQuestionTypeID()),
                                "obj_fi" => array("integer", $this->getObjId()),
                                "owner_fi" => array("integer", $this->getOwner()),
                                "title" => array("text", $this->getTitle()),
                                "label" => array("text", (strlen($this->label)) ? $this->label : null),
                                "description" => array("text", $this->getDescription()),
                                "author" => array("text", $this->getAuthor()),
                                "questiontext" => array("clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestiontext(), 0)),
                                "obligatory" => array("text", $this->getObligatory()),
                                "complete" => array("text", $this->isComplete()),
                                "created" => array("integer", time()),
                                "original_id" => array("integer", ($original_id) ? $original_id : NULL),
                                "tstamp" => array("integer", time())
                        ));
                        $this->setId($next_id);
                } 
                else 
                {
                        // update existing dataset
                        $affectedRows = $ilDB->update("svy_question", array(
                                "title" => array("text", $this->getTitle()),
                                "label" => array("text", (strlen($this->label)) ? $this->label : null),
                                "description" => array("text", $this->getDescription()),
                                "author" => array("text", $this->getAuthor()),
                                "questiontext" => array("clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestiontext(), 0)),
                                "obligatory" => array("text", $this->getObligatory()),
                                "complete" => array("text", $this->isComplete()),
                                "tstamp" => array("integer", time())
                        ), array(
                        "question_id" => array("integer", $this->getId())
                        ));
                }
 
                $set = $ilDB->query("SELECT survey_fi FROM svy_svy_qst".
                        " WHERE question_fi = ".$ilDB->quote($this->getId(), "integer"));
                $survey_fi = $ilDB->fetchAssoc($set);
                $survey_fi = $survey_fi["survey_fi"];
 
                if($survey_fi)
                {               
                        $set = $ilDB->query("SELECT obligatory FROM svy_qst_oblig".
                                 " WHERE survey_fi = ".$ilDB->quote($survey_fi, "integer").
                                " AND question_fi = ".$ilDB->quote($this->getId(), "integer"));
                        $has_obligatory_states_entry = (bool)$ilDB->numRows($set);
                        $is_obligatory = $ilDB->fetchAssoc($set);
                        $is_obligatory = (bool)$is_obligatory["obligatory"];
 
                        if(!$this->getObligatory())
                        {
                                if($has_obligatory_states_entry)
                                {
                                        $ilDB->manipulate("DELETE FROM svy_qst_oblig".
                                                " WHERE survey_fi = ".$ilDB->quote($survey_fi, "integer").
                                                " AND question_fi = ".$ilDB->quote($this->getId(), "integer"));                 
                                }
                        }
                        else if($this->getObligatory())
                        {
                                if(!$has_obligatory_states_entry)
                                {
                                        // ilObjSurvey::setObligatoryStates()
                                        $next_id = $ilDB->nextId('svy_qst_oblig');
                                        $affectedRows = $ilDB->manipulateF("INSERT INTO svy_qst_oblig (question_obligatory_id, survey_fi, question_fi, " .
                                                "obligatory, tstamp) VALUES (%s, %s, %s, %s, %s)",
                                                array('integer','integer','integer','text','integer'),
                                                array($next_id, $survey_fi, $this->getId(), 1, time())
                                        );
                                }
                                else if(!$is_obligatory)
                                {
                                         $ilDB->manipulate("UPDATE svy_qst_oblig".
                                                " SET obligatory = ".$ilDB->quote(1, "integer").
                                                " WHERE survey_fi = ".$ilDB->quote($survey_fi, "integer").
                                                " AND question_fi = ".$ilDB->quote($this->getId(), "integer")); 
                                }
                        }
                }
                
                return $affectedRows;
        }

References $ilDB, ilRTE\_cleanupMediaObjectUsage(), ilRTE\_replaceMediaObjectImageSrc(), getAuthor(), getDescription(), getId(), getObjId(), getObligatory(), getOwner(), getQuestiontext(), getQuestionTypeID(), getTitle(), isComplete(), and setId().

Referenced by syncWithOriginal().

Here is the call graph for this function:

Here is the caller graph for this function:

saveWorkingData()

SurveyQuestion::saveWorkingData

(

$limit_to = LIMIT_NO_LIMIT

)

Saves the learners input of the question to the database.

@access public

See also

$answers

Definition at line 967 of file class.SurveyQuestion.php.

        {
  }

setAuthor()

SurveyQuestion::setAuthor

(

$author = ""

)

Sets the authors name of the SurveyQuestion object.

Parameters

string

$author

A string containing the name of the questions author @access public

See also

$author

Definition at line 412 of file class.SurveyQuestion.php.

        {
                if (!$author) 
                {
                        $author = $this->ilias->account->fullname;
                }
                $this->author = $author;
        }

References $author.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setComplete()

SurveyQuestion::setComplete

(

$a_complete

)

Sets the complete state of the question.

Parameters

integer

$a_complete

1 if complete, 0 otherwise @access public

Definition at line 208 of file class.SurveyQuestion.php.

        {
                $this->complete = ($a_complete) ? 1 : 0;
        }

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setDescription()

SurveyQuestion::setDescription

(

$description = ""

)

Sets the description string of the SurveyQuestion object.

Parameters

string

$description

A description string to describe the question @access public

See also

$description

Definition at line 317 of file class.SurveyQuestion.php.

        {
                $this->description = $description;
        }

References $description.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setExportCumulatedCVS()

& SurveyQuestion::setExportCumulatedCVS	(	&	$eval_data,
			$export_label
	)

Creates the CSV output for the cumulated results of this question.

Parameters

object	$worksheet	Reference to the excel worksheet
object	$format_title	Excel title format
object	$format_bold	Excel bold format
array	$eval_data	Cumulated evaluation data
integer	$row	Actual row in the worksheet

Returns

integer The next row which should be used for the export @access public

Reimplemented in SurveyMatrixQuestion.

Definition at line 2138 of file class.SurveyQuestion.php.

        {
                $csvrow = array();
                switch ($export_label)
                {
                        case 'label_only':
                                array_push($csvrow, $this->label);
                                break;
                        case 'title_only':
                                array_push($csvrow, $this->getTitle());
                                break;
                        default:
                                array_push($csvrow, $this->getTitle());
                                array_push($csvrow, $this->label);
                                break;
                }
                array_push($csvrow, strip_tags($this->getQuestiontext())); // #12942
                array_push($csvrow, $this->lng->txt($eval_data["QUESTION_TYPE"]));
                array_push($csvrow, $eval_data["USERS_ANSWERED"]);
                array_push($csvrow, $eval_data["USERS_SKIPPED"]);
                array_push($csvrow, $eval_data["MODE"]);
                array_push($csvrow, $eval_data["MODE_NR_OF_SELECTIONS"]);
                array_push($csvrow, str_replace("<br />", " ", $eval_data["MEDIAN"])); // #17214
                array_push($csvrow, $eval_data["ARITHMETIC_MEAN"]);
                $result = array();
                array_push($result, $csvrow);
                return $result;
        }

References $result, getQuestiontext(), and getTitle().

Here is the call graph for this function:

setExportCumulatedXLS()

SurveyQuestion::setExportCumulatedXLS	(	&	$worksheet,
		&	$format_title,
		&	$format_bold,
		&	$eval_data,
			$row,
			$export_label
	)

Creates the Excel output for the cumulated results of this question.

Parameters

object	$worksheet	Reference to the excel worksheet
object	$format_title	Excel title format
object	$format_bold	Excel bold format
array	$eval_data	Cumulated evaluation data
integer	$row	Actual row in the worksheet

Returns

integer The next row which should be used for the export @access public

Reimplemented in SurveyMatrixQuestion.

Definition at line 2088 of file class.SurveyQuestion.php.

        {
                include_once ("./Services/Excel/classes/class.ilExcelUtils.php");
                $column = 0;
                switch ($export_label)
                {
                        case 'label_only':
                                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text($this->label));
                                break;
                        case 'title_only':
                                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text($this->getTitle()));
                                break;
                        default:
                                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text($this->getTitle()));
                                $column++;
                                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text($this->label));
                                break;
                }
                $column++;
                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text(strip_tags($this->getQuestiontext()))); // #12942
                $column++;
                $worksheet->writeString($row, $column, ilExcelUtils::_convert_text($this->lng->txt($eval_data["QUESTION_TYPE"])));
                $column++;
                $worksheet->write($row, $column, $eval_data["USERS_ANSWERED"]);
                $column++;
                $worksheet->write($row, $column, $eval_data["USERS_SKIPPED"]);
                $column++;
                $worksheet->write($row, $column, ilExcelUtils::_convert_text($eval_data["MODE_VALUE"]));
                $column++;
                $worksheet->write($row, $column, ilExcelUtils::_convert_text($eval_data["MODE"]));
                $column++;
                $worksheet->write($row, $column, $eval_data["MODE_NR_OF_SELECTIONS"]);
                $column++;
                $worksheet->write($row, $column, ilExcelUtils::_convert_text(str_replace("<br />", " ", $eval_data["MEDIAN"])));
                $column++;
                $worksheet->write($row, $column, $eval_data["ARITHMETIC_MEAN"]);
                return $row + 1;
        }

References $row, ilExcelUtils\_convert_text(), getQuestiontext(), and getTitle().

Here is the call graph for this function:

setExportDetailsXLS()

SurveyQuestion::setExportDetailsXLS	(	&	$workbook,
		&	$format_title,
		&	$format_bold,
		&	$eval_data,
			$export_label
	)

Creates an Excel worksheet for the detailed cumulated results of this question.

Parameters

object	$workbook	Reference to the parent excel workbook
object	$format_title	Excel title format
object	$format_bold	Excel bold format
array	$eval_data	Cumulated evaluation data @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2176 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
        }

setId()

SurveyQuestion::setId

(

$id = -1

)

Sets the id of the SurveyQuestion object.

Parameters

integer

$id

A unique integer value @access public

See also

$id

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

        {
                $this->id = $id;
        }

References $id.

Referenced by createNewQuestion(), SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), SurveyTextQuestion\loadFromDb(), saveToDb(), and syncWithOriginal().

Here is the caller graph for this function:

setMaterial()

SurveyQuestion::setMaterial	(		$material_id = "",
			$is_import = false,
			$material_title = ""
	)

Sets a material link for the question.

Parameters

string	$material_id	An internal link pointing to the material
boolean	$is_import	A boolean indication that the internal link was imported from another ILIAS installation @access public

Definition at line 1488 of file class.SurveyQuestion.php.

        {
                if (strcmp($material_id, "") != 0)
                {
                        $import_id = "";
                        if ($is_import)
                        {
                                $import_id = $material_id;
                                $material_id = $this->_resolveInternalLink($import_id);
                        }
                        if (strcmp($material_title, "") == 0)
                        {
                                if (preg_match("/il__(\w+)_(\d+)/", $material_id, $matches))
                                {
                                        $type = $matches[1];
                                        $target_id = $matches[2];
                                        $material_title = $this->lng->txt("obj_$type") . ": ";
                                        switch ($type)
                                        {
                                                case "lm":
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $target_id, true);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $material_title .= $cont_obj->getTitle();
                                                        break;
                                                case "pg":
                                                        include_once("./Modules/LearningModule/classes/class.ilLMPageObject.php");
                                                        include_once("./Modules/LearningModule/classes/class.ilLMObject.php");
                                                        $lm_id = ilLMObject::_lookupContObjID($target_id);
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $lm_id, FALSE);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $pg_obj =& new ilLMPageObject($cont_obj, $target_id);
                                                        $material_title .= $pg_obj->getTitle();
                                                        break;
                                                case "st":
                                                        include_once("./Modules/LearningModule/classes/class.ilStructureObject.php");
                                                        include_once("./Modules/LearningModule/classes/class.ilLMObject.php");
                                                        $lm_id = ilLMObject::_lookupContObjID($target_id);
                                                        include_once("./Modules/LearningModule/classes/class.ilObjContentObjectGUI.php");
                                                        $cont_obj_gui =& new ilObjContentObjectGUI("", $lm_id, FALSE);
                                                        $cont_obj = $cont_obj_gui->object;
                                                        $st_obj =& new ilStructureObject($cont_obj, $target_id);
                                                        $material_title .= $st_obj->getTitle();
                                                        break;
                                                case "git":
                                                        include_once "./Modules/Glossary/classes/class.ilGlossaryTerm.php";
                                                        $material_title = $this->lng->txt("glossary_term") . ": " . ilGlossaryTerm::_lookGlossaryTerm($target_id);
                                                        break;
                                                case "mob":
                                                        break;
                                        }
                                }
                        }
                        $this->material = array(
                                "internal_link" => $material_id,
                                "import_id" => $import_id,
                                "title" => $material_title
                        );
                }
                $this->saveMaterial();
        }

References $target_id, ilGlossaryTerm\_lookGlossaryTerm(), ilLMObject\_lookupContObjID(), _resolveInternalLink(), and saveMaterial().

Here is the call graph for this function:

setMaterialsfile()

SurveyQuestion::setMaterialsfile	(		$materials_filename,
			$materials_tempfilename = "",
			$materials_name = ""
	)

Sets and uploads the materials uri.

Parameters

stringstringstring

$materials_filename,$materials_tempfilename,$materials

@access public

See also

$materials

Definition at line 350 of file class.SurveyQuestion.php.

        {
                if (!empty($materials_filename))
                {
                        include_once "./Services/Utilities/classes/class.ilUtil.php";
                        $materialspath = $this->getMaterialsPath();
                        if (!file_exists($materialspath))
                        {
                                ilUtil::makeDirParents($materialspath);
                        }
                        if (ilUtil::moveUploadedFile($materials_tempfilename, $materials_filename,
                                $materialspath.$materials_filename))
                        {
                                print "image not uploaded!!!! ";
                        }
                        else
                        {
                                $this->addMaterials($materials_filename, $materials_name);
                        }
                }
        }

References addMaterials(), getMaterialsPath(), ilUtil\makeDirParents(), ilUtil\moveUploadedFile(), and print.

Here is the call graph for this function:

setObjId()

SurveyQuestion::setObjId

(

$obj_id = 0

)

Set the reference id of the container object.

Parameters

integer

$obj_id

The reference id of the container object @access public

See also

$obj_id

Definition at line 607 of file class.SurveyQuestion.php.

        {
                $this->obj_id = $obj_id;
        }

References $obj_id.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setObligatory()

SurveyQuestion::setObligatory

(

$obligatory = 1

)

Sets the obligatory state of the question.

Parameters

integer

$obligatory

1, if the question is obligatory, otherwise 0 @access public

See also

$obligatory

Definition at line 269 of file class.SurveyQuestion.php.

        {
                $this->obligatory = ($obligatory) ? 1 : 0;
        }

References $obligatory.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setOrientation()

SurveyQuestion::setOrientation

(

$orientation = 0

)

Sets the orientation of the question output.

Parameters

integer

$orientation

0 = vertical, 1 = horizontal @access public

See also

$orientation

Definition at line 281 of file class.SurveyQuestion.php.

        {
                $this->orientation = ($orientation) ? $orientation : 0;
        }

References $orientation.

Referenced by SurveyMultipleChoiceQuestion\importAdditionalMetadata(), SurveySingleChoiceQuestion\importAdditionalMetadata(), SurveyMultipleChoiceQuestion\loadFromDb(), and SurveySingleChoiceQuestion\loadFromDb().

Here is the caller graph for this function:

setOriginalId()

SurveyQuestion::setOriginalId

(

$original_id

)

Definition at line 2253 of file class.SurveyQuestion.php.

        {
                $this->original_id = $original_id;
        }

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), SurveyTextQuestion\loadFromDb(), and syncWithOriginal().

Here is the caller graph for this function:

setOwner()

SurveyQuestion::setOwner

(

$owner = ""

)

Sets the creator/owner ID of the SurveyQuestion object.

Parameters

integer

$owner

A numerical ID to identify the owner/creator @access public

See also

$owner

Definition at line 440 of file class.SurveyQuestion.php.

        {
                $this->owner = $owner;
        }

References $owner.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setQuestiontext()

SurveyQuestion::setQuestiontext

(

$questiontext = ""

)

Sets the questiontext of the SurveyQuestion object.

Parameters

string

$questiontext

A string containing the questiontext @access public

See also

$questiontext

Definition at line 428 of file class.SurveyQuestion.php.

        {
                $this->questiontext = $questiontext;
        }

References $questiontext.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

setSubtype()

SurveyQuestion::setSubtype

(

$a_subtype

)

Reimplemented in SurveyMatrixQuestion, and SurveyMetricQuestion.

Definition at line 2278 of file class.SurveyQuestion.php.

        {
                // do nothing
        }

setSurveyId()

SurveyQuestion::setSurveyId

(

$id = -1

)

Sets the survey id of the SurveyQuestion object.

Parameters

integer

$id

A unique integer value @access public

See also

$survey_id

Definition at line 305 of file class.SurveyQuestion.php.

        {
                $this->survey_id = $id;
        }

References $id.

setTitle()

SurveyQuestion::setTitle

(

$title = ""

)

Sets the title string of the SurveyQuestion object.

Parameters

string

$title

A title string to describe the question @access public

See also

$title

Definition at line 257 of file class.SurveyQuestion.php.

        {
                $this->title = $title;
        }

References $title.

Referenced by SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), and SurveyTextQuestion\loadFromDb().

Here is the caller graph for this function:

SurveyQuestion()

SurveyQuestion::SurveyQuestion	(		$title = "",
			$description = "",
			$author = "",
			$questiontext = "",
			$owner = -1
	)

SurveyQuestion constructor The constructor takes possible arguments an creates an instance of the SurveyQuestion object.

Parameters

string	$title	A title string to describe the question
string	$description	A description string to describe the question
string	$author	A string containing the name of the questions author
integer	$owner	A numerical ID to identify the owner/creator @access public

Definition at line 157 of file class.SurveyQuestion.php.

        {
                global $ilias;
                global $lng;
                global $tpl;
 
                $this->ilias =& $ilias;
                $this->lng =& $lng;
                $this->tpl =& $tpl;
                $this->complete = 
                $this->title = $title;
                $this->description = $description;
                $this->questiontext = $questiontext;
                $this->author = $author;
                $this->cumulated = array();
                if (!$this->author) 
                {
                        $this->author = $this->ilias->account->fullname;
                }
                $this->owner = $owner;
                if ($this->owner == -1) 
                {
                        $this->owner = $this->ilias->account->id;
                }
                $this->id = -1;
                $this->survey_id = -1;
                $this->obligatory = 1;
                $this->orientation = 0;
                $this->materials = array();
                $this->material = array();
                $this->arrData = array();
                register_shutdown_function(array(&$this, '_SurveyQuestion'));
        }

References $author, $description, $ilias, $lng, $owner, $questiontext, $title, and $tpl.

Referenced by SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

Here is the caller graph for this function:

syncWithOriginal()

SurveyQuestion::syncWithOriginal

(

)

Reimplemented in SurveyMatrixQuestion.

Definition at line 1280 of file class.SurveyQuestion.php.

        {
                global $ilDB;
                
                if ($this->getOriginalId())
                {
                        $id = $this->getId();
                        $original = $this->getOriginalId();
 
                        $this->setId($this->getOriginalId());
                        $this->setOriginalId(NULL);
                        $this->saveToDb();
 
                        $this->setId($id);
                        $this->setOriginalId($original);
 
                        include_once "./Services/Link/classes/class.ilInternalLink.php";
                        $affectedRows = $ilDB->manipulateF("DELETE FROM svy_material WHERE question_fi = %s",
                                array('integer'),
                                array($this->getOriginalId())
                        );
                        ilInternalLink::_deleteAllLinksOfSource("sqst", $this->original_id);
                        if (strlen($this->material["internal_link"]))
                        {
                                $next_id = $ilDB->nextId('svy_material');
                                $affectedRows = $ilDB->manipulateF("INSERT INTO svy_material (material_id, question_fi, internal_link, import_id, material_title, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
                                        array('integer', 'integer', 'text', 'text', 'text', 'integer'),
                                        array($next_id, $this->getOriginalId(), $this->material["internal_link"], $this->material["import_id"], $this->material["title"], time())
                                );
                                if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $this->material["internal_link"], $matches))
                                {
                                        ilInternalLink::_saveLink("sqst", $this->getOriginalId(), $matches[2], $matches[3], $matches[1]);
                                }
                        }
                }
        }

References $ilDB, ilInternalLink\_deleteAllLinksOfSource(), ilInternalLink\_saveLink(), getId(), getOriginalId(), saveToDb(), setId(), and setOriginalId().

Here is the call graph for this function:

usableForPrecondition()

SurveyQuestion::usableForPrecondition

(

)

Returns if the question is usable for preconditions.

Returns

boolean TRUE if the question is usable for a precondition, FALSE otherwise @access public

Reimplemented in SurveyMatrixQuestion, SurveyMetricQuestion, SurveyMultipleChoiceQuestion, SurveySingleChoiceQuestion, and SurveyTextQuestion.

Definition at line 2187 of file class.SurveyQuestion.php.

        {
                // overwrite in inherited classes
                return FALSE;
        }

Field Documentation

$arrData

SurveyQuestion::$arrData

private

data array containing the question data

Definition at line 145 of file class.SurveyQuestion.php.

$author

SurveyQuestion::$author

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

Referenced by duplicate(), setAuthor(), SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveyQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

$complete

SurveyQuestion::$complete

Definition at line 135 of file class.SurveyQuestion.php.

$cumulated

SurveyQuestion::$cumulated

protected

An array containing the cumulated results of the question for a given survey.

Definition at line 140 of file class.SurveyQuestion.php.

Referenced by calculateCumulatedResults(), SurveyMatrixQuestion\getCumulatedResultData(), getCumulatedResultData(), SurveyMatrixQuestion\getCumulatedResults(), SurveyMetricQuestion\getCumulatedResults(), SurveyMultipleChoiceQuestion\getCumulatedResults(), SurveySingleChoiceQuestion\getCumulatedResults(), SurveyTextQuestion\getCumulatedResults(), and SurveyMatrixQuestion\getCumulatedResultsForRow().

$description

SurveyQuestion::$description

Definition at line 54 of file class.SurveyQuestion.php.

Referenced by setDescription(), SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveyQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

$id

SurveyQuestion::$id

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

Referenced by SurveyMatrixQuestion\_getQuestionDataArray(), SurveyMetricQuestion\_getQuestionDataArray(), SurveyMultipleChoiceQuestion\_getQuestionDataArray(), SurveySingleChoiceQuestion\_getQuestionDataArray(), SurveyTextQuestion\_getQuestionDataArray(), getId(), SurveyMatrixQuestion\importResponses(), SurveyMetricQuestion\importResponses(), SurveyMultipleChoiceQuestion\importResponses(), SurveySingleChoiceQuestion\importResponses(), SurveyTextQuestion\importResponses(), SurveyMatrixQuestion\loadFromDb(), SurveyMetricQuestion\loadFromDb(), SurveyMultipleChoiceQuestion\loadFromDb(), SurveySingleChoiceQuestion\loadFromDb(), SurveyTextQuestion\loadFromDb(), setId(), and setSurveyId().

$ilias

SurveyQuestion::$ilias

Definition at line 111 of file class.SurveyQuestion.php.

Referenced by SurveyQuestion().

$lng

SurveyQuestion::$lng

Definition at line 125 of file class.SurveyQuestion.php.

Referenced by _getQuestionTypeName(), SurveyMultipleChoiceQuestion\getPreconditionOptions(), SurveySingleChoiceQuestion\getPreconditionOptions(), and SurveyQuestion().

$material

SurveyQuestion::$material

Definition at line 134 of file class.SurveyQuestion.php.

Referenced by getMaterial(), SurveyMatrixQuestion\importResponses(), SurveyMultipleChoiceQuestion\importResponses(), SurveySingleChoiceQuestion\importResponses(), QTIMaterialToString(), and saveMaterial().

$materials

SurveyQuestion::$materials

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

$obj_id

SurveyQuestion::$obj_id

Definition at line 90 of file class.SurveyQuestion.php.

Referenced by createNewQuestion(), delete(), getObjId(), and setObjId().

$obligatory

SurveyQuestion::$obligatory

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

Referenced by setObligatory().

$orientation

SurveyQuestion::$orientation

Definition at line 132 of file class.SurveyQuestion.php.

Referenced by getOrientation(), setOrientation(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), and SurveySingleChoiceQuestion\SurveySingleChoiceQuestion().

$owner

SurveyQuestion::$owner

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

Referenced by duplicate(), getOwner(), setOwner(), SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveyQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

$questiontext

SurveyQuestion::$questiontext

Definition at line 97 of file class.SurveyQuestion.php.

Referenced by SurveyMatrixQuestion\getCumulatedResultData(), getCumulatedResultData(), setQuestiontext(), SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveyQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

$survey_id

SurveyQuestion::$survey_id

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

Referenced by calculateCumulatedResults(), SurveyMatrixQuestion\checkUserInput(), SurveyMetricQuestion\checkUserInput(), SurveyMultipleChoiceQuestion\checkUserInput(), SurveySingleChoiceQuestion\checkUserInput(), SurveyTextQuestion\checkUserInput(), SurveyMatrixQuestion\getCumulatedResultData(), SurveyMatrixQuestion\getCumulatedResults(), SurveyMetricQuestion\getCumulatedResults(), SurveyMultipleChoiceQuestion\getCumulatedResults(), SurveySingleChoiceQuestion\getCumulatedResults(), SurveyTextQuestion\getCumulatedResults(), SurveyMatrixQuestion\getCumulatedResultsForRow(), SurveyMatrixQuestion\getNrOfUsersAnswered(), getObligatory(), getSurveyId(), SurveyMatrixQuestion\getUserAnswers(), SurveyMetricQuestion\getUserAnswers(), SurveyMultipleChoiceQuestion\getUserAnswers(), SurveySingleChoiceQuestion\getUserAnswers(), and SurveyTextQuestion\getUserAnswers().

$title

SurveyQuestion::$title

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

Referenced by SurveyMatrixQuestion\addUserSpecificResultsExportTitles(), SurveyMultipleChoiceQuestion\addUserSpecificResultsExportTitles(), addUserSpecificResultsExportTitles(), SurveySingleChoiceQuestion\addUserSpecificResultsExportTitles(), copyObject(), duplicate(), SurveyMatrixQuestion\getPreconditionSelectValue(), SurveyMetricQuestion\getPreconditionSelectValue(), SurveyMultipleChoiceQuestion\getPreconditionSelectValue(), SurveySingleChoiceQuestion\getPreconditionSelectValue(), getTitle(), SurveyMultipleChoiceQuestion\getUserAnswers(), SurveySingleChoiceQuestion\getUserAnswers(), phraseExists(), questionTitleExists(), SurveyMatrixQuestion\savePhrase(), SurveySingleChoiceQuestion\savePhrase(), SurveyMatrixQuestion\setExportDetailsXLS(), SurveyMultipleChoiceQuestion\setExportDetailsXLS(), SurveySingleChoiceQuestion\setExportDetailsXLS(), setTitle(), SurveyMatrixQuestion\SurveyMatrixQuestion(), SurveyMetricQuestion\SurveyMetricQuestion(), SurveyMultipleChoiceQuestion\SurveyMultipleChoiceQuestion(), SurveyQuestion(), SurveySingleChoiceQuestion\SurveySingleChoiceQuestion(), and SurveyTextQuestion\SurveyTextQuestion().

$tpl

SurveyQuestion::$tpl

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

Referenced by SurveyQuestion().

---

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

• Modules/SurveyQuestionPool/classes/class.SurveyQuestion.php