Add
Описание и параметры
mixed CFormResult::Add( int form_id, array values = false, string check_rights = "Y", int user_id = false )
Создает новый результат веб-формы. В случае успеха - возвращает ID нового результата, в противном случае - "false". Метод нестатический.
Данный метод не создает почтовое событие, связанное с формой. Для этого нужно использовать CFormResult::Mail.
Примечание: в случае неактивных вопросов данные из формы в них не сохраняются и сообщения об ошибках не выводятся.
Параметры метода
| Параметр | Описание |
|---|---|
| form_id | ID веб-формы. |
| values | Массив со значениями ответов. Массив имеет следующую структуру:
array( "имя HTML поля ответа 1" => "значение ответа 1", "имя HTML поля ответа 2" => "значение ответа 2", ... "имя HTML поля ответа N" => "значение ответа N" )Правила формирования "имен HTML полей ответов" и "значений ответов" описаны в разделе "Имена HTML полей веб-форм". Пример:Array ( [form_text_586] => Иванов Иван Иванович [form_date_587] => 10.03.1992 [form_textarea_588] => г. Мурманск [form_radio_VS_MARRIED] => 589 [form_checkbox_VS_INTEREST] => Array ( [0] => 592 [1] => 593 [2] => 594 ) [form_dropdown_VS_AGE] => 597 [form_multiselect_VS_EDUCATION] => Array ( [0] => 603 [1] => 604 ) [form_text_606] => 2345 [form_image_607] => 1045 )Параметр необязательный. По умолчанию - "false" (будет взят стандартный массив $_REQUEST). |
| check_rights | Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения:
Параметр необязательный. По умолчанию - "Y" (права необходимо проверить). |
| user_id | ID пользователя, который будет записан как создатель данного результата. Параметр необязательный. По умолчанию - "false" (будет взят ID текущего пользователя). |
Смотрите также
Примеры использования
<?
// ID веб-формы
$FORM_ID = 4;
// массив описывающий загруженную на сервер фотографию
$arImage = CFile::MakeFileArray($_SERVER["DOCUMENT_ROOT"]."/images/photo.gif");
// массив значений ответов
$arValues = array (
"form_text_586" => "Иванов Иван", // "Фамилия, имя, отчество"
"form_date_587" => "01.06.1904", // "Дата рождения"
"form_textarea_588" => "г. Москва", // "Адрес"
"form_radio_VS_MARRIED" => 590, // "Женаты/замужем?"
"form_checkbox_VS_INTEREST" => array(612, 613), // "Увлечения"
"form_dropdown_VS_AGE" => 601, // "Возраст"
"form_multiselect_VS_EDUCATION" => array(602, 603), // "Образование"
"form_text_606" => 300, // "Доход"
"form_image_607" => $arImage // "Фотография"
);
// создадим новый результат
if ($RESULT_ID = CFormResult::Add($FORM_ID, $arValues))
{
echo "Результат #".$RESULT_ID." успешно создан";
}
else
{
global $strError;
echo $strError;
}
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025