Способы обновления элементов инфоблока через PHP API Bitrix

Расширенные примеры редактирования элемента инфоблока

Пример 1: Обновление с привязкой к разделу и обработка ошибок

$el = new CIBlockElement;
$id = 123;
$fields = [
  'IBLOCK_ID' => 2,
  'IBLOCK_SECTION_ID' => 15,
  'NAME' => 'Обновлённый элемент',
  'ACTIVE' => 'Y',
  'SORT' => 100,
  'PREVIEW_TEXT' => 'Текст анонса',
  'DETAIL_TEXT' => 'Детальное описание',
];

if($el->Update($id, $fields)) {
  echo "Обновление успешно. ID: $id";
} else {
  echo "Ошибка: " . $el->LAST_ERROR;
  // Пример: "IBLOCK_ID is required" или "Element not found"
}

Результат (при успехе):
Обновление успешно. ID: 123

Результат (при ошибке):
Ошибка: Element not found

Пояснение:

Обновляются основные поля элемента. Важно указывать IBLOCK_ID. Если элемент не найден, LAST_ERROR содержит сообщение. При отсутствии прав - ошибка прав доступа.

Пример 2: Редактирование множественного свойства (список)

$el = new CIBlockElement;
$id = 123;
$fields = [
  'IBLOCK_ID' => 2,
  'PROPERTY_VALUES' => [
    'BRAND' => ['Nike', 'Adidas'],  // множественное свойство типа список
    'IMAGE' => [
      'n0' => ['VALUE' => '/upload/new_image.jpg', 'DESCRIPTION' => 'Основное'],
      'n1' => ['VALUE' => '/upload/second.jpg', 'DESCRIPTION' => 'Дополнительное'],
    ],
  ],
];
$el->Update($id, $fields);

Результат: элемент обновлён, свойства привязаны. Для файловых свойств испольуется массив с ключами n0, n1 и т.д.

Пояснение:

Множественные свойства требуют массив значений. Для типа «Файл» необходимо передавать полный путь к файлу на сервере или массив с идентификатором из CFile::MakeFileArray. Если не указывать ключи n0, n1, можно просто [['VALUE' => ...], ...].

Пример 3: Массовое обновление элементов через агент с использованием D7

\Bitrix\Main\Loader::includeModule('iblock');

class MassUpdateAgent {
  public static function updateElements($iblockId, $newStatus) {
    $elements = \Bitrix\Iblock\ElementTable::getList([
      'filter' => ['IBLOCK_ID' => $iblockId, 'ACTIVE' => 'N'],
      'select' => ['ID', 'NAME'],
    ]);

    while ($element = $elements->fetch()) {
      $result = \Bitrix\Iblock\ElementTable::update($element['ID'], [
        'ACTIVE' => $newStatus,
      ]);
      if (!$result->isSuccess()) {
        AddMessage2Log('Ошибка обновления элемента '. $element['ID']);
      }
    }

    return "MassUpdateAgent::updateElements($iblockId, '$newStatus');";
  }
}

// Регистрация агента
\Bitrix\Main\Application::getConnection()->queryExecute(
  "INSERT INTO b_agent (NAME, MODULE_ID, ACTIVE, AGENT_INTERVAL) 
   VALUES ('MassUpdateAgent::updateElements(2, \"Y\");', '', 'Y', 86400)"
);

Результат: агент выполняется раз в сутки, обновляет все неактивные элементы инфоблока 2, устанавливая активность = Y.

Пояснение:

Агент возвращает строку с вызовом самого себя для повторного выполнения. Внутри используется ORM для обновления. Массовая операция не вызывает событий по каждому элементу, поэтому может быть быстрее. Для обновления свойств потребуется дополнительный вызов CIBlockElement::SetPropertyValues.

Пример 4: Редактирование с транзакцией и откатом при ошибке

$connection = \Bitrix\Main\Application::getConnection();
$connection->startTransaction();

try {
  $el = new CIBlockElement;
  $id = 123;
  $fields = ['IBLOCK_ID' => 2, 'NAME' => 'Новое имя'];
  if (!$el->Update($id, $fields)) {
    throw new \Exception($el->LAST_ERROR);
  }

  // Обновление свойства
  CIBlockElement::SetPropertyValues($id, 2, ['COLOR' => 'синий']);

  $connection->commitTransaction();
  echo "Успешно";
} catch (\Exception $e) {
  $connection->rollbackTransaction();
  echo "Откат: " . $e->getMessage();
}

Результат при ошибке: Откат: Element not found
Результат при успехе: Успешно

Пояснение:

Транзакция позволяет откатить все изменения, если одно из них не выполнилось. Важно, что CIBlockElement::Update использует отдельное соединение? В D7 по умолчанию транзакции на уровне подключения. В некоторых случаях метод Update может коммитить внутренние транзакции, поэтому проверка на практике обязательна. Альтернатива - обновление через ORM в одной транзакции.

Пример 5: Использование PreUpdateEvent для логирования

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
  'iblock',
  'OnBeforeIBlockElementUpdate',
  function(\Bitrix\Main\Event $event) {
    $params = $event->getParameters();
    $fields = $params['FIELDS'];
    $id = $params['ID'];
    \Bitrix\Main\Diag\Debug::writeToFile(
      "Элемент $id изменён: ". print_r($fields, true),
      'update_log'
    );
  }
);

Результат: в файле /upload/debug.log появляется запись с переданными полями.

Пояснение:

Обработчик не влияет на данные, только логирует. Полезно для отладки при массовых обновлениях. Для предотвращения логирования одинаковых вызовов можно проверять флаг сессии.