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

GetList

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

record set
CTicketDictionary::GetList(
	varchar &by,
	varchar &order,
	array arFilter=array(),
	boolean &is_filtered
);

Метод предназначен для получения списка записей справочника. Метод нестатический.

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

ПараметрОписание
by Идентификатор позволяющий задать имя поля для сортировки. Допустимы следующие значения:
  • s_id - по ID
  • s_c_sort - по указанному порядку сортировки
  • s_sid - по символьному коду
  • s_lis - по языку
  • s_name - по имени
  • s_responsible - по ID ответственного
  • s_dropdown - по указанному порядку сортировки и по имени
order Порядок сортировки. Допустимы следующие значения:
  • desc - по убыванию (значение по умолчанию)
  • asc - по возрастанию
arFilter Массив для фильтрации значений. В массиве допустимы следующие индексы:
  • ID - ID записи (допускается сложная логика)
  • SID - символьный код (допускается сложная логика)
  • LID - ID сайта
  • TYPE - тип записи: "C" - категория, "K" - критичность, "S" - статус, "M" - оценка ответов, "F" - часто используемые ответы, "SR" - источник
  • NAME - имя (допускается сложная логика)
  • RESPONSIBLE_ID - ID ответственного
  • RESPONSIBLE - ответственный, поиск осуществляется по ID пользователя, логину, имени, фамилии (допускается сложная логика)
  • DEFAULT - флаг "Выбирать по умолчанию"; "Y" - да, "N" - нет
Необязательный параметр.
is_filtered Переменная возвращающая true в том случае если список результатов отфильтрован по какому либо критерию; либо false в противном случае. С версии 12.0.0 изменен на isFiltered.

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

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

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

<?
$FilterArr = Array(
	"find_id",
	"find_lid",
	"find_type",
	"find_name",
	"find_sid",
	"find_responsible",
	"find_responsible_id",
	"find_default"
);
if (strlen($set_filter)>0) InitFilterEx($FilterArr,"TICKET_DICTIONARY_LIST","set"); else InitFilterEx($FilterArr,"TICKET_DICTIONARY_LIST","get");
if (strlen($del_filter)>0) DelFilterEx($FilterArr,"TICKET_DICTIONARY_LIST");
$arFilter = Array(
	"ID"				=> $find_id,
	"LID"				=> $find_lid,
	"TYPE"				=> $find_type,
	"NAME"				=> $find_name,
	"SID"				=> $find_sid,
	"RESPONSIBLE_ID"	=> $find_responsible_id,
	"RESPONSIBLE"		=> $find_responsible,
	"DEFAULT"			=> $find_default
);
$tdic = CTicketDictionary::GetList($by, $order, $arFilter, $is_filtered);
?>
//получим список статусов для текущего сайта $arFilter = Array(
	"LID" => SITE_ID,
	"TYPE" => "S",
);

//сортировка задется через переменные
$by = "s_c_sort";
$sort = "asc";

//отбор и вывод
$rsStatus = CTicketDictionary::GetList($by, $sort, $arFilter, $is_filtered); while($arRes = $rsStatus->GetNext()) 
{
	echo $arRes["NAME"], "";
}


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

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

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

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

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