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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.