Документация anyCSV/XLS import/export PRO - 4

1. Зайдите в модуль импорта anyCSV/XLS

3. Установите Разделитель, Ограничитель, Символ экранирования, Кодировку в соответствии с файлом (если Вы планируете загрузить файл в формате XLS, XLSX, то менять значения в этих настройках необязательно)

Как узнать Разделитель, Ограничитель, Кодировку файла, показано в соответствующих разделах этой инструкции

4. Загрузите файл или скопируйте ссылку на нужный файл в поле "URL ссылка на файл". При использовании ссылки нужно обязательно указать протокол: http или https

Файл может быть заархивирован в архив zip

Если файл не загружается, пожалуйста, проделайте действия, описанные в разделе "Ошибки при загрузке файла или подаче ссылки"

Если ссылка не загружается, проверьте ссылку, как это указано в разделе "Источники данных: файлы, ссылки на файлы на других сайтах, авторизация, файлы в архиве", или в разделе "Ошибки при загрузке файла или подаче ссылки"

Если Вы импортируете файл в формате XLS, XLSX, также смотрите следующий раздел

5. Выставите дополнительные настройки перед начало проверки файла:

• Режим синхронизации данных - если Вы планируете делать импорт не только в стандартные поля ОпенКарт, но и поля, которые были добавлены в базу данных, или в поля, которые скрыты от просмотра, то нужно выбрать "Выводить все поля базы". В случае, если импорт будет в стандартные поля, то оставьте эту настройку без изменений: Выводить только основные поля базы
• Язык контента - укажите для какого языка контента сайта будет производиться импорт данных. Профиль импорта можно привязать только к одному языку. Если Вам нужен аналогичный профиль для другого языка, то создайте новый на его основе, как это показано в разделе "Сохранение профиля настроек"
• Конвертация валюты (если будут передаваться цены) - укажите нужна ли конвертация валюты, если какие-либо цены на входе будут поступать не в итоговой валюте. В этом случае, при работе с любой ценой (в т.ч. наценках в опциях), если таковая будет, цена будет автоматически конвертироваться
• Для магазинов - укажите к каким магазинам будут привязываться данные
  

Удостоверьтесь, что количество строк соответствует количеству строк входящих данных

Удостоверьтесь, что найдено правильное количество колонок

Проверьте таблицу: колонки таблицы должны совпадать с колонками, импортируемого файла, а данные ниже должны соответствовать данным в последней строке файла

Если какие-то данные не соответствуют данным файла, убедитесь, что все предыдущие шаги, а в особенности выставление кодировки, разделителей и ограничителей, проделаны верно

Если у Вас возникают ошибки, к данному шагу не удается выйти, подробнее об ошибках смотрите в разделе Ошибки

Справа на рисунке файл расположен в программе Эксель

Слева, показано, как колонки файла представляются в модуле. Для удобства настроек, название колонок подается не горизонтально, а вертикально. Под каждым названием колонки присутствуют данные из файла, по которым можно удостовериться, что данные парсятся правильно

3. Выберите, по какой колонке базы данных таблицы товара, проверять это значение

Если в колонке с идентификатором находится то, что у Вас на сайте находится в колонке Артикул, то выбирайте SKU, если Модель (Код товара) - то выбирайте MODEL, если Вы импортируете product_id, то выбирайте product_id и т.д. 

Если для идентификатора Вы используете кастомное поле, добавленное в таблицу товара, то оно также появится в списке, показанном справа

Также возможна идентификация по названию товара, или главной картинки товара

1. Проделайте действия из Шага 1, установите идентификатор данным, если нужно, как это описано в разделе "Установка идентификатора". В данном примере, идентификатор не устанавливается для простоты понимания смысла прямого импорта. 

После появления представления Шага 2, у каждой колонки файла найдите нужное соответствие и укажите его в настройках колонки

Например, у артикула нужно найти и выбрать "SKU"

4. Чтобы приступить к импорту, в рубрике "Параметры профиля настроек" выберите нужный режим обмена данными (т.к. идентификации в данном примере не требуется, на примере, выбрано Добавлять все данные, как новые"). А также выберите настройки в шаге 3 и для старта импорта, нажмите "Начать импорт данных". Вы увидите счетчик импорта, значит импорт начался успешно

Подробнее о режимах обмена, и Шаге 3 смотрите в следующих разделах

5. По завершению импорта появится окно об успешном завершении

1. Войдите в область настроек первого шага

2. Найдите настройку "Обработка перед импортом (обнуление остатков, цен, выключение определенных товаров)"

3. В колонке "Найти нужные товары, если поле товара..." укажите "Модель", в колонке "Оператор" - укажите "Содержит слева", в колонке "Значение" укажите: OS- (указывать нужно без пробелов и лишних символов, обратите внимание, что запрос будет регистронезависимый, то есть OS- тоже самое, что os-)

4. В настройку: "Установить все остатки, соответствующих товаров перед импортом" укажите тот остаток, который должен быть установлен всем товаром, с префиксом OS- слева в каждой модели (коде товара), например: 0

5. После данной настройки, в ходе импорта у всех товаров, у которых в модели (коде товара) будет присутствовать слева префикс OS- в поле количество товара будет добавлен нуль. 

1. Войдите в область настроек первого шага

2. Найдите настройку "Обработка перед импортом (обнуление остатков, цен, выключение определенных товаров)"

3. В колонке "Найти нужные товары, если поле товара..." укажите "Модель", в колонке "Оператор" - укажите "Содержит слева", в колонке "Значение" укажите: OS2- (указывать нужно без пробелов и лишних символов, обратите внимание, что запрос будет регистронезависимый, то есть OS2- тоже самое, что os2-)

3. В колонке "Найти нужные товары, если поле товара...", ниже укажите "Количество", в колонке "Оператор" - укажите ">", в колонке "Значение" укажите: 0

4. В настройку: "Отключить все соответствующие товары перед импортом" укажите "Включено"

5. После данной настройки, в ходе импорта у всех товаров, у которых в модели (коде товара) будет присутствовать слева префикс OS2-, и одновременно количество больше нуля, статус будет изменен на 0, то есть товар будет выключен и не будет показываться во фронтенде магазина 

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

2. Скопируйте это название в точности, и запомните какой разделитель используется: на примере разделить слеш: /, а название: Каталог_чистый

1. Перейдите в область настроек Шага 1, и в области "Сопоставление категорий файла и категорий сайта" в левой колонке "Название колонки в файле с категориями, заданными путем" вставьте, скопированное название колонки. В правой колонке "Разделитель категорий внутри пути" укажите разделитель вложенности.

2. Нажмите на кнопку "Проверить файл и загрузить данные для сопоставления"

1. Если всё сделано, а также в файле есть указанная колонка, разделитель соответствует тому, которым переложены названия категорий, то появится область: Сопоставление категорий файла XML и категорий сайта

2. Сопоставьте категории файла и категории сайта

1. Сохраните настройки, нажав на "Сохранить профиль настроек" внизу. Подробнее о вариантах сохранения профиля, и Шаге 3, смотрите в соответствующих разделах

Установить количество всем товарам - Настройка позволяет установить то или иное число всем товарам, которые будут импортироваться по файлу. Количество у других товаров в ОпенКарте не изменится

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

Публикация данных после импорта - устанавливает нужно ли включать товары, которые импортируются или обновляются по файлу

Генерировать seo_url - включает генерацию сео урла по правилам транслитерации поисковиков, если в рамках импорта будут переноситься названия. Генерация делается один раз. Если у товара уже заведен какой-либо сео-урл, то он не будет изменен при следующих обновлениях

Не импортировать товары без картинок - если в какой-либо колонке будет указано, что импортируются изображения, и если изображения не будут получены с удаленного сервера, или будут отсутствовать на сайте, то при включении этой настройки, импорт таких данных в целом по строке не произойдет

Загрузка изображений при помощи CURL - если картинки не загружаются или загружаются медленно, попробуйте включить этот способ получения изображений с удаленных серверов

Переименовать названия папок - если импортируются изображения, у которых кириллические или прочие нестандартные названия файлов или папок, Вы можете привести эти данные в соответствие со стандартом URL, но обратите внимание, что длина файла и папок вместе не должна превышать 255 символов, как установлено в базе данных ОпенКарт на колонках image. Если длина будет превышать, то картинки загрузятся, но в базе данных будет сохранен не весь путь и картинки не отобразится

Обрабатывать изображение - используйте любое из данных полей, чтобы обработать изображения при импорте: сделать пропорциональное уменьшение и/или обрезать часть изображения

Доступно 3 режима сохранения:

• Сохранить, как новый - этот режим позволяет сохранить профиль, как новый профиль настроек. При этом тот, который был вызван первоначально не изменится
• Сохранить изменения - этот режим сохраняет изменения в вызванный профиль настроек
• Удалить профиль - этот режим удаляет вызванный профиль настроек. Удалить профиль можно также нажав на иконку корзинки рядом с названием профиля настроек, в области настроек Шага 1, в рубрике: Загрузить профиль настроек

Доступно 4 режима обмена данными:

• Добавить все данные, как новые - этот режим позволяет добавлять данные, как новые без идентификации. Будьте осторожны, каждый импорт в этом режиме будет заводить данные. Это может привести к их дублированию. Чтобы избежать дублирования, используйте следующие ниже режимы
• Обновить все данные, и вставить новые если есть - этот режим нужен, если в файле есть товары, часть которых уже заведена, а часть не заведена. При работе с файлом, модуль будет находить имеющиеся товары и если таковые есть, то обновлять в них данные, которые будут требовать обновления по данным настроек профиля. Если модуль не найдет данные по идентификатору сущности данных, то данные по файлу, в соответствии с настройками по колонкам, будут добавляться, как новые. Для этого профиля обязательна настройка идентификатора (смотрите раздел "Установка идентификатора")
• Обновить только имеющиеся - этот режим отличается от предыдущего тем, что новые данные вставляться не будут, а обновление будет происходить только если будет найден тот или иной товар, категория и т.п. сущность данных. Для этого профиля обязательна настройка идентификатора (смотрите раздел "Установка идентификатора")
• Добавить только новые - этот режим отличается тем, что позволяет добавлять сущности данных (например, товары), только если таковые отсутствуют на сайте. Для этого профиля обязательна настройка идентификатора (смотрите раздел "Установка идентификатора")

1. Перед началом импорта установите нужные параметры:

• С какой строки файла начать? - этот параметр позволяет начать (продолжить) импорт с любой строки файла, без учета первой строки, в котором находятся колонки файла
• Делать строк за один проход (рекомендуется 50-100) - установите оптимальный режим обработки - размер порции, которая будет обрабатываться за один круг. Чем больше данных в строке, тем затратней для памяти и времени импорт одной строки. Чем меньше данных в строке, тем менее затратней по времени и памяти операция импорта. Для обычных хостингов, и длине колонок 10-20, установите 50-200. Для хостингов с большим объемом ОЗУ, нелимитируемым временем работы скрипта - этот параметр может быть равен тысячам и десяткам тысяч