GetList

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

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

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

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

Параметр	Описание	С версии
arOrder	Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]). Поле для сортировки может принимать значения: ID - идентификатор попытки; TEST_ID - идентификатор теста; STUDENT_ID - идентификатор студента ; DATE_START - дата начала попытки; DATE_END - дата окончания попытки; STATUS - статус попытки; SCORE - количество баллов; MAX_SCORE - максимальное количество баллов; COMPLETED - тест пройден; QUESTIONS - количество вопросов; USER_NAME - имя студента ; TEST_NAME - название теста. Направление сортировки может принимать значения: asc - по возрастанию; desc - по убыванию; Необязательный. По умолчанию сортируется по убыванию идентификатора попытки.
arFilter	Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения: ID - идентификатор попытки; TEST_ID - идентификатор теста; STUDENT_ID - идентификатор студента; SCORE - количество баллов; MAX_SCORE - максимальное количество баллов; QUESTIONS - количество вопросов; STATUS - статус попытки (B - тестирование началось, D - тест прерван, F - тест закончен.); COMPLETED - тест пройден (Y\|N); DATE_START - дата начала попытки; DATE_END - дата окончания попытки; USER - пользователь (возможны сложные условия по полям пользователя ID, LOGIN, NAME, LAST_NAME); MIN_PERMISSION - минимальный уровень доcтупа. По умолчанию "R". Список прав доступа см. в CCourse::SetPermission. CHECK_PERMISSIONS - проверять уровень доступа. Если установлено значение "N" - права доступа не проверяются. Перед названием фильтруемого поля может указать тип фильтрации: "!" - не равно "<" - меньше "<=" - меньше либо равно ">" - больше ">=" - больше либо равно "значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются.
arSelect	Массив полей записей, которые будут возвращены методом. Значение по умолчанию - пустой массив array() - означает, что будут возвращены все поля основной таблицы запроса.	9.5.2
arNavParams	Массив настроек постраничной навигации.	12.5.1

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

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

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

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

<?
if (CModule::IncludeModule("learning"))
{
	$TEST_ID = 45;
	$res = CTestAttempt::GetList(
		Array("ID" => "ASC"), 
		Array("TEST_ID" => $TEST_ID)
	);

	while ($arAttempt = $res->GetNext())
	{
		echo "Attempt ID:".$arAttempt["ID"]."; Date start: ".$arAttempt["DATE_START"]."; Test name: ".$arAttempt["TEST_NAME"]."<br>";
	}
}

?>

<?

if (CModule::IncludeModule("learning"))
{
	$TEST_ID = 45;
	$STUDENT_ID = 3;

	$res = CTestAttempt::GetList(
		Array("SCORE" => "DESC"), 
		Array("CHECK_PERMISSIONS" => "N", "TEST_ID" => $TEST_ID, "STUDENT_ID" => $STUDENT_ID)
	);

	while ($arAttempt = $res->GetNext())
	{
		echo "Attempt ID:".$arAttempt["ID"]."; Date start: ".$arAttempt["DATE_START"]."; Test name: ".$arAttempt["TEST_NAME"]."<br>";
	}
}

?>