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

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-2021, «1С-Битрикс», 2021
Наверх