# Тип файла ## CSV

* ***Кодировка*** *-* Выберите кодировку файла. Если кодировка не соответствует UTF-8, то для корректного импорта файла необходимо создать активную константу ALT\_SITE\_LOCALE, которая должна содержать альтернативную локаль. Например, если импорт ведется из CSV-файла в кодировке Windows-1251, то указанная константа должна иметь в своем значении наименование локали для этой кодировки, чаще всего это ru\_RU.CP1251. * ***Разделитель** - р*азделитель для столбцов (например: Запятая, Точка с запятой при сохранении из Microsoft Excel® и др), укажите символ разделителя в поле * ***Ограничитель** -* ограничитель для полей (например: Кавычки и др), укажите символ ограничителя * ***Кол-во проп. строк** - число указывающее сколько нужно пропустить строк сверху (например если сверху есть название полей)* ### Настройка полей импорта При настройке полей для импорта вы должны сопоставить номер столбца в файле с полем в которое выгружать (в файле столбец **А** → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно, пустые столбцы можно пропускать * номер столбца в файле, диапазон от А до AZ * Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств) * Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name) * Домен к image - укажите если в файле путь к изображениям не указан *

параметр обновления данных выбранного поля для уже существующих товаров, если вкл. то будет обновлять (например можно включить чтобы обновлял только остатки и цены, а название и описание не перезаписывал) * ![](https://2369838666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mj-gwbYdQWRhuB0jULI%2Fuploads%2FfhFXaOzOIPKJBk7ppz4B%2Fimage.png?alt=media\&token=115900a4-d003-4180-a3b9-84954d76cbea) поставьте галочку если загружаете модификации и нужно из них создать род. товар, тогда текущие данные будут загружаться для родительского товара ## XLS/XLSX

* ***Кол-во проп. строк** - число указывающее сколько нужно пропустить строк сверху (например если сверху есть название полей)* * ***Номер листа** - в Excel файле может находится несколько листов с данными, можно указать какой именно загружать (от 1 до 99) или загружать все (-1)* ### Настройка полей импорта При настройке полей для импорта вы должны сопоставить номер столбца в файле с полем в которое выгружать (в файле столбец **А** → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно, пустые столбцы можно пропускать * номер столбца в файле, диапазон от А до AZ * Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств) * Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name) * Домен к image - укажите если в файле путь к изображениям не указан *

* ***Загружать группы*** - загружать группы из файла * ***Путь до групп***² - `xpath` *путь до тега групп (например* `shop/categories/category`*)* * ***Путь до товаров***² *-* `xpath` *путь до тега товара (например* `shop/offers/offer`*)* * ***Путь до модификаций***² *-* `xpath` *путь до тега внутри товара (например* `variant`*)* * ***Путь названия свойства***² *-* `xpath` *название тега (по умолчанию* `@name`*)* * ***Путь значения свойства***² *-* `xpath` *название тега (по умолчанию пусто)* {% hint style="info" %} ²XPath реализовывает навигацию по DOM в XML [подробнее](https://ru.wikipedia.org/wiki/XPath) {% endhint %} ### Настройка полей импорта При настройке полей для импорта вы должны сопоставить XML тэг в файле с полем в которое выгружать (тег в файле`name` → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно * xpath пути тега из XML (например `name`) * Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств) * Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name) * Домен к image - укажите если в файле путь к изображениям не указан *

* **Путь к ссылкам на товары**² - `xpath`, например `//a[@class = 'product-item' and @href]/@href)` * **Маска пагинации** - например `?page=%d` * **Путь к номеру последней страницы**² - `xpath`, например `//ul[@class = 'pagination']/a[position() = last()]/text())` * **Путь названия свойства**² - `xpath`, например `//*[@class = 'name']/text())` * **Путь значения свойства**² - `xpath`, например `//*[@class = 'value']/text())` {% hint style="info" %} ²XPath реализовывает навигацию по DOM в HTML [подробнее](https://habr.com/ru/articles/753332/) {% endhint %} ### Настройка полей импорта При настройке полей для импорта вы должны сопоставить данные html с полем в которое выгружать (данные тэга `//h1/text()` → в админке **Название товара \[name]**), для вашего удобства порядок лучше соблюдать, но это не обязательно * xpath пути тега из XML (например `//h1/text()`) * Поле в которое будут записываться данные из столбца, стандартные поля товара и его доп. свойства (выбор поля идет автокомплитом, по названию и его названию из таблицы базы, так же по ID и XML тегу для доп. свойств) * Поле для родителського товара (mod\_id - рекомендуем, marking, guid, name) * Домен к image - укажите если в файле путь к изображениям не указан *