CDBResult
CTestAttempt::GetList(
array arOrder =
Array("ID"=>"DESC"),
array arFilter = 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" -
права доступа не проверяются.
Перед
названием фильтруемого поля может указать тип фильтрации:
- "!"
- не равно
- "<"
- меньше
- "<="
- меньше либо равно
- ">"
- больше
- ">="
- больше либо равно
"значения фильтра" - одиночное значение или массив.
Необязательный. По умолчанию записи не фильтруются.
|
Возвращаемое значение
Возвращается
объект 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>";
}
}
?>
Мой пример.
|