Общие сведения об импорте

Материал из Википедия ЭТИМа (ETIM Wikipedia)
Версия от 17:02, 2 июня 2022; Michael (обсуждение | вклад) (Описание формата {{Имя файла|.json}})
Перейти к навигации Перейти к поиску


Общее

В настоящий момент весовой комплекс LS515 поддерживает следующие варианты импорта данных:

  1. Импорт из файлов;
  2. Импорт по протоколам TCP/IP;
  3. Импорт из других программных продуктов с помощью встроенных в них средств.


Импорт из файлов

  1. Импорт данных из файлов в формате XML.
  2. Импорт данных из файлов в формате CSV: формат для весов Digi ПО QLoad (файлы с разделителями и файлы с фиксированными полями), фиксированный файл CSV, формат Леруа-Мерлен.
  3. Частичный импорт данных посредством непосредственного файлового обмена.


Параметры файлового импорта можно изменить в настройках ПО.


При использовании файлового импорта файлы с данными можно записывать в каталог обмена (по умолчанию это каталог /opt/Exchange/Import, данный каталог можно изменить в настройках) или на Flash-диск (USB или MicroSD).

При импорте данных о товарах используется корневой каталог Flash-диска или каталог /opt/Exchange/Import.

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


Зависимость имени каталога от вида данных:

Каталог Данные
Lic Лицензии
Settings Настройки
Labels Шаблоны этикеток
Images Картинки
AdPictures Картинки для рекламного слайд-шоу

Импорт по TCP/IP

  1. Импорт данных по протоколу R1Sensor;
  2. Импорт данных по протоколу ПО компании xArt "ART-TRADE";
  3. Импорт данных по протоколу весов Digi (например: SM-100, SM-300, SM-5000SB, SM-5300, RM-5800);
  4. Импорт данных по протоколу WEB API.
  5. Импорт данных по протоколу весов T-Scale (например: RBS KS4010).


Импорт из других программных продуктов

  1. Импорт с помощью нативных драйверов из ПО "1С 8.х";
  2. Импорт с помощью дополнительной обработки из ПО "1С Рарус";
  3. Импорт данных по протоколу весов Digi из ПО "ImageLoader";
  4. Импорт данных по протоколу весов Digi из ПО "СуперМаг";
  5. Импорт данных из ПО "SetRetail 10".


Особенности импорта товаров без групп

При импорте данных из некоторых программных продуктов (например 1С) невозможно передать на весы связь между товаром и группой, отображаемой на экране. Группы необходимы для обеспечения легкого выбора товаров пользователями (покупателями). Без использования товарных групп появляются ограничения на возможности выбора товаров. В таких случаях товары можно выбирать только с использованием кода товара, набирая его на экранной клавиатуре или с помощью автоматически сгенерированных групп.

Автоматические группы формируются на основании кодов и названий товаров. Например: визуальный интерфейс А7:


Для исключения подобных ситуаций в весах (начиная с версии ПО 1.0.2.22 сборка 4077) предусмотрена возможность создания файла связи между товарами и группами.

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

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

Файл может находится в любом каталоге на весах, его расположение и разрешение использования задается в настройках импорта.

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

Если в файле присутствует несколько товаров привязанных к одной группе, то параметры группы (название и картинки) достаточно задать у одной из записей.

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

Данный режим можно использовать при выполнении импорта товаров по любому из поддерживаемых весами протокола.


Файл содержащий информацию о связи импортируемых товаров с группами может быть представлен в одном их двух форматов: .csv или .json.


Описание формата .csv

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

Порядок следования полей:

Номер товара ; Номер группы ; Название группы ; Основная картинка группы ; Дополнительная картинка группы ;


Строка начинающаяся с символа # игнорируется.

Например, задание связи между товаром 116 и группой 1 (Выпечка) и задание картинок:

116;1;"Выпечка";"m_bread-group.png";"b_bread-group.png";


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

Описание формата .json

Файл в формате JSON Описание стандарта JSON можно найти на сайте.

On-line парсер формата JSON.


Информация о связях задается в файле в виде словаря. Ключевым параметром является номер товара. Для каждого товара задаются параметры группы.

При задании номера товара можно использовать диапазон номеров.

Например для диапазона с 1 по 100 товар, необходимо вместо номера товара указать: 1-100 или 1:100

Минимально необходимо задать номер группы к которой привязывается товар:

{
  "1-100": {
    "OwnerGroup": "1",
    "GroupName": "Выпечка",
    "GroupPicture": "m_bread-group.png",
    "GroupSecondPicture": "b_bread-group.png"
  },
  "116": {
    "OwnerGroup": "1",
    "GroupName": "Выпечка",
    "GroupPicture": "m_bread-group.png",
    "GroupSecondPicture": "b_bread-group.png"
  },
  "117": {
    "OwnerGroup": "1"
  },
  "118": {
    "OwnerGroup": "2",
    "GroupName": "Фрукты",
    "GroupPicture": "b_fruit-group.png",
    "GroupSecondPicture": "m_fruit-group.png"
  },
  "119": {
    "OwnerGroup": "2"
  }
}


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

Разрешение импорта только определенных товаров

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

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

При импорте товаров отсутствующих в списке данные товары будут игнорироваться.

Файл может находится в любом каталоге на весах, его расположение и разрешение использования задается в настройках импорта.

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

Данный режим можно использовать при выполнении импорта товаров по любому из поддерживаемых весами протокола.

Файл содержащий информацию о разрешении импортируемых товаров может быть представлен в одном их двух форматов: .csv или .json.


Описание формата .csv

В данном формате в каждой строке файла записывается номер товара и признак разрешения загрузки, разделенные символом ;.


Строка начинающаяся с символа # игнорируется.


Разрешение задается ключевым словом true или числом 1 или отсутствием второго параметра.


Запрет загрузки задается ключевым словом false или числом 0.

Так же запрет загрузки - это отсутствие товара в данном файле.


Например:


Запрещенные для загрузки товары:
116;false;
116;0;


Разрешенные для загрузки товары:
117;true;
117;1;
117;
Примеры файлов

Описание формата .json

Файл в формате JSON Описание стандарта JSON можно найти на сайте.

On-line парсер формата JSON.


Информация в файле может быть представлена в виде массива или словаря.

В виде массива информация содержит только номера разрешенных для загрузки товаров:

[
  "116",
  "117"
]


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

{
  "116" : "true",
  "117" : "true",
  "118" : "false",
  "119" : "0"
}


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