В документации (API) Битрикса допущена ошибка в описании метода Add класса CIBlockSection. Вот тут. Поле PICTURE не может быть числом типа Int. Метод требует чтобы в данном свойстве на вход передавалась информация об изображении по структуре и содержанию аналогичная массиву $_FILES. Из-за этого возникают неудобства, связанные с назначением разделу изображения, которое уже добавлен в битрикс (т.е. вам известен числовой код картинки) - нельзя сразу передать номер файла. В данном случае может помочь CFile::MakeFileArray(). Вот пример, того как можно обработать поле с изображением раздела перед его(раздела) добавлением:
$bs = new CIBlockSection;
$arFields = Array(
"ACTIVE" => $ar_fields['ACTIVE'],
"IBLOCK_SECTION_ID" => $ar_fields['IBLOCK_SECTION_ID'],
"IBLOCK_ID" => $to,
"NAME" => $ar_fields['NAME'],
"SORT" => $ar_fields['SORT'],
"DESCRIPTION" => $ar_fields['DESCRIPTION'],
"DESCRIPTION_TYPE" => $ar_fields['DESCRIPTION_TYPE'],
"DATE_CREATE" => $ar_fields['DATE_CREATE'],
"TIMESTAMP_X" => $ar_fields['TIMESTAMP_X'],
"PICTURE" => CFile::MakeFileArray($ar_fields['PICTURE']), // приходится преобразовывать код картинки в массив информации о ней
"CODE" => $ar_fields['CODE'],
"XML_ID" => $ar_fields['XML_ID']
);
$ID_sec = $bs->Add($arFields);
В данном случае, конечно, приходится дублировать изображение, но зато это и спасает от его утери в случае, если элемент/раздел с которым оно связано тоже будет удалено.
Так в чем ошибка? По приведенной Вам ссылке нигде ни сказано, что ключ PICTURE массива входных параметров может содержать ID файла. В примере передается массив из $_FILES. Если же речь о таблице полей раздела - там все верно. Тип поля PICTURE - int.
В данном случае пример помог разобраться, что на самом деле должен передаваться массив, а в описании написано, что это должен быть "Код картинки в таблице файлов." с типом "Int."
Ошибка в том, что поле раздела "PICTURE" должен иметь тип array. Причём массив этот должен иметь вполне определённую структуру. А в документации, в частности в той ссылки, которую Вы указали, сказано: "Код картинки в таблице файлов." типа Int (третья колонка слева). Номер картинки из таблицы файлов и массив, по-моему, вещи разные.
Группы на сайте создаются не только сотрудниками «1С-Битрикс», но и партнерами компании. Поэтому мнения участников групп могут не совпадать с позицией компании «1С-Битрикс».