Печать
Справочник по разделу Печать в настройках DataMobile: типы печати, параметры Bluetooth-принтера, каталоги шаблонов и переменные, которые DataMobile подставляет в шаблон при печати.
Типы печати
| Тип печати | Описание |
|---|---|
| Bluetooth-принтер | Печать на беспроводной принтер по шаблонам печати. Параметры — в разделе Bluetooth-принтер. |
| Печать в файл | Запись данных для печати в файл на устройстве. Параметры — в разделе Печать в файл. |
| Сервер печати | Печать через сервер печати. Параметры — в разделе Сервер печати. |
Bluetooth-принтер
Основные настройки
| Параметр | Описание |
|---|---|
| Принтер | Беспроводной принтер, на который отправляется печать. |
| Кол-во этикеток в документе | Количество этикеток товара при печати из документа: Одна — одна этикетка; Кол-во подобранных позиций — столько этикеток, сколько товара подобрано в документе; Кол-во в задании — столько этикеток, сколько товара в документе по заданию. |
| Кодировка печати | Кодировка файла при печати на Bluetooth-принтер: Windows-1251 или UTF-8. |
| TSPL | Экранирует специальные символы в переменных для языка TSPL — языка принтеров TSC и других марок, которые используют TSPL. Если параметр включён, символ " в значениях всех переменных заменяется на \["]. Включение TSPL выключает ZPL. |
| ZPL | Экранирует специальные символы в переменных для языка ZPL — языка принтеров Zebra и других марок, которые используют ZPL. Если параметр включён, символ _ в значениях всех переменных заменяется на __. Включение ZPL выключает TSPL. |
| Длина строки | Максимальное количество символов до переноса на следующую строку. |
| Перенос строки по словам | Перенос строк без разрыва слов. |
| Таймаут соединения | Время, после которого соединение с Bluetooth-принтером закрывается. Таймаут сбрасывается после каждой успешной печати. |
| Управляющий символ GS1 | Управляющий символ GS1 для значения с динамической длиной: ~], ~d029, ~1, _1 или Не использовать. |
Шаблоны печати
В разделе Шаблоны задаются шаблоны печати для Bluetooth-принтера.
| Шаблон | Что печатается по шаблону |
|---|---|
| Товар | Этикетка товара. |
| Код маркировки | Код маркировки. |
| Промо-товар | Этикетка товара с промо-ценой. |
| Документ | Документ. |
| Упак. лист | Упаковочный лист. |
| Печать копии ШК | Копия штрихкода. |
Кнопка Восстановить шаблоны печати возвращает типовые шаблоны печати, если их удалили или изменили.
Файлы и каталоги шаблонов
Файлы шаблонов пишутся на языке принтера, который подключён к устройству по Bluetooth: ZPL, EPL, TSPL и других.
Шаблоны хранятся во внутренней памяти устройства в каталоге /Android/data/com.scanport.datamobilex/files/default/PrnMask/, где default — название профиля в приложении. По умолчанию профиль называется default.
| Каталог | Назначение |
|---|---|
all | Шаблоны, доступные во всех операциях |
art | Шаблон для печати товара |
km | Шаблон для печати КМ |
promoart | Шаблон для печати промо-товара |
doc | Шаблон для печати документа |
art_in_doc | Шаблоны для печати товара из документа |
upl | Шаблон для печати упаковочного листа |
copybarcode | Шаблон для печати копии штрихкода |
Переменные для печати на Bluetooth-принтер
Набор переменных зависит от типа и вида операции печати и от того, какие данные есть на устройстве. Переменные сгруппированы по операциям печати.
Печать этикеток и проверка ценника
Переменные для шаблонов Товар, Промо-товар и печати товара из документа.
Цены
| Переменная | Значение |
|---|---|
@Price@ | Цена товара — дробное число с двумя знаками после запятой |
@Price1@ | Дополнительная цена товара 1 — дробное число с двумя знаками после запятой |
@Price2@ | Дополнительная цена товара 2 — дробное число с двумя знаками после запятой |
@Price3@ | Дополнительная цена товара 3 — дробное число с двумя знаками после запятой |
@PriceDiscount@ | Промо-цена (цена со скидкой / скидка) |
@PriceDiscountWhole@ | Промо-цена, округлённая до целого |
@PriceWhole@ | Цена товара, округлённая до целого |
@Price1Whole@ | Дополнительная цена товара 1, округлённая до целого |
@Price2Whole@ | Дополнительная цена товара 2, округлённая до целого |
@Price3Whole@ | Дополнительная цена товара 3, округлённая до целого |
@PriceFraction@ | Цена товара без форматирования |
@Price1Fraction@ | Дополнительная цена товара 1 без форматирования |
@Price2Fraction@ | Дополнительная цена товара 2 без форматирования |
@Price3Fraction@ | Дополнительная цена товара 3 без форматирования |
@PriceInteger@ | Целая часть цены товара |
@Price1Integer@ | Целая часть дополнительной цены товара 1 |
@Price2Integer@ | Целая часть дополнительной цены товара 2 |
@Price3Integer@ | Целая часть дополнительной цены товара 3 |
Штрихкод и атрибуты
| Переменная | Значение |
|---|---|
@Barcode@ | Штрихкод |
@BarcodeFull@ | Полный штрихкод |
@SN@ | Значение поля Серийный номер из формы печати этикеток (устаревшая переменная) |
@Measure@ | Тип измерения — штучный или весовой — либо имя штрихкода |
@Attr1@ | Атрибут товара 1 |
@Attr2@ | Атрибут товара 2 |
@Attr3@ | Атрибут товара 3 |
@Attr4@ | Атрибут товара 4 |
@Attr5@ | Атрибут товара 5 |
@Attr6@ | Атрибут товара 6 |
@Attr7@ | Атрибут товара 7 |
@Attr8@ | Атрибут товара 8 |
@Attr9@ | Атрибут товара 9 |
@Attr10@ | Атрибут товара 10 |
Наименование
X — значение параметра Длина строки, по умолчанию 30 символов.
| Переменная | Значение |
|---|---|
@Name1@ | Наименование товара с 1-го по X-й символ |
@Name2@ | Наименование товара с X+1-го по 2X-й символ |
@Name3@ | Наименование товара с 2X+1-го по 3X-й символ |
Количество и коэффициент
| Переменная | Значение |
|---|---|
@Quant@ | Количество копий (этикеток) |
@Coef@ | Количество подобранной строки в документе либо 1 |
@QtyInt@ | Целая часть количества подобранной строки документа, округлённого до трёх знаков после запятой. Если в целой части меньше двух знаков, в начало добавляется ноль |
@QtyWholeInt@ | Целая часть количества подобранной строки документа, округлённого до трёх знаков после запятой, без нуля в начале |
@QtyFrac@ | Дробная часть количества подобранной строки документа, округлённого до трёх знаков после запятой |
@Qty_310%s_GS1@ | Количество товара в формате GS1 — тег 310y стандарта GS1. %s — число от 1 до 5, количество знаков после запятой. Значение всегда состоит из шести символов |
@Kf@ | Коэффициент штрихкода |
@Kf1@ | Целая часть коэффициента штрихкода |
@Kf2@ | Дробная часть коэффициента штрихкода |
Значения @Qty_310%s_GS1@ для количества 5.657:
| Переменная | Значение на печати |
|---|---|
@Qty_3101_GS1@ | 000056 |
@Qty_3102_GS1@ | 000565 |
@Qty_3103_GS1@ | 005657 |
@Qty_3104_GS1@ | 056570 |
@Qty_3105_GS1@ | 565700 |
Даты
| Переменная | Значение |
|---|---|
@Date-@ | Дата печати в формате dd-MM-yyyy |
@Date.@ | Дата печати в формате dd.MM.yyyy |
@Date@ | Дата печати в формате yyyy-MM-dd HH:mm:ss |
Серии
%value% — AI-тип серии (тег).
| Переменная | Значение |
|---|---|
@SN_TYPE_%value%@ | Серия заданного типа: номер партии, дата производства, срок годности, номер ГТД и т. п. |
@sn_type_%value%_gs1@ | Серия заданного типа при печати GS1 DataMatrix |
Данные документа
| Переменная | Значение |
|---|---|
@DocNumber@ | Номер документа |
@DocDate@ | Дата документа в формате dd.MM.yyyy HH:mm:ss |
@Client@ | Контрагент документа |
@Warehouse@ | Склад-отправитель документа |
@Warehouse2@ | Склад-получатель документа |
@Comment@ | Комментарий документа |
Дополнительные формы
Переменные для вывода дополнительных форм в режимах Авто и По умолчанию. %d — порядковый номер дополнительной формы в шаблоне.
| Переменная | Значение |
|---|---|
@RowAttribute%dTitle@ | Наименование атрибута дополнительной формы строки |
@RowAttribute%dValue@ | Значение атрибута дополнительной формы строки |
Пример шаблона этикетки товара на языке TSPL для принтера TSC:
Печать КМ (GS1 DataMatrix)
Если в таблице print_marks локальной базы устройства есть объект PrintKiz, значения переменных берутся из него. Таблица заполняется, если КМ для печати выгружены в локальную базу, например офлайн-обработкой — см. Маркировка.
Если товар найден, в шаблон передаются все переменные товара из раздела Печать этикеток и проверка ценника. Если товар не найден, передаются только переменные из этой таблицы.
| Переменная | Значение |
|---|---|
@gtin@ | GTIN — подстрока КМ со 2-го по 16-й символ |
@sn@ | Серийный номер — подстрока КМ с 18-го по 31-й символ |
@dmx91@ | Тег 91 — подстрока КМ с 33-го по 37-й символ |
@dmx92@ | Тег 92 — подстрока КМ с 40-го символа до конца строки |
Пример шаблона на языке TSPL для принтера TSC с переменными для кода маркировки:
Печать копии штрихкода (EAN, Code 128)
Если товар найден, в шаблон передаются все переменные товара из раздела Печать этикеток и проверка ценника. Если товар не найден, передаются только переменные из этой таблицы.
| Переменная | Значение |
|---|---|
@Barcode@ | Штрихкод без специальных символов |
@Quant@ | Количество копий, всегда 1 |
Печать копии штрихкода (GS1, GS1 DataMatrix, КМ)
Если товар найден, в шаблон передаются все переменные товара из раздела Печать этикеток и проверка ценника. Для печати КМ маркированного товара передаются также переменные из этой таблицы. %d — порядковый номер тега.
| Переменная | Значение |
|---|---|
@tag%dname@ | Код тега AI |
@tag%dvalue@ | Значение тега AI |
@barcodetype@ | Тип штрихкода, если его удалось определить |
@gs1barcode@ | Штрихкод, собранный из AI-кодов |
@BarcodeMarkingKi@ | Код идентификации (КИ) |
Если отсканирован штрихкод типа GS1, значение переменной @Barcode@ на печать не передаётся.
К значениям тегов GS1 переменной длины в конце добавляется символ из параметра Управляющий символ GS1.
Пример шаблона с этими переменными и результат печати в файл с управляющим символом ~] (символ GS):
Документ
| Переменная | Значение |
|---|---|
@Now@ | Время печати в формате yyyy-MM-dd HH:mm:ss |
@Name@ | Имя шаблона документа |
@Date@ | Дата документа в формате dd.MM.yyyy HH:mm:ss |
@Number@ | Номер документа |
@Client@ | Контрагент документа |
@Comment@ | Комментарий документа |
@QRData@ | Штрихкоды из логов подбора и размещения, каждый с новой строки |
@DocBarcode@ | Штрихкод документа |
@PlaceQtySelect@ | Количество в логах подбора |
@PlaceQtyInsert@ | Количество в логах размещения |
@SumOfDetailsSelect@ | Общая стоимость в логах подбора |
@SumOfDetailsInsert@ | Общая стоимость в логах размещения |
@Quant@ | Количество копий |
Упаковочный лист
| Переменная | Значение |
|---|---|
@Now@ | Текущее время в формате yyyy-MM-dd HH:mm:ss |
@Date@ | Время документа в формате dd.MM.yyyy HH:mm:ss |
@Number@ | Номер документа |
@Comment@ | Комментарий документа |
@Client@ | Контрагент документа, если он указан |
@Quant@ | Количество копий, всегда 1 |
@Pack@ | Штрихкод упаковки без скобок SSCC |
Печать в файл
При типе печати Печать в файл DataMobile записывает данные для печати в каталог /Android/data/com.scanport.datamobilex/files/print во внутренней памяти устройства.
Файлы формируются по шаблонам из раздела Шаблоны печати и содержат те же данные, что ушли бы на Bluetooth-принтер.
Если включён параметр Сохранять файл в каталог обмена, файлы печати сохраняются в каталог обмена:
| Тип обмена | Каталог |
|---|---|
| Локальный | files/default/out/others/print |
| FTP | FTP/DataMobile/out/others/print |
| Яндекс Диск | Приложения/DataMobile/out/others/print |
Сервер печати
Настройка сервера печати описана в разделе Сервер печати.
Сервер печати можно скачать с FTP-сервера компании или с Яндекс Диска.