Inheritance diagram for ilAssQuestionList:

Collaboration diagram for ilAssQuestionList:

Public Member Functions
	__construct (ilDBInterface $db, ilLanguage $lng, ILIAS\Refinery\Factory $refinery, ilPluginAdmin $pluginAdmin)

	getParentObjId ()

	setParentObjId ($parentObjId)

	getParentObjectType ()

	setParentObjectType ($parentObjType)

	getParentObjIdsFilter ()

	setParentObjIdsFilter ($parentObjIdsFilter)

	setQuestionInstanceTypeFilter ($questionInstanceTypeFilter)

	getQuestionInstanceTypeFilter ()

	setIncludeQuestionIdsFilter ($questionIdsFilter)

	getIncludeQuestionIdsFilter ()

	getExcludeQuestionIdsFilter ()

	setExcludeQuestionIdsFilter ($excludeQuestionIdsFilter)

	getQuestionCompletionStatusFilter ()

	setQuestionCompletionStatusFilter ($questionCompletionStatusFilter)

	addFieldFilter ($fieldName, $fieldValue)

	addTaxonomyFilter ($taxId, $taxNodes, $parentObjId, $parentObjType)

	setAvailableTaxonomyIds ($availableTaxonomyIds)

	getAvailableTaxonomyIds ()

	setAnswerStatusActiveId ($answerStatusActiveId)

	getAnswerStatusActiveId ()

	setAnswerStatusFilter ($answerStatusFilter)

	getAnswerStatusFilter ()

	setJoinObjectData ($a_val)
	Set if object data table should be joined. More...

	getJoinObjectData ()
	Get if object data table should be joined. More...

	setForcedQuestionIds ($forcedQuestionIds)

	getForcedQuestionIds ()

	load ()

	getDataArrayForQuestionId ($questionId)

	getQuestionDataArray ()

	isInList ($questionId)

	getTitle ($a_comp_id, $a_item_type, $a_item_id)
	Get title of an assigned item. More...

Data Fields
const	QUESTION_ANSWER_STATUS_NON_ANSWERED = 'nonAnswered'
	answer status domain for single questions More...

const	QUESTION_ANSWER_STATUS_WRONG_ANSWERED = 'wrongAnswered'

const	QUESTION_ANSWER_STATUS_CORRECT_ANSWERED = 'correctAnswered'

const	ANSWER_STATUS_FILTER_ALL_NON_CORRECT = 'allNonCorrect'
	answer status filter value domain More...

const	ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY = 'nonAnswered'

const	ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY = 'wrongAnswered'

const	QUESTION_INSTANCE_TYPE_ORIGINALS = 'QST_INSTANCE_TYPE_ORIGINALS'

const	QUESTION_INSTANCE_TYPE_DUPLICATES = 'QST_INSTANCE_TYPE_DUPLICATES'

const	QUESTION_INSTANCE_TYPE_ALL = 'QST_INSTANCE_TYPE_ALL'

const	QUESTION_COMPLETION_STATUS_COMPLETE = 'complete'

const	QUESTION_COMPLETION_STATUS_INCOMPLETE = 'incomplete'

const	QUESTION_COMPLETION_STATUS_BOTH = 'complete/incomplete'

Protected Member Functions
	getTaxItems ($parentType, $parentObjId, $taxId, $taxNode)

Protected Attributes
	$db = null

	$refinery

	$join_obj_data = true

	$questions = array()

Private Member Functions
	getParentObjFilterExpression ()

	getFieldFilterExpressions ()

	getTaxonomyFilterExpressions ()

	getQuestionInstanceTypeFilterExpression ()

	getQuestionIdsFilterExpressions ()

	getParentObjectIdFilterExpression ()

	getAnswerStatusFilterExpressions ()

	getTableJoinExpression ()

	getConditionalFilterExpression ()

	getSelectFieldsExpression ()

	buildBasicQuery ()

	buildQuery ()

	loadTaxonomyAssignmentData ($parentObjId, $questionId)

	isActiveQuestionType ($questionData)

	checkFilters ()

Private Attributes
	$lng = null

	$pluginAdmin = null

	$parentObjIdsFilter = array()

	$parentObjId = null

	$parentObjType = 'qpl'

	$availableTaxonomyIds = array()

	$fieldFilters = array()

	$taxFilters = array()

	$taxParentIds = array()

	$taxParentTypes = array()

	$answerStatusActiveId = null

	$forcedQuestionIds = array()

	$answerStatusFilter = null

	$questionInstanceTypeFilter = self::QUESTION_INSTANCE_TYPE_ORIGINALS

	$includeQuestionIdsFilter = null

	$excludeQuestionIdsFilter = null

	$questionCompletionStatusFilter = self::QUESTION_COMPLETION_STATUS_BOTH

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionList::__construct	(	ilDBInterface	$db,
		ilLanguage	$lng,
		ILIAS\Refinery\Factory	$refinery,
		ilPluginAdmin	$pluginAdmin
	)

Definition at line 163 of file class.ilAssQuestionList.php.

References $db, $lng, $pluginAdmin, and $refinery.

       {
         $this->db = $db;
         $this->lng = $lng;
         $this->refinery = $refinery;
         $this->pluginAdmin = $pluginAdmin;
     }

Member Function Documentation

◆ addFieldFilter()

ilAssQuestionList::addFieldFilter	(	$fieldName,
		$fieldValue
	)

Definition at line 251 of file class.ilAssQuestionList.php.

     {
         $this->fieldFilters[$fieldName] = $fieldValue;
     }

◆ addTaxonomyFilter()

ilAssQuestionList::addTaxonomyFilter	(	$taxId,
		$taxNodes,
		$parentObjId,
		$parentObjType
	)

Definition at line 256 of file class.ilAssQuestionList.php.

References $parentObjId, and $parentObjType.

     {
         $this->taxFilters[$taxId] = $taxNodes;
         $this->taxParentIds[$taxId] = $parentObjId;
         $this->taxParentTypes[$taxId] = $parentObjType;
     }

◆ buildBasicQuery()

ilAssQuestionList::buildBasicQuery ( )

private

Definition at line 621 of file class.ilAssQuestionList.php.

Referenced by buildQuery().

     {
         return "
                         {$this->getSelectFieldsExpression()}
 
                         FROM            qpl_questions
 
                         {$this->getTableJoinExpression()}
 
                         WHERE           qpl_questions.tstamp > 0
                 ";
     }

Here is the caller graph for this function:

◆ buildQuery()

ilAssQuestionList::buildQuery ( )

private

Definition at line 634 of file class.ilAssQuestionList.php.

References $query, buildBasicQuery(), and getForcedQuestionIds().

Referenced by load().

     {
         $query = $this->buildBasicQuery() . "
                         {$this->getConditionalFilterExpression()}
                 ";
 
         if (count($this->getForcedQuestionIds())) {
             $query .= "
                                 UNION {$this->buildBasicQuery()}
                                 AND     {$this->db->in('qpl_questions.question_id', $this->getForcedQuestionIds(), false, 'integer')}
                         ";
         }
 
         return $query;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkFilters()

ilAssQuestionList::checkFilters ( )

private

Definition at line 757 of file class.ilAssQuestionList.php.

References getAnswerStatusActiveId(), and getAnswerStatusFilter().

Referenced by load().

     {
         if (strlen($this->getAnswerStatusFilter()) && !$this->getAnswerStatusActiveId()) {
             require_once 'Modules/TestQuestionPool/exceptions/class.ilTestQuestionPoolException.php';
 
             throw new ilTestQuestionPoolException(
                 'No active id given! You cannot use the answer status filter without giving an active id.'
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAnswerStatusActiveId()

ilAssQuestionList::getAnswerStatusActiveId ( )

Definition at line 278 of file class.ilAssQuestionList.php.

References $answerStatusActiveId.

Referenced by checkFilters(), getSelectFieldsExpression(), and getTableJoinExpression().

     {
         return $this->answerStatusActiveId;
     }

Here is the caller graph for this function:

◆ getAnswerStatusFilter()

ilAssQuestionList::getAnswerStatusFilter ( )

Definition at line 288 of file class.ilAssQuestionList.php.

References $answerStatusFilter.

Referenced by checkFilters(), and getAnswerStatusFilterExpressions().

     {
         return $this->answerStatusFilter;
     }

Here is the caller graph for this function:

◆ getAnswerStatusFilterExpressions()

ilAssQuestionList::getAnswerStatusFilterExpressions ( )

private

Definition at line 501 of file class.ilAssQuestionList.php.

References getAnswerStatusFilter().

Referenced by getConditionalFilterExpression().

     {
         $expressions = array();
 
         switch ($this->getAnswerStatusFilter()) {
             case self::ANSWER_STATUS_FILTER_ALL_NON_CORRECT:
 
                 $expressions[] = '
                                         (tst_test_result.question_fi IS NULL OR tst_test_result.points < qpl_questions.points)
                                 ';
                 break;
 
             case self::ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY:
 
                 $expressions[] = 'tst_test_result.question_fi IS NULL';
                 break;
 
             case self::ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY:
 
                 $expressions[] = 'tst_test_result.question_fi IS NOT NULL';
                 $expressions[] = 'tst_test_result.points < qpl_questions.points';
                 break;
         }
 
         return $expressions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAvailableTaxonomyIds()

ilAssQuestionList::getAvailableTaxonomyIds ( )

Definition at line 268 of file class.ilAssQuestionList.php.

References $availableTaxonomyIds.

Referenced by loadTaxonomyAssignmentData().

     {
         return $this->availableTaxonomyIds;
     }

Here is the caller graph for this function:

◆ getConditionalFilterExpression()

ilAssQuestionList::getConditionalFilterExpression ( )

private

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

References getAnswerStatusFilterExpressions(), getFieldFilterExpressions(), getParentObjectIdFilterExpression(), getParentObjFilterExpression(), getQuestionIdsFilterExpressions(), getQuestionInstanceTypeFilterExpression(), and getTaxonomyFilterExpressions().

     {
         $CONDITIONS = array();
 
         if ($this->getQuestionInstanceTypeFilterExpression() !== null) {
             $CONDITIONS[] = $this->getQuestionInstanceTypeFilterExpression();
         }
 
         if ($this->getParentObjFilterExpression() !== null) {
             $CONDITIONS[] = $this->getParentObjFilterExpression();
         }
 
         if ($this->getParentObjectIdFilterExpression() !== null) {
             $CONDITIONS[] = $this->getParentObjectIdFilterExpression();
         }
 
         $CONDITIONS = array_merge(
             $CONDITIONS,
             $this->getQuestionIdsFilterExpressions(),
             $this->getFieldFilterExpressions(),
             $this->getTaxonomyFilterExpressions(),
             $this->getAnswerStatusFilterExpressions()
         );
 
         $CONDITIONS = implode(' AND ', $CONDITIONS);
 
         return strlen($CONDITIONS) ? 'AND ' . $CONDITIONS : '';
     }

Here is the call graph for this function:

◆ getDataArrayForQuestionId()

ilAssQuestionList::getDataArrayForQuestionId ( $questionId )

Definition at line 720 of file class.ilAssQuestionList.php.

     {
         return $this->questions[$questionId];
     }

◆ getExcludeQuestionIdsFilter()

ilAssQuestionList::getExcludeQuestionIdsFilter ( )

Definition at line 231 of file class.ilAssQuestionList.php.

References $excludeQuestionIdsFilter.

Referenced by getQuestionIdsFilterExpressions().

     {
         return $this->excludeQuestionIdsFilter;
     }

Here is the caller graph for this function:

◆ getFieldFilterExpressions()

ilAssQuestionList::getFieldFilterExpressions ( )

private

Definition at line 342 of file class.ilAssQuestionList.php.

Referenced by getConditionalFilterExpression().

     {
         $expressions = array();
 
         foreach ($this->fieldFilters as $fieldName => $fieldValue) {
             switch ($fieldName) {
                 case 'title':
                 case 'description':
                 case 'author':
                 case 'lifecycle':
 
                     $expressions[] = $this->db->like('qpl_questions.' . $fieldName, 'text', "%%$fieldValue%%");
                     break;
 
                 case 'type':
 
                     $expressions[] = "qpl_qst_type.type_tag = {$this->db->quote($fieldValue, 'text')}";
                     break;
 
                 case 'question_id':
                     if ($fieldValue != "" && !is_array($fieldValue)) {
                         $fieldValue = array($fieldValue);
                     }
                     $expressions[] = $this->db->in("qpl_questions.question_id", $fieldValue, false, "integer");
                     break;
 
                 case 'parent_title':
                     if ($this->join_obj_data) {
                         $expressions[] = $this->db->like('object_data.title', 'text', "%%$fieldValue%%");
                     }
                     break;
             }
         }
 
         return $expressions;
     }

Here is the caller graph for this function:

◆ getForcedQuestionIds()

ilAssQuestionList::getForcedQuestionIds ( )

Returns: array

Definition at line 324 of file class.ilAssQuestionList.php.

References $forcedQuestionIds.

Referenced by buildQuery().

     {
         return $this->forcedQuestionIds;
     }

Here is the caller graph for this function:

◆ getIncludeQuestionIdsFilter()

ilAssQuestionList::getIncludeQuestionIdsFilter ( )

Definition at line 226 of file class.ilAssQuestionList.php.

References $includeQuestionIdsFilter.

Referenced by getQuestionIdsFilterExpressions().

     {
         return $this->includeQuestionIdsFilter;
     }

Here is the caller graph for this function:

◆ getJoinObjectData()

ilAssQuestionList::getJoinObjectData ( )

Get if object data table should be joined.

Returns: bool join object_data

Definition at line 308 of file class.ilAssQuestionList.php.

References $join_obj_data.

     {
         return $this->join_obj_data;
     }

◆ getParentObjectIdFilterExpression()

ilAssQuestionList::getParentObjectIdFilterExpression ( )

private

Definition at line 492 of file class.ilAssQuestionList.php.

Referenced by getConditionalFilterExpression().

     {
         if ($this->parentObjId) {
             return "qpl_questions.obj_fi = {$this->db->quote($this->parentObjId, 'integer')}";
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ getParentObjectType()

ilAssQuestionList::getParentObjectType ( )

Definition at line 185 of file class.ilAssQuestionList.php.

References $parentObjType.

Referenced by getTableJoinExpression().

     {
         return $this->parentObjType;
     }

Here is the caller graph for this function:

◆ getParentObjFilterExpression()

ilAssQuestionList::getParentObjFilterExpression ( )

private

Definition at line 329 of file class.ilAssQuestionList.php.

References getParentObjId(), and getParentObjIdsFilter().

Referenced by getConditionalFilterExpression().

     {
         if ($this->getParentObjId()) {
             return 'qpl_questions.obj_fi = ' . $this->db->quote($this->getParentObjId(), 'integer');
         }
 
         if (count($this->getParentObjIdsFilter())) {
             return $this->db->in('qpl_questions.obj_fi', $this->getParentObjIdsFilter(), false, 'integer');
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParentObjId()

ilAssQuestionList::getParentObjId ( )

Definition at line 175 of file class.ilAssQuestionList.php.

References $parentObjId.

Referenced by getParentObjFilterExpression(), and ilTestSkillEvaluation\init().

     {
         return $this->parentObjId;
     }

Here is the caller graph for this function:

◆ getParentObjIdsFilter()

ilAssQuestionList::getParentObjIdsFilter ( )

Returns: array

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

References $parentObjIdsFilter.

Referenced by getParentObjFilterExpression().

     {
         return $this->parentObjIdsFilter;
     }

Here is the caller graph for this function:

◆ getQuestionCompletionStatusFilter()

ilAssQuestionList::getQuestionCompletionStatusFilter ( )

Definition at line 241 of file class.ilAssQuestionList.php.

References $questionCompletionStatusFilter.

     {
         return $this->questionCompletionStatusFilter;
     }

◆ getQuestionDataArray()

ilAssQuestionList::getQuestionDataArray ( )

Definition at line 725 of file class.ilAssQuestionList.php.

References $questions.

Referenced by ilTestDynamicQuestionSet\getQuestionSequenceStructuredByTaxonomy(), ilTestDynamicQuestionSet\getQuestionSequenceStructuredByUpdateDate(), and ilTestSkillEvaluation\initTestQuestionData().

     {
         return $this->questions;
     }

Here is the caller graph for this function:

◆ getQuestionIdsFilterExpressions()

ilAssQuestionList::getQuestionIdsFilterExpressions ( )

private

Definition at line 461 of file class.ilAssQuestionList.php.

References getExcludeQuestionIdsFilter(), and getIncludeQuestionIdsFilter().

Referenced by getConditionalFilterExpression().

     {
         $expressions = array();
 
         if (is_array($this->getIncludeQuestionIdsFilter())) {
             $expressions[] = $this->db->in(
                 'qpl_questions.question_id',
                 $this->getIncludeQuestionIdsFilter(),
                 false,
                 'integer'
             );
         }
 
         if (is_array($this->getExcludeQuestionIdsFilter())) {
             $IN = $this->db->in(
                 'qpl_questions.question_id',
                 $this->getExcludeQuestionIdsFilter(),
                 true,
                 'integer'
             );
 
             if ($IN == ' 1=2 ') {
                 $IN = ' 1=1 ';
             } // required for ILIAS < 5.0
 
             $expressions[] = $IN;
         }
 
         return $expressions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionInstanceTypeFilter()

ilAssQuestionList::getQuestionInstanceTypeFilter ( )

Definition at line 216 of file class.ilAssQuestionList.php.

References $questionInstanceTypeFilter.

Referenced by getQuestionInstanceTypeFilterExpression(), and getTableJoinExpression().

     {
         return $this->questionInstanceTypeFilter;
     }

Here is the caller graph for this function:

◆ getQuestionInstanceTypeFilterExpression()

ilAssQuestionList::getQuestionInstanceTypeFilterExpression ( )

private

Definition at line 446 of file class.ilAssQuestionList.php.

References getQuestionInstanceTypeFilter().

Referenced by getConditionalFilterExpression().

     {
         switch ($this->getQuestionInstanceTypeFilter()) {
             case self::QUESTION_INSTANCE_TYPE_ORIGINALS:
                 return 'qpl_questions.original_id IS NULL';
             case self::QUESTION_INSTANCE_TYPE_DUPLICATES:
                 return 'qpl_questions.original_id IS NOT NULL';
             case self::QUESTION_INSTANCE_TYPE_ALL:
             default:
                 return null;
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSelectFieldsExpression()

ilAssQuestionList::getSelectFieldsExpression ( )

private

Definition at line 590 of file class.ilAssQuestionList.php.

References getAnswerStatusActiveId().

     {
         $selectFields = array(
             'qpl_questions.*',
             'qpl_qst_type.type_tag',
             'qpl_qst_type.plugin',
             'qpl_qst_type.plugin_name',
             'qpl_questions.points max_points'
         );
 
         if ($this->join_obj_data) {
             $selectFields[] = 'object_data.title parent_title';
         }
 
         if ($this->getAnswerStatusActiveId()) {
             $selectFields[] = 'tst_test_result.points reached_points';
             $selectFields[] = "CASE
                                         WHEN tst_test_result.points IS NULL THEN '" . self::QUESTION_ANSWER_STATUS_NON_ANSWERED . "'
                                         WHEN tst_test_result.points < qpl_questions.points THEN '" . self::QUESTION_ANSWER_STATUS_WRONG_ANSWERED . "'
                                         ELSE '" . self::QUESTION_ANSWER_STATUS_CORRECT_ANSWERED . "'
                                 END question_answer_status
                         ";
         }
 
         $selectFields = implode(",\n\t\t\t\t", $selectFields);
 
         return "
                         SELECT          {$selectFields}
                 ";
     }

Here is the call graph for this function:

◆ getTableJoinExpression()

ilAssQuestionList::getTableJoinExpression ( )

private

Definition at line 528 of file class.ilAssQuestionList.php.

References getAnswerStatusActiveId(), getParentObjectType(), and getQuestionInstanceTypeFilter().

     {
         $tableJoin = "
                         INNER JOIN      qpl_qst_type
                         ON                      qpl_qst_type.question_type_id = qpl_questions.question_type_fi
                 ";
 
         if ($this->join_obj_data) {
             $tableJoin .= "
                                 INNER JOIN      object_data
                                 ON                      object_data.obj_id = qpl_questions.obj_fi
                         ";
         }
 
         if ($this->getParentObjectType() === 'tst'
             && $this->getQuestionInstanceTypeFilter() === self::QUESTION_INSTANCE_TYPE_ALL) {
             $tableJoin .= "
                                                         INNER JOIN      tst_test_question tstquest
                         ON                      tstquest.question_fi = qpl_questions.question_id
                         ";
         }
 
         if ($this->getAnswerStatusActiveId()) {
             $tableJoin .= "
                                 LEFT JOIN       tst_test_result
                                 ON                      tst_test_result.question_fi = qpl_questions.question_id
                                 AND                     tst_test_result.active_fi = {$this->db->quote($this->getAnswerStatusActiveId(), 'integer')}
                         ";
         }
 
         return $tableJoin;
     }

Here is the call graph for this function:

◆ getTaxItems()

ilAssQuestionList::getTaxItems	(	$parentType,
		$parentObjId,
		$taxId,
		$taxNode
	)

protected

Parameters

string	$parentType
int	$parentObjId
int	$taxId
int	$taxNode

Returns: array

Definition at line 429 of file class.ilAssQuestionList.php.

References $parentObjId.

Referenced by getTaxonomyFilterExpressions().

     {
         $taxTree = new ilTaxonomyTree($taxId);
 
         $taxNodeAssignment = new ilTaxNodeAssignment(
             $parentType,
             $parentObjId,
             'quest',
             $taxId
         );
 
         $subNodes = $taxTree->getSubTreeIds($taxNode);
         $subNodes[] = $taxNode;
 
         return $taxNodeAssignment->getAssignmentsOfNode($subNodes);
     }

Here is the caller graph for this function:

◆ getTaxonomyFilterExpressions()

ilAssQuestionList::getTaxonomyFilterExpressions ( )

private

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

References getTaxItems().

Referenced by getConditionalFilterExpression().

     {
         $expressions = array();
 
         require_once 'Services/Taxonomy/classes/class.ilTaxonomyTree.php';
         require_once 'Services/Taxonomy/classes/class.ilTaxNodeAssignment.php';
 
         foreach ($this->taxFilters as $taxId => $taxNodes) {
             $questionIds = array();
 
             $forceBypass = true;
 
             foreach ($taxNodes as $taxNode) {
                 $forceBypass = false;
 
                 $taxItemsByTaxParent = $this->getTaxItems(
                     $this->taxParentTypes[$taxId],
                     $this->taxParentIds[$taxId],
                     $taxId,
                     $taxNode
                 );
 
                 $taxItemsByParent = $this->getTaxItems(
                     $this->parentObjType,
                     $this->parentObjId,
                     $taxId,
                     $taxNode
                 );
 
                 $taxItems = array_merge($taxItemsByTaxParent, $taxItemsByParent);
                 foreach ($taxItems as $taxItem) {
                     $questionIds[$taxItem['item_id']] = $taxItem['item_id'];
                 }
             }
 
             if (!$forceBypass) {
                 $expressions[] = $this->db->in('question_id', $questionIds, false, 'integer');
             }
         }
 
         return $expressions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTitle()

ilAssQuestionList::getTitle	(	$a_comp_id,
		$a_item_type,
		$a_item_id
	)

Get title of an assigned item.

(is used from ilObjTaxonomyGUI when item sorting is activated)

Parameters

string	$a_comp_id	('qpl' in our context)
string	$a_item_type	('quest' in our context)
integer	$a_item_id	(questionId in our context)

Implements ilTaxAssignedItemInfo.

Definition at line 744 of file class.ilAssQuestionList.php.

     {
         if ($a_comp_id != 'qpl' || $a_item_type != 'quest' || !(int) $a_item_id) {
             return '';
         }
 
         if (!isset($this->questions[$a_item_id])) {
             return '';
         }
 
         return $this->questions[$a_item_id]['title'];
     }

◆ isActiveQuestionType()

ilAssQuestionList::isActiveQuestionType ( $questionData )

private

Definition at line 707 of file class.ilAssQuestionList.php.

References IL_COMP_MODULE.

Referenced by load().

     {
         if (!isset($questionData['plugin'])) {
             return false;
         }
 
         if (!$questionData['plugin']) {
             return true;
         }
 
         return $this->pluginAdmin->isActive(IL_COMP_MODULE, 'TestQuestionPool', 'qst', $questionData['plugin_name']);
     }

Here is the caller graph for this function:

◆ isInList()

ilAssQuestionList::isInList ( $questionId )

Definition at line 730 of file class.ilAssQuestionList.php.

     {
         return isset($this->questions[$questionId]);
     }

◆ load()

ilAssQuestionList::load ( )

Definition at line 650 of file class.ilAssQuestionList.php.

References $query, $res, buildQuery(), checkFilters(), ilAssQuestionType\completeMissingPluginName(), isActiveQuestionType(), and loadTaxonomyAssignmentData().

     {
         $this->checkFilters();
 
         $tags_trafo = $this->refinery->string()->stripTags();
 
         $query = $this->buildQuery();
 
         $res = $this->db->query($query);
 
         while ($row = $this->db->fetchAssoc($res)) {
             $row = ilAssQuestionType::completeMissingPluginName($row);
 
             if (!$this->isActiveQuestionType($row)) {
                 continue;
             }
 
             $row['title'] = $tags_trafo->transform($row['title'] ?? '&nbsp;');
             $row['description'] = $tags_trafo->transform($row['description'] !== '' && $row['description'] !== null ? $row['description'] : '&nbsp;');
             $row['author'] = $tags_trafo->transform($row['author']);
             $row['taxonomies'] = $this->loadTaxonomyAssignmentData($row['obj_fi'], $row['question_id']);
             $row['ttype'] = $this->lng->txt($row['type_tag']);
 
             $this->questions[ $row['question_id'] ] = $row;
         }
     }

Here is the call graph for this function:

◆ loadTaxonomyAssignmentData()

ilAssQuestionList::loadTaxonomyAssignmentData	(	$parentObjId,
		$questionId
	)

private

Definition at line 677 of file class.ilAssQuestionList.php.

References $parentObjId, and getAvailableTaxonomyIds().

Referenced by load().

     {
         $taxAssignmentData = array();
 
         foreach ($this->getAvailableTaxonomyIds() as $taxId) {
             require_once 'Services/Taxonomy/classes/class.ilTaxonomyTree.php';
             require_once 'Services/Taxonomy/classes/class.ilTaxNodeAssignment.php';
 
             $taxTree = new ilTaxonomyTree($taxId);
 
             $taxAssignment = new ilTaxNodeAssignment('qpl', $parentObjId, 'quest', $taxId);
 
             $assignments = $taxAssignment->getAssignmentsOfItem($questionId);
 
             foreach ($assignments as $assData) {
                 if (!isset($taxAssignmentData[ $assData['tax_id'] ])) {
                     $taxAssignmentData[ $assData['tax_id'] ] = array();
                 }
 
                 $nodeData = $taxTree->getNodeData($assData['node_id']);
 
                 $assData['node_lft'] = $nodeData['lft'];
 
                 $taxAssignmentData[ $assData['tax_id'] ][ $assData['node_id'] ] = $assData;
             }
         }
 
         return $taxAssignmentData;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAnswerStatusActiveId()

ilAssQuestionList::setAnswerStatusActiveId ( $answerStatusActiveId )

Definition at line 273 of file class.ilAssQuestionList.php.

References $answerStatusActiveId.

     {
         $this->answerStatusActiveId = $answerStatusActiveId;
     }

◆ setAnswerStatusFilter()

ilAssQuestionList::setAnswerStatusFilter ( $answerStatusFilter )

Definition at line 283 of file class.ilAssQuestionList.php.

References $answerStatusFilter.

     {
         $this->answerStatusFilter = $answerStatusFilter;
     }

◆ setAvailableTaxonomyIds()

ilAssQuestionList::setAvailableTaxonomyIds ( $availableTaxonomyIds )

Definition at line 263 of file class.ilAssQuestionList.php.

References $availableTaxonomyIds.

     {
         $this->availableTaxonomyIds = $availableTaxonomyIds;
     }

◆ setExcludeQuestionIdsFilter()

ilAssQuestionList::setExcludeQuestionIdsFilter ( $excludeQuestionIdsFilter )

Definition at line 236 of file class.ilAssQuestionList.php.

References $excludeQuestionIdsFilter.

     {
         $this->excludeQuestionIdsFilter = $excludeQuestionIdsFilter;
     }

◆ setForcedQuestionIds()

ilAssQuestionList::setForcedQuestionIds ( $forcedQuestionIds )

Parameters

array $forcedQuestionIds

Definition at line 316 of file class.ilAssQuestionList.php.

References $forcedQuestionIds.

     {
         $this->forcedQuestionIds = $forcedQuestionIds;
     }

◆ setIncludeQuestionIdsFilter()

ilAssQuestionList::setIncludeQuestionIdsFilter ( $questionIdsFilter )

Definition at line 221 of file class.ilAssQuestionList.php.

     {
         $this->includeQuestionIdsFilter = $questionIdsFilter;
     }

◆ setJoinObjectData()

ilAssQuestionList::setJoinObjectData ( $a_val )

Set if object data table should be joined.

Parameters

bool $a_val join object_data

Definition at line 298 of file class.ilAssQuestionList.php.

     {
         $this->join_obj_data = $a_val;
     }

◆ setParentObjectType()

ilAssQuestionList::setParentObjectType ( $parentObjType )

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

References $parentObjType.

     {
         $this->parentObjType = $parentObjType;
     }

◆ setParentObjId()

ilAssQuestionList::setParentObjId ( $parentObjId )

Definition at line 180 of file class.ilAssQuestionList.php.

References $parentObjId.

Referenced by ilTestResultsGUI\executeCommand(), and ilCopySelfAssQuestionTableGUI\getQuestions().

     {
         $this->parentObjId = $parentObjId;
     }

Here is the caller graph for this function:

◆ setParentObjIdsFilter()

ilAssQuestionList::setParentObjIdsFilter ( $parentObjIdsFilter )

Parameters

array $parentObjIdsFilter

Definition at line 206 of file class.ilAssQuestionList.php.

References $parentObjIdsFilter.

Referenced by ilAsqFactory\getQuestionDataArray(), and ilAsqFactory\getQuestionInstances().

     {
         $this->parentObjIdsFilter = $parentObjIdsFilter;
     }

Here is the caller graph for this function:

◆ setQuestionCompletionStatusFilter()

ilAssQuestionList::setQuestionCompletionStatusFilter ( $questionCompletionStatusFilter )

Definition at line 246 of file class.ilAssQuestionList.php.

References $questionCompletionStatusFilter.

     {
         $this->questionCompletionStatusFilter = $questionCompletionStatusFilter;
     }

◆ setQuestionInstanceTypeFilter()

ilAssQuestionList::setQuestionInstanceTypeFilter ( $questionInstanceTypeFilter )

Definition at line 211 of file class.ilAssQuestionList.php.

References $questionInstanceTypeFilter.

     {
         $this->questionInstanceTypeFilter = $questionInstanceTypeFilter;
     }

Field Documentation

◆ $answerStatusActiveId

ilAssQuestionList::$answerStatusActiveId = null

private

Definition at line 107 of file class.ilAssQuestionList.php.

Referenced by getAnswerStatusActiveId(), and setAnswerStatusActiveId().

◆ $answerStatusFilter

ilAssQuestionList::$answerStatusFilter = null

private

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

Referenced by getAnswerStatusFilter(), and setAnswerStatusFilter().

◆ $availableTaxonomyIds

ilAssQuestionList::$availableTaxonomyIds = array()

private

Definition at line 72 of file class.ilAssQuestionList.php.

Referenced by getAvailableTaxonomyIds(), and setAvailableTaxonomyIds().

◆ $db

ilAssQuestionList::$db = null

protected

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

Referenced by __construct().

◆ $excludeQuestionIdsFilter

ilAssQuestionList::$excludeQuestionIdsFilter = null

private

Definition at line 149 of file class.ilAssQuestionList.php.

Referenced by getExcludeQuestionIdsFilter(), and setExcludeQuestionIdsFilter().

◆ $fieldFilters

ilAssQuestionList::$fieldFilters = array()

private

Definition at line 79 of file class.ilAssQuestionList.php.

◆ $forcedQuestionIds

ilAssQuestionList::$forcedQuestionIds = array()

private

Definition at line 112 of file class.ilAssQuestionList.php.

Referenced by getForcedQuestionIds(), and setForcedQuestionIds().

◆ $includeQuestionIdsFilter

ilAssQuestionList::$includeQuestionIdsFilter = null

private

Definition at line 148 of file class.ilAssQuestionList.php.

Referenced by getIncludeQuestionIdsFilter().

◆ $join_obj_data

ilAssQuestionList::$join_obj_data = true

protected

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

Referenced by getJoinObjectData().

◆ $lng

ilAssQuestionList::$lng = null

private

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

Referenced by __construct().

◆ $parentObjId

ilAssQuestionList::$parentObjId = null

private

Definition at line 58 of file class.ilAssQuestionList.php.

Referenced by addTaxonomyFilter(), getParentObjId(), getTaxItems(), loadTaxonomyAssignmentData(), and setParentObjId().

◆ $parentObjIdsFilter

ilAssQuestionList::$parentObjIdsFilter = array()

private

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

Referenced by getParentObjIdsFilter(), and setParentObjIdsFilter().

◆ $parentObjType

ilAssQuestionList::$parentObjType = 'qpl'

private

Definition at line 65 of file class.ilAssQuestionList.php.

Referenced by addTaxonomyFilter(), getParentObjectType(), and setParentObjectType().

◆ $pluginAdmin

ilAssQuestionList::$pluginAdmin = null

private

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

Referenced by __construct().

◆ $questionCompletionStatusFilter

ilAssQuestionList::$questionCompletionStatusFilter = self::QUESTION_COMPLETION_STATUS_BOTH

private

Definition at line 154 of file class.ilAssQuestionList.php.

Referenced by getQuestionCompletionStatusFilter(), and setQuestionCompletionStatusFilter().

◆ $questionInstanceTypeFilter

ilAssQuestionList::$questionInstanceTypeFilter = self::QUESTION_INSTANCE_TYPE_ORIGINALS

private

Definition at line 146 of file class.ilAssQuestionList.php.

Referenced by getQuestionInstanceTypeFilter(), and setQuestionInstanceTypeFilter().

◆ $questions

ilAssQuestionList::$questions = array()

protected

Definition at line 161 of file class.ilAssQuestionList.php.

Referenced by getQuestionDataArray().

◆ $refinery

ilAssQuestionList::$refinery

protected

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

Referenced by __construct().

◆ $taxFilters

ilAssQuestionList::$taxFilters = array()

private

Definition at line 86 of file class.ilAssQuestionList.php.

◆ $taxParentIds

ilAssQuestionList::$taxParentIds = array()

private

Definition at line 93 of file class.ilAssQuestionList.php.

◆ $taxParentTypes

ilAssQuestionList::$taxParentTypes = array()

private

Definition at line 100 of file class.ilAssQuestionList.php.

◆ ANSWER_STATUS_FILTER_ALL_NON_CORRECT

const ilAssQuestionList::ANSWER_STATUS_FILTER_ALL_NON_CORRECT = 'allNonCorrect'

answer status filter value domain

Definition at line 131 of file class.ilAssQuestionList.php.

Referenced by ilTestPlayerDynamicQuestionSetGUI\filterQuestionSelectionCmd(), and ilTestDynamicQuestionSetStatisticTableGUI\initFilter().

◆ ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY

const ilAssQuestionList::ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY = 'nonAnswered'

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

Referenced by ilTestDynamicQuestionSetStatisticTableGUI\initFilter().

◆ ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY

const ilAssQuestionList::ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY = 'wrongAnswered'

Definition at line 133 of file class.ilAssQuestionList.php.

Referenced by ilTestDynamicQuestionSetStatisticTableGUI\initFilter().

◆ QUESTION_ANSWER_STATUS_CORRECT_ANSWERED

const ilAssQuestionList::QUESTION_ANSWER_STATUS_CORRECT_ANSWERED = 'correctAnswered'

Definition at line 126 of file class.ilAssQuestionList.php.

Referenced by ilTestPlayerDynamicQuestionSetGUI\buildQuestionSetAnswerStatisticRowArray().

◆ QUESTION_ANSWER_STATUS_NON_ANSWERED

const ilAssQuestionList::QUESTION_ANSWER_STATUS_NON_ANSWERED = 'nonAnswered'

answer status domain for single questions

Definition at line 124 of file class.ilAssQuestionList.php.

Referenced by ilTestPlayerDynamicQuestionSetGUI\buildQuestionSetAnswerStatisticRowArray().

◆ QUESTION_ANSWER_STATUS_WRONG_ANSWERED

const ilAssQuestionList::QUESTION_ANSWER_STATUS_WRONG_ANSWERED = 'wrongAnswered'

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

Referenced by ilTestPlayerDynamicQuestionSetGUI\buildQuestionSetAnswerStatisticRowArray().

◆ QUESTION_COMPLETION_STATUS_BOTH

const ilAssQuestionList::QUESTION_COMPLETION_STATUS_BOTH = 'complete/incomplete'

Definition at line 153 of file class.ilAssQuestionList.php.

◆ QUESTION_COMPLETION_STATUS_COMPLETE

const ilAssQuestionList::QUESTION_COMPLETION_STATUS_COMPLETE = 'complete'

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

◆ QUESTION_COMPLETION_STATUS_INCOMPLETE

const ilAssQuestionList::QUESTION_COMPLETION_STATUS_INCOMPLETE = 'incomplete'

Definition at line 152 of file class.ilAssQuestionList.php.

◆ QUESTION_INSTANCE_TYPE_ALL

const ilAssQuestionList::QUESTION_INSTANCE_TYPE_ALL = 'QST_INSTANCE_TYPE_ALL'

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

Referenced by ilTestQuestionBrowserTableGUI\getQuestionInstanceTypeFilter().

◆ QUESTION_INSTANCE_TYPE_DUPLICATES

const ilAssQuestionList::QUESTION_INSTANCE_TYPE_DUPLICATES = 'QST_INSTANCE_TYPE_DUPLICATES'

Definition at line 143 of file class.ilAssQuestionList.php.

Referenced by ilTestPlayerFixedQuestionSetGUI\buildTestPassQuestionList(), ilTestPlayerRandomQuestionSetGUI\buildTestPassQuestionList(), ilTestResultsGUI\executeCommand(), ilTestServiceGUI\getFilteredTestResult(), ilLOTestQuestionAdapter\getQuestionData(), and ilTestSkillAdministrationGUI\getRequiredQuestionInstanceTypeFilter().

◆ QUESTION_INSTANCE_TYPE_ORIGINALS

const ilAssQuestionList::QUESTION_INSTANCE_TYPE_ORIGINALS = 'QST_INSTANCE_TYPE_ORIGINALS'

Definition at line 142 of file class.ilAssQuestionList.php.

Referenced by ilTestPlayerDynamicQuestionSetGUI\buildTestPassQuestionList(), ilQuestionPoolSkillAdministrationGUI\executeCommand(), ilTestResultsGUI\executeCommand(), ilTestQuestionBrowserTableGUI\getQuestionInstanceTypeFilter(), and ilTestSkillAdministrationGUI\getRequiredQuestionInstanceTypeFilter().

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

Modules/TestQuestionPool/classes/class.ilAssQuestionList.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addFieldFilter()

◆ addTaxonomyFilter()

◆ buildBasicQuery()

◆ buildQuery()

◆ checkFilters()

◆ getAnswerStatusActiveId()

◆ getAnswerStatusFilter()

◆ getAnswerStatusFilterExpressions()

◆ getAvailableTaxonomyIds()

◆ getConditionalFilterExpression()

◆ getDataArrayForQuestionId()

◆ getExcludeQuestionIdsFilter()

◆ getFieldFilterExpressions()

◆ getForcedQuestionIds()

◆ getIncludeQuestionIdsFilter()

◆ getJoinObjectData()

◆ getParentObjectIdFilterExpression()

◆ getParentObjectType()

◆ getParentObjFilterExpression()

◆ getParentObjId()

◆ getParentObjIdsFilter()

◆ getQuestionCompletionStatusFilter()

◆ getQuestionDataArray()

◆ getQuestionIdsFilterExpressions()

◆ getQuestionInstanceTypeFilter()

◆ getQuestionInstanceTypeFilterExpression()

◆ getSelectFieldsExpression()

◆ getTableJoinExpression()

◆ getTaxItems()

◆ getTaxonomyFilterExpressions()

◆ getTitle()

◆ isActiveQuestionType()

◆ isInList()

◆ load()

◆ loadTaxonomyAssignmentData()

◆ setAnswerStatusActiveId()

◆ setAnswerStatusFilter()

◆ setAvailableTaxonomyIds()

◆ setExcludeQuestionIdsFilter()

◆ setForcedQuestionIds()

◆ setIncludeQuestionIdsFilter()

◆ setJoinObjectData()

◆ setParentObjectType()

◆ setParentObjId()

◆ setParentObjIdsFilter()

◆ setQuestionCompletionStatusFilter()

◆ setQuestionInstanceTypeFilter()

Field Documentation

◆ $answerStatusActiveId

◆ $answerStatusFilter

◆ $availableTaxonomyIds

◆ $db

◆ $excludeQuestionIdsFilter

◆ $fieldFilters

◆ $forcedQuestionIds

◆ $includeQuestionIdsFilter

◆ $join_obj_data

◆ $lng

◆ $parentObjId

◆ $parentObjIdsFilter

◆ $parentObjType

◆ $pluginAdmin

◆ $questionCompletionStatusFilter

◆ $questionInstanceTypeFilter

◆ $questions

◆ $refinery

◆ $taxFilters

◆ $taxParentIds

◆ $taxParentTypes

◆ ANSWER_STATUS_FILTER_ALL_NON_CORRECT