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

GetList

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

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

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

Параметр Описание
arOrder Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]).
Поле для сортировки может принимать значения:
  • ID - идентификатор вопроса в плане тестирования;
  • ATTEMPT_ID - идентификатор попытки;
  • QUESTION_ID - идентификатор вопроса;
  • POINT - количество баллов;
  • ANSWERED - вопрос отвечен (Y|N);
  • CORRECT - вопрос правильно отвечен (Y|N);
  • QUESTION_NAME - название вопроса;
  • RAND - случайный порядок.
Направление сортировки может принимать значения:
  • asc - по возрастанию;
  • desc - по убыванию;
Необязательный. По умолчанию сортируется по убыванию идентификатора вопроса в плане тестирования.
arFilter Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:
  • ID - идентификатор вопроса в плане тестирования;
  • ATTEMPT_ID - идентификатор попытки;
  • QUESTION_ID - идентификатор вопроса;
  • POINT - количество баллов;
  • RESPONSE - ответ учащегося (можно искать по шаблону [%_]);
  • QUESTION_NAME - название вопроса (можно искать по шаблону [%_]);
  • ANSWERED - вопрос отвечен (Y|N);
  • CORRECT - вопрос правильно отвечен (Y|N).
Перед названием фильтруемого поля может указать тип фильтрации:
  • "!" - не равно
  • "<" - меньше
  • "<=" - меньше либо равно
  • ">" - больше
  • ">=" - больше либо равно

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

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

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

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

См. также

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

<?
if (CModule::IncludeModule("learning"))
{
    $ATTEMPT_ID = 590;
    $res = CTestResult::GetList(
        Array("ID" => "ASC"), 
        Array("ANSWERED" => "N", "ATTEMPT_ID" => $ATTEMPT_ID)
    );

    while ($arQuestionPlan = $res->GetNext())
    {
        echo "Question ID: ".$arQuestionPlan["QUESTION_ID"].
             "; Correct answer: ".$arQuestionPlan["CORRECT"].
             "; Question name:".$arQuestionPlan["QUESTION_NAME"]."<br>"; } } ?>


© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх