GetList

Описание и параметры

CDBResult
CTestResult::GetList(
	array arOrder = Array("ID"=>"DESC"),
	array arFilter = Array()
);

Возвращает список вопросов плана тестирования по фильтру arFilter, отсортированный в порядке arOrder. Метод нестатический.

Параметры метода

Параметр	Описание
arOrder	Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]). Поле для сортировки может принимать значения: ID - идентификатор вопроса в плане тестирования; ATTEMPT_ID - идентификатор попытки; QUESTION_ID - идентификатор вопроса; POINT - количество баллов; ANSWERED - вопрос отвечен (Y\|N); CORRECT - вопрос правильно отвечен (Y\|N); QUESTION_NAME - название вопроса; RAND - случайный порядок. Направление сортировки может принимать значения: asc - по возрастанию; desc - по убыванию; Необязательный. По умолчанию сортируется по убыванию идентификатора вопроса в плане тестирования.
arFilter	Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения: ID - идентификатор вопроса в плане тестирования; ATTEMPT_ID - идентификатор попытки; QUESTION_ID - идентификатор вопроса; POINT - количество баллов; RESPONSE - ответ учащегося (можно искать по шаблону [%_]); QUESTION_NAME - название вопроса (можно искать по шаблону [%_]); ANSWERED - вопрос отвечен (Y\|N); CORRECT - вопрос правильно отвечен (Y\|N). Перед названием фильтруемого поля может указать тип фильтрации: "!" - не равно "<" - меньше "<=" - меньше либо равно ">" - больше ">=" - больше либо равно "значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются.

Параметр

Описание

arOrder

Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:

ID - идентификатор вопроса в плане тестирования;
ATTEMPT_ID - идентификатор попытки;
QUESTION_ID - идентификатор вопроса;
POINT - количество баллов;
ANSWERED - вопрос отвечен (Y|N);
CORRECT - вопрос правильно отвечен (Y|N);
QUESTION_NAME - название вопроса;
RAND - случайный порядок.

Направление сортировки может принимать значения:

asc - по возрастанию;
desc - по убыванию;

Необязательный. По умолчанию сортируется по убыванию идентификатора вопроса в плане тестирования.

arFilter

Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:

ID - идентификатор вопроса в плане тестирования;
ATTEMPT_ID - идентификатор попытки;
QUESTION_ID - идентификатор вопроса;
POINT - количество баллов;
RESPONSE - ответ учащегося (можно искать по шаблону [%_]);
QUESTION_NAME - название вопроса (можно искать по шаблону [%_]);
ANSWERED - вопрос отвечен (Y|N);
CORRECT - вопрос правильно отвечен (Y|N).

Перед названием фильтруемого поля может указать тип фильтрации:

"!" - не равно
"<" - меньше
"<=" - меньше либо равно
">" - больше
">=" - больше либо равно

"значения фильтра" - одиночное значение или массив.

Необязательный. По умолчанию записи не фильтруются.

Возвращаемое значение

Возвращается объект CDBResult.

Смотрите также

Примеры использования

<?
if (CModule::IncludeModule("learning"))
{
	$ATTEMPT_ID = 590;
	$res = CTestResult::GetList(
		Array("ID" => "ASC"), 
		Array("ANSWERED" => "N", "ATTEMPT_ID" => $ATTEMPT_ID)
	);

	while ($arQuestionPlan = $res->GetNext())
	{
		echo "Question ID: ".$arQuestionPlan["QUESTION_ID"].
             "; Correct answer: ".$arQuestionPlan["CORRECT"].
             "; Question name:".$arQuestionPlan["QUESTION_NAME"]."<br>";
	}
}
?>