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

GetList

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

CDBResult
CBlog::GetList(
 array arOrder = Array("ID"=>"DESC"),
 array arFilter = Array(),
 bool  arGroupBy = false,
 bool  arNavStartParams = false,
 array arSelectFields = Array()
);

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

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

ПараметрОписание
arOrder Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]) Поле для сортировки может принимать значения:
  • ID - идентификатор блога;
  • NAME - название блога;
  • DATE_CREATE - дата создания блога;
  • DATE_UPDATE - дата изменения блога;
  • ACTIVE - активность блога;
  • OWNER_ID - идентификатор владельца блога;
  • URL - адрес блога;
  • GROUP_ID - идентификатор группы блога;
  • GROUP_NAME - название группы блога;
  • GROUP_SITE_ID - идентификатор сайта группы блога;
  • LAST_POST_ID - идентификатор последнего сообщения в блоге;
  • LAST_POST_DATE - дата последнего сообщения в блоге;
  • OWNER_LOGIN - логин владельца блога;
  • OWNER_NAME - имя владельца блога;
  • OWNER_LAST_NAME - фамилия владельца блога;
  • OWNER_EMAIL - электронный адрес владельца блога;
  • BLOG_USER_ALIAS - псевдоним владельца блога;
Необязательный. По умолчанию фильтруется по убыванию идентификатора блога.
arFilter Массив вида array("фильтруемое поле"=>"значение фильтра" [, ...]). Фильтруемое поле может принимать значения:
  • ID - идентификатор блога;
  • NAME - название блога;
  • DATE_CREATE - дата создания блога;
  • DATE_UPDATE - дата изменения блога;
  • ACTIVE - активность блога;
  • OWNER_ID - идентификатор владельца блога;
  • URL - адрес блога;
  • GROUP_ID - идентификатор группы блога;
  • GROUP_NAME - название группы блога;
  • GROUP_SITE_ID - идентификатор сайта группы блога;
  • ENABLE_COMMENTS - включены ли комментарии в блоге;
  • ENABLE_IMG_VERIF - включена ли CAPTCHA для комментариев в блоге;
  • EMAIL_NOTIFY - включено ли уведомление по Email в блоге;
  • ENABLE_RSS - включен ли экспорт в RSS блога;
  • LAST_POST_ID - идентификатор последнего сообщения в блоге;
  • LAST_POST_DATE - дата последнего сообщения в блоге;
  • OWNER_LOGIN - логин владельца блога;
  • OWNER_NAME - имя владельца блога;
  • OWNER_LAST_NAME - фамилия владельца блога;
  • OWNER_EMAIL - электронный адрес владельца блога;
  • BLOG_USER_ALIAS - псевдоним владельца блога;
Перед названием фильтруемого поля может указать тип фильтрации:
  • "!" - не равно
  • "<" - меньше
  • "<=" - меньше либо равно
  • ">" - больше
  • ">=" - больше либо равно

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

Необязательный. По умолчанию записи не фильтруются.
arGroupBy Массив полей, по которым группируются записи. Массив имеет вид:
array("название_поля1",
      "группирующая_функция2" => "название_поля2", ...)
В качестве "название_поляN" может стоять любое поле. В качестве группирующей функции могут стоять:
  • COUNT - подсчет количества;
  • AVG - вычисление среднего значения;
  • MIN - вычисление минимального значения;
  • MAX - вычисление максимального значения;
  • SUM - вычисление суммы.
Если массив пустой, то метод вернет число записей, удовлетворяющих фильтру.

Необязательный. По умолчанию - false - означает, что результат группироваться не будет.
arNavStartParams Массив параметров выборки. Может содержать следующие ключи:
  • "nTopCount" - количество возвращаемых методом записей будет ограничено сверху значением этого ключа
  • любой ключ, принимаемый методом CDBResult::NavQuery в качестве третьего параметра.
Необязательный. По умолчанию - false - означает, что параметров выборки нет.
arSelectFields Массив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы. Если в массиве присутствует значение "*", то будут возвращены все доступные поля.

Необязательный. По умолчанию - пустой массив array() - означает, что будут возвращены все поля основной таблицы запроса.

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

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

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

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

<?
// выберем все активные блоги, привязанные к текущему сайту.
// результат будет отсортирован сначала по дате создания, затем по названию блога
// выберутся только необходимые нам поля: Идентификатор блога, Название блога, Адрес блога,
// Идентификатор владельца блога и Дату создания блога
$SORT = Array("DATE_CREATE" => "DESC", "NAME" => "ASC");
$arFilter = Array(
        "ACTIVE" => "Y",
        "GROUP_SITE_ID" => SITE_ID
    );	
$arSelectedFields = array("ID", "NAME", "DESCRIPTION", "URL", "OWNER_ID", "DATE_CREATE");

$dbBlogs = CBlog::GetList(
        $SORT,
        $arFilter,
        false,
        false,
        $arSelectedFields
    );

while ($arBlog = $dbBlogs->Fetch())
{
    print_r($arBlog);
}
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх