Массовое создание свойств инфоблока в Bitrix (api)

🤯 Проблема: Рутинное добавление множества характеристик

При работе с каталогами товаров или сложными инфоблоками часто возникает необходимость добавить сразу двадцать-тридцать и более однотипных свойств (характеристик) — например, технических параметров оборудования: «Напряжение В», «Расход топлива», «Габаритные размеры».

Ручное создание каждого свойства в административной панели Bitrix — это:

1. Монотонный процесс.
2. Высокий риск ошибки (опечатки в названии или, что хуже, в символьном коде).
3. Огромная трата времени.

🛠️ Решение: PHP-скрипт для быстрого создания свойств (CIBlockProperty)

Представленный скрипт — это мощный инструмент, который автоматизирует всю эту рутину. Он использует стандартный API Bitrix (класс CIBlockProperty) для программного создания свойств, гарантируя, что все они будут добавлены по единому, корректному шаблону.

🎯 Как работает скрипт?

Скрипт состоит из нескольких логических блоков:

1. ⚙️ Блок настройки и транслитерации

В начале скрипта задается ID целевого инфоблока (в вашем случае, $iblockId = 13;) и массив $properties, содержащий русскоязычные названия будущих свойств.

Ключевая особенность — функция transliterate($string). Она преобразует русское название свойства (например, «Теплопроизводительность max кВт») в корректный символьный код (TEPLOPROIZVODITELNOST_MAX_KV), который необходим для работы Bitrix и сторонних систем. Код обрезается до максимальной длины в 24 символа и приводится к верхнему регистру, что соответствует стандартам платформы.

2. 🛡️ Блок проверки уникальности кода

Символьный код свойства должен быть уникальным в пределах одного инфоблока. Скрипт решает эту задачу в два этапа:

• Получение существующих кодов: Функция getExistingPropertyCodes перед началом работы запрашивает все коды уже существующих свойств инфоблока.
• Генерация уникального кода: Функция generateUniqueCode берет транслитерированное имя и проверяет его на совпадение с существующими. Если код занят, она автоматически добавляет к нему счетчик (например, MODEL_1, MODEL_2), обеспечивая уникальность.

3. 💾 Блок создания свойств

Основная логика содержится в цикле foreach. Для каждого названия из массива $properties:

• Скрипт формирует массив $arFields, где задаются основные параметры:
  • IBLOCK_ID: ID вашего инфоблока.
  • NAME: Русское название.
  • CODE: Сгенерированный уникальный код.
  • PROPERTY_TYPE: Устанавливается как 'S' (Строка) — самый универсальный тип для технических характеристик.
  • FILTRABLE: 'Y' — Свойство будет доступно в умном фильтре.
  • SEARCHABLE: 'Y' — Свойство будет участвовать в поиске.
• Используется метод $ibp->Add($arFields) для записи данных в базу.
• Выводится красивый HTML-отчет с результатом: ✓ Создано или ✗ Ошибка с причиной.

🧑‍💻 Как использовать этот скрипт?

1. Создайте файл: Сохраните код, например, как add_props.php.
2. Настройте переменные: Отредактируйте ID инфоблока и список названий в массиве $properties.
3. Загрузите: Разместите файл в корневой директории сайта.
4. Запустите: Откройте файл в браузере по адресу ваш_сайт.ru/add_props.php.
5. Проверьте: Убедитесь, что все свойства успешно созданы, и удалите скрипт с сервера для безопасности.

Скрипт

<?php
require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");

use Bitrix\Main\Loader;
use Bitrix\Main\Localization\Loc;

Loader::includeModule('iblock');

// ID инфоблока
$iblockId = 13;

// Список свойств для создания
$properties = [
    'Наименование',
    'Напряжение В',
    'Тип топлива',
  
];

/**
 * Функция транслитерации
 */
function transliterate($string) {
    $translitTable = [
        'А' => 'A', 'Б' => 'B', 'В' => 'V', 'Г' => 'G', 'Д' => 'D',
        'Е' => 'E', 'Ё' => 'YO', 'Ж' => 'ZH', 'З' => 'Z', 'И' => 'I',
        'Й' => 'J', 'К' => 'K', 'Л' => 'L', 'М' => 'M', 'Н' => 'N',
        'О' => 'O', 'П' => 'P', 'Р' => 'R', 'С' => 'S', 'Т' => 'T',
        'У' => 'U', 'Ф' => 'F', 'Х' => 'H', 'Ц' => 'C', 'Ч' => 'CH',
        'Ш' => 'SH', 'Щ' => 'SCH', 'Ъ' => '', 'Ы' => 'Y', 'Ь' => '',
        'Э' => 'E', 'Ю' => 'YU', 'Я' => 'YA',
        'а' => 'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd',
        'е' => 'e', 'ё' => 'yo', 'ж' => 'zh', 'з' => 'z', 'и' => 'i',
        'й' => 'j', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n',
        'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't',
        'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch',
        'ш' => 'sh', 'щ' => 'sch', 'ъ' => '', 'ы' => 'y', 'ь' => '',
        'э' => 'e', 'ю' => 'yu', 'я' => 'ya',
    ];
    
    $string = strtr($string, $translitTable);
    $string = preg_replace('/[^a-zA-Z0-9_]/', '_', $string);
    $string = preg_replace('/_+/', '_', $string);
    $string = trim($string, '_');
    $string = strtoupper($string);
    
    // Ограничение до 24 символов
    if (strlen($string) > 24) {
        $string = substr($string, 0, 24);
    }
    
    return $string;
}

/**
 * Получение существующих свойств инфоблока
 */
function getExistingPropertyCodes($iblockId) {
    $codes = [];
    $properties = CIBlockProperty::GetList(
        [],
        ['IBLOCK_ID' => $iblockId]
    );
    
    while ($prop = $properties->Fetch()) {
        $codes[] = $prop['CODE'];
    }
    
    return $codes;
}

/**
 * Генерация уникального кода
 */
function generateUniqueCode($name, $existingCodes) {
    $baseCode = transliterate($name);
    $code = $baseCode;
    $counter = 1;
    
    // Если код уже существует, добавляем счётчик
    while (in_array($code, $existingCodes)) {
        $suffix = '_' . $counter;
        $maxLength = 24 - strlen($suffix);
        $code = substr($baseCode, 0, $maxLength) . $suffix;
        $counter++;
        
        // Защита от бесконечного цикла
        if ($counter > 100) {
            $code = substr($baseCode, 0, 20) . '_' . time();
            break;
        }
    }
    
    return $code;
}

// Получаем существующие коды свойств
$existingCodes = getExistingPropertyCodes($iblockId);

echo "<h2>Создание свойств для инфоблока ID: {$iblockId}</h2>";
echo "<table border='1' cellpadding='5' cellspacing='0'>";
echo "<tr><th>№</th><th>Название</th><th>Код</th><th>Результат</th></tr>";

$successCount = 0;
$errorCount = 0;
$createdPropertyCodes = []; // Массив для хранения кодов созданных свойств

foreach ($properties as $index => $propertyName) {
    $number = $index + 1;
    
    // Генерируем уникальный код
    $propertyCode = generateUniqueCode($propertyName, $existingCodes);
    
    // Добавляем код в список существующих для предотвращения дубликатов в текущей сессии
    $existingCodes[] = $propertyCode;
    
    // Параметры свойства
    $arFields = [
        'IBLOCK_ID' => $iblockId,
        'NAME' => $propertyName,
        'CODE' => $propertyCode,
        'ACTIVE' => 'Y',
        'PROPERTY_TYPE' => 'S', // Строковое
        'USER_TYPE' => null,
        'MULTIPLE' => 'N',
        'IS_REQUIRED' => 'N',
        'SORT' => $number * 100,
        'FILTRABLE' => 'Y',
        'SEARCHABLE' => 'Y',
        'WITH_DESCRIPTION' => 'N',
        'HINT' => '',
        'COL_COUNT' => 30,
        'MULTIPLE_CNT' => 5,
        'LINK_IBLOCK_ID' => 0,
        'DEFAULT_VALUE' => '',
        'DISPLAY_TYPE' => 'F',
        'DISPLAY_EXPANDED' => 'N',
        'FIELD_TYPE' => '',
    ];
    
    $ibp = new CIBlockProperty();
    $propId = $ibp->Add($arFields);
    
    if ($propId) {
        echo "<tr>";
        echo "<td>{$number}</td>";
        echo "<td>{$propertyName}</td>";
        echo "<td><strong>{$propertyCode}</strong></td>";
        echo "<td style='color: green;'>✓ Создано (ID: {$propId})</td>";
        echo "</tr>";
        $successCount++;
        $createdPropertyCodes[] = $propertyCode; // Добавляем код созданного свойства
    } else {
        $error = $ibp->LAST_ERROR;
        echo "<tr>";
        echo "<td>{$number}</td>";
        echo "<td>{$propertyName}</td>";
        echo "<td><strong>{$propertyCode}</strong></td>";
        echo "<td style='color: red;'>✗ Ошибка: {$error}</td>";
        echo "</tr>";
        $errorCount++;
    }
}

echo "</table>";
echo "<br>";
echo "<h3>Итого:</h3>";
echo "<p>Успешно создано: <strong style='color: green;'>{$successCount}</strong></p>";
echo "<p>Ошибок: <strong style='color: red;'>{$errorCount}</strong></p>";


require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog_after.php");