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

GetList

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

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

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

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

ПараметрОписание
arOrder Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:
  • ID - идентификатор записи;
  • TEST_ID - идентификатор теста;
  • STUDENT_ID - идентификатор студента ;
  • RESULT - количество баллов;
  • MAX_RESULT - максимальное количество баллов;
  • COMPLETED - тест пройден;
  • USER_NAME - имя студента;
  • TEST_NAME - название теста.
Направление сортировки может принимать значения:
  • asc - по возрастанию;
  • desc - по убыванию;
Необязательный. По умолчанию фильтруется по убыванию идентификатора записи журнала.
arFilter Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:
  • ID - идентификатор записи;
  • TEST_ID - идентификатор теста;
  • STUDENT_ID - идентификатор студента;
  • RESULT - количество баллов;
  • MAX_RESULT - максимальное количество баллов;
  • COMPLETED - тест пройден (Y|N);
  • USER - пользователь (возможны сложные условия по полям пользователя ID, LOGIN, NAME, LAST_NAME);
  • MIN_PERMISSION - минимальный уровень доcтупа. По умолчанию "R". Список прав доступа см. в CCourse::SetPermission.
  • CHECK_PERMISSIONS - проверять уровень доступа. Если установлено значение "N" - права доступа не проверяются.
Перед названием фильтруемого поля можно указать тип фильтрации:
  • "!" - не равно
  • "<" - меньше
  • "<=" - меньше либо равно
  • ">" - больше
  • ">=" - больше либо равно

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

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

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

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

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

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

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

	while ($arGradebook = $res->GetNext())
	{
		echo "Student: ".$arGradebook["USER_NAME"]."; Test name: ".$arGradebook["TEST_NAME"]."; Completed: ".$arGradebook["COMPLETED"]."<br>";
	}
}

?>
<?

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

	$res = CGradebook::GetList(
		Array("ID" => "ASC"), 
		Array("CHECK_PERMISSIONS" => "N", "TEST_ID" => $TEST_ID, "STUDENT_ID" => $STUDENT_ID)
	);

	while ($arGradebook = $res->GetNext())
	{
		echo "Student: ".$arGradebook["USER_NAME"]."; Test name: ".$arGradebook["TEST_NAME"]."; Completed: ".$arGradebook["COMPLETED"]."<br>";
	}

}

?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024