Пример файла csv

Формат CSV

Главная   →   Справка   →   Экcпорт и импорт товаров

Общие данные
Для понимания процесса импорта/синхронизации

Для работы понадобиться программа работы с таблицами (Microsoft Excel, Apple Numbers, OpenOffice Calc или любая другая программа которая может сделать экспорт в формат CSV ).

В вашей программе вы должны создать таблицу со столбцами в которых содержатся значения ваших будущих товаров.

Пример таблицы :

articul	name	price	vendor	country	images
UX31E	ASUS ZENBOOK	44400	Asus	Китай	http://shopexpress.difocus.ru/alboms/3/3/zenbook.jpg
MBA-123	13-inch MacBook Air	45000	Apple	Китай	http://shopexpress.difocus.ru/alboms/3/3/apple-air-13.jpg
HD-8838	Philips Saeco HD 8838	27462	Philips	Россия	http://shopexpress.difocus.ru/alboms/3/3/saeco-hd-8838.jpg
HD-8838	Delonghi ECAM 23.210	27462	Delonghi	Италия	http://shopexpress.difocus.ru/alboms/3/3/delonghi.jpg

В самой первой строке нашей таблицы обязательно использование названий полей для наших товаров. У нас это articul — артикул, name — название товара, price — цена, vendor — производитель, country — страна производства, images — путь к изображению(подробности ниже).

Обязательное поле для создания товаров одно:

• name — название.

• price — цена,
• articul — артикул.

Другие поля товаров можно выбрать произвольно из общего количества полей. (В редакторе типов вы можете добавить новые поля для ваших товаров или других объектов.)

Вы можете указывать названия столбцов, чтобы внести или изменить значения:

• info:url — поле для Подстрока URL;
• info:name — поле для Название объекта в системе;
• info:sort — поле для сортировки объектов внутри раздела;
• info:access — поле для указания прав доступа (например: 7733);
• info:template — поле для Шаблон вывода, индексы шаблона вывода можно посмотреть тут;
• info:delete — поле для удаления товара, создайте столбец и заполните ячейку товара произвольными данными, чтобы удалить его во всемя импорта.

Список полей товара можно увидеть так, нажать «Параметры» → «Типы объектов» → «Товар».

В нашем редакторе таблица выглядит так :

После того, как таблица заполнена, экспортируйте ее в формат CSV. И сохраните файл, например на рабочем столе.

В формате CSV, если файл открыть с помощью Блокнота, таблица будет выглядеть так :

articul;name;price;vendor;country;images UX31E;ASUS ZENBOOK;44400;Asus;Китай;http://shopexpress.difocus.ru/alboms/3/3/zenbook.jpg MBA-123;13-inch MacBook Air;45000;Apple;Китай;http://shopexpress.difocus.ru/alboms/3/3/apple-air-13.jpg HD-8838;Philips Saeco HD 8838;27462;Philips;Россия;http://shopexpress.difocus.ru/alboms/3/3/saeco-hd-8838.jpg HD-8838;Delonghi ECAM 23.210;27462;Delonghi;Италия;http://shopexpress.difocus.ru/alboms/3/3/delonghi.jpg

При импорте из CSV вы можете указать:

• Раздел товара (любой уровень), если раздел не существует, он будет создан;
• Параметры товара;
• Путь к изображениям товара (изображения должны находится в одном zip-архиве с файлом CSV);
• Cпецификаций;
• Скидки;
• Размеры.

Требования и возможности:

• Наименования товаров должны быть разные:
• Если товар с указанным наименованием уже находится в разделе, он будет пропущен;
• Если в файле для импорта присутствуют товары с одинаковыми названиями в одном разделе, товарам будут присвоены индексы «Наименование {X}», где {X} — порядковый номер начиная с 1(единицы).
• Файл CSV в архиве должен быть один и находиться в корне архива;
• Изображения для выгрузки должны быть запакованы вместе с файлом CSV, кроме изображений с указанием URL;
• Количество разделов и товаров в CSV не более 5000;
• Формат CSV не поддерживает переходы строк, поэтому данные или текст внутри ячейки с использованием перехода строки будут неверно интерпретированы;
• В качестве разделителей в формате CSV используется точка с запятой «;», поэтому использование этого символа в тексте становится невозможным;
• Общий вес архива не должен превышать 64Мб для тарифов Эконом и Стандарт, 128Мб для тарифов Люкс и Максимум. Во время бесплатного пользования действует ограничение 3Мб.

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

Пример подготовленного CSV файла для импорта с изображениями можно скачать здесь.

Импорт товаров

Перейдите в систему управления сайтом и нажмите правой кнопкой мышки на нужный раздел, как будто вы собираетесь создать один новый товар, затем «Создать» → «Импорт». Появится окно с предложением ввести файл и тип файла. Нажмите «Добавить» и  выберите тип файла «CVS». Нажмите «Импортировать».

Если все действия выполнены верно вы увидите, следующее окно.

Синхронизация товаров

Для синхронизации товаров сначала их нужно экспортировать.

Вы скачаете файл примерно такого содержания.

Это файл в формате CSV. Откройте его программой для работы с таблицами ( Microsoft Excel, Apple Numbers или OpenOffice Calc ). Столбец UniqueKey — содержит уникальный идентификатор товара в системе управления. Вы можете менять все значения товара, кроме этого значений в ячейках столбца UniqueKey.

Если вы очистите ячейку с идентификатором товара — он будет заново создан,
с названием «Копия (N) {Название}«, где {Название} — его название из колонки name, а N — номер копии.

Исправленный файл в формате CSV импортируйте в систему управления, как было описано выше. Товары содержащие запись UniqueKey — обновят свои данные, товары с пустой ячейкой UniqueKey будут созданы.

Если вы не редактировали и не собирались редактировать значения какого-либо столбца, его можно удалить из файла для импорта. Это ускорит загрузку файла и время импорта, т.к. не будут обрабатываться лишние данные.

Например, если вы хотели изменить только цену товаров, в файле импорта необходимо оставить только столбцы price и UniqueKey, остальные столбцы нужно удалить(вместе с заголовком столбца, т.е. целиком удалить столбец).

Внимание! При синхронизации товаров вы можете указать раздел, где будет размещен товар. В таком случае импортируйте файл в ту папку, относительно которой вы указали размещение товара.

shopexpress.difocus.ru

Предварительная настройка импорта

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

Для создания структуры выполните следующие действия.

1. Создайте и настройте требуемый информационный блок, если его ещё нет.
2. Создайте в информационном блоке все необходимые свойства (для элементов информационного блока должны быть заданы те же свойства, что и для товаров, импортируемых из CSV файла).
3. Настройте информационный блок на использование в качестве торгового каталога (см. Торговый каталог).
4. Загрузите иллюстрации товаров (если они есть) на сайт.

Импорт каталога

Загрузка каталога из CSV файла осуществляется в несколько этапов.

Шаг 1

1. Откройте форму импорта данных: Магазин -> Торговый каталог-> Настройка импорта -> Импортировать.
2. Если CSV файл с данными находится на локальном диске, выберите его с помощью кнопки Обзор…(Browse…) в поле ввода Файл данных с моего компьютера.
   Если файл с данными находится на сайте, найдите его с помощью дерева папок и убедитесь, что полный путь к нему попал в поле Файл данных с сайта.
   Если файл данных имеет большой размер и находится на вашем локальном компьютере, то рекомендуется сначала выкачать этот файл на сайт с помощью любого FTP-клиента.
   
   
3. Выберите информационный блок, в который вы хотите загрузить данные.
4. Если у вас есть готовая схема загрузки для данного CSV-файла, то вы можете выбрать ее. В этом случае загрузка произойдет сразу, и дальнейшие шаги будут опущены.

   Внимание!
   Схема должна в точности соответствовать загружаемому файлу. В противном случае результат загрузки непредсказуем.

5. Нажмите кнопку Далее для перехода ко второму шагу.
   Если вы указали схему загрузки, загрузка начнется немедленно, и дальнейшие шаги будут пропущены.

Шаг 2

1. Выберите подходящий формат CSV файла с данными:
   • с разделителями — поля с данными разделяются специальным символом: запятой, точкой с запятой, знаком табуляции, пробелом или другим символом;
   • с фиксированной шириной полей.

   В зависимости от вашего выбора необходимо заполнить соответствующую форму настроек:

• если вы выбрали формат с разделителями, то укажите в поле Разделитель полей соответствующий разделитель;
• если вы выбрали формат с фиксированной шириной полей, то в поле Метки разделителя укажите номера колонок, которые разделяют поля.


2. Укажите, содержит ли первая строка файла имена полей (опция Первая строка содержит имена полей). Если вы отметите эту опцию, а файл не содержит имен полей, первая строка файла будет обработана неправильно.
3. Нажмите кнопку Далее для перехода к третьему шагу.

Шаг 3

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

   Если поле является элементом каталогизации, то установите ему в соответствие значение Группа уровня X.

   Обязательно должно быть установлено хотя бы одно из значений Уникальный идентификатор (B_IBLOCK_ELEMENT.XML_ID) или Название (B_IBLOCK_ELEMENT.NAME). Эти поля используются для сопоставления товаров в файле товарам в базе данных.

   Внимание!
   Убедитесь, что соответствия полей заданы корректно. В противном случае результат загрузки непредсказуем.

2. Для загрузки товаров с иллюстрациями необходимо предварительно выгрузить картинки в какой-либо каталог на сайте с помощью любого FTP-клиента. Задайте в поле Путь к картинкам путь к каталогу на сайте, в который вы выгрузили иллюстрации.
3. Укажите, как поступать с теми товарами, которые есть в базе, но которых нет в импортируемом CSV файле:
   • выберите удалить для того, чтобы полностью заменить существующий набор товаров загружаемым из файла;
   • выберите деактивировать для деактивации товаров. Деактивируемые товары не удаляются из базы данных, но и не показываются покупателям;
   • выберите не трогать для того, чтобы просто добавить данные из импортируемого файла в базу данных.
   
   
4. Если вы будете регулярно повторять загрузку CSV файлов с точно такой же структурой, то имеет смысл сохранить схему загрузки (настройки загрузки) и использовать ее при последующих загрузках.

   Внимание!
   Сохраненную схему вы можете использовать только на файлах с абсолютно совпадающей структурой; в противном случае, результат загрузки будет непредсказуем.

5. Нажмите кнопку Загрузить данные для начала загрузки.

Примеры файлов

Пример корректного CSV файла данных для формы Import CSV (new)

  Уникальный идентификатор;Название;Количество;Свойство_Battery;Группа;Покупка От;До;Базовая цена;Валюта;Розничная цена;Валюта  295;Siemens S55;10;90;Li-Ion;Siemens;1;10;160.00;USD;251.20;USD;N  295;Siemens S55;10;90;Li-Ion; Siemens;11;20;150.00;USD;235.50;USD;N  295;Siemens S55;10;90;Li-Ion;Siemens;21;;140.00;USD;219.80;USD;N  297;Siemens S46;2;680;Li-Ion;Siemens;1;10;85.00;USD;100.73;USD;N  297;Siemens S46;2;680;Li-Ion;Siemens;11;20;80.00;USD;94.80;USD;N  297;Siemens S46; 2;680;Li-Ion;Siemens;21;;75.00;RUR;88.88;RUR;N  325;Siemens U15;5;720;Li-Pol; Siemens;1;10;310.00;USD;367.35;USD;N  325;Siemens U15;5;720;Li-Pol;Siemens;11;20;290.00;USD;343.65;USD;N  325;Siemens U15;5;720;Li-Pol;Siemens;21;;270.00; USD;310; USD;N

Пример корректного CSV файла данных для формы Import CSV

  Группа;Подгруппа;Код;Товар;Короткое описание;Полное описание;Розничная цена;Оптовая цена;Количество;Картинка  Видеокарты;ASUS;1245;ASUS V9950/TD;GF FX5900 128Mb AGP8x, DirectX 9 and OpenGL1.4 support;"Серия V9950 и семейство GeForce FX 5900 выводят производительность в графике на качественно новый уровень; шина обмена данными с памятью шириной в 256 бит и эксклюзивная технология Lightspeed Memory Architecture от NVIDIA делают возможным наложение сложных текстур, освещения и других эффектов сразу на всю сцену"; $392,00; $369,95;1000; 9233.jpg  Видеокарты;Chaintech;20673;A-FX20 64TV;GeForce FX5200, 64MB DDR, 8xAGP, 64bit, DVI, TV-out;"Основные характеристики: Чип NVIDIA GeForce FX 5200; RAMDAC 350 МГц; максимальное разрешение 2D/3D 2048 x 1536 @ 75 Гц"; $82,95; $75,95;1000;20673.jpg  

© «Битрикс», 2001-2008, «1C-Битрикс», 2008

1С-Битрикс: Управление сайтом

neolant.ru

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

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

Для всех современных CMS, которые используются для создания магазинов, написаны дополнительные модули или расширения по импорту/экспорту товаров, которые могут быть как встроенными, так и поставляться отдельно на платной или бесплатной основе. Но для самописного движка интернет магазина вышеуказанный функционал придется описывать самостоятельно. Поэтому в данном уроке мы с Вами напишем небольшое веб-приложение, которое реализует импорт товаров CSV.

Конечно, создаваемый скрипт будет не сложен и по сути не будет привязываться к реальному движку, потому как у каждого из Вас различные задачи и показать создание универсального инструмента в рамках парочки уроков просто невозможно. Я хотел бы рассмотреть принцип импорта товаров, то есть, что бы Вы увидели, как это можно сделать, и возможно это поможет Вам в решении некоторой реальной задачи.

Итак, в данном уроке мы будем рассматривать импорт товаров в формате CSV, то есть вся информация о добавляемых товарах будет содержаться в специальном файле с расширением .csv.

Формат CSV – это простой текстовый формат, предназначенный для представления различных табличных данных. То есть благодаря ему, сложная таблица может быть сохранена в виде простого текста, с специфическим форматированием. CSV – это аббревиатура, образованная английскими словами — Comma-Separated Values — значения, разделённые запятыми. Синтаксис указанного формата предполагает, что каждая строка файла – это одна строка таблицы. Данные, которые хранятся в колонках, разделены друг от друга знаком запятой (,).

Но согласитесь, что запятая – это символ, который конечно же может встречаться в тексте, в качестве знака пунктуации, поэтому на практике, часто используют в качестве разделителей другие знаки, к примеру – точка с запятой (;), что собственно мы с Вами и сделаем. В этом случае, правильно бы назвать формат – DSV (delimiter-separated values — значения разделённые разделителем), но на сегодняшний день под понятием CSV – понимают набор определенных текстовых значений разделенных определенным разделителем.

Как было сказано выше, создавать скрипт мы будем с чистого листа и по сути реализуем считывание данных документа CSV и запись полученной информации в таблицу “products” базы данных.

Структура таблицы следующая:

Формат CSV очень легко получить, используя в качестве исходной таблицы – таблицу Microsoft Excel. Конечно, Вы можете спросить – зачем преобразовывать таблицу в специальный формат, если можно осуществить импорт, читая содержимое каждой ячейки таблицы. И по большому счету — Да, мы можем это сделать. Но при этом придется использовать дополнительную библиотеку по работе с документами Excel. В свою очередь формат CSV – простой текстовый формат, который легко и быстро читается языком PHP, без каких либо дополнительных инструментов.

Теперь предположим, что поставщик передал нам следующий документ с информацией о доступных товарах:

Как Вы видите каждая строка таблицы – это отдельный товар. При этом в колонках, располагается информация, которая должна быть сохранена в соответствующие поля таблицы “products”.

Теперь давайте преобразуем данную таблицу в формат CSV, для этого переходим в меню “Файл”, далее выбираем пункт “Сохранить как”.

Затем при сохранении выбираем формат CSV (разделители-запятые).

Обратите внимание, что файл будет сохранен в кодировке Windows-1251, поэтому для дальнейшей работы необходимо сменить кодировку на UTF-8. Теперь можно приступать к созданию функционала будущего скрипта.

В данной части мы с Вами реализуем общую файловую структуру приложения, создадим глобальную точку входа и функцию автоматической загрузки классов, а так же опишем класс, который выполнит чтение документа формата CSV и вернет полученную информацию в виде многомерного массива, работать с которым мы будем на следующем уроке. Соответственно, как реализовать вышеуказанный функционал, детально показано в видео версии текущего урока.

Поэтому текстовая версия завершена, а значит жду Вас в видео. Всего Вам доброго и удачного кодирования!!!

webformyself.com

Для успешного импорта данных, Ваш CSV-файл должен соответствовать определенному формату:

• Каждый столбец CSV-файла должен иметь заголовок с правильным названием (например _NAME_, ниже приведён список заголовков);
• Каждая строка файла это одна запись, связанная с товаром (категорией или производителем);
• Значения отдельных колонок (полей) разделяются разделительным символом точкой с запятой (;);
• Текстовые значения обрамляются символом двойные кавычки (").
• Если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд;

Пример данных из CSV-файла:

"_CATEGORY_";"_NAME_";"_MODEL";"_PRICE_";"_SKU_";"_QUANTITY_"  "Непонятные товары|Мётлы чудные";"Метла: Нимбус-2000";"Н-2000";2999.00;"19781712";100

Описание полей (заголовков) CSV-файла

_ATTRIBUTES_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить атрибуты.
Формат поля это список атрибутов разделённых переносом строки, одна строка = один атрибут со значениями через вертикальную черту

(Группа атрибутов|Название атрибута|Значение атрибута)
Пример:

 Процессор|No. of Cores|8   Память|test 1|32ГБ   Дисплей|Разрешение экрана|1980x1280

Вертикальная черта в названиях атрибутов не допускается.

_CATEGORY_

Используется: Товары
Формат поля: Перечисление категорий в одну строку или несколько строк.
Каждая отдельная строка это одна категория, включая подкатегории, для товара с разделителем вертикальная черта (|).
Последняя категория (или первая, если всего одна строка) будет присвоена товару как _MAIN_CATEGORY_.
Пример:

Категория|Подкатегория|Подкатегория|Категория_товара_1  Категория|Подкатегория|Подкатегория|Категория_товара_2  Категория|Подкатегория|Подкатегория|Категория_товара_3

_COLUMN_

Используется: Категории
Формат поля: Целое число
Количество колонок в выпадающем меню категорий (только для главных родительских категорий).

_DESCRIPTION_

Используется: Товары, Категории, Производители
Формат поля: Многострочный текст с поддержкой HTML
Описание товара.

_DISCOUNT_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить скидки. Формат поля это список скидок разделённых переносом строки, одна или несколько, где одна строка = одна скидка со значениями через запятую:

(ID группы покупателей,Количество,Приоритет,Цена,Дата начала,Дата окончания) — где даты можно пропустить
Пример:

 1,2,3,999.00   1,10,2,799.00,2012-10-01   1,100,1,699.00,2012-10-01,2012-10-31

Значения цены должны указываться в виде целых или дробных чисел, где разделитель дробной части должна быть точка

_EAN_

Используется: Товары
Формат поля: Текст в одну строку
Европейский стандарт штрихкода.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_HEIGHT_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара высота

_META_H1_ (старое название _HTML_H1_)

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Это поле соответствует HTML-тег H1 (тот самый H1).

_META_TITLE_ (старое название _HTML_TITLE_)

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Это поле соответствует HTML-тег Title.

_ID_

Используется: Товары, Категории, Производители
Формат поля: Целое число
Данное поле можно импортировать только в режиме «Только добавить» для новых товаров и новых производителей.

_IMAGE_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Изображение товара (категории или производителя), в виде имени файла и отностилеьного пути до директории с изображением.

Для OpenCart 1.5.x используется data/:

data/mycatalog/panaconik/my01010.jpg

Для OpenCart 2.x используется catalog/:

catalog/mycatalog/panaconik/my01010.jpg

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

Если включена опция «Докачка изображений», то в качестве значения должна быть указана ссылка на изображение

http://www.example.com/my_directory/image_name_01010.jpg

_IMAGES_

Используется: Товары
Формат поля: Текст в одну строку
Изображения товара, список названий, разделённых запятой, в виде имени файла и относительного пути до директории с изображением.

Для OpenCart 1.5.x используется data/:

data/mycatalog/panaconik/my01010.jpg,data/mycatalog/panaconik/my01011.jpg,data/mycatalog/panaconik/my01020.jpg

Для OpenCart 2.x используется catalog/:

catalog/mycatalog/panaconik/my01010.jpg,catalog/mycatalog/panaconik/my01011.jpg,catalog/mycatalog/panaconik/my01020.jpg

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

Если включена опция «Докачка изображений», то в качестве значения должна быть указаны ссылки на изображение

http://www.example.com/my_directory/image_name_01.jpg,http://www.example.com/my_directory/image_name_02.jpg

_ISBN_

Используется: Товары
Формат поля: Текст в одну строку
Международный стандартный книжный номер.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_JAN_

Используется: Товары
Формат поля: Текст в одну строку
Японский номер товара.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_LENGTH_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара длина

_LOCATION_

Используется: Товары
Формат поля: Текст в одну строку
Расположение где-либо, как-либо или в чём (доставерно не известно).
Имеет ограничение по количеству символов (поле в таблице MySQL).

_MAIN_CATEGORY_

Используется: Товары
Формат поля: Перечисление категорий в одну строку с разделителем вертикальная черта (|)
Пример:

Категория|Подкатегория|Подкатегория|Категория_товара

Данное поле есть только в версии ocStore.

_MANUFACTURER_

Используется: Товары
Формат поля: Текст в одну строку
Наименование производителя (Бренда).
Если такого производителя в магазине не существует, будет производитель будет создан автоматически.

_META_DESCRIPTION_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Мета-тег Description описание страницы (из области: что-то там про SEO-оптимизацию).

_META_KEYWORDS_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Мета-тег Keywords ключевые слова (из области: что-то там про SEO-оптимизацию).

_MODEL_

Используется: Товары
Формат поля: Текст в одну строку
Модель товара, если такая имеется.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_MPN_

Используется: Товары
Формат поля: Текст в одну строку
Номер производителя.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_NAME_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Импортируется или экспортируется в зависимости от выбранного языка (опция Локализация)

_OPTIONS_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить опции товара.
Описание: Импорт-экспорт Опций

_POINTS_

Используется: Товары
Формат поля: Целое число
Количество баллов для покупки товара.

_PRICE_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Цена товара.
Пример:

2341.90

_PRODUCT_TAG_

Используется: Товары
Формат поля: Текст в одну строку
Теги товара, список слов или словосочетаний разделённых запятой.

_QUANTITY_

Используется: Товары
Формат поля: Целое число
Количество товара (ведение склада по магазину).

_RELATED_

Используется: Товары
Формат поля: Строка в виде перечисления ID товаров через запятую
Сопутствующие товары (вкладка Связи в редактировани товара)
Пример

34,12,45,33

Также может быть использован другой заголовок и данные о товаре:
_RELATED_ID_ — строка в виде перечисления ID товаров через запятую (синоним для _RELATED_);
_RELATED_NAME_ — строка в виде перечисления наименований товаров через запятую;
_RELATED_MODEL_ — строка в виде перечисления моделей товаров через запятую;
_RELATED_SKU_ — строка в виде перечисления SKU(артикулов) товаров через запятую;
_RELATED_MPN_ — строка в виде перечисления MPN товаров через запятую;
_RELATED_EAN_ — строка в виде перечисления EAN товаров через запятую;
_RELATED_JAN_ — строка в виде перечисления JAN товаров через запятую;
_RELATED_ISBN_ — строка в виде перечисления ISBN товаров через запятую;

_SEO_KEYWORD_

Используется: Товары, Категории, Производители
Формат поля: Текст без пробелов и разделителей
Это поле соответствует SEO URL и должно быть уникальным на всю систему.

_SHIPPING_

Используется: Товары
Формат поля: Целое число (0 или 1)
Статус доставки (Необходима доставка), 0 = Нет, 1 = Да

_SKU_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Артикул товара (произвольный или по базе Вашего склада например).
Имеет ограничение по количеству символов (поле в таблице MySQL).

_SORT_ORDER_

Используется: Товары, Категории, Производители
Формат поля: Целое число
Порядок сортировки (што будем видеть в первых рядах)

_SPECIAL_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить акции товара.
Формат поля это список скидок разделённых переносом строки, одна строка = одна акция со значениями через запятую:

(ID группы покупателей,Приоритет,Цена,Дата начала,Дата окончания) — где даты можно пропустить
Пример:

 1,3,999.00   1,2,799.00,2012-10-01   1,1,699.00,2012-10-01,2012-10-31

_STATUS_

Используется: Товары, Категории, Производители
Формат поля: Целое число (0 или 1)
Статус, где 0 = выключен, 1 = включен.

_STOCK_STATUS_ID_

Используется: Товары
Формат поля: Целое число
ID статуса (Остутствие на складе).

_STOCK_STATUS_

Используется: Товары
Формат поля: Текст в одну строку
Статус, показываемый, когда товара нет на складе (Остутствие на складе), содаётся автоматически если такого статуса нет в базе магазина.

_TOP_

Используется: Категории
Формат поля: Целое число
Показывать в главном меню (только для главных родительских категорий).

_UPC_

Используется: Товары
Формат поля: Текст в одну строку
Номер производителя.
Имеет ограничение по количеству символов (поле в таблице MySQL).
Американский стандарт штрих-кода

_WEIGHT_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Вес товара (кг, мг, и тд.)

_WIDTH_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара ширина

www.opencartlabs.ru

Создание CSV-файла импорта

Создать CSV-файл можно с помощью любого текстового редактора или соответствующего приложения, например Microsoft Office Excel. Отформатируйте файл, как описано далее в этом разделе и сохраните его с расширением CSV или TXT.

В первой строке, т. е. в строке заголовков CSV-файла содержатся имена атрибутов или полей, значения которых находятся в последующих строках. Имя каждого атрибута отделяется запятой.

Каждая строка под строкой заголовков представляет одного пользователя и содержит данные, используемые для создания этого пользователя. Атрибуты в строке должны следовать в том же порядке, что и имена атрибутов в строке заголовков. Значение каждого атрибута отделяется запятой.

Для получения образца CSV-файла, используемого в качестве шаблона для создания собственного CSV-файла импорта, в диалоговом окне «Импорт пользователей» щелкните ссылку на образец CSV-файла.

Формат CSV-файла

Ниже приведен пример формата CSV-файла импорта, содержащего необходимые атрибуты для создания управляемых пользователей. В этом примере импортируются три новых пользователя.

Name,EmailAddress,FirstName,LastName,Password adamsta0109,terrya@contoso.edu,Terry,Adams,1091990 beebeab0211,annb@contoso.edu,Ann,Beebe,2111991 cannocc0328,chrisc@contoso.edu,Chris,Cannon,3281986 

Столбцы в CSV-файле

Один и тот же атрибут в каждой строке образует столбец. В этом примере имена столбцов совпадают с атрибутами в строке заголовков. В данном примере пять столбцов: Name, EmailAddress, FirstName, LastName и Password. Например, столбец EmailAddress содержит адрес электронной почты для каждого нового пользователя: terrya@contoso.edu, annb@contoso.edu и chrisc@contoso.edu.

Тот же CSV-файл в приложении Excel.

Кодировка файла

Если CSV-файл содержит знаки, не входящие в ASCII, или специальные символы, сохраните его в кодировке UTF-8 или другой кодировке Юникода. В зависимости от приложения сохранить CSV-файл в кодировке UTF-8 или другой кодировке Юникода может оказаться проще, если язык системы соответствует языку, используемому в CSV-файле.

В начало страницы

Обязательные атрибуты

В этой таблице представлено описание атрибутов, необходимых для импорта новых пользователей. При отсутствии одного из атрибутов в строке заголовка CSV-файла импорта процесс импорта выполнить не удастся.

Примечание.   Вводить атрибуты следует именно так, как они представлены. Атрибуты не должны содержать пробелов. Это должно быть одно слово. Например, First Name является недопустимым. Следует ввести FirstName.

Атрибут	Описание
Имя	Name указывает идентификатор пользователя. Значение Name должно быть уникальным в пределах домена. Важно!   Значение атрибута Name используется в качестве отображаемого имени в списке почтовых ящиков в панели управления Exchange и общей адресной книге, если не включен атрибут DisplayName, являющийся необязательным.
EmailAddress	EmailAddress указывает адрес электронной почты нового пользователя. Он также используется для создания соответствующего идентификатора Windows Live ID. Значение EmailAddress должно быть уникальным в пределах домена.
FirstName	FirstName указывает имя пользователя.
LastName	LastName указывает фамилию пользователя.
Password	Password — исходный пароль, назначенный идентификатору Windows Live ID, который создается для пользователя почтового ящика. Если пользователи организации Live@edu должны сменить пароли при первом входе в учетную запись, используйте атрибут ForceChangePassword. Примечание.   Параметр требования изменения паролей недоступен для организаций, система электронной почты в которых основана на Microsoft Online.

В начало страницы

Необязательные атрибуты

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

Атрибут	Описание
DisplayName	DisplayName указывает способ отображения имени пользователя в адресной книге в списке почтовых ящиков в панели управления Exchange. Если при импорте новых пользователей или при использовании пустого значения атрибут DisplayName не включен, значение атрибута Name используется для DisplayName.
CustomAttributeN, где N — целое число от 1 до 15.	Атрибуты CustomAttributeN используются для хранения сведений о пользователях, например является ли пользователь студентом, преподавателем или выпускником, или для хранения альтернативного адреса электронной почты. Атрибуты CustomAttributeN не отображаются в панели управления Exchange и общей адресной книге. Для просмотра атрибутов CustomAttributeN, назначенных пользователю, служит Windows PowerShell.
EvictEASI	Если значение атрибута EvictEASI равно 1, то для нового пользователя используется неуправляемый Windows Live ID, указанный в столбце EmailAddress. Неуправляемый Windows Live ID связывается с новым почтовым ящиком; все имеющиеся параметры, включая пароль и баллы продуктов, сохраняются. Идентификатор Windows Live ID при этом переводится в состояние принудительного переименования. Пользователь сможет войти в систему, используя этот идентификатор Windows Live ID и соответствующий пароль, но тут же получит запрос на переименование идентификатора Windows Live ID. Пользователь должен указать адрес электронной почты, не входящий в облачный домен. Дополнительные сведения см. в разделе Импорт или исключение существующих идентификаторов Windows Live ID.
ForceChangePassword	Чтобы принудить новых пользователей сменить пароль при первом входе, используйте атрибут ForceChangePassword. Если атрибут ForceChangePassword не используется, новым пользователям не нужно будет изменять пароли, заданные в CSV-файле импорта. Примечание.   Этот атрибут могут использовать только организации Live@edu. При включении этого атрибута в CSV-файл импорта в организации Microsoft Online процесс импорта завершится ошибкой.
ImportEASI	Если значение атрибута ImportEASI равно 1, то для нового пользователя используется неуправляемый Windows Live ID, указанный в столбце EmailAddress. Идентификатор Windows Live ID и все существующие параметры сохраняются. Этот идентификатор сопоставляется с новым почтовым ящиком, созданным в ходе импорта. Дополнительные сведения см. в разделе Импорт или исключение существующих идентификаторов Windows Live ID.
MailboxPlan	План почтового ящика определяет общие параметры по умолчанию при создании новых пользователей. Атрибут MailboxPlan указывает планы почтовых ящиков для пользователей. Если атрибут MailboxPlan не задан, используется план почтового ящика организации по умолчанию. Чтобы просмотреть список планов почтового ящика в организации, введите следующую команду:Get-MailboxPlan | FL DisplayName Дополнительные сведения о планах почтовых ящиков см. в разделе Планы почтовых ящиков для Outlook Live.
City	City указывает город пользователя в адресной книге.
Company	Company указывает название организации пользователя в адресной книге.
CountryorRegion	CountryorRegion указывает название страны или региона, указываемое для пользователя в адресной книге. Для поиска допустимых значений для атрибута CountryorRegion в облачной электронной почте последовательно выберите пункты «Параметры» > «Учетная запись» > «Изменить» > «Расположение контакта». Все допустимые значения для страны или региона представлены в раскрывающемся меню.
Department	Department указывает отдел пользователя в адресной книге.
Fax	Fax указывает номер факса пользователя в адресной книге.
HomePhone	HomePhone указывает номер домашнего телефона пользователя в адресной книге.
Initials	Initials указывает инициалы пользователя в адресной книге.
MobilePhone	MobilePhone указывает номер мобильного телефона пользователя в адресной книге.
Примечания	Поле Notes указывает дополнительные сведения о пользователе в адресной книге.
Office	Office указывает комнату пользователя в адресной книге.
Phone	Phone указывает номер рабочего телефона пользователя в адресной книге.
PostalCode	PostalCode указывает почтовый индекс пользователя в адресной книге.
StateorProvince	StateorProvince указывает область или край пользователя в адресной книге.
StreetAddress	StreetAddress указывает почтовый адрес пользователя в адресной книге.
Title	Title указывает должность пользователя в адресной книге.
WebPage	WebPage указывает веб-страницу пользователя в адресной книге.

В начало страницы

Пример CSV-файла импорта

Используйте этот пример в качестве шаблона для создания своих CSV-файлов импорта. Нажмите кнопку «Скопировать код» и вставьте его в файл Excel или текстовый файл.

CSV-файл для управляемых пользователей

Этот пример CSV-файла импорта содержит обязательные атрибуты для создания управляемых пользователей.

Name,EmailAddress,FirstName,LastName,Password adamsta0109,terrya@contoso.edu,Terry,Adams,1091990 beebeab0211,annb@contoso.edu,Ann,Beebe,2111991 cannocc0328,chrisc@contoso.edu,Chris,Cannon,3281986 desaipd0430,prashanthd@contoso.edu,Prashanth,Desi,4301989 ersanee0529,ebrue@contoso.edu,Ebru,Ersan,5291988 flipffo0628,florencef@contoso.edu,Florence,Flipo,6281989 garciadg0726,debrag@contoso.edu,Debra,Garcia,7271986 halbeph0826,pernilleh@contoso.edu,Pernille,Halberg,8261986 ilyinji0925,julial@contoso.edu,Julia,Ilyina,9251985 johnstj1024,tamaraj@contoso.edu,Tamara,Johnston,10241987