Skip to main content

Всё о переменных шаблона печати СМАРТ Л2

История обновлений документа:

  • 06.08.24: добавлены все основные параметры

  • 14.11.24: добавлены aggregation_capacity, code_128, custom_attribute

  • 23.05.25:

1) Общая структура файла

В папке /template-vars рядом с smartl2.jar файл example.vars представляет собой JSON следующего формата:

{
    "label": {
		"height": "320",
		"width": "640"
	},
	"variables": {
		"название_переменной_1": {
			"type": "тип_переменной"
		},
		"название_переменной_2": {
			"type": "тип_переменной"
		},
		"название_переменной_3": {
			"type": "date",
			"format": "dd/MM"
		},
		"название_переменной_4": {
			"type": "text",
			"value": "годен до: "
		},
		"название_переменной_5": {
			"type": "тип_переменной",
			"regex": ".*/(\\d{6})"
		}
		...
	}
}

Где название_переменной_Х соответствует названию переменной в шаблоне принтера с названием example. Например, var1-1, var100, 6501310, <BATCH_SERIAL_NUMBER>.

Можно сохранить несколько шаблонов с разными названиями (example.vars, default.vars, dm1.vars). Нужный шаблон указывается в редакторе продукта в СМАРТ Л3 в поле шаблон для печати.

image.png

2) Поддерживаемые переменные шаблона

Следующая таблица описывает все допустимые значения параметра type, а также доступные им значения поляараметра format

type Описание typeformat format
DATAMATRIX_GSGS1 DataMatrixDATAMATRIX_GS

Опционально

Длина кода, до которой нужно обрезать его с конца

 

Пример: "format":"5"

"12345678" -> "12345"


DATAMATRIX_NON_GS

НЕ-GS1 DataMatrix

Без FNC1 и GS

Например, сигареты

DATAMATRIX_NON_GS

Опционально

Длина кода, до которой нужно обрезать его с конца


SGTIN_SERIAL_21 Серийный номер SGTIN, AI 21SGTIN_SERIAL_21

Длина серийного номера в коде этой товарной группы

 

Пример: "format":"6" для молока или "13" для БАДов


SGTIN_SERIAL_NON_GS Серийнный номер SGTIN, без AI SGTIN_SERIAL_NON_GS- -
SGTIN_91 ID криптохвоста SGTIN, AI 91 SGTIN_91- -
SGTIN_92 Криптохвост SGTIN, AI 92 SGTIN_92- -
SGTIN_93 Криптохвост SGTIN, AI 93 SGTIN_93- -
BATCH_NAME Название партии BATCH_NAME- -
SERIES_NAME

Название серии

SERIES_NAME- -
DATE_PRODUCTION Дата производстваDATE_PRODUCTION

Формат даты, где


y – цифра года
M – цифра месяца
d – цифра дня

h – цифра часа

m – цифра минут

 

Примеры: 
"dd.MM.yyyy"
"dd-MM-yy"
"dd/MM"

"hh:mm dd/MM/yy"


DATE_EXPIRE Дата истечения срока годности DATE_EXPIRE
DATE_CURRENT Текущая дата DATE_CURRENT
DATE_AGGREGATION Дата агрегации DATE_AGGREGATION
TEXT Пользовательский текст TEXT- -
PRODUCT_NAME Название продукции PRODUCT_NAME-
GTIN GTIN продукцииGTIN

Длина GTIN, до которой нужно обрезать его с начала

 

Пример: "format":"13"

 "00812345678918" -> "0812345678918"


GTIN_NON_CHECK_DIGIT GTIN продукции без контрольной цифры (последняя цифра в GTIN) GTIN_NON_CHECK_DIGIT

Длина GTIN, до которой нужно обрезать его с начала

 

Пример: "format":"12"

 "0081234567891" -> "081234567891"


CODE_128 Линейный код GS1-128CODE_128

Опционально

Длина кода, до которой нужно обрезать его с конца


CODE_128_BMP Линейный код GS1-128, конвертируемый в .bmp изображение CODE_128_BMP- -
CUSTOM_ATTRIBUTE Специфичный параметр продукта CUSTOM_ATTRIBUTE- -

CUSTOM_ATTRIBUTE_TEXT_TO_BMP

Специфичный параметр продукта, конвертируемый в .bmp изображение

CUSTOM_ATTRIBUTE_TEXT_TO_BMP

-
-
MRP МРЦ продукции для табачных ТГ MRP- -
WEIGHT Вес / объём продукции WEIGHT- -
ACTUAL_WEIGHT Общий вес всех продуктов в агрегате ACTUAL_WEIGHT- -
AGGREGATION_CAPACITY Ёмкость групповой упаковки конкретного уровняAGGREGATION_CAPACITY

"1" для групповой упаковки

"2" для транспортной

"3" для паллетной и выше 


ACTUAL_CAPACITY Реальное количество вложений в текущем агрегатеACTUAL_CAPACITY

Опционально

"1" для групповой упаковки

"2" для транспортной

"3" для паллетной и выше 


TOTAL_CAPACITY

Общее количество вложений самого нижнего уровня в агрегате

Например: 50, если в одной транспортной упаковке 10 групповых, в которых по 5 индивидуальных

TOTAL_CAPACITY- -
NEXT_LEVEL_COUNTER

Количество кодов в упаковке следующего уровня

Например: 3 короб из 50 (AGGREGATION_CAPACITY = 50) 

NEXT_LEVEL_COUNTER

ID группы устройств

 

Пример: "format":"1"


IMAGE Изображение формата .bmp, расположенное в папке /img рядом с исполняемым .jar  IMAGE- -
VARIABLE_TO_TEXT Конвертируемое в текст значение переменной VARIABLE_TO_TEXT- -
VARIABLE_TO_BMP Конвертируемое в .bmp картинку текстовое значение переменной VARIABLE_TO_BMP- -
LINE Номер линии LINE- -
BOX_NUMBER Номер короба BOX_NUMBER- -
EAN EAN продукции EAN- -
SKU

SKU продукции

(артикул / ID в товароучётной системе)

SKU- -

Далее описаны параметры и их значения, применимые для отдельных типов переменных

typeОписаниеПараметрЗначение
GTINУровень упаковки для GTIN

value

 

(тип данных string)

"SGTIN" - GTIN товара

"GROUP" - GTIN групповой упаковки

"TRANSPORT" - GTIN транспортной упаковки

"PALLET" - GTIN паллетной упаковки

 

Пример: "value":"SGTIN"

TEXTТекстовое значение для печати

Текст, который будет отправлен на печать


Пример: "value":"Колбаса"

CUSTOM_ATTRIBUTE

CUSTOM_ATTRIBUTE_TEXT_TO_BMP

 

Название атрибута продукта

Название атрибута продукта, из которого будет взято значение для печати

 

Пример: "value":"attr_1"