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 и value

Описание type format
GS1 DataMatrix DATAMATRIX_GS

Опционально

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

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

"12345678" -> "12345"

НЕ-GS1 DataMatrix

Без FNC1 и GS

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

DATAMATRIX_NON_GS

Опционально

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

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

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

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

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

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

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

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


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

h – цифра часа

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

 

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

"hh:mm dd/MM/yy"

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

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

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

 "00812345678918" -> "0812345678918"

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

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

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

 "0081234567891" -> "081234567891"

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

Опционально

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

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

CUSTOM_ATTRIBUTE_TEXT_TO_BMP


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

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

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

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

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

Опционально

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

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

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

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

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

TOTAL_CAPACITY
-

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

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

NEXT_LEVEL_COUNTER

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

 

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


Изображение формата .bmp, расположенное в папке /img рядом с исполняемым .jar 
IMAGE
-

Конвертируемое в текст значение переменной
VARIABLE_TO_TEXT
-

Конвертируемое в .bmp картинку текстовое значение переменной
VARIABLE_TO_BMP
-

Номер линии
LINE
-

Номер короба
BOX_NUMBER
-

EAN продукции
EAN
-

SKU продукции

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

SKU
-