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-2024, «1С-Битрикс», 2024