Розробка модуля імпорту даних 1С-Бітрікс

Клієнт приніс Excel на 15 000 рядків з унікальними характеристиками товарів. Вбудований CommerceML не підходить — формат нестандартний, потрібно оновлювати існуючі позиції, не чіпаючи ціни та залишки. Ручне введення зайняло б місяць. Ми розробили модуль імпорту під ключ за 13 робочих днів. Наш досвід понад 10 років у Бітрікс-розробці та 50+ завершених проектів з інтеграції — гарантія, що модуль стабільно працюватиме під навантаженням. Ви отримуєте готове рішення, яке економить час у 10 разів порівняно з ручним завантаженням.

Стандартний модуль catalog підтримує імпорт через CSaleImport та клас CDataExchangeXML для CommerceML 2.x. Працює прийнятно для простого каталогу. Проблеми починаються з довільних форматів (Excel, JSON, XML з нестандартною схемою), імпорту в кілька інфоблоків одночасно, оновлення існуючих записів з логікою злиття полів, імпорту користувачів, замовлень, CRM-сутностей та великих файлів (10 000+ рядків) без таймаутів. Кастомний модуль вирішує ці проблеми, використовуючи потокову обробку та настроюваний мапінг.

В основі модуля vendor.importer лежать три абстракції: Reader (читає джерело), Transformer (перетворює дані) та Writer (записує в Бітрікс). Така архітектура дозволяє підключати будь-які джерела та цілі без зміни ядра. Докладніше про платформу можна прочитати в Wikipedia.

Як влаштований модуль?

Модуль vendor.importer будується навколо трьох абстракцій: Reader, Transformer та Writer.

SourceFile → Reader → RawRow[] → Transformer → MappedRow[] → Writer → Bitrix entities 

ReaderInterface:

interface ReaderInterface { public function open(string $filePath): void; public function readNext(): ?array; // null = кінець файлу public function getHeaders(): array; public function close(): void; } 

Реалізації: CsvReader, XlsxReader (через PhpSpreadsheet), XmlReader (через XMLReader для потокового читання великих файлів), JsonReader.

Мапінг полів — розробка модуля імпорту

Конфігурація мапінгу зберігається в b_vendor_importer_mapping:

{ "source": "csv", "target": "catalog_product", "iblock_id": 5, "fields": { "article": "PROPERTY_ARTICLE", "name": "NAME", "price": "CATALOG_PRICE_1", "stock": "CATALOG_STORE_PRODUCT_AMOUNT" }, "key_field": "article", "update_strategy": "merge" } 

key_field визначає поле для ідентифікації існуючого запису. update_strategy:

• merge — оновлює лише поля з мапінгу;
• replace — повна заміна;
• skip — пропуск існуючих.

Як обробляються великі файли?

Імпорт 50 000 рядків за один HTTP-запит неприпустимий. Використовуємо агенти:

// Крок 1: завантаження файлу, завдання $job = ImportJobTable::add([ 'FILE_PATH' => $uploadedPath, 'MAPPING_ID' => $mappingId, 'STATUS' => 'pending', 'TOTAL' => 0, 'PROCESSED' => 0, ]); // Крок 2: агент обробляє порціями public static function processChunk(int $jobId, int $offset, int $limit = 100): string { $job = ImportJobTable::getById($jobId)->fetch(); $reader = ReaderFactory::create($job['FILE_PATH']); $reader->open($job['FILE_PATH']); // пропускаємо offset рядків, читаємо limit рядків // записуємо, оновлюємо PROCESSED return "\\Bitrix\\Main\\Agent::executeImporter($jobId, $newOffset);"; } 

Агент викликається щохвилини, прогрес видно в адмінці в реальному часі. Потокова обробка в 10 разів швидша за звичайний імпорт за один запит.

Writer: запис в інфоблок

class IblockElementWriter implements WriterInterface { public function write(MappedRow $row): WriteResult { $existing = $this->findByKey($row->getKeyValue()); if ($existing) { $result = \CIBlockElement::Update($existing['ID'], $row->toIblockArray()); } else { $element = new \CIBlockElement(); $result = $element->Add($row->toIblockArray()); } return new WriteResult($result !== false, $existing ? 'updated' : 'created'); } } 

Аналогічні Writer'и: CrmLeadWriter, SaleOrderWriter, UserWriter.

Валідація даних та обробка помилок

Перед записом кожен рядок проходить валідацію. Правила задаються в конфігурації:

Рядки з помилками фіксуються в журналі b_vendor_importer_error. Після імпорту доступний звіт та CSV із проблемними рядками.

Сповіщення та логування

Після завершення модуль надсилає email ініціатору через \Bitrix\Main\Mail\Event::send(): загальна кількість рядків, створено/оновлено/помилок, посилання на журнал.

Процес розробки модуля

1. Аналіз форматів та мапінг — вивчаємо ваші джерела даних, узгоджуємо поля.
2. Проектування архітектури — визначаємо Reader, Transformer, Writer.
3. Розробка Reader'ів — підключаємо потокові парсери для ваших форматів.
4. Налаштування мапінгу — конфігуруємо відповідність полів.
5. Реалізація Writer'ів — запис в інфоблоки, CRM, замовлення.
6. Потокова обробка та агенти — налаштування фонового імпорту.
7. Валідація та логування — налаштування правил перевірки та журналу помилок.
8. Адміністративний інтерфейс — створюємо сторінку для запуску та моніторингу.
9. Тестування та навантажувальне тестування — прогоняємо на реальних даних.
10. Документація та навчання — передача команді.

Чому варто замовити кастомний модуль?

Ми — сертифіковані спеціалісти 1С-Бітрікс з 10+ роками досвіду. Кожен модуль проходить навантажувальне тестування. Ви отримуєте гарантію стабільної роботи та підтримку після впровадження. Згідно з офіційною документацією 1С-Бітрікс, стандартні засоби не покривають кастомні формати та складну логіку оновлення. Для консультації та попередньої оцінки вашого проекту звяжіться з нами — ми підготуємо пропозицію під ваші завдання.

Строки розробки

Разом: від 13 робочих днів. Складні формати або трансформації — оцінюємо окремо. Отримайте консультацію та попередню оцінку вашого проекту, напишіть нам. Замовте розробку модуля, який вирішить вашу задачу.