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

Update

Описание и параметры

bool
CFormResult::Update(
	int result_id,
	array values = false,
	string update_fields = "N",
	string check_rights = "Y"
)

Обновляет все значения ответов и полей результата веб-формы. В случае успеха возвращает "true", в противном случае - "false". Метод нестатический.

Параметры метода

Параметр Описание
result_id ID результата.
values Массив со значениями ответов и полей веб-формы. Массив имеет следующую структуру:
array(
	"имя HTML поля 1" => "значение 1",
	"имя HTML поля 2" => "значение 2",
	...
	"имя HTML поля N" => "значение N"
)
Правила формирования "имен 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
	[form_textarea_ADDITIONAL_149] => 155
)
Параметр необязательный. По умолчанию - "false" (будет взят стандартный массив $_REQUEST).
update_fiels Флаг необходимости обновления полей веб-формы. Возможны следующие значения:
  • Y - необходимо обновить;
  • N - не нужно обновлять.
Параметр необязательный. По умолчанию - "N" (не нужно обновлять).
check_rights Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения:
  • Y - права необходимо проверить;
  • N - права не нужно проверять.
Для успешного обновления результата необходимо обладать следующими правами:
  1. На веб-форму, к которой принадлежит редактируемый результат:

    [20] Работа со всеми результатами в соответствии с их статусами

    или, в случае, если вы являетесь создателем редактируемого результата, достаточно права:

    [15] Работа со своим результатом в соответствии с его статусом
  2. На статус, в котором находится редактируемый результат, необходимо иметь право:

    [EDIT] редактирование
Параметр необязательный. По умолчанию - "Y" (права необходимо проверить).

Примеры использования

<?
// ID результата
$RESULT_ID = 186;

// массив описывающий загруженную на сервер фотографию
$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,         // "Фотография"
	"form_textarea_ADDITIONAL_149"  => "155 рублей"      // "Рассчитанная сумма"
)

//обновим результат
if (CFormResult::Update($RESULT_ID, $arValues, "Y"))
{
	echo "Результат #".$RESULT_ID." успешно обновлен.";
}
else
{
	global $strError;
	echo $strError;
}
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
2
Антон Долганин
Как изменить только один ответ в результате
http://dev.1c-bitrix.ru/community/webdev/user/11948/blog/6212/  
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх