Set
Описание и параметры
mixed CFormField::Set( array fields, mixed field_id = false, string check_rights = "Y" )
Добавляет новый вопрос/поле или обновляет существующий. Возвращает ID обновленного или добавленного вопроса/поля в случае положительного результата, в противном случае - "false". Метод нестатический.
Параметры метода
| Параметр | Описание | С версии |
|---|---|---|
| fields | Массив значений, в качестве ключей массива допустимы:
* - обязательно к заполнению; * - заполняется только для полей веб-формы; ** - заполняется только для вопросов веб-формы. |
|
| field_id | ID обновляемого вопроса/поля. Параметр необязательный. По умолчанию - "false" (добавление нового вопроса/поля). |
|
| check_rights | Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения:
Параметр необязательный. По умолчанию - "Y" (права необходимо проверить). |
|
| update_filter | Необязательный параметр. Значение по умолчанию - "Y". | 8.0.3 |
Смотрите также
Примеры использования
<?
/*************************************************
Добавление вопроса веб-формы
*************************************************/
// создадим массив описывающий изображение
// находящееся в файле на сервере
$arIMAGE = CFile::MakeFileArray($_SERVER["DOCUMENT_ROOT"]."/images/question.gif");
$arIMAGE["MODULE_ID"] = "form";
// формируем массив ответов
$arANSWER = array();
$arANSWER[] = array(
"MESSAGE" => "да", // параметр ANSWER_TEXT
"C_SORT" => 100, // порядок фортировки
"ACTIVE" => "Y", // флаг активности
"FIELD_TYPE" => "radio", // тип ответа
"FIELD_PARAM" => "checked class=\"inputradio\"" // параметры ответа
);
$arANSWER[] = array(
"MESSAGE" => "нет",
"C_SORT" => 200,
"ACTIVE" => "Y",
"FIELD_TYPE" => "radio"
);
// формируем массив полей
$arFields = array(
"FORM_ID" => 4, // ID веб-формы
"ACTIVE" => "Y", // флаг активности
"TITLE" => "Вы женаты/замужем ?", // текст вопроса
"TITLE_TYPE" => "text", // тип текста вопроса
"SID" => "VS_MARRIED", // символьный идентификатор вопроса
"C_SORT" => 400, // порядок сортировки
"ADDITIONAL" => "N", // мы добавляем вопрос веб-формы
"REQUIRED" => "Y", // ответ на данный вопрос обязателен
"IN_RESULTS_TABLE" => "Y", // добавить в HTML таблицу результатов
"IN_EXCEL_TABLE" => "Y", // добавить в Excel таблицу результатов
"FILTER_TITLE" => "Женат/замужем", // подпись к полю фильтра
"RESULTS_TABLE_TITLE" => "Женат/замужем", // заголовок столбца фильтра
"arIMAGE" => $arIMAGE, // изображение вопроса
"arFILTER_ANSWER_TEXT" => array("dropdown"), // тип фильтра по ANSWER_TEXT
"arANSWER" => $arANSWER, // набор ответов
);
// добавим новый вопрос
$NEW_ID = CFormField::Set($arFields);
if ($NEW_ID>0) echo "Добавлен вопрос с ID=".$NEW_ID;
else // ошибка
{
// выводим текст ошибки
global $strError;
echo $strError;
}
?>
<?
/*************************************************
Добавление поля веб-формы
*************************************************/
$arFields = array(
"FORM_ID" => 4
"ACTIVE" => "Y",
"TITLE" => "Рассчитанная стоимость",
"SID" => "VS_PRICE",
"C_SORT" => 1000,
"ADDITIONAL" => "Y",
"IN_RESULTS_TABLE" => "Y",
"IN_EXCEL_TABLE" => "Y",
"FIELD_TYPE" => "text",
"FILTER_TITLE" => "Стоимость",
"RESULTS_TABLE_TITLE" => "Стоимость",
"arFILTER_FIELD" => array("text")
);
// добавим новое поле
$NEW_ID = CFormField::Set($arFields);
if ($NEW_ID>0) echo "Добавлено поле с ID=".$NEW_ID;
else // ошибка
{
// выводим текст ошибки
global $strError;
echo $strError;
}
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025