30.06.2021

Внешний компонент “1C:Печать штрихкодов” (Native) для платформы «1С: Предприятие 8.3»

Внешний компонент "1С:Печать штрихкодов" для платформы "1С:Предприятие 8.3" поставляется в составе «1С:Библиотеки подключаемого оборудования» (далее БПО) и «1С:Библиотеки стандартных подсистем» (далее БСП) . Компонент предназначен для формирования изображений штрихкодов в формате PNG на основе передаваемых в компонент данных и параметров построения изображения. Компонент может использоваться только совместно с программными продуктами системы "1С:Предприятие 8" на рабочих местах, обеспеченных Лицензией на использование системы программ "1С:Предприятие 8".

• Основные возможности
• Алгоритм генерации изображений ШК
• Невозможность генерации изображения
• Свойства
• Методы
• Особенности работы с GS1 кодами
• Пример генерации изображений штрихкода с помощью библиотек БПО и БСП

Основные возможности

Внешний компонент "1С:Печать штрихкодов" позволяет формировать изображения штрихкодов следующих типов: EAN8, EAN13, EAN13 AddOn 2, EAN13 AddOn 5, ITF14, RSS14, EAN128, Code39, Code39 Full ASCII, Code93, Code128, Code16k Industrial 2 of 5, Interleaved 2 of 5, CodaBar, PDF417, QR, GS1 databar extended stacked, DataMatrix ASCII, DataMatrix Base256, DataMatrix Text, DataMatrix C40, DataMatrix X12, DataMatrix Edifact, GS1 Datamatrix. Компонент позволяет автоматически определять тип штрихкода исходя из передаваемых параметров (см. раздел «Свойства компонента»).

Алгоритм генерации изображений ШК

Внешний компонент "1С:Печать штрихкодов" реализует следующий алгоритм генерации изображений ШК:

1. Валидация переданных параметров. На этапе валидации производится определение ТипаКода, если он не задан явно (см. свойство АвтоТип), преобразование ЗначенияКода в соответствии с ТипомВходныхДанных к внутреннему формату, а так же проверка возможности генерации ШК по полученным значениям.
2. Генерация штрихкода, как таблицы значений закрашенных и не закрашенных областей
3. Определение предельных габаритов ШК на изображении в соответствии с запрошенными Шириной и Высотой. Компонент рассчитывает максимально возможные размеры ШК, с элементами состоящими из максимального целого числа пикселей. Например, 1d ШК состоит из линий ширины 1ч-1б-2ч-2б-1ч - то есть 7(1+2+1 черных полосы и 1+2 белых), поэтому если будет запрошена Ширина, скажем, 27 пиксела, то будет сгенерирован ШК ширины 21 пиксел (максимальный кратный 7), остальное место на изображении останется не занятым. Таким образом, компонент генерирует точное растровое изображение: размер минимального элемента составляет минимум 1 пиксель и количество пикселей на элемент всегда целое.
4. Определение габаритов генерируемого изображения. Если свойство УбратьЛишнийФон не задано, то будет сгенерировано изображение запрошенных Ширины и Высоты, иначе, изображение такого же размера как размер ШК определенный на предыдущем этапе. Так в примере выше, считая что запрашиваемые Ширина Высота, скажем 27 и 10 соответственно, если свойство УбратьЛишнийФон принимает значение Ложь, то будет сгенерировано изображение 27х10, ШК на котором будет 21х10(1d ШК). Т.е 6 пикселей - по 3 с левой и правой стороны от значащей части ШК, будут оставаться пустыми. Если же свойство УбратьЛишнийФон установлено, то будет сгенерировано изображение 21х10 со значащей частью 21х10 изображающей ШК.

5. Генерация изображения ШК с учетом заданного угла поворота и других параметров визуализации. Графически это можно представить следующим образом:

В случае успешной генерации изображения ШК свойство Результат будет содержать значение 0.

Невозможность генерации изображения

Свойства

* Устаревшие свойства не используются в актуальных версиях компонента и будут удалены (станут недоступны) начиная с версии 10.1.1.1.

Методы

Особенности работы с GS1 кодами

К GS1 типам кодов относятся – EAN128, GS1 Datamatrix и GS1 Databar extended stacked. При задании ЗначенияКода GS1 кодов допускается две формы ввода:

1. В виде Строки. В этом случае ЗначениеКода должно содержать код GS1 в HRI (Human Readable Inеrpretation) виде, в котором коды групп применения заключены в круглые скобки, например, (01)04600822901507(11)161109(30)2434. В этом случае компонент интерпретирует строку как код GS1, раскрывает скобки, добавляет символ GS в конце каждой группы переменной длины и генерирует изображение, добавив графический символ начала кода FNC1.
2. В виде Строки Base64. В этом случае внешняя система передает в компонент двоичные данные, содержащие в соответствии со стандартом GS1 группы применения и символ GS завершения группы переменной длины. Компонент генерирует изображение полученных данных, добавляя в штрихкод лидирующий графический символ FMC1. Проверка данных на соответствие стандарту GS1 не производиться. Пример входного значения - MDEwMDg1MTc2ODAwMzAyMDIxPktvbzNLUkx0Z0YicB05M2RHVno=

Пример генерации изображений штрихкода с помощью библиотек БПО и БСП

В состав БПО и БСП включены и необходимые методы по инициализации компоненты “1C:Печать штрихкодов” (Native) и генерации изображений штрихкодов в прикладных решениях 1С.
Для генерации картинки штрикода необходимо использовать метод «ИзображениеШтрихкода()» общего модуля «ГенерацияШтрихкода»
Внешняя компонента будет загружена и инициализирована автоматически при первом вызове этого метода.
Подробное описание возможных значений входящих параметров даны в описании функции конструктора для заполнения структуры входящих параметров «ПараметрыГенерацииШтрихкода()» общего модуля «ГенерацияШтрихкода».

Пример использования компоненты в составе БПО или БСП может быть представлен следующим листингом

Копировать в буфер обмена

Функция ПолучитьШтрихкод(ШиринаШтрихкода, ВысотаШтрихкода)



	Функция ПолучитьШтрихкод(ЗначШтрихкод, ЗначТипШтрихкода)
 
     ПараметрыШтрихкода = ГенерацияШтрихкодаКлиентСервер.ПараметрыГенерацииШтрихкода();
 
     ПараметрыШтрихкода = ГенерацияШтрихкода.ПараметрыГенерацииШтрихкода();
     ПараметрыШтрихкода.Ширина = ШиринаШтрихкода;
     ПараметрыШтрихкода.Высота = ВысотаШтрихкода;
     ПараметрыШтрихкода.ТипКода = ЗначТипШтрихкода;
     ПараметрыШтрихкода.УголПоворота = Число(УголПоворота);
     ПараметрыШтрихкода.Штрихкод = ЗначШтрихкод;
     ПараметрыШтрихкода.ПрозрачныйФон = ПрозрачныйФон;
     ПараметрыШтрихкода.УровеньКоррекцииQR = УровеньКоррекцииQR;
     ПараметрыШтрихкода.ОтображатьТекст = ОтображатьТекст;
     ПараметрыШтрихкода.Масштабировать = Масштабировать;
     ПараметрыШтрихкода.СохранятьПропорции = СохранятьПропорции;
     ПараметрыШтрихкода.ВертикальноеВыравнивание = ВертикальноеВыравнивание; 
     ПараметрыШтрихкода.GS1DatabarКоличествоСтрок = КоличествоСтрокGS1Databar;
     ПараметрыШтрихкода.ТипВходныхДанных = 0;  // Тип входных данных (0-Строка, 1-Base64).
     ПараметрыШтрихкода.УбратьЛишнийФон = УбратьЛишнийФон;
     ПараметрыШтрихкода.ЛоготипКартинка = КартинкаBase64;
     ПараметрыШтрихкода.ЛоготипРазмерПроцентОтШК = ЛоготипРазмерПроцентОтШК;
    
     РезультатШтрихкод = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);
 
     Если НЕ РезультатШтрихкод.Результат Тогда
         Сообщить(НСтр("ru='Ошибка генерации штрихкода.'"));
     КонецЕсли;
 
     Возврат РезультатШтрихкод.Картинка;
 
 КонецФункции