1C Import Queue

При повторной выгрузке из 1С CS-Cart может не узнать уже существующие товары и создать дубликаты вместо обновления. Так происходит потому что 1С иногда генерирует новые внешние идентификаторы (UUID) для тех же самых товаров, а CS-Cart сопоставляет записи именно по идентификатору, а не по артикулу.

Модуль не встраивается в сам процесс импорта и не работает в фоне — это инструмент диагностики и ручной починки: вы запускаете его из панели администратора, когда нужно сопоставить товары заново по артикулу и подготовиться к следующей выгрузке.

Этот модуль нужен если:

• после выгрузки из 1С появляются дубликаты товаров
• импорт создаёт новые товары вместо обновления существующих
• часть товаров при импорте молча пропускается и непонятно почему
• вы хотите видеть все ошибки CommerceML в одном месте

Что умеет модуль:

• Пересопоставление по артикулу — вручную обновляет связь товара с новым идентификатором из 1С, чтобы при следующем импорте CS-Cart не создал дубль
• Предпросмотр перед применением — показывает все предстоящие замены до того, как они произойдут
• Откат в рамках сессии — можно вернуть последнюю операцию обратно, пока вы не вышли из системы (подробнее в разделе 6)
• Поиск дубликатов артикулов — и в базе сайта, и внутри выбранного XML-файла из 1С
• Пропущенные записи — показывает какие товары пропустил импорт, и пытается найти причину в логах
• Журнал ошибок CommerceML — собирает строки с ошибками из лог-файлов в одну таблицу с привязкой к товарам, если удаётся её определить
• Проверка совпадения названия — опционально проверяет, что название товара в XML и в базе совпадает, перед заменой идентификатора

1. Установка и настройка

Установка производится стандартным способом через панель управления CS-Cart:

• Распакуйте архив модуля и скопируйте содержимое в корневую директорию сайта, сохранив структуру папок
• Перейдите в Модули → Управление модулями
• Найдите «IP5 Fixed UUID» и нажмите «Установить»
• Откройте настройки модуля, нажав на его название

После установки откройте страницу настроек. Доступны следующие параметры:

• Проверять название товара — если включено, идентификатор заменяется только при совпадении названия товара в XML и в базе данных. Повышает точность, снижает риск ошибочных замен, но и означает, что часть реальных дублей не будет исправлена автоматически, если название товара было изменено в 1С или на сайте.
• Путь к XML-файлу — относительный путь от корня сайта до одного XML-файла CommerceML. Пример: var/files/1/exim/1C/import0_1.xml. Модуль обрабатывает только этот файл за один запуск; если выгрузка 1С состоит из нескольких файлов, их нужно указывать и обрабатывать по очереди. Ниже поля модуль автоматически показывает список найденных XML-файлов, начинающихся с «import», в директории экспорта — чтобы упростить выбор пути.

Рис. 0 — Страница настроек с параметрами конфигурации и кнопками быстрого доступа

2. Предпросмотр и применение замены идентификаторов

Основная функция модуля — ручная, управляемая замена идентификаторов с предварительным просмотром всех изменений перед их применением. Это не автоматический процесс: каждый запуск инициируется администратором и требует подтверждения.

• Нажмите кнопку «Запустить сейчас» на странице настроек
• Модуль прочитает указанный XML-файл и сопоставит товары по артикулу с записями в таблице маппинга CS-Cart — для каждого несовпадения показаны артикул, название, текущий и новый идентификатор из файла 1С
• Проверьте таблицу: строки, где название товара в XML и на сайте не совпадает, выделены отдельно — это стоит проверить вручную перед применением, особенно если включена проверка названия
• Нажмите «Применить» для обновления записей в таблице маппинга
• После применения появится уведомление с количеством замен, кнопка «Откат» станет активной на время текущей сессии

Важно понимать: замена меняет только связь товара с внешним идентификатором 1С в служебной таблице CS-Cart. Она не изменяет сам товар, его цену, остатки или другие данные, и не запускает импорт — это подготовка к тому, чтобы следующий импорт из 1С прошёл корректно.

Рис. 1 — Страница предпросмотра: таблица товаров с предстоящими заменами

Рис. 2 — Детальный вид: артикулы, названия и пары идентификаторов

3. Проверка дублирующихся артикулов

Нажмите «Проверить дублирующиеся артикулы» на странице настроек. Страница содержит два раздела:

• Дубли на сайте — товары с одинаковым артикулом в базе данных. Показываются ID товара, название, внешний идентификатор и дата последнего обновления. Наличие таких строк говорит о том, что дубли уже были созданы ранее и их придётся объединять или удалять вручную — модуль их не устраняет автоматически.
• Дубли в XML-файле — артикулы, встречающиеся более одного раза в текущем выбранном файле выгрузки из 1С. Это сигнал о проблеме на стороне 1С: при импорте невозможно однозначно определить, какую из записей использовать. При парсинге такого файла модуль запоминает первую по порядку встречи запись с этим артикулом, остальные попадают только в список дублей и не участвуют в сопоставлении.

Рис. 3 — Таблица товаров с одинаковыми артикулами в базе данных

Рис. 4 — Полный файл логов

Рис. 5 — Дублирующиеся артикулы внутри выбранного XML-файла из 1С

4. Пропущенные записи при импорте

Нажмите «Пропущенные записи» на странице настроек — отображаются до 150 последних пропущенных записей, отсортированных по дате. Для каждой записи модуль ищет строку с этим UUID в файлах commerceml.log и пытается вытащить из неё причину пропуска.

В таблице отображается:

• UUID — внешний идентификатор записи в CommerceML
• Тип — тип сущности (product, category и т.д.)
• Название — название из файла маппинга
• Причина — текст причины пропуска, извлечённый из commerceml.log
• Лог-файл — имя файла, в котором найдена причина
• Дата — временная метка записи

Если для записи не удалось найти совпадение ни в одном лог-файле, в таблице так и будет указано «не найдено в логах» — это может происходить, если нужный лог уже был ротирован или удалён с сервера.

Рис. 6 — Таблица пропущенных записей с причиной из лога и ссылкой на товар

5. Журнал ошибок CommerceML

Доступен через ссылку в меню администратора. Модуль сканирует все файлы commerceml.log*, извлекает строки с тегом [error] и группирует их по файлам лога, начиная с самого нового. Одинаковые строки показываются только один раз — дубликаты фильтруются автоматически. Если по идентификатору из строки ошибки удаётся найти товар на сайте — показывается прямая ссылка на его редактирование; название товара при этом извлекается из текста самой строки лога и зависит от того, в каком формате 1С её записала, поэтому в части строк название может не определиться.

6. Откат изменений

После применения замен кнопка «Откат (N)» появляется на странице настроек. В скобках указано количество изменённых записей.

• Модуль проверяет, что старые идентификаторы не заняты другими записями. Если заняты — такая запись пропускается и логируется, откат по ней не выполняется
• Для каждой оставшейся пары выполняется обратная замена
• Отображается уведомление с количеством обработанных пар и фактически восстановленных записей

Важно: список последних замен для отката хранится в сессии браузера, а не в базе данных. Кнопка «Откат» доступна только пока вы не вышли из системы и сессия активна; после логаута или истечения сессии возможность отката через интерфейс модуля теряется безвозвратно. Рекомендуем проверять результат сразу после применения замены, до выхода из системы.