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

GetList

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

CDBResult
CStatEventType::GetList(
	string &by = "s_today_counter",
	string &order = "desc",
	array filter = array(),
	bool &is_filtered,
	mixed limit = false
)

Возвращает список типов событий.

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

ПараметрОписание
byПоле для сортировки. Возможные значения:
  • s_id - ID типа события;
  • s_date_last - дата последнего события данного типа;
  • s_date_enter - дата первого события данного типа;
  • s_today_counter - количество событий данного типа за сегодня;
  • s_yesterday_counter - количество событий данного типа за вчера;
  • s_b_yesterday_counter - количество событий данного типа за позавчера;
  • s_total_counter - суммарное количество событий данного типа;
  • s_period_counter - количество событий данного типа за указанный период (filter[DATE1_PERIOD], filter[DATE2_PERIOD]);
  • s_name - название типа события;
  • s_event1 - идентификатор event1 типа события;
  • s_event2 - идентификатор event2 типа события;
  • s_event12 - сортировка по "EVENT1, EVENT2";
  • s_chart - сортировка по "DIAGRAM_DEFAULT desc, TOTAL_COUNTER";
  • s_stat - сортировка по "TODAY_COUNTER desc, YESTERDAY_COUNTER desc, B_YESTERDAY_COUNTER desc, TOTAL_COUNTER desc, PERIOD_COUNTER".
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • ID* - ID типа события;
  • ID_EXACT_MATCH - если значение равно "N", то при фильтрации по ID будет искаться вхождение;
  • EVENT1* - идентификатор event1 типа события;
  • EVENT1_EXACT_MATCH - если значение равно "Y", то при фильтрации по EVENT1 будет искаться точное совпадение;
  • EVENT2* - идентификатор event2 типа события;
  • EVENT2_EXACT_MATCH - если значение равно "Y", то при фильтрации по EVENT2 будет искаться точное совпадение;
  • NAME* - название типа события;
  • NAME_EXACT_MATCH - если значение равно "Y", то при фильтрации по NAME будет искаться точное совпадение;
  • DESCRIPTION* - описание типа события;
  • DESCRIPTION_EXACT_MATCH - если значение равно "Y", то при фильтрации по DESCRIPTION будет искаться точное совпадение;
  • DATE_ENTER_1 - начальное значение интервала для поля "дата первого события данного типа";
  • DATE_ENTER_2 - конечное значение интервала для поля "дата первого события данного типа";
  • DATE_LAST_1 - начальное значение интервала для поля "дата последнего события данного типа";
  • DATE_LAST_2 - конечное значение интервала для поля "дата последнего события данного типа";
  • DATE1_PERIOD - начальное значение значение для произвольного периода;
  • DATE2_PERIOD - конечное значение значение для произвольного периода;
  • COUNTER1 - начальное значение интервала для поля "суммарное количество событий данного типа";
  • COUNTER2 - конечное значение интервала для поля "суммарное количество событий данного типа";
  • ADV_VISIBLE - флаг включать ли статистику по данному типу события в отчет по рекламным кампаниям, возможные значения:
    • Y - включать;
    • N - не включать.
  • DIAGRAM_DEFAULT - флаг включать ли данный тип события в круговую диаграмму и график по умолчанию, возможные значения:
    • Y - включать;
    • N - не включать.
  • KEEP_DAYS1 - начальное значение интервала для поля "количество дней отведенное для хранения событий данного типа";
  • KEEP_DAYS2 - конечное значение интервала для поля "количество дней отведенное для хранения событий данного типа";
  • DYNAMIC_KEEP_DAYS1 - начальное значение интервала для поля "количество дней отведенное для хранения статистики по данному типу события в разрезе по дням";
  • DYNAMIC_KEEP_DAYS2 - конечное значение интервала для поля "количество дней отведенное для хранения статистики по данному типу события в разрезе по дням";
  • MONEY1 - начальное значение интервала для поля "суммарная денежная сумма для данного типа событий";
  • MONEY2 - конечное значение интервала для поля "суммарная денежная сумма для данного типа событий";
  • CURRENCY - трехсимвольный идентификатор валюты для денежной суммы;
  • GROUP - группировка результирующего списка, возможные значения:
    • event1 - группировка по event1;
    • event2 - группировка по event2.
* - допускается сложная логика
is_filteredФлаг отфильтрованности результирующего списка. Если значение равно "true", то список был отфильтрован.
limitМаксимальное число типов событий которые будут выбраны в списке. Если значение равно "false", то кол-во РК будет ограничено в соответствии со значением параметра Максимальное кол-во показываемых записей в таблицах из настроек модуля "Статистика".

Структура возвращаемой записи

В зависимости от установленной группировки, структура возвращаемой записи различная.

  • при группировке по event1 (filter["GROUP"]="event1"):
    Array
    (
    	[EVENT1] => идентификатор event1 типа события
    	[DATE_ENTER] => дата первого события, тип которого имеет данный идентификатор event1
    	[DATE_LAST] => дата последнего события, тип которого имеет данный идентификатор event1
    	[TOTAL_COUNTER] => суммарное количество событий
    	[TODAY_COUNTER] => количество событий за сегодня
    	[YESTERDAY_COUNTER] => количество событий за вчера
    	[B_YESTERDAY_COUNTER] => количество событий за позавчера
    	[PERIOD_COUNTER] => количество событий за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[TOTAL_MONEY] => суммарная денежная сумма
    	[TODAY_MONEY] => денежная сумма за сегодня
    	[YESTERDAY_MONEY] => денежная сумма за вчера
    	[B_YESTERDAY_MONEY] => денежная сумма за позавчера
    	[PERIOD_MONEY] => денежная сумма за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[CURRENCY] => трехсимвольный идентификатор валюты
    )
  • при группировке по event2 (filter["GROUP"]="event2"):
    Array
    (
    	[EVENT2] => идентификатор event2 типа события
    	[DATE_ENTER] => дата первого события, тип которого имеет данный идентификатор event2
    	[DATE_LAST] => дата последнего события, тип которого имеет данный идентификатор event2
    	[TOTAL_COUNTER] => суммарное количество событий
    	[TODAY_COUNTER] => количество событий за сегодня
    	[YESTERDAY_COUNTER] => количество событий за вчера
    	[B_YESTERDAY_COUNTER] => количество событий за позавчера
    	[PERIOD_COUNTER] => количество событий за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[TOTAL_MONEY] => суммарная денежная сумма
    	[TODAY_MONEY] => денежная сумма за сегодня
    	[YESTERDAY_MONEY] => денежная сумма за вчера
    	[B_YESTERDAY_MONEY] => денежная сумма за позавчера
    	[PERIOD_MONEY] => денежная сумма за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[CURRENCY] => трехсимвольный идентификатор валюты
    )
  • когда группировка не установлена:
    Array
    (
    	[ID] => ID типа события
    	[EVENT1] => идентификатор event1 типа события
    	[EVENT2] => идентификатор event2 типа события
    	[DIAGRAM_DEFAULT] => [Y|N] флаг: включать ли данный тип события в круговую диаграмму и график по умолчанию
    	[NAME] => название типа события
    	[EVENT] => event1 / event2, либо название типа события (если оно указано)
    	[DESCRIPTION] => описание типа события
    	[TOTAL_COUNTER] => суммарное количество событий данного типа
    	[TODAY_COUNTER] => количество событий данного типа за сегодня
    	[YESTERDAY_COUNTER] => количество событий данного типа за вчера
    	[B_YESTERDAY_COUNTER] => количество событий данного типа за позавчера
    	[PERIOD_COUNTER] => количество событий данного типа за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[TOTAL_MONEY] => суммарная денежная сумма по данному типу события
    	[TODAY_MONEY] => денежная сумма по данному типу события за сегодня
    	[YESTERDAY_MONEY] => денежная сумма по данному типу события за вчера
    	[B_YESTERDAY_MONEY] => денежная сумма по данному типу события за позавчера
    	[PERIOD_MONEY] => денежная сумма по данному типу события за период времени, указанный в фильтре (filter[DATE1_PERIOD], filter[DATE2_PERIOD])
    	[CURRENCY] => трехсимвольный идентификатор валюты
    )

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

<?
// получим данные только по тем типам событий 
// у которых event1 = "download"
// а также получим дополнительные данные на декабрь 2007 года
$arFilter = array(
	"DATE1_PERIOD" => "01.12.2007",
	"DATE2_PERIOD" => "31.12.2007",
	"EVENT1"       => "download"
);

// получим список записей
$rs = CStatEventType::GetList(
	($by = "s_today_counter"), 
	($order = "desc"), 
	$arFilter, 
	$is_filtered
);

// выведем все записи
while ($ar = $rs->Fetch())
{
	echo "<pre>"; print_r($ar); echo "</pre>";    
}
?>


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

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

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

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

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