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

GetDropDown

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

CDBResult
CFormStatus::GetDropDown(
	int form_id,
	array permission = array("MOVE"), 
	int owner_user_id = 0
)

Возвращает список статусов в виде объекта класса CDBResult в формате, пригодном для вывода выпадающего списка одиночного выбора.

Результирующий список будет состоять из статусов указанной веб-формы form_id. Статус будет включен в результирующий список только в том случае, если текущий пользователь обладает хотя бы одним из прав, указанных в параметре permission.

Метод нестатический.

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

Параметр Описание
form_id ID веб-формы.
permission Массив прав, одним из которых должен обладать текущий пользователь. В данном массиве возможны следующие значения:
  • VIEW - право на просмотр;
  • MOVE - право на перевод;
  • EDIT - право на редактирование;
  • DELETE - право на удаление.
Параметр необязательный. По умолчанию - array("MOVE") (право на перевод результатов в соответствующий статус).
owner_user_id Если данный метод используется для построения выпадающего списка доступных статусов конкретного результата, то в данном параметре необходимо указать ID пользователя, создавшего данный результат (владелец результата, поле результата - USER_ID).

Параметр необязательный. По умолчанию - 0.

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

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

<?
$FORM_ID = 4; // ID веб-формы

// получим список всех доступных статусов
// для которых есть право просмотра у текущего пользователя
$rsStatuses = CFormStatus::GetDropdown($FORM_ID, array("VIEW"));

// выведем выпадающий список
echo SelectBox("STATUS_ID", $rsStatuses, "(выберете статус)", htmlspecialchars($STATUS_ID));
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024