GetList
170 / 177
Описание:



Возвращает список результатов голосования по фильтру arFilter.

Параметры функции:

Параметры Описание
arOrderМассив вида Array(by1=>order1[, by2=>order2 [, ..]])

by - поле для сортировки, может принимать значения:
  • id - (целое число) ID результата голосования;
  • element_id - (целое число) ID элемента инфоблока, за который голосуют;
  • answer - (целое число) оценка, которую поставил пользователь;
  • ip - (строка) IP-адрес пользователя;
  • user_id - (целое число) ID пользователя;
  • date_vote - (дата) время, когда пользователь проголосовал;
  • stat_session_id - (целое число) ID сессии пользователя. Автоматически заполняется при вызове функции Add, имеет смысл только если установлен модуль веб-аналитика.
order - порядок сортировки, может принимать значения:
  • asc - по возрастанию;
  • desc - по убыванию.
Регистр букв не важен: 
 
array("ID" => "ASC") или array("id" => "asc")

arFilter Массив вида array("фильтруемое поле"=>"значения фильтра" [, ...]). "фильтруемое поле" может принимать значения:

  • ID - по ID результата голосования;
  • ELEMENT_ID - по ID элемента инфоблока, за который голосуют;
  • ANSWER - по оценке, которую поставил пользователь;
  • IP - по IP-адресу пользователя;
  • USER_ID - по ID пользователя;
  • DATE_VOTE - по дате, когда пользователь проголосовал;
  • STAT_SESSION_ID - по ID сессии пользователя из модуля веб-аналитика.
Перед названием фильтруемого поля можно указать тип проверки фильтра:
  • "=" - равно
  • "<" - меньше
  • "<=" - меньше либо равно
  • ">" - больше
  • ">=" - больше либо равно
Тип проверки указывать необязательно. По-умолчанию "=".

arGroupByМассив полей для группировки элемента. Если поля указаны, то выборка по ним группируется, а в результат добавляется поле CNT - количество сгруппированных элементов. Если указать в качестве arGroupBy пустой массив, то функция вернет количество элементов CNT по фильтру.

Необязательное. По умолчанию false - записи не группируются.



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

Метод возвращает объект CDBResult (на сайте 1С-Битрикс описание класса, ссылка откроется в новом окне).

В том случае, если параметр arGroupBy пустой массив, то функция вернет целое число.

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





0  


 GetByID | Описание курса | Update