При повторной выгрузке из 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)» появляется на странице настроек. В скобках указано количество изменённых записей.
- Модуль проверяет, что старые идентификаторы не заняты другими записями. Если заняты — такая запись пропускается и логируется, откат по ней не выполняется
- Для каждой оставшейся пары выполняется обратная замена
- Отображается уведомление с количеством обработанных пар и фактически восстановленных записей
Важно: список последних замен для отката хранится в сессии браузера, а не в базе данных. Кнопка «Откат» доступна только пока вы не вышли из системы и сессия активна; после логаута или истечения сессии возможность отката через интерфейс модуля теряется безвозвратно. Рекомендуем проверять результат сразу после применения замены, до выхода из системы.