Обмен данными CSV

Категории:  Mobile SMARTS: КИЗ
Последние изменение: 02.06.2017

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

Обмен данными


Обмен данными происходит в два этапа:

Этап первый – выгрузка номенклатуры «На сервер» (1).

При нажатии на кнопку «На сервер» происходит выгрузка номенклатуры на сервер (на ТСД в батч режиме).

Этап второй – загрузка документов «С сервера» (2).

При нажатии на кнопку «С сервера» происходит загрузка выполненных документов с сервера (с ТСД в батч режиме).


Этап первый

Выгрузка номенклатуры

Для выгрузки номенклатуры на терминал необходимо положить в папку «На терминал» файл «Номенклатура.csv».

Если у Вас есть файл, полученный с сайта ГС1 (GS1), то просто положите его в папку «На терминал». Изменять его нет необходимости, программа поддерживает шаблон этого файла (начиная с версии 3.0.0.7). В настройках утилиты «Не читать первую строку данных» нужно проставить галочку.


Формат обмена (какие данные и в каком порядке идут в файле) задаётся в файле «…\XlsCsv\Templates\Upload\Номенклатура.csv».

Формат для CSV по умолчанию имеет следующий вид:

Название;Штрихкод

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

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

Основные колонки для шаблона номенклатуры:

Название колонки

Описание

Название

Наименование товара.

Штрихкод

Штрихкод товара (обычно EAN13).


Примеры

Пример корректного входного файла «Номенклатура.csv»:

Название;Штрихкод

Норковый полушубок, с мехом лисы. Меховая фабрика EL-EZER, Пятигорск;2000000003146
Норковый полушубок с мехом лисы. Пятигорская меховая фабрика EL-EZER;2000000003313
Норковый полушубок с мехом лисы. Меховая фабрика EL-EZER в Пятигорске;2000000003412
Пальто из кусковой норки от Пятигорской меховой фабрики EL-EZER;2000000003580
Норковый полушубок с соболем. Меховая фабрика EL-EZER, Пятигорск;2000000003962
Норковый жакет - отделка соболь. Меховая фабрика EL-EZER;2000000004594

Комментарии:

  • В качестве первой строки можно выгружать произвольные имена колонок, для удобства человека. Для этого в утилите добавлена настройка «Не читать первую строку данных»;



  • Каждая строка должна иметь ровно тоже число колонок, что задано в формате обмена. Если для данной позиции нет данных, то просто пропускаем его, ставя разделитель «;;»;
  • Значения, содержащие зарезервированные символы (двойная кавычка, запятая, точка с запятой, новая строка) обрамляются двойными кавычками ("); если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд;
  • Подробнее про формат CSV Вы можете прочитать по ссылке https://ru.wikipedia.org/wiki/CSV 

Этап второй

Загрузка документов

Файл документа для загрузки будет иметь имя, начинающееся с имени типа документа (например, Маркировка), после которого идет небуквенный и нецифровой символ, например, «№» или «#».

Итоговые загруженные файлы документа создаются автоматически по шаблону и попадают в папку «…\XlsCsv\С терминала\».

Шаблон документа для загрузки с ТСД описывает какие данные и в каком порядке попадут в итоговый файл csv.

Шаблон для загрузки документов с ТСД

Путь к шаблонам «…\XlsCsv\Templates\Download\».

Файл CSV:

#{Document};;;;;;
Имя;;;;;;
#{Document.CombinedItems};;;;;;
Штрихкод;Название;Принято;КИЗ;Серийный номер метки;TAGID;TID

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

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

Колонки для шаблона загрузки документа:

Название колонки

Описание

#{Document}

В CSV файле указание, что далее идут поля шапки документа для загрузки.

#{Document.CombinedItems}
#{Document.CurrentItems}
#{Document.DeclaredItems}

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

Штрихкод

Штрихкод товара (обычно EAN13).

Название

Наименование товара.

Принято

Фактическое количество, то которое отсканировали.

КИЗ

Контрольный идентификационный знак.

Серийный номер метки

Серийный номер метки, задается производителем на производстве.

TAGID

Поле памяти Tag ID, в которое при производстве обычно пишется код типа метки.

TID

Уникальный номер чипа. Поле TID — неизменяемое, и, таким образом, каждая метка является уникальной.

Примеры

Файл CSV загруженный с ТСД (например, Маркировка 10.02.16 13.23.csv)

Имя;;;;;;;

"Маркировка 10/02/16 13:23";"";"";"";"";"";"";""
"2000000005270";"Пальто из кусковой норки от меховой фабрики EL-EZER";"1";"RU-430301-ABCDEF1245";"193987947748";"3028001E848083ED2A952CE4";"E2801160200074E452A508A500000000"
"2000000004594";"Норковый жакет - отделка соболь. Меховая фабрика EL-EZER";"2";" RU-430301-ABCDEF1246";"193987947643";"3028001E848083ED2A952CE5";" E2801160200074E452A508A600000000"

Незаполненные поля загружаются в файл в виде разделителя «"";».


Смотрите также: