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

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-2019, «1С-Битрикс», 2019
Наверх