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...

	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.

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

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

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.

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

References $parentObjId, and $parentObjType.

◆ buildBasicQuery()

ilAssQuestionList::buildBasicQuery ( )

private

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

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

Referenced by buildQuery().

Here is the caller graph for this function:

◆ buildQuery()

ilAssQuestionList::buildQuery ( )

private

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

    {
        $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;
    }

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

Referenced by load().

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.

    {
        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.'
            );
        }
    }

References getAnswerStatusActiveId(), and getAnswerStatusFilter().

Referenced by load().

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.

    {
        return $this->answerStatusActiveId;
    }

References $answerStatusActiveId.

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

Here is the caller graph for this function:

◆ getAnswerStatusFilter()

ilAssQuestionList::getAnswerStatusFilter ( )

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

    {
        return $this->answerStatusFilter;
    }

References $answerStatusFilter.

Referenced by checkFilters(), and getAnswerStatusFilterExpressions().

Here is the caller graph for this function:

◆ getAnswerStatusFilterExpressions()

ilAssQuestionList::getAnswerStatusFilterExpressions ( )

private

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

    {
        $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;
    }

References ANSWER_STATUS_FILTER_ALL_NON_CORRECT, ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY, ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY, and getAnswerStatusFilter().

Referenced by getConditionalFilterExpression().

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.

    {
        return $this->availableTaxonomyIds;
    }

References $availableTaxonomyIds.

Referenced by loadTaxonomyAssignmentData().

Here is the caller graph for this function:

◆ getConditionalFilterExpression()

ilAssQuestionList::getConditionalFilterExpression ( )

private

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

    {
        $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 : '';
    }

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

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.

    {
        return $this->excludeQuestionIdsFilter;
    }

References $excludeQuestionIdsFilter.

Referenced by getQuestionIdsFilterExpressions().

Here is the caller graph for this function:

◆ getFieldFilterExpressions()

ilAssQuestionList::getFieldFilterExpressions ( )

private

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

    {
        $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;
    }

Referenced by getConditionalFilterExpression().

Here is the caller graph for this function:

◆ getForcedQuestionIds()

ilAssQuestionList::getForcedQuestionIds ( )

Returns: array

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

    {
        return $this->forcedQuestionIds;
    }

References $forcedQuestionIds.

Referenced by buildQuery().

Here is the caller graph for this function:

◆ getIncludeQuestionIdsFilter()

ilAssQuestionList::getIncludeQuestionIdsFilter ( )

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

    {
        return $this->includeQuestionIdsFilter;
    }

References $includeQuestionIdsFilter.

Referenced by getQuestionIdsFilterExpressions().

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.

    {
        return $this->join_obj_data;
    }

References $join_obj_data.

◆ getParentObjectIdFilterExpression()

ilAssQuestionList::getParentObjectIdFilterExpression ( )

private

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

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

Referenced by getConditionalFilterExpression().

Here is the caller graph for this function:

◆ getParentObjectType()

ilAssQuestionList::getParentObjectType ( )

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

    {
        return $this->parentObjType;
    }

References $parentObjType.

Referenced by getTableJoinExpression().

Here is the caller graph for this function:

◆ getParentObjFilterExpression()

ilAssQuestionList::getParentObjFilterExpression ( )

private

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

    {
        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;
    }

References getParentObjId(), and getParentObjIdsFilter().

Referenced by getConditionalFilterExpression().

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.

    {
        return $this->parentObjId;
    }

References $parentObjId.

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

Here is the caller graph for this function:

◆ getParentObjIdsFilter()

ilAssQuestionList::getParentObjIdsFilter ( )

Returns: array

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

    {
        return $this->parentObjIdsFilter;
    }

References $parentObjIdsFilter.

Referenced by getParentObjFilterExpression().

Here is the caller graph for this function:

◆ getQuestionCompletionStatusFilter()

ilAssQuestionList::getQuestionCompletionStatusFilter ( )

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

    {
        return $this->questionCompletionStatusFilter;
    }

References $questionCompletionStatusFilter.

◆ getQuestionDataArray()

ilAssQuestionList::getQuestionDataArray ( )

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

    {
        return $this->questions;
    }

References $questions.

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

Here is the caller graph for this function:

◆ getQuestionIdsFilterExpressions()

ilAssQuestionList::getQuestionIdsFilterExpressions ( )

private

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

    {
        $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;
    }

References getExcludeQuestionIdsFilter(), and getIncludeQuestionIdsFilter().

Referenced by getConditionalFilterExpression().

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.

    {
        return $this->questionInstanceTypeFilter;
    }

References $questionInstanceTypeFilter.

Referenced by getQuestionInstanceTypeFilterExpression(), and getTableJoinExpression().

Here is the caller graph for this function:

◆ getQuestionInstanceTypeFilterExpression()

ilAssQuestionList::getQuestionInstanceTypeFilterExpression ( )

private

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

    {
        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;
    }

References getQuestionInstanceTypeFilter(), QUESTION_INSTANCE_TYPE_ALL, QUESTION_INSTANCE_TYPE_DUPLICATES, and QUESTION_INSTANCE_TYPE_ORIGINALS.

Referenced by getConditionalFilterExpression().

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.

    {
        $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}
                ";
    }

References getAnswerStatusActiveId().

Here is the call graph for this function:

◆ getTableJoinExpression()

ilAssQuestionList::getTableJoinExpression ( )

private

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

    {
        $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;
    }

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

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.

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

References $parentObjId.

Referenced by getTaxonomyFilterExpressions().

Here is the caller graph for this function:

◆ getTaxonomyFilterExpressions()

ilAssQuestionList::getTaxonomyFilterExpressions ( )

private

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

    {
        $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;
    }

References getTaxItems().

Referenced by getConditionalFilterExpression().

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.

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

References IL_COMP_MODULE.

Referenced by load().

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.

    {
        $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;
        }
    }

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

Here is the call graph for this function:

◆ loadTaxonomyAssignmentData()

ilAssQuestionList::loadTaxonomyAssignmentData	(	$parentObjId,
		$questionId
	)

private

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

    {
        $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;
    }

References $parentObjId, and getAvailableTaxonomyIds().

Referenced by load().

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.

    {
        $this->answerStatusActiveId = $answerStatusActiveId;
    }

References $answerStatusActiveId.

◆ setAnswerStatusFilter()

ilAssQuestionList::setAnswerStatusFilter ( $answerStatusFilter )

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

    {
        $this->answerStatusFilter = $answerStatusFilter;
    }

References $answerStatusFilter.

◆ setAvailableTaxonomyIds()

ilAssQuestionList::setAvailableTaxonomyIds ( $availableTaxonomyIds )

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

    {
        $this->availableTaxonomyIds = $availableTaxonomyIds;
    }

References $availableTaxonomyIds.

◆ setExcludeQuestionIdsFilter()

ilAssQuestionList::setExcludeQuestionIdsFilter ( $excludeQuestionIdsFilter )

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

    {
        $this->excludeQuestionIdsFilter = $excludeQuestionIdsFilter;
    }

References $excludeQuestionIdsFilter.

◆ setForcedQuestionIds()

ilAssQuestionList::setForcedQuestionIds ( $forcedQuestionIds )

Parameters

array $forcedQuestionIds

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

    {
        $this->forcedQuestionIds = $forcedQuestionIds;
    }

References $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.

    {
        $this->parentObjType = $parentObjType;
    }

References $parentObjType.

◆ setParentObjId()

ilAssQuestionList::setParentObjId ( $parentObjId )

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

    {
        $this->parentObjId = $parentObjId;
    }

References $parentObjId.

◆ setParentObjIdsFilter()

ilAssQuestionList::setParentObjIdsFilter ( $parentObjIdsFilter )

Parameters

array $parentObjIdsFilter

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

    {
        $this->parentObjIdsFilter = $parentObjIdsFilter;
    }

References $parentObjIdsFilter.

◆ setQuestionCompletionStatusFilter()

ilAssQuestionList::setQuestionCompletionStatusFilter ( $questionCompletionStatusFilter )

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

    {
        $this->questionCompletionStatusFilter = $questionCompletionStatusFilter;
    }

References $questionCompletionStatusFilter.

◆ setQuestionInstanceTypeFilter()

ilAssQuestionList::setQuestionInstanceTypeFilter ( $questionInstanceTypeFilter )

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

    {
        $this->questionInstanceTypeFilter = $questionInstanceTypeFilter;
    }

References $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(), getAnswerStatusFilterExpressions(), 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 getAnswerStatusFilterExpressions(), and 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 getAnswerStatusFilterExpressions(), and 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(), and getQuestionInstanceTypeFilterExpression().

◆ 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(), getQuestionInstanceTypeFilterExpression(), 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(), ilTestResultsGUI\executeCommand(), ilQuestionPoolSkillAdministrationGUI\executeCommand(), ilTestQuestionBrowserTableGUI\getQuestionInstanceTypeFilter(), getQuestionInstanceTypeFilterExpression(), 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