FCIBlockSection::Update

Описание

Метод изменяет переводы раздела с кодом ID. Перед изменением раздела вызываются обработчики события OnBeforeIBlockSectionUpdate из которых можно изменить значения полей или отменить изменение параметров раздела вернув сообщение об ошибке. После изменения раздела вызывается событие OnAfterIBlockSectionUpdate. Нестатический метод.

Параметры

Code Copy code Code copied! 
1
2
3
4
5
6
7

bool FCIBlockSection::Update(
	int ID,
	array arFields,
	bool bResort = true,
	bool bUpdateSearch = true,
	bool bResizePictures = false
);

Параметры

 Параметр  Описание  С версии
ID Идентификатор раздела.  
arFields
 Массив вида Array("поле"=>"значение", ...), содержащий значения полей раздела инфоблоков.
  
bResort
 Флаг, указывающий пересчитывать ли правую и левую границы после изменения (поля LEFT_MARGIN и RIGHT_MARGIN).

Примечание: настоятельно рекомендуется не устанавливать значение false.

Если в перечне обновляемых полей имеются ключи IBLOCK_SECTION_ID, NAME, SORT, ACTIVE, то параметр bResort обязательно должен быть установлен в true. В противном случае необходимо вызывать после серии операций метод CIBlockSection::ReSort.
  
 bUpdateSearch Флаг, указывающий, что раздел должен быть проиндексирован для поиска сразу же после сохранения.
  
 bResizePictures Использовать настройки инфоблока для обработки изображений. По умолчанию настройки не применяются. Если этот параметр имеет значение true, то к полям PICTURE и DETAIL_PICTURE будут применены правила генерации и масштабирования в соответствии с настройками информационного блока.  

Возвращаемое значение

Метод возвращает true если изменение прошло успешно, при возникновении ошибки метод вернет false, а в свойстве LAST_ERROR объекта будет содержаться текст ошибки.⁠.

Пример

Code Copy code Code copied! 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

// Идентификатор раздела, для которого нужно обновить перевод
$ID = 123; // Укажите нужный ID раздела

// Данные для обновления
$arFields = [
    'NAME' => 'New Section Name', // Новое название раздела
    'DESCRIPTION' => 'Updated section description.', // Описание раздела
];

// Создаем объект класса FCIBlockSection
$bs = new FCIBlockSection;

// Обновляем раздел и проверяем результат
if ($bs->Update($ID, $arFields)) {
    echo "Перевод раздела успешно обновлен.";
} else {
    echo "Ошибка при обновлении перевода раздела: " . $bs->LAST_ERROR;
}

Количество показов: 378
Дата изменения: 17.01.2025 06:48:00