GetList

Описание

CDBResult CUser::GetList(
	mixed &by = "timestamp_x",
	string &order = "desc",
	array filter = array(),
	array arParams=array()
)

Возвращает список пользователей в виде объекта класса CDBResult. Статический метод.

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

Параметры

Параметр Описание С версии

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

id - ID пользователя
active - активность
last_login - дата последней авторизации
login - имя входа Если у вас задача найти пользователя именно по логину, то используйте CUser::GetByLogin. Этот метод ищет точное совпадение с логином.
email - E-Mail адрес
name - имя
ntopcount - параметр постраничной навигации, ограничивающий количество возвращаемых элементов
last_name - фамилия
timestamp_x - дата изменения
date_register - дата регистрации
personal_profession - профессия
personal_www - WWW-страница
personal_icq - номер ICQ
personal_gender - пол ("M" - мужской; "F" - женский)
personal_birthday - день рождения
personal_photo - ID файла-фотографии
personal_phone - номер телефона
personal_fax - номер факса
personal_mobile - номер мобильного
personal_pager - номер пейджера
personal_street - улица
personal_mailbox - почтовый ящик
personal_city - город
personal_state - область / край
personal_zip - почтовый индекс
personal_country - код страны
personal_notes - дополнительные заметки
work_company - наименования компании
work_department - отдел
work_position - должность
work_www - WWW-страница компании
work_phone - рабочий телефон
work_fax - рабочий факс
work_pager - рабочий пейджер
work_street - улица компании
work_mailbox - почтовый ящик компании
work_city - город компании
work_state - область / край компании
work_zip - почтовый индекс компании
work_country - код страны компании
work_profile - направление деятельности компании
work_notes - дополнительные заметки касаемо места работы
admin_notes - комментарий администратора

Начиная с версии ядра 11.0.13 в параметре можно передавать массив вида array("field1"=>"asc", "field2"=>"desc") для множественной сортировки. Значения ключей массива совпадают с перечисленными выше.

оrder

Ссылка на переменную с порядком сортировки, может принимать значения:

asc - по возрастанию
desc - по убыванию

При использовании массива в параметре by данный параметр игнорируется. Значения c nulls не работают, например: desc,nulls.

filter

Массив для фильтрации пользователей. (Типы фильтрации) В массиве допустимы следующие индексы:

¹ID - по ID пользователя
XML_ID - по XML_ID пользователя
TIMESTAMP_1 - дата изменения профайла пользователя "с"
TIMESTAMP_2 - дата изменения профайла пользователя "по"
LAST_LOGIN_1 - дата последнего логина пользователя "с"
LAST_LOGIN_2 - дата последнего логина пользователя "по"
LAST_ACTIVITY - интервал в секундах
ACTIVE - фильтр по активности (Y|N)
¹LOGIN_EQUAL - по имени входа (ищет прямое совпадение с логином)
¹LOGIN - по имени входа (ищет подстроку в логине)
¹NAME - по имени и фамилии
¹EMAIL - по E-Mail адресу
¹COUNTRY_ID - по коду страны, оставлен для обратной совместимости. Сейчас при его использовании производится фильтрация по WORK_COUNTRY.
GROUPS_ID - по группам (массив с кодами групп пользователей)
PERSONAL_BIRTHDAY_1 - день рождения "с"
PERSONAL_BIRTHDAY_2 - день рождения "по"
¹KEYWORDS - по нижеследующим полям профайла помеченных символом - *
¹* PERSONAL_PROFESSION - профессия
¹* PERSONAL_WWW - WWW-страница
¹* PERSONAL_ICQ - номер ICQ
¹* PERSONAL_GENDER - пол ("M" - мужской; "F" - женский)
¹* PERSONAL_PHOTO - ID файла - фотографии (таблица b_file)
¹* PERSONAL_PHONE - номер телефона
¹* PERSONAL_FAX - номер факса
¹* PERSONAL_MOBILE - номер мобильного
¹* PERSONAL_PAGER - номер пейджера
¹* PERSONAL_STREET - улица
¹* PERSONAL_MAILBOX - почтовый ящик
¹* PERSONAL_CITY - город
¹* PERSONAL_STATE - область / край
¹* PERSONAL_ZIP - почтовый индекс
¹* PERSONAL_COUNTRY - код страны (хранится в файлах \bitrix\modules\main\lang\ru\tools.php, \bitrix\modules\main\lang\en\tools.php)
¹* PERSONAL_NOTES - дополнительные заметки
¹* WORK_COMPANY - наименования компании
¹* WORK_DEPARTMENT - отдел
¹* WORK_POSITION - должность
¹* WORK_WWW - WWW-страница компании
¹* WORK_PHONE - рабочий телефон
¹* WORK_FAX - рабочий факс
¹* WORK_PAGER - рабочий пейджер
¹* WORK_STREET - улица компании
¹* WORK_MAILBOX - почтовый ящик компании
¹* WORK_CITY - город компании
¹* WORK_STATE - область / край компании
¹* WORK_ZIP - почтовый индекс компании
¹* WORK_COUNTRY - код страны компании (хранится в файлах \bitrix\modules\main\lang\ru\tools.php, \bitrix\modules\main\lang\en\tools.php)
¹* WORK_PROFILE - направление деятельности компании
¹* WORK_NOTES - дополнительные заметки касаемо места работы
¹* ADMIN_NOTES - комментарий администратора (доступен для просмотра и редактирования только администратору сайта)

¹ - в данных полях допускается сложные условия. Сложные условия для данного поля работают только при указании: ID. При указании !ID и >ID, сложные условия работать не будут.
* - поиск по "KEYWORDS" по сути является поиском по полям отмеченных символом "*"

В фильтре можно использовать и пользовательские поля, типа UF_*.

arParameters

Массив с дополнительными параметрами метода. Может содержать ключи:

SELECT - массив с идентификаторами пользовательских полей для их выборки в результат, например array("UF_TEXT_1", "UF_STRUCTURE"). Для указания выборки всех полей используйте маску: array("UF_*").

NAV_PARAMS - массив с параметрами навигации, может использоваться для ограничения размера выборки. Например: array("nPageSize"=>"20"). При указании NAV_PARAMS строится ограниченный по размеру список результатов, учитывающий номер страницы в постраничной навигации (для mysql выборка производится с указанием limit). С версии ядра 11.0.14 в массиве можно указать параметр "nTopCount" для ограничения выборки по количеству записей.

FIELDS (с версии ядра 11.0.13) - массив с идентификаторами полей для выборки. Если не указан или пустой, то выбираются все поля. Возможные значения:

ID	PERSONAL_WWW	PERSONAL_ZIP	IS_ONLINE
ACTIVE	PERSONAL_ICQ	PERSONAL_COUNTRY	WORK_CITY
LAST_LOGIN	PERSONAL_GENDER	PERSONAL_NOTES	WORK_STATE
LOGIN	PERSONAL_PHOTO	WORK_COMPANY	WORK_ZIP
EMAIL	PERSONAL_PHONE	WORK_DEPARTMENT	WORK_COUNTRY
NAME	PERSONAL_FAX	WORK_POSITION	WORK_PROFILE
LAST_NAME	PERSONAL_MOBILE	WORK_WWW	WORK_NOTES
SECOND_NAME	PERSONAL_PAGER	WORK_PHONE	ADMIN_NOTES
TIMESTAMP_X	PERSONAL_STREET	WORK_FAX	XML_ID
PERSONAL_BIRTHDAY	PERSONAL_MAILBOX	WORK_PAGER	PASSWORD
DATE_REGISTER	PERSONAL_CITY	WORK_STREET	LOGIN_ATTEMPTS
PERSONAL_PROFESSION	PERSONAL_STATE	WORK_MAILBOX	STORED_HASH
CHECKWORD_TIME	EXTERNAL_AUTH_ID	CONFIRM_CODE	TITLE
LAST_ACTIVITY_DATE	AUTO_TIME_ZONE	TIME_ZONE	LID Не рекомендуется устанавливать `'LID' => SITE_ID`. В этом случае в запросе будет `(upper(U.LID) like upper('%s1%')`. Лучше использовать новое ядро: `\Bitrix\Main\UserTable::getList(array("filter"=>array("=LID" => 's1')));` .
CHECKWORD

6.0.2

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

<?
$filter = Array
(
	"ID"                  => "1 | 2",
	"TIMESTAMP_1"         => "04.02.2004", // в формате текущего сайта
	"TIMESTAMP_2"         => "04.02.2005",
	"LAST_LOGIN_1"        => "01.02.2004",
	"ACTIVE"              => "Y",
	"LOGIN"               => "nessy | admin",
	"NAME"                 => "Виталий & Соколов",
	"EMAIL"               => "mail@server.com | mail@server.com",
	"KEYWORDS"            => "www.bitrix.ru",
	"PERSONAL_PROFESSION" => "системотехник",
	"PERSONAL_GENDER"     => "M",
	"PERSONAL_COUNTRY"    => "4 | 1", // Беларусь или Россия
	"ADMIN_NOTES"         => "\"UID = 145\"",
	"GROUPS_ID"           => Array(1,4,10)
);
$rsUsers = CUser::GetList(($by="personal_country"), ($order="desc"), $filter); // выбираем пользователей
$is_filtered = $rsUsers->is_filtered; // отфильтрована ли выборка ?
$rsUsers->NavStart(50); // разбиваем постранично по 50 записей
echo $rsUsers->NavPrint(GetMessage("PAGES")); // печатаем постраничную навигацию
while($rsUsers->NavNext(true, "f_")) :
	echo "[".$f_ID."] (".$f_LOGIN.") ".$f_NAME." ".$f_LAST_NAME."<br>";	
endwhile;
?>

Пример нерабочего вызова, так как оба параметра передаются по значению:

$rsUsers = CUser::GetList(array('sort' => 'asc'), 'sort');

Пример рабочего вызова:

$order = array('sort' => 'asc');
$tmp = 'sort'; // параметр проигнорируется методом, но обязан быть
$rsUsers = CUser::GetList($order, $tmp);

Для фильтрации пользователей с незаполненным полем Город (для других текстовых полей - аналогично):

$filter = array("PERSONAL_CITY" => " ~_% ");