Документация для разработчиков
Темная тема

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

?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх